Anzeigen des Bereitstellungsverlaufs mit Azure Resource Manager

Artikel
03/20/2024

Mit Azure Resource Manager können Sie den Bereitstellungsverlauf anzeigen. Sie können bestimmte Vorgänge in früheren Bereitstellungen überprüfen und sehen, welche Ressourcen bereitgestellt wurden. Dieser Verlauf enthält Informationen zu Fehlern.

Der Bereitstellungsverlauf einer Ressourcengruppe ist auf 800 Bereitstellungen beschränkt. Wenn Sie den Grenzwert fast erreicht haben, werden Bereitstellungen automatisch aus dem Verlauf gelöscht. Weitere Informationen finden Sie unter Automatische Löschungen aus dem Bereitstellungsverlauf.

Hilfe zum Beheben bestimmter Bereitstellungsfehler finden Sie unter Problembehandlung von häufigen Azure-Bereitstellungsfehlern.

Korrelations-ID und Unterstützung

Jede Bereitstellung verfügt über eine Korrelations-ID, die zum Nachverfolgen verwandter Ereignisse verwendet wird. Wenn Sie eine Azure-Supportanfrage erstellen, werden Sie vom Support unter Umständen nach der Korrelations-ID gefragt. Der Support verwendet die Korrelations-ID, um die Vorgänge für die fehlerhafte Bereitstellung zu identifizieren.

Die Beispiele in diesem Artikel zeigen, wie Sie die Korrelations-ID abrufen.

Bereitstellungen von Ressourcengruppen

Sie können Details zur Bereitstellung einer Ressourcengruppe über das Azure-Portal, PowerShell, die Azure CLI oder REST-API anzeigen.

Wählen Sie die zu untersuchende Ressourcengruppe aus.
Wählen Sie den Link unter Bereitstellungen aus.
Wählen Sie eine der Bereitstellungen aus dem Bereitstellungsverlauf aus.
Es wird eine Zusammenfassung der Bereitstellung angezeigt, einschließlich der Korrelations-ID.

Um alle Bereitstellungen für eine Ressourcengruppe aufzulisten, verwenden Sie den Befehl Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Um eine bestimmte Bereitstellung aus einer Ressourcengruppe abzurufen, fügen Sie den Parameter DeploymentName hinzu.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Gehen Sie folgendermaßen vor, um die Korrelations-ID abzurufen:

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

Um alle Bereitstellungen für eine Ressourcengruppe aufzulisten, verwenden Sie az deployment group list.

az deployment group list --resource-group ExampleGroup

Um eine bestimmte Bereitstellung abzurufen, verwenden Sie az deployment group show.

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

Gehen Sie folgendermaßen vor, um die Korrelations-ID abzurufen:

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

Um die Bereitstellung für eine Ressourcengruppe aufzulisten, verwenden Sie den folgenden Vorgang. Informationen zur neuesten API-Versionsnummer, die in der Anforderung verwendet werden soll, finden Sie unter Bereitstellungen – Liste nach Ressourcengruppe.

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

Um eine bestimmte Bereitstellung zu erhalten, verwenden Sie den folgenden Vorgang. Informationen zur neuesten API-Versionsnummer, die in der Anforderung verwendet werden soll, finden Sie unter Bereitstellungen – Abrufen.

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

Die Antwort enthält die Korrelations-ID.

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

Abonnementbereitstellungen

Sie können den Verlauf von Bereitstellungen in einem Abonnement einsehen.

Wählen Sie das Abonnement aus, das Sie untersuchen möchten.
Wählen Sie im linken Bereich Bereitstellungen aus.
Wählen Sie eine der Bereitstellungen aus dem Bereitstellungsverlauf aus.
Es wird eine Zusammenfassung der Bereitstellung angezeigt, einschließlich der Korrelations-ID.

Führen Sie den Befehl Get-AzSubscriptionDeployment aus, um alle Bereitstellungen für das aktuelle Abonnement aufzulisten. Dieser Befehl entspricht Get-AzDeployment.

Get-AzSubscriptionDeployment

Um eine bestimmte Bereitstellung aus einem Abonnement abzurufen, fügen Sie den Parameter Name hinzu.

Get-AzSubscriptionDeployment -Name ExampleDeployment

Gehen Sie folgendermaßen vor, um die Korrelations-ID abzurufen:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Um alle Bereitstellungen für das aktuelle Abonnement aufzulisten, verwenden Sie az deployment sub list.

az deployment sub list

Um eine bestimmte Bereitstellung abzurufen, verwenden Sie az deployment sub show.

az deployment sub show --name ExampleDeployment

Gehen Sie folgendermaßen vor, um die Korrelations-ID abzurufen:

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

Um die Bereitstellungen für ein Abonnement aufzulisten, verwenden Sie den folgenden Vorgang. Informationen zur neuesten API-Versionsnummer, die in der Anforderung verwendet werden soll, finden Sie unter Bereitstellungen – Auflisten im Abonnementbereich.

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

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

Die Antwort enthält die Korrelations-ID.

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

Verwaltungsgruppenbereitstellungen mit Bicep-Dateien

Sie können den Verlauf von Bereitstellungen in einer Verwaltungsgruppe einsehen.

Wählen Sie die Verwaltungsgruppe aus, die Sie untersuchen möchten. Wenn Sie nicht über ausreichende Berechtigungen zum Einsehen von Details zur Verwaltungsgruppe verfügen, können Sie sie nicht auswählen.
Wählen Sie im linken Bereich Bereitstellungen aus.
Wählen Sie eine der Bereitstellungen aus dem Bereitstellungsverlauf aus.
Es wird eine Zusammenfassung der Bereitstellung angezeigt, einschließlich der Korrelations-ID.

Um alle Bereitstellungen für eine Verwaltungsgruppe aufzulisten, verwenden Sie den Befehl Get-AzManagementGroupDeployment. Wenn Sie nicht über ausreichende Berechtigungen zum Anzeigen von Bereitstellungen für die Verwaltungsgruppe verfügen, erhalten Sie eine Fehlermeldung.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Um eine bestimmte Bereitstellung aus einer Verwaltungsgruppe abzurufen, fügen Sie den Parameter Name hinzu.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Gehen Sie folgendermaßen vor, um die Korrelations-ID abzurufen:

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

Um alle Bereitstellungen für eine Verwaltungsgruppe aufzulisten, verwenden Sie az deployment mg list. Wenn Sie nicht über ausreichende Berechtigungen zum Anzeigen von Bereitstellungen für die Verwaltungsgruppe verfügen, erhalten Sie eine Fehlermeldung.

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

Um eine bestimmte Bereitstellung abzurufen, verwenden Sie az deployment mg show.

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

Gehen Sie folgendermaßen vor, um die Korrelations-ID abzurufen:

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

Um die Bereitstellung für eine Verwaltungsgruppe aufzulisten, verwenden Sie den folgenden Vorgang. Informationen zur neuesten API-Versionsnummer, die in der Anforderung verwendet werden soll, finden Sie unter Bereitstellungen – Auflisten im Verwaltungsgruppenbereich. Wenn Sie nicht über ausreichende Berechtigungen zum Anzeigen von Bereitstellungen für die Verwaltungsgruppe verfügen, erhalten Sie eine Fehlermeldung.

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

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

Die Antwort enthält die Korrelations-ID.

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

Mandantenbereitstellungen mit Bicep-Datei

Sie können den Verlauf von Bereitstellungen in einem Mandanten einsehen.

Im Portal werden derzeit keine Mandantenbereitstellungen gezeigt.

Um alle Bereitstellungen für den aktuellen Mandanten aufzulisten, verwenden Sie den Befehl Get-AzTenantDeployment. Wenn Sie nicht über ausreichende Berechtigungen zum Anzeigen von Bereitstellungen für den Mandanten verfügen, erhalten Sie eine Fehlermeldung.

Get-AzTenantDeployment

Um eine bestimmte Bereitstellung aus dem aktuellen Mandanten abzurufen, fügen Sie den Parameter Name hinzu.

Get-AzTenantDeployment -Name ExampleDeployment

Gehen Sie folgendermaßen vor, um die Korrelations-ID abzurufen:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Um alle Bereitstellungen für den aktuellen Mandanten aufzulisten, verwenden Sie az deployment tenant list. Wenn Sie nicht über ausreichende Berechtigungen zum Anzeigen von Bereitstellungen für den Mandanten verfügen, erhalten Sie eine Fehlermeldung.

az deployment tenant list

Um eine bestimmte Bereitstellung abzurufen, verwenden Sie az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Gehen Sie folgendermaßen vor, um die Korrelations-ID abzurufen:

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

Um die Bereitstellungen für den aktuellen Mandanten auflisten, verwenden Sie den folgenden Vorgang. Informationen zur neuesten API-Versionsnummer, die in der Anforderung verwendet werden soll, finden Sie unter Bereitstellungen – Auflisten im Mandantenbereich. Wenn Sie nicht über ausreichende Berechtigungen zum Anzeigen von Bereitstellungen für den Mandanten verfügen, erhalten Sie eine Fehlermeldung.

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

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

Die Antwort enthält die Korrelations-ID.

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

Bereitstellungsvorgänge und Fehlermeldung

Jede Bereitstellung kann mehrere Vorgänge umfassen. Um weiter Informationen zu einer Bereitstellung anzuzeigen, zeigen Sie die Bereitstellungsvorgänge an. Beim Fehlschlagen einer Bereitstellung enthalten die Bereitstellungsvorgänge eine Fehlermeldung.

Wählen Sie in der Zusammenfassung für eine Bereitstellung Vorgangsdetails aus.
Es werden die ausführlichen Informationen zu dem Bereitstellungsschritt angezeigt. Wenn ein Fehler auftritt, enthalten die Details die Fehlermeldung.

Verwenden Sie zum Anzeigen der Bereitstellungsvorgänge für die Bereitstellung in einer Ressourcengruppe den Befehl Get-AzResourceGroupDeploymentOperation.

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Zum Anzeigen fehlerhafter Vorgänge filtern Sie Vorgänge mit dem Zustand Fehler.

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

Verwenden Sie den folgenden Befehl, um die Statusmeldung für einen fehlerhaften Vorgang abzurufen:

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

Um Bereitstellungsvorgänge für andere Bereiche anzuzeigen, verwenden Sie:

Verwenden Sie zum Anzeigen der Bereitstellungsvorgänge für die Bereitstellung in einer Ressourcengruppe den Befehl az deployment operation group list. Sie müssen Azure CLI 2.6.0 oder höher verwenden.

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

Zum Anzeigen fehlerhafter Vorgänge filtern Sie Vorgänge mit dem Zustand Fehler.

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

Verwenden Sie den folgenden Befehl, um die Statusmeldung für einen fehlerhaften Vorgang abzurufen:

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

Um Bereitstellungsvorgänge für andere Bereiche anzuzeigen, verwenden Sie:

Um Bereitstellungsvorgänge abzurufen, verwenden Sie den folgenden Vorgang. Informationen zur neuesten API-Versionsnummer, die in der Anforderung verwendet werden soll, finden Sie unter Bereitstellungsvorgänge – Auflisten.

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}

Die Antwort enthält eine Fehlermeldung.

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

Um Bereitstellungsvorgänge für andere Bereiche anzuzeigen, verwenden Sie:

Nächste Schritte

Hilfe zum Beheben bestimmter Bereitstellungsfehler finden Sie unter Problembehandlung von häufigen Azure-Bereitstellungsfehlern.
Weitere Informationen zur Verwaltung von Bereitstellungen im Verlauf finden Sie unter Automatische Löschungen aus dem Bereitstellungsverlauf.
Informationen zum Anzeigen einer Änderungsvorschau vor der Bereitstellung einer Vorlage finden Sie unter Was-wäre-wenn-Vorgang bei der Bereitstellung von ARM-Vorlagen.

Freigeben über

Anzeigen des Bereitstellungsverlaufs mit Azure Resource Manager

Korrelations-ID und Unterstützung

Bereitstellungen von Ressourcengruppen

Abonnementbereitstellungen

Verwaltungsgruppenbereitstellungen mit Bicep-Dateien

Mandantenbereitstellungen mit Bicep-Datei

Bereitstellungsvorgänge und Fehlermeldung

Nächste Schritte

Feedback

Zusätzliche Ressourcen