# Editar dados de configuração para extensões em sua conta
<a name="registry-set-configuration"></a>

Este tópico fornece orientação sobre como editar dados de configuração para extensões em sua conta em uma região específica. As extensões podem incluir propriedades de configuração destinadas a serem aplicadas em todas as instâncias da extensão para uma determinada conta e região. Elas são especificadas pelo autor da extensão na definição da configuração da extensão. Se houver alguma propriedade necessária na definição de configuração da extensão, você deverá especificá-la antes de poder utilizar a extensão na sua conta e região.

Para saber mais sobre como as definições de configuração são especificadas ao desenvolver uma extensão, consulte a documentação a seguir.
+ [Referência de sintaxe de esquema de configuração de hook](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html)
+ [Definir a configuração no nível da conta de uma extensão](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration)

**Topics**
+ [Permissões necessárias para usar referências dinâmicas](#registry-set-configuration-considerations)
+ [Editar dados de configuração para uma extensão (console)](#registry-set-configuration-procedure-console)
+ [Editar dados de configuração para uma extensão (AWS CLI)](#registry-set-configuration-procedure-cli)

## Permissões necessárias para usar referências dinâmicas
<a name="registry-set-configuration-considerations"></a>

Se os dados de configuração incluírem referências dinâmicas aos valores armazenados no AWS Systems Manager ou AWS Secrets Manager, qualquer perfil usado para provisionar o tipo (por exemplo, ao criar ou atualizar uma pilha) deverá ter as permissões adequadas para recuperar esse valor. Especificamente:
+ Se os dados de configuração contiverem um parâmetro armazenado no AWS Systems Manager Parameter Store, o usuário ou perfil usado para provisionar o tipo deverá ter permissões para chamar [https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html).
+ Se os dados de configuração contiverem um segredo armazenado no AWS Secrets Manager, o usuário ou perfil usado para provisionar o tipo deverá ter permissões para chamar [https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html). 

Para obter mais informações, consulte [Obter valores armazenados em outros serviços usando referências dinâmicas](dynamic-references.md).

## Editar dados de configuração para uma extensão (console)
<a name="registry-set-configuration-procedure-console"></a>

Siga as etapas nesta seção para usar o console para:
+ Visualizar os dados de configuração atuais de uma extensão
+ Atualizar os dados de configuração de extensão para sua conta

**Para visualizar os dados de configuração atuais de uma extensão**

1. Faça login no Console de gerenciamento da AWS e abra o console CloudFormation em [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).

1. Na barra de navegação na parte superior da tela, escolha sua Região da AWS.

1. No painel de navegação, em **Registro**, escolha **Extensões ativadas**.

1. Encontre a extensão que você deseja visualizar. Para obter mais informações, consulte [Visualizar as extensões disponíveis e ativadas no registro do CloudFormation](registry-view.md).

1. Escolha a extensão para visualizar seus detalhes.

1. Na página de detalhes da extensão, selecione a guia **Configuration** (Configuração).

1. Expanda a guia **Configuration schema** (Esquema de configuração) para ver o esquema de configuração definido para a extensão.

1. Expanda a guia **Configuration** (Configuração) para ver a configuração atual que você definiu para essa extensão.

**Para atualizar os dados de configuração para uma extensão**

1. Na página de detalhes da extensão, na guia **Configuração**, escolha **Editar configuração**.

   Como alternativa, em **Ações**, escolha **Editar** e, em seguida, escolha **Editar configuração**.

   O CloudFormation exibe a página **Configure extension** (Configurar extensão). Certifique-se de que a opção **View configuration schema** (Visualizar esquema de configuração) esteja ativada para ver o esquema de definição de configuração atual da extensão.

1. Na caixa de texto **Configuration JSON** (Configuração JSON), insira uma string JSON que represente o esquema de configuração que você deseja definir para essa extensão. Ele deve ser validado com o esquema definido em **Configuration schema** (Esquema de configuração).

1. Escolha **Configurar extensão**.

## Editar dados de configuração para uma extensão (AWS CLI)
<a name="registry-set-configuration-procedure-cli"></a>

Siga as etapas nesta seção para usar o AWS CLI para:
+ Visualizar os dados de configuração atuais de uma extensão
+ Atualizar os dados de configuração de extensão para sua conta

**Para visualizar os dados de configuração atuais de uma extensão**
+ Use o comando [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 retornar informações detalhadas sobre a extensão. O elemento `ConfigurationSchema` da saída contém a definição de configuração atual da extensão em uma determinada região.

  Como alternativa, use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/batch-describe-type-configurations.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/batch-describe-type-configurations.html) para retornar dados de configuração sobre várias extensões.

**Para atualizar os dados de configuração para uma extensão**
+ Use o comando [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. O JSON transmitido para `--configuration` deve validar em relação ao esquema de configuração da extensão. 

  No exemplo a seguir, o comando **set-type-configuration** especifica os dados de configuração de *`"{"CredentialKey": "testUserCredential"}"`* para opção `--configuration`.

  ```
  aws cloudformation set-type-configuration --type RESOURCE \
    --type-name My::Resource::Example \
    --configuration-alias default \
    --configuration "{"CredentialKey": "testUserCredential"}" \
    --region us-west-2
  ```