Edición de los datos de configuración de las extensiones en su cuenta

En este tema se proporcionan instrucciones sobre cómo editar los datos de configuración de las extensiones de su cuenta dentro de una región específica. Las extensiones pueden incluir propiedades de configuración que aplican a todas las instancias de la extensión para una cuenta y región determinadas. El autor de la extensión las define en la configuración de definición de la extensión. Si hay propiedades obligatorias en la definición de configuración de la extensión, debe especificarlas antes de poder usar la extensión en su cuenta y región.

Para obtener más información sobre cómo se definen las opciones de definición al desarrollar una extensión, consulte la siguiente documentación.

• Referencia a la sintaxis del esquema de la configuración del enlace

• Defining the account-level configuration of an extension (Definición de la configuración de cuenta de una extensión)

Permisos necesarios para usar referencias dinámicas

Si la configuración de datos incluye referencias dinámicas a valores almacenados en AWS Systems Manager o AWS Secrets Manager, cualquier rol que se use para aprovisionar el tipo (por ejemplo, al crear o actualizar una pila) debe tener los permisos adecuados para recuperar ese valor. En concreto:

• Si la configuración de datos contiene un parámetro almacenado en el almacén de parámetros de AWS Systems Manager, el usuario o rol que se use para aprovisionar el tipo debe tener permisos para llamar a GetParameter.

• Si la configuración de datos contiene un secreto almacenado en AWS Secrets Manager, el usuario o rol que se use para aprovisionar el tipo debe tener permisos para llamar a GetSecretValue.

Para obtener más información, consulte Obtención de valores almacenados en otros servicios con referencias dinámicas.

Edición de los datos de configuración de una extensión (consola)

Siga los pasos de esta sección para utilizar la consola a fin de hacer lo siguiente:

• Visualización de los datos de configuración actuales de una extensión

• Actualización de los datos de configuración de la extensión de su cuenta

Visualización de los datos de configuración actuales de una extensión

1. Inicie sesión en la AWS Management Console y abra la consola de AWS CloudFormation en https://console.aws.amazon.com/cloudformation.

2. En la barra de navegación de la parte superior de la pantalla, elija la Región de AWS.

3. En el panel de navegación, en Registro de CloudFormation, seleccione Extensiones activadas.

4. Encuentre la extensión que desea ver. Para obtener más información, consulte Visualización de las extensiones disponibles y activadas en el registro de CloudFormation.

5. Elija la extensión para ver sus detalles.

6. En la página de detalles de la extensión, elija la pestaña Configuration (Configuración).

7. Expanda la pestaña Configuration schema (Esquema de configuración) para ver el esquema de configuración definido para la extensión.

8. Expanda la pestaña Configuration (Configuración) para ver la configuración actual que ha establecido para esta extensión.

Actualización de los datos de configuración de una extensión

1. En la página de detalles de la extensión, en la pestaña Configuración, seleccione Editar configuración.

   Como alternativa, desde Acciones, seleccione Editar y, a continuación, seleccione Editar configuración.

   CloudFormation mostrará la página Configure extension (Configurar extensión). Asegúrese de que View configuration schema (Ver esquema de configuración) esté activado para ver el esquema de definición de configuración actual de la extensión.

2. En el cuadro de texto Configuration JSON (JSON de configuración), ingrese una cadena JSON que represente el esquema de configuración que desea especificar para esta extensión. Debe validarse con respecto al esquema definido en Configuration schema (Esquema de configuración).

3. Seleccione Configurar extensión.

Edición de los datos de configuración de una extensión (AWS CLI)

Siga los pasos de esta sección para utilizar la AWS CLI a fin de hacer lo siguiente:

• Visualización de los datos de configuración actuales de una extensión

• Actualización de los datos de configuración de la extensión de su cuenta

Visualización de los datos de configuración actuales de una extensión

• Use el comando describe-type para devolver información detallada acerca de la extensión. El elemento ConfigurationSchema de la salida contiene la definición de configuración actual de la extensión en una región determinada.

  Como alternativa, consulte el comando batch-describe-type-configurations para devolver datos de configuración sobre varias extensiones.

Actualización de los datos de configuración de una extensión

• Utilice el comando set-type-configuration para especificar los datos de configuración. El JSON que pase para --configuration debe validarse con el esquema de configuración de la extensión.

  En el siguiente ejemplo, el comando set-type-configuration especifica los datos de configuración "{"CredentialKey": "testUserCredential"}" de la opción --configuration.

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