Organizowanie zasobów platformy Azure i hierarchii zarządzania przy użyciu tagów

Artykuł
03/25/2023
Czas czytania: 15 min

Tagi to elementy metadanych, które są stosowane do zasobów platformy Azure. Są to pary klucz-wartość, które ułatwiają identyfikowanie zasobów na podstawie ustawień istotnych dla organizacji. Jeśli chcesz śledzić środowisko wdrażania dla zasobów, dodaj klucz o nazwie Środowisko. Aby zidentyfikować zasoby wdrożone w środowisku produkcyjnym, nadaj im wartość Produkcja. W pełni utworzona para klucz-wartość staje się, Environment = Production.

Tagi można stosować do zasobów platformy Azure, grup zasobów i subskrypcji.

Aby uzyskać zalecenia dotyczące implementowania strategii tagowania, zobacz Przewodnik po decyzjach dotyczących nazewnictwa zasobów i tagowania.

Tagi zasobów obsługują wszystkie usługi naliczania kosztów. Aby upewnić się, że usługi naliczania kosztów są aprowizowane za pomocą tagu, użyj jednej z zasad tagów.

Ostrzeżenie

Tagi są przechowywane jako zwykły tekst. Nigdy nie dodawaj poufnych wartości do tagów. Poufne wartości można uwidocznić za pomocą wielu metod, w tym raportów kosztów, poleceń, które zwracają istniejące definicje tagów, historie wdrażania, wyeksportowane szablony i dzienniki monitorowania.

Ostrzeżenie

Zachowaj ostrożność podczas korzystania z języka innego niż angielski w tagach. Może to spowodować niepowodzenie dekodowania postępu podczas ładowania metadanych maszyny wirtualnej z usługi IMDS (Instance Metadata Service).

Ważne

Nazwy tagów są bez uwzględniania wielkości liter dla operacji. Tag o nazwie tagu, niezależnie od wielkości liter, jest aktualizowany lub pobierany. Jednak dostawca zasobów może zachować wielkość liter dla nazwy tagu. Zobaczysz, że wielkość liter w raportach kosztów.

Wartości tagów są uwzględniane w wielkości liter.

Uwaga

Ten artykuł zawiera kroki dotyczące usuwania danych osobowych z urządzenia lub usługi i może służyć do obsługi zobowiązań wynikających z RODO. Aby uzyskać ogólne informacje na temat RODO, zobacz sekcję RODO w Centrum zaufania firmy Microsoft i w sekcji RODO w portalu zaufania usług.

Wymagany dostęp

Istnieją dwa sposoby uzyskania wymaganego dostępu do tagowania zasobów.

Możesz mieć dostęp do zapisu do Microsoft.Resources/tags typu zasobu. Ten dostęp umożliwia otagowanie dowolnego zasobu, nawet jeśli nie masz dostępu do samego zasobu. Rola Współautor tagów przyznaje ten dostęp. Rola współautora tagu, na przykład, nie może stosować tagów do zasobów ani grup zasobów za pośrednictwem portalu. Może jednak stosować tagi do subskrypcji za pośrednictwem portalu. Obsługuje ona wszystkie operacje na tagach za pośrednictwem programu Azure PowerShell i interfejsu API REST.
Możesz mieć dostęp do zapisu do samego zasobu. Rola Współautor przyznaje wymagany dostęp do stosowania tagów do dowolnej jednostki. Aby zastosować tagi tylko do jednego typu zasobu, użyj roli współautora dla tego zasobu. Aby zastosować tagi do maszyn wirtualnych, na przykład użyj współautora maszyny wirtualnej.

PowerShell

Stosowanie tagów

Azure PowerShell oferuje dwa polecenia do stosowania tagów: New-AzTag i Update-AzTag. Musisz mieć moduł w wersji 1.12.0 lub nowszej Az.Resources . Możesz sprawdzić wersję za pomocą polecenia Get-InstalledModule -Name Az.Resources. Możesz zainstalować ten moduł lub zainstalować Azure PowerShell w wersji 3.6.1 lub nowszej.

Element New-AzTag zastępuje wszystkie tagi w zasobie, grupie zasobów lub subskrypcji. Po wywołaniu polecenia przekaż identyfikator zasobu jednostki, którą chcesz oznaczyć.

Poniższy przykład stosuje zestaw tagów do konta magazynu:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

Po zakończeniu polecenia zwróć uwagę, że zasób ma dwa tagi.

Properties :
        Name    Value
        ======  =======
        Dept    Finance
        Status  Normal

Jeśli ponownie uruchomisz polecenie, ale tym razem z różnymi tagami, zwróć uwagę, że wcześniejsze tagi znikną.

$tags = @{"Team"="Compliance"; "Environment"="Production"}
New-AzTag -ResourceId $resource.id -Tag $tags

Properties :
        Name         Value
        ===========  ==========
        Environment  Production
        Team         Compliance

Aby dodać tagi do zasobu, który ma już tagi, użyj polecenia Update-AzTag. -Operation Ustaw parametr na Merge.

$tags = @{"Dept"="Finance"; "Status"="Normal"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

Zwróć uwagę, że istniejące tagi rosną wraz z dodawaniem dwóch nowych tagów.

Properties :
        Name         Value
        ===========  ==========
        Status       Normal
        Dept         Finance
        Team         Compliance
        Environment  Production

Każda nazwa tagu może mieć tylko jedną wartość. Jeśli podasz nową wartość tagu, zastępuje starą wartość, nawet jeśli używasz operacji scalania. Poniższy przykład zmienia Status tag z Normalny na Zielony.

$tags = @{"Status"="Green"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

Po ustawieniu parametru -Operation na Replacewartość , nowy zestaw tagów zastępuje istniejące tagi.

$tags = @{"Project"="ECommerce"; "CostCenter"="00123"; "Team"="Web"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Replace

Tylko nowe tagi pozostają w zasobie.

Properties :
        Name        Value
        ==========  =========
        CostCenter  00123
        Team        Web
        Project     ECommerce

Te same polecenia działają również z grupami zasobów lub subskrypcjami. Przekaż je w identyfikatorze grupy zasobów lub subskrypcji, którą chcesz oznaczyć.

Aby dodać nowy zestaw tagów do grupy zasobów, użyj:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
New-AzTag -ResourceId $resourceGroup.ResourceId -tag $tags

Aby zaktualizować tagi dla grupy zasobów, użyj:

$tags = @{"CostCenter"="00123"; "Environment"="Production"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
Update-AzTag -ResourceId $resourceGroup.ResourceId -Tag $tags -Operation Merge

Aby dodać nowy zestaw tagów do subskrypcji, użyj:

$tags = @{"CostCenter"="00123"; "Environment"="Dev"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
New-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags

Aby zaktualizować tagi dla subskrypcji, użyj:

$tags = @{"Team"="Web Apps"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Update-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags -Operation Merge

Być może istnieje więcej niż jeden zasób o tej samej nazwie w grupie zasobów. W takim przypadku można ustawić każdy zasób za pomocą następujących poleceń:

$resource = Get-AzResource -ResourceName sqlDatabase1 -ResourceGroupName examplegroup
$resource | ForEach-Object { Update-AzTag -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $_.ResourceId -Operation Merge }

Aby pobrać tagi dla zasobu, grupy zasobów lub subskrypcji, użyj polecenia Get-AzTag i przekaż identyfikator zasobu jednostki.

Aby wyświetlić tagi zasobu, użyj:

$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
Get-AzTag -ResourceId $resource.id

Aby wyświetlić tagi dla grupy zasobów, użyj:

$resourceGroup = Get-AzResourceGroup -Name demoGroup
Get-AzTag -ResourceId $resourceGroup.ResourceId

Aby wyświetlić tagi subskrypcji, użyj:

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Get-AzTag -ResourceId "/subscriptions/$subscription"

Wyświetlanie listy według tagu

Aby uzyskać zasoby o określonej nazwie i wartości tagu, użyj:

(Get-AzResource -Tag @{ "CostCenter"="00123"}).Name

Aby uzyskać zasoby o określonej nazwie tagu z dowolną wartością tagu, użyj:

(Get-AzResource -TagName "Dept").Name

Aby uzyskać grupy zasobów, które mają określoną nazwę i wartość tagu, użyj:

(Get-AzResourceGroup -Tag @{ "CostCenter"="00123" }).ResourceGroupName

Usuwanie tagów

Aby usunąć określone tagi, użyj Update-AzTag polecenia i ustaw wartość -OperationDelete. Przekaż identyfikatory zasobów tagów, które chcesz usunąć.

$removeTags = @{"Project"="ECommerce"; "Team"="Web"}
Update-AzTag -ResourceId $resource.id -Tag $removeTags -Operation Delete

Określone tagi są usuwane.

Properties :
        Name        Value
        ==========  =====
        CostCenter  00123

Aby usunąć wszystkie tagi, użyj polecenia Remove-AzTag .

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Remove-AzTag -ResourceId "/subscriptions/$subscription"

Interfejs wiersza polecenia platformy Azure

Stosowanie tagów

Interfejs wiersza polecenia platformy Azure oferuje dwa polecenia do stosowania tagów: az tag create i az tag update. Musisz mieć interfejs wiersza polecenia platformy Azure w wersji 2.10.0 lub nowszej. Możesz sprawdzić wersję za pomocą polecenia az version. Aby ją zaktualizować lub zainstalować, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

Element az tag create zastępuje wszystkie tagi w zasobie, grupie zasobów lub subskrypcji. Po wywołaniu polecenia przekaż identyfikator zasobu jednostki, którą chcesz oznaczyć.

Poniższy przykład stosuje zestaw tagów do konta magazynu:

resource=$(az resource show -g demoGroup -n demoStorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag create --resource-id $resource --tags Dept=Finance Status=Normal

Po zakończeniu polecenia zwróć uwagę, że zasób ma dwa tagi.

"properties": {
  "tags": {
    "Dept": "Finance",
    "Status": "Normal"
  }
},

Jeśli ponownie uruchomisz polecenie, ale tym razem z różnymi tagami, zwróć uwagę, że wcześniejsze tagi znikną.

az tag create --resource-id $resource --tags Team=Compliance Environment=Production

"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

Aby dodać tagi do zasobu, który ma już tagi, użyj polecenia az tag update. --operation Ustaw parametr na Merge.

az tag update --resource-id $resource --operation Merge --tags Dept=Finance Status=Normal

Zwróć uwagę, że istniejące tagi rosną wraz z dodawaniem dwóch nowych tagów.

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Normal",
    "Team": "Compliance"
  }
},

Każda nazwa tagu może mieć tylko jedną wartość. Jeśli podasz nową wartość tagu, nowy tag zastępuje starą wartość, nawet jeśli używasz operacji scalania. Poniższy przykład zmienia Status tag z Normalny na Zielony.

az tag update --resource-id $resource --operation Merge --tags Status=Green

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Green",
    "Team": "Compliance"
  }
},

Po ustawieniu parametru --operation na Replacewartość , nowy zestaw tagów zastępuje istniejące tagi.

az tag update --resource-id $resource --operation Replace --tags Project=ECommerce CostCenter=00123 Team=Web

Tylko nowe tagi pozostają w zasobie.

"properties": {
  "tags": {
    "CostCenter": "00123",
    "Project": "ECommerce",
    "Team": "Web"
  }
},

Te same polecenia działają również z grupami zasobów lub subskrypcjami. Przekaż je w identyfikatorze grupy zasobów lub subskrypcji, którą chcesz oznaczyć.

Aby dodać nowy zestaw tagów do grupy zasobów, użyj:

group=$(az group show -n demoGroup --query id --output tsv)
az tag create --resource-id $group --tags Dept=Finance Status=Normal

Aby zaktualizować tagi dla grupy zasobów, użyj:

az tag update --resource-id $group --operation Merge --tags CostCenter=00123 Environment=Production

Aby dodać nowy zestaw tagów do subskrypcji, użyj:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag create --resource-id /subscriptions/$sub --tags CostCenter=00123 Environment=Dev

Aby zaktualizować tagi dla subskrypcji, użyj:

az tag update --resource-id /subscriptions/$sub --operation Merge --tags Team="Web Apps"

Aby pobrać tagi zasobu, grupy zasobów lub subskrypcji, użyj polecenia az tag list i przekaż identyfikator zasobu jednostki.

Aby wyświetlić tagi zasobu, użyj:

resource=$(az resource show -g demoGroup -n demoStorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag list --resource-id $resource

Aby wyświetlić tagi dla grupy zasobów, użyj:

group=$(az group show -n demoGroup --query id --output tsv)
az tag list --resource-id $group

Aby wyświetlić tagi subskrypcji, użyj:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag list --resource-id /subscriptions/$sub

Wyświetlanie listy według tagu

Aby uzyskać zasoby o określonej nazwie i wartości tagu, użyj:

az resource list --tag CostCenter=00123 --query [].name

Aby uzyskać zasoby o określonej nazwie tagu z dowolną wartością tagu, użyj:

az resource list --tag Team --query [].name

Aby uzyskać grupy zasobów, które mają określoną nazwę i wartość tagu, użyj:

az group list --tag Dept=Finance

Usuwanie tagów

Aby usunąć określone tagi, użyj az tag update polecenia i ustaw wartość --operationDelete. Przekaż identyfikator zasobu tagów, które chcesz usunąć.

az tag update --resource-id $resource --operation Delete --tags Project=ECommerce Team=Web

Usunięto określone tagi.

"properties": {
  "tags": {
    "CostCenter": "00123"
  }
},

Aby usunąć wszystkie tagi, użyj polecenia az tag delete .

az tag delete --resource-id $resource

Obsługa spacji

Jeśli nazwy tagów lub wartości zawierają spacje, należy je ująć w cudzysłów.

az tag update --resource-id $group --operation Merge --tags "Cost Center"=Finance-1222 Location="West US"

Szablony usługi ARM

Zasoby, grupy zasobów i subskrypcje można tagować podczas wdrażania przy użyciu szablonu usługi ARM.

Uwaga

Tagi stosowane za pomocą szablonu usługi ARM lub pliku Bicep zastępują wszystkie istniejące tagi.

Stosowanie wartości

Poniższy przykład wdraża konto magazynu z trzema tagami. Dwa tagi (Dept i Environment) są ustawione na wartości literału. Jeden tag (LastDeployed) jest ustawiony na parametr, który jest domyślnie ustawiony na bieżącą datę.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "utcShort": {
      "type": "string",
      "defaultValue": "[utcNow('d')]"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "Dept": "Finance",
        "Environment": "Production",
        "LastDeployed": "[parameters('utcShort')]"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location
param utcShort string = utcNow('d')

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    Dept: 'Finance'
    Environment: 'Production'
    LastDeployed: utcShort
  }
}

Stosowanie obiektu

Można zdefiniować parametr obiektu, który przechowuje kilka tagów i zastosować ten obiekt do elementu tagu. Takie podejście zapewnia większą elastyczność niż w poprzednim przykładzie, ponieważ obiekt może mieć różne właściwości. Każda właściwość obiektu będzie osobnym tagiem dla zasobu. Poniższy przykład zawiera parametr o nazwie tagValues zastosowanej do elementu tagu.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "tagValues": {
      "type": "object",
      "defaultValue": {
        "Dept": "Finance",
        "Environment": "Production"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": "[parameters('tagValues')]",
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location
param tagValues object = {
  Dept: 'Finance'
  Environment: 'Production'
}

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: tagValues
}

Stosowanie ciągu JSON

Aby przechowywać wiele wartości w jednym tagu, zastosuj ciąg JSON reprezentujący te wartości. Cały ciąg JSON jest przechowywany jako jeden tag, który nie może przekraczać 256 znaków. Poniższy przykład zawiera pojedynczy tag o nazwie CostCenter, który zawiera kilka wartości z ciągu JSON:

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "CostCenter": "{\"Dept\":\"Finance\",\"Environment\":\"Production\"}"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    CostCenter: '{"Dept":"Finance","Environment":"Production"}'
  }
}

Stosowanie tagów z grupy zasobów

Aby zastosować tagi z grupy zasobów do zasobu, użyj funkcji resourceGroup(). Po pobraniu wartości tagu użyj tags[tag-name] składni zamiast tags.tag-name składni, ponieważ niektóre znaki nie są prawidłowo analizowane w notacji kropkowej.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "Dept": "[resourceGroup().tags['Dept']]",
        "Environment": "[resourceGroup().tags['Environment']]"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    Dept: resourceGroup().tags['Dept']
    Environment: resourceGroup().tags['Environment']
  }
}

Stosowanie tagów do grup zasobów lub subskrypcji

Tagi można dodać do grupy zasobów lub subskrypcji, wdrażając Microsoft.Resources/tags typ zasobu. Tagi można zastosować do docelowej grupy zasobów lub subskrypcji, którą chcesz wdrożyć. Za każdym razem, gdy wdrażasz szablon, zastępujesz wszystkie poprzednie tagi.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "tagName": {
      "type": "string",
      "defaultValue": "TeamName"
    },
    "tagValue": {
      "type": "string",
      "defaultValue": "AppTeam1"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Resources/tags",
      "name": "default",
      "apiVersion": "2021-04-01",
      "properties": {
        "tags": {
          "[parameters('tagName')]": "[parameters('tagValue')]"
        }
      }
    }
  ]
}

param tagName string = 'TeamName'
param tagValue string = 'AppTeam1'

resource applyTags 'Microsoft.Resources/tags@2021-04-01' = {
  name: 'default'
  properties: {
    tags: {
      '${tagName}': tagValue
    }
  }
}

Aby zastosować tagi do grupy zasobów, użyj Azure PowerShell lub interfejsu wiersza polecenia platformy Azure. Wdróż w grupie zasobów, którą chcesz oznaczyć.

New-AzResourceGroupDeployment -ResourceGroupName exampleGroup -TemplateFile https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

az deployment group create --resource-group exampleGroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

Aby zastosować tagi do subskrypcji, użyj programu PowerShell lub interfejsu wiersza polecenia platformy Azure. Wdróż w subskrypcji, którą chcesz oznaczyć.

New-AzSubscriptionDeployment -name tagresourcegroup -Location westus2 -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

az deployment sub create --name tagresourcegroup --location westus2 --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

Aby uzyskać więcej informacji na temat wdrożeń subskrypcji, zobacz Tworzenie grup zasobów i zasobów na poziomie subskrypcji.

Poniższy szablon dodaje tagi z obiektu do grupy zasobów lub subskrypcji.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "tags": {
      "type": "object",
      "defaultValue": {
        "TeamName": "AppTeam1",
        "Dept": "Finance",
        "Environment": "Production"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Resources/tags",
      "apiVersion": "2021-04-01",
      "name": "default",
      "properties": {
        "tags": "[parameters('tags')]"
      }
    }
  ]
}

targetScope = 'subscription'

param tagObject object = {
  TeamName: 'AppTeam1'
  Dept: 'Finance'
  Environment: 'Production'
}

resource applyTags 'Microsoft.Resources/tags@2021-04-01' = {
  name: 'default'
  properties: {
    tags: tagObject
  }
}

Portal

Jeśli użytkownik nie ma wymaganego dostępu do stosowania tagów, możesz przypisać użytkownikowi rolę Współautor tagów . Aby uzyskać więcej informacji, zobacz Samouczek: udzielanie użytkownikowi dostępu do zasobów platformy Azure przy użyciu kontroli dostępu opartej na rolach i Azure Portal.

Aby wyświetlić tagi dla zasobu lub grupy zasobów, poszukaj istniejących tagów w omówieniu. Jeśli wcześniej nie zastosowano tagów, lista będzie pusta.
Aby dodać tag, wybierz pozycję Kliknij tutaj, aby dodać tagi.
Podaj nazwę i wartość.
Kontynuuj dodawanie tagów zgodnie z potrzebami. Po zakończeniu wybierz pozycję Zapisz.
Tagi są teraz wyświetlane w omówieniu.
Aby dodać lub usunąć tag, wybierz pozycję Zmień.
Aby usunąć tag, wybierz ikonę kosza. Następnie wybierz pozycję Zapisz.

Aby zbiorczo przypisać tagi do wielu zasobów:

Na dowolnej liście zasobów zaznacz pole wyboru dla zasobów, którym chcesz przypisać tag. Następnie wybierz pozycję Przypisz tagi.
Dodaj nazwy i wartości. Po zakończeniu wybierz pozycję Zapisz.

Aby wyświetlić wszystkie zasoby z tagiem:

W menu Azure Portal wyszukaj tagi. Wybierz tagi z listy dostępnych opcji.
Wybierz tag na potrzeby wyświetlania zasobów.
Zostaną wyświetlone wszystkie zasoby z tym tagiem.

Interfejs API REST

Aby pracować z tagami za pomocą interfejsu API REST platformy Azure, użyj:

Tagi — tworzenie lub aktualizowanie w zakresie (operacja PUT)
Tagi — aktualizacja w zakresie (operacja PATCH)
Tagi — uzyskiwanie zakresu (operacja GET)
Tagi — usuwanie w zakresie (operacja DELETE)

Zestawy SDK

Przykłady stosowania tagów za pomocą zestawów SDK można znaleźć w temacie:

Dziedziczenie tagów

Zasoby nie dziedziczą tagów zastosowanych do grupy zasobów lub subskrypcji. Aby zastosować tagi z subskrypcji lub grupy zasobów do zasobów, zobacz Azure Policies — tags (Zasady platformy Azure — tagi).

Tagi i rozliczenia

Tagów można użyć do grupowania danych dotyczących rozliczeń. Jeśli używasz wielu maszyn wirtualnych dla różnych organizacji, na przykład użyj tagów do grupowania użycia według centrum kosztów. Tagi umożliwiają również kategoryzowanie kosztów według środowiska uruchomieniowego, na przykład na potrzeby rozliczania użycia maszyn uruchomionych w środowisku produkcyjnym.

Informacje o tagach można uzyskać, pobierając plik użycia dostępny w witrynie Azure Portal. Aby uzyskać więcej informacji, zobacz Pobieranie i wyświetlanie faktury rozliczeniowej za platformę Azure i danych dziennego użycia. W przypadku usług obsługujących tagi z rozliczeniami tagi są wyświetlane w kolumnie Tagi.

W przypadku operacji interfejsu API REST zobacz Dokumentacja interfejsu API REST rozliczeń platformy Azure.

Ograniczenia

Tagi mają następujące ograniczenia:

Nie wszystkie typy zasobów obsługują tagi. Aby określić, czy możesz zastosować tag do typu zasobu, zobacz Obsługa tagów dla zasobów platformy Azure.
Każdy zasób, grupa zasobów lub subskrypcja może mieć co najwyżej 50 par nazwa-wartość tagu. Jeśli musisz zastosować więcej tagów niż maksymalna dozwolona liczba, użyj ciągu JSON dla wartości tagu. Ciąg JSON może zawierać wiele wartości, które są stosowane do jednej nazwy tagu. Grupa zasobów lub subskrypcja może zawierać wiele zasobów, z których każdy może mieć 50 par nazwa-wartość tagu.
Nazwa tagu ma limit 512 znaków, a wartość tagu ma limit 256 znaków. W przypadku kont magazynu nazwa tagu ma limit 128 znaków, a wartość tagu ma limit 256 znaków.
Zasoby klasyczne, takie jak Cloud Services, nie obsługują tagów.
Grupy adresów IP platformy Azure i zasady Azure Firewall nie obsługują operacji PATCH. W związku z tym operacje metody interfejsu API PATCH nie mogą aktualizować tagów za pośrednictwem portalu. Zamiast tego dla tych zasobów można użyć poleceń aktualizacji. Tagi dla grupy adresów IP można zaktualizować na przykład za pomocą polecenia az network ip-group update .
Nazwy tagów nie mogą zawierać następujących znaków: <, >, %, \&, , , ?/
Uwaga
- Strefy systemu nazw domen platformy Azure (DNS) nie obsługują używania spacji w tagu ani tagu rozpoczynającego się od liczby. Nazwy tagów usługi Azure DNS nie obsługują znaków specjalnych i unicode. Wartość może zawierać wszystkie znaki.
- Usługa Traffic Manager nie obsługuje używania spacji # ani : w nazwie tagu. Nazwa tagu nie może zaczynać się od liczby.
- Usługa Azure Front Door nie obsługuje użycia # ani : nazwy tagu.
- Następujące zasoby platformy Azure obsługują tylko 15 tagów:
  - Azure Automation
  - Azure Content Delivery Network (CDN)
  - Azure DNS (strefy i rekordy A)
  - Zapisane wyszukiwanie w usłudze Azure Log Analytics

Następne kroki

Nie wszystkie typy zasobów obsługują tagi. Aby określić, czy możesz zastosować tag do typu zasobu, zobacz Obsługa tagów dla zasobów platformy Azure.
Aby uzyskać zalecenia dotyczące implementowania strategii tagowania, zobacz Przewodnik po decyzjach dotyczących nazewnictwa zasobów i tagowania.

Organizowanie zasobów platformy Azure i hierarchii zarządzania przy użyciu tagów

Wymagany dostęp

PowerShell

Stosowanie tagów

Wyświetlanie listy według tagu

Usuwanie tagów

Interfejs wiersza polecenia platformy Azure

Stosowanie tagów

Wyświetlanie listy według tagu

Usuwanie tagów

Obsługa spacji

Szablony usługi ARM

Stosowanie wartości

Stosowanie obiektu

Stosowanie ciągu JSON

Stosowanie tagów z grupy zasobów

Stosowanie tagów do grup zasobów lub subskrypcji

Portal

Interfejs API REST

Zestawy SDK

Dziedziczenie tagów

Tagi i rozliczenia

Ograniczenia

Następne kroki

Dodatkowe zasoby

Dodatkowe zasoby

Organizowanie zasobów platformy Azure i hierarchii zarządzania przy użyciu tagów

Wymagany dostęp

PowerShell

Stosowanie tagów

Tworzenie listy tagów

Wyświetlanie listy według tagu

Usuwanie tagów

Interfejs wiersza polecenia platformy Azure

Stosowanie tagów

Tworzenie listy tagów

Wyświetlanie listy według tagu

Usuwanie tagów

Obsługa spacji

Szablony usługi ARM

Stosowanie wartości

Stosowanie obiektu

Stosowanie ciągu JSON

Stosowanie tagów z grupy zasobów

Stosowanie tagów do grup zasobów lub subskrypcji

Portal

Interfejs API REST

Zestawy SDK

Dziedziczenie tagów

Tagi i rozliczenia

Ograniczenia

Następne kroki

Dodatkowe zasoby

Dodatkowe zasoby