Tagger

En tagg er en etikett i formen nøkkel=verdi på en ressurs, for eksempel env=prod eller cost-center=eu-42. Bruk tagger til å organisere og filtrere ressursene dine — etter miljø, eierteam eller kostnadssted.

Denne siden dekker:

• tagger på en ressurs, inkludert Kubernetes-klynger og nodepooler og databaser, cacher, meldingsmeglere, webservere og applikasjonsgatewayer, samt VPC-gatewayer og DNS-poster;
• standardtagger for tenanten, som plattformen legger til på hver ressurs som opprettes i en tenant;
• taggfarger, som gjør at en tagg ser lik ut i alle tenantene i organisasjonen din;
• Terraform: providerens default_tags og attributtet tags_all.

Tagg en ressurs

Du kan tagge disse ressursene:

• VPC-er, subnett og sikkerhetsgrupper
• VPC-gatewayer
• Offentlige IP-adresser
• Lastbalansere, med lyttere, pooler, poolmedlemmer og helseovervåkere
• Instanser, skaleringsgrupper og startmaler
• Volumer og øyeblikksbilder av volumer
• Buckets i objektlagring
• DNS-soner og DNS-poster
• Hemmeligheter
• Kubernetes-klynger og nodepooler
• Databaser, cacher, meldingsmeglere, webservere og applikasjonsgatewayer, og ressursene du oppretter under dem (se nedenfor)

Containerregistre har ingen tagger. Øyeblikksbilder av instanser bruker enkle etiketter i stedet for tagger i formen nøkkel=verdi.

Hver ressurstype har egne regler for taggnøkler og taggverdier, og noen har et høyeste antall tagger. Portalen kontrollerer dem mens du skriver, og plattformen avviser en tagg som bryter dem.

Portalen. Legg til tagger i delen Tagger i et skjema for å opprette en ressurs. For de fleste ressurser kan du endre dem senere fra ressursens side.

fm CLI. Oppgi --tag key=value (kan gjentas) når du oppretter en ressurs (hemmeligheter tar --tags i stedet; se nedenfor), og bruk tags get og tags set til å lese og erstatte taggene senere:

fm network security-group create --name web --vpc <vpc-id> --tag env=prod --tag team=web
fm network security-group tags get <security-group-id>
fm network security-group tags set <security-group-id> --tag env=prod --tag team=payments
fm network security-group tags set <security-group-id> --clear

tags set erstatter hele settet: en tagg du utelater, fjernes. Oppgi --clear for å fjerne alle taggene. De samme kommandoene tags get og tags set finnes for instanser, volumer, buckets, VPC-er, offentlige IP-adresser, lastbalansere og deres pooler og helseovervåkere, skaleringsgrupper og startmaler. DNS-soner og hemmeligheter har ingen tags get eller tags set: de får tagger når du oppretter dem, og du endrer dem med update. DNS-soner bruker --tag (fm dns zone update --tag …, eller --clear-tags for å fjerne alle taggene). Hemmeligheter bruker --tags, kommaseparert, både ved opprettelse og oppdatering (fm secrets update --tags …, eller --clear-tags). Se DNS og Hemmeligheter.

Noen ressurser har også nøkler som plattformen administrerer, for eksempel nøkler som begynner med frostmoln_. Du kan ikke angi dem. tags get viser dem separat som skrivebeskyttede, og plattformen beholder dem når du erstatter taggene dine.

Terraform. Angi argumentet tags:

resource "frostmoln_security_group" "web" {
  name   = "web"
  vpc_id = frostmoln_vpc.main.id

  tags = {
    env  = "prod"
    team = "web"
  }
}

Kubernetes-klynger og nodepooler

En administrert Kubernetes-klynge og hver av nodepoolene dens har egne tagger. Tagger er dine metadata for søk og filtrering, og plattformen lagrer dem bare: de er ikke Kubernetes-etiketter (labels), og de når aldri klyngen eller nodene. En nodepools labels — Kubernetes-etikettene som settes på hver node i poolen — er en egen innstilling, og et taggfilter treffer dem aldri.

Regel	Grense
Antall tagger	Høyst 32 per klynge eller nodepool, inkludert standardtaggene for tenanten
Nøkkel	1 til 64 byte bokstaver, sifre og . _ : / -; må begynne og slutte med en bokstav eller et siffer
Verdi	Høyst 256 byte, uten kontrolltegn. En verdi kan være tom.
Reserverte nøkkelprefikser, uansett store/små bokstaver	frostmoln_, frostmoln-

En endring av taggene påvirker aldri den kjørende klyngen eller nodene.

Den første nodepoolen får en kopi én gang. Nodepoolen du oppretter sammen med klyngen, kan ikke få egne tagger i forespørselen som oppretter den. I stedet får den en kopi av klyngens tagger — de du angir pluss standardtaggene for tenanten — én gang, når klyngen opprettes. Senere endringer av klyngens tagger når den ikke; endre poolens egne tagger i stedet. En nodepool du legger til senere, får ingen kopi av klyngens tagger: gi den egne tagger når du legger den til. Standardtaggene for tenanten legges til på den, som på hver ny ressurs.

Portalen. Angi klyngens tagger i delen Tagger i skjemaet for å opprette klyngen. På klyngens fane Oversikt viser kortet Tagger dem, og Rediger endrer dem. På fanen Nodepooler viser hver pool taggene sine og har Rediger tagger, og skjemaet Legg til pool har egne tagger. Filtrer klyngelisten på tagger med taggfilteret over listen.

fm CLI.

fm kubernetes cluster create --name prod --vpc <vpc-id> --subnet <subnet-id> \
  --node-flavor k8s.gp1.medium --tag env=prod --tag team=platform
fm kubernetes cluster list --tag env=prod
fm kubernetes cluster tags get <cluster-id>
fm kubernetes cluster tags set <cluster-id> --tag env=prod --tag team=payments
fm kubernetes node-pool create <cluster-id> --flavor k8s.gp1.large --name gpu --tag team=ml
fm kubernetes node-pool list <cluster-id> --tag team=ml
fm kubernetes node-pool tags get <cluster-id> <node-pool-id>
fm kubernetes node-pool tags set <cluster-id> <node-pool-id> --clear

tags set erstatter hele settet, og --clear fjerner alle taggene. På list gjentar du --tag for å filtrere: en klynge eller pool vises bare når den har alle taggene du oppgir.

Terraform. frostmoln_kubernetes_cluster og frostmoln_kubernetes_node_pool tar tags og rapporterer tags_all, som alle ressurser med tagger (se Terraform). En klynges tags styrer ikke taggene på den første nodepoolen, og den poolen kan ikke styres som en frostmoln_kubernetes_node_pool: endre taggene i portalen eller med fm kubernetes node-pool tags set.

Databaser, cacher, meldingsmeglere, webservere og applikasjonsgatewayer

Disse administrerte tjenestene har tagger på selve tjenesten og på ressursene du oppretter under den:

Tjeneste	Ressurser som kan tagges
Databaser	Instanser, lesereplikaer, sikkerhetskopier og parametergrupper
Cacher	Instanser og sikkerhetskopier
Meldingsmeglere	Instanser
Webservere	Instanser, domener og innholdsdistribusjoner
Applikasjonsgateway	Gatewayer, lyttere, ruter, backend-pooler, backends, sertifikater, tillatte veier, regelsett for brannmuren, publiserte versjoner av dem og testkjøringer for brannmuren (dry runs)

De samme reglene gjelder som for Kubernetes-klynger: høyst 32 tagger per ressurs, inkludert tenantens standardtagger; nøkler på 1 til 64 byte med bokstaver, sifre og . _ : / -, som begynner og slutter med en bokstav eller et siffer; verdier på høyst 256 byte uten kontrolltegn; og de reserverte prefiksene frostmoln_ og frostmoln-, uavhengig av store og små bokstaver.

Tagger er metadataene dine for søk og filtrering, og plattformen lagrer dem bare. En endring starter aldri noe på nytt, konfigurerer det om eller distribuerer det på nytt: på en applikasjonsgateway er en tagg ikke konfigurasjon, så den trenger ingen anvendelse og endrer ikke hva gatewayen leverer. Hver ressurs har sine egne tagger:

• Lesereplikaer får taggene du gir dem, pluss tenantens standardtagger. De kopierer ikke primærens tagger, og en senere endring på den ene siden når ikke den andre.
• En gjenoppretting oppretter en ny instans. Den får taggene du angir i gjenopprettingen, pluss tenantens standardtagger. Kildeinstansens tagger kopieres ikke.
• Sikkerhetskopier du oppretter får taggene du gir dem, pluss tenantens standardtagger. Planlagte sikkerhetskopier får bare tenantens standardtagger. De leses fra en kopi som kan være opptil 30 sekunder gammel, og hvis plattformen ikke kan lese dem i det hele tatt, tas sikkerhetskopien likevel, uten tagger. Bruk Bruk på eksisterende ressurser på siden Standardtagger, eller fm tenant default-tags apply, for å legge standardtaggene til en slik sikkerhetskopi i etterkant.
• En innholdsdistribusjon på en webserver er en egen ressurs, og tenantens standardtagger legges til på den. En distribusjon kan derfor ikke starte mens plattformen ikke kan lese tenantens standardtagger: den avvises med default_tags_unavailable (HTTP 503), og du kan prøve igjen om litt.
• En tillatt vei på en applikasjonsgateway deles av alle backends i samme sikkerhetsgruppe, protokoll og port. Taggene settes når den opprettes første gang. Å tillate den samme veien igjen gjenbruker den og beholder taggene.

På applikasjonsgatewayens lyttere, ruter, backends, sertifikater, tillatte veier, versjoner av regelsett og testkjøringer er taggene det eneste du kan endre etter at ressursen er opprettet. En endring som angir et annet felt, avvises med field_not_updatable.

Portalen. Angi tagger i delen Tagger i tjenestens opprettingsskjema, og i opprettingsdialogene for ressursene dens (en replika, en sikkerhetskopi, en gjenoppretting, et domene, en distribusjon, en lytter, en rute, en pool, en backend, et sertifikat, en tillatt vei eller et regelsett). Tjenestens side har kortet Tagger med Rediger, og hver ressurs i fanene og delene viser taggene sine og har Rediger tagger. Filtrer en tjenestes liste på tagger med taggfilteret over listen.

fm CLI. Hver av disse ressursene unntatt databasenes parametergrupper har tags get og tags set, og kommandoene create og list tar --tag. Bruk fm v0.97.0 eller nyere. Parametergruppenes tagger angis via API-et:

fm database postgres instance create --name orders ... --tag env=prod
fm database postgres instance list --tag env=prod
fm database postgres instance tags set <instance-id> --tag env=prod --tag team=payments
fm database postgres replica tags get <instance-id> <replica-id>
fm database postgres backup tags set <instance-id> <backup-id> --clear
fm cache redis instance tags set <instance-id> --tag env=prod
fm messaging lavinmq instance tags get <instance-id>
fm webserver nginx domain tags set <instance-id> <domain-id> --tag site=shop
fm webserver nginx deploys tags get <instance-id> <deploy-id>
fm appgw tags set <gateway-id> --tag env=prod
fm appgw listener tags set <listener-id> --gateway <gateway-id> --tag team=web

tags set erstatter hele settet, og --clear fjerner alle taggene. Gjenta --tag på list for å filtrere: en ressurs listes bare når den har alle taggene du angir.

Terraform. Disse ressursene tar tags og rapporterer tags_all, som alle ressurser som kan tagges (se Terraform): frostmoln_postgres_instance, frostmoln_mysql_instance, frostmoln_postgres_read_replica, frostmoln_mysql_read_replica, frostmoln_postgres_backup, frostmoln_mysql_backup, frostmoln_redis_instance, frostmoln_valkey_instance, frostmoln_messaging_instance, frostmoln_apache_instance, frostmoln_nginx_instance, frostmoln_webserver_domain, frostmoln_webserver_deployment, frostmoln_application_gateway, frostmoln_appgw_listener, frostmoln_appgw_route, frostmoln_appgw_backend_pool, frostmoln_appgw_backend, frostmoln_appgw_certificate, frostmoln_appgw_backend_authorization og frostmoln_appgw_waf_policy. Se Providerversjoner for hvilken provider de krever.

VPC-gatewayer og DNS-poster

En VPC sin gateway og hver DNS-post har egne tagger. De følger de samme reglene som Kubernetes-klynger: høyst 32 tagger per ressurs, inkludert tenantens standardtagger; nøkler på 1 til 64 byte med bokstaver, sifre og . _ : /-, som starter og slutter med en bokstav eller et siffer; verdier på høyst 256 byte uten kontrolltegn; og de reserverte prefiksene frostmoln_ og frostmoln-, uavhengig av store og små bokstaver.

Tagger er metadataene dine for søk og filtrering, og plattformen bare lagrer dem. Å endre taggene på en gateway berører aldri adressen eller VPC-ens tilkobling, og krever ingen bekreftelse. Taggene på en DNS-post publiseres aldri i DNS, og å endre bare taggene endrer ikke sonen.

Portalen. På siden for en VPC har kortet Gateway en taggredigerer når du legger til en gateway, og kortet Gatewayens tagger viser og redigerer taggene på en eksisterende gateway. På siden for en DNS-sone har postdialogen en del Tagger, postlisten viser taggene på hver post, og taggfilteret over listen begrenser den.

API. Forespørslene som oppretter ressursene, tar tags. Ved en oppdatering (PATCH for en gateway, PUT for en DNS-post) erstatter tags hele settet, og {} fjerner alle taggene. En forespørsel som bare inneholder tags, endrer ingenting annet. Listen over gatewayer, listen over DNS-poster og listen over rutere tar filteret ?tag=key=value, som kan gjentas: en ressurs vises bare når den har alle taggene du oppgir.

Terraform. frostmoln_gateway og frostmoln_dns_record tar tags og rapporterer tags_all, som alle ressurser med tagger (se Terraform). Det gjør også lastbalansererens underressurser frostmoln_lb_listener og frostmoln_lb_member. Se Providerversjoner for hvilken provider de krever.

Eksisterende ressurser. Når tenantens standardtagger legges til på ressursene tenanten allerede har (Bruk på eksisterende ressurser på siden Standardtagger, eller fm tenant default-tags apply), er VPC-gatewayer og DNS-poster med når plattformen har aktivert disse typene. Inntil da får de tenantens standardtagger bare når de opprettes.

Poolmedlemmer i lastbalansere. Et poolmedlem har egne tagger, med de samme reglene som lastbalansererens andre ressurser. Angi dem når du legger til medlemmet (i portalen delen Tagger i skjemaet for å legge til et medlem); tenantens standardtagger legges til. Endre dem senere med Rediger tagger på medlemmet, eller i API-et med PUT på medlemmet: tags erstatter hele settet, og clearTags: true fjerner alle taggene (ikke send begge). Poolmedlemmer er med når tenantens standardtagger legges til på eksisterende ressurser.

Rutere. Taggene på en ruter kan endres etter at den er opprettet, via API-et: PUT /v1/tenants/{tenant-id}/routers/{router-id} tar tags, som erstatter hele settet, eller clearTags: true for å fjerne alle taggene.

Tagger i tilgangspolicyer

Betingelser i tilgangspolicyer på frn:resourceTag/<k> (se Betingelser) evalueres ikke for de administrerte tjenestene: Kubernetes-klynger og nodepooler, databaser, cacher, meldingsmeglere, webservere og applikasjonsgatewayer, og ressursene under dem. En slik betingelse regnes som ukjent, og en ukjent betingelse feiler lukket: en allow-regel som er avgrenset med en ressurstagg, treffer aldri, og en deny-regel som er avgrenset med en ressurstagg, gjelder alltid. Ikke bruk taggavgrensede regler for å gi tilgang til disse ressursene.

Standardtagger for tenanten

Standardtagger for tenanten er et sett med tagger som plattformen legger til på hver ressurs med tagger som opprettes i tenanten — uansett hvem som oppretter den: portalen, fm CLI, API-et eller Terraform. Bruk dem til tagger som hver ressurs i en tenant skal ha, for eksempel miljø eller kostnadssted.

Slik legges standardtaggene til

• De kopieres når en ressurs opprettes. Deretter er de vanlige tagger på ressursen. Du kan endre eller fjerne dem som alle andre tagger, og ingenting knytter dem tilbake til tenantens standardtagger.
• Ressursens egne tagger vinner. En standardtagg legges bare til når forespørselen om å opprette ressursen ikke selv angir den nøkkelen. En nøkkel med tom verdi regnes som angitt.
• Bare nye ressurser får dem. En endring av standardtaggene endrer aldri en ressurs som allerede finnes.
• En endring tar opptil 30 sekunder. En ressurs som opprettes innen 30 sekunder etter en endring, kan fortsatt få det forrige settet.
• De teller mot ressursens taggrense. Hvis standardtaggene gjør at en ressurs får flere tagger enn den tillater, avvises opprettelsen. Feilen (tag_limit_exceeded_by_defaults) navngir standardtaggenes nøkler. Fjern noen tagger fra forespørselen, eller be en administrator i organisasjonen om å redusere tenantens standardtagger. I skjemaet for å opprette en ressurs viser portalen hvilke standardtagger som legges til, og hvor mange egne tagger du fortsatt kan legge til.
• En ressurs opprettes aldri uten dem. Hvis plattformen ikke kan lese tenantens standardtagger, avvises opprettelsen med en feil som kan prøves på nytt (default_tags_unavailable, HTTP 503). Prøv igjen om litt.

Instanser som en skaleringsgruppe starter, får tenantens standardtagger slik de er når skaleringsgruppen skalerer ut. En nøkkel i startmalens metadata (Terraform-argumentet metadata) vinner over en standardtagg; malens egne tagger blir på malen og kopieres ikke til instansene. Hvis plattformen fortsatt ikke kan lese standardtaggene etter nye forsøk, startes instansene uten dem, slik at skaleringen ikke stopper.

Standardtagger legges ikke til på:

• containerregistre, som ikke har tagger (alle andre administrerte tjenester, og ressursene du oppretter under dem, får dem);
• ressurser som plattformen oppretter for en administrert tjeneste;
• øyeblikksbilder av instanser, der taggene er enkle etiketter.

Regler for standardtagger

En standardtagg havner på alle typer ressurser, så den må godtas av alle. Derfor er reglene strengere enn for tagger du angir på én enkelt ressurs.

Regel	Grense
Antall standardtagger	Høyst 10 per tenant
Nøkkel	1 til 64 byte med bokstaver (a-z, A-Z), sifre og . _ : -; må begynne og slutte med en bokstav eller et siffer. Ingen /, ingen mellomrom.
Verdi	0 til 255 byte med bokstaver, sifre, mellomrom og + - . _ : / @ =. Verdien kan være tom.
Reserverte nøkkelprefikser, uansett store og små bokstaver	frostmoln_, frostmoln-, os_, instance_, nova_
Reserverte nøkler, uansett store og små bokstaver	request-id, customer-id, project-id, tenant-id, created-at, acl, storage-class, quota-bytes, cors-config

Hvem som kan endre dem

Alle medlemmer av organisasjonen som eier tenanten, kan lese standardtaggene. For å endre dem kreves rollen administrator eller eier i den organisasjonen. En API-nøkkel trenger tilgangen organizations:read for å lese dem og organizations:write for å endre dem; se API-nøkkeltilganger.

Hver tenant har ett sett med standardtagger, tomt til noen angir det. Hver endring erstatter hele settet, og det finnes ingen låsing: den siste skrivingen vinner, så administrer settet fra ett sted.

Angi standardtagger

Portalen. Åpne kontomenyen (øverst til høyre) og velg Standardtagger. Siden viser standardtaggene for tenanten du har valgt. Administratorer og eiere kan legge til, endre og fjerne tagger og deretter velge Lagre; andre medlemmer ser en skrivebeskyttet liste.

fm CLI. Kommandoene gjelder den aktive tenanten; oppgi --tenant for en annen.

fm tenant default-tags get
fm tenant default-tags set --tag env=prod --tag cost-center=eu-42
fm tenant default-tags set --tag owner=team-a --merge
fm tenant default-tags clear

set erstatter hele settet. Med --merge legger den i stedet taggene dine til det nåværende settet. clear ber om bekreftelse; oppgi --yes når fm ikke kjører i en terminal.

Terraform. Ressursen frostmoln_tenant_default_tags administrerer hele settet for providerens tenant:

resource "frostmoln_tenant_default_tags" "this" {
  tags = {
    env         = "prod"
    cost-center = "eu-42"
  }
}

Ressursen eier settet. Hver apply skriver nøyaktig tags, så en standardtagg som er lagt til i portalen, fjernes ved neste apply. Når ressursen opprettes, erstattes settet tenanten allerede har, og når den slettes, tømmes settet. Importer et eksisterende sett med tenantens id: terraform import frostmoln_tenant_default_tags.this <tenant-id>. Datakilden frostmoln_tenant_default_tags leser settet uten å administrere det.

Taggfarger

En regel for taggfarge viser en tagg i en farge du velger, i portalen og i fm. Farger angis per organisasjon og gjelder i alle tenantene i den, så env=prod ser lik ut overalt. De påvirker bare visningen: de endrer ingenting ved ressursene.

• En regel treffer en nøkkel og én eksakt verdi (env=prod), eller en nøkkel med alle verdier (env).
• For en tagg nøkkel=verdi vinner regelen for akkurat den verdien over nøkkelens regel for alle verdier.
• En regel for den tomme verdien er en annen regel enn regelen for alle verdier: den treffer bare tagger med tom verdi.
• Nøkler og verdier sammenlignes med skille mellom store og små bokstaver.
• Fargen er taggens bakgrunn, som #RRGGBB. Teksten er svart eller hvit, avhengig av hva som gir best kontrast. Taggens tekst vises alltid, så fargen er aldri det eneste signalet.

Regel	Grense
Regler	Høyst 200 per organisasjon, og én per nøkkel og verdi
Nøkkel	1 til 255 tegn, uten kontroll- eller formateringstegn
Verdi	Høyst 256 tegn, uten kontroll- eller formateringstegn; eller ingen, for å treffe alle verdier
Reserverte nøkkelprefikser	frostmoln_ og frostmoln-, bare med små bokstaver: en nøkkel som Frostmoln_Team kan fargelegges
Farge	#RRGGBB, for eksempel #1f6feb

Alle medlemmer av organisasjonen kan lese fargereglene. For å legge til, endre og slette dem kreves rollen administrator eller eier. En API-nøkkel trenger tilgangen organizations:read for å lese dem og organizations:write for å endre dem.

Portalen. Gå til Organisasjoner, åpne organisasjonen din og velg fanen Innstillinger. I kortet Taggfarger velger du Legg til farge, skriver inn taggnøkkelen, krysser deretter enten av for Alle verdier eller skriver inn en verdi, og velger en farge med fargevelgeren eller skriver den som hex. Medlemmer som ikke er administratorer eller eiere, ser listen skrivebeskyttet.

fm CLI. fm organization tag-colors arbeider mot organisasjonen som eier den aktive tenanten din; oppgi --organization for en annen. Nøyaktig én av --value og --any-value kreves. Sett fargen i anførselstegn, fordi en # uten anførselstegn starter en kommentar i skallet, eller utelat #.

fm organization tag-colors list
fm organization tag-colors set --key env --value prod --color '#d73a49'
fm organization tag-colors set --key team --any-value --color 1f6feb
fm organization tag-colors delete --key env --value prod

Hvis du kjører set igjen for samme nøkkel og verdi, endres regelens farge. I en terminal med 24-biters farger skriver fm også ut tagger i fargene deres. Den skriver ut tagger uten farge med --no-color eller NO_COLOR, og når utdataene ikke går til en terminal.

Terraform. Hver ressurs frostmoln_tag_color administrerer én regel. Utelat value for en regel som gjelder alle verdier. Uten organization_id havner regelen i organisasjonen som eier providerens tenant.

resource "frostmoln_tag_color" "prod" {
  key   = "env"
  value = "prod"
  color = "#d73a49"
}

resource "frostmoln_tag_color" "team" {
  key   = "team"
  color = "#1f6feb"
}

Datakilden frostmoln_tag_colors viser organisasjonens regler, med id-ene du trenger for å importere en regel som er opprettet i portalen.

Terraform: default_tags og tags_all

Blokken default_tags i provideren legger til tagger på hver ressurs med tagger som denne providerkonfigurasjonen administrerer:

provider "frostmoln" {
  default_tags {
    tags = {
      managed-by = "terraform"
      env        = "prod"
    }
  }
}

resource "frostmoln_vpc" "app" {
  name = "app"
  cidr = "10.1.0.0/16"

  tags = {
    env = "staging" # en ressurstagg vinner over en standardtagg med samme nøkkel
  }

  # Opprett VPC-en etter at tenantens standardtagger er angitt.
  depends_on = [frostmoln_tenant_default_tags.this]
}

output "app_vpc_tags" {
  value = frostmoln_vpc.app.tags_all
}

Hver ressurs med tagger har to taggattributter:

• tags inneholder nøyaktig det ressursens konfigurasjon angir.
• tags_all er skrivebeskyttet og inneholder alle taggene på ressursen: providerens default_tags, ressursens egne tags, tenantens standardtagger og alt som er angitt utenfor Terraform. Referer til tags_all når du trenger hele settet.

Nøkler som er angitt utenfor Terraform — i portalen, med fm eller gjennom tenantens standardtagger — vises bare i tags_all, og provideren beholder dem ved hver apply. Den fjerner bare nøklene den administrerer: de i en ressurs tags og de den la til fra default_tags.

Når samme nøkkel kommer fra flere steder, vinner den mest spesifikke:

Kilde	Forrang
Ressursens tags	Høyest
Providerens default_tags	Middels
Tenantens standardtagger	Lavest

Providerens default_tags og tenantens standardtagger skiller seg i omfang og tidspunkt:

	Tenantens standardtagger	Providerens default_tags
Gjelder	Hver ressurs som opprettes i tenanten, av hvilken som helst klient	Ressursene én providerkonfigurasjon administrerer
Når	Én gang, når en ressurs opprettes	Ved hver opprettelse og oppdatering
Når de endres	Påvirker bare ressurser som opprettes senere	Planlegger en oppdatering på stedet av hver ressurs med tagger i konfigurasjonen
Vises i Terraform	Bare i tags_all	I tags_all
Regler	Reglene for standardtagger	Samme regler, kontrollert når provideren konfigureres

En endring av default_tags oppdaterer hver ressurs med tagger som provideren administrerer. Ingenting erstattes, men se over størrelsen på planen før du bruker den på en stor konfigurasjon.

Øyeblikksbilder oppdateres også på stedet, men plattformen avviser en oppdatering av taggene på et øyeblikksbilde (HTTP 409) mens øyeblikksbildet ikke er available (det tas fortsatt, eller det gjenopprettes; kjør apply på nytt når det er det), og på enkelte eldre øyeblikksbilder som mangler eiertagg. Administrer et slikt øyeblikksbilde med en ekstra providerkonfigurasjon med alias og uten default_tags, og la tags stå uendret, eller ta et nytt øyeblikksbilde som erstatter det.

Providerversjoner

For å bruke	Trenger du provider
Terraform i en tenant som har standardtagger	v0.62.0 eller nyere
default_tags og tags_all	v0.62.0 eller nyere
frostmoln_tag_color og datakilden frostmoln_tag_colors	v0.63.0 eller nyere
frostmoln_tenant_default_tags (ressurs og datakilde)	v0.65.0 eller nyere
tags på frostmoln_kubernetes_cluster og frostmoln_kubernetes_node_pool	v0.81.0 eller nyere
tags på ressursene for databaser, cacher, meldingsmeglere, webservere og applikasjonsgatewayer	v0.82.0 eller nyere
tags på frostmoln_gateway, frostmoln_dns_record, frostmoln_lb_listener og frostmoln_lb_member	v0.83.0 eller nyere

Når en tenant har standardtagger, feiler eldre providerversjoner når de oppretter en ressurs med tagger i den, med "Provider produced inconsistent result after apply": ressursen kommer tilbake med tagger de ikke forventet. Oppgrader provideren før du angir standardtagger for en tenant som Terraform administrerer.

En oppgradering fra en versjon uten tags_all endrer én oppførsel: en nøkkel som var angitt utenfor konfigurasjonen, ble tidligere vist som en forskjell i tags som neste apply fjernet. Nå blir den værende, i tags_all.

Migrere fra en annen sky

Når du konverterer en konfigurasjon med fm terraform convert, blir AWS-providerens default_tags og Google-providerens default_labels til Frostmoln-providerens default_tags. Azure-provideren har ingen standardtagger på providernivå. Ingenting konverteres til tenantens standardtagger, og ingen kildesky har taggfarger. Se matrisene for AWS, Azure og Google Cloud for detaljer.

Relatert

• API-nøkkeltilganger · Skymigrering
• fm CLI-referanse: fm organization · fm tenant
• Terraform: frostmoln_tag_color · datakilden frostmoln_tag_colors