タグを使用して Azure リソースと整理階層を整理するUse tags to organize your Azure resources and management hierarchy

Azure リソース、リソース グループ、サブスクリプションにタグを適用して、論理的な分類に整理できます。You apply tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. 各タグは、名前と値のペアで構成されます。Each tag consists of a name and a value pair. たとえば、運用環境のすべてのリソースには名前 "環境" と値 "運用" を適用できます。For example, you can apply the name "Environment" and the value "Production" to all the resources in production.

タグ付け戦略の実装方法に関する推奨事項については、「リソースの名前付けとタグ付けの意思決定ガイド」を参照してください。For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.

重要

操作のタグの名前は大文字と小文字が区別されません。Tag names are case-insensitive for operations. 大文字と小文字の区別に関係なく、タグ名を持つタグが更新または取得されます。A tag with a tag name, regardless of casing, is updated or retrieved. ただし、リソース プロバイダーでは、タグ名に指定した大文字と小文字がそのまま保持される可能性があります。However, the resource provider might keep the casing you provide for the tag name. コスト レポートにはその大文字と小文字で表示されます。You'll see that casing in cost reports.

タグの値は大文字と小文字が区別されます。Tag values are case-sensitive.

注意

この記事では、デバイスまたはサービスから個人データを削除する手順について説明します。また、これは GDPR での義務をサポートするために使用できます。This article provides steps for how to delete personal data from the device or service and can be used to support your obligations under the GDPR. GDPR に関する一般情報については、Service Trust Portal の GDPR セクションをご覧ください。If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

必要なアクセスRequired access

リソースにタグを適用するには、Microsoft.Resources/tags リソースの種類に対する書き込みアクセス権が必要です。To apply tags to a resource, you must have write access to the Microsoft.Resources/tags resource type. タグ共同作成者ロールを使用すると、エンティティ自体へのアクセス権がなくても、エンティティにタグを適用できます。The Tag Contributor role lets you apply tags to an entity without having access to the entity itself. 現時点では、タグの共同作成者ロールでは、ポータルからリソースまたはリソース グループにタグを適用することはできません。Currently, the tag contributor role can't apply tags to resources or resource groups through the portal. ポータルを使用したサブスクリプションへのタグの適用は可能です。It can apply tags to subscriptions through the portal. PowerShell と REST API によるすべてのタグ操作がサポートされます。It supports all tag operations through PowerShell and REST API.

共同作成者ロールでも、任意のエンティティにタグを適用するために必要なアクセス権が付与されます。The Contributor role also grants the required access to apply tags to any entity. 1 つのリソースの種類だけにタグを適用するには、そのリソースの共同作成者ロールを使用します。To apply tags to only one resource type, use the contributor role for that resource. たとえば、仮想マシンにタグを適用するには、仮想マシン共同作成者を使用します。For example, to apply tags to virtual machines, use the Virtual Machine Contributor.

PowerShellPowerShell

タグを適用するApply tags

Azure PowerShell には、タグを適用するために、New-AzTagUpdate-AzTag の 2 つのコマンドが用意されています。Azure PowerShell offers two commands for applying tags - New-AzTag and Update-AzTag. Az.Resources モジュール 1.12.0 以降が必要です。You must have the Az.Resources module 1.12.0 or later. Get-Module Az.Resources を使用して、お使いのバージョンを確認できます。You can check your version with Get-Module Az.Resources. そのモジュールをインストールすることも、Azure PowerShell をインストール (3.6.1 以降) することもできます。You can install that module or install Azure PowerShell 3.6.1 or later.

New-AzTag では、リソース、リソース グループ、またはサブスクリプションのすべてのタグが置き換えられます。The New-AzTag replaces all tags on the resource, resource group, or subscription. コマンドを呼び出すときに、タグを付けるエンティティのリソース ID を渡します。When calling the command, pass in the resource ID of the entity you wish to tag.

次の例では、一連のタグがストレージ アカウントに適用されます。The following example applies a set of tags to a storage account:

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

コマンドが完了すると、リソースに 2 つのタグが付いていることがわかります。When the command completes, notice that the resource has two tags.

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

異なるタグを指定してコマンドをもう一度実行すると、前のタグが削除されることに注意してください。If you run the command again but this time with different tags, notice that the earlier tags are removed.

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

既にタグがあるリソースにタグを追加するには、Update-AzTag を使用します。To add tags to a resource that already has tags, use Update-AzTag. -Operation パラメーターを Merge に設定します。Set the -Operation parameter to Merge.

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

2 つの新しいタグが既存の 2 つのタグに追加されていることに注意してください。Notice that the two new tags were added to the two existing tags.

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

各タグ名に対して設定できる値は 1 つだけです。Each tag name can have only one value. タグに新しい値を指定すると、マージ操作を使用した場合でも、古い値が置き換えられます。If you provide a new value for a tag, the old value is replaced even if you use the merge operation. 次の例では、Status タグを Normal から Green に変更します。The following example changes the Status tag from Normal to Green.

$tags = @{"Status"="Green"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge
Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

-Operation パラメーターを Replace に設定すると、既存のタグが新しいタグのセットに置き換えられます。When you set the -Operation parameter to Replace, the existing tags are replaced by the new set of tags.

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

リソースには新しいタグだけが残ります。Only the new tags remain on the resource.

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

同じコマンドを、リソース グループまたはサブスクリプションに対しても使用できます。The same commands also work with resource groups or subscriptions. タグを付けるリソース グループまたはサブスクリプションの識別子を渡します。You pass in the identifier for the resource group or subscription you want to tag.

リソース グループに新しいタグのセットを追加する場合の使用方法は、次のとおりです。To add a new set of tags to a resource group, use:

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

リソース グループのタグを更新する場合の使用方法は、次のとおりです。To update the tags for a resource group, use:

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

サブスクリプションに新しいタグのセットを追加する場合の使用方法は、次のとおりです。To add a new set of tags to a subscription, use:

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

サブスクリプションのタグを更新する場合の使用方法は、次のとおりです。To update the tags for a subscription, use:

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

1 つのリソース グループに同じ名前のリソースが複数存在する場合があります。You may have more than one resource with the same name in a resource group. その場合は、次のコマンドを使用して各リソースを設定できます。In that case, you can set each resource with the following commands:

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

タグの一覧を表示するList tags

リソース、リソース グループ、またはサブスクリプションのタグを取得するには、Get-AzTag コマンドを使用して、エンティティのリソース ID を渡します。To get the tags for a resource, resource group, or subscription, use the Get-AzTag command and pass in the resource ID for the entity.

リソースのタグを表示するには、次のように使用します。To see the tags for a resource, use:

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

リソース グループのタグを表示するには、次のように使用します。To see the tags for a resource group, use:

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

サブスクリプションのタグを表示するには、次のように使用します。To see the tags for a subscription, use:

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

タグで一覧を取得するList by tag

特定のタグ名と値を持つリソースを取得するには、次のように使用します。To get resources that have a specific tag name and value, use:

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

特定のタグ名と任意のタグ値を持つリソースを取得するには、次のように使用します。To get resources that have a specific tag name with any tag value, use:

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

特定のタグ名と値を持つリソース グループを取得するには、次のように使用します。To get resource groups that have a specific tag name and value, use:

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

タグを削除するRemove tags

特定のタグを削除するには、Update-AzTag を使用し、 -OperationDelete に設定します。To remove specific tags, use Update-AzTag and set -Operation to Delete. 削除するタグを渡します。Pass in the tags you want to delete.

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

指定したタグが削除されます。The specified tags are removed.

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

すべてのタグを削除するには、Remove-AzTag コマンドを使用します。To remove all tags, use the Remove-AzTag command.

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

Azure CLIAzure CLI

タグを適用するApply tags

Azure CLI には、タグを適用するための 2 つのコマンドが用意されています。az tag createaz tag update です。Azure CLI offers two commands for applying tags - az tag create and az tag update. Azure CLI 2.10.0 以降である必要があります。You must have Azure CLI 2.10.0 or later. az version を使用して、お使いのバージョンを確認できます。You can check your version with az version. 更新またはインストールする方法については、「Azure CLI のインストール」を参照してください。To update or install, see Install the Azure CLI.

az tag create を実行すると、リソース、リソース グループ、またはサブスクリプションのすべてのタグが置き換えられます。The az tag create replaces all tags on the resource, resource group, or subscription. コマンドを呼び出すときに、タグを付けるエンティティのリソース ID を渡します。When calling the command, pass in the resource ID of the entity you wish to tag.

次の例では、一連のタグがストレージ アカウントに適用されます。The following example applies a set of tags to a storage account:

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

コマンドが完了すると、リソースに 2 つのタグが付いていることがわかります。When the command completes, notice that the resource has two tags.

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

異なるタグを指定してコマンドをもう一度実行すると、前のタグが削除されることに注意してください。If you run the command again but this time with different tags, notice that the earlier tags are removed.

az tag create --resource-id $resource --tags Team=Compliance Environment=Production
"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

既にタグがあるリソースにタグを追加するには、az tag update を使用します。To add tags to a resource that already has tags, use az tag update. --operation パラメーターを Merge に設定します。Set the --operation parameter to Merge.

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

2 つの新しいタグが既存の 2 つのタグに追加されていることに注意してください。Notice that the two new tags were added to the two existing tags.

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

各タグ名に対して設定できる値は 1 つだけです。Each tag name can have only one value. タグに新しい値を指定すると、マージ操作を使用した場合でも、古い値が置き換えられます。If you provide a new value for a tag, the old value is replaced even if you use the merge operation. 次の例では、Status タグを Normal から Green に変更します。The following example changes the Status tag from Normal to Green.

az tag update --resource-id $resource --operation Merge --tags Status=Green
"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Green",
    "Team": "Compliance"
  }
},

--operation パラメーターを Replace に設定すると、既存のタグが新しいタグのセットに置き換えられます。When you set the --operation parameter to Replace, the existing tags are replaced by the new set of tags.

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

リソースには新しいタグだけが残ります。Only the new tags remain on the resource.

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

同じコマンドを、リソース グループまたはサブスクリプションに対しても使用できます。The same commands also work with resource groups or subscriptions. タグを付けるリソース グループまたはサブスクリプションの識別子を渡します。You pass in the identifier for the resource group or subscription you want to tag.

リソース グループに新しいタグのセットを追加する場合の使用方法は、次のとおりです。To add a new set of tags to a resource group, use:

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

リソース グループのタグを更新する場合の使用方法は、次のとおりです。To update the tags for a resource group, use:

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

サブスクリプションに新しいタグのセットを追加する場合の使用方法は、次のとおりです。To add a new set of tags to a subscription, use:

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

サブスクリプションのタグを更新する場合の使用方法は、次のとおりです。To update the tags for a subscription, use:

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

タグの一覧を表示するList tags

リソース、リソース グループ、またはサブスクリプションのタグを取得するには、az tag list コマンドを使用して、エンティティのリソース ID を渡します。To get the tags for a resource, resource group, or subscription, use the az tag list command and pass in the resource ID for the entity.

リソースのタグを表示するには、次のように使用します。To see the tags for a resource, use:

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

リソース グループのタグを表示するには、次のように使用します。To see the tags for a resource group, use:

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

サブスクリプションのタグを表示するには、次のように使用します。To see the tags for a subscription, use:

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

タグで一覧を取得するList by tag

特定のタグ名と値を持つリソースを取得するには、次のように使用します。To get resources that have a specific tag name and value, use:

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

特定のタグ名と任意のタグ値を持つリソースを取得するには、次のように使用します。To get resources that have a specific tag name with any tag value, use:

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

特定のタグ名と値を持つリソース グループを取得するには、次のように使用します。To get resource groups that have a specific tag name and value, use:

az group list --tag Dept=Finance

タグを削除するRemove tags

特定のタグを削除するには、az tag update を使用し、 --operationDelete に設定します。To remove specific tags, use az tag update and set --operation to Delete. 削除するタグを渡します。Pass in the tags you want to delete.

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

指定したタグが削除されます。The specified tags are removed.

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

すべてのタグを削除するには、az tag delete コマンドを使用します。To remove all tags, use the az tag delete command.

az tag delete --resource-id $resource

スペースを処理するHandling spaces

タグの名前または値にスペースが含まれている場合は、二重引用符で囲みます。If your tag names or values include spaces, enclose them in double quotes.

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

テンプレートTemplates

Resource Manager テンプレートによるデプロイの間に、リソース、リソース グループ、サブスクリプションにタグを付けることができます。You can tag resources, resource groups, and subscriptions during deployment with a Resource Manager template.

値を適用するApply values

次の例では、3 つのタグが適用されたストレージ アカウントがデプロイされます。The following example deploys a storage account with three tags. 2 つのタグ (DeptEnvironment) にはリテラル値が設定されます。Two of the tags (Dept and Environment) are set to literal values. 1 つのタグ (LastDeployed) には、現在の日付が既定値のパラメーターが設定されます。One tag (LastDeployed) is set to a parameter that defaults to the current date.

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

オブジェクトを適用するApply an object

複数のタグを格納するオブジェクト パラメーターを定義し、そのオブジェクトをタグ要素に適用できます。You can define an object parameter that stores several tags, and apply that object to the tag element. この方法では、オブジェクトは異なるプロパティを持つことができるため、前の例より柔軟性が高くなります。This approach provides more flexibility than the previous example because the object can have different properties. オブジェクト内の各プロパティがリソースの個々のタグになります。Each property in the object becomes a separate tag for the resource. 次の例は、タグ要素に適用される tagValues という名前のパラメーターを示しています。The following example has a parameter named tagValues that is applied to the tag element.

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

JSON 文字列を適用するApply a JSON string

1 つのタグに複数の値を格納するには、値を表す JSON 文字列を適用します。To store many values in a single tag, apply a JSON string that represents the values. JSON 文字列全体は、1 つのタグとして格納されます。256 文字以下にする必要があります。The entire JSON string is stored as one tag that can't exceed 256 characters. 次の例は、JSON 文字列で複数の値を格納する CostCenter という名前の 1 つのタグを示しています。The following example has a single tag named CostCenter that contains several values from a JSON string:

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

リソース グループからタグを適用するApply tags from resource group

リソース グループからリソースにタグを適用するには、resourceGroup() 関数を使います。To apply tags from a resource group to a resource, use the resourceGroup() function. タグの値を取得するときは、tags.tag-name 構文ではなく tags[tag-name] 構文を使います。これは、ドット表記では一部の文字が正しく解析されないためです。When getting the tag value, use the tags[tag-name] syntax instead of the tags.tag-name syntax, because some characters aren't parsed correctly in the dot notation.

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

リソース グループまたはサブスクリプションにタグを適用するApply tags to resource groups or subscriptions

リソースの種類 Microsoft.Resources/tags をデプロイすることにより、リソース グループまたはサブスクリプションにタグを追加できます。You can add tags to a resource group or subscription by deploying the Microsoft.Resources/tags resource type. タグは、デプロイのターゲット リソース グループまたはサブスクリプションに適用されます。The tags are applied to the target resource group or subscription for the deployment. テンプレートをデプロイするたびに、以前に適用したタグがすべて置き換えられます。Each time you deploy the template you replace any tags there were previously applied.

{
    "$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"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.Resources/tags",
            "name": "default",
            "apiVersion": "2019-10-01",
            "dependsOn": [],
            "properties": {
                "tags": {
                    "[parameters('tagName')]": "[parameters('tagValue')]"
                }
            }
        }
    ]
}

リソース グループにタグを適用するには、PowerShell または Azure CLI を使用します。To apply the tags to a resource group, use either PowerShell or Azure CLI. タグを付けるリソース グループにデプロイします。Deploy to the resource group that you want to tag.

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

サブスクリプションにタグを適用するには、PowerShell または Azure CLI を使用します。To apply the tags to a subscription, use either PowerShell or Azure CLI. タグを付けるサブスクリプションにデプロイします。Deploy to the subscription that you want to tag.

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

サブスクリプション デプロイの詳細については、「サブスクリプション レベルでリソース グループとリソースを作成する」を参照してください。For more information about subscription deployments, see Create resource groups and resources at the subscription level.

次のテンプレートでは、オブジェクトからリソース グループまたはサブスクリプションにタグが追加されます。The following template adds the tags from an object to either a resource group or subscription.

"$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"
            }
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.Resources/tags",
            "name": "default",
            "apiVersion": "2019-10-01",
            "dependsOn": [],
            "properties": {
                "tags": "[parameters('tags')]"
            }
        }
    ]
}

ポータルPortal

タグを適用するために必要なアクセス権がユーザーに与えられていない場合は、 [タグ共同作成者] ロールをユーザーに割り当てることができます。If a user doesn't have the required access for applying tags, you can assign the Tag Contributor role to the user. 詳細については、「チュートリアル:RBAC と Azure portal を使用して Azure リソースへのアクセス権をユーザーに付与する」を参照してください。For more information, see Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal.

  1. リソースまたはリソース グループのタグを表示するには、概要で既存のタグを探します。To view the tags for a resource or a resource group, look for existing tags in the overview. これまでにタグを適用していない場合、リストは空です。If you have not previously applied tags, the list is empty.

    リソースまたはリソース グループのタグの表示

  2. タグを追加するには、 [タグを追加するにはここをクリックします] を選択します。To add a tag, select Click here to add tags.

  3. 名前と値を指定します。Provide a name and value.

    タグの追加

  4. 必要に応じてタグの追加を続行します。Continue adding tags as needed. 操作が完了したら、 [保存] をクリックします。When done, select Save.

    タグの保存

  5. タグは、概要に表示されます。The tags are now displayed in the overview.

    タグの表示

  6. タグを追加または削除するには、 [変更] を選択します。To add or delete a tag, select change.

  7. タグを削除するには、ごみ箱アイコンを選択します。To delete a tag, select the trash icon. 次に、 [保存] を選択します。Then, select Save.

    タグの削除

複数のリソースにタグを一括で割り当てるには:To bulk assign tags to multiple resources:

  1. リソースのリストで、タグを割り当てるリソースのチェックボックスをオンにします。From any list of resources, select the checkbox for the resources you want to assign the tag. 次に、 [タグの割り当て] を選択します。Then, select Assign tags.

    複数のリソースの選択

  2. 名前と値を追加します。Add names and values. 操作が完了したら、 [保存] をクリックします。When done, select Save.

    割り当ての選択

タグが付いているすべてのリソースを表示するには:To view all resources with a tag:

  1. Azure portal のメニューでタグを検索します。On the Azure portal menu, search for tags. 使用可能なオプションから、それを選択します。Select it from the available options.

    タグで検索する

  2. リソースを表示するタグを選択します。Select the tag for viewing resources.

    タグの選択

  3. そのタグの付いたすべてのリソースが表示されます。All resources with that tag are displayed.

    タグでリソースを表示する

REST APIREST API

Azure REST API でタグを操作するには、次のように使用します。To work with tags through the Azure REST API, use:

タグを継承するInherit tags

リソース グループまたはサブスクリプションに適用されたタグは、リソースによって継承されません。Tags applied to the resource group or subscription aren't inherited by the resources. サブスクリプションまたはリソース グループのタグをリソースに適用するには、タグに関する Azure Policy についての記事を参照してください。To apply tags from a subscription or resource group to the resources, see Azure Policies - tags.

タグと課金Tags and billing

タグを使用して課金データをグループ化できます。You can use tags to group your billing data. たとえば、異なる組織向けに複数の VM を実行している場合は、タグを使用して、コスト センターごとに使用状況をグループ化します。For example, if you're running multiple VMs for different organizations, use the tags to group usage by cost center. また、タグを使用すると、運用環境で実行されている VM の課金データなどの、ランタイム環境ごとにコストを分類することもできます。You can also use tags to categorize costs by runtime environment, such as the billing usage for VMs running in the production environment.

タグに関する情報は、Azure Resource Usage API や Rate Card API、またはコンマ区切り値 (CSV) ファイルから取得できます。You can retrieve information about tags through the Azure Resource Usage and Rate Card APIs or the usage comma-separated values (CSV) file. Azure portal から使用状況ファイルをダウンロードします。You download the usage file from the Azure portal. 詳細については、「Azure の請求書と毎日の使用状況データをダウンロードまたは表示する」を参照してください。For more information, see Download or view your Azure billing invoice and daily usage data. Azure アカウント センターから使用状況ファイルをダウンロードする場合は、 [バージョン 2] を選択します。When downloading the usage file from the Azure Account Center, select Version 2. 課金のタグがサポートされているサービスの場合、タグは [Tags] 列に表示されます。For services that support tags with billing, the tags appear in the Tags column.

REST API の操作については、「 Azure Billing REST API Reference (Azure Billing REST API リファレンス)」を参照してください。For REST API operations, see Azure Billing REST API Reference.

制限事項Limitations

タグには次の制限事項が適用されます。The following limitations apply to tags:

  • すべてのリソースの種類で、タグがサポートされるわけではありません。Not all resource types support tags. リソースの種類にタグを適用することができるかどうかを確認するには、Azure リソースに対するタグのサポートに関する記事を参照してください。To determine if you can apply a tag to a resource type, see Tag support for Azure resources.

  • 各リソース、リソース グループ、サブスクリプションには、最大で 50 個のタグ名と値のペアを付けることができます。Each resource, resource group, and subscription can have a maximum of 50 tag name/value pairs. 許可される最大数よりも多くのタグを適用する必要がある場合は、タグ値に JSON 文字列を使用します。If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. JSON 文字列には、1 つのタグ名に適用される値を多数含めることができます。The JSON string can contain many values that are applied to a single tag name. リソース グループまたはサブスクリプションには、それぞれ 50 個のタグ名と値のペアが付けられたリソースを多数含めることができます。A resource group or subscription can contain many resources that each have 50 tag name/value pairs.

  • タグ名は 512 文字まで、タグ値は 256 文字までに制限されます。The tag name is limited to 512 characters, and the tag value is limited to 256 characters. ストレージ アカウントについては、タグ名は 128 文字まで、タグ値は 256 文字までに制限されます。For storage accounts, the tag name is limited to 128 characters, and the tag value is limited to 256 characters.

  • Cloud Services など、クラシック リソースにタグを適用することはできません。Tags can't be applied to classic resources such as Cloud Services.

  • タグ名には、これらの文字を含めることはできません: <>%&\?/Tag names can't contain these characters: <, >, %, &, \, ?, /

    注意

    また、Azure DNS ゾーンと Traffic Manager サービスでは現在、タグ内でスペースを使用することはできません。Currently, Azure DNS zones and Traffic Manager services also don't allow the use of spaces in the tag.

    Azure Front Door では、タグ名に # を使用できません。Azure Front Door doesn't support the use of # in the tag name.

    Azure Automation と Azure CDN では、リソースで 15 個のタグのみがサポートされています。Azure Automation and Azure CDN only support 15 tags on resources.

次のステップNext steps