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 support

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.

Distributioner 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

Om du vill hämta korrelations-ID:t använder du:

(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

Om du vill hämta korrelations-ID:t använder du:

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

HTTP

Om du vill visa en lista över distributioner för en resursgrupp använder du följande åtgärd. 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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

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

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

Get-AzSubscriptionDeployment -Name ExampleDeployment

Om du vill hämta korrelations-ID:t använder du:

(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

Om du vill hämta korrelations-ID:t använder du:

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

HTTP

Använd följande åtgärd om du vill visa en lista över distributioner för en prenumeration. Det senaste API-versionsnumret som ska användas i begäran finns i Distributioner – lista i 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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

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 felmeddelande.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

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

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Om du vill hämta korrelations-ID:t använder du:

(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 az deployment mg list. Om du inte har tillräcklig behörighet för att visa distributioner för hanteringsgruppen får du ett felmeddelande.

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

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

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

Om du vill hämta korrelations-ID:t använder du:

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

HTTP

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

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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Klientdistributioner

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 felmeddelande.

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

Om du vill hämta korrelations-ID:t använder du:

(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 felmeddelande.

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

Om du vill hämta korrelations-ID:t använder du:

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

HTTP

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

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 i klientomfå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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Distributionsåtgärder och felmeddelande

Varje distribution kan innehålla flera åtgärder. Om du vill se mer information om en distribution kan du visa 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/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"
        }
      }
    },
    ...
  ]
}

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

• Distributionsåtgärder – lista i prenumerationsomfång
• Distributionsåtgärder – lista i 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 gör innan du distribuerar finns i Konsekvensåtgärd för ARM-malldistribution.