Editar dados de configuração para extensões em sua conta

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

• Definir a configuração no nível da conta de uma extensão

Permissões necessárias para usar referências dinâmicas

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

• 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 GetSecretValue.

Para ter mais informações, consulte Obter valores armazenados em outros serviços usando referências dinâmicas.

Editar dados de configuração para uma extensão (console)

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 AWS Management Console e abra o console AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

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

3. Encontre a extensão que você deseja visualizar. Para ter mais informações, consulte Visualizar as extensões disponíveis e ativadas no registro do CloudFormation.

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

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

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

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

2. 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).

3. Escolha Configurar extensão.

Editar dados de configuração para uma extensão (AWS CLI)

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 describe-type 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 batch-describe-type-configurations 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 set-type-configuration 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