# Use extensões privadas de terceiros que foram compartilhadas com você
<a name="registry-private"></a>

Para usar extensões privadas de terceiros que foram compartilhadas com você, primeiro você deverá *registrá-las* no CloudFormation, nas contas e regiões em que deseja usá-las. O registro da extensão carrega uma cópia dela no registro do CloudFormation na sua conta e a ativa. Ao registrar uma extensão privada, ela aparecerá no registro do CloudFormation para a respectiva região e Conta da AWS, e você poderá usá-la em seus modelos de pilha.

**Topics**
+ [Permissões do IAM para registrar uma extensão privada de terceiros](#registry-register-permissions)
+ [Comandos da AWS CLI comumente usados para trabalhar com extensões privadas](#registry-commonly-used-commands-private-extensions)
+ [Registrar uma extensão privada de terceiros em sua conta](registry-register-private-extension.md)
+ [Remover extensões privadas de terceiros de sua conta](registry-private-deregister-extension.md)

## Permissões do IAM para registrar uma extensão privada de terceiros
<a name="registry-register-permissions"></a>

Como parte do registro de uma extensão privada, é possível especificar um bucket do Amazon S3 que contém o pacote do projeto de extensão. Esse pacote contém todos os arquivos de origem necessários para a extensão que você quer registrar. O usuário que registra a extensão deve ser capaz de acessar o pacote de projeto no bucket do Amazon S3. Para isso, o usuário precisa ter permissões [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) para o pacote de extensão.

Isso será verdadeiro se você estiver usando o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html) da AWS CLI ou o comando [https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-cli-submit.html](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-cli-submit.html) da CLI do CloudFormation.

Para obter mais informações, consulte [Actions, Resources, and Condition Keys for Amazon S3](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazons3.html) na *Service Authorization Reference*.

## Comandos da AWS CLI comumente usados para trabalhar com extensões privadas
<a name="registry-commonly-used-commands-private-extensions"></a>

Os comandos comumente usados para trabalhar com extensões privadas incluem: 
+  [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html) para registrar uma extensão privada em sua conta.
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type-registration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type-registration.html) para retornar o status atual de uma solicitação de registro.
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-types.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-types.html) para listar as extensões na sua conta.
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html) para devolver informações detalhadas sobre uma extensão específica ou uma versão específica da extensão, incluindo dados de configuração atuais.
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html) para especificar os dados de configuração para uma extensão na sua conta e para desabilitar e habilitar hooks.
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-default-version.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-default-version.html) para especificar qual versão de uma extensão é a versão padrão.
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deregister-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deregister-type.html) para remover uma extensão privada ou uma versão de extensão da sua conta.