Azure Resource Manager でのデプロイ履歴の表示

[アーティクル]
03/20/2024

Azure Resource Manager では、デプロイ履歴を表示することができます。過去のデプロイにおける特定の操作を調べ、どのリソースがデプロイされたかを確認できます。この履歴には、エラーに関する情報が含まれます。

リソースグループのデプロイ履歴は、800 件のデプロイに制限されます。この制限に近づくと、デプロイは履歴から自動的に削除されます。詳細については、「デプロイ履歴からの自動削除」を参照してください。

特定のデプロイエラーの解決方法については、「よくある Azure デプロイエラーのトラブルシューティングに関する記事」を参照してください。

リソースグループのデプロイ

リソースグループのデプロイの詳細を表示するには、Azure portal、PowerShell、Azure CLI、または REST API を使用します。

調べたいリソースグループを選択します。
[デプロイ] の下のリンクを選択します。
デプロイ履歴からいずれかのデプロイを選択します。
デプロイの概要が表示され、関連付け ID を確認できます。

リソースグループのすべてのデプロイを一覧表示するには、Get-AzResourceGroupDeployment コマンドを使用します。

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

リソースグループから特定のデプロイを取得するには、DeploymentName パラメーターを追加します。

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

相関 ID を取得するには、以下を使用します。

(Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment).CorrelationId

リソースグループのすべてのデプロイを一覧表示するには、az deployment group list を使用します。

az deployment group list --resource-group ExampleGroup

特定のデプロイを取得するには、az deployment group show を使用します。

az deployment group show --resource-group ExampleGroup --name ExampleDeployment

相関 ID を取得するには、以下を使用します。

az deployment group show --resource-group ExampleGroup --name ExampleDeployment --query properties.correlationId

リソースグループのデプロイを一覧表示するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ - リソースグループごとの一覧表示」をご覧ください。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/?api-version={api-version}

特定のデプロイを取得するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ - 取得」を参照してください。

GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}?api-version={api-version}

応答に関連付け ID が含まれています。

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

サブスクリプションへのデプロイ

サブスクリプションへのデプロイの履歴を表示できます。

調べたいサブスクリプションを選択します。
左側のペインで [デプロイ] を選択します。
デプロイ履歴からいずれかのデプロイを選択します。
デプロイの概要が表示され、関連付け ID を確認できます。

現在のサブスクリプションのすべてのデプロイを一覧表示するには、Get-AzSubscriptionDeployment コマンドを使用します。このコマンドは、Get-AzDeployment と同等です。

Get-AzSubscriptionDeployment

サブスクリプションから特定のデプロイを取得するには、Name パラメーターを追加します。

Get-AzSubscriptionDeployment -Name ExampleDeployment

相関 ID を取得するには、以下を使用します。

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

現在のサブスクリプションのすべてのデプロイを一覧表示するには、az deployment sub list を使用します。

az deployment sub list

特定のデプロイを取得するには、az deployment sub show を使用します。

az deployment sub show --name ExampleDeployment

相関 ID を取得するには、以下を使用します。

az deployment sub show --name ExampleDeployment --query properties.correlationId

サブスクリプションのデプロイを一覧表示するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ - サブスクリプションスコープでの一覧表示」をご覧ください。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/?api-version={api-version}

特定のデプロイを取得するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ - サブスクリプションスコープでの取得」をご覧ください。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

応答に関連付け ID が含まれています。

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

管理グループへのデプロイ

管理グループへのデプロイの履歴を表示できます。

調べたい管理グループを選択します。管理グループに関する詳細を表示するための十分なアクセス許可がない場合は、選択することはできません。
左側のペインで [デプロイ] を選択します。
デプロイ履歴からいずれかのデプロイを選択します。
デプロイの概要が表示され、関連付け ID を確認できます。

管理グループのすべてのデプロイを一覧表示するには、Get-AzManagementGroupDeployment コマンドを使用します。管理グループのデプロイを表示するための十分なアクセス許可がない場合は、エラーが表示されます。

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

管理グループから特定のデプロイを取得するには、Name パラメーターを追加します。

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

相関 ID を取得するには、以下を使用します。

(Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment).CorrelationId

管理グループのすべてのデプロイを一覧表示するには、az deployment mg list を使用します。管理グループのデプロイを表示するための十分なアクセス許可がない場合は、エラーが表示されます。

az deployment mg list --management-group-id examplemg

特定のデプロイを取得するには、az deployment mg show を使用します。

az deployment mg show --management-group-id examplemg --name ExampleDeployment

相関 ID を取得するには、以下を使用します。

az deployment mg show --management-group-id examplemg --name ExampleDeployment --query properties.correlationId

管理グループのデプロイを一覧表示するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ - 管理グループスコープでの一覧表示」をご覧ください。管理グループのデプロイを表示するための十分なアクセス許可がない場合は、エラーが表示されます。

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/?api-version={api-version}

特定のデプロイを取得するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ - 管理グループスコープでの取得」をご覧ください。

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

応答に関連付け ID が含まれています。

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

テナントへのデプロイ

テナントへのデプロイの履歴を表示できます。

現在、ポータルにはテナントのデプロイは表示されません。

現在のテナントのすべてのデプロイを一覧表示するには、Get-AzTenantDeployment コマンドを使用します。テナントのデプロイを表示するための十分なアクセス許可がない場合は、エラーが表示されます。

Get-AzTenantDeployment

現在のテナントから特定のデプロイを取得するには、Name パラメーターを追加します。

Get-AzTenantDeployment -Name ExampleDeployment

相関 ID を取得するには、以下を使用します。

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

現在のテナントのすべてのデプロイを一覧表示するには、az deployment tenant list を使用します。テナントのデプロイを表示するための十分なアクセス許可がない場合は、エラーが表示されます。

az deployment tenant list

特定のデプロイを取得するには、az deployment tenant show を使用します。

az deployment tenant show --name ExampleDeployment

相関 ID を取得するには、以下を使用します。

az deployment tenant show --name ExampleDeployment --query properties.correlationId

現在のテナントのデプロイを一覧表示するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ - テナントスコープでの一覧表示」をご覧ください。テナントのデプロイを表示するための十分なアクセス許可がない場合は、エラーが表示されます。

GET https://management.azure.com/providers/Microsoft.Resources/deployments/?api-version={api-version}

特定のデプロイを取得するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ - テナントスコープでの取得」をご覧ください。

GET https://management.azure.com/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

応答に関連付け ID が含まれています。

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

デプロイ操作とエラーメッセージ

各デプロイには、複数の操作が含まれる可能性があります。デプロイの詳細については、デプロイの操作に関する記事をご覧ください。デプロイが失敗すると、デプロイ操作にエラーメッセージが含まれます。

デプロイの概要で、 [操作の詳細] を選択します。
該当するデプロイ手順の詳細が表示されます。エラーが発生した場合は、この詳細にエラーメッセージが表示されます。

リソースグループにデプロイするためのデプロイ操作を表示するには、Get-AzResourceGroupDeploymentOperation コマンドを使用します。

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

失敗した操作を表示するには、Failed 状態で操作をフィルターします。

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }

失敗した操作のステータスメッセージを取得するには、次のコマンドを使用します。

(Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }).StatusMessage

他のスコープのデプロイ操作を表示するには、次を使用します。

リソースグループにデプロイするためのデプロイ操作を表示するには、az deployment operation group list コマンドを使用します。 Azure CLI 2.6.0 以降である必要があります。

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment

失敗した操作を表示するには、Failed 状態で操作をフィルターします。

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed']"

失敗した操作のステータスメッセージを取得するには、次のコマンドを使用します。

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed'].properties.statusMessage.error"

他のスコープのデプロイ操作を表示するには、次を使用します。

デプロイ操作を取得するには、次の操作を行います。要求で使用する最新の API バージョン番号については、「デプロイ操作 - 一覧表示」を参照してください。

GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}/operations?$skiptoken={skiptoken}&api-version={api-version}

応答にエラーメッセージが含まれています。

{
  "value": [
    {
      "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/examplegroup/providers/Microsoft.Resources/deployments/exampledeployment/operations/1234567890ABCDEF",
      "operationId": "1234567890ABCDEF",
      "properties": {
        "provisioningOperation": "Create",
        "provisioningState": "Failed",
        "timestamp": "2019-11-26T14:18:36.3177613Z",
        "duration": "PT21.0580179S",
        "trackingId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "serviceRequestId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "statusCode": "BadRequest",
        "statusMessage": {
          "error": {
            "code": "InvalidAccountType",
            "message": "The AccountType Standard_LRS1 is invalid. For more information, see - https://aka.ms/storageaccountskus"
          }
        },
        "targetResource": {
          "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/examplegroup/providers/Microsoft.Storage/storageAccounts/storage",
          "resourceType": "Microsoft.Storage/storageAccounts",
          "resourceName": "storage"
        }
      }
    },
    ...
  ]
}

他のスコープのデプロイ操作を表示するには、次を使用します。

次のステップ

特定のデプロイエラーの解決方法については、「よくある Azure デプロイエラーのトラブルシューティングに関する記事」を参照してください。
履歴でのデプロイの管理方法の詳細については、「デプロイ履歴からの自動削除」を参照してください。
デプロイ前に、テンプレートによって行われる変更をプレビューするには、「ARM テンプレートのデプロイの what-if 操作」を参照してください。

次の方法で共有

Azure Resource Manager でのデプロイ履歴の表示

関連付け ID とサポート

リソースグループのデプロイ

サブスクリプションへのデプロイ

管理グループへのデプロイ

テナントへのデプロイ

デプロイ操作とエラーメッセージ

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Resource Manager でのデプロイ履歴の表示

関連付け ID とサポート

リソース グループのデプロイ

サブスクリプションへのデプロイ

管理グループへのデプロイ

テナントへのデプロイ

デプロイ操作とエラー メッセージ

次のステップ

フィードバック

その他のリソース

リソースグループのデプロイ

デプロイ操作とエラーメッセージ