As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Verificar o status da implantação
É possível verificar o status de uma implantação que você criou no AWS IoT Greengrass. Também é possível verificar o status dos trabalhos do AWS IoT que executam a implantação em cada dispositivo principal. Enquanto uma implantação estiver ativa, o status do trabalho do AWS IoT é `IN_PROGRESS`. Depois de criar uma revisão de uma implantação, o status do trabalho do AWS IoT da revisão anterior muda para `CANCELLED`.
**Topics**
+ [Verificar o status da implantação](#check-cloud-deployment-status)
+ [Verificar o status da implantação do dispositivo](#check-device-deployment-status)
## Verificar o status da implantação
É possível verificar o status de uma implantação identificada pelo destino ou pelo ID.
**Como verificar o status da implantação por destino (AWS CLI)**
+ Execute o comando a seguir para recuperar o status da implantação mais recente de um destino. Substitua *targetArn* pelo nome do recurso da Amazon (ARN) da coisa ou grupo de coisas do AWS IoT que a implantação tem como destino.
```
aws greengrassv2 list-deployments --target-arn targetArn
```
A resposta contém uma lista com a implantação mais recente do destino. Esse objeto de implantação inclui o status da implantação.
**Como verificar o status da implantação por ID (AWS CLI)**
+ Execute o comando a seguir para recuperar o status de uma implantação. Substitua *deploymentId* pelo ID da implantação a ser consultada.
```
aws greengrassv2 get-deployment --deployment-id deploymentId
```
A resposta contém o status da implantação.
## Verificar o status da implantação do dispositivo
É possível verificar o status de um trabalho de implantação que se aplica a um dispositivo principal individual. Também é possível verificar o status de um trabalho de implantação para uma implantação de um grupo de coisas.
**Como verificar o status do trabalho de implantação de um dispositivo principal (AWS CLI)**
+ Execute o comando a seguir para recuperar o status de todos os trabalhos de implantação de um dispositivo principal. Substitua *coreDeviceName* pelo nome do dispositivo principal que será consultado.
```
aws greengrassv2 list-effective-deployments --core-device-thing-name coreDeviceName
```
A resposta contém a lista de trabalhos de implantação do dispositivo principal. É possível identificar o trabalho para uma implantação pelo `deploymentId` ou `targetArn` do trabalho. Cada trabalho de implantação contém o status do trabalho no dispositivo principal.
**Como verificar o status de implantação de um grupo de coisas (AWS CLI)**
1. Execute o comando a seguir para recuperar o ID de uma implantação existente. Substitua *targetArn* pelo ARN do grupo de coisas de destino.
```
aws greengrassv2 list-deployments --target-arn targetArn
```
A resposta contém uma lista com a implantação mais recente do destino. Copie o `deploymentId` da resposta para usar na próxima etapa.
**nota**
Também é possível listar uma implantação diferente da implantação mais recente do destino. Especifique o argumento `--history-filter ALL` para listar todas as implantações do destino. Em seguida, copie o ID da implantação cujo status você quer verificar.
1. Execute o comando a seguir para obter os detalhes da implantação. Substitua *deploymentID* pelo ID da etapa anterior.
```
aws greengrassv2 get-deployment --deployment-id deploymentId
```
A resposta contém informações sobre a implantação. Copie o `iotJobId` da resposta para usar na etapa a seguir.
1. Execute o comando a seguir para descrever a execução do trabalho de um dispositivo principal para a implantação. Substitua *iotJobId* e *coreDeviceThingName* pelo ID do trabalho da etapa anterior e pelo dispositivo principal do qual você deseja verificar o status.
```
aws iot describe-job-execution --job-id iotJobId --thing-name coreDeviceThingName
```
A resposta contém o status da execução do trabalho de implantação do dispositivo principal e detalhes sobre o status. O `detailsMap` contém as seguintes informações:
+ `detailed-deployment-status`: o status do resultado da implantação, que pode ter um dos seguintes valores:
+ `SUCCESSFUL`: a implantação foi bem-sucedida.
+ `FAILED_NO_STATE_CHANGE`: a implantação falhou enquanto o dispositivo principal se preparava para aplicar a implantação.
+ `FAILED_ROLLBACK_NOT_REQUESTED`: a implantação falhou e a implantação não especificou a reversão para uma configuração de trabalho anterior, portanto, o dispositivo principal pode não estar funcionando corretamente.
+ `FAILED_ROLLBACK_COMPLETE`: a implantação falhou e o dispositivo principal foi revertido com sucesso para uma configuração de trabalho anterior.
+ `FAILED_UNABLE_TO_ROLLBACK`: a implantação falhou e o dispositivo principal não conseguiu reverter para uma configuração de trabalho anterior, portanto, o dispositivo principal pode não estar funcionando corretamente.
Se a implantação falhar, verifique o valor `deployment-failure-cause` e os arquivos de log do dispositivo principal para identificar o problema. Para obter mais informações sobre como acessar os arquivos de log do dispositivo principal, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md).
+ `deployment-failure-cause`: uma mensagem de erro que fornece detalhes adicionais sobre o motivo da falha na execução do trabalho.
A resposta é semelhante ao exemplo a seguir.
```
{
"execution": {
"jobId": "2cc2698a-5175-48bb-adf2-1dd345606ebd",
"status": "FAILED",
"statusDetails": {
"detailsMap": {
"deployment-failure-cause": "No local or cloud component version satisfies the requirements. Check whether the version constraints conflict and that the component exists in your Conta da AWS with a version that matches the version constraints. If the version constraints conflict, revise deployments to resolve the conflict. Component com.example.HelloWorld version constraints: LOCAL_DEPLOYMENT requires =1.0.0, thinggroup/MyGreengrassCoreGroup requires =1.0.1.",
"detailed-deployment-status": "FAILED_NO_STATE_CHANGE"
}
},
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"queuedAt": "2022-02-15T14:45:53.098000-08:00",
"startedAt": "2022-02-15T14:46:05.670000-08:00",
"lastUpdatedAt": "2022-02-15T14:46:20.892000-08:00",
"executionNumber": 1,
"versionNumber": 3
}
}
```