Implementatiegeschiedenis weergeven met Azure Resource Manager

Met Azure Resource Manager kunt u uw implementatiegeschiedenis bekijken. U kunt specifieke bewerkingen in eerdere implementaties onderzoeken en zien welke resources zijn geïmplementeerd. Deze geschiedenis bevat informatie over eventuele fouten.

De implementatiegeschiedenis voor een resourcegroep is beperkt tot 800 implementaties. Wanneer u de limiet nadert, worden implementaties automatisch verwijderd uit de geschiedenis. Raadpleeg Automatic deletions from deployment history (Automatische verwijderingen uit de implementatiegeschiedenis) voor meer informatie.

Zie Veelvoorkomende implementatiefouten in Azure oplossen voor hulp bij het oplossen van bepaalde implementatiefouten.

Correlatie-id en ondersteuning

Elke implementatie heeft een correlatie-id, die wordt gebruikt om gerelateerde gebeurtenissen bij te houden. Als u een ondersteuning voor Azure aanvraag maakt, kan ondersteuning u om de correlatie-id vragen. Ondersteuning gebruikt de correlatie-id om de bewerkingen voor de mislukte implementatie te identificeren.

De voorbeelden in dit artikel laten zien hoe u de correlatie-id ophaalt.

Resourcegroepimplementaties

U kunt details over de implementatie van een resourcegroep bekijken via de Azure Portal, PowerShell, Azure CLI of REST API.

Portal

1. Selecteer de resourcegroep die u wilt onderzoeken.

   

2. Selecteer de koppeling onder Implementaties.

   

3. Selecteer een van de implementaties in de implementatiegeschiedenis.

   

4. Er wordt een samenvatting van de implementatie weergegeven, inclusief de correlatie-id.

   

PowerShell

Als u alle implementaties voor een resourcegroep wilt weergeven, gebruikt u de opdracht Get-AzResourceGroupDeployment .

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Als u een specifieke implementatie van een resourcegroep wilt ophalen, voegt u de DeploymentName parameter toe.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Als u de correlatie-id wilt ophalen, gebruikt u:

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

Azure-CLI

Gebruik az deployment group list om alle implementaties voor een resourcegroep weer te geven.

az deployment group list --resource-group ExampleGroup

Gebruik az deployment group show om een specifieke implementatie op te halen.

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

Als u de correlatie-id wilt ophalen, gebruikt u:

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

HTTP

Gebruik de volgende bewerking om de implementaties voor een resourcegroep weer te geven. Zie Implementaties - Lijst per resourcegroep voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt.

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

Gebruik de volgende bewerking om een specifieke implementatie op te halen. Zie Implementaties - Ophalen voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt.

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

Het antwoord bevat de correlatie-id.

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

Abonnementsimplementaties

U kunt de geschiedenis van implementaties voor een abonnement bekijken.

Portal

1. Selecteer het abonnement dat u wilt onderzoeken.

   

2. Selecteer Implementaties in het linkerdeelvenster.

   

3. Selecteer een van de implementaties in de implementatiegeschiedenis.

   

4. Er wordt een samenvatting van de implementatie weergegeven, inclusief de correlatie-id.

   

PowerShell

Gebruik de opdracht om alle implementaties voor het huidige abonnement weer te Get-AzSubscriptionDeployment geven. Deze opdracht is gelijk aan Get-AzDeployment.

Get-AzSubscriptionDeployment

Als u een specifieke implementatie van een abonnement wilt ophalen, voegt u de Name parameter toe.

Get-AzSubscriptionDeployment -Name ExampleDeployment

Als u de correlatie-id wilt ophalen, gebruikt u:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Azure-CLI

Gebruik az deployment sub list om alle implementaties voor het huidige abonnement weer te geven.

az deployment sub list

Als u een specifieke implementatie wilt ophalen, gebruikt u de sub-show az deployment.

az deployment sub show --name ExampleDeployment

Als u de correlatie-id wilt ophalen, gebruikt u:

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

HTTP

Gebruik de volgende bewerking om de implementaties voor een abonnement weer te geven. Zie Implementaties - Lijst bij abonnementsbereik voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt.

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

Gebruik de volgende bewerking om een specifieke implementatie op te halen. Zie Implementaties - Abonnementsbereik ophalen voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt.

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

Het antwoord bevat de correlatie-id.

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

Implementaties van beheergroepen

U kunt de geschiedenis van implementaties voor een beheergroep weergeven.

Portal

1. Selecteer de beheergroep die u wilt onderzoeken. Als u niet over voldoende machtigingen beschikt om details over de beheergroep weer te geven, kunt u deze niet selecteren.

   

2. Selecteer Implementaties in het linkerdeelvenster.

   

3. Selecteer een van de implementaties in de implementatiegeschiedenis.

   

4. Er wordt een samenvatting van de implementatie weergegeven, inclusief de correlatie-id.

   

PowerShell

Als u alle implementaties voor een beheergroep wilt weergeven, gebruikt u de opdracht Get-AzManagementGroupDeployment . Als u niet over voldoende machtigingen beschikt om implementaties voor de beheergroep weer te geven, krijgt u een foutmelding.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Als u een specifieke implementatie van een beheergroep wilt ophalen, voegt u de Name parameter toe.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Als u de correlatie-id wilt ophalen, gebruikt u:

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

Azure-CLI

Als u alle implementaties voor een beheergroep wilt weergeven, gebruikt u az deployment mg list. Als u niet over voldoende machtigingen beschikt om implementaties voor de beheergroep weer te geven, krijgt u een foutmelding.

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

Gebruik az deployment mg show om een specifieke implementatie op te halen.

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

Als u de correlatie-id wilt ophalen, gebruikt u:

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

HTTP

Gebruik de volgende bewerking om de implementaties voor een beheergroep weer te geven. Zie Implementaties - Lijst bij beheergroepbereik voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt. Als u niet over voldoende machtigingen beschikt om implementaties voor de beheergroep weer te geven, krijgt u een foutmelding.

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

Gebruik de volgende bewerking om een specifieke implementatie op te halen. Zie Implementaties - Ophalen bij bereik van beheergroep voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt.

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

Het antwoord bevat de correlatie-id.

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

Tenantimplementaties

U kunt de geschiedenis van implementaties in een tenant bekijken.

Portal

In de portal worden momenteel geen tenantimplementaties weergegeven.

PowerShell

Als u alle implementaties voor de huidige tenant wilt weergeven, gebruikt u de opdracht Get-AzTenantDeployment . Als u niet voldoende machtigingen hebt om implementaties voor de tenant weer te geven, krijgt u een foutmelding.

Get-AzTenantDeployment

Als u een specifieke implementatie van de huidige tenant wilt ophalen, voegt u de Name parameter toe.

Get-AzTenantDeployment -Name ExampleDeployment

Als u de correlatie-id wilt ophalen, gebruikt u:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Azure-CLI

Gebruik az deployment tenant list om alle implementaties voor de huidige tenant weer te geven. Als u niet voldoende machtigingen hebt om implementaties voor de tenant weer te geven, krijgt u een foutmelding.

az deployment tenant list

Als u een specifieke implementatie wilt ophalen, gebruikt u de az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Als u de correlatie-id wilt ophalen, gebruikt u:

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

HTTP

Gebruik de volgende bewerking om de implementaties voor de huidige tenant weer te geven. Zie Deployments - List At Tenant Scope (Implementaties - Lijst op tenantbereik) voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt. Als u niet voldoende machtigingen hebt om implementaties voor de tenant weer te geven, krijgt u een foutmelding.

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

Gebruik de volgende bewerking om een specifieke implementatie op te halen. Zie Deployments - Get At Tenant Scope (Implementaties - Get At Tenant Scope) voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt.

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

Het antwoord bevat de correlatie-id.

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

Implementatiebewerkingen en foutbericht

Elke implementatie kan meerdere bewerkingen bevatten. Bekijk de implementatiebewerkingen voor meer informatie over een implementatie. Wanneer een implementatie mislukt, bevatten de implementatiebewerkingen een foutbericht.

Portal

1. Selecteer bewerkingsdetails in het overzicht voor een implementatie.

   

2. U ziet de details voor die stap van de implementatie. Wanneer er een fout optreedt, bevatten de details het foutbericht.

   

PowerShell

Als u de implementatiebewerkingen voor implementatie in een resourcegroep wilt weergeven, gebruikt u de opdracht Get-AzResourceGroupDeploymentOperation .

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Als u mislukte bewerkingen wilt weergeven, filtert u bewerkingen met de status Mislukt .

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

Gebruik de volgende opdracht om het statusbericht van mislukte bewerkingen op te halen:

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

Als u implementatiebewerkingen voor andere bereiken wilt weergeven, gebruikt u:

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

Azure-CLI

Als u de implementatiebewerkingen voor implementatie in een resourcegroep wilt weergeven, gebruikt u de opdracht az deployment operation group list . U moet Azure CLI 2.6.0 of hoger hebben.

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

Als u mislukte bewerkingen wilt weergeven, filtert u bewerkingen met de status Mislukt .

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

Gebruik de volgende opdracht om het statusbericht van mislukte bewerkingen op te halen:

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

Als u implementatiebewerkingen voor andere bereiken wilt weergeven, gebruikt u:

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

HTTP

Gebruik de volgende bewerking om implementatiebewerkingen op te halen. Zie Deployment Operations - List (Implementatiebewerkingen - Lijst) voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt.

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}

Het antwoord bevat een foutbericht.

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

Als u implementatiebewerkingen voor andere bereiken wilt weergeven, gebruikt u:

• Implementatiebewerkingen - Lijst op abonnementsbereik
• Implementatiebewerkingen - lijst op het bereik van de beheergroep
• Implementatiebewerkingen - lijst op tenantbereik

Volgende stappen

• Zie Veelvoorkomende implementatiefouten in Azure oplossen voor hulp bij het oplossen van specifieke implementatiefouten.
• Zie Automatische verwijderingen uit de implementatiegeschiedenis voor meer informatie over hoe implementaties worden beheerd in de geschiedenis.
• Zie Wat-als-bewerking voor ARM-sjabloonimplementatie als u een voorbeeld wilt bekijken van de wijzigingen die een sjabloon aanbrengt voordat u de implementatie uitvoert.