Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Modifier les données de configuration des extensions de votre compte
<a name="registry-set-configuration"></a>

Cette rubrique fournit des conseils sur la modification des données de configuration des extensions de votre compte dans une région spécifique. Les extensions peuvent inclure des propriétés de configuration qui s’appliquent à toutes les instances de l’extension pour un compte et une région donnés. Ils sont définis par l’auteur de l’extension dans la définition de configuration de l’extension. Si certaines propriétés sont requises dans la définition de configuration de l'extension, vous devez les spécifier avant de pouvoir utiliser l'extension dans votre compte et votre région.

Pour plus d’informations sur la manière dont les définitions de configuration sont définies lors du développement d’une extension, consultez la documentation suivante.
+ [Référence syntaxique du schéma de configuration Hook](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html)
+ [Définition de la configuration d'une extension au niveau du compte](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration)

**Topics**
+ [Autorisations requises pour utiliser des références dynamiques](#registry-set-configuration-considerations)
+ [Modifier les données de configuration d’une extension (console)](#registry-set-configuration-procedure-console)
+ [Modifier les données de configuration d’une extension (AWS CLI)](#registry-set-configuration-procedure-cli)

## Autorisations requises pour utiliser des références dynamiques
<a name="registry-set-configuration-considerations"></a>

Si vos données de configuration incluent des références dynamiques à des valeurs stockées dans AWS Systems Manager ou AWS Secrets Manager, tout rôle utilisé pour provisionner le type (par exemple, lors de la création ou de la mise à jour d'une pile) doit disposer des autorisations appropriées pour récupérer cette valeur. En particulier :
+ Si les données de configuration contiennent un paramètre stocké dans le Parameter Store AWS Systems Manager , l’utilisateur ou le rôle utilisé pour provisionner le type doit disposer des autorisations nécessaires pour appeler [https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html).
+ Si les données de configuration contiennent un secret stocké dans AWS Secrets Manager, l'utilisateur ou le rôle utilisé pour configurer le type doit être autorisé à appeler [https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html). 

Pour de plus amples informations, veuillez consulter [Obtenir les valeurs stockées dans d’autres services à l’aide de références dynamiques](dynamic-references.md).

## Modifier les données de configuration d’une extension (console)
<a name="registry-set-configuration-procedure-console"></a>

Suivez les étapes de cette section pour utiliser la console afin de :
+ Afficher les données de configuration actuelles d’une extension
+ Mettre à jour les données de configuration de l’extension pour votre compte

**Pour afficher les données de configuration actuelles d’une extension**

1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)

1. Dans la barre de navigation, en haut de l’écran, sélectionnez votre Région AWS.

1. Dans le volet de navigation, sous **Registre**, sélectionnez **Extensions activées**.

1. Recherchez l’extension que vous souhaitez afficher. Pour de plus amples informations, veuillez consulter [Afficher les extensions disponibles et activées dans le CloudFormation registre](registry-view.md).

1. Choisissez l'extension pour afficher ses détails.

1. Sur la page des détails de l'extension, choisissez l'onglet **Configuration**.

1. Développez l'onglet **Configuration schema** (Schéma de configuration) pour voir le schéma de configuration défini pour l'extension.

1. Développez l'onglet **Configuration** pour voir la configuration actuelle que vous avez définie pour cette extension.

**Pour mettre à jour les données de configuration d’une extension**

1. Sur la page des détails de l’extension, dans l’onglet **Configuration**, sélectionnez **Modifier la configuration**.

   Vous pouvez également, dans **Actions**, sélectionner **Modifier**, puis **Modifier la configuration**.

   CloudFormation affiche la page **Configurer l'extension**. Vérifiez que **View configuration schema** (Afficher un schéma de configuration) est activé pour voir le schéma de définition de la configuration actuelle de l'extension.

1. Dans la zone de texte **Configuration JSON** (Fichier JSON de configuration), saisissez une chaîne JSON qui représente le schéma de configuration que vous souhaitez définir pour cette extension. Il doit être conforme au schéma défini dans **Configuration schema** (Schéma de configuration).

1. Sélectionnez **Configurer l’extension**.

## Modifier les données de configuration d’une extension (AWS CLI)
<a name="registry-set-configuration-procedure-cli"></a>

Suivez les étapes décrites dans cette section pour utiliser le AWS CLI pour :
+ Afficher les données de configuration actuelles d’une extension
+ Mettre à jour les données de configuration de l’extension pour votre compte

**Pour afficher les données de configuration actuelles d’une extension**
+ Utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html) pour obtenir des informations détaillées sur l’extension. L'élément `ConfigurationSchema` de la sortie contient la définition de la configuration actuelle de l'extension dans une région donnée.

  Vous pouvez également utiliser la commande [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) pour renvoyer les données de configuration relatives à plusieurs extensions.

**Pour mettre à jour les données de configuration d’une extension**
+ Utilisez la commande [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) pour spécifier les données de configuration. Le fichier JSON que vous transmettez pour `--configuration` doit être conforme au schéma de configuration de l’extension. 

  Dans l’exemple suivant, la commande **set-type-configuration** spécifie les données de configuration *`"{"CredentialKey": "testUserCredential"}"`* pour l’option `--configuration`.

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