Wyświetlanie historii wdrażania za pomocą usługi Azure Resource Manager

Artykuł
03/20/2024

Usługa Azure Resource Manager umożliwia wyświetlanie historii wdrożenia. Można sprawdzić konkretne operacje w poprzednich wdrożeniach i zobaczyć, które zasoby zostały wdrożone. Ta historia zawiera informacje o błędach.

Historia wdrażania grupy zasobów jest ograniczona do 800 wdrożeń. W miarę zbliżania się do limitu wdrożenia są automatycznie usuwane z historii. Aby uzyskać więcej informacji, zobacz Automatyczne usuwanie z historii wdrożenia.

Aby uzyskać pomoc dotyczącą rozwiązywania konkretnych błędów wdrażania, zobacz Rozwiązywanie typowych błędów wdrażania platformy Azure.

Identyfikator korelacji i obsługa techniczna

Każde wdrożenie ma identyfikator korelacji, który służy do śledzenia powiązanych zdarzeń. Jeśli tworzysz żądanie pomoc techniczna platformy Azure, pomoc techniczna może poprosić Cię o identyfikator korelacji. Obsługa używa identyfikatora korelacji do identyfikowania operacji wdrożenia, które zakończyły się niepowodzeniem.

W przykładach w tym artykule pokazano, jak pobrać identyfikator korelacji.

Wdrożenia grup zasobów

Szczegółowe informacje o wdrożeniu grupy zasobów można wyświetlić za pomocą Azure Portal, programu PowerShell, interfejsu wiersza polecenia platformy Azure lub interfejsu API REST.

Wybierz grupę zasobów , którą chcesz zbadać.
Wybierz link w obszarze Wdrożenia.
Wybierz jedno z wdrożeń z historii wdrożenia.
Zostanie wyświetlone podsumowanie wdrożenia, w tym identyfikator korelacji.

Aby wyświetlić listę wszystkich wdrożeń dla grupy zasobów, użyj polecenia Get-AzResourceGroupDeployment .

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Aby uzyskać określone wdrożenie z grupy zasobów, dodaj DeploymentName parametr .

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Aby uzyskać identyfikator korelacji, użyj:

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

Aby wyświetlić listę wszystkich wdrożeń dla grupy zasobów, użyj polecenia az deployment group list.

az deployment group list --resource-group ExampleGroup

Aby uzyskać określone wdrożenie, użyj polecenia az deployment group show.

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

Aby uzyskać identyfikator korelacji, użyj:

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

Aby wyświetlić listę wdrożeń dla grupy zasobów, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Deployments - List By Resource Group (Wdrożenia — lista według grupy zasobów).

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

Aby uzyskać określone wdrożenie, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Deployments - Get (Wdrożenia — pobieranie).

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

Odpowiedź zawiera identyfikator korelacji.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Wdrożenia subskrypcji

Historię wdrożeń można wyświetlić w subskrypcji.

Wybierz subskrypcję , którą chcesz zbadać.
W okienku po lewej stronie wybierz pozycję Wdrożenia.
Wybierz jedno z wdrożeń z historii wdrożenia.
Zostanie wyświetlone podsumowanie wdrożenia, w tym identyfikator korelacji.

Aby wyświetlić listę wszystkich wdrożeń dla bieżącej subskrypcji, użyj Get-AzSubscriptionDeployment polecenia . To polecenie jest równoważne get-AzDeployment.

Get-AzSubscriptionDeployment

Aby uzyskać określone wdrożenie z subskrypcji, dodaj Name parametr .

Get-AzSubscriptionDeployment -Name ExampleDeployment

Aby uzyskać identyfikator korelacji, użyj:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Aby wyświetlić listę wszystkich wdrożeń dla bieżącej subskrypcji, użyj polecenia az deployment sub list.

az deployment sub list

Aby uzyskać określone wdrożenie, użyj polecenia az deployment sub show.

az deployment sub show --name ExampleDeployment

Aby uzyskać identyfikator korelacji, użyj:

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

Aby wyświetlić listę wdrożeń dla subskrypcji, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Deployments - List At Subscription Scope (Wdrożenia — lista w zakresie subskrypcji).

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

Aby uzyskać określone wdrożenie, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Deployments - Get At Subscription Scope (Wdrożenia — uzyskiwanie w zakresie subskrypcji).

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

Odpowiedź zawiera identyfikator korelacji.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Wdrożenia grup zarządzania

Historię wdrożeń można wyświetlić w grupie zarządzania.

Wybierz grupę zarządzania , którą chcesz zbadać. Jeśli nie masz wystarczających uprawnień do wyświetlania szczegółów dotyczących grupy zarządzania, nie będzie można jej wybrać.
W okienku po lewej stronie wybierz pozycję Wdrożenia.
Wybierz jedno z wdrożeń z historii wdrożenia.
Zostanie wyświetlone podsumowanie wdrożenia, w tym identyfikator korelacji.

Aby wyświetlić listę wszystkich wdrożeń dla grupy zarządzania, użyj polecenia Get-AzManagementGroupDeployment . Jeśli nie masz wystarczających uprawnień do wyświetlania wdrożeń dla grupy zarządzania, zostanie wyświetlony błąd.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Aby uzyskać określone wdrożenie z grupy zarządzania, dodaj Name parametr .

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Aby uzyskać identyfikator korelacji, użyj:

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

Aby wyświetlić listę wszystkich wdrożeń dla grupy zarządzania, użyj polecenia az deployment mg list. Jeśli nie masz wystarczających uprawnień do wyświetlania wdrożeń dla grupy zarządzania, zostanie wyświetlony błąd.

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

Aby uzyskać określone wdrożenie, użyj polecenia az deployment mg show.

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

Aby uzyskać identyfikator korelacji, użyj:

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

Aby wyświetlić listę wdrożeń dla grupy zarządzania, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Deployments - List At Management Group Scope (Wdrożenia — lista w zakresie grupy zarządzania). Jeśli nie masz wystarczających uprawnień do wyświetlania wdrożeń dla grupy zarządzania, zostanie wyświetlony błąd.

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

Aby uzyskać określone wdrożenie, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Deployments - Get At Management Group Scope (Wdrożenia — uzyskiwanie w zakresie grupy zarządzania).

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

Odpowiedź zawiera identyfikator korelacji.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Wdrożenia dzierżawy

Historię wdrożeń można wyświetlić w dzierżawie.

W portalu nie są obecnie wyświetlane wdrożenia dzierżawy.

Aby wyświetlić listę wszystkich wdrożeń dla bieżącej dzierżawy, użyj polecenia Get-AzTenantDeployment . Jeśli nie masz wystarczających uprawnień do wyświetlania wdrożeń dla dzierżawy, zostanie wyświetlony błąd.

Get-AzTenantDeployment

Aby uzyskać określone wdrożenie z bieżącej dzierżawy, dodaj Name parametr .

Get-AzTenantDeployment -Name ExampleDeployment

Aby uzyskać identyfikator korelacji, użyj:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Aby wyświetlić listę wszystkich wdrożeń dla bieżącej dzierżawy, użyj polecenia az deployment tenant list. Jeśli nie masz wystarczających uprawnień do wyświetlania wdrożeń dla dzierżawy, zostanie wyświetlony błąd.

az deployment tenant list

Aby uzyskać określone wdrożenie, użyj polecenia az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Aby uzyskać identyfikator korelacji, użyj:

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

Aby wyświetlić listę wdrożeń dla bieżącej dzierżawy, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Deployments - List At Tenant Scope (Wdrożenia — lista w zakresie dzierżawy). Jeśli nie masz wystarczających uprawnień do wyświetlania wdrożeń dla dzierżawy, zostanie wyświetlony błąd.

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

Aby uzyskać określone wdrożenie, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Deployments - Get At Tenant Scope (Wdrożenia — uzyskiwanie w zakresie dzierżawy).

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

Odpowiedź zawiera identyfikator korelacji.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Operacje wdrażania i komunikat o błędzie

Każde wdrożenie może obejmować wiele operacji. Aby wyświetlić więcej szczegółów dotyczących wdrożenia, wyświetl operacje wdrażania. Gdy wdrożenie zakończy się niepowodzeniem, operacje wdrażania zawierają komunikat o błędzie.

W podsumowaniu wdrożenia wybierz pozycję Szczegóły operacji.
Zostaną wyświetlone szczegóły dotyczące tego kroku wdrożenia. W przypadku wystąpienia błędu szczegóły zawierają komunikat o błędzie.

Aby wyświetlić operacje wdrażania dla wdrożenia w grupie zasobów, użyj polecenia Get-AzResourceGroupDeploymentOperation .

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Aby wyświetlić operacje zakończone niepowodzeniem, operacje filtrowania ze stanem Niepowodzenie .

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

Aby uzyskać komunikat o stanie operacji, które zakończyły się niepowodzeniem, użyj następującego polecenia:

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

Aby wyświetlić operacje wdrażania dla innych zakresów, użyj:

Aby wyświetlić operacje wdrażania dla wdrożenia w grupie zasobów, użyj polecenia az deployment operation group list . Musisz mieć interfejs wiersza polecenia platformy Azure w wersji 2.6.0 lub nowszej.

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

Aby wyświetlić operacje zakończone niepowodzeniem, operacje filtrowania ze stanem Niepowodzenie .

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

Aby uzyskać komunikat o stanie operacji, które zakończyły się niepowodzeniem, użyj następującego polecenia:

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

Aby wyświetlić operacje wdrażania dla innych zakresów, użyj:

Aby uzyskać operacje wdrażania, użyj następującej operacji. Aby uzyskać najnowszy numer wersji interfejsu API do użycia w żądaniu, zobacz Operacje wdrażania — lista.

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}

Odpowiedź zawiera komunikat o błędzie.

{
  "value": [
    {
      "id": "/subscriptions/11111111-1111-1111-1111-111111111111/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": "11111111-1111-1111-1111-111111111111",
        "serviceRequestId": "11111111-1111-1111-1111-111111111111",
        "statusCode": "BadRequest",
        "statusMessage": {
          "error": {
            "code": "InvalidAccountType",
            "message": "The AccountType Standard_LRS1 is invalid. For more information, see - https://aka.ms/storageaccountskus"
          }
        },
        "targetResource": {
          "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/examplegroup/providers/Microsoft.Storage/storageAccounts/storage",
          "resourceType": "Microsoft.Storage/storageAccounts",
          "resourceName": "storage"
        }
      }
    },
    ...
  ]
}

Aby wyświetlić operacje wdrażania dla innych zakresów, użyj:

Następne kroki

Aby uzyskać pomoc dotyczącą rozwiązywania określonych błędów wdrażania, zobacz Rozwiązywanie typowych błędów wdrażania platformy Azure.
Aby dowiedzieć się, jak wdrożenia są zarządzane w historii, zobacz Automatyczne usuwanie z historii wdrożenia.
Aby wyświetlić podgląd zmian szablonu przed wdrożeniem, zobacz operację analizy co-jeżeli wdrożenia szablonu usługi ARM.

Share via

Wyświetlanie historii wdrażania za pomocą usługi Azure Resource Manager

Identyfikator korelacji i obsługa techniczna

Wdrożenia grup zasobów

Wdrożenia subskrypcji

Wdrożenia grup zarządzania

Wdrożenia dzierżawy

Operacje wdrażania i komunikat o błędzie

Następne kroki

Dodatkowe zasoby