Visa distributionshistorik med Azure Resource Manager

Med Azure Resource Manager kan du visa distributionshistoriken. Du kan undersöka vissa åtgärder i tidigare distributioner och se vilka resurser som har distribuerats. Den här historiken innehåller information om eventuella fel.

Distributionshistoriken för en resursgrupp är begränsad till 800 distributioner. När du närmar dig gränsen tas distributioner automatiskt bort från historiken. Mer information finns i Automatiska borttagningar från distributionshistoriken.

Hjälp med att lösa specifika distributionsfel finns i Felsöka vanliga Azure-distributionsfel.

Korrelations-ID och stöd

Varje distribution har ett korrelations-ID som används för att spåra relaterade händelser. Om du skapar en Azure Support begäran kan supporten be dig om korrelations-ID: t. Supporten använder korrelations-ID:t för att identifiera åtgärderna för den misslyckade distributionen.

Exemplen i den här artikeln visar hur du hämtar korrelations-ID:t.

Distribution av resursgrupper

Du kan visa information om en resursgruppsdistribution via Azure Portal, PowerShell, Azure CLI eller REST API.

Portal

1. Välj den resursgrupp som du vill undersöka.

   

2. Välj länken under Distributioner.

   

3. Välj en av distributionerna från distributionshistoriken.

   

4. En sammanfattning av distributionen visas, inklusive korrelations-ID:t.

   

PowerShell

Om du vill visa en lista över alla distributioner för en resursgrupp använder du kommandot Get-AzResourceGroupDeployment .

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Om du vill hämta en specifik distribution från en resursgrupp lägger du till parametern DeploymentName .

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Använd för att hämta korrelations-ID:t:

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

Azure CLI

Om du vill visa en lista över alla distributioner för en resursgrupp använder du az deployment group list.

az deployment group list --resource-group ExampleGroup

Om du vill hämta en specifik distribution använder du az deployment group show.

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

Använd för att hämta korrelations-ID:t:

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

HTTP

Använd följande åtgärd för att lista distributionerna för en resursgrupp. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – lista efter resursgrupp.

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

Använd följande åtgärd för att hämta en specifik distribution. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – Hämta.

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

Svaret innehåller korrelations-ID:t.

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

Prenumerationsdistributioner

Du kan visa historiken för distributioner till en prenumeration.

Portal

1. Välj den prenumeration som du vill undersöka.

   

2. I den vänstra rutan väljer du Distributioner.

   

3. Välj en av distributionerna från distributionshistoriken.

   

4. En sammanfattning av distributionen visas, inklusive korrelations-ID:t.

   

PowerShell

Om du vill visa en lista över alla distributioner för den aktuella prenumerationen Get-AzSubscriptionDeployment använder du kommandot . Det här kommandot motsvarar Get-AzDeployment.

Get-AzSubscriptionDeployment

Lägg till parametern Name för att hämta en specifik distribution från en prenumeration.

Get-AzSubscriptionDeployment -Name ExampleDeployment

Använd för att hämta korrelations-ID:t:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Azure CLI

Om du vill visa en lista över alla distributioner för den aktuella prenumerationen använder du az deployment sub list.

az deployment sub list

Om du vill hämta en specifik distribution använder du az deployment sub show.

az deployment sub show --name ExampleDeployment

Använd för att hämta korrelations-ID:t:

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

HTTP

Om du vill visa en lista över distributioner för en prenumeration använder du följande åtgärd. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – lista med prenumerationsomfång.

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

Använd följande åtgärd för att hämta en specifik distribution. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – Hämta vid prenumerationsomfång.

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

Svaret innehåller korrelations-ID:t.

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

Distributioner av hanteringsgrupp

Du kan visa historiken för distributioner till en hanteringsgrupp.

Portal

1. Välj den hanteringsgrupp som du vill undersöka. Om du inte har tillräcklig behörighet för att visa information om hanteringsgruppen kan du inte välja den.

   

2. I den vänstra rutan väljer du Distributioner.

   

3. Välj en av distributionerna från distributionshistoriken.

   

4. En sammanfattning av distributionen visas, inklusive korrelations-ID:t.

   

PowerShell

Om du vill visa en lista över alla distributioner för en hanteringsgrupp använder du kommandot Get-AzManagementGroupDeployment . Om du inte har tillräcklig behörighet för att visa distributioner för hanteringsgruppen får du ett fel.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Lägg till parametern Name för att hämta en specifik distribution från en hanteringsgrupp.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Använd för att hämta korrelations-ID:t:

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

Azure CLI

Om du vill visa en lista över alla distributioner för en hanteringsgrupp använder du listan az deployment mg. Om du inte har tillräcklig behörighet för att visa distributioner för hanteringsgruppen får du ett fel.

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

Om du vill få en specifik distribution använder du az deployment mg show.

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

Använd för att hämta korrelations-ID:t:

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

HTTP

Använd följande åtgärd för att lista distributionerna för en hanteringsgrupp. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – lista över hanteringsgruppsomfång. Om du inte har tillräcklig behörighet för att visa distributioner för hanteringsgruppen får du ett fel.

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

Använd följande åtgärd för att hämta en specifik distribution. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – Hämta vid hanteringsgruppsomfång.

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

Svaret innehåller korrelations-ID:t.

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

Klientorganisationsdistributioner

Du kan visa historiken för distributioner till en klientorganisation.

Portal

Portalen visar för närvarande inte klientdistributioner.

PowerShell

Om du vill visa en lista över alla distributioner för den aktuella klientorganisationen använder du kommandot Get-AzTenantDeployment . Om du inte har tillräcklig behörighet för att visa distributioner för klientorganisationen får du ett fel.

Get-AzTenantDeployment

Om du vill hämta en specifik distribution från den aktuella klientorganisationen lägger du till parametern Name .

Get-AzTenantDeployment -Name ExampleDeployment

Använd för att hämta korrelations-ID:t:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Azure CLI

Om du vill visa en lista över alla distributioner för den aktuella klientorganisationen använder du listan az deployment tenant. Om du inte har tillräcklig behörighet för att visa distributioner för klientorganisationen får du ett fel.

az deployment tenant list

Om du vill hämta en specifik distribution använder du az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Använd för att hämta korrelations-ID:t:

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

HTTP

Använd följande åtgärd för att lista distributionerna för den aktuella klientorganisationen. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – lista i klientorganisationsomfång. Om du inte har tillräcklig behörighet för att visa distributioner för klientorganisationen får du ett fel.

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

Använd följande åtgärd för att hämta en specifik distribution. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – Hämta vid klientorganisationsomfång.

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

Svaret innehåller korrelations-ID:t.

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

Distributionsåtgärder och felmeddelande

Varje distribution kan innehålla flera åtgärder. Mer information om en distribution finns i distributionsåtgärderna. När en distribution misslyckas innehåller distributionsåtgärderna ett felmeddelande.

Portal

1. I sammanfattningen för en distribution väljer du Åtgärdsinformation.

   

2. Du ser information om det steget i distributionen. När ett fel inträffar innehåller informationen felmeddelandet.

   

PowerShell

Om du vill visa distributionsåtgärderna för distribution till en resursgrupp använder du kommandot Get-AzResourceGroupDeploymentOperation .

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Om du vill visa misslyckade åtgärder filtrerar du åtgärder med tillståndet Misslyckades .

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

Använd följande kommando för att hämta statusmeddelandet för misslyckade åtgärder:

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

Om du vill visa distributionsåtgärder för andra omfång använder du:

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

Azure CLI

Om du vill visa distributionsåtgärderna för distribution till en resursgrupp använder du kommandot az deployment operation group list . Du måste ha Azure CLI 2.6.0 eller senare.

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

Om du vill visa misslyckade åtgärder filtrerar du åtgärder med tillståndet Misslyckades .

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

Använd följande kommando för att hämta statusmeddelandet för misslyckade åtgärder:

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

Om du vill visa distributionsåtgärder för andra omfång använder du:

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

HTTP

Använd följande åtgärd för att hämta distributionsåtgärder. Det senaste API-versionsnumret som ska användas i begäran finns i Distributionsåtgärder – 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}

Svaret innehåller ett felmeddelande.

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

Om du vill visa distributionsåtgärder för andra omfång använder du:

• Distributionsåtgärder – lista över prenumerationsomfång
• Distributionsåtgärder – lista över hanteringsgruppsomfång
• Distributionsåtgärder – lista i klientomfång

Nästa steg

• Hjälp med att lösa specifika distributionsfel finns i Felsöka vanliga Azure-distributionsfel.
• Mer information om hur distributioner hanteras i historiken finns i Automatiska borttagningar från distributionshistoriken.
• Information om hur du förhandsgranskar ändringar som en mall kommer att göra innan du distribuerar finns i Vad händer om-åtgärden för ARM-malldistribution.