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 bijna hebt bereikt, worden implementaties automatisch verwijderd uit de geschiedenis. Raadpleeg Automatic deletions from deployment history (Automatische verwijderingen uit de implementatiegeschiedenis) voor meer informatie.

Zie Veelvoorkomende Azure-implementatiefouten 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 de ondersteuning u vragen om de correlatie-id. Ondersteuning gebruikt de correlatie-id om de bewerkingen voor de mislukte implementatie te identificeren.

In de voorbeelden in dit artikel ziet u hoe u de correlatie-id ophaalt.

Brongroepimplementaties

U kunt details over een implementatie van een resourcegroep bekijken via 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 wilt ophalen uit een resourcegroep, 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

Als u alle implementaties voor een resourcegroep wilt weergeven, gebruikt u az deployment group list.

az deployment group list --resource-group ExampleGroup

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

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 Deployments - List By Resource Group 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 Deployments - Get 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": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Abonnementsimplementaties

U kunt de geschiedenis van implementaties weergeven in een abonnement.

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 wilt ophalen uit een abonnement, 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

Als u alle implementaties voor het huidige abonnement wilt weergeven, gebruikt u az deployment sub list.

az deployment sub list

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

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 Deployments - List At Subscription Scope 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 Deployments - Get At Subscription Scope 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": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Implementaties van beheergroepen

U kunt de geschiedenis van implementaties bekijken in een beheergroep.

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 wilt ophalen uit een beheergroep, 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

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

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 Deployments - List At Management Group Scope 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 Deployments - Get At Management Group Scope 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": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Tenantimplementaties

U kunt de geschiedenis van implementaties naar 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 over voldoende machtigingen beschikt om implementaties voor de tenant weer te geven, krijgt u een foutmelding.

Get-AzTenantDeployment

Als u een specifieke implementatie wilt ophalen uit de huidige tenant, 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

Als u alle implementaties voor de huidige tenant wilt weergeven, gebruikt u az deployment tenant list. Als u niet over voldoende machtigingen beschikt 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 voor het meest recente API-versienummer dat in de aanvraag moet worden gebruikt. Als u niet over voldoende machtigingen beschikt 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 Implementaties - Ophalen bij tenantbereik 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": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

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 bewerkingsgegevens in de samenvatting 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

Gebruik de opdracht Get-AzResourceGroupDeploymentOperation om de implementatiebewerkingen voor implementatie in een resourcegroep weer te geven.

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 naar een resourcegroep wilt weergeven, gebruikt u de opdracht az deployment operation group list . U moet Beschikken over Azure CLI 2.6.0 of hoger.

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 Implementatiebewerkingen - Lijst voor het meest recente API-versienummer dat u in de aanvraag wilt gebruiken.

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

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

• Implementatiebewerkingen - Lijst bij abonnementsbereik
• Implementatiebewerkingen - Lijst bij bereik van beheergroep
• Implementatiebewerkingen - lijst met tenantbereik

Volgende stappen

• Zie Veelvoorkomende Azure-implementatiefouten 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.
• Als u een voorbeeld van wijzigingen wilt bekijken die door een sjabloon worden aangebracht voordat u implementeert, raadpleegt u wat-als-bewerking voor ARM-sjabloonimplementatie.