Visualización del historial de implementación con Azure Resource Manager

Artículo
03/20/2024

Azure Resource Manager permite ver el historial de implementación. Se pueden examinar las operaciones específicas en implementaciones pasadas y ver qué recursos se han implementado. Este historial contiene información sobre los errores.

El historial de implementaciones de un grupo de recursos está limitado a 800 implementaciones. A medida que se acerque el límite, las implementaciones se eliminarán automáticamente del historial. Para obtener más información, vea Eliminaciones automáticas del historial de implementaciones.

Para obtener ayuda para resolver errores de implementación concretos, consulte Solución de errores comunes de implementación de Azure.

Id. de correlación y soporte técnico

Cada implementación tiene un id. de correlación que se usa para realizar el seguimiento de los eventos relacionados. Si crea una solicitud de soporte técnico de Azure, puede que el servicio de soporte técnico le pida un identificador de correlación. Este identificador de correlación lo usan para identificar las operaciones de la implementación que ha dado error.

En los ejemplos de este artículo se muestra cómo recuperar el id. de correlación.

Implementaciones de grupos de recursos

Se pueden ver los detalles sobre la implementación de un grupo de recursos mediante Azure Portal, PowerShell, la CLI de Azure o la API REST.

Seleccione el grupo de recursos que quiera examinar.
Seleccione el vínculo situado bajo Implementaciones.
Seleccione una de las implementaciones del historial de implementación.
Se muestra un resumen de la implementación, incluido el id. de correlación.

Para enumerar todas las implementaciones de un grupo de recursos, use el comando Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Para obtener una implementación específica de un grupo de recursos, agregue el parámetro DeploymentName.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Para obtener el Id. de correlación, use:

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

Para mostrar todas las implementaciones de un grupo de recursos, use az deployment group list.

az deployment group list --resource-group ExampleGroup

Para obtener una implementación concreta, use az deployment group show.

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

Para obtener el Id. de correlación, use:

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

Para enumerar las implementaciones de un grupo de recursos, use la operación siguiente. Para obtener el número de versión de la API más reciente que se va a usar en la solicitud, vea Implementaciones: enumerar por grupo de recursos.

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

Para obtener una implementación específica, use la siguiente operación. Para obtener el número de versión de la API más reciente que se va a usar en la solicitud, vea Implementaciones: obtener.

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

La respuesta incluye el id. de correlación.

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

Implementaciones de suscripciones

Puede ver el historial de implementaciones en una suscripción.

Seleccione la suscripción que quiere ver.
En el panel izquierdo, seleccione Implementación.
Seleccione una de las implementaciones del historial de implementación.
Se muestra un resumen de la implementación, incluido el id. de correlación.

Para enumerar todas las implementaciones de la suscripción actual, use el comando Get-AzSubscriptionDeployment. Este comando equivale a Get-AzDeployment.

Get-AzSubscriptionDeployment

Para obtener una implementación específica de una suscripción, agregue el parámetro Name.

Get-AzSubscriptionDeployment -Name ExampleDeployment

Para obtener el Id. de correlación, use:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Para enumerar todas las implementaciones de la suscripción actual, use az deployment sub list.

az deployment sub list

Para obtener una implementación concreta, use az deployment sub show.

az deployment sub show --name ExampleDeployment

Para obtener el Id. de correlación, use:

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

Para enumerar las implementaciones de una suscripción, use la siguiente operación. Para obtener el número de versión de la API más reciente que se va a usar en la solicitud, vea Implementaciones: enumerar en el ámbito de la suscripción.

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

Para obtener una implementación específica, use la siguiente operación. Para obtener el número de versión de la API más reciente que se va a usar en la solicitud, vea Implementaciones: obtener en el ámbito de la suscripción.

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

La respuesta incluye el id. de correlación.

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

Implementaciones de grupos de administración

Puede ver el historial de implementaciones en un grupo de administración.

Seleccione el grupo de administración que quiera examinar. Si no tiene permisos suficientes para ver detalles sobre el grupo de administración, no podrá seleccionarlo.
En el panel izquierdo, seleccione Implementación.
Seleccione una de las implementaciones del historial de implementación.
Se muestra un resumen de la implementación, incluido el id. de correlación.

Para enumerar todas las implementaciones de un grupo de administración, use el comando Get-AzManagementGroupDeployment. Si no tiene permisos suficientes para ver implementaciones para el grupo de administración, se producirá un error.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Para obtener una implementación específica de un grupo de administración, agregue el parámetro Name.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Para obtener el Id. de correlación, use:

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

Para enumerar todas las implementaciones de un grupo de administración, use az deployment mg list. Si no tiene permisos suficientes para ver implementaciones para el grupo de administración, se producirá un error.

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

Para obtener una implementación concreta, use az deployment mg show.

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

Para obtener el Id. de correlación, use:

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

Para enumerar las implementaciones de un grupo de administración, use la operación siguiente. Para obtener el número de versión de la API más reciente que se va a usar en la solicitud, vea Implementaciones: enumerar en el ámbito del grupo de administración. Si no tiene permisos suficientes para ver implementaciones para el grupo de administración, se producirá un error.

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}

La respuesta incluye el id. de correlación.

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

Implementaciones de inquilinos

Puede ver el historial de implementaciones en un inquilino.

El portal no muestra actualmente implementaciones de inquilinos.

Para enumerar todas las implementaciones del inquilino actual, use el comando Get-AzTenantDeployment. Si no tiene permisos suficientes para ver implementaciones para el inquilino, se producirá un error.

Get-AzTenantDeployment

Para obtener una implementación específica del inquilino actual, agregue el parámetro Name.

Get-AzTenantDeployment -Name ExampleDeployment

Para obtener el Id. de correlación, use:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Para enumerar todas las implementaciones del inquilino actual, use az deployment tenant list. Si no tiene permisos suficientes para ver implementaciones para el inquilino, se producirá un error.

az deployment tenant list

Para obtener una implementación concreta, use az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Para obtener el Id. de correlación, use:

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

Para enumerar las implementaciones del inquilino actual, use la siguiente operación. Para obtener el número de versión de la API más reciente que se va a usar en la solicitud, vea Implementaciones: enumerar en el ámbito del inquilino. Si no tiene permisos suficientes para ver implementaciones para el inquilino, se producirá un error.

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}

La respuesta incluye el id. de correlación.

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

Operaciones de implementación y mensajes de error

Cada implementación puede incluir varias operaciones. Para ver más detalles acerca de una implementación, vea las operaciones de implementación. Cuando se produce un error en una implementación, las operaciones de implementación incluyen un mensaje de error.

En el Resumen de una implementación, seleccione Detalles de la operación.
Verá los detalles de ese paso de la implementación. Cuando se produce un error, los detalles incluyen el mensaje de error.

Con el fin de ver las operaciones de implementación para la implementación en un grupo de recursos, use el comando Get-AzResourceGroupDeploymentOperation.

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Para ver las operaciones con errores, filtre las operaciones con el estado Erróneas.

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

Para obtener el mensaje de estado de las operaciones erróneas, use el comando siguiente:

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

Para ver las operaciones de implementación de otros ámbitos, use:

Con el fin de ver las operaciones de implementación para la implementación en un grupo de recursos, use el comando az deployment operation group list. Debe tener la CLI de Azure 2.6.0 o una versión posterior.

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

Para ver las operaciones con errores, filtre las operaciones con el estado Erróneas.

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

Para obtener el mensaje de estado de las operaciones erróneas, use el comando siguiente:

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

Para ver las operaciones de implementación de otros ámbitos, use:

Para obtener las operaciones de implementación, use la operación siguiente. Para obtener el número de versión de la API más reciente que se va a usar en la solicitud, vea Operaciones de implementación: mostrar.

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}

La respuesta incluye un mensaje de error.

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

Para ver las operaciones de implementación de otros ámbitos, use:

Pasos siguientes

Para obtener ayuda para resolver errores de implementación concretos, consulte Solución de errores comunes de implementación de Azure.
Para obtener información sobre cómo se administran las implementaciones en el historial, vea Eliminaciones automáticas del historial de implementaciones.
Para obtener una vista previa de los cambios que aplicará una plantilla antes de realizar la implementación, consulte Operación hipotética de implementación de plantillas de ARM.

Visualización del historial de implementación con Azure Resource Manager

Id. de correlación y soporte técnico

Implementaciones de grupos de recursos

Implementaciones de suscripciones

Implementaciones de grupos de administración

Implementaciones de inquilinos

Operaciones de implementación y mensajes de error

Pasos siguientes

Recursos adicionales