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.
# Gestion des groupes de paramètres du cluster Amazon DocumentDB
Vous pouvez gérer la configuration du moteur Amazon DocumentDB en utilisant les paramètres d'un groupe de paramètres de cluster. Un *groupe de paramètres de cluster* est un ensemble de valeurs de configuration Amazon DocumentDB qui facilitent la gestion des paramètres de vos clusters Amazon DocumentDB. Les groupes de paramètres de cluster servent de conteneurs pour les valeurs de configuration de moteur qui sont appliquées à toutes les instances du cluster.
Cette section décrit comment créer, afficher et modifier des groupes de paramètres de cluster. Elle explique également comment déterminer quel groupe de paramètres de cluster est associé à un cluster donné.
**Topics**
+ [Décrire les groupes de paramètres de cluster](cluster_parameter_groups-describe.md)
+ [Création de groupes de paramètres de cluster](cluster_parameter_groups-create.md)
+ [Modification des groupes de paramètres du cluster](cluster_parameter_groups-modify.md)
+ [Modification de clusters pour utiliser des groupes de paramètres de cluster personnalisés](cluster_parameter_groups-modify_clusters.md)
+ [Copie de groupes de paramètres de cluster](cluster_parameter_groups-copy.md)
+ [Réinitialisation des groupes de paramètres du cluster](cluster_parameter_groups-reset.md)
+ [Suppression de groupes de paramètres de cluster](cluster_parameter_groups-delete.md)
+ [Référence des paramètres du cluster](cluster_parameter_groups-list_of_parameters.md)
# Décrire les groupes de paramètres du cluster Amazon DocumentDB
Un groupe de paramètres de `default` cluster est créé automatiquement lorsque vous créez le premier cluster Amazon DocumentDB dans une nouvelle région ou lorsque vous utilisez un nouveau moteur. Les clusters suivants, créés dans la même région et dotés de la même version de moteur, sont créés avec le groupe de paramètres de `default` cluster.
**Topics**
+ [Décrire les détails d'un groupe de paramètres de cluster](#cluster_parameter_groups-describe_details)
+ [Déterminer le groupe de paramètres d'un cluster](#cluster_parameter_groups-determine)
+ [Détermination des clusters et des instances associés à un groupe de paramètres de cluster](#cluster_parameter_groups-count)
## Décrire les détails d'un groupe de paramètres de cluster Amazon DocumentDB
Pour décrire les détails d'un groupe de paramètres de cluster donné, effectuez les étapes suivantes à l'aide du AWS Management Console ou du AWS Command Line Interface (AWS CLI).
------
#### [ Using the AWS Management Console ]
****
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Groupes de paramètres**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Dans le panneau **Groupes de paramètres de cluster**, sélectionnez le nom du groupe de paramètres de cluster dont vous voulez voir les détails.
1. La page qui s'affiche répertorie les paramètres du groupe de paramètres, l'activité récente ainsi que les balises.
+ Sous **Cluster parameters (Paramètres de cluster)**, vous pouvez voir le nom du paramètre, la valeur actuelle, les valeurs autorisées, si le paramètre est modifiable, son type d'application, son type de données et sa description. Vous pouvez modifier des paramètres individuels en sélectionnant le paramètre, puis en choisissant **Modifier** dans la section **Cluster parameters (Paramètres de cluster)** . Pour de plus amples informations, veuillez consulter [Modification des paramètres du cluster Amazon DocumentDB](cluster_parameter_groups-parameters.md).
+ Sous **Événements récents**, vous pouvez voir les événements les plus récents pour ce groupe de paramètres. Vous pouvez filtrer ces événements à l'aide de la barre de recherche de cette section. Pour de plus amples informations, veuillez consulter [Gestion des événements Amazon DocumentDB](managing-events.md).
+ Dans **Tags (Balises)**, vous pouvez voir les balises qui se trouvent dans ce groupe de paramètres de cluster. Vous pouvez ajouter ou supprimer des balises en choisissant **Modifier** dans la section **Balises**. Pour de plus amples informations, veuillez consulter [Balisage des ressources Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Vous pouvez utiliser la `describe-db-cluster-parameter-groups` AWS CLI commande pour afficher le nom de ressource Amazon (ARN), la famille, la description et le nom d'un seul groupe de paramètres de cluster ou de tous les groupes de paramètres de cluster dont vous disposez pour Amazon DocumentDB. Vous pouvez également utiliser la `describe-db-cluster-parameters` AWS CLI commande pour afficher les paramètres et leurs détails au sein d'un seul groupe de paramètres de cluster.
+ **--describe-db-cluster-parameter-groups**— Pour consulter la liste de tous vos groupes de paramètres de cluster et leurs détails.
+ **--db-cluster-parameter-group-name**— Facultatif Nom du groupe de paramètres de cluster que vous voulez décrire. Si ce paramètre n'est pas spécifié, tous les groupes de paramètres de cluster sont décrits.
+ **--describe-db-cluster-parameters**— Pour répertorier tous les paramètres d'un groupe de paramètres et leurs valeurs.
+ **--db-cluster-parameter-group name** — Obligatoire. Nom du groupe de paramètres de cluster que vous voulez décrire.
**Example**
Le code suivant répertorie jusqu'à 100 groupes de paramètres de cluster ainsi que leur ARN, leur famille, leur description et leur nom.
```
aws docdb describe-db-cluster-parameter-groups
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Default cluster parameter group for docdb4.0",
"DBClusterParameterGroupName": "default.docdb4.0"
},
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Custom docdb4.0 parameter group",
"DBClusterParameterGroupName": "sample-parameter-group"
}
]
}
```
**Example**
Le code suivant répertorie l'ARN, la famille, la description et le nom de `sample-parameter-group`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameter-groups \
--db-cluster-parameter-group-name sample-parameter-group
```
Pour Windows :
```
aws docdb describe-db-cluster-parameter-groups ^
--db-cluster-parameter-group-name sample-parameter-group
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
"Description": "Custom docdb4.0 parameter group",
"DBParameterGroupFamily": "docdb4.0",
"DBClusterParameterGroupName": "sample-parameter-group"
}
]
}
```
**Example**
Le code suivant répertorie les valeurs des paramètres dans `sample-parameter-group`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Pour Windows :
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"Parameters": [
{
"ParameterName": "audit_logs",
"ParameterValue": "disabled",
"Description": "Enables auditing on cluster.",
"Source": "system",
"ApplyType": "dynamic",
"DataType": "string",
"AllowedValues": "enabled,disabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "change_stream_log_retention_duration",
"ParameterValue": "17777",
"Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
"Source": "user",
"ApplyType": "dynamic",
"DataType": "integer",
"AllowedValues": "3600-86400",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------
## Déterminer le groupe de paramètres d'un cluster Amazon DocumentDB
Pour déterminer quel groupe de paramètres est associé à un cluster particulier, effectuez les étapes suivantes à l'aide du AWS Management Console ou du AWS CLI.
------
#### [ Using the AWS Management Console ]
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le volet de navigation de gauche, choisissez **Clusters**.
1. Dans la liste des clusters, sélectionnez le nom du cluster qui vous intéresse.
1. La page qui s'affiche répertorie les détails du cluster sélectionné. Faites défiler vers le bas jusqu'à **Cluster details (Détails du cluster)**. En bas de cette section, recherchez le nom du groupe de paramètres sous **Cluster parameter group (Groupe de paramètres de cluster)**.
![\[Capture d'écran : Affichage du groupe de paramètres d'un cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png)
------
#### [ Using the AWS CLI ]
Le AWS CLI code suivant détermine le groupe de paramètres qui régit le cluster`sample-cluster`.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'
```
La sortie de cette opération ressemble à ceci (format JSON).
```
[
[
"sample-cluster",
"sample-parameter-group"
]
]
```
------
## Détermination des clusters et des instances associés à un groupe de paramètres de cluster Amazon DocumentDB
Pour déterminer le nombre de clusters et d'instances associés à chaque groupe de paramètres, effectuez les étapes suivantes à l'aide du AWS CLI.
------
#### [ Using the AWS CLI ]
Le AWS CLI code suivant détermine le nombre de clusters et d'instances associés`sample-parameter-group`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \
--output json | \
jq -r 'group_by(.[0]) | map({
parameter_group_name: .[0][0],
total_clusters: length,
total_instances: map(.[2] | length) | add // 0
}) | .[]'
```
Pour Windows :
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^
--output json | ^
jq -r 'group_by(.[0]) | map({
parameter_group_name: .[0][0],
total_clusters: length,
total_instances: map(.[2] | length) | add // 0
}) | .[]'
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"parameter_group_name": "sample-parameter-group",
"total_clusters": 50,
"total_instances": 150
}
```
------
# Création de groupes de paramètres de cluster Amazon DocumentDB
Les groupes de paramètres de cluster par défaut tels que `default.docdb5.0` `default.docdb4.0``default.docdb3.6`, ou sont créés lorsque vous créez un cluster avec une nouvelle version du moteur et dans une nouvelle région. Les clusters suivants créés dans cette région et dotés de la même version de moteur héritent du groupe de paramètres de `default` cluster. Une fois créés, les groupes de `default` paramètres ne peuvent pas être supprimés ou renommés. Vous pouvez modifier le comportement du moteur des instances de cluster en créant un groupe de paramètres personnalisé avec des valeurs de paramètres préférées et en l'attachant à votre cluster Amazon DocumentDB.
La procédure suivante vous guide tout au long de la création d'un groupe de paramètres de cluster personnalisé. Vous pouvez ensuite [modifier les paramètres de ce groupe de paramètres](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html).
**Note**
Après la création d'un groupe de paramètres de cluster, patientez au moins 5 minutes avant d'utiliser ce groupe de paramètres de cluster. Cela permet à Amazon DocumentDB de terminer complètement l'`create`action avant que le groupe de paramètres du cluster ne soit utilisé pour un nouveau cluster. Vous pouvez utiliser l'`describe-db-cluster-parameter-groups` AWS CLI opération AWS Management Console ou pour vérifier que votre groupe de paramètres de cluster a été créé. Pour de plus amples informations, veuillez consulter [Décrire les groupes de paramètres du cluster Amazon DocumentDB](cluster_parameter_groups-describe.md).
------
#### [ Using the AWS Management Console ]
**Créer un groupe de paramètres de cluster**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Groupes de paramètres**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Dans le panneau **Groupes de paramètres de cluster**, choisissez **Créer**.
1. Dans le panneau **Create cluster parameter group (Créer un groupe de paramètres de cluster)** entrez les éléments suivants :
1. **Nom du nouveau groupe de paramètres de cluster** : entrez un nom pour le groupe de paramètres de cluster. Par exemple, `sample-parameter-group`. Les groupes de paramètres de cluster sont soumis aux contraintes de dénomination suivantes :
+ Entre 1 et 255 caractères alphanumériques.
+ Le premier caractère doit être une lettre.
+ Ne peut pas se terminer par un tiret ou contenir deux tirets consécutifs.
1. **Famille** — Choisissez la version de DocumentDB que vous souhaitez utiliser pour votre cluster.
1. **Description** — Fournissez une description de ce groupe de paramètres de cluster.
1. Choisissez **Créer** pour créer le groupe de paramètres de cluster. Pour annuler l'opération, choisissez **Annuler**.
1. Une fois que vous avez sélectionné **Créer**, le texte suivant s'affiche en haut de la page pour confirmer que votre groupe de paramètres de cluster a été créé avec succès :
```
Successfully created cluster parameter group 'sample-parameter-group'.
```
------
#### [ Using the AWS CLI ]
Pour créer un nouveau groupe de paramètres de cluster pour les clusters Amazon DocumentDB 4.0, utilisez l' AWS CLI `create-db-cluster-parameter-group`opération avec les paramètres suivants :
+ **--db-cluster-parameter-group-name**— Nom du groupe de paramètres de cluster personnalisé. Par exemple, `sample-parameter-group`.
+ **--db-cluster-parameter-group-family**— La famille de groupes de paramètres de cluster utilisée comme modèle pour le groupe de paramètres de cluster personnalisé.
+ **--description**— Description fournie par l'utilisateur pour ce groupe de paramètres de cluster. L'exemple suivant utilise `Custom docdb4.0 parameter group`.
Pour Linux, macOS ou Unix :
**Example**
```
aws docdb create-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--db-parameter-group-family docdb5.0 \
--description "Custom docdb5.0 parameter group"
```
Pour Windows :
```
aws docdb create-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--db-parameter-group-family docdb5.0 ^
--description "Custom docdb5.0 parameter group"
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "sample-parameter-group",
"DBParameterGroupFamily": "docdb5.0",
"Description": "Custom docdb4.0 parameter group",
"DBClusterParameterGroupArn": "sample-parameter-group-arn"
}
}
```
------
# Modification des groupes de paramètres du cluster Amazon DocumentDB
Cette section explique comment modifier un groupe de paramètres Amazon DocumentDB *personnalisé*. Dans Amazon DocumentDB, vous ne pouvez pas modifier un groupe de paramètres de `default` cluster créé lorsque vous créez pour la première fois un cluster avec une nouvelle version du moteur dans une nouvelle région. Si votre cluster Amazon DocumentDB utilise le groupe de paramètres de cluster par défaut et que vous souhaitez y modifier une valeur, vous devez d'abord [créer un nouveau groupe de paramètres](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) ou [copier un groupe de paramètres existant](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), le modifier, puis appliquer le groupe de paramètres modifié à votre cluster.
Procédez comme suit pour modifier un groupe de paramètres de cluster personnalisé. La propagation des actions de modification peut prendre un certain temps. Attendez que le groupe de paramètres de cluster modifié soit disponible avant de l'associer à votre cluster. Vous pouvez utiliser l' AWS CLI `describe-db-cluster-parameters`opération AWS Management Console ou pour vérifier que votre groupe de paramètres de cluster a été modifié. Pour de plus amples informations, veuillez consulter [Décrire les groupes de paramètres de cluster](cluster_parameter_groups-describe.md).
------
#### [ Using the AWS Management Console ]
Suivez ces étapes pour modifier un groupe de paramètres Amazon DocumentDB personnalisé. Vous ne pouvez pas modifier un groupe de paramètres `default`. Si vous souhaitez modifier une valeur dans le groupe de paramètres `default`, vous pouvez [copier le groupe de paramètres de cluster par défaut](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), le modifier, puis l'appliquer à votre cluster. Pour de plus amples informations sur l'application de groupes de paramètres à votre cluster, veuillez consulter [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md).
**Pour modifier un groupe de paramètres de cluster personnalisé**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation sur le côté gauche de la console, choisissez **Groupes de paramètres**. Dans la liste des groupes de paramètres, sélectionnez le nom du groupe de paramètres que vous souhaitez modifier.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Pour chaque paramètre dans le groupe de paramètres que vous souhaitez modifier, procédez comme suit :
1. Recherchez le paramètre que vous souhaitez modifier et vérifiez qu'il est modifiable : `true` doit être indiqué dans la colonne **Modifiable** .
1. S'il est modifiable, sélectionnez le paramètre et choisissez **Modifier** dans l'angle supérieur droit de la page de la console.
1. Dans la boîte `` de dialogue **Modifier**, apportez les modifications souhaitées. Choisissez ensuite **Modify cluster parameter (Modifier le paramètre de cluster)**, ou **Annuler** pour annuler les modifications.
------
#### [ Using the AWS CLI ]
Vous pouvez modifier le `ParameterValue` ou `ApplyMethod` de n'importe quel paramètre modifiable dans un groupe de paramètres de cluster Amazon DocumentDB personnalisé à l'aide du. `Description` AWS CLI Vous ne pouvez pas apporter de modifications directement à un groupe de paramètres de cluster par défaut.
Pour modifier les paramètres d'un groupe de paramètres de cluster personnalisé, utilisez l'opération `modify-db-cluster-parameter-group` avec les paramètres suivants.
+ **--db-cluster-parameter-group-name** — Obligatoire. Nom du groupe de paramètres de cluster que vous voulez modifier.
+ **--parameters** — Obligatoire. Paramètres que vous modifiez. Pour obtenir la liste des paramètres qui s'appliquent à toutes les instances d'un cluster Amazon DocumentDB, consultez le. [Référence des paramètres du cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md) Chaque saisie de paramètre doit inclure ce qui suit :
+ **ParameterName**— Le nom du paramètre que vous êtes en train de modifier.
+ **ParameterValue**— La nouvelle valeur de ce paramètre.
+ **ApplyMethod**— La manière dont vous souhaitez que les modifications soient appliquées à ce paramètre. Les valeurs autorisées sont `immediate` et `pending-reboot`.
**Note**
Les paramètres avec le `ApplyType` de `static` doivent avoir une `ApplyMethod` de `pending-reboot`.
**Example - Modification de la valeur d'un paramètre**
Dans cet exemple, vous répertoriez les valeurs du paramètre du `sample-parameter-group` et modifiez le paramètre `tls`. Ensuite, après 5 minutes, vous répertoriez à nouveau les valeurs du `sample-parameter-group` pour voir les valeurs du paramètre modifiées.
1. Répertoriez les paramètres et leurs valeurs de `sample-parameter-group`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Pour Windows :
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"Parameters": [
{
"Source": "system",
"ApplyType": "static",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "tls",
"IsModifiable": true,
"Description": "Config to enable/disable TLS"
},
{
"Source": "user",
"ApplyType": "dynamic",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "ttl_monitor",
"IsModifiable": true,
"Description": "Enables TTL Monitoring"
}
]
}
```
1. Modifiez le paramètre `tls` afin que sa valeur soit `disabled`.
Vous ne pouvez pas modifier la `ApplyMethod` car le `ApplyType` est `static`.
Pour Linux, macOS ou Unix :
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
Pour Windows :
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. Patientez au moins 5 minutes.
1. Répertoriez les valeurs des paramètres de `sample-parameter-group` pour vérifier que le paramètre `tls` a été modifié.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Pour Windows :
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"Parameters": [
{
"ParameterValue": "false",
"ParameterName": "enable_audit_logs",
"ApplyType": "dynamic",
"DataType": "string",
"Description": "Enables auditing on cluster.",
"AllowedValues": "true,false",
"Source": "system",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterValue": "disabled",
"ParameterName": "tls",
"ApplyType": "static",
"DataType": "string",
"Description": "Config to enable/disable TLS",
"AllowedValues": "disabled,enabled",
"Source": "system",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------
# Modification de clusters Amazon DocumentDB pour utiliser des groupes de paramètres de cluster personnalisés
Lorsque vous créez un cluster Amazon DocumentDB, un groupe de `default.docdb4.0` paramètres est automatiquement créé pour ce cluster. Vous ne pouvez pas modifier le groupe de paramètres de cluster `default`. Au lieu de cela, vous pouvez modifier votre cluster Amazon DocumentDB pour y associer un nouveau groupe de paramètres personnalisés.
Cette section explique comment modifier un cluster Amazon DocumentDB existant pour utiliser un groupe de paramètres de cluster personnalisé à l'aide du AWS Management Console et AWS Command Line Interface ()AWS CLI.
------
#### [ Using the AWS Management Console ]
**Pour modifier un cluster Amazon DocumentDB afin d'utiliser un nouveau groupe de paramètres de cluster autre que celui par défaut**
1. Avant de commencer, assurez-vous d'avoir créé un cluster Amazon DocumentDB et un groupe de paramètres de cluster. Pour consulter des instructions supplémentaires, veuillez consulter [Création d'un cluster Amazon DocumentDB](db-cluster-create.md) et [Création de groupes de paramètres de cluster Amazon DocumentDB](cluster_parameter_groups-create.md).
1. Après avoir créé votre groupe de paramètres de cluster, ouvrez la console Amazon DocumentDB à l'adresse. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Dans le panneau de navigation, choisissez **Clusters** pour ajouter votre nouveau groupe de paramètres à un cluster.
1. Choisissez le cluster auquel vous souhaitez associer votre groupe de paramètres. Choisissez **Actions**, puis **Modifier** pour modifier votre cluster.
1. Sous **Cluster options (Options de cluster)**, choisissez le nouveau groupe de paramètres auquel vous souhaitez associer votre cluster.
1. Sélectionnez **Continuer** pour afficher un résumé de vos modifications.
1. Après vérification de vos modifications, vous pouvez les appliquer immédiatement ou au cours de la fenêtre de maintenance suivante sous **Scheduling of modifications (Planification des modifications)**.
1. Choisissez **Modify cluster (Modifier le cluster)** pour mettre à jour votre cluster avec votre nouveau groupe de paramètres.
------
#### [ Using the AWS CLI ]
Avant de commencer, assurez-vous d'avoir créé un cluster Amazon DocumentDB et un groupe de paramètres de cluster. Vous pouvez [créer un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html) à l'aide de cette opération. AWS CLI `create-db-cluster` Vous pouvez [créer un groupe de paramètres de cluster](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) à l'aide de AWS CLI `create-db-cluster-parameter-group` cette opération.
Pour ajouter votre nouveau groupe de paramètres de cluster à votre cluster, utilisez l' AWS CLI `modify-db-cluster`opération avec les paramètres suivants.
+ **-- db-cluster-identifier** — Le nom de votre cluster (par exemple,`sample-cluster`).
+ **-- db-cluster-parameter-group -name** — Le nom du groupe de paramètres auquel vous souhaitez associer votre cluster (par exemple,`sample-parameter-group`).
**Example**
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group
```
La sortie de cette opération ressemble à ceci (format JSON).
```
"DBCluster": {
"AvailabilityZones": [
"us-west-2c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
...
}
```
------
# Copie des groupes de paramètres du cluster Amazon DocumentDB
Vous pouvez créer une copie d'un groupe de paramètres de cluster dans Amazon DocumentDB à l'aide du AWS Management Console ou du AWS Command Line Interface ()AWS CLI.
------
#### [ Using the AWS Management Console ]
La procédure suivante vous guide tout au long de la création d'un nouveau groupe de paramètres de cluster en effectuant une copie d'un groupe de paramètres de cluster existant.
**Pour copier un groupe de paramètres de cluster**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Groupes de paramètres**.
1. Dans le panneau **Groupes de paramètres de cluster**, sélectionnez le nom du groupe de paramètres de cluster que vous souhaitez copier.
1. Choisissez **Actions**, puis **Copy (Copier)** pour copier ce groupe de paramètres.
1. Sous **Copy options (Options de copie)**, entrez le nom et une description du nouveau groupe de paramètres de cluster. Choisissez ensuite **Copy (Copier)** pour enregistrer vos modifications.
------
#### [ Using the AWS CLI ]
Pour réaliser une copie d'un groupe de paramètres de cluster, utilisez l'opération `copy-db-cluster-parameter-group` avec les paramètres suivants.
+ **--source-db-cluster-parameter-group-identifier** — Obligatoire. Nom ou Amazon Resource Name (ARN) du groupe de paramètres de cluster dont vous voulez réaliser une copie.
Si les groupes de paramètres du cluster source et cible se trouvent dans le même groupe Région AWS, l'identifiant peut être un nom ou un ARN.
Si les groupes de paramètres du cluster source et cible sont différents Régions AWS, l'identifiant doit être un ARN.
+ **--target-db-cluster-parameter-group-identifier** — Obligatoire. Le nom ou l'ARN de la copie du groupe de paramètres du cluster.
Contraintes:
+ Ne peut pas être null ou vide.
+ Doit contenir de 1 à 255 lettres, chiffres ou traits d'union.
+ Le premier caractère doit être une lettre.
+ Ne peut pas se terminer par un tiret ou contenir deux tirets consécutifs.
+ **--target-db-cluster-parameter-group-description** — Obligatoire. Un utilisateur a fourni une description pour la copie du groupe de paramètres de cluster.
**Example**
Le code suivant effectue une copie de `sample-parameter-group`, en appelant la copie `sample-parameter-group-copy`.
Pour Linux, macOS ou Unix :
```
aws docdb copy-db-cluster-parameter-group \
--source-db-cluster-parameter-group-identifier sample-parameter-group \
--target-db-cluster-parameter-group-identifier sample-parameter-group-copy \
--target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
Pour Windows :
```
aws docdb copy-db-cluster-parameter-group ^
--source-db-cluster-parameter-group-identifier sample-parameter-group ^
--target-db-cluster-parameter-group-identifier sample-parameter-group-copy ^
--target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group-copy",
"DBClusterParameterGroupName": "sample-parameter-group-copy",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Copy of sample-parameter-group"
}
}
```
------
# Réinitialisation des groupes de paramètres du cluster Amazon DocumentDB
Vous pouvez rétablir certaines ou toutes les valeurs des paramètres d'un groupe de paramètres de cluster Amazon DocumentDB à leurs valeurs par défaut en utilisant le AWS Management Console ou le AWS Command Line Interface (AWS CLI) pour réinitialiser le groupe de paramètres de cluster.
------
#### [ Using the AWS Management Console ]
Procédez comme suit pour réinitialiser certaines ou toutes les valeurs de paramètres d'un groupe de paramètres de cluster à leurs valeurs par défaut.
**Pour réinitialiser les valeurs de paramètres d'un groupe de paramètres de cluster**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation sur le côté gauche de la console, choisissez **Groupes de paramètres**.
1. Dans le panneau **Groupes de paramètres de cluster**, choisissez le nom du groupe de paramètres de cluster que vous souhaitez réinitialiser.
1. Choisissez **Actions**, puis **Réinitialiser** pour réinitialiser ce groupe de paramètres.
1. Sur la page **Cluster parameter group reset confirmation (Confirmation de réinitialisation du groupe de paramètres de cluster)** qui s'affiche, confirmez que vous souhaitez réinitialiser tous les paramètres de cluster de ce groupe de paramètres à leurs valeurs par défaut. Choisissez ensuite **Réinitialiser** pour réinitialiser votre groupe de paramètres. Vous pouvez également choisir **Annuler** pour annuler vos modifications.
------
#### [ Using the AWS CLI ]
Pour réinitialiser certaines ou toutes les valeurs des paramètres d'un groupe de paramètres de cluster aux valeurs par défaut, utilisez l'opération `reset-db-cluster-parameter-group` avec les paramètres suivants.
+ **--db-cluster-parameter-group-name** — Obligatoire. Le nom du groupe de paramètres du cluster à réinitialiser.
+ **--parameters**— Facultatif Une liste des `ParameterName` et de la `ApplyMethod` dans le groupe de paramètres de cluster à réinitialiser à leurs valeurs par défaut. Les paramètres statiques doit être définie sur `pending-reboot` pour entrer en vigueur lors du prochain redémarrage de l'instance ou de la demande `reboot-db-instance`. Vous devez appeler `reboot-db-instance` pour chaque instance de votre cluster à laquelle vous souhaitez que la mise à jour des paramètres statiques soit appliquée.
Ce paramètre et `--reset-all-parameters` s'excluent mutuellement : vous pouvez utiliser l'un ou l'autre, mais pas les deux.
+ **--reset-all-parameters**ou **--no-reset-all-parameters** — Facultatif. Spécifie s'il faut réinitialiser tous les paramètres (`--reset-all-parameters`) ou uniquement certains des paramètres (`--no-reset-all-parameters`) à leurs valeurs par défaut. Le paramètre `--reset-all-parameters` et `--parameters` s'excluent mutuellement : vous pouvez utiliser l'un ou l'autre, mais pas les deux.
Lorsque vous réinitialisez l'ensemble du groupe, les paramètres dynamiques sont mis à jour immédiatement. Les paramètres statiques doivent être définis sur `pending-reboot` pour entrer en vigueur lors du redémarrage suivant de l'instance ou de la demande `reboot-db-instance`. Vous devez appeler `reboot-db-instance` pour chaque instance de votre cluster à laquelle vous souhaitez que la mise à jour des paramètres statiques soit appliquée.
**Example**
**Exemple 1 : Réinitialisation de tous les paramètres à leurs valeurs par défaut**
Le code suivant réinitialise tous les paramètres dans le groupe de paramètres de cluster `sample-parameter-group` à leurs valeurs par défaut.
Pour Linux, macOS ou Unix :
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--reset-all-parameters
```
Pour Windows :
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--reset-all-parameters
```
**Exemple 2 : Réinitialisation de paramètres spécifiés à leurs valeurs par défaut**
Le code suivant réinitialise le paramètre `tls` dans le groupe de paramètres de cluster `sample-parameter-group` à sa valeur par défaut.
Pour Linux, macOS ou Unix :
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--no-reset-all-parameters \
--parameters ParameterName=tls,ApplyMethod=pending-reboot
```
Pour Windows :
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--no-reset-all-parameters ^
--parameters ParameterName=tls,ApplyMethod=pending-reboot
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
**Redémarrage d'une instance de cluster**
Avant qu'une valeur de paramètre statique soit modifiée, l'instance du cluster doit être redémarrée. Redémarrez chaque instance de votre cluster à laquelle vous souhaitez que la mise à jour du paramètre statique soit appliquée.
Pour Linux, macOS ou Unix :
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-cluster-instance
```
Pour Windows :
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-cluster-instance
```
------
# Suppression de groupes de paramètres de cluster Amazon DocumentDB
Vous pouvez supprimer un groupe de paramètres de cluster Amazon DocumentDB personnalisé à l'aide du AWS Management Console ou du AWS Command Line Interface ()AWS CLI. Vous ne pouvez pas supprimer le groupe de paramètres de cluster `default.docdb4.0`.
------
#### [ Using the AWS Management Console ]
**Supprimer un groupe de paramètres de cluster**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Groupes de paramètres**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Dans le volet **Groupes de paramètres**, sélectionnez la case d'option à gauche du groupe de paramètres de cluster que vous voulez supprimer.
1. Choisissez **Actions**, puis **Supprimer**.
1. Dans le volet de confirmation **Supprimer** choisissez **Supprimer** pour supprimer le groupe de paramètres de cluster. Pour conserver le groupe de paramètres de cluster, choisissez **Annuler**.
------
#### [ Using the AWS CLI ]
Pour supprimer un groupe de paramètres de cluster, utilisez l'opération `delete-db-cluster-parameter-group` avec le paramètre suivant.
+ **--db-cluster-parameter-group-name** — Obligatoire. Le nom du groupe de paramètres du cluster à supprimer. Il doit s'agir d'un groupe de paramètres de cluster existant. *Vous ne pouvez pas supprimer le groupe de paramètres de cluster `default.docdb4.0`. *
**Example - Suppression d'un groupe de paramètres de cluster**
Suivez les trois étapes de l'exemple suivant pour la suppression d'un groupe de paramètres de cluster :
1. Trouver le nom du groupe de paramètres de cluster que vous voulez supprimer.
1. Suppression du groupe de paramètres de cluster spécifié.
1. Vérification de la suppression du groupe de paramètres de cluster.
**1. Trouvez le nom du groupe de paramètres de cluster que vous voulez supprimer.**
Le code suivant répertorie les noms de tous les groupes de paramètres de cluster.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Pour Windows :
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Le résultat de l'opération précédente est une liste des noms des groupes de paramètres de cluster similaire à celle ci-après (au format JSON).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
],
[
"sample-parameter-group-copy"
]
]
```
**2. Supprimer un groupe de paramètres de cluster spécifique.**
Le code suivant supprime le groupe de paramètres de cluster `sample-parameter-group-copy`.
Pour Linux, macOS ou Unix :
```
aws docdb delete-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Pour Windows :
```
aws docdb delete-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Il n'existe aucun résultat pour cette opération.
**3. Vérifiez que le groupe de paramètres de cluster a été supprimé.**
Le code suivant répertorie les noms de tous les groupes de paramètres de cluster restants.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Pour Windows :
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Le résultat de l'opération précédente est une liste des groupes de paramètres de cluster similaire à celle ci-après (au format JSON). Le groupe de paramètres de cluster que vous venez de supprimer ne doit pas figurer dans la liste.
La sortie de cette opération ressemble à ceci (format JSON).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
]
]
```
------
# Référence des paramètres du cluster Amazon DocumentDB
Lorsque vous modifiez un paramètre dynamique et que vous enregistrez le groupe de paramètres de cluster, la modification est appliquée immédiatement, quel que soit le paramètre *Apply Immediately (Appliquer immédiatement)*. Lorsque vous modifiez un paramètre statique et que vous enregistrez le groupe de paramètres de cluster, la modification du paramètre est appliquée après que vous avez redémarré manuellement l'instance. Vous pouvez redémarrer une instance à l'aide de la console Amazon DocumentDB ou en appelant explicitement. `reboot-db-instance`
Le tableau suivant indique les paramètres qui s'appliquent à toutes les instances d'un cluster Amazon DocumentDB.
**Paramètres au niveau du cluster Amazon DocumentDB**
| Paramètre | Valeur par défaut | Valeurs valides | Adaptabilité | Type d’application | Type de données | Description |
| --- | --- | --- | --- | --- | --- | --- |
| audit\$1logs | désactivées | activé, désactivé, ddl, dml\$1read, dml\$1write, tout, aucun | Oui | Répartition dynamique | String | Définit si les journaux CloudWatch d'audit Amazon sont activés. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | Oui | Répartition dynamique | Entier | Définit la durée (en secondes) pendant laquelle le journal du flux de modifications est conservé et peut être consommé. |
| default\$1collection\$1compression | désactivées | activé, désactivé (Amazon DocumentDB 5.0)/zstd, lz4, aucun (Amazon Document 5.0) DB8 | Oui | Répartition dynamique | String | Définit le paramètre de compression par défaut pour les nouvelles collections d'un cluster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| profiler | désactivées | activé, désactivé | Oui | Répartition dynamique | String | Active le profilage pour les opérations lentes. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| profiler\$1sampling\$1rate | 1.0 | 0.0-1.0 | Oui | Répartition dynamique | Float | Définit la fréquence d'échantillonnage pour les opérations consignées. |
| profiler\$1threshold\$1ms | 100 | 50-2147483646 | Oui | Répartition dynamique | Entier | Définit le seuil pour profiler. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| planner\$1version | 3.0 | 1,0, 2,0, 3,0 | Oui | Répartition dynamique | Float | Définit la version du planificateur de requêtes à utiliser pour les requêtes.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| tls | activé | activé, désactivé, fips-140-3, tls1.2\$1, tls1.3\$1 | Oui | Statique | String | Définit si des connexions utilisant le protocole TLS sont requises. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| ttl\$1monitor | activé | activé, désactivé | Oui | Répartition dynamique | String | Définit si la surveillance de durée de vie (TTL) est activée pour le cluster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
# Modification des paramètres du cluster Amazon DocumentDB
Dans Amazon DocumentDB, les *groupes de paramètres de cluster* sont des *paramètres* qui s'appliquent à toutes les instances que vous créez dans le cluster. Pour les groupes de paramètres de cluster personnalisés, vous pouvez modifier une valeur de paramètre à tout moment ou réinitialiser toutes les valeurs de paramètre à leurs valeurs par défaut pour les groupes de paramètres que vous créez. Cette section explique comment afficher les paramètres qui constituent un groupe de paramètres de cluster Amazon DocumentDB et leurs valeurs, et comment modifier ou mettre à jour ces valeurs.
Les paramètres peuvent être *dynamiques* ou *statiques*. Lorsque vous modifiez un paramètre dynamique et que vous enregistrez le groupe de paramètres de cluster, la modification est appliquée immédiatement, quel que soit le paramètre `Apply Immediately`. Lorsque vous modifiez un paramètre statique et que vous enregistrez le groupe de paramètres de cluster, la modification du paramètre est appliquée après que vous avez redémarré manuellement l'instance.
## Afficher les paramètres d'un groupe de paramètres de cluster Amazon DocumentDB
Vous pouvez consulter les paramètres d'un cluster Amazon DocumentDB et leurs valeurs à l'aide du AWS Management Console ou. AWS CLI
------
#### [ Using the AWS Management Console ]
**Pour afficher les détails d'un groupe de paramètres de cluster**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Groupes de paramètres**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Dans le volet **Groupes de paramètres**, sélectionnez le nom du groupe de paramètres de cluster dont vous voulez voir les détails.
1. La page qui s’affiche montre les valeurs suivantes pour chaque paramètre : nom du paramètre, valeur actuelle, valeurs autorisées, si le paramètre est modifiable, type d'application, type de données et description.
![\[Capture d'écran : Noms et valeurs de paramètres.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png)
------
#### [ Using the AWS CLI ]
Pour afficher les paramètres et les valeurs d'un groupe de paramètres de cluster, utilisez l'opération `describe-db-cluster-parameters` avec les paramètres suivants.
+ **--db-cluster-parameter-group-name** — Obligatoire. Le nom du groupe de paramètres de cluster pour lequel vous souhaitez obtenir une liste détaillée des paramètres.
+ **--source**— Facultatif S'il est fournit, il renvoie uniquement les paramètres pour une source spécifique. Les sources du paramètre peuvent être `engine-default`, `system` ou `user`.
**Example**
L'exemple de code suivant répertorie les paramètres et leurs valeurs pour le groupe de paramètres `custom3-6-param-grp`. Pour obtenir des informations sur le groupe de paramètres, omettez la ligne `--query`. Pour obtenir des informations sur tous les groupes de paramètres, omettez la ligne `--db-cluster-parameter-group-name`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name custom3-6-param-grp \
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
Pour Windows :
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name custom3-6-param-grp ^
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
La sortie de cette opération ressemble à ceci (format JSON).
```
[
[
"audit_logs",
"disabled"
],
[
"tls",
"enabled"
],
[
"ttl_monitor",
"enabled"
]
]
```
------
## Modification des paramètres d'un groupe de paramètres de cluster Amazon DocumentDB
Vous pouvez modifier les paramètres d'un groupe de paramètres à l'aide du AWS Management Console ou AWS CLI.
------
#### [ Using the AWS Management Console ]
**Pour mettre à jour les paramètres d'un groupe de paramètres de cluster**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Groupes de paramètres**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Dans le volet **Parameter groups (Groupes de paramètres)**, choisissez le groupe de paramètres de cluster dont vous souhaitez mettre à jour les paramètres.
1. La page qui s’affiche montre les paramètres et leurs détails correspondants pour ce groupe de paramètres de cluster. Sélectionnez un paramètre à mettre à jour.
1. En haut à droite de la page, choisissez **Edit (Modifier)** pour modifier la valeur du paramètre. Pour de plus amples informations sur les types de paramètres de cluster, veuillez consulter [Référence des paramètres du cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md).
1. Effectuez votre modification, puis choisissez **Modify cluster parameter (Modifier le paramètre de cluster)** pour enregistrer les modifications. Pour ignorer vos modifications, choisissez **Annuler**.
------
#### [ Using the AWS CLI ]
Pour modifier les paramètres d'un groupe de paramètres de cluster, utilisez l'opération `modify-db-cluster-parameter-group` avec les paramètres suivants :
+ **--db-cluster-parameter-group-name** — Obligatoire. Nom du groupe de paramètres de cluster que vous voulez modifier.
+ **--parameters** — Obligatoire. Le paramètre ou les paramètres que vous voulez modifier. Chaque saisie de paramètre doit inclure ce qui suit :
+ **ParameterName**— Le nom du paramètre que vous êtes en train de modifier.
+ **ParameterValue**— La nouvelle valeur de ce paramètre.
+ **ApplyMethod**— La manière dont vous souhaitez que les modifications soient appliquées à ce paramètre. Les valeurs autorisées sont `immediate` et `pending-reboot`.
**Note**
Les paramètres avec le `ApplyType` de `static` doivent avoir une `ApplyMethod` de `pending-reboot`.
**Pour modifier les valeurs des paramètres d'un groupe de paramètres de cluster (AWS CLI)**
L'exemple suivant modifie le paramètre `tls`.
1. **Liste des paramètres et de leurs valeurs pour `sample-parameter-group`**
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Pour Windows :
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"Parameters": [
{
"Source": "system",
"ApplyType": "static",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "tls",
"IsModifiable": true,
"Description": "Config to enable/disable TLS"
},
{
"Source": "user",
"ApplyType": "dynamic",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "ttl_monitor",
"IsModifiable": true,
"Description": "Enables TTL Monitoring"
}
]
}
```
1. **Modifier le paramètre `tls` afin que sa valeur soit `disabled`**. Vous ne pouvez pas modifier la `ApplyMethod` car le `ApplyType` est `static`.
Pour Linux, macOS ou Unix :
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"
```
Pour Windows :
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. **Patientez au moins 5 minutes.**
1. **Liste des valeurs du paramètre du `sample-parameter-group`.**
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Pour Windows :
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"Parameters": [
{
"ParameterName": "audit_logs",
"ParameterValue": "disabled",
"Description": "Enables auditing on cluster.",
"Source": "system",
"ApplyType": "dynamic",
"DataType": "string",
"AllowedValues": "enabled,disabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "tls",
"ParameterValue": "disabled",
"Description": "Config to enable/disable TLS",
"Source": "user",
"ApplyType": "static",
"DataType": "string",
"AllowedValues": "disabled,enabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------