Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

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

# Redefinir implantações
<a name="reset-deployments-scenario"></a>

Esse recurso está disponível para o AWS IoT Greengrass Core v1.1 e versões posteriores.

Você pode querer redefinir as implantações de um grupo para:
+ Exclua o grupo, por exemplo, quando você quiser mover o núcleo do grupo para outro grupo ou se o núcleo do grupo tiver sido recriado. Antes de excluir um grupo, você deve redefinir as implantações do grupo para usar o núcleo com outro grupo do Greengrass.
+ Mover o núcleo do grupo para um grupo diferente.
+ Reverter o grupo para seu estado antes de qualquer implantação.
+ Remover a configuração de implantação do dispositivo de núcleo.
+ Excluir dados confidenciais do dispositivo de núcleo ou da nuvem.
+ Implantar um novo grupo de configuração em um núcleo sem a necessidade de substituir o núcleo por outro no grupo atual.

**nota**  
A funcionalidade de redefinição de implantações não está disponível no software de núcleo do AWS IoT Greengrass v1.0.0. Não é possível excluir um grupo que foi implantado usando a v1.0.0.

A operação de redefinição de implantações primeiro limpa todas as informações de implantação armazenadas na nuvem para determinado grupo. Depois, ele também instrui o dispositivo de núcleo do grupo a limpar todas as informações relacionadas à implantação (funções do função do Lambda, logs de usuário, banco de dados shadow e certificado do servidor, mas não o `config.json` definido pelo usuário nem os certificados de núcleo do Greengrass). Não é possível iniciar uma redefinição de implantações para um grupo se o grupo tiver, no momento, uma implantação com o status `In Progress` ou `Building`.

## Redefinir implantações a partir do console AWS IoT
<a name="reset-deployments-console"></a>

Você pode redefinir as implantações de grupo na página de configuração do grupo no AWS IoT console.

1. <a name="console-gg-groups"></a>No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1).

1. Selecione o grupo de destino.

1. Na guia **Implantações**, selecione **Redefinir implantações**.

1. Na caixa de diálogo **Redefinir implantações para este grupo do Greengrass**, digite **confirm** para concordar e selecione **Redefinir implantação**.

## Redefina as implantações com a API AWS IoT Greengrass
<a name="reset-deployments-api"></a>

Você pode usar a `ResetDeployments` ação na AWS IoT Greengrass API ou no AWS CLI AWS SDK para redefinir as implantações. Os exemplos deste tópico usam a CLI.

```
aws greengrass reset-deployments --group-id GroupId [--force]
```Argumentos do comando `reset-deployments` da CLI:

`--group-id`  
O ID do grupo. Use o comando `list-groups` para obter esse valor.

`--force`  
Opcional. Use esse parâmetro se o dispositivo de núcleo do grupo foi perdido, roubado ou destruído. Essa opção faz com que o processo de implantação de redefinição relate êxito depois que todas as informações de implantação na nuvem tiverem sido limpas, sem esperar que um dispositivo de núcleo responda. No entanto, se o dispositivo de núcleo estiver ou se tornar ativo, ele também executará operações de limpeza.

A saída do comando `reset-deployments` da CLI tem a seguinte aparência:

```
{
    "DeploymentId": "4db95ef8-9309-4774-95a4-eea580b6ceef",
    "DeploymentArn": "arn:aws:greengrass:us-west-2:106511594199:/greengrass/groups/b744ed45-a7df-4227-860a-8d4492caa412/deployments/4db95ef8-9309-4774-95a4-eea580b6ceef"
}
```

Você pode verificar o status da implantação de redefinição com comando `get-deployment-status` da CLI:

```
aws greengrass get-deployment-status --deployment-id DeploymentId --group-id GroupId
```Argumentos do comando `get-deployment-status` da CLI:

`--deployment-id`  
O ID da implantação.

`--group-id`  
O ID do grupo.

A saída do comando `get-deployment-status` da CLI tem a seguinte aparência:

```
{
    "DeploymentStatus": "Success",
    "UpdatedAt": "2017-04-04T00:00:00.000Z"
}
```

O `DeploymentStatus` é definido como `Building` quando a implantação de redefinição está sendo preparada. Quando a implantação redefinida está pronta, mas o AWS IoT Greengrass núcleo não captou a implantação redefinida, `DeploymentStatus` está`InProgress`.

Se a operação de redefinição falhar, as informações de erro serão retornados na resposta.

## Consulte também
<a name="reset-deployments-see-also"></a>
+ [Implante AWS IoT Greengrass grupos em um AWS IoT Greengrass núcleo](deployments.md)
+ [ResetDeployments ](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html)na *Referência da AWS IoT Greengrass Version 1 API*
+ [GetDeploymentStatus](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html)na *Referência da AWS IoT Greengrass Version 1 API*