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

Usługa Azure Resource Manager umożliwia wyświetlanie historii wdrażania. Można sprawdzić konkretne operacje w poprzednich wdrożeniach i zobaczyć, które zasoby zostały wdrożone. Ta historia zawiera informacje o wszelkich 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

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 dla wdrożenia, które zakończyło 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 pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia platformy Azure lub interfejsu API REST.

Portal

1. Wybierz grupę zasobów, którą chcesz zbadać.

   

2. Wybierz link w obszarze Wdrożenia.

   

3. Wybierz jedno z wdrożeń z historii wdrażania.

   

4. Zostanie wyświetlone podsumowanie wdrożenia, w tym identyfikator korelacji.

   

Program PowerShell

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

Interfejs wiersza polecenia platformy Azure

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

HTTP

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 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 Wdrożenia — pobierz.

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": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Wdrożenia subskrypcji

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

Portal

1. Wybierz subskrypcję, którą chcesz zbadać.

   

2. W okienku po lewej stronie wybierz pozycję Wdrożenia.

   

3. Wybierz jedno z wdrożeń z historii wdrażania.

   

4. Zostanie wyświetlone podsumowanie wdrożenia, w tym identyfikator korelacji.

   

Program PowerShell

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

Interfejs wiersza polecenia platformy Azure

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

HTTP

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": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Wdrożenia grup zarządzania

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

Portal

1. Wybierz grupę zarządzania, którą chcesz zbadać. Jeśli nie masz wystarczających uprawnień, aby wyświetlić szczegółowe informacje o grupie zarządzania, nie będzie można jej wybrać.

   

2. W okienku po lewej stronie wybierz pozycję Wdrożenia.

   

3. Wybierz jedno z wdrożeń z historii wdrażania.

   

4. Zostanie wyświetlone podsumowanie wdrożenia, w tym identyfikator korelacji.

   

Program PowerShell

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

Interfejs wiersza polecenia platformy Azure

Aby wyświetlić listę wszystkich wdrożeń 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

HTTP

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 zakresu 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": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Wdrażanie dzierżawców

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

Portal

Portal nie pokazuje obecnie wdrożeń dzierżawy.

Program PowerShell

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

Interfejs wiersza polecenia platformy Azure

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

HTTP

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 zakresu 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": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

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.

Portal

1. W podsumowaniu wdrożenia wybierz pozycję Szczegóły operacji.

   

2. Zostaną wyświetlone szczegółowe informacje dotyczące tego kroku wdrożenia. W przypadku wystąpienia błędu szczegóły zawierają komunikat o błędzie.

   

Program PowerShell

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:

• Get-AzDeploymentOperation
• Get-AzManagementGroupDeploymentOperation
• Get-AzTenantDeploymentOperation

Interfejs wiersza polecenia platformy Azure

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:

• az deployment operation sub list
• az deployment operation mg list
• az deployment operation tenant list.

HTTP

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/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"
        }
      }
    },
    ...
  ]
}

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

• Operacje wdrażania — lista w zakresie subskrypcji
• Operacje wdrażania — lista w zakresie grupy zarządzania
• Operacje wdrażania — lista w zakresie dzierżawy

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 w szablonie przed wdrożeniem, zobacz Wdrażanie szablonu usługi ARM — operacja analizy warunkowej.