# Remover extensões privadas de terceiros de sua conta
<a name="registry-private-deregister-extension"></a>

Para remover uma extensão privada de terceiros ou uma versão de extensão, use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deregister-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deregister-type.html).

É possível cancelar o registro de uma versão específica da extensão ou da extensão como um todo. Para cancelar o registro de uma extensão, é necessário cancelar o registro individual de todas as versões registradas dessa extensão. Se uma extensão tiver apenas uma única versão registrada, o cancelamento do registro dessa versão resultará no cancelamento do registro da extensão em si. Você não pode cancelar o registro da versão padrão de uma extensão, a menos que seja a única versão registrada dessa extensão. Nesse caso, o registro da extensão em si também será cancelado. 

**Atenção**  
O cancelamento do registro de uma extensão privada não pode ser desfeito. Esta ação vai:  
Tornar a extensão inutilizável em todas as operações do CloudFormation.
Causar falhas em futuras atualizações de pilha que usem essa extensão (para módulos e tipos de recursos). Embora você possa registrar novamente a extensão de forma privada posteriormente, isso poderá causar falhas se o CloudFormation depender de uma versão anterior.
Antes de continuar, use os comandos [list-stacks](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-stacks.html) e [get-template](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/get-template.html) para verificar se nenhuma pilha ativa está usando essa extensão.

## Exemplo de comandos para cancelar o registro da extensão
<a name="registry-deregister-type-commands"></a>

Esta seção fornece exemplos que mostram as diferentes formas de cancelar o registro de extensões privadas.

**Cancelar o registro por nome do tipo**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deregister-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deregister-type.html) com as opções `--type` e `--type-name` para cancelar o registro da sua extensão.

```
aws cloudformation deregister-type \
  --type {{MODULE}} \
  --type-name {{My::S3::SampleBucket::MODULE}}
```

**Cancelar o registro por nome do tipo e versão**  
Para cancelar o registro de uma versão específica da sua extensão, especifique a opção `--version-id` no comando.

```
aws cloudformation deregister-type \
  --type {{MODULE}} \
  --type-name {{My::S3::SampleBucket::MODULE}} \
  --version-id {{00000001}}
```

**dica**  
Para definir uma versão diferente da extensão como padrão primeiro, use o comando [set-type-default-version](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-default-version.html).

**Cancelar o registro pelo ARN**  
Use a opção `--arn` e especifique o ARN da sua extensão para cancelar o registro.

```
aws cloudformation deregister-type \
  --arn {{arn:aws:cloudformation:us-west-2:123456789012:type/resource/Organization-Service-Resource}}
```