D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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.
# Exemples d'Amazon RDS utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide d'Amazon RDS.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `add-option-to-option-group`
L'exemple de code suivant montre comment utiliser`add-option-to-option-group`.
**AWS CLI**
**Pour ajouter une option à un groupe d’options**
L’exemple `add-option-to-option-group` suivant ajoute une option à un groupe d’options spécifié.
```
aws rds add-option-to-option-group \
--option-group-name {{myoptiongroup}} \
--options {{OptionName=OEM,Port=5500,DBSecurityGroupMemberships=default}} \
--apply-immediately
```
Sortie :
```
{
"OptionGroup": {
"OptionGroupName": "myoptiongroup",
"OptionGroupDescription": "Test Option Group",
"EngineName": "oracle-ee",
"MajorEngineVersion": "12.1",
"Options": [
{
"OptionName": "Timezone",
"OptionDescription": "Change time zone",
"Persistent": true,
"Permanent": false,
"OptionSettings": [
{
"Name": "TIME_ZONE",
"Value": "Australia/Sydney",
"DefaultValue": "UTC",
"Description": "Specifies the timezone the user wants to change the system time to",
"ApplyType": "DYNAMIC",
"DataType": "STRING",
"AllowedValues": "Africa/Cairo,Africa/Casablanca,Africa/Harare,Africa/Lagos,Africa/Luanda,Africa/Monrovia,Africa/Nairobi,Africa/Tripoli,Africa/Windhoek,America/Araguaina,America/Argentina/Buenos_Aires,America/Asuncion,America/Bogota,America/Caracas,America/Chicago,America/Chihuahua,America/Cuiaba,America/Denver,America/Detroit,America/Fortaleza,America/Godthab,America/Guatemala,America/Halifax,America/Lima,America/Los_Angeles,America/Manaus,America/Matamoros,America/Mexico_City,America/Monterrey,America/Montevideo,America/New_York,America/Phoenix,America/Santiago,America/Sao_Paulo,America/Tijuana,America/Toronto,Asia/Amman,Asia/Ashgabat,Asia/Baghdad,Asia/Baku,Asia/Bangkok,Asia/Beirut,Asia/Calcutta,Asia/Damascus,Asia/Dhaka,Asia/Hong_Kong,Asia/Irkutsk,Asia/Jakarta,Asia/Jerusalem,Asia/Kabul,Asia/Karachi,Asia/Kathmandu,Asia/Kolkata,Asia/Krasnoyarsk,Asia/Magadan,Asia/Manila,Asia/Muscat,Asia/Novosibirsk,Asia/Rangoon,Asia/Riyadh,Asia/Seoul,Asia/Shanghai,Asia/Singapore,Asia/Taipei,Asia/Tehran,Asia/Tokyo,Asia/Ulaanbaatar,Asia/Vladivostok,Asia/Yakutsk,Asia/Yerevan,Atlantic/Azores,Atlantic/Cape_Verde,Australia/Adelaide,Australia/Brisbane,Australia/Darwin,Australia/Eucla,Australia/Hobart,Australia/Lord_Howe,Australia/Perth,Australia/Sydney,Brazil/DeNoronha,Brazil/East,Canada/Newfoundland,Canada/Saskatchewan,Etc/GMT-3,Europe/Amsterdam,Europe/Athens,Europe/Berlin,Europe/Dublin,Europe/Helsinki,Europe/Kaliningrad,Europe/London,Europe/Madrid,Europe/Moscow,Europe/Paris,Europe/Prague,Europe/Rome,Europe/Sarajevo,Pacific/Apia,Pacific/Auckland,Pacific/Chatham,Pacific/Fiji,Pacific/Guam,Pacific/Honolulu,Pacific/Kiritimati,Pacific/Marquesas,Pacific/Samoa,Pacific/Tongatapu,Pacific/Wake,US/Alaska,US/Central,US/East-Indiana,US/Eastern,US/Pacific,UTC",
"IsModifiable": true,
"IsCollection": false
}
],
"DBSecurityGroupMemberships": [],
"VpcSecurityGroupMemberships": []
},
{
"OptionName": "OEM",
"OptionDescription": "Oracle 12c EM Express",
"Persistent": false,
"Permanent": false,
"Port": 5500,
"OptionSettings": [],
"DBSecurityGroupMemberships": [
{
"DBSecurityGroupName": "default",
"Status": "authorized"
}
],
"VpcSecurityGroupMemberships": []
}
],
"AllowsVpcAndNonVpcInstanceMemberships": false,
"OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:myoptiongroup"
}
}
```
Pour plus d’informations, consultez [Ajout d’une option à un groupe d’options](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.AddOption) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [AddOptionToOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-option-to-option-group.html)à la section *Référence des AWS CLI commandes*.
### `add-role-to-db-cluster`
L'exemple de code suivant montre comment utiliser`add-role-to-db-cluster`.
**AWS CLI**
**Pour associer un rôle AWS Identity and Access Management (IAM) à un cluster de bases de données**
L’exemple `add-role-to-db-cluster` suivant associe un rôle à un cluster de bases de données.
```
aws rds add-role-to-db-cluster \
--db-cluster-identifier {{mydbcluster}} \
--role-arn {{arn:aws:iam::123456789012:role/RDSLoadFromS3}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Association d’un rôle IAM à un cluster de bases de données Amazon Aurora MySQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.IAM.AddRoleToDBCluster.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [AddRoleToDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-role-to-db-cluster.html)à la section *Référence des AWS CLI commandes*.
### `add-role-to-db-instance`
L'exemple de code suivant montre comment utiliser`add-role-to-db-instance`.
**AWS CLI**
**Pour associer un rôle AWS Identity and Access Management (IAM) à une instance de base de données**
L’exemple `add-role-to-db-instance` suivant ajoute le rôle à une instance de base de données Oracle nommée `test-instance`.
```
aws rds add-role-to-db-instance \
--db-instance-identifier {{test-instance}} \
--feature-name {{S3_INTEGRATION}} \
--role-arn {{arn:aws:iam::111122223333:role/rds-s3-integration-role}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Conditions préalables à l’intégration de Amazon RDS Oracle avec Amazon S3](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-s3-integration.html#oracle-s3-integration.preparing) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [AddRoleToDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-role-to-db-instance.html)la section *Référence des AWS CLI commandes*.
### `add-source-identifier-to-subscription`
L'exemple de code suivant montre comment utiliser`add-source-identifier-to-subscription`.
**AWS CLI**
**Pour ajouter un identifiant de la source à un abonnement**
L’exemple `add-source-identifier` suivant ajoute un autre identifiant de la source à un abonnement existant.
```
aws rds add-source-identifier-to-subscription \
--subscription-name {{my-instance-events}} \
--source-identifier {{test-instance-repl}}
```
Sortie :
```
{
"EventSubscription": {
"SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
"CustSubscriptionId": "my-instance-events",
"EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
"Enabled": false,
"Status": "modifying",
"EventCategoriesList": [
"backup",
"recovery"
],
"CustomerAwsId": "123456789012",
"SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
"SourceType": "db-instance",
"SourceIdsList": [
"test-instance",
"test-instance-repl"
]
}
}
```
+ Pour plus de détails sur l'API, voir [AddSourceIdentifierToSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-source-identifier-to-subscription.html)la section *Référence des AWS CLI commandes*.
### `add-tags-to-resource`
L'exemple de code suivant montre comment utiliser`add-tags-to-resource`.
**AWS CLI**
**Pour ajouter des balises à une ressource**
L’exemple `add-tags-to-resource` suivant ajoute des balises à une base de données RDS.
```
aws rds add-tags-to-resource \
--resource-name {{arn:aws:rds:us-east-1:123456789012:db:database-mysql}} \
--tags "[{\"Key\": \"Name\",\"Value\": \"MyDatabase\"},{\"Key\": \"Environment\",\"Value\": \"test\"}]"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Balisage de ressources Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [AddTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-tags-to-resource.html)la section *Référence des AWS CLI commandes*.
### `apply-pending-maintenance-action`
L'exemple de code suivant montre comment utiliser`apply-pending-maintenance-action`.
**AWS CLI**
**Pour appliquer les actions de maintenance en attente**
L’exemple `apply-pending-maintenance-action` suivant applique les actions de maintenance en attente pour un cluster de bases de données.
```
aws rds apply-pending-maintenance-action \
--resource-identifier {{arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster}} \
--apply-action {{system-update}} \
--opt-in-type {{immediate}}
```
Sortie :
```
{
"ResourcePendingMaintenanceActions": {
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"OptInStatus": "immediate",
"CurrentApplyDate": "2021-01-23T01:07:36.100Z",
"Description": "Upgrade to Aurora PostgreSQL 3.3.2"
}
]
}
}
```
Pour plus d’informations, consultez [Entretien d’une instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html) dans le *Guide de l’utilisateur Amazon RDS* et [Maintaining an Amazon Aurora DB cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [ApplyPendingMaintenanceAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/apply-pending-maintenance-action.html)la section *Référence des AWS CLI commandes*.
### `authorize-db-security-group-ingress`
L'exemple de code suivant montre comment utiliser`authorize-db-security-group-ingress`.
**AWS CLI**
**Pour associer un rôle AWS Identity and Access Management (IAM) à une instance de base de données**
L’exemple `authorize-db-security-group-ingress` suivant configure le groupe de sécurité par défaut avec une règle d’entrée pour la plage d’adresses CIDR IP 192.0.2.0/24.
```
aws rds authorize-db-security-group-ingress \
--db-security-group-name {{default}} \
--cidrip {{192.0.2.0/24}}
```
Sortie :
```
{
"DBSecurityGroup": {
"OwnerId": "123456789012",
"DBSecurityGroupName": "default",
"DBSecurityGroupDescription": "default",
"EC2SecurityGroups": [],
"IPRanges": [
{
"Status": "authorizing",
"CIDRIP": "192.0.2.0/24"
}
],
"DBSecurityGroupArn": "arn:aws:rds:us-east-1:111122223333:secgrp:default"
}
}
```
Pour plus d’informations, consultez [Autorisation de l’accès réseau à un groupe de sécurité DB depuis une plage IP](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html#USER_WorkingWithSecurityGroups.Authorizing) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [AuthorizeDbSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/authorize-db-security-group-ingress.html)la section *Référence des AWS CLI commandes*.
### `backtrack-db-cluster`
L'exemple de code suivant montre comment utiliser`backtrack-db-cluster`.
**AWS CLI**
**Pour effectuer un retour sur trace d’un cluster de bases de données Aurora**
L’exemple `backtrack-db-cluster` suivant effectue un retour sur trace sur l’exemple de cluster de bases de données spécifié à 10 h, le 19 mars 2018.
```
aws rds backtrack-db-cluster --db-cluster-identifier {{sample-cluster}} --backtrack-to {{2018-03-19T10:00:00+00:00}}
```
Cette commande génère un bloc JSON qui accuse réception de la modification apportée à la ressource RDS.
+ Pour plus de détails sur l'API, voir [BacktrackDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/backtrack-db-cluster.html)la section *Référence des AWS CLI commandes*.
### `cancel-export-task`
L'exemple de code suivant montre comment utiliser`cancel-export-task`.
**AWS CLI**
**Pour annuler l’exportation d’un instantané vers Amazon S3**
L’exemple `cancel-export-task` suivant annule une tâche d’exportation en cours d’un instantané vers Amazon S3.
```
aws rds cancel-export-task \
--export-task-identifier {{my-s3-export-1}}
```
Sortie :
```
{
"ExportTaskIdentifier": "my-s3-export-1",
"SourceArn": "arn:aws:rds:us-east-1:123456789012:snapshot:publisher-final-snapshot",
"SnapshotTime": "2019-03-24T20:01:09.815Z",
"S3Bucket": "amzn-s3-demo-bucket",
"S3Prefix": "",
"IamRoleArn": "arn:aws:iam::123456789012:role/service-role/export-snap-S3-role",
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/abcd0000-7bfd-4594-af38-aabbccddeeff",
"Status": "CANCELING",
"PercentProgress": 0,
"TotalExtractedDataInGB": 0
}
```
Pour plus d’informations, consultez [Annulation d’une tâche d’exportation d’instantané](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Canceling) dans le *Guide de l’utilisateur Amazon RDS* ou [Annulation d’une tâche d’exportation d’instantané](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Canceling) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CancelExportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/cancel-export-task.html)la section *Référence des AWS CLI commandes*.
### `copy-db-cluster-parameter-group`
L'exemple de code suivant montre comment utiliser`copy-db-cluster-parameter-group`.
**AWS CLI**
**Pour copier un groupe de paramètres de cluster de bases de données**
L’exemple `copy-db-cluster-parameter-group` suivant effectue une copie d’un groupe de paramètres de cluster de bases de données.
```
aws rds copy-db-cluster-parameter-group \
--source-db-cluster-parameter-group-identifier {{mydbclusterpg}} \
--target-db-cluster-parameter-group-identifier {{mydbclusterpgcopy}} \
--target-db-cluster-parameter-group-description {{"Copy of mydbclusterpg parameter group"}}
```
Sortie :
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "mydbclusterpgcopy",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy",
"DBParameterGroupFamily": "aurora-mysql5.7",
"Description": "Copy of mydbclusterpg parameter group"
}
}
```
Pour plus d’informations, consultez [Copie d’un groupe de paramètres de cluster de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.CopyingCluster) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CopyDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-cluster-parameter-group.html)la section *Référence des AWS CLI commandes*.
### `copy-db-cluster-snapshot`
L'exemple de code suivant montre comment utiliser`copy-db-cluster-snapshot`.
**AWS CLI**
**Pour copier un instantané de cluster de bases de données**
L’exemple `copy-db-cluster-snapshot` suivant effectue une copie d’un instantané de cluster de bases de données, y compris ses balises.
```
aws rds copy-db-cluster-snapshot \
--source-db-cluster-snapshot-identifier {{arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:myaurora-2019-06-04-09-16}}
--target-db-cluster-snapshot-identifier {{myclustersnapshotcopy}} \
--copy-tags
```
Sortie :
```
{
"DBClusterSnapshot": {
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1e"
],
"DBClusterSnapshotIdentifier": "myclustersnapshotcopy",
"DBClusterIdentifier": "myaurora",
"SnapshotCreateTime": "2019-06-04T09:16:42.649Z",
"Engine": "aurora-mysql",
"AllocatedStorage": 0,
"Status": "available",
"Port": 0,
"VpcId": "vpc-6594f31c",
"ClusterCreateTime": "2019-04-15T14:18:42.785Z",
"MasterUsername": "myadmin",
"EngineVersion": "5.7.mysql_aurora.2.04.2",
"LicenseModel": "aurora-mysql",
"SnapshotType": "manual",
"PercentProgress": 100,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:myclustersnapshotcopy",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
Pour plus d’informations, consultez [Copie d’un instantané](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CopySnapshot.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CopyDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-cluster-snapshot.html)la section *Référence des AWS CLI commandes*.
### `copy-db-parameter-group`
L'exemple de code suivant montre comment utiliser`copy-db-parameter-group`.
**AWS CLI**
**Pour copier un groupe de paramètres de cluster de bases de données**
L’exemple `copy-db-parameter-group` suivant effectue une copie d’un groupe de paramètres de bases de données.
```
aws rds copy-db-parameter-group \
--source-db-parameter-group-identifier {{mydbpg}} \
--target-db-parameter-group-identifier {{mydbpgcopy}} \
--target-db-parameter-group-description {{"Copy of mydbpg parameter group"}}
```
Sortie :
```
{
"DBParameterGroup": {
"DBParameterGroupName": "mydbpgcopy",
"DBParameterGroupArn": "arn:aws:rds:us-east-1:814387698303:pg:mydbpgcopy",
"DBParameterGroupFamily": "mysql5.7",
"Description": "Copy of mydbpg parameter group"
}
}
```
Pour plus d’informations, consultez [Copie d’un groupe de paramètres de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Copying) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [CopyDbParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-parameter-group.html)la section *Référence des AWS CLI commandes*.
### `copy-db-snapshot`
L'exemple de code suivant montre comment utiliser`copy-db-snapshot`.
**AWS CLI**
**Pour copier un instantané de base de données**
L’exemple `copy-db-snapshot` suivant crée une copie d’un instantané de base de données.
```
aws rds copy-db-snapshot \
--source-db-snapshot-identifier {{rds:database-mysql-2019-06-06-08-38}}
--target-db-snapshot-identifier {{mydbsnapshotcopy}}
```
Sortie :
```
{
"DBSnapshot": {
"VpcId": "vpc-6594f31c",
"Status": "creating",
"Encrypted": true,
"SourceDBSnapshotIdentifier": "arn:aws:rds:us-east-1:123456789012:snapshot:rds:database-mysql-2019-06-06-08-38",
"MasterUsername": "admin",
"Iops": 1000,
"Port": 3306,
"LicenseModel": "general-public-license",
"DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshotcopy",
"EngineVersion": "5.6.40",
"OptionGroupName": "default:mysql-5-6",
"ProcessorFeatures": [],
"Engine": "mysql",
"StorageType": "io1",
"DbiResourceId": "db-ZI7UJ5BLKMBYFGX7FDENCKADC4",
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"SnapshotType": "manual",
"IAMDatabaseAuthenticationEnabled": false,
"SourceRegion": "us-east-1",
"DBInstanceIdentifier": "database-mysql",
"InstanceCreateTime": "2019-04-30T15:45:53.663Z",
"AvailabilityZone": "us-east-1f",
"PercentProgress": 0,
"AllocatedStorage": 100,
"DBSnapshotIdentifier": "mydbsnapshotcopy"
}
}
```
Pour plus d’informations, consultez [Copie d’un instantané](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [CopyDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-snapshot.html)la section *Référence des AWS CLI commandes*.
### `copy-option-group`
L'exemple de code suivant montre comment utiliser`copy-option-group`.
**AWS CLI**
**Pour copier un groupe d’options**
L’exemple `copy-option-group` suivant effectue une copie d’un groupe d’options.
```
aws rds copy-option-group \
--source-option-group-identifier {{myoptiongroup}} \
--target-option-group-identifier {{new-option-group}} \
--target-option-group-description {{"My option group copy"}}
```
Sortie :
```
{
"OptionGroup": {
"Options": [],
"OptionGroupName": "new-option-group",
"MajorEngineVersion": "11.2",
"OptionGroupDescription": "My option group copy",
"AllowsVpcAndNonVpcInstanceMemberships": true,
"EngineName": "oracle-ee",
"OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:new-option-group"
}
}
```
Pour plus d’informations, consultez [Réalisation d’une copie d’un groupe d’options](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.Copy) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [CopyOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-option-group.html)la section *Référence des AWS CLI commandes*.
### `create-blue-green-deployment`
L'exemple de code suivant montre comment utiliser`create-blue-green-deployment`.
**AWS CLI**
**Exemple 1 : pour créer un blue/green déploiement pour une instance de base de données RDS pour MySQL**
L'`create-blue-green-deployment`exemple suivant crée un blue/green déploiement pour une instance de base de données MySQL.
```
aws rds create-blue-green-deployment \
--blue-green-deployment-name {{bgd-cli-test-instance}} \
--source {{arn:aws:rds:us-east-1:123456789012:db:my-db-instance}} \
--target-engine-version {{8.0}} \
--target-db-parameter-group-name {{mysql-80-group}}
```
Sortie :
```
{
"BlueGreenDeployment": {
"BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
"BlueGreenDeploymentName": "bgd-cli-test-instance",
"Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "PENDING"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "PENDING"
},
{
"Name": "CONFIGURE_BACKUPS",
"Status": "PENDING"
},
{
"Name": "CREATING_TOPOLOGY_OF_SOURCE",
"Status": "PENDING"
}
],
"Status": "PROVISIONING",
"CreateTime": "2022-02-25T21:18:51.183000+00:00"
}
}
```
Pour plus d'informations, consultez la section [Création d'un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-creating.html) dans le *guide de l'utilisateur Amazon RDS*.
**Exemple 2 : pour créer un blue/green déploiement pour un cluster de base de données Aurora MySQL**
L'`create-blue-green-deployment`exemple suivant crée un blue/green déploiement pour un cluster de base de données Aurora MySQL.
```
aws rds create-blue-green-deployment \
--blue-green-deployment-name {{my-blue-green-deployment}} \
--source {{arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster}} \
--target-engine-version {{8.0}} \
--target-db-cluster-parameter-group-name {{ams-80-binlog-enabled}} \
--target-db-parameter-group-name {{mysql-80-cluster-group}}
```
Sortie :
```
{
"BlueGreenDeployment": {
"BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
"BlueGreenDeploymentName": "my-blue-green-deployment",
"Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"Status": "PROVISIONING"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
"Status": "PROVISIONING"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
"Status": "PROVISIONING"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
"Status": "PROVISIONING"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
"Status": "PROVISIONING"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
"Status": "PROVISIONING"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "PENDING"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "PENDING"
},
{
"Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
"Status": "PENDING"
},
{
"Name": "CREATE_CUSTOM_ENDPOINTS",
"Status": "PENDING"
}
],
"Status": "PROVISIONING",
"CreateTime": "2022-02-25T21:12:00.288000+00:00"
}
}
```
Pour plus d'informations, consultez la section [Création d'un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-creating.html) dans le *guide de l'utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-blue-green-deployment.html)la section *Référence des AWS CLI commandes*.
### `create-db-cluster-endpoint`
L'exemple de code suivant montre comment utiliser`create-db-cluster-endpoint`.
**AWS CLI**
**Pour créer un point de terminaison de cluster de bases de données personnalisé**
L’exemple `create-db-cluster-endpoint` suivant crée un point de terminaison de cluster de bases de données personnalisé et l’associe au cluster de bases de données Aurora spécifié.
```
aws rds create-db-cluster-endpoint \
--db-cluster-endpoint-identifier {{mycustomendpoint}} \
--endpoint-type {{reader}} \
--db-cluster-identifier {{mydbcluster}} \
--static-members {{dbinstance1}} {{dbinstance2}}
```
Sortie :
```
{
"DBClusterEndpointIdentifier": "mycustomendpoint",
"DBClusterIdentifier": "mydbcluster",
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE",
"Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com",
"Status": "creating",
"EndpointType": "CUSTOM",
"CustomEndpointType": "READER",
"StaticMembers": [
"dbinstance1",
"dbinstance2"
],
"ExcludedMembers": [],
"DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint"
}
```
Pour plus d’informations, consultez [Gestion des connexions Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-endpoint.html)la section *Référence des AWS CLI commandes*.
### `create-db-cluster-parameter-group`
L'exemple de code suivant montre comment utiliser`create-db-cluster-parameter-group`.
**AWS CLI**
**Pour créer un groupe de paramètres de cluster de bases de données**
L’exemple `create-db-cluster-parameter-group` suivant crée un groupe de paramètres de cluster de bases de données.
```
aws rds create-db-cluster-parameter-group \
--db-cluster-parameter-group-name {{mydbclusterparametergroup}} \
--db-parameter-group-family {{aurora5.6}} \
--description {{"My new cluster parameter group"}}
```
Sortie :
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "mydbclusterparametergroup",
"DBParameterGroupFamily": "aurora5.6",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
}
}
```
Pour plus d’informations, consultez [Création d’un groupe de paramètres de cluster de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.CreatingCluster) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-parameter-group.html)la section *Référence des AWS CLI commandes*.
### `create-db-cluster-snapshot`
L'exemple de code suivant montre comment utiliser`create-db-cluster-snapshot`.
**AWS CLI**
**Pour créer un instantané de cluster de bases de données**
L’exemple `create-db-cluster-snapshot` suivant crée un instantané de cluster de bases de données.
```
aws rds create-db-cluster-snapshot \
--db-cluster-identifier {{mydbcluster}} \
--db-cluster-snapshot-identifier {{mydbclustersnapshot}}
```
Sortie :
```
{
"DBClusterSnapshot": {
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1e"
],
"DBClusterSnapshotIdentifier": "mydbclustersnapshot",
"DBClusterIdentifier": "mydbcluster",
"SnapshotCreateTime": "2019-06-18T21:21:00.469Z",
"Engine": "aurora-mysql",
"AllocatedStorage": 1,
"Status": "creating",
"Port": 0,
"VpcId": "vpc-6594f31c",
"ClusterCreateTime": "2019-04-15T14:18:42.785Z",
"MasterUsername": "myadmin",
"EngineVersion": "5.7.mysql_aurora.2.04.2",
"LicenseModel": "aurora-mysql",
"SnapshotType": "manual",
"PercentProgress": 0,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:mydbclustersnapshot",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
Pour plus d’informations, consultez [Création d’un instantané de cluster DB](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CreateSnapshotCluster.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-snapshot.html)la section *Référence des AWS CLI commandes*.
### `create-db-cluster`
L'exemple de code suivant montre comment utiliser`create-db-cluster`.
**AWS CLI**
**Exemple 1 : pour créer un cluster de bases de données compatible avec MySQL 5.7**
L’exemple `create-db-cluster` suivant crée un cluster de bases de données compatible avec MySQL 5.7 en utilisant la version du moteur par défaut. Remplacez ensuite l’exemple de mot de passe `secret99` par un mot de passe sécurisé. Si vous utilisez la console pour créer un cluster de bases de données, Amazon RDS crée automatiquement l’instance de base de données d’enregistreur pour votre cluster de bases de données. Toutefois, lorsque vous utilisez l' AWS interface de ligne de commande pour créer un cluster de base de données, vous devez créer explicitement l'instance de base de données d'écriture pour votre cluster de base de données à l'aide de la commande `create-db-instance` AWS CLI.
```
aws rds create-db-cluster \
--db-cluster-identifier {{sample-cluster}} \
--engine {{aurora-mysql}} \
--engine-version {{5.7}} \
--master-username {{admin}} \
--master-user-password {{secret99}} \
--db-subnet-group-name {{default}} \
--vpc-security-group-ids {{sg-0b9130572daf3dc16}}
```
Sortie :
```
{
"DBCluster": {
"DBSubnetGroup": "default",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-0b9130572daf3dc16",
"Status": "active"
}
],
"AllocatedStorage": 1,
"AssociatedRoles": [],
"PreferredBackupWindow": "09:12-09:42",
"ClusterCreateTime": "2023-02-27T23:21:33.048Z",
"DeletionProtection": false,
"IAMDatabaseAuthenticationEnabled": false,
"ReadReplicaIdentifiers": [],
"EngineMode": "provisioned",
"Engine": "aurora-mysql",
"StorageEncrypted": false,
"MultiAZ": false,
"PreferredMaintenanceWindow": "mon:04:31-mon:05:01",
"HttpEndpointEnabled": false,
"BackupRetentionPeriod": 1,
"DbClusterResourceId": "cluster-ANPAJ4AE5446DAEXAMPLE",
"DBClusterIdentifier": "sample-cluster",
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1e"
],
"MasterUsername": "master",
"EngineVersion": "5.7.mysql_aurora.2.11.1",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"DBClusterMembers": [],
"Port": 3306,
"Status": "creating",
"Endpoint": "sample-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"DBClusterParameterGroup": "default.aurora-mysql5.7",
"HostedZoneId": "Z2R2ITUGPM61AM",
"ReaderEndpoint": "sample-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
"CopyTagsToSnapshot": false
}
}
```
**Exemple 2 : pour créer un cluster de bases de données compatible avec PostgreSQL**
L’exemple `create-db-cluster` suivant crée un cluster de bases de données compatible avec PostgreSQL en utilisant la version du moteur par défaut. Remplacez ensuite l’exemple de mot de passe `secret99` par un mot de passe sécurisé. Si vous utilisez la console pour créer un cluster de bases de données, Amazon RDS crée automatiquement l’instance de base de données d’enregistreur pour votre cluster de bases de données. Toutefois, lorsque vous utilisez l' AWS interface de ligne de commande pour créer un cluster de base de données, vous devez créer explicitement l'instance de base de données d'écriture pour votre cluster de base de données à l'aide de la commande `create-db-instance` AWS CLI.
```
aws rds create-db-cluster \
--db-cluster-identifier {{sample-pg-cluster}} \
--engine {{aurora-postgresql}} \
--{{master}}-username master \
--master-user-password {{secret99}} \
--db-subnet-group-name {{default}} \
--vpc-security-group-ids {{sg-0b9130572daf3dc16}}
```
Sortie :
```
{
"DBCluster": {
"Endpoint": "sample-pg-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"HttpEndpointEnabled": false,
"DBClusterMembers": [],
"EngineMode": "provisioned",
"CopyTagsToSnapshot": false,
"HostedZoneId": "Z2R2ITUGPM61AM",
"IAMDatabaseAuthenticationEnabled": false,
"AllocatedStorage": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-0b9130572daf3dc16",
"Status": "active"
}
],
"DeletionProtection": false,
"StorageEncrypted": false,
"BackupRetentionPeriod": 1,
"PreferredBackupWindow": "09:56-10:26",
"ClusterCreateTime": "2023-02-27T23:26:08.371Z",
"DBClusterParameterGroup": "default.aurora-postgresql13",
"EngineVersion": "13.7",
"Engine": "aurora-postgresql",
"Status": "creating",
"DBClusterIdentifier": "sample-pg-cluster",
"MultiAZ": false,
"Port": 5432,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-pg-cluster",
"AssociatedRoles": [],
"DbClusterResourceId": "cluster-ANPAJ4AE5446DAEXAMPLE",
"PreferredMaintenanceWindow": "wed:03:33-wed:04:03",
"ReaderEndpoint": "sample-pg-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
"MasterUsername": "master",
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1c"
],
"ReadReplicaIdentifiers": [],
"DBSubnetGroup": "default"
}
}
```
Pour plus d’informations, consultez [Création d’un cluster de bases de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster.html)la section *Référence des AWS CLI commandes*.
### `create-db-instance-read-replica`
L'exemple de code suivant montre comment utiliser`create-db-instance-read-replica`.
**AWS CLI**
**Pour créer un réplica en lecture d’une instance de base de données**
Cet exemple crée un réplica en lecture d’une instance de base de données existante nommée `test-instance`. Le réplica en lecture est nommé `test-instance-repl`.
```
aws rds create-db-instance-read-replica \
--db-instance-identifier {{test-instance-repl}} \
--source-db-instance-identifier {{test-instance}}
```
Sortie :
```
{
"DBInstance": {
"IAMDatabaseAuthenticationEnabled": false,
"MonitoringInterval": 0,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl",
"ReadReplicaSourceDBInstanceIdentifier": "test-instance",
"DBInstanceIdentifier": "test-instance-repl",
...some output truncated...
}
}
```
+ Pour plus de détails sur l'API, voir [CreateDbInstanceReadReplica](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-instance-read-replica.html)la section *Référence des AWS CLI commandes*.
### `create-db-instance`
L'exemple de code suivant montre comment utiliser`create-db-instance`.
**AWS CLI**
**Pour créer une instance de base de données**
L’exemple `create-db-instance` suivant utilise les options requises pour lancer une nouvelle instance de base de données.
```
aws rds create-db-instance \
--db-instance-identifier {{test-mysql-instance}} \
--db-instance-class {{db.t3.micro}} \
--engine {{mysql}} \
--master-username {{admin}} \
--master-user-password {{secret99}} \
--allocated-storage {{20}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "test-mysql-instance",
"DBInstanceClass": "db.t3.micro",
"Engine": "mysql",
"DBInstanceStatus": "creating",
"MasterUsername": "admin",
"AllocatedStorage": 20,
"PreferredBackupWindow": "12:55-13:25",
"BackupRetentionPeriod": 1,
"DBSecurityGroups": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-12345abc",
"Status": "active"
}
],
"DBParameterGroups": [
{
"DBParameterGroupName": "default.mysql5.7",
"ParameterApplyStatus": "in-sync"
}
],
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-2ff2ff2f",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-########",
"SubnetAvailabilityZone": {
"Name": "us-west-2c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-########",
"SubnetAvailabilityZone": {
"Name": "us-west-2d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-########",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-########",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:08:07-sun:08:37",
"PendingModifiedValues": {
"MasterUserPassword": "****"
},
"MultiAZ": false,
"EngineVersion": "5.7.22",
"AutoMinorVersionUpgrade": true,
"ReadReplicaDBInstanceIdentifiers": [],
"LicenseModel": "general-public-license",
"OptionGroupMemberships": [
{
"OptionGroupName": "default:mysql-5-7",
"Status": "in-sync"
}
],
"PubliclyAccessible": true,
"StorageType": "gp2",
"DbInstancePort": 0,
"StorageEncrypted": false,
"DbiResourceId": "db-5555EXAMPLE44444444EXAMPLE",
"CACertificateIdentifier": "rds-ca-2019",
"DomainMemberships": [],
"CopyTagsToSnapshot": false,
"MonitoringInterval": 0,
"DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:test-mysql-instance",
"IAMDatabaseAuthenticationEnabled": false,
"PerformanceInsightsEnabled": false,
"DeletionProtection": false,
"AssociatedRoles": []
}
}
```
Pour plus d’informations, consultez [Création d’une instance de base de données Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Create DBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-instance.html) in *AWS CLI Command Reference*.
### `create-db-parameter-group`
L'exemple de code suivant montre comment utiliser`create-db-parameter-group`.
**AWS CLI**
**Pour créer un groupe de paramètres de base de données**
L’exemple `create-db-parameter-group` suivant crée un groupe de paramètres de base de données.
```
aws rds create-db-parameter-group \
--db-parameter-group-name {{mydbparametergroup}} \
--db-parameter-group-family {{MySQL5.6}} \
--description {{"My new parameter group"}}
```
Sortie :
```
{
"DBParameterGroup": {
"DBParameterGroupName": "mydbparametergroup",
"DBParameterGroupFamily": "mysql5.6",
"Description": "My new parameter group",
"DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:mydbparametergroup"
}
}
```
Pour plus d’informations, consultez [Création d’un groupe de paramètres DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Creating) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Créer un DBParameter groupe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-parameter-group.html) dans *AWS CLI la référence des commandes*.
### `create-db-proxy-endpoint`
L'exemple de code suivant montre comment utiliser`create-db-proxy-endpoint`.
**AWS CLI**
**Pour créer un point de terminaison de proxy de base de données pour une base de données RDS**
L’exemple `create-db-proxy-endpoint` suivant crée un point de terminaison proxy de base de données personnalisé.
```
aws rds create-db-proxy-endpoint \
--db-proxy-name {{proxyExample}} \
--db-proxy-endpoint-name {{"proxyep1"}} \
--vpc-subnet-ids {{subnetgroup1}} {{subnetgroup2}}
```
Sortie :
```
{
"DBProxyEndpoint": {
"DBProxyEndpointName": "proxyep1",
"DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab",
"DBProxyName": "proxyExample",
"Status": "creating",
"VpcId": "vpc-1234567",
"VpcSecurityGroupIds": [
"sg-1234",
"sg-5678"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Endpoint": "proxyep1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"CreatedDate": "2023-04-05T16:09:33.452000+00:00",
"TargetRole": "READ_WRITE",
"IsDefault": false
}
}
```
Pour plus d’informations, consultez [Création d’un point de terminaison de proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.CreatingEndpoint) dans le *Guide de l’utilisateur Amazon RDS* et [Création d’un point de terminaison de proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.CreatingEndpoint) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-proxy-endpoint.html)la section *Référence des AWS CLI commandes*.
### `create-db-proxy`
L'exemple de code suivant montre comment utiliser`create-db-proxy`.
**AWS CLI**
**Pour créer un proxy de base de données pour une base de données RDS**
L’exemple `create-db-proxy` suivant crée un proxy de base de données.
```
aws rds create-db-proxy \
--db-proxy-name {{proxyExample}} \
--engine-family {{MYSQL}} \
--auth Description="proxydescription1",AuthScheme="SECRETS",SecretArn="arn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f",IAMAuth="DISABLED",ClientPasswordAuthType="MYSQL_NATIVE_PASSWORD" \
--role-arn {{arn:aws:iam::123456789123:role/ProxyRole}} \
--vpc-subnet-ids {{subnetgroup1}} {{subnetgroup2}}
```
Sortie :
```
{
"DBProxy": {
"DBProxyName": "proxyExample",
"DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab",
"EngineFamily": "MYSQL",
"VpcId": "vpc-1234567",
"VpcSecuritytGroupIds": [
"sg-1234",
"sg-5678",
"sg-9101"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Auth": "[
{
"Description": "proxydescription1",
"AuthScheme": "SECRETS",
"SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e",
"IAMAuth": "DISABLED"
}
]",
"RoleArn": "arn:aws:iam::12345678912:role/ProxyRole",
"Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"RequireTLS": false,
"IdleClientTimeout": 1800,
"DebuggingLogging": false,
"CreatedDate": "2023-04-05T16:09:33.452000+00:00",
"UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
}
}
```
Pour plus d’informations, consultez [Création d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-creating) dans le *Guide de l’utilisateur Amazon RDS* et [Création d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-creating) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-proxy.html)la section *Référence des AWS CLI commandes*.
### `create-db-security-group`
L'exemple de code suivant montre comment utiliser`create-db-security-group`.
**AWS CLI**
**Pour créer un groupe de sécurité de base de données Amazon RDS**
La commande `create-db-security-group` suivante crée un nouveau groupe de sécurité de base de données Amazon RDS :
```
aws rds create-db-security-group --db-security-group-name {{mysecgroup}} --db-security-group-description {{"My Test Security Group"}}
```
Dans l’exemple, le nouveau groupe de sécurité de base de données est nommé `mysecgroup` et possède une description.
Sortie :
```
{
"DBSecurityGroup": {
"OwnerId": "123456789012",
"DBSecurityGroupName": "mysecgroup",
"DBSecurityGroupDescription": "My Test Security Group",
"VpcId": "vpc-a1b2c3d4",
"EC2SecurityGroups": [],
"IPRanges": [],
"DBSecurityGroupArn": "arn:aws:rds:us-west-2:123456789012:secgrp:mysecgroup"
}
}
```
+ Pour plus de détails sur l'API, voir [CreateDbSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-security-group.html)la section *Référence des AWS CLI commandes*.
### `create-db-shard-group`
L'exemple de code suivant montre comment utiliser`create-db-shard-group`.
**AWS CLI**
**Exemple 1 : pour créer un cluster de bases de données principal Aurora PostgreSQL**
L’exemple `create-db-cluster` suivant crée un cluster de base de données principal SQL Aurora PostgreSQL compatible avec Aurora sans serveur v2 et Aurora Limitless Database.
```
aws rds create-db-cluster \
--db-cluster-identifier {{my-sv2-cluster}} \
--engine {{aurora-postgresql}} \
--engine-version {{15.2-limitless}} \
--storage-type {{aurora-iopt1}} \
--serverless-v2-scaling-configuration {{MinCapacity=2,MaxCapacity=16}} \
--enable-limitless-database \
--master-username {{myuser}} \
--master-user-password {{mypassword}} \
--enable-cloudwatch-logs-exports {{postgresql}}
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-2b",
"us-east-2c",
"us-east-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "my-sv2-cluster",
"DBClusterParameterGroup": "default.aurora-postgresql15",
"DBSubnetGroup": "default",
"Status": "creating",
"Endpoint": "my-sv2-cluster.cluster-cekycexample.us-east-2.rds.amazonaws.com",
"ReaderEndpoint": "my-sv2-cluster.cluster-ro-cekycexample.us-east-2.rds.amazonaws.com",
"MultiAZ": false,
"Engine": "aurora-postgresql",
"EngineVersion": "15.2-limitless",
"Port": 5432,
"MasterUsername": "myuser",
"PreferredBackupWindow": "06:05-06:35",
"PreferredMaintenanceWindow": "mon:08:25-mon:08:55",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-########",
"Status": "active"
}
],
"HostedZoneId": "Z2XHWR1EXAMPLE",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-XYEDT6ML6FHIXH4Q2J1EXAMPLE",
"DBClusterArn": "arn:aws:rds:us-east-2:123456789012:cluster:my-sv2-cluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2024-02-19T16:24:07.771000+00:00",
"EnabledCloudwatchLogsExports": [
"postgresql"
],
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": [],
"TagList": [],
"StorageType": "aurora-iopt1",
"AutoMinorVersionUpgrade": true,
"ServerlessV2ScalingConfiguration": {
"MinCapacity": 2.0,
"MaxCapacity": 16.0
},
"NetworkType": "IPV4",
"IOOptimizedNextAllowedModificationTime": "2024-03-21T16:24:07.781000+00:00",
"LimitlessDatabase": {
"Status": "not-in-use",
"MinRequiredACU": 96.0
}
}
}
```
**Exemple 2 : pour créer l’instance de base de données principale (enregistreur)**
L’exemple `create-db-instance` suivant crée une instance de base de données principale (enregistreur) Aurora sans serveur v2. Si vous utilisez la console pour créer un cluster de bases de données, Amazon RDS crée automatiquement l’instance de base de données d’enregistreur pour votre cluster de bases de données. Toutefois, lorsque vous utilisez l' AWS interface de ligne de commande pour créer un cluster de base de données, vous devez créer explicitement l'instance de base de données d'écriture pour votre cluster de base de données à l'aide de la commande `create-db-instance` AWS CLI.
```
aws rds create-db-instance \
--db-instance-identifier {{my-sv2-instance}} \
--db-cluster-identifier {{my-sv2-cluster}} \
--engine {{aurora-postgresql}} \
--db-instance-class {{db.serverless}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "my-sv2-instance",
"DBInstanceClass": "db.serverless",
"Engine": "aurora-postgresql",
"DBInstanceStatus": "creating",
"MasterUsername": "myuser",
"AllocatedStorage": 1,
"PreferredBackupWindow": "06:05-06:35",
"BackupRetentionPeriod": 1,
"DBSecurityGroups": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-########",
"Status": "active"
}
],
"DBParameterGroups": [
{
"DBParameterGroupName": "default.aurora-postgresql15",
"ParameterApplyStatus": "in-sync"
}
],
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-########",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-########",
"SubnetAvailabilityZone": {
"Name": "us-east-2c"
},
"SubnetOutpost": {},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-########",
"SubnetAvailabilityZone": {
"Name": "us-east-2a"
},
"SubnetOutpost": {},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-########",
"SubnetAvailabilityZone": {
"Name": "us-east-2b"
},
"SubnetOutpost": {},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "fri:09:01-fri:09:31",
"PendingModifiedValues": {
"PendingCloudwatchLogsExports": {
"LogTypesToEnable": [
"postgresql"
]
}
},
"MultiAZ": false,
"EngineVersion": "15.2-limitless",
"AutoMinorVersionUpgrade": true,
"ReadReplicaDBInstanceIdentifiers": [],
"LicenseModel": "postgresql-license",
"OptionGroupMemberships": [
{
"OptionGroupName": "default:aurora-postgresql-15",
"Status": "in-sync"
}
],
"PubliclyAccessible": false,
"StorageType": "aurora-iopt1",
"DbInstancePort": 0,
"DBClusterIdentifier": "my-sv2-cluster",
"StorageEncrypted": false,
"DbiResourceId": "db-BIQTE3B3K3RM7M74SK5EXAMPLE",
"CACertificateIdentifier": "rds-ca-rsa2048-g1",
"DomainMemberships": [],
"CopyTagsToSnapshot": false,
"MonitoringInterval": 0,
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-2:123456789012:db:my-sv2-instance",
"IAMDatabaseAuthenticationEnabled": false,
"PerformanceInsightsEnabled": false,
"DeletionProtection": false,
"AssociatedRoles": [],
"TagList": [],
"CustomerOwnedIpEnabled": false,
"BackupTarget": "region",
"NetworkType": "IPV4",
"StorageThroughput": 0,
"CertificateDetails": {
"CAIdentifier": "rds-ca-rsa2048-g1"
},
"DedicatedLogVolume": false
}
}
```
**Exemple 3 : pour créer le groupe de partitions de base de données**
L’exemple `create-db-shard-group` suivant crée un groupe de partitions de base de données dans le cluster de bases de données principal Aurora PostgreSQL.
```
aws rds create-db-shard-group \
--db-shard-group-identifier {{my-db-shard-group}} \
--db-cluster-identifier {{my-sv2-cluster}} \
--max-acu {{768}}
```
Sortie :
```
{
"DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
"DBShardGroupIdentifier": "my-db-shard-group",
"DBClusterIdentifier": "my-sv2-cluster",
"MaxACU": 768.0,
"ComputeRedundancy": 0,
"Status": "creating",
"PubliclyAccessible": false,
"Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}
```
Pour plus d’informations, consultez [Utilisation d’Amazon Aurora sans serveur v2](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-shard-group.html)la section *Référence des AWS CLI commandes*.
### `create-db-snapshot`
L'exemple de code suivant montre comment utiliser`create-db-snapshot`.
**AWS CLI**
**Pour créer un instantané de base de données**
L’exemple `create-db-snapshot` suivant crée un instantané de base de données.
```
aws rds create-db-snapshot \
--db-instance-identifier {{database-mysql}} \
--db-snapshot-identifier {{mydbsnapshot}}
```
Sortie :
```
{
"DBSnapshot": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBInstanceIdentifier": "database-mysql",
"Engine": "mysql",
"AllocatedStorage": 100,
"Status": "creating",
"Port": 3306,
"AvailabilityZone": "us-east-1b",
"VpcId": "vpc-6594f31c",
"InstanceCreateTime": "2019-04-30T15:45:53.663Z",
"MasterUsername": "admin",
"EngineVersion": "5.6.40",
"LicenseModel": "general-public-license",
"SnapshotType": "manual",
"Iops": 1000,
"OptionGroupName": "default:mysql-5-6",
"PercentProgress": 0,
"StorageType": "io1",
"Encrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot",
"IAMDatabaseAuthenticationEnabled": false,
"ProcessorFeatures": [],
"DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE"
}
}
```
Pour plus d’informations, consultez [Création d’un instantané de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Create DBSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-snapshot.html) in *AWS CLI Command Reference*.
### `create-db-subnet-group`
L'exemple de code suivant montre comment utiliser`create-db-subnet-group`.
**AWS CLI**
**Pour créer un groupe de sous-réseaux de base de données**
L’exemple `create-db-subnet-group` suivant crée un groupe de sous-réseaux de base de données appelé `mysubnetgroup` à l’aide de sous-réseaux existants.
```
aws rds create-db-subnet-group \
--db-subnet-group-name {{mysubnetgroup}} \
--db-subnet-group-description {{"test DB subnet group"}} \
--subnet-ids '{{["subnet-0a1dc4e1a6f123456","subnet-070dd7ecb3aaaaaaa","subnet-00f5b198bc0abcdef"]}}'
```
Sortie :
```
{
"DBSubnetGroup": {
"DBSubnetGroupName": "mysubnetgroup",
"DBSubnetGroupDescription": "test DB subnet group",
"VpcId": "vpc-0f08e7610a1b2c3d4",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-070dd7ecb3aaaaaaa",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-00f5b198bc0abcdef",
"SubnetAvailabilityZone": {
"Name": "us-west-2d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-0a1dc4e1a6f123456",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
],
"DBSubnetGroupArn": "arn:aws:rds:us-west-2:0123456789012:subgrp:mysubnetgroup"
}
}
```
Pour plus d’informations, consultez [Création d’une instance de base de données dans un VPC](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.InstanceInVPC) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [CreateDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-subnet-group.html)la section *Référence des AWS CLI commandes*.
### `create-event-subscription`
L'exemple de code suivant montre comment utiliser`create-event-subscription`.
**AWS CLI**
**Pour créer un abonnement à un événement**
L'`create-event-subscription`exemple suivant crée un abonnement pour les événements de sauvegarde et de restauration pour les instances de base de données du AWS compte courant. Les notifications sont envoyées à une rubrique Amazon Simple Notification Service spécifiée par `--sns-topic-arn`.
```
aws rds create-event-subscription \
--subscription-name {{my-instance-events}} \
--source-type {{db-instance}} \
--event-categories '{{["backup","recovery"]}}' \
--sns-topic-arn {{arn:aws:sns:us-east-1:123456789012:interesting-events}}
```
Sortie :
```
{
"EventSubscription": {
"Status": "creating",
"CustSubscriptionId": "my-instance-events",
"SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
"EventCategoriesList": [
"backup",
"recovery"
],
"SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
"CustomerAwsId": "123456789012",
"EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
"SourceType": "db-instance",
"Enabled": true
}
}
```
+ Pour plus de détails sur l'API, voir [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-event-subscription.html)la section *Référence des AWS CLI commandes*.
### `create-global-cluster`
L'exemple de code suivant montre comment utiliser`create-global-cluster`.
**AWS CLI**
**Pour créer un cluster de bases de données global**
L’exemple `create-global-cluster` suivant crée un nouveau cluster de bases de données global compatible avec Aurora MySQL.
```
aws rds create-global-cluster \
--global-cluster-identifier {{myglobalcluster}} \
--engine {{aurora-mysql}}
```
Sortie :
```
{
"GlobalCluster": {
"GlobalClusterIdentifier": "myglobalcluster",
"GlobalClusterResourceId": "cluster-f0e523bfe07aabb",
"GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
"Status": "available",
"Engine": "aurora-mysql",
"EngineVersion": "5.7.mysql_aurora.2.07.2",
"StorageEncrypted": false,
"DeletionProtection": false,
"GlobalClusterMembers": []
}
}
```
Pour plus d’informations, consultez [Création d’une base de données Aurora globale](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-getting-started.html#aurora-global-database-creating) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [CreateGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-global-cluster.html)la section *Référence des AWS CLI commandes*.
### `create-option-group`
L'exemple de code suivant montre comment utiliser`create-option-group`.
**AWS CLI**
**Pour créer un groupe d’options Amazon RDS**
La commande `create-option-group` suivante crée un nouveau groupe d’options Amazon RDS pour `Oracle Enterprise Edition` version `11.2`, is named ``MyOptionGroup` et inclut une description.
```
aws rds create-option-group \
--option-group-name {{MyOptionGroup}} \
--engine-name {{oracle-ee}} \
--major-engine-version {{11.2}} \
--option-group-description {{"Oracle Database Manager Database Control"}}
```
Sortie :
```
{
"OptionGroup": {
"OptionGroupName": "myoptiongroup",
"OptionGroupDescription": "Oracle Database Manager Database Control",
"EngineName": "oracle-ee",
"MajorEngineVersion": "11.2",
"Options": [],
"AllowsVpcAndNonVpcInstanceMemberships": true,
"OptionGroupArn": "arn:aws:rds:us-west-2:123456789012:og:myoptiongroup"
}
}
```
+ Pour plus de détails sur l'API, voir [CreateOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-option-group.html)la section *Référence des AWS CLI commandes*.
### `delete-blue-green-deployment`
L'exemple de code suivant montre comment utiliser`delete-blue-green-deployment`.
**AWS CLI**
**Exemple 1 : pour supprimer des ressources dans un environnement vert pour une instance de base de données RDS for MySQL**
L’exemple `delete-blue-green-deployment` suivant supprime les ressources dans un environnement vert pour une instance de base de données RDS for MySQL.
```
aws rds delete-blue-green-deployment \
--blue-green-deployment-identifier {{bgd-v53303651eexfake}} \
--delete-target
```
Sortie :
```
{
"BlueGreenDeployment": {
"BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
"BlueGreenDeploymentName": "bgd-cli-test-instance",
"Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-j382ha",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ejv4ao",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-vlpz3t",
"Status": "AVAILABLE"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CONFIGURE_BACKUPS",
"Status": "COMPLETED"
},
{
"Name": "CREATING_TOPOLOGY_OF_SOURCE",
"Status": "COMPLETED"
}
],
"Status": "DELETING",
"CreateTime": "2022-02-25T21:18:51.183000+00:00",
"DeleteTime": "2022-02-25T22:25:31.331000+00:00"
}
}
```
Pour plus d'informations, consultez [Supprimer un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-deleting.html) dans le *guide de l'utilisateur Amazon RDS*.
**Exemple 2 : pour supprimer des ressources dans un environnement vert pour un cluster de bases de données Aurora MySQL**
L’exemple `delete-blue-green-deployment` suivant supprime les ressources dans un environnement vert pour un cluster de bases de données Aurora MySQL.
```
aws rds delete-blue-green-deployment \
--blue-green-deployment-identifier {{bgd-wi89nwzglccsfake}} \
--delete-target
```
Sortie :
```
{
"BlueGreenDeployment": {
"BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
"BlueGreenDeploymentName": "my-blue-green-deployment",
"Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg",
"Status": "AVAILABLE"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
"Status": "COMPLETED"
},
{
"Name": "CREATE_CUSTOM_ENDPOINTS",
"Status": "COMPLETED"
}
],
"Status": "DELETING",
"CreateTime": "2022-02-25T21:12:00.288000+00:00",
"DeleteTime": "2022-02-25T22:29:11.336000+00:00"
}
}
```
Pour plus d'informations, consultez [la section Suppression d'un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-deleting.html) dans le *guide de l'utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-blue-green-deployment.html)la section *Référence des AWS CLI commandes*.
### `delete-db-cluster-endpoint`
L'exemple de code suivant montre comment utiliser`delete-db-cluster-endpoint`.
**AWS CLI**
**Pour supprimer un point de terminaison de cluster de bases de données personnalisé**
L’exemple `delete-db-cluster-endpoint` suivant supprime le point de terminaison de cluster de bases de données personnalisé spécifié.
```
aws rds delete-db-cluster-endpoint \
--db-cluster-endpoint-identifier {{mycustomendpoint}}
```
Sortie :
```
{
"DBClusterEndpointIdentifier": "mycustomendpoint",
"DBClusterIdentifier": "mydbcluster",
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE",
"Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com",
"Status": "deleting",
"EndpointType": "CUSTOM",
"CustomEndpointType": "READER",
"StaticMembers": [
"dbinstance1",
"dbinstance2",
"dbinstance3"
],
"ExcludedMembers": [],
"DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint"
}
```
Pour plus d’informations, consultez [Gestion des connexions Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-endpoint.html)la section *Référence des AWS CLI commandes*.
### `delete-db-cluster-parameter-group`
L'exemple de code suivant montre comment utiliser`delete-db-cluster-parameter-group`.
**AWS CLI**
**Pour supprimer un groupe de paramètres de cluster de bases de données**
L’exemple `delete-db-cluster-parameter-group` suivant supprime le groupe de paramètres de cluster de bases de données spécifié.
```
aws rds delete-db-cluster-parameter-group \
--db-cluster-parameter-group-name {{mydbclusterparametergroup}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-parameter-group.html)la section *Référence des AWS CLI commandes*.
### `delete-db-cluster-snapshot`
L'exemple de code suivant montre comment utiliser`delete-db-cluster-snapshot`.
**AWS CLI**
**Pour supprimer un instantané de cluster de bases de données**
L’exemple `delete-db-cluster-snapshot` suivant supprime l’instantané de cluster de bases de données spécifié.
```
aws rds delete-db-cluster-snapshot \
--db-cluster-snapshot-identifier {{mydbclustersnapshot}}
```
Sortie :
```
{
"DBClusterSnapshot": {
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1e"
],
"DBClusterSnapshotIdentifier": "mydbclustersnapshot",
"DBClusterIdentifier": "mydbcluster",
"SnapshotCreateTime": "2019-06-18T21:21:00.469Z",
"Engine": "aurora-mysql",
"AllocatedStorage": 0,
"Status": "available",
"Port": 0,
"VpcId": "vpc-6594f31c",
"ClusterCreateTime": "2019-04-15T14:18:42.785Z",
"MasterUsername": "myadmin",
"EngineVersion": "5.7.mysql_aurora.2.04.2",
"LicenseModel": "aurora-mysql",
"SnapshotType": "manual",
"PercentProgress": 100,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:mydbclustersnapshot",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
Pour plus d’informations, consultez [Suppression d’un instantané](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteSnapshot.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-snapshot.html)la section *Référence des AWS CLI commandes*.
### `delete-db-cluster`
L'exemple de code suivant montre comment utiliser`delete-db-cluster`.
**AWS CLI**
**Exemple 1 : pour supprimer une instance de base de données dans un cluster de bases de données**
L’exemple `delete-db-instance` suivant supprime l’instance de base de données finale dans un cluster de bases de données. Vous ne pouvez pas supprimer un cluster de bases de données s’il contient des instances de base de données dont l’état n’est pas **suppression en cours**. Vous ne pouvez pas prendre un instantané final lors de la suppression d’une instance de base de données dans un cluster de bases de données.
```
aws rds delete-db-instance \
--db-instance-identifier {{database-3}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "database-3",
"DBInstanceClass": "db.r4.large",
"Engine": "aurora-postgresql",
"DBInstanceStatus": "deleting",
...output omitted...
}
}
```
Pour plus d’informations, consultez [Suppression d’une instance de base de données dans un cluster de base de données Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteInstance.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 2 : pour supprimer un cluster de bases de données**
L’exemple `delete-db-cluster` suivant supprime le cluster de bases de données appelé `mycluster` et prend un instantané final nommé `mycluster-final-snapshot`. Le statut du cluster de bases de données est **disponible** pendant la prise de l’instantané. Pour suivre la progression de la suppression, utilisez la commande `describe-db-clusters` de l’interface de ligne de commande.
```
aws rds delete-db-cluster \
--db-cluster-identifier {{mycluster}} \
--no-skip-final-snapshot \
--final-db-snapshot-identifier {{mycluster-final-snapshot}}
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 20,
"AvailabilityZones": [
"eu-central-1b",
"eu-central-1c",
"eu-central-1a"
],
"BackupRetentionPeriod": 7,
"DBClusterIdentifier": "mycluster",
"DBClusterParameterGroup": "default.aurora-postgresql10",
"DBSubnetGroup": "default-vpc-aa11bb22",
"Status": "available",
...output omitted...
}
}
```
Pour plus d’informations, consultez [Clusters Aurora avec une seule instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteInstance.html#USER_DeleteInstance.LastInstance) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster.html)la section *Référence des AWS CLI commandes*.
### `delete-db-instance-automated-backup`
L'exemple de code suivant montre comment utiliser`delete-db-instance-automated-backup`.
**AWS CLI**
**Pour supprimer une sauvegarde automatique répliquée d’une région**
L’exemple `delete-db-instance-automated-backup` suivant supprime la sauvegarde automatique avec l’Amazon Resource Name (ARN) spécifié.
```
aws rds delete-db-instance-automated-backup \
--db-instance-automated-backups-arn {{"arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"}}
```
Sortie :
```
{
"DBInstanceAutomatedBackup": {
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
"DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
"Region": "us-east-1",
"DBInstanceIdentifier": "new-orcl-db",
"RestoreWindow": {},
"AllocatedStorage": 20,
"Status": "deleting",
"Port": 1521,
"AvailabilityZone": "us-east-1b",
"VpcId": "vpc-########",
"InstanceCreateTime": "2020-12-04T15:28:31Z",
"MasterUsername": "admin",
"Engine": "oracle-se2",
"EngineVersion": "12.1.0.2.v21",
"LicenseModel": "bring-your-own-license",
"OptionGroupName": "default:oracle-se2-12-1",
"Encrypted": false,
"StorageType": "gp2",
"IAMDatabaseAuthenticationEnabled": false,
"BackupRetentionPeriod": 7,
"DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
}
}
```
Pour plus d’informations, consultez [Suppression de sauvegardes répliquées](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Delete) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [DeleteDbInstanceAutomatedBackup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-instance-automated-backup.html)la section *Référence des AWS CLI commandes*.
### `delete-db-instance`
L'exemple de code suivant montre comment utiliser`delete-db-instance`.
**AWS CLI**
**Pour supprimer une instance de base de données**
L’exemple `delete-db-instance` suivant supprime l’instance de base de données spécifiée après la création d’un instantané de base de données final nommé `test-instance-final-snap`.
```
aws rds delete-db-instance \
--db-instance-identifier {{test-instance}} \
--final-db-snapshot-identifier {{test-instance-final-snap}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "test-instance",
"DBInstanceStatus": "deleting",
...some output truncated...
}
}
```
+ Pour plus de détails sur l'API, voir [Supprimer DBInstance dans le](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-instance.html) manuel de *référence des AWS CLI commandes*.
### `delete-db-parameter-group`
L'exemple de code suivant montre comment utiliser`delete-db-parameter-group`.
**AWS CLI**
**Pour supprimer un groupe de paramètres de base de données**
L’exemple `command` suivant supprime un groupe de paramètres de base de données.
```
aws rds delete-db-parameter-group \
--db-parameter-group-name {{mydbparametergroup}}
```
Cette commande ne produit aucune sortie.
Pour de plus amples informations, veuillez consulter [ Utilisation des groupes de paramètres de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Supprimer le DBParameter groupe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-parameter-group.html) dans *AWS CLI la référence des commandes*.
### `delete-db-proxy-endpoint`
L'exemple de code suivant montre comment utiliser`delete-db-proxy-endpoint`.
**AWS CLI**
**Pour supprimer un point de terminaison de proxy de base de données pour une base de données RDS**
L’exemple `delete-db-proxy-endpoint` suivant supprime un point de terminaison proxy de base de données pour la base de données cible.
```
aws rds delete-db-proxy-endpoint \
--db-proxy-endpoint-name {{proxyEP1}}
```
Sortie :
```
{
"DBProxyEndpoint":
{
"DBProxyEndpointName": "proxyEP1",
"DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab",
"DBProxyName": "proxyExample",
"Status": "deleting",
"VpcId": "vpc-1234567",
"VpcSecurityGroupIds": [
"sg-1234",
"sg-5678"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Endpoint": "proxyEP1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"CreatedDate": "2023-04-13T01:49:38.568000+00:00",
"TargetRole": "READ_ONLY",
"IsDefault": false
}
}
```
Pour plus d’informations, consultez [Suppression d’un point de terminaison proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DeletingEndpoint) dans le *Guide de l’utilisateur Amazon RDS* et [Suppression d’un point de terminaison proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DeletingEndpoint) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-proxy-endpoint.html)la section *Référence des AWS CLI commandes*.
### `delete-db-proxy`
L'exemple de code suivant montre comment utiliser`delete-db-proxy`.
**AWS CLI**
**Pour supprimer un proxy de base de données pour une base de données RDS**
L’exemple `delete-db-proxy` suivant supprime un proxy de base de données.
```
aws rds delete-db-proxy \
--db-proxy-name {{proxyExample}}
```
Sortie :
```
{
"DBProxy":
{
"DBProxyName": "proxyExample",
"DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab",
"Status": "deleting",
"EngineFamily": "PostgreSQL",
"VpcId": "vpc-1234567",
"VpcSecurityGroupIds": [
"sg-1234",
"sg-5678"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Auth": "[
{
"Description": "proxydescription`"
"AuthScheme": "SECRETS",
"SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e",
"IAMAuth": "DISABLED"
} ],
"RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole",
"Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"RequireTLS": false,
"IdleClientTimeout": 1800,
"DebuggingLogging": false,
"CreatedDate": "2023-04-05T16:09:33.452000+00:00",
"UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
}
}
```
Pour plus d’informations, consultez [Suppression d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-deleting) dans le *Guide de l’utilisateur Amazon RDS* et [Suppression d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-deleting) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-proxy.html)la section *Référence des AWS CLI commandes*.
### `delete-db-security-group`
L'exemple de code suivant montre comment utiliser`delete-db-security-group`.
**AWS CLI**
**Pour supprimer un groupe de sécurité de base de données**
L’exemple `delete-db-security-group` suivant supprime un groupe de sécurité de base de données nommé `mysecuritygroup`.
```
aws rds delete-db-security-group \
--db-security-group-name {{mysecuritygroup}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Utilisation des groupes de sécurité DB (plateforme EC2-Classic)](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [DeleteDbSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-security-group.html)la section *Référence des AWS CLI commandes*.
### `delete-db-shard-group`
L'exemple de code suivant montre comment utiliser`delete-db-shard-group`.
**AWS CLI**
**Exemple 1 : pour supprimer un groupe de partitions de base de données sans succès**
L’exemple `delete-db-shard-group` suivant montre l’erreur qui se produit lorsque vous essayez de supprimer un groupe de partitions de base de données avant de supprimer l’ensemble de vos bases de données et de vos schémas.
```
aws rds delete-db-shard-group \
--db-shard-group-identifier {{limitless-test-shard-grp}}
```
Sortie :
```
An error occurred (InvalidDBShardGroupState) when calling the DeleteDBShardGroup operation: Unable to delete the DB shard group limitless-test-db-shard-group.
Delete all of your Limitless Database databases and schemas, then try again.
```
**Exemple 2 : pour supprimer un groupe de partitions de base de données avec succès**
L’exemple `delete-db-shard-group` suivant supprime un groupe de partitions de base de données une fois que vous avez supprimé toutes vos bases de données et tous vos schémas, y compris le schéma `public`.
```
aws rds delete-db-shard-group \
--db-shard-group-identifier {{limitless-test-shard-grp}}
```
Sortie :
```
{
"DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
"DBShardGroupIdentifier": "limitless-test-shard-grp",
"DBClusterIdentifier": "limitless-test-cluster",
"MaxACU": 768.0,
"ComputeRedundancy": 0,
"Status": "deleting",
"PubliclyAccessible": true,
"Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}
```
Pour plus d’informations, consultez [Suppression de clusters de bases de données Aurora et d’instances de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteCluster.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-shard-group.html)la section *Référence des AWS CLI commandes*.
### `delete-db-snapshot`
L'exemple de code suivant montre comment utiliser`delete-db-snapshot`.
**AWS CLI**
**Pour supprimer un instantané de base de données**
L’exemple `delete-db-snapshot` suivant supprime l’instantané de base de données spécifié.
```
aws rds delete-db-snapshot \
--db-snapshot-identifier {{mydbsnapshot}}
```
Sortie :
```
{
"DBSnapshot": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBInstanceIdentifier": "database-mysql",
"SnapshotCreateTime": "2019-06-18T22:08:40.702Z",
"Engine": "mysql",
"AllocatedStorage": 100,
"Status": "deleted",
"Port": 3306,
"AvailabilityZone": "us-east-1b",
"VpcId": "vpc-6594f31c",
"InstanceCreateTime": "2019-04-30T15:45:53.663Z",
"MasterUsername": "admin",
"EngineVersion": "5.6.40",
"LicenseModel": "general-public-license",
"SnapshotType": "manual",
"Iops": 1000,
"OptionGroupName": "default:mysql-5-6",
"PercentProgress": 100,
"StorageType": "io1",
"Encrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot",
"IAMDatabaseAuthenticationEnabled": false,
"ProcessorFeatures": [],
"DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE"
}
}
```
Pour plus d’informations, consultez [Suppression d’un instantané](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteSnapshot.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [DeleteDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-snapshot.html)la section *Référence des AWS CLI commandes*.
### `delete-db-subnet-group`
L'exemple de code suivant montre comment utiliser`delete-db-subnet-group`.
**AWS CLI**
**Pour supprimer un groupe de sous-réseaux de base de données**
L’exemple `delete-db-subnet-group` suivant supprime le groupe de sous-réseaux de base de données nommé `mysubnetgroup`.
```
aws rds delete-db-subnet-group --db-subnet-group-name {{mysubnetgroup}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Utilisation d’une instance de base de données dans un VPC](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [DeleteDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-subnet-group.html)la section *Référence des AWS CLI commandes*.
### `delete-event-subscription`
L'exemple de code suivant montre comment utiliser`delete-event-subscription`.
**AWS CLI**
**Pour supprimer un abonnement à un événement**
L’exemple `delete-event-subscription` suivant supprime l’abonnement à un événement spécifié.
```
aws rds delete-event-subscription --subscription-name {{my-instance-events}}
```
Sortie :
```
{
"EventSubscription": {
"EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
"CustomerAwsId": "123456789012",
"Enabled": false,
"SourceIdsList": [
"test-instance"
],
"SourceType": "db-instance",
"EventCategoriesList": [
"backup",
"recovery"
],
"SubscriptionCreationTime": "2018-07-31 23:22:01.893",
"CustSubscriptionId": "my-instance-events",
"SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
"Status": "deleting"
}
}
```
+ Pour plus de détails sur l'API, voir [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-event-subscription.html)la section *Référence des AWS CLI commandes*.
### `delete-global-cluster`
L'exemple de code suivant montre comment utiliser`delete-global-cluster`.
**AWS CLI**
**Pour supprimer un cluster de bases de données global**
L’exemple `delete-global-cluster` suivant supprime un cluster de bases de données global compatible avec Aurora MySQL. La sortie indique le cluster que vous supprimez, mais les commandes `describe-global-clusters` suivantes ne répertorient pas ce cluster de bases de données.
```
aws rds delete-global-cluster \
--global-cluster-identifier {{myglobalcluster}}
```
Sortie :
```
{
"GlobalCluster": {
"GlobalClusterIdentifier": "myglobalcluster",
"GlobalClusterResourceId": "cluster-f0e523bfe07aabb",
"GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
"Status": "available",
"Engine": "aurora-mysql",
"EngineVersion": "5.7.mysql_aurora.2.07.2",
"StorageEncrypted": false,
"DeletionProtection": false,
"GlobalClusterMembers": []
}
}
```
Pour plus d’informations, consultez [Dissociation d’une base de données Aurora globale](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html#aurora-global-database-deleting) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeleteGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-global-cluster.html)la section *Référence des AWS CLI commandes*.
### `delete-option-group`
L'exemple de code suivant montre comment utiliser`delete-option-group`.
**AWS CLI**
**Pour supprimer un groupe d’options**
L’exemple `delete-option-group` suivant supprime le groupe d’options spécifié.
```
aws rds delete-option-group \
--option-group-name {{myoptiongroup}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Suppression d’un groupe d’options](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.Delete) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [DeleteOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-option-group.html)la section *Référence des AWS CLI commandes*.
### `deregister-db-proxy-targets`
L'exemple de code suivant montre comment utiliser`deregister-db-proxy-targets`.
**AWS CLI**
**Pour annuler l’enregistrement d’une cible de proxy de base de données du groupe cible de bases de données**
L’exemple `deregister-db-proxy-targets` suivant supprime l’association entre le proxy `proxyExample` et sa cible.
```
aws rds deregister-db-proxy-targets \
--db-proxy-name {{proxyExample}} \
--db-instance-identifiers {{database-1}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Suppression d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-deleting) dans le *Guide de l’utilisateur Amazon RDS* et [Suppression d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-deleting) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DeregisterDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/deregister-db-proxy-targets.html)la section *Référence des AWS CLI commandes*.
### `describe-account-attributes`
L'exemple de code suivant montre comment utiliser`describe-account-attributes`.
**AWS CLI**
**Pour décrire les attributs d’un compte**
L'`describe-account-attributes`exemple suivant récupère les attributs du AWS compte courant.
```
aws rds describe-account-attributes
```
Sortie :
```
{
"AccountQuotas": [
{
"Max": 40,
"Used": 4,
"AccountQuotaName": "DBInstances"
},
{
"Max": 40,
"Used": 0,
"AccountQuotaName": "ReservedDBInstances"
},
{
"Max": 100000,
"Used": 40,
"AccountQuotaName": "AllocatedStorage"
},
{
"Max": 25,
"Used": 0,
"AccountQuotaName": "DBSecurityGroups"
},
{
"Max": 20,
"Used": 0,
"AccountQuotaName": "AuthorizationsPerDBSecurityGroup"
},
{
"Max": 50,
"Used": 1,
"AccountQuotaName": "DBParameterGroups"
},
{
"Max": 100,
"Used": 3,
"AccountQuotaName": "ManualSnapshots"
},
{
"Max": 20,
"Used": 0,
"AccountQuotaName": "EventSubscriptions"
},
{
"Max": 50,
"Used": 1,
"AccountQuotaName": "DBSubnetGroups"
},
{
"Max": 20,
"Used": 1,
"AccountQuotaName": "OptionGroups"
},
{
"Max": 20,
"Used": 6,
"AccountQuotaName": "SubnetsPerDBSubnetGroup"
},
{
"Max": 5,
"Used": 0,
"AccountQuotaName": "ReadReplicasPerMaster"
},
{
"Max": 40,
"Used": 1,
"AccountQuotaName": "DBClusters"
},
{
"Max": 50,
"Used": 0,
"AccountQuotaName": "DBClusterParameterGroups"
},
{
"Max": 5,
"Used": 0,
"AccountQuotaName": "DBClusterRoles"
}
]
}
```
+ Pour plus de détails sur l'API, voir [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-account-attributes.html)la section *Référence des AWS CLI commandes*.
### `describe-blue-green-deployments`
L'exemple de code suivant montre comment utiliser`describe-blue-green-deployments`.
**AWS CLI**
**Exemple 1 : pour décrire le blue/green déploiement d'une instance de base de données RDS une fois la création terminée**
L'`describe-blue-green-deployment`exemple suivant permet de récupérer les détails d'un blue/green déploiement une fois sa création terminée.
```
aws rds describe-blue-green-deployments \
--blue-green-deployment-identifier {{bgd-v53303651eexfake}}
```
Sortie :
```
{
"BlueGreenDeployments": [
{
"BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
"BlueGreenDeploymentName": "bgd-cli-test-instance",
"Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-j382ha",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ejv4ao",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-vlpz3t",
"Status": "AVAILABLE"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CONFIGURE_BACKUPS",
"Status": "COMPLETED"
},
{
"Name": "CREATING_TOPOLOGY_OF_SOURCE",
"Status": "COMPLETED"
}
],
"Status": "AVAILABLE",
"CreateTime": "2022-02-25T21:18:51.183000+00:00"
}
]
}
```
Pour plus d'informations, consultez la section [Visualisation d'un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-viewing.html) dans le *guide de l'utilisateur Amazon RDS*.
**Exemple 2 : Pour décrire un blue/green déploiement pour un cluster de base de données Aurora MySQL**
L'`describe-blue-green-deployment`exemple suivant permet de récupérer les détails d'un blue/green déploiement.
```
aws rds describe-blue-green-deployments \
--blue-green-deployment-identifier {{bgd-wi89nwzglccsfake}}
```
Sortie :
```
{
"BlueGreenDeployments": [
{
"BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
"BlueGreenDeploymentName": "my-blue-green-deployment",
"Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg",
"Status": "AVAILABLE"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
"Status": "COMPLETED"
},
{
"Name": "CREATE_CUSTOM_ENDPOINTS",
"Status": "COMPLETED"
}
],
"Status": "AVAILABLE",
"CreateTime": "2022-02-25T21:12:00.288000+00:00"
}
]
}
```
Pour plus d'informations, consultez la section [Visualisation d'un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) dans le *guide de l'utilisateur Amazon Aurora*.
**Exemple 3 : pour décrire un blue/green déploiement pour un cluster Aurora MySQL après le basculement**
L'`describe-blue-green-deployment`exemple suivant permet de récupérer les détails d'un blue/green déploiement une fois que l'environnement écologique a été promu environnement de production.
```
aws rds describe-blue-green-deployments \
--blue-green-deployment-identifier {{bgd-wi89nwzglccsfake}}
```
Sortie :
```
{
"BlueGreenDeployments": [
{
"BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
"BlueGreenDeploymentName": "my-blue-green-deployment",
"Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-old1",
"Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"Status": "SWITCHOVER_COMPLETED"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
"Status": "SWITCHOVER_COMPLETED"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
"Status": "SWITCHOVER_COMPLETED"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
"Status": "SWITCHOVER_COMPLETED"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
"Status": "SWITCHOVER_COMPLETED"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
"Status": "SWITCHOVER_COMPLETED"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
"Status": "COMPLETED"
},
{
"Name": "CREATE_CUSTOM_ENDPOINTS",
"Status": "COMPLETED"
}
],
"Status": "SWITCHOVER_COMPLETED",
"CreateTime": "2022-02-25T22:38:49.522000+00:00"
}
]
}
```
Pour plus d'informations, consultez la section [Visualisation d'un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) dans le *guide de l'utilisateur Amazon Aurora*.
**Exemple 4 : pour décrire un blue/green déploiement combiné**
L'`describe-blue-green-deployment`exemple suivant permet de récupérer les détails d'un blue/green déploiement combiné.
```
aws rds describe-blue-green-deployments
```
Sortie :
```
{
"BlueGreenDeployments": [
{
"BlueGreenDeploymentIdentifier": "bgd-wi89nwzgfakelccs",
"BlueGreenDeploymentName": "my-blue-green-deployment",
"Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg",
"Status": "AVAILABLE"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
"Status": "COMPLETED"
},
{
"Name": "CREATE_CUSTOM_ENDPOINTS",
"Status": "COMPLETED"
}
],
"Status": "AVAILABLE",
"CreateTime": "2022-02-25T21:12:00.288000+00:00"
},
{
"BlueGreenDeploymentIdentifier": "bgd-v5330365fake1eex",
"BlueGreenDeploymentName": "bgd-cli-test-instance",
"Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-old1",
"Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"Status": "SWITCHOVER_COMPLETED"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
"Status": "SWITCHOVER_COMPLETED"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
"Status": "SWITCHOVER_COMPLETED"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-old1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
"Status": "SWITCHOVER_COMPLETED"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CONFIGURE_BACKUPS",
"Status": "COMPLETED"
},
{
"Name": "CREATING_TOPOLOGY_OF_SOURCE",
"Status": "COMPLETED"
}
],
"Status": "SWITCHOVER_COMPLETED",
"CreateTime": "2022-02-25T22:33:22.225000+00:00"
}
]
}
```
Pour plus d'informations, consultez les [sections Affichage d'un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-viewing.html) dans le *guide de l'utilisateur Amazon RDS* et [Affichage d'un blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) dans le *guide de l'utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeBlueGreenDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-blue-green-deployments.html)la section *Référence des AWS CLI commandes*.
### `describe-certificates`
L'exemple de code suivant montre comment utiliser`describe-certificates`.
**AWS CLI**
**Pour décrire les certificats**
L’exemple `describe-certificates` suivant récupère les détails sur le certificat associé à la région par défaut de l’utilisateur.
```
aws rds describe-certificates
```
Sortie :
```
{
"Certificates": [
{
"CertificateIdentifier": "rds-ca-ecc384-g1",
"CertificateType": "CA",
"Thumbprint": "2ee3dcc06e50192559b13929e73484354f23387d",
"ValidFrom": "2021-05-24T22:06:59+00:00",
"ValidTill": "2121-05-24T23:06:59+00:00",
"CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-ecc384-g1",
"CustomerOverride": false
},
{
"CertificateIdentifier": "rds-ca-rsa4096-g1",
"CertificateType": "CA",
"Thumbprint": "19da4f2af579a8ae1f6a0fa77aa5befd874b4cab",
"ValidFrom": "2021-05-24T22:03:20+00:00",
"ValidTill": "2121-05-24T23:03:20+00:00",
"CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-rsa4096-g1",
"CustomerOverride": false
},
{
"CertificateIdentifier": "rds-ca-rsa2048-g1",
"CertificateType": "CA",
"Thumbprint": "7c40cb42714b6fdb2b296f9bbd0e8bb364436a76",
"ValidFrom": "2021-05-24T21:59:00+00:00",
"ValidTill": "2061-05-24T22:59:00+00:00",
"CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-rsa2048-g1",
"CustomerOverride": true,
"CustomerOverrideValidTill": "2061-05-24T22:59:00+00:00"
},
{
"CertificateIdentifier": "rds-ca-2019",
"CertificateType": "CA",
"Thumbprint": "d40ddb29e3750dffa671c3140bbf5f478d1c8096",
"ValidFrom": "2019-08-22T17:08:50+00:00",
"ValidTill": "2024-08-22T17:08:50+00:00",
"CertificateArn": "arn:aws:rds:us-west-2::cert:rds-ca-2019",
"CustomerOverride": false
}
],
"DefaultCertificateForNewLaunches": "rds-ca-rsa2048-g1"
}
```
Pour plus d'informations, consultez les [sections Utilisation SSL/TLS pour chiffrer une connexion à une instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html) de base de données dans le *guide de l'utilisateur Amazon RDS* et [Utilisation SSL/TLS pour chiffrer une connexion à un cluster de bases](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html) de données dans le guide de l'utilisateur *Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-certificates.html)la section *Référence des AWS CLI commandes*.
### `describe-db-cluster-backtracks`
L'exemple de code suivant montre comment utiliser`describe-db-cluster-backtracks`.
**AWS CLI**
**Pour décrire les retours sur trace pour un cluster de bases de données**
L’exemple `describe-db-cluster-backtracks` suivant extrait des détails sur le cluster de bases de données spécifié.
```
aws rds describe-db-cluster-backtracks \
--db-cluster-identifier {{mydbcluster}}
```
Sortie :
```
{
"DBClusterBacktracks": [
{
"DBClusterIdentifier": "mydbcluster",
"BacktrackIdentifier": "2f5f5294-0dd2-44c9-9f50-EXAMPLE",
"BacktrackTo": "2021-02-12T04:59:22Z",
"BacktrackedFrom": "2021-02-12T14:37:31.640Z",
"BacktrackRequestCreationTime": "2021-02-12T14:36:18.819Z",
"Status": "COMPLETED"
},
{
"DBClusterIdentifier": "mydbcluster",
"BacktrackIdentifier": "3c7a6421-af2a-4ea3-ae95-EXAMPLE",
"BacktrackTo": "2021-02-11T22:53:46Z",
"BacktrackedFrom": "2021-02-12T00:09:27.006Z",
"BacktrackRequestCreationTime": "2021-02-12T00:07:53.487Z",
"Status": "COMPLETED"
}
]
}
```
Pour plus d’informations, consultez [Retour sur trace d’un cluster de base de données Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Managing.Backtrack.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbClusterBacktracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-backtracks.html)la section *Référence des AWS CLI commandes*.
### `describe-db-cluster-endpoints`
L'exemple de code suivant montre comment utiliser`describe-db-cluster-endpoints`.
**AWS CLI**
**Exemple 1 : pour décrire les points de terminaison d’un cluster de bases de données**
L’exemple `describe-db-cluster-endpoints` suivant extrait des détails sur les points de terminaison du cluster de bases de données. Les types de clusters Aurora les plus courants possèdent deux points de terminaison. Un point de terminaison est de type `WRITER`. Vous pouvez utiliser ce point de terminaison pour toutes les instructions SQL. L’autre point de terminaison est de type `READER`. Vous ne pouvez utiliser ce point de terminaison que pour SELECT et les autres instructions SQL en lecture seule.
```
aws rds describe-db-cluster-endpoints
```
Sortie :
```
{
"DBClusterEndpoints": [
{
"DBClusterIdentifier": "my-database-1",
"Endpoint": "my-database-1.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"Status": "creating",
"EndpointType": "WRITER"
},
{
"DBClusterIdentifier": "my-database-1",
"Endpoint": "my-database-1.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
"Status": "creating",
"EndpointType": "READER"
},
{
"DBClusterIdentifier": "mydbcluster",
"Endpoint": "mydbcluster.cluster-cnpexamle.us-east-1.rds.amazonaws.com",
"Status": "available",
"EndpointType": "WRITER"
},
{
"DBClusterIdentifier": "mydbcluster",
"Endpoint": "mydbcluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
"Status": "available",
"EndpointType": "READER"
}
]
}
```
**Exemple 2 : pour décrire les points de terminaison d’un cluster de bases de données unique**
L’exemple `describe-db-cluster-endpoints` suivant extrait des détails sur les points de terminaison d’un cluster de base de données unique spécifié. Les clusters Aurora sans serveur ne possèdent qu’un seul point de terminaison de type `WRITER`.
```
aws rds describe-db-cluster-endpoints \
--db-cluster-identifier {{serverless-cluster}}
```
Sortie :
```
{
"DBClusterEndpoints": [
{
"Status": "available",
"Endpoint": "serverless-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"DBClusterIdentifier": "serverless-cluster",
"EndpointType": "WRITER"
}
]
}
```
Pour plus d’informations, consultez [Gestion des connexions Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbClusterEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-endpoints.html)la section *Référence des AWS CLI commandes*.
### `describe-db-cluster-parameter-groups`
L'exemple de code suivant montre comment utiliser`describe-db-cluster-parameter-groups`.
**AWS CLI**
**Pour décrire les groupes de paramètres de cluster de bases de données**
L’exemple `describe-db-cluster-parameter-groups` suivant extrait des détails sur vos groupes de paramètres de cluster de bases de données.
```
aws rds describe-db-cluster-parameter-groups
```
Sortie :
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupName": "default.aurora-mysql5.7",
"DBParameterGroupFamily": "aurora-mysql5.7",
"Description": "Default cluster parameter group for aurora-mysql5.7",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora-mysql5.7"
},
{
"DBClusterParameterGroupName": "default.aurora-postgresql9.6",
"DBParameterGroupFamily": "aurora-postgresql9.6",
"Description": "Default cluster parameter group for aurora-postgresql9.6",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora-postgresql9.6"
},
{
"DBClusterParameterGroupName": "default.aurora5.6",
"DBParameterGroupFamily": "aurora5.6",
"Description": "Default cluster parameter group for aurora5.6",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6"
},
{
"DBClusterParameterGroupName": "mydbclusterpg",
"DBParameterGroupFamily": "aurora-mysql5.7",
"Description": "My DB cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpg"
},
{
"DBClusterParameterGroupName": "mydbclusterpgcopy",
"DBParameterGroupFamily": "aurora-mysql5.7",
"Description": "Copy of mydbclusterpg parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy"
}
]
}
```
Pour plus d’informations, consultez [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-parameter-groups.html)la section *Référence des AWS CLI commandes*.
### `describe-db-cluster-parameters`
L'exemple de code suivant montre comment utiliser`describe-db-cluster-parameters`.
**AWS CLI**
**Exemple 1 : pour décrire les paramètres d’un groupe de paramètres de cluster de bases de données**
L’exemple `describe-db-cluster-parameters` suivant extrait des détails sur les paramètres d’un groupe de paramètres de cluster de bases de données.
```
aws rds describe-db-cluster-parameters \
--db-cluster-parameter-group-name {{mydbclusterpg}}
```
Sortie :
```
{
"Parameters": [
{
"ParameterName": "allow-suspicious-udfs",
"Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": false,
"ApplyMethod": "pending-reboot",
"SupportedEngineModes": [
"provisioned"
]
},
{
"ParameterName": "aurora_lab_mode",
"ParameterValue": "0",
"Description": "Enables new features in the Aurora engine.",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": true,
"ApplyMethod": "pending-reboot",
"SupportedEngineModes": [
"provisioned"
]
},
...some output truncated...
]
}
```
**Exemple 2 : pour répertorier uniquement les noms de paramètres dans un groupe de paramètres de cluster de bases de données**
L’exemple `describe-db-cluster-parameters` suivant récupère uniquement les noms des paramètres d’un groupe de paramètres de cluster de bases de données.
```
aws rds describe-db-cluster-parameters \
--db-cluster-parameter-group-name {{default.aurora-mysql5.7}} \
--query '{{Parameters[].{ParameterName:ParameterName}}}'
```
Sortie :
```
[
{
"ParameterName": "allow-suspicious-udfs"
},
{
"ParameterName": "aurora_binlog_read_buffer_size"
},
{
"ParameterName": "aurora_binlog_replication_max_yield_seconds"
},
{
"ParameterName": "aurora_binlog_use_large_read_buffer"
},
{
"ParameterName": "aurora_lab_mode"
},
...some output truncated...
}
]
```
**Exemple 3 : pour décrire uniquement les paramètres modifiables d’un groupe de paramètres de cluster de bases de données**
L’exemple `describe-db-cluster-parameters` suivant récupère les noms d’uniquement les paramètres que vous pouvez modifier dans un groupe de paramètres de cluster de bases de données.
```
aws rds describe-db-cluster-parameters \
--db-cluster-parameter-group-name {{default.aurora-mysql5.7}} \
--query '{{Parameters[].{ParameterName:ParameterName,IsModifiable:IsModifiable} | [?IsModifiable == `true`]}}'
```
Sortie :
```
[
{
"ParameterName": "aurora_binlog_read_buffer_size",
"IsModifiable": true
},
{
"ParameterName": "aurora_binlog_replication_max_yield_seconds",
"IsModifiable": true
},
{
"ParameterName": "aurora_binlog_use_large_read_buffer",
"IsModifiable": true
},
{
"ParameterName": "aurora_lab_mode",
"IsModifiable": true
},
...some output truncated...
}
]
```
**Exemple 4 : pour décrire uniquement les paramètres booléens modifiables dans un groupe de paramètres de cluster de base de données**
L’exemple `describe-db-cluster-parameters` suivant récupère les noms d’uniquement les paramètres que vous pouvez modifier dans un groupe de paramètres de cluster de bases de données et qui ont un type de données booléen.
```
aws rds describe-db-cluster-parameters \
--db-cluster-parameter-group-name {{default.aurora-mysql5.7}} \
--query '{{Parameters[].{ParameterName:ParameterName,DataType:DataType,IsModifiable:IsModifiable} | [?DataType == `boolean`] | [?IsModifiable == `true`]}}'
```
Sortie :
```
[
{
"DataType": "boolean",
"ParameterName": "aurora_binlog_use_large_read_buffer",
"IsModifiable": true
},
{
"DataType": "boolean",
"ParameterName": "aurora_lab_mode",
"IsModifiable": true
},
{
"DataType": "boolean",
"ParameterName": "autocommit",
"IsModifiable": true
},
{
"DataType": "boolean",
"ParameterName": "automatic_sp_privileges",
"IsModifiable": true
},
...some output truncated...
}
]
```
Pour plus d’informations, consultez [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-parameters.html)la section *Référence des AWS CLI commandes*.
### `describe-db-cluster-snapshot-attributes`
L'exemple de code suivant montre comment utiliser`describe-db-cluster-snapshot-attributes`.
**AWS CLI**
**Pour décrire les noms et les valeurs des attributs d’un instantané de cluster de bases de données**
L’exemple `describe-db-cluster-snapshot-attributes` suivant extrait des détails des noms et des valeurs des attributs pour l’instantané de cluster de bases de données spécifié.
```
aws rds describe-db-cluster-snapshot-attributes \
--db-cluster-snapshot-identifier {{myclustersnapshot}}
```
Sortie :
```
{
"DBClusterSnapshotAttributesResult": {
"DBClusterSnapshotIdentifier": "myclustersnapshot",
"DBClusterSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123456789012"
]
}
]
}
}
```
Pour plus d’informations, consultez [Partage d’un instantané de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_ShareSnapshot.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbClusterSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-snapshot-attributes.html)la section *Référence des AWS CLI commandes*.
### `describe-db-cluster-snapshots`
L'exemple de code suivant montre comment utiliser`describe-db-cluster-snapshots`.
**AWS CLI**
**Pour décrire un instantané d’un cluster de bases de données**
L’exemple `describe-db-cluster-snapshots` suivant extrait des détails sur les instantanés du cluster de bases de données spécifié.
```
aws rds describe-db-cluster-snapshots \
--db-cluster-identifier {{mydbcluster}}
```
Sortie :
```
{
"DBClusterSnapshots": [
{
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1e"
],
"DBClusterSnapshotIdentifier": "myclustersnapshotcopy",
"DBClusterIdentifier": "mydbcluster",
"SnapshotCreateTime": "2019-06-04T09:16:42.649Z",
"Engine": "aurora-mysql",
"AllocatedStorage": 0,
"Status": "available",
"Port": 0,
"VpcId": "vpc-6594f31c",
"ClusterCreateTime": "2019-04-15T14:18:42.785Z",
"MasterUsername": "myadmin",
"EngineVersion": "5.7.mysql_aurora.2.04.2",
"LicenseModel": "aurora-mysql",
"SnapshotType": "manual",
"PercentProgress": 100,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:814387698303:cluster-snapshot:myclustersnapshotcopy",
"IAMDatabaseAuthenticationEnabled": false
},
{
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1e"
],
"DBClusterSnapshotIdentifier": "rds:mydbcluster-2019-06-20-09-16",
"DBClusterIdentifier": "mydbcluster",
"SnapshotCreateTime": "2019-06-20T09:16:26.569Z",
"Engine": "aurora-mysql",
"AllocatedStorage": 0,
"Status": "available",
"Port": 0,
"VpcId": "vpc-6594f31c",
"ClusterCreateTime": "2019-04-15T14:18:42.785Z",
"MasterUsername": "myadmin",
"EngineVersion": "5.7.mysql_aurora.2.04.2",
"LicenseModel": "aurora-mysql",
"SnapshotType": "automated",
"PercentProgress": 100,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:814387698303:key/AKIAIOSFODNN7EXAMPLE",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:mydbcluster-2019-06-20-09-16",
"IAMDatabaseAuthenticationEnabled": false
}
]
}
```
Pour plus d’informations, consultez [Création d’un instantané de cluster DB](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CreateSnapshotCluster.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-snapshots.html)la section *Référence des AWS CLI commandes*.
### `describe-db-clusters`
L'exemple de code suivant montre comment utiliser`describe-db-clusters`.
**AWS CLI**
**Exemple 1 : pour décrire un cluster de bases de données**
L’exemple `describe-db-clusters` suivant extrait des détails sur le cluster de bases de données.
```
aws rds describe-db-clusters \
--db-cluster-identifier {{mydbcluster}}
```
Sortie :
```
{
"DBClusters": [
{
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1e"
],
"BackupRetentionPeriod": 1,
"DatabaseName": "mydbcluster",
"DBClusterIdentifier": "mydbcluster",
"DBClusterParameterGroup": "default.aurora-mysql5.7",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2019-06-19T09:16:28.210Z",
"Endpoint": "mydbcluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"ReaderEndpoint": "mydbcluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
"MultiAZ": true,
"Engine": "aurora-mysql",
"EngineVersion": "5.7.mysql_aurora.2.04.2",
"LatestRestorableTime": "2019-06-20T22:38:14.908Z",
"Port": 3306,
"MasterUsername": "myadmin",
"PreferredBackupWindow": "09:09-09:39",
"PreferredMaintenanceWindow": "sat:04:09-sat:04:39",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "dbinstance3",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "dbinstance1",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "dbinstance2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "mydbcluster",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "mydbcluster-us-east-1b",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "mydbcluster",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-0b9130572daf3dc16",
"Status": "active"
}
],
"HostedZoneId": "Z2R2ITUGPM61AM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:814387698303:key/AKIAIOSFODNN7EXAMPLE",
"DbClusterResourceId": "cluster-AKIAIOSFODNN7EXAMPLE",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2019-04-15T14:18:42.785Z",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false
}
]
}
```
**Exemple 2 : pour répertorier certains attributs de tous les clusters de bases de données**
L'`describe-db-clusters`exemple suivant récupère uniquement les `ReaderEndpoint` attributs`DBClusterIdentifier`,`Endpoint`, et de tous vos clusters de base de données dans la AWS région actuelle.
```
aws rds describe-db-clusters \
--query '{{DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,Endpoint:Endpoint,ReaderEndpoint:ReaderEndpoint}}}'
```
Sortie :
```
[
{
"Endpoint": "cluster-57-2020-05-01-2270.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"ReaderEndpoint": "cluster-57-2020-05-01-2270.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
"DBClusterIdentifier": "cluster-57-2020-05-01-2270"
},
{
"Endpoint": "cluster-57-2020-05-01-4615.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"ReaderEndpoint": "cluster-57-2020-05-01-4615.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
"DBClusterIdentifier": "cluster-57-2020-05-01-4615"
},
{
"Endpoint": "pg2-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"ReaderEndpoint": "pg2-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
"DBClusterIdentifier": "pg2-cluster"
},
...output omitted...
}
]
```
**Exemple 3 : pour répertorier des clusters de bases de données avec un attribut spécifique**
L’exemple `describe-db-clusters` suivant récupère uniquement les attributs `DBClusterIdentifier` et `Engine` de tous les clusters de bases de données qui utilisent le moteur de base de données `aurora-postgresql`.
```
aws rds describe-db-clusters \
--query '{{DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,Engine:Engine} | [?Engine == `aurora-postgresql`]}}'
```
Sortie :
```
[
{
"Engine": "aurora-postgresql",
"DBClusterIdentifier": "pg2-cluster"
}
]
```
Pour plus d’informations, consultez [Clusters de bases de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-clusters.html)la section *Référence des AWS CLI commandes*.
### `describe-db-engine-versions`
L'exemple de code suivant montre comment utiliser`describe-db-engine-versions`.
**AWS CLI**
**Pour décrire les versions du moteur de base de données MySQL**
L’exemple `describe-db-engine-versions` suivant affiche des détails sur chacune des versions du moteur de base de données pour le moteur de base de données spécifié.
```
aws rds describe-db-engine-versions \
--engine {{mysql}}
```
Sortie :
```
{
"DBEngineVersions": [
{
"Engine": "mysql",
"EngineVersion": "5.5.46",
"DBParameterGroupFamily": "mysql5.5",
"DBEngineDescription": "MySQL Community Edition",
"DBEngineVersionDescription": "MySQL 5.5.46",
"ValidUpgradeTarget": [
{
"Engine": "mysql",
"EngineVersion": "5.5.53",
"Description": "MySQL 5.5.53",
"AutoUpgrade": false,
"IsMajorVersionUpgrade": false
},
{
"Engine": "mysql",
"EngineVersion": "5.5.54",
"Description": "MySQL 5.5.54",
"AutoUpgrade": false,
"IsMajorVersionUpgrade": false
},
{
"Engine": "mysql",
"EngineVersion": "5.5.57",
"Description": "MySQL 5.5.57",
"AutoUpgrade": false,
"IsMajorVersionUpgrade": false
},
...some output truncated...
]
}
```
Pour plus d’informations, consultez [Qu’est-ce qu’Amazon Relational Database Service (Amazon RDS) ?](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Décrire DBEngine les versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-engine-versions.html) dans *AWS CLI la référence des commandes*.
### `describe-db-instance-automated-backups`
L'exemple de code suivant montre comment utiliser`describe-db-instance-automated-backups`.
**AWS CLI**
**Pour décrire les sauvegardes automatiques d’une instance de base de données**
L’exemple `describe-db-instance-automated-backups` suivant affiche les détails sur les sauvegardes automatiques pour l’instance de base de données spécifiée. Les détails incluent les sauvegardes automatisées répliquées dans d'autres AWS régions.
```
aws rds describe-db-instance-automated-backups \
--db-instance-identifier {{new-orcl-db}}
```
Sortie :
```
{
"DBInstanceAutomatedBackups": [
{
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
"DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
"Region": "us-east-1",
"DBInstanceIdentifier": "new-orcl-db",
"RestoreWindow": {
"EarliestTime": "2020-12-07T21:05:20.939Z",
"LatestTime": "2020-12-07T21:05:20.939Z"
},
"AllocatedStorage": 20,
"Status": "replicating",
"Port": 1521,
"InstanceCreateTime": "2020-12-04T15:28:31Z",
"MasterUsername": "admin",
"Engine": "oracle-se2",
"EngineVersion": "12.1.0.2.v21",
"LicenseModel": "bring-your-own-license",
"OptionGroupName": "default:oracle-se2-12-1",
"Encrypted": false,
"StorageType": "gp2",
"IAMDatabaseAuthenticationEnabled": false,
"BackupRetentionPeriod": 14,
"DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
}
]
}
```
Pour plus d’informations, consultez [Recherche d’informations sur les sauvegardes répliquées](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Describe) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [DescribeDbInstanceAutomatedBackups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-instance-automated-backups.html)la section *Référence des AWS CLI commandes*.
### `describe-db-instances`
L'exemple de code suivant montre comment utiliser`describe-db-instances`.
**AWS CLI**
**Pour décrire une instance de base de données**
L’exemple `describe-db-instances` suivant extrait des détails sur l’instance de base de données spécifiée.
```
aws rds describe-db-instances \
--db-instance-identifier {{mydbinstancecf}}
```
Sortie :
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "mydbinstancecf",
"DBInstanceClass": "db.t3.small",
"Engine": "mysql",
"DBInstanceStatus": "available",
"MasterUsername": "masterawsuser",
"Endpoint": {
"Address": "mydbinstancecf.abcexample.us-east-1.rds.amazonaws.com",
"Port": 3306,
"HostedZoneId": "Z2R2ITUGPM61AM"
},
...some output truncated...
}
]
}
```
+ Pour plus de détails sur l'API, voir [Description DBInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-instances.html) dans le manuel de *référence des AWS CLI commandes*.
### `describe-db-log-files`
L'exemple de code suivant montre comment utiliser`describe-db-log-files`.
**AWS CLI**
**Pour décrire les fichiers journaux d’une instance de base de données**
L’exemple `describe-db-log-files` suivant extrait des détails sur les fichiers journaux pour l’instance de base de données spécifiée.
```
aws rds describe{{-}}db-log-files -\
{{-db-instance-identifier}} {{test-instance}}
```
Sortie :
```
{
"DescribeDBLogFiles": [
{
"Size": 0,
"LastWritten": 1533060000000,
"LogFileName": "error/mysql-error-running.log"
},
{
"Size": 2683,
"LastWritten": 1532994300000,
"LogFileName": "error/mysql-error-running.log.0"
},
{
"Size": 107,
"LastWritten": 1533057300000,
"LogFileName": "error/mysql-error-running.log.18"
},
{
"Size": 13105,
"LastWritten": 1532991000000,
"LogFileName": "error/mysql-error-running.log.23"
},
{
"Size": 0,
"LastWritten": 1533061200000,
"LogFileName": "error/mysql-error.log"
},
{
"Size": 3519,
"LastWritten": 1532989252000,
"LogFileName": "mysqlUpgrade"
}
]
}
```
+ Pour plus de détails sur l'API, voir [DescribeDbLogFiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-log-files.html)la section *Référence des AWS CLI commandes*.
### `describe-db-parameter-groups`
L'exemple de code suivant montre comment utiliser`describe-db-parameter-groups`.
**AWS CLI**
**Pour décrire votre groupe de paramètres de bases de données**
L’exemple `describe-db-parameter-groups` suivant extrait des détails sur vos groupes de paramètres de base de données.
```
aws rds describe-db-parameter-groups
```
Sortie :
```
{
"DBParameterGroups": [
{
"DBParameterGroupName": "default.aurora-mysql5.7",
"DBParameterGroupFamily": "aurora-mysql5.7",
"Description": "Default parameter group for aurora-mysql5.7",
"DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora-mysql5.7"
},
{
"DBParameterGroupName": "default.aurora-postgresql9.6",
"DBParameterGroupFamily": "aurora-postgresql9.6",
"Description": "Default parameter group for aurora-postgresql9.6",
"DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora-postgresql9.6"
},
{
"DBParameterGroupName": "default.aurora5.6",
"DBParameterGroupFamily": "aurora5.6",
"Description": "Default parameter group for aurora5.6",
"DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.aurora5.6"
},
{
"DBParameterGroupName": "default.mariadb10.1",
"DBParameterGroupFamily": "mariadb10.1",
"Description": "Default parameter group for mariadb10.1",
"DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:default.mariadb10.1"
},
...some output truncated...
]
}
```
Pour de plus amples informations, veuillez consulter [ Utilisation des groupes de paramètres de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, consultez la section [Décrire DBParameter les groupes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-parameter-groups.html) dans *AWS CLI la référence des commandes*.
### `describe-db-parameters`
L'exemple de code suivant montre comment utiliser`describe-db-parameters`.
**AWS CLI**
**Pour décrire les paramètres d’un groupe de paramètres de bases de données**
L’exemple `describe-db-parameters` suivant extrait des détails sur le groupe de paramètres de base de données spécifié.
```
aws rds describe-db-parameters \
--db-parameter-group-name {{mydbpg}}
```
Sortie :
```
{
"Parameters": [
{
"ParameterName": "allow-suspicious-udfs",
"Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": false,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "auto_generate_certs",
"Description": "Controls whether the server autogenerates SSL key and certificate files in the data directory, if they do not already exist.",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": false,
"ApplyMethod": "pending-reboot"
},
...some output truncated...
]
}
```
Pour de plus amples informations, veuillez consulter [ Utilisation des groupes de paramètres de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Description DBParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-parameters.html) dans le manuel de *référence des AWS CLI commandes*.
### `describe-db-proxies`
L'exemple de code suivant montre comment utiliser`describe-db-proxies`.
**AWS CLI**
**Pour décrire un proxy de base de données pour une base de données RDS**
L’exemple `describe-db-proxies` suivant renvoie les informations sur les proxy de base de données.
```
aws rds describe-db-proxies
```
Sortie :
```
{
"DBProxies": [
{
"DBProxyName": "proxyExample1",
"DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab",
"Status": "available",
"EngineFamily": "PostgreSQL",
"VpcId": "vpc-1234567",
"VpcSecurityGroupIds": [
"sg-1234"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Auth": "[
{
"Description": "proxydescription1"
"AuthScheme": "SECRETS",
"SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f",
"IAMAuth": "DISABLED"
}
]",
"RoleArn": "arn:aws:iam::12345678912??:role/ProxyPostgreSQLRole",
"Endpoint": "proxyExample1.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"RequireTLS": false,
"IdleClientTimeout": 1800,
"DebuggingLogging": false,
"CreatedDate": "2023-04-05T16:09:33.452000+00:00",
"UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
},
{
"DBProxyName": "proxyExample2",
"DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-1234a12b23456c1ab",
"Status": "available",
"EngineFamily": "PostgreSQL",
"VpcId": "sg-1234567",
"VpcSecurityGroupIds": [
"sg-1234"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Auth": "[
{
"Description": "proxydescription2"
"AuthScheme": "SECRETS",
"SecretArn": "aarn:aws:secretsmanager:us-west-2:123456789123:secret:secretName-1234f",
"IAMAuth": "DISABLED"
}
]",
"RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole",
"Endpoint": "proxyExample2.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"RequireTLS": false,
"IdleClientTimeout": 1800,
"DebuggingLogging": false,
"CreatedDate": "2022-01-05T16:19:33.452000+00:00",
"UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
}
]
}
```
Pour plus d’informations, consultez [Affichage d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) dans le *Guide de l’utilisateur Amazon RDS* et [Affichage d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbProxies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxies.html)la section *Référence des AWS CLI commandes*.
### `describe-db-proxy-endpoints`
L'exemple de code suivant montre comment utiliser`describe-db-proxy-endpoints`.
**AWS CLI**
**Pour décrire les points de terminaison d’un proxy de base de données**
L’exemple `describe-db-proxy-endpoints` suivant renvoie les informations sur les points de terminaison de proxy de base de données.
```
aws rds describe-db-proxy-endpoints
```
Sortie :
```
{
"DBProxyEndpoints": [
{
"DBProxyEndpointName": "proxyEndpoint1",
"DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab",
"DBProxyName": "proxyExample",
"Status": "available",
"VpcId": "vpc-1234567",
"VpcSecurityGroupIds": [
"sg-1234"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Endpoint": "proxyEndpoint1.endpoint.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"CreatedDate": "2023-04-05T16:09:33.452000+00:00",
"TargetRole": "READ_WRITE",
"IsDefault": false
},
{
"DBProxyEndpointName": "proxyEndpoint2",
"DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-4567a01b12345c0ab",
"DBProxyName": "proxyExample2",
"Status": "available",
"VpcId": "vpc1234567",
"VpcSecurityGroupIds": [
"sg-5678"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Endpoint": "proxyEndpoint2.endpoint.proxy-cd1ef2klmnop.us-east-1.rds.amazonaws.com",
"CreatedDate": "2023-04-05T16:09:33.452000+00:00",
"TargetRole": "READ_WRITE",
"IsDefault": false
}
]
}
```
Pour plus d’informations, consultez [Affichage d’un point de terminaison de proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DescribingEndpoint) dans le *Guide de l’utilisateur Amazon RDS* et [Affichage d’un point de terminaison de proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DescribingEndpoint) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbProxyEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-endpoints.html)la section *Référence des AWS CLI commandes*.
### `describe-db-proxy-target-groups`
L'exemple de code suivant montre comment utiliser`describe-db-proxy-target-groups`.
**AWS CLI**
**Pour décrire les points de terminaison d’un proxy de base de données**
L’exemple `describe-db-proxy-target-groups` suivant renvoie les informations sur les groupes de cibles de proxy de base de données.
```
aws rds describe-db-proxy-target-groups \
--db-proxy-name {{proxyExample}}
```
Sortie :
```
{
"TargetGroups":
{
"DBProxyName": "proxyExample",
"TargetGroupName": "default",
"TargetGroupArn": "arn:aws:rds:us-east-1:123456789012:target-group:prx-tg-0123a01b12345c0ab",
"IsDefault": true,
"Status": "available",
"ConnectionPoolConfig": {
"MaxConnectionsPercent": 100,
"MaxIdleConnectionsPercent": 50,
"ConnectionBorrowTimeout": 120,
"SessionPinningFilters": []
},
"CreatedDate": "2023-05-02T18:41:19.495000+00:00",
"UpdatedDate": "2023-05-02T18:41:21.762000+00:00"
}
}
```
Pour plus d’informations, consultez [Affichage d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) dans le *Guide de l’utilisateur Amazon RDS* et [Affichage d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbProxyTargetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-target-groups.html)la section *Référence des AWS CLI commandes*.
### `describe-db-proxy-targets`
L'exemple de code suivant montre comment utiliser`describe-db-proxy-targets`.
**AWS CLI**
**Pour décrire les cibles de proxy de base de données**
L’exemple `describe-db-proxy-targets` suivant renvoie les informations sur les cibles de proxy de base de données.
```
aws rds describe-db-proxy-targets \
--db-proxy-name {{proxyExample}}
```
Sortie :
```
{
"Targets": [
{
"Endpoint": "database1.ab0cd1efghij.us-east-1.rds.amazonaws.com",
"TrackedClusterId": "database1",
"RdsResourceId": "database1-instance-1",
"Port": 3306,
"Type": "RDS_INSTANCE",
"Role": "READ_WRITE",
"TargetHealth": {
"State": "UNAVAILABLE",
"Reason": "PENDING_PROXY_CAPACITY",
"Description": "DBProxy Target is waiting for proxy to scale to desired capacity"
}
}
]
}
```
Pour plus d’informations, consultez [Affichage d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) dans le *Guide de l’utilisateur Amazon RDS* et [Affichage d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-targets.html)la section *Référence des AWS CLI commandes*.
### `describe-db-recommendations`
L'exemple de code suivant montre comment utiliser`describe-db-recommendations`.
**AWS CLI**
**Exemple 1 : pour répertorier toutes les recommandations de base de données**
L'`describe-db-recommendations`exemple suivant répertorie toutes les recommandations de base de données de votre AWS compte.
```
aws rds describe-db-recommendations
```
Sortie :
```
{
"DBRecommendations": [
{
"RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
"TypeId": "config_recommendation::old_minor_version",
"Severity": "informational",
"ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
"Status": "active",
"CreatedTime": "2024-02-21T23:14:19.292000+00:00",
"UpdatedTime": "2024-02-21T23:14:19+00:00",
"Detection": "**[resource-name]** is not running the latest minor DB engine version",
"Recommendation": "Upgrade to latest engine version",
"Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
"RecommendedActions": [
{
"ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
"Operation": "modifyDbInstance",
"Parameters": [
{
"Key": "EngineVersion",
"Value": "5.7.44"
},
{
"Key": "DBInstanceIdentifier",
"Value": "database-1"
}
],
"ApplyModes": [
"immediately",
"next-maintenance-window"
],
"Status": "ready",
"ContextAttributes": [
{
"Key": "Recommended value",
"Value": "5.7.44"
},
{
"Key": "Current engine version",
"Value": "5.7.42"
}
]
}
],
"Category": "security",
"Source": "RDS",
"TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
"TypeRecommendation": "Upgrade to latest engine version",
"Impact": "Reduced database performance and data security at risk",
"AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
"Links": [
{
"Text": "Upgrading an RDS DB instance engine version",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
},
{
"Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
},
{
"Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
}
]
}
]
}
```
Pour plus d’informations, consultez [Affichage de recommandations Amazon RDS et leur réponse](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) dans le *Guide de l’utilisateur Amazon RDS* et [Affichage de recommandations Amazon RDS et leur réponse](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 2 : pour répertorier toutes les recommandations de base de données de gravité élevée**
L'`describe-db-recommendations`exemple suivant répertorie les recommandations de base de données les plus sévères pour votre AWS compte.
```
aws rds describe-db-recommendations \
--filters {{Name=severity,Values=high}}
```
Sortie :
```
{
"DBRecommendations": [
{
"RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
"TypeId": "config_recommendation::rds_extended_support",
"Severity": "high",
"ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
"Status": "active",
"CreatedTime": "2024-02-21T23:14:19.392000+00:00",
"UpdatedTime": "2024-02-21T23:14:19+00:00",
"Detection": "Your databases will be auto-enrolled to RDS Extended Support on February 29",
"Recommendation": "Upgrade your major version before February 29, 2024 to avoid additional charges",
"Description": "Your PostgreSQL 11 and MySQL 5.7 databases will be automatically enrolled into RDS Extended Support on February 29, 2024. To avoid the increase in charges due to RDS Extended Support, we recommend upgrading your databases to a newer major engine version before February 29, 2024.\nTo learn more about the RDS Extended Support pricing, refer to the pricing page.",
"RecommendedActions": [
{
"ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
"Parameters": [],
"ApplyModes": [
"manual"
],
"Status": "ready",
"ContextAttributes": []
}
],
"Category": "cost optimization",
"Source": "RDS",
"TypeDetection": "Your database will be auto-enrolled to RDS Extended Support on February 29",
"TypeRecommendation": "Upgrade your major version before February 29, 2024 to avoid additional charges",
"Impact": "Increase in charges due to RDS Extended Support",
"AdditionalInfo": "With Amazon RDS Extended Support, you can continue running your database on a major engine version past the RDS end of standard support date for an additional cost. This paid feature gives you more time to upgrade to a supported major engine version.\nDuring Extended Support, Amazon RDS will supply critical CVE patches and bug fixes.",
"Links": [
{
"Text": "Amazon RDS Extended Support pricing for RDS for MySQL",
"Url": "https://aws.amazon.com/rds/mysql/pricing/"
},
{
"Text": "Amazon RDS Extended Support for RDS for MySQL and PostgreSQL databases",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html"
},
{
"Text": "Amazon RDS Extended Support pricing for Amazon Aurora PostgreSQL",
"Url": "https://aws.amazon.com/rds/aurora/pricing/"
},
{
"Text": "Amazon RDS Extended Support for Aurora PostgreSQL databases",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/extended-support.html"
},
{
"Text": "Amazon RDS Extended Support pricing for RDS for PostgreSQL",
"Url": "https://aws.amazon.com/rds/postgresql/pricing/"
}
]
}
]
}
```
Pour plus d’informations, consultez [Affichage de recommandations Amazon RDS et leur réponse](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) dans le *Guide de l’utilisateur Amazon RDS* et [Affichage de recommandations Amazon RDS et leur réponse](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 3 : pour répertorier des recommandations de base de données pour une instance de base de données spécifiée**
L’exemple `describe-db-recommendations` suivant répertorie toutes les recommandations de base de données pour une instance de base de données spécifiée.
```
aws rds describe-db-recommendations \
--filters {{Name=dbi-resource-id,Values=database-1}}
```
Sortie :
```
{
"DBRecommendations": [
{
"RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
"TypeId": "config_recommendation::old_minor_version",
"Severity": "informational",
"ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
"Status": "active",
"CreatedTime": "2024-02-21T23:14:19.292000+00:00",
"UpdatedTime": "2024-02-21T23:14:19+00:00",
"Detection": "**[resource-name]** is not running the latest minor DB engine version",
"Recommendation": "Upgrade to latest engine version",
"Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
"RecommendedActions": [
{
"ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
"Operation": "modifyDbInstance",
"Parameters": [
{
"Key": "EngineVersion",
"Value": "5.7.44"
},
{
"Key": "DBInstanceIdentifier",
"Value": "database-1"
}
],
"ApplyModes": [
"immediately",
"next-maintenance-window"
],
"Status": "ready",
"ContextAttributes": [
{
"Key": "Recommended value",
"Value": "5.7.44"
},
{
"Key": "Current engine version",
"Value": "5.7.42"
}
]
}
],
"Category": "security",
"Source": "RDS",
"TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
"TypeRecommendation": "Upgrade to latest engine version",
"Impact": "Reduced database performance and data security at risk",
"AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
"Links": [
{
"Text": "Upgrading an RDS DB instance engine version",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
},
{
"Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
},
{
"Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
}
]
}
]
}
```
Pour plus d’informations, consultez [Affichage de recommandations Amazon RDS et leur réponse](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) dans le *Guide de l’utilisateur Amazon RDS* et [Affichage de recommandations Amazon RDS et leur réponse](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 4 : pour répertorier toutes les recommandations de base de données actives**
L'`describe-db-recommendations`exemple suivant répertorie toutes les recommandations de base de données actives dans votre AWS compte.
```
aws rds describe-db-recommendations \
--filters {{Name=status,Values=active}}
```
Sortie :
```
{
"DBRecommendations": [
{
"RecommendationId": "12ab3cde-f456-7g8h-9012-i3j45678k9lm",
"TypeId": "config_recommendation::old_minor_version",
"Severity": "informational",
"ResourceArn": "arn:aws:rds:us-west-2:111122223333:db:database-1",
"Status": "active",
"CreatedTime": "2024-02-21T23:14:19.292000+00:00",
"UpdatedTime": "2024-02-21T23:14:19+00:00",
"Detection": "**[resource-name]** is not running the latest minor DB engine version",
"Recommendation": "Upgrade to latest engine version",
"Description": "Your database resources aren't running the latest minor DB engine version. The latest minor version contains the latest security fixes and other improvements.",
"RecommendedActions": [
{
"ActionId": "12ab34c5de6fg7h89i0jk1lm234n5678",
"Operation": "modifyDbInstance",
"Parameters": [
{
"Key": "EngineVersion",
"Value": "5.7.44"
},
{
"Key": "DBInstanceIdentifier",
"Value": "database-1"
}
],
"ApplyModes": [
"immediately",
"next-maintenance-window"
],
"Status": "ready",
"ContextAttributes": [
{
"Key": "Recommended value",
"Value": "5.7.44"
},
{
"Key": "Current engine version",
"Value": "5.7.42"
}
]
}
],
"Category": "security",
"Source": "RDS",
"TypeDetection": "**[resource-count] resources** are not running the latest minor DB engine version",
"TypeRecommendation": "Upgrade to latest engine version",
"Impact": "Reduced database performance and data security at risk",
"AdditionalInfo": "We recommend that you maintain your database with the latest DB engine minor version as this version includes the latest security and functionality fixes. The DB engine minor version upgrades contain only the changes which are backward-compatible with earlier minor versions of the same major version of the DB engine.",
"Links": [
{
"Text": "Upgrading an RDS DB instance engine version",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html"
},
{
"Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon Aurora",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html"
},
{
"Text": "Using Amazon RDS Blue/Green Deployments for database updates for Amazon RDS",
"Url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html"
}
]
}
]
}
```
Pour plus d’informations, consultez [Affichage de recommandations Amazon RDS et leur réponse](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) dans le *Guide de l’utilisateur Amazon RDS* et [Affichage de recommandations Amazon RDS et leur réponse](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbRecommendations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-recommendations.html)la section *Référence des AWS CLI commandes*.
### `describe-db-security-groups`
L'exemple de code suivant montre comment utiliser`describe-db-security-groups`.
**AWS CLI**
**Pour répertorier des groupes de sécurité de base de données**
L’exemple `describe-db-security-groups` suivant répertorie des groupes de sécurité de base de données.
```
aws rds describe-db-security-groups
```
Sortie :
```
{
"DBSecurityGroups": [
{
"OwnerId": "123456789012",
"DBSecurityGroupName": "default",
"DBSecurityGroupDescription": "default",
"EC2SecurityGroups": [],
"IPRanges": [],
"DBSecurityGroupArn": "arn:aws:rds:us-west-1:111122223333:secgrp:default"
},
{
"OwnerId": "123456789012",
"DBSecurityGroupName": "mysecgroup",
"DBSecurityGroupDescription": "My Test Security Group",
"VpcId": "vpc-1234567f",
"EC2SecurityGroups": [],
"IPRanges": [],
"DBSecurityGroupArn": "arn:aws:rds:us-west-1:111122223333:secgrp:mysecgroup"
}
]
}
```
Pour plus d’informations, consultez [Liste des groupes de sécurité DB disponibles](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html#USER_WorkingWithSecurityGroups.Listing) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [DescribeDbSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-security-groups.html)la section *Référence des AWS CLI commandes*.
### `describe-db-shard-groups`
L'exemple de code suivant montre comment utiliser`describe-db-shard-groups`.
**AWS CLI**
**Exemple 1 : pour décrire les groupes de partitions de base de données**
L’exemple `describe-db-shard-groups` suivant récupère les détails sur vos groupes de partitions de base de données.
```
aws rds describe-db-shard-groups
```
Sortie :
```
{
"DBShardGroups": [
{
"DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
"DBShardGroupIdentifier": "limitless-test-shard-grp",
"DBClusterIdentifier": "limitless-test-cluster",
"MaxACU": 768.0,
"ComputeRedundancy": 0,
"Status": "available",
"PubliclyAccessible": true,
"Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
},
{
"DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
"DBShardGroupIdentifier": "my-db-shard-group",
"DBClusterIdentifier": "my-sv2-cluster",
"MaxACU": 768.0,
"ComputeRedundancy": 0,
"Status": "available",
"PubliclyAccessible": false,
"Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}
]
}
```
Pour plus d’informations, consultez [Clusters de bases de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, voir [DescribeDbShardGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-shard-groups.html)la section *Référence des AWS CLI commandes*.
### `describe-db-snapshot-attributes`
L'exemple de code suivant montre comment utiliser`describe-db-snapshot-attributes`.
**AWS CLI**
**Pour décrire les noms et les valeurs des attributs d’un instantané de base de données**
L’exemple `describe-db-snapshot-attributes` suivant décrit des noms et les valeurs d’attributs pour un instantané de base de données.
```
aws rds describe-db-snapshot-attributes \
--db-snapshot-identifier {{mydbsnapshot}}
```
Sortie :
```
{
"DBSnapshotAttributesResult": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123456789012",
"210987654321"
]
}
]
}
}
```
Pour plus d’informations, consultez [Partage d’un instantané de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [DescribeDbSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-snapshot-attributes.html)la section *Référence des AWS CLI commandes*.
### `describe-db-snapshots`
L'exemple de code suivant montre comment utiliser`describe-db-snapshots`.
**AWS CLI**
**Exemple 1 : pour décrire un instantané de base de données pour une instance de base de données**
L’exemple `describe-db-snapshots` suivant récupère les détails sur instantané de base de données pour une instance de base de données.
```
aws rds describe-db-snapshots \
--db-snapshot-identifier {{mydbsnapshot}}
```
Sortie :
```
{
"DBSnapshots": [
{
"DBSnapshotIdentifier": "mydbsnapshot",
"DBInstanceIdentifier": "mysqldb",
"SnapshotCreateTime": "2018-02-08T22:28:08.598Z",
"Engine": "mysql",
"AllocatedStorage": 20,
"Status": "available",
"Port": 3306,
"AvailabilityZone": "us-east-1f",
"VpcId": "vpc-6594f31c",
"InstanceCreateTime": "2018-02-08T22:24:55.973Z",
"MasterUsername": "mysqladmin",
"EngineVersion": "5.6.37",
"LicenseModel": "general-public-license",
"SnapshotType": "manual",
"OptionGroupName": "default:mysql-5-6",
"PercentProgress": 100,
"StorageType": "gp2",
"Encrypted": false,
"DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot",
"IAMDatabaseAuthenticationEnabled": false,
"ProcessorFeatures": [],
"DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE"
}
]
}
```
Pour plus d’informations, consultez [Création d’un instantané de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) dans le *Guide de l’utilisateur Amazon RDS*.
**Exemple 2 : pour trouver le nombre d’instantanés manuels pris**
L'`describe-db-snapshots`exemple suivant utilise l'`length`opérateur dans l'`--query`option pour renvoyer le nombre de clichés manuels qui ont été pris dans une AWS région donnée.
```
aws rds describe-db-snapshots \
--snapshot-type {{manual}} \
--query {{"length(*[].{DBSnapshots:SnapshotType})"}} \
--region {{eu-central-1}}
```
Sortie :
```
35
```
Pour plus d’informations, consultez [Création d’un instantané de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Description DBSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-snapshots.html) dans le manuel de *référence des AWS CLI commandes*.
### `describe-db-subnet-groups`
L'exemple de code suivant montre comment utiliser`describe-db-subnet-groups`.
**AWS CLI**
**Pour décrire un groupe de sous-réseaux de base de données**
L’exemple `describe-db-subnet-groups` extrait les détails sur le groupe de sous-réseaux de base de données spécifié.
```
aws rds describe-db-subnet-groups
```
Sortie :
```
{
"DBSubnetGroups": [
{
"DBSubnetGroupName": "mydbsubnetgroup",
"DBSubnetGroupDescription": "My DB Subnet Group",
"VpcId": "vpc-971c12ee",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-d8c8e7f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-718fdc7d",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-cbc8e7e7",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-0ccde220",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
}
],
"DBSubnetGroupArn": "arn:aws:rds:us-east-1:123456789012:subgrp:mydbsubnetgroup"
}
]
}
```
Pour plus d'informations, consultez [Amazon Virtual Private Cloud VPCs et Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html) dans le guide de l'*utilisateur Amazon RDS.*
+ Pour plus de détails sur l'API, voir [DescribeDbSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-subnet-groups.html)la section *Référence des AWS CLI commandes*.
### `describe-engine-default-cluster-parameters`
L'exemple de code suivant montre comment utiliser`describe-engine-default-cluster-parameters`.
**AWS CLI**
**Pour décrire les informations sur le moteur par défaut et sur les paramètres système du moteur de base de données Aurora**
L’exemple `describe-engine-default-cluster-parameters` suivant récupère les détails sur le moteur par défaut et les informations sur les paramètres système pour les clusters de bases de données Aurora compatibles avec MySQL 5.7.
```
aws rds describe-engine-default-cluster-parameters \
--db-parameter-group-family {{aurora-mysql5.7}}
```
Sortie :
```
{
"EngineDefaults": {
"Parameters": [
{
"ParameterName": "aurora_load_from_s3_role",
"Description": "IAM role ARN used to load data from AWS S3",
"Source": "engine-default",
"ApplyType": "dynamic",
"DataType": "string",
"IsModifiable": true,
"SupportedEngineModes": [
"provisioned"
]
},
...some output truncated...
]
}
}
```
Pour plus d’informations, consultez [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeEngineDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-engine-default-cluster-parameters.html)à la section *Référence des AWS CLI commandes*.
### `describe-engine-default-parameters`
L'exemple de code suivant montre comment utiliser`describe-engine-default-parameters`.
**AWS CLI**
**Pour décrire les informations sur le moteur par défaut et sur les paramètres système du moteur de base de données**
L’exemple `describe-engine-default-parameters` suivant récupère les détails sur le moteur par défaut et les informations sur les paramètres système pour les instances de base de données MySQL 5.7.
```
aws rds describe-engine-default-parameters \
--db-parameter-group-family {{mysql5.7}}
```
Sortie :
```
{
"EngineDefaults": {
"Parameters": [
{
"ParameterName": "allow-suspicious-udfs",
"Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": false
},
...some output truncated...
]
}
}
```
Pour de plus amples informations, veuillez consulter [ Utilisation des groupes de paramètres de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeEngineDefaultParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-engine-default-parameters.html)à la section *Référence des AWS CLI commandes*.
### `describe-event-categories`
L'exemple de code suivant montre comment utiliser`describe-event-categories`.
**AWS CLI**
**Pour décrire les catégories d’événements**
L’exemple `describe-event-categories` suivant récupère les détails sur les catégories d’événements pour toutes les sources d’événements disponibles.
```
aws rds describe-event-categories
```
Sortie :
```
{
"EventCategoriesMapList": [
{
"SourceType": "db-instance",
"EventCategories": [
"deletion",
"read replica",
"failover",
"restoration",
"maintenance",
"low storage",
"configuration change",
"backup",
"creation",
"availability",
"recovery",
"failure",
"backtrack",
"notification"
]
},
{
"SourceType": "db-security-group",
"EventCategories": [
"configuration change",
"failure"
]
},
{
"SourceType": "db-parameter-group",
"EventCategories": [
"configuration change"
]
},
{
"SourceType": "db-snapshot",
"EventCategories": [
"deletion",
"creation",
"restoration",
"notification"
]
},
{
"SourceType": "db-cluster",
"EventCategories": [
"failover",
"failure",
"notification"
]
},
{
"SourceType": "db-cluster-snapshot",
"EventCategories": [
"backup"
]
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEventCategories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-event-categories.html)à la section *Référence des AWS CLI commandes*.
### `describe-event-subscriptions`
L'exemple de code suivant montre comment utiliser`describe-event-subscriptions`.
**AWS CLI**
**Pour décrire les abonnements aux événements**
Cet exemple décrit tous les abonnements aux événements Amazon RDS pour le AWS compte courant.
```
aws rds describe-event-subscriptions
```
Sortie :
```
{
"EventSubscriptionsList": [
{
"EventCategoriesList": [
"backup",
"recovery"
],
"Enabled": true,
"EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
"Status": "creating",
"SourceType": "db-instance",
"CustomerAwsId": "123456789012",
"SubscriptionCreationTime": "2018-07-31 23:22:01.893",
"CustSubscriptionId": "my-instance-events",
"SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events"
},
...some output truncated...
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEventSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-event-subscriptions.html)à la section *Référence des AWS CLI commandes*.
### `describe-events`
L'exemple de code suivant montre comment utiliser`describe-events`.
**AWS CLI**
**Pour décrire les événements**
L’exemple `describe-events` suivant récupère les détails sur les événements qui se sont produits pour l’instance de base de données spécifiée.
```
aws rds describe-events \
--source-identifier {{test-instance}} \
--source-type {{db-instance}}
```
Sortie :
```
{
"Events": [
{
"SourceType": "db-instance",
"SourceIdentifier": "test-instance",
"EventCategories": [
"backup"
],
"Message": "Backing up DB instance",
"Date": "2018-07-31T23:09:23.983Z",
"SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance"
},
{
"SourceType": "db-instance",
"SourceIdentifier": "test-instance",
"EventCategories": [
"backup"
],
"Message": "Finished DB Instance backup",
"Date": "2018-07-31T23:15:13.049Z",
"SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-events.html)à la section *Référence des AWS CLI commandes*.
### `describe-export-tasks`
L'exemple de code suivant montre comment utiliser`describe-export-tasks`.
**AWS CLI**
**Pour décrire les tâches d’exportation d’instantanés**
L’exemple `describe-export-tasks` suivant renvoie d’informations sur les exportations d’instantanés vers Amazon S3.
```
aws rds describe-export-tasks
```
Sortie :
```
{
"ExportTasks": [
{
"ExportTaskIdentifier": "test-snapshot-export",
"SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:test-snapshot",
"SnapshotTime": "2020-03-02T18:26:28.163Z",
"TaskStartTime": "2020-03-02T18:57:56.896Z",
"TaskEndTime": "2020-03-02T19:10:31.985Z",
"S3Bucket": "amzn-s3-demo-bucket",
"S3Prefix": "",
"IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
"Status": "COMPLETE",
"PercentProgress": 100,
"TotalExtractedDataInGB": 0
},
{
"ExportTaskIdentifier": "my-s3-export",
"SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test",
"SnapshotTime": "2020-03-27T20:48:42.023Z",
"S3Bucket": "amzn-s3-demo-bucket",
"S3Prefix": "",
"IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
"Status": "STARTING",
"PercentProgress": 0,
"TotalExtractedDataInGB": 0
}
]
}
```
Pour plus d’informations, consultez [Surveillance des exportations d’instantanés](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Monitoring) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeExportTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-export-tasks.html)à la section *Référence des AWS CLI commandes*.
### `describe-global-clusters`
L'exemple de code suivant montre comment utiliser`describe-global-clusters`.
**AWS CLI**
**Pour décrire les clusters de bases de données globaux**
L'`describe-global-clusters`exemple suivant répertorie les clusters de base de données globaux Aurora dans la AWS région actuelle.
```
aws rds describe-global-clusters
```
Sortie :
```
{
"GlobalClusters": [
{
"GlobalClusterIdentifier": "myglobalcluster",
"GlobalClusterResourceId": "cluster-f5982077e3b5aabb",
"GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
"Status": "available",
"Engine": "aurora-mysql",
"EngineVersion": "5.7.mysql_aurora.2.07.2",
"StorageEncrypted": false,
"DeletionProtection": false,
"GlobalClusterMembers": []
}
]
}
```
Pour plus d’informations, consultez [Gestion d’une base de données Aurora globale](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeGlobalClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-global-clusters.html)à la section *Référence des AWS CLI commandes*.
### `describe-option-group-options`
L'exemple de code suivant montre comment utiliser`describe-option-group-options`.
**AWS CLI**
**Pour décrire toutes les options disponibles**
L’exemple `describe-option-group-options` suivant répertorie deux options pour une instance Oracle Database 19c.
```
aws rds describe-option-group-options \
--engine-name {{oracle-ee}} \
--major-engine-version {{19}} \
--max-items {{2}}
```
Sortie :
```
{
"OptionGroupOptions": [
{
"Name": "APEX",
"Description": "Oracle Application Express Runtime Environment",
"EngineName": "oracle-ee",
"MajorEngineVersion": "19",
"MinimumRequiredMinorEngineVersion": "0.0.0.ru-2019-07.rur-2019-07.r1",
"PortRequired": false,
"OptionsDependedOn": [],
"OptionsConflictsWith": [],
"Persistent": false,
"Permanent": false,
"RequiresAutoMinorEngineVersionUpgrade": false,
"VpcOnly": false,
"SupportsOptionVersionDowngrade": false,
"OptionGroupOptionSettings": [],
"OptionGroupOptionVersions": [
{
"Version": "19.1.v1",
"IsDefault": true
},
{
"Version": "19.2.v1",
"IsDefault": false
}
]
},
{
"Name": "APEX-DEV",
"Description": "Oracle Application Express Development Environment",
"EngineName": "oracle-ee",
"MajorEngineVersion": "19",
"MinimumRequiredMinorEngineVersion": "0.0.0.ru-2019-07.rur-2019-07.r1",
"PortRequired": false,
"OptionsDependedOn": [
"APEX"
],
"OptionsConflictsWith": [],
"Persistent": false,
"Permanent": false,
"RequiresAutoMinorEngineVersionUpgrade": false,
"VpcOnly": false,
"OptionGroupOptionSettings": []
}
],
"NextToken": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ=="
}
```
Pour plus d’informations, consultez [Liste des options et des paramètres d’options pour un groupe d’options](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.ListOption) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeOptionGroupOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-option-group-options.html)à la section *Référence des AWS CLI commandes*.
### `describe-option-groups`
L'exemple de code suivant montre comment utiliser`describe-option-groups`.
**AWS CLI**
**Pour décrire les groupes d’options disponibles**
L’exemple `describe-option-groups` suivant répertorie des groupes d’options pour une instance Oracle Database 19c.
```
aws rds describe-option-groups \
--engine-name {{oracle-ee}} \
--major-engine-version {{19}}
```
Sortie :
```
{
"OptionGroupsList": [
{
"OptionGroupName": "default:oracle-ee-19",
"OptionGroupDescription": "Default option group for oracle-ee 19",
"EngineName": "oracle-ee",
"MajorEngineVersion": "19",
"Options": [],
"AllowsVpcAndNonVpcInstanceMemberships": true,
"OptionGroupArn": "arn:aws:rds:us-west-1:111122223333:og:default:oracle-ee-19"
}
]
}
```
Pour plus d’informations, consultez [Liste des options et des paramètres d’options pour un groupe d’options](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.ListOption) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeOptionGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-option-groups.html)à la section *Référence des AWS CLI commandes*.
### `describe-orderable-db-instance-options`
L'exemple de code suivant montre comment utiliser`describe-orderable-db-instance-options`.
**AWS CLI**
**Pour décrire les options d’instance de base de données pouvant être commandées**
L’exemple `describe-orderable-db-instance-options` suivant extrait des détails sur les options commandables pour une instance de base de données exécutant le moteur de base de données MySQL.
```
aws rds describe-orderable-db-instance-options \
--engine {{mysql}}
```
Sortie :
```
{
"OrderableDBInstanceOptions": [
{
"MinStorageSize": 5,
"ReadReplicaCapable": true,
"MaxStorageSize": 6144,
"AvailabilityZones": [
{
"Name": "us-east-1a"
},
{
"Name": "us-east-1b"
},
{
"Name": "us-east-1c"
},
{
"Name": "us-east-1d"
}
],
"SupportsIops": false,
"AvailableProcessorFeatures": [],
"MultiAZCapable": true,
"DBInstanceClass": "db.m1.large",
"Vpc": true,
"StorageType": "gp2",
"LicenseModel": "general-public-license",
"EngineVersion": "5.5.46",
"SupportsStorageEncryption": false,
"SupportsEnhancedMonitoring": true,
"Engine": "mysql",
"SupportsIAMDatabaseAuthentication": false,
"SupportsPerformanceInsights": false
}
]
...some output truncated...
}
```
+ Pour plus de détails sur l'API, consultez la section [DescribeOrderableDBInstanceOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-orderable-db-instance-options.html) du manuel de *référence des AWS CLI commandes*.
### `describe-pending-maintenance-actions`
L'exemple de code suivant montre comment utiliser`describe-pending-maintenance-actions`.
**AWS CLI**
**Pour répertorier des ressources dont au moins une action de maintenance est en attente**
L'`describe-pending-maintenance-actions`exemple suivant répertorie l'action de maintenance en attente pour une instance de base de données.
```
aws rds describe-pending-maintenance-actions
```
Sortie :
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-west-2:123456789012:cluster:global-db1-cl1",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "Upgrade to Aurora PostgreSQL 2.4.2"
}
]
}
]
}
```
Pour plus d’informations, consultez [Entretien d’une instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [DescribePendingMaintenanceActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-pending-maintenance-actions.html)à la section *Référence des AWS CLI commandes*.
### `describe-reserved-db-instances-offerings`
L'exemple de code suivant montre comment utiliser`describe-reserved-db-instances-offerings`.
**AWS CLI**
**Pour décrire les offres d’instances de base de données réservées**
L’exemple `describe-reserved-db-instances-offerings` suivant extrait des détails sur les options d’instance de base de données réservées pour `oracle`.
```
aws rds describe-reserved-db-instances-offerings \
--product-description {{oracle}}
```
Sortie :
```
{
"ReservedDBInstancesOfferings": [
{
"CurrencyCode": "USD",
"UsagePrice": 0.0,
"ProductDescription": "oracle-se2(li)",
"ReservedDBInstancesOfferingId": "005bdee3-9ef4-4182-aa0c-58ef7cb6c2f8",
"MultiAZ": true,
"DBInstanceClass": "db.m4.xlarge",
"OfferingType": "Partial Upfront",
"RecurringCharges": [
{
"RecurringChargeAmount": 0.594,
"RecurringChargeFrequency": "Hourly"
}
],
"FixedPrice": 4089.0,
"Duration": 31536000
},
...some output truncated...
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeReservedDbInstancesOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-reserved-db-instances-offerings.html)à la section *Référence des AWS CLI commandes*.
### `describe-reserved-db-instances`
L'exemple de code suivant montre comment utiliser`describe-reserved-db-instances`.
**AWS CLI**
**Pour décrire les instances de base de données réservées**
L'`describe-reserved-db-instances`exemple suivant récupère les détails de toutes les instances de base de données réservées dans le AWS compte courant.
```
aws rds describe-reserved-db-instances
```
Sortie :
```
{
"ReservedDBInstances": [
{
"ReservedDBInstanceId": "myreservedinstance",
"ReservedDBInstancesOfferingId": "12ab34cd-59af-4b2c-a660-1abcdef23456",
"DBInstanceClass": "db.t3.micro",
"StartTime": "2020-06-01T13:44:21.436Z",
"Duration": 31536000,
"FixedPrice": 0.0,
"UsagePrice": 0.0,
"CurrencyCode": "USD",
"DBInstanceCount": 1,
"ProductDescription": "sqlserver-ex(li)",
"OfferingType": "No Upfront",
"MultiAZ": false,
"State": "payment-pending",
"RecurringCharges": [
{
"RecurringChargeAmount": 0.014,
"RecurringChargeFrequency": "Hourly"
}
],
"ReservedDBInstanceArn": "arn:aws:rds:us-west-2:123456789012:ri:myreservedinstance",
"LeaseId": "a1b2c3d4-6b69-4a59-be89-5e11aa446666"
}
]
}
```
Pour plus d’informations, consultez [Reserved DB Instances for Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeReservedDbInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-reserved-db-instances.html)à la section *Référence des AWS CLI commandes*.
### `describe-source-regions`
L'exemple de code suivant montre comment utiliser`describe-source-regions`.
**AWS CLI**
**Pour décrire les régions source**
L'`describe-source-regions`exemple suivant permet de récupérer des informations sur toutes les AWS régions sources. Cela montre également que les sauvegardes automatisées ne peuvent être répliquées que depuis l'ouest des États-Unis (Oregon) vers la AWS région de destination, l'est des États-Unis (Virginie du Nord).
```
aws rds describe-source-regions \
--region {{us-east-1}}
```
Sortie :
```
{
"SourceRegions": [
{
"RegionName": "af-south-1",
"Endpoint": "https://rds.af-south-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": false
},
{
"RegionName": "ap-east-1",
"Endpoint": "https://rds.ap-east-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": false
},
{
"RegionName": "ap-northeast-1",
"Endpoint": "https://rds.ap-northeast-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "ap-northeast-2",
"Endpoint": "https://rds.ap-northeast-2.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "ap-northeast-3",
"Endpoint": "https://rds.ap-northeast-3.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": false
},
{
"RegionName": "ap-south-1",
"Endpoint": "https://rds.ap-south-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "ap-southeast-1",
"Endpoint": "https://rds.ap-southeast-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "ap-southeast-2",
"Endpoint": "https://rds.ap-southeast-2.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "ap-southeast-3",
"Endpoint": "https://rds.ap-southeast-3.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": false
},
{
"RegionName": "ca-central-1",
"Endpoint": "https://rds.ca-central-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "eu-north-1",
"Endpoint": "https://rds.eu-north-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "eu-south-1",
"Endpoint": "https://rds.eu-south-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": false
},
{
"RegionName": "eu-west-1",
"Endpoint": "https://rds.eu-west-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "eu-west-2",
"Endpoint": "https://rds.eu-west-2.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "eu-west-3",
"Endpoint": "https://rds.eu-west-3.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "me-central-1",
"Endpoint": "https://rds.me-central-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": false
},
{
"RegionName": "me-south-1",
"Endpoint": "https://rds.me-south-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": false
},
{
"RegionName": "sa-east-1",
"Endpoint": "https://rds.sa-east-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "us-east-2",
"Endpoint": "https://rds.us-east-2.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "us-west-1",
"Endpoint": "https://rds.us-west-1.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
},
{
"RegionName": "us-west-2",
"Endpoint": "https://rds.us-west-2.amazonaws.com",
"Status": "available",
"SupportsDBInstanceAutomatedBackupsReplication": true
}
]
}
```
Pour plus d’informations, consultez [Recherche d’informations sur les sauvegardes répliquées](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Describe) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeSourceRegions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-source-regions.html)à la section *Référence des AWS CLI commandes*.
### `describe-valid-db-instance-modifications`
L'exemple de code suivant montre comment utiliser`describe-valid-db-instance-modifications`.
**AWS CLI**
**Pour décrire les modifications valides pour une instance de base de données**
L’exemple `describe-valid-db-instance-modifications` suivant extrait les détails sur les modifications valides pour l’instance de base de données spécifiée.
```
aws rds describe-valid-db-instance-modifications \
--db-instance-identifier {{test-instance}}
```
Sortie :
```
{
"ValidDBInstanceModificationsMessage": {
"ValidProcessorFeatures": [],
"Storage": [
{
"StorageSize": [
{
"Step": 1,
"To": 20,
"From": 20
},
{
"Step": 1,
"To": 6144,
"From": 22
}
],
"ProvisionedIops": [
{
"Step": 1,
"To": 0,
"From": 0
}
],
"IopsToStorageRatio": [
{
"To": 0.0,
"From": 0.0
}
],
"StorageType": "gp2"
},
{
"StorageSize": [
{
"Step": 1,
"To": 6144,
"From": 100
}
],
"ProvisionedIops": [
{
"Step": 1,
"To": 40000,
"From": 1000
}
],
"IopsToStorageRatio": [
{
"To": 50.0,
"From": 1.0
}
],
"StorageType": "io1"
},
{
"StorageSize": [
{
"Step": 1,
"To": 20,
"From": 20
},
{
"Step": 1,
"To": 3072,
"From": 22
}
],
"ProvisionedIops": [
{
"Step": 1,
"To": 0,
"From": 0
}
],
"IopsToStorageRatio": [
{
"To": 0.0,
"From": 0.0
}
],
"StorageType": "magnetic"
}
]
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeValidDbInstanceModifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-valid-db-instance-modifications.html)à la section *Référence des AWS CLI commandes*.
### `download-db-log-file-portion`
L'exemple de code suivant montre comment utiliser`download-db-log-file-portion`.
**AWS CLI**
**Exemple 1 : pour télécharger la dernière partie d’un fichier journal de base de données**
L’exemple `download-db-log-file-portion` suivant télécharge uniquement la dernière partie de votre fichier journal et l’enregistre dans un fichier local nommé `tail.txt`.
```
aws rds download-db-log-file-portion \
--db-instance-identifier {{test-instance}} \
--log-file-name {{log.txt}} \
--output {{text}} {{>}} {{tail.txt}}
```
Le fichier enregistré peut contenir des lignes vides. Elles apparaissent à la fin de chaque partie du fichier journal lors du téléchargement.
**Exemple 2 : pour télécharger l’intégralité d’un fichier journal de base de données**
L’exemple `download-db-log-file-portion` suivant télécharge l’intégralité du fichier journal à l’aide du paramètre `--starting-token 0` et enregistre la sortie dans un fichier local nommé `full.txt`.
```
aws rds download-db-log-file-portion \
--db-instance-identifier {{test-instance}} \
--log-file-name {{log.txt}} \
--starting-token {{0}} \
--output {{text}} {{>}} {{full.txt}}
```
Le fichier enregistré peut contenir des lignes vides. Elles apparaissent à la fin de chaque partie du fichier journal lors du téléchargement.
+ Pour plus de détails sur l'API, reportez-vous [DownloadDbLogFilePortion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/download-db-log-file-portion.html)à la section *Référence des AWS CLI commandes*.
### `generate-auth-token`
L'exemple de code suivant montre comment utiliser`generate-auth-token`.
**AWS CLI**
**Pour générer un jeton d’authentification**
L’exemple `generate-db-auth-token` suivant génère un jeton d’authentification à utiliser avec l’authentification de base de données IAM.
```
aws rds generate-db-auth-token \
--hostname {{aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com}} \
--port {{3306}} \
--region {{us-east-1}} \
--username {{jane_doe}}
```
Sortie :
```
aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com:3306/?Action=connect&DBUser=jane_doe&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIESZCNJ3OEXAMPLE%2F20180731%2Fus-east-1%2Frds-db%2Faws4_request&X-Amz-Date=20180731T235209Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=5a8753ebEXAMPLEa2c724e5667797EXAMPLE9d6ec6e3f427191fa41aeEXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [GenerateAuthToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/generate-auth-token.html)à la section *Référence des AWS CLI commandes*.
### `generate-db-auth-token`
L'exemple de code suivant montre comment utiliser`generate-db-auth-token`.
**AWS CLI**
**Pour générer un jeton d’authentification IAM**
L’exemple `generate-db-auth-token` suivant génère un jeton d’authentification IAM pour se connecter à une base de données.
```
aws rds generate-db-auth-token \
--hostname {{mydb.123456789012.us-east-1.rds.amazonaws.com}} \
--port {{3306}} \
--region {{us-east-1}} \
--username {{db_user}}
```
Sortie :
```
mydb.123456789012.us-east-1.rds.amazonaws.com:3306/?Action=connect&DBUser=db_user&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIEXAMPLE%2Fus-east-1%2Frds-db%2Faws4_request&X-Amz-Date=20210123T011543Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=88987EXAMPLE1EXAMPLE2EXAMPLE3EXAMPLE4EXAMPLE5EXAMPLE6
```
Pour plus d’informations, consultez [Connexion de votre instance de base de données à l’aide de l’authentification IAM](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.Connecting.html) dans le *Guide de l’utilisateur Amazon RDS* et [Connexion de votre cluster de base de données à l’aide de l’authentification IAM](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.Connecting.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [GenerateDbAuthToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/generate-db-auth-token.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour répertorier des balises sur une ressource Amazon RDS**
L’exemple `list-tags-for-resource` suivant répertorie toutes les balises d’une instance de base de données.
```
aws rds list-tags-for-resource \
--resource-name {{arn:aws:rds:us-east-1:123456789012:db:orcl1}}
```
Sortie :
```
{
"TagList": [
{
"Key": "Environment",
"Value": "test"
},
{
"Key": "Name",
"Value": "MyDatabase"
}
]
}
```
Pour plus d’informations, consultez [Balisage de ressources Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `modify-certificates`
L'exemple de code suivant montre comment utiliser`modify-certificates`.
**AWS CLI**
**Pour remplacer temporairement le SSL/TLS certificat par défaut du système pour les nouvelles instances de base de données**
L'`modify-certificates`exemple suivant remplace temporairement le SSL/TLS certificat par défaut du système pour les nouvelles instances de base de données.
```
aws rds modify-certificates \
--certificate-identifier {{rds-ca-2019}}
```
Sortie :
```
{
"Certificate": {
"CertificateIdentifier": "rds-ca-2019",
"CertificateType": "CA",
"Thumbprint": "EXAMPLE123456789012",
"ValidFrom": "2019-09-19T18:16:53Z",
"ValidTill": "2024-08-22T17:08:50Z",
"CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-2019",
"CustomerOverride": true,
"CustomerOverrideValidTill": "2024-08-22T17:08:50Z"
}
}
```
Pour plus d'informations, consultez [Rotation de votre SSL/TLS certificat](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html) dans le *guide de l'utilisateur Amazon RDS* et [Rotation de votre SSL/TLS certificat](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html) dans le *guide de l'utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-certificates.html)à la section *Référence des AWS CLI commandes*.
### `modify-current-db-cluster-capacity`
L'exemple de code suivant montre comment utiliser`modify-current-db-cluster-capacity`.
**AWS CLI**
**Pour mettre à l’échelle la capacité d’un cluster de bases de données Aurora sans serveur**
L’exemple `modify-current-db-cluster-capacity` suivant met à l’échelle la capacité d’un cluster de bases de données Aurora sans serveur sur 8.
```
aws rds modify-current-db-cluster-capacity \
--db-cluster-identifier {{mydbcluster}} \
--capacity {{8}}
```
Sortie :
```
{
"DBClusterIdentifier": "mydbcluster",
"PendingCapacity": 8,
"CurrentCapacity": 1,
"SecondsBeforeTimeout": 300,
"TimeoutAction": "ForceApplyCapacityChange"
}
```
Pour plus d’informations, consultez [Scaling Aurora Serverless v1 DB cluster capacity manually](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.setting-capacity.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyCurrentDbClusterCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-current-db-cluster-capacity.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-cluster-endpoint`
L'exemple de code suivant montre comment utiliser`modify-db-cluster-endpoint`.
**AWS CLI**
**Pour modifier un point de terminaison du cluster de bases de données personnalisé**
L’exemple `modify-db-cluster-endpoint` suivant modifie le point de terminaison du cluster de bases de données spécifié.
```
aws rds modify-db-cluster-endpoint \
--db-cluster-endpoint-identifier {{mycustomendpoint}} \
--static-members {{dbinstance1}} {{dbinstance2}} {{dbinstance3}}
```
Sortie :
```
{
"DBClusterEndpointIdentifier": "mycustomendpoint",
"DBClusterIdentifier": "mydbcluster",
"DBClusterEndpointResourceIdentifier": "cluster-endpoint-ANPAJ4AE5446DAEXAMPLE",
"Endpoint": "mycustomendpoint.cluster-custom-cnpexample.us-east-1.rds.amazonaws.com",
"Status": "modifying",
"EndpointType": "CUSTOM",
"CustomEndpointType": "READER",
"StaticMembers": [
"dbinstance1",
"dbinstance2",
"dbinstance3"
],
"ExcludedMembers": [],
"DBClusterEndpointArn": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:mycustomendpoint"
}
```
Pour plus d’informations, consultez [Gestion des connexions Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-endpoint.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-cluster-parameter-group`
L'exemple de code suivant montre comment utiliser`modify-db-cluster-parameter-group`.
**AWS CLI**
**Pour modifier les paramètres dans un groupe de paramètres du cluster de bases de données**
L’exemple `modify-db-cluster-parameter-group` suivant modifie les valeurs des paramètres d’un groupe de paramètres du cluster de bases de données.
```
aws rds modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name {{mydbclusterpg}} \
--parameters {{"ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate"}} \
{{"ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"}}
```
Sortie :
```
{
"DBClusterParameterGroupName": "mydbclusterpg"
}
```
Pour plus d’informations, consultez [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-parameter-group.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-cluster-snapshot-attribute`
L'exemple de code suivant montre comment utiliser`modify-db-cluster-snapshot-attribute`.
**AWS CLI**
**Pour modifier un attribut d’instantané de cluster de bases de données**
L’exemple `modify-db-cluster-snapshot-attribute` suivant apporte des modifications à l’attribut d’instantané de cluster de bases de données spécifié.
```
aws rds modify-db-cluster-snapshot-attribute \
--db-cluster-snapshot-identifier {{myclustersnapshot}} \
--attribute-name {{restore}} \
--values-to-add {{123456789012}}
```
Sortie :
```
{
"DBClusterSnapshotAttributesResult": {
"DBClusterSnapshotIdentifier": "myclustersnapshot",
"DBClusterSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123456789012"
]
}
]
}
}
```
Pour plus d’informations, consultez [Restauration à partir d’un instantané de cluster de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RestoreFromSnapshot.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbClusterSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-snapshot-attribute.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-cluster`
L'exemple de code suivant montre comment utiliser`modify-db-cluster`.
**AWS CLI**
**Exemple 1 : pour modifier un cluster de bases de données**
L’exemple `modify-db-cluster` suivant modifie le mot de passe de l’utilisateur principal pour le cluster de base de données nommé `cluster-2` et définit la période de conservation des sauvegardes à 14 jours. Le paramètre `--apply-immediately` entraîne la modification immédiate du groupes de paramètres de base de données, au lieu d’attendre la prochaine fenêtre de maintenance.
```
aws rds modify-db-cluster \
--db-cluster-identifier {{cluster-2}} \
--backup-retention-period {{14}} \
--master-user-password {{newpassword99}} \
--apply-immediately
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"eu-central-1b",
"eu-central-1c",
"eu-central-1a"
],
"BackupRetentionPeriod": 14,
"DatabaseName": "",
"DBClusterIdentifier": "cluster-2",
"DBClusterParameterGroup": "default.aurora5.6",
"DBSubnetGroup": "default-vpc-2305ca49",
"Status": "available",
"EarliestRestorableTime": "2020-06-03T02:07:29.637Z",
"Endpoint": "cluster-2.cluster-############.eu-central-1.rds.amazonaws.com",
"ReaderEndpoint": "cluster-2.cluster-ro-############.eu-central-1.rds.amazonaws.com",
"MultiAZ": false,
"Engine": "aurora",
"EngineVersion": "5.6.10a",
"LatestRestorableTime": "2020-06-04T15:11:25.748Z",
"Port": 3306,
"MasterUsername": "admin",
"PreferredBackupWindow": "01:55-02:25",
"PreferredMaintenanceWindow": "thu:21:14-thu:21:44",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "cluster-2-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-20a5c047",
"Status": "active"
}
],
"HostedZoneId": "Z1RLNU0EXAMPLE",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:eu-central-1:123456789012:key/d1bd7c8f-5cdb-49ca-8a62-a1b2c3d4e5f6",
"DbClusterResourceId": "cluster-AGJ7XI77XVIS6FUXHU1EXAMPLE",
"DBClusterArn": "arn:aws:rds:eu-central-1:123456789012:cluster:cluster-2",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2020-04-03T14:44:02.764Z",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": true,
"CrossAccountClone": false,
"DomainMemberships": []
}
}
```
Pour plus d’informations, consultez [Modification d’un cluster de bases de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Modifying.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 2 : pour associer un groupe de sécurité VPC à un cluster de bases de données**
L’exemple `modify-db-instance` suivant associe un groupe de sécurité VPC spécifique et supprime des groupes de sécurité de base de données d’un cluster de bases de données.
```
aws rds modify-db-cluster \
--db-cluster-identifier {{dbName}} \
--vpc-security-group-ids {{sg-ID}}
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-west-2c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "dbName",
"DBClusterParameterGroup": "default.aurora-mysql8.0",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2024-02-15T01:12:13.966000+00:00",
"Endpoint": "dbName.cluster-abcdefghji.us-west-2.rds.amazonaws.com",
"ReaderEndpoint": "dbName.cluster-ro-abcdefghji.us-west-2.rds.amazonaws.com",
"MultiAZ": false,
"Engine": "aurora-mysql",
"EngineVersion": "8.0.mysql_aurora.3.04.1",
"LatestRestorableTime": "2024-02-15T02:25:33.696000+00:00",
"Port": 3306,
"MasterUsername": "admin",
"PreferredBackupWindow": "10:59-11:29",
"PreferredMaintenanceWindow": "thu:08:54-thu:09:24",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "dbName-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-ID",
"Status": "active"
}
],
...output omitted...
}
}
```
Pour plus d’informations, consultez [Contrôle d’accès par groupe de sécurité](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Overview.RDSSecurityGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-instance`
L'exemple de code suivant montre comment utiliser`modify-db-instance`.
**AWS CLI**
**Exemple 1 : pour modifier une instance de base de données**
L’exemple `modify-db-instance` suivant associe un groupe d’options et un groupe de paramètres à une instance de base de données Microsoft SQL Server compatible. Le paramètre `--apply-immediately` entraîne l’association immédiate des groupes d’options et de paramètres au lieu d’attendre la prochaine fenêtre de maintenance.
```
aws rds modify-db-instance \
--db-instance-identifier {{database-2}} \
--option-group-name {{test-se-2017}} \
--db-parameter-group-name {{test-sqlserver-se-2017}} \
--apply-immediately
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "database-2",
"DBInstanceClass": "db.r4.large",
"Engine": "sqlserver-se",
"DBInstanceStatus": "available",
...output omitted...
"DBParameterGroups": [
{
"DBParameterGroupName": "test-sqlserver-se-2017",
"ParameterApplyStatus": "applying"
}
],
"AvailabilityZone": "us-west-2d",
...output omitted...
"MultiAZ": true,
"EngineVersion": "14.00.3281.6.v1",
"AutoMinorVersionUpgrade": false,
"ReadReplicaDBInstanceIdentifiers": [],
"LicenseModel": "license-included",
"OptionGroupMemberships": [
{
"OptionGroupName": "test-se-2017",
"Status": "pending-apply"
}
],
"CharacterSetName": "SQL_Latin1_General_CP1_CI_AS",
"SecondaryAvailabilityZone": "us-west-2c",
"PubliclyAccessible": true,
"StorageType": "gp2",
...output omitted...
"DeletionProtection": false,
"AssociatedRoles": [],
"MaxAllocatedStorage": 1000
}
}
```
Pour plus d’informations, consultez [Modification d’une instance de base de données Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html) dans le *Guide de l’utilisateur Amazon RDS*.
**Exemple 2 : pour associer un groupe de sécurité VPC à une instance de base de données**
L’exemple `modify-db-instance` suivant associe un groupe de sécurité VPC spécifique et supprime des groupes de sécurité de base de données d’une instance de base de données :
```
aws rds modify-db-instance \
--db-instance-identifier {{dbName}} \
--vpc-security-group-ids {{sg-ID}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "dbName",
"DBInstanceClass": "db.t3.micro",
"Engine": "mysql",
"DBInstanceStatus": "available",
"MasterUsername": "admin",
"Endpoint": {
"Address": "dbName.abcdefghijk.us-west-2.rds.amazonaws.com",
"Port": 3306,
"HostedZoneId": "ABCDEFGHIJK1234"
},
"AllocatedStorage": 20,
"InstanceCreateTime": "2024-02-15T00:37:58.793000+00:00",
"PreferredBackupWindow": "11:57-12:27",
"BackupRetentionPeriod": 7,
"DBSecurityGroups": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-ID",
"Status": "active"
}
],
... output omitted ...
"MultiAZ": false,
"EngineVersion": "8.0.35",
"AutoMinorVersionUpgrade": true,
"ReadReplicaDBInstanceIdentifiers": [],
"LicenseModel": "general-public-license",
... output omitted ...
}
}
```
Pour plus d’informations, consultez [Contrôle d’accès par groupe de sécurité](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.RDSSecurityGroups.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Modifier DBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-instance.html) dans *AWS CLI la référence des commandes*.
### `modify-db-parameter-group`
L'exemple de code suivant montre comment utiliser`modify-db-parameter-group`.
**AWS CLI**
**Pour modifier un groupe de paramètres de base de données**
L’exemple `modify-db-parameter-group` suivant modifie la valeur du paramètre `clr enabled` dans un groupe de paramètres de base de données. Le paramètre `--apply-immediately` entraîne la modification immédiate du groupe de paramètres de base de données, au lieu d’attendre la prochaine fenêtre de maintenance.
```
aws rds modify-db-parameter-group \
--db-parameter-group-name {{test-sqlserver-se-2017}} \
--parameters {{"ParameterName='clr enabled',ParameterValue=1,ApplyMethod=immediate"}}
```
Sortie :
```
{
"DBParameterGroupName": "test-sqlserver-se-2017"
}
```
Pour plus d’informations, consultez [Modification de paramètres dans un groupe de paramètres DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Modifying) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Modifier DBParameter le groupe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-parameter-group.html) dans *AWS CLI la référence des commandes*.
### `modify-db-proxy-endpoint`
L'exemple de code suivant montre comment utiliser`modify-db-proxy-endpoint`.
**AWS CLI**
**Pour modifier un point de terminaison proxy de base de données pour une base de données RDS**
L’exemple `modify-db-proxy-endpoint` suivant modifie un point de terminaison du proxy de base de données `proxyEndpoint` pour définir le délai d’expiration de lecture à 65 secondes.
```
aws rds modify-db-proxy-endpoint \
--db-proxy-endpoint-name {{proxyEndpoint}} \
--cli-read-timeout {{65}}
```
Sortie :
```
{
"DBProxyEndpoint":
{
"DBProxyEndpointName": "proxyEndpoint",
"DBProxyEndpointArn": "arn:aws:rds:us-east-1:123456789012:db-proxy-endpoint:prx-endpoint-0123a01b12345c0ab",
"DBProxyName": "proxyExample",
"Status": "available",
"VpcId": "vpc-1234567",
"VpcSecurityGroupIds": [
"sg-1234"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Endpoint": "proxyEndpoint.endpoint.proxyExample-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"CreatedDate": "2023-04-05T16:09:33.452000+00:00",
"TargetRole": "READ_WRITE",
"IsDefault": "false"
}
}
```
Pour plus d’informations, consultez [Modification d’un point de terminaison proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.ModifyingEndpoint) dans le *Guide de l’utilisateur Amazon RDS* et [Modification d’un point de terminaison proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.ModifyingEndpoint) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy-endpoint.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-proxy-target-group`
L'exemple de code suivant montre comment utiliser`modify-db-proxy-target-group`.
**AWS CLI**
**Pour modifier les points de terminaison d’un proxy de base de données**
L’exemple `modify-db-proxy-target-group` suivant modifie un groupe cible de proxy de base de données pour définir le nombre maximum de connexions à 80 % et le nombre maximum de connexions inactives à 10 %.
```
aws rds modify-db-proxy-target-group \
--target-group-name {{default}} \
--db-proxy-name {{proxyExample}} \
--connection-pool-config {{MaxConnectionsPercent=80,MaxIdleConnectionsPercent=10}}
```
Sortie :
```
{
"DBProxyTargetGroup":
{
"DBProxyName": "proxyExample",
"TargetGroupName": "default",
"TargetGroupArn": "arn:aws:rds:us-east-1:123456789012:target-group:prx-tg-0123a01b12345c0ab",
"IsDefault": true,
"Status": "available",
"ConnectionPoolConfig": {
"MaxConnectionsPercent": 80,
"MaxIdleConnectionsPercent": 10,
"ConnectionBorrowTimeout": 120,
"SessionPinningFilters": []
},
"CreatedDate": "2023-05-02T18:41:19.495000+00:00",
"UpdatedDate": "2023-05-02T18:41:21.762000+00:00"
}
}
```
Pour plus d’informations, consultez [Modification d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) dans le *Guide de l’utilisateur Amazon RDS* et [Modification d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbProxyTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy-target-group.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-proxy`
L'exemple de code suivant montre comment utiliser`modify-db-proxy`.
**AWS CLI**
**Pour modifier un proxy de base de données pour une base de données RDS**
L’exemple `modify-db-proxy` suivant modifie un proxy de base de données nommé `proxyExample` pour exiger le protocole SSL pour ses connexions.
```
aws rds modify-db-proxy \
--db-proxy-name {{proxyExample}} \
--require-tls
```
Sortie :
```
{
"DBProxy":
{
"DBProxyName": "proxyExample",
"DBProxyArn": "arn:aws:rds:us-east-1:123456789012:db-proxy:prx-0123a01b12345c0ab",
"Status": "modifying"
"EngineFamily": "PostgreSQL",
"VpcId": "sg-1234567",
"VpcSecurityGroupIds": [
"sg-1234"
],
"VpcSubnetIds": [
"subnetgroup1",
"subnetgroup2"
],
"Auth": "[
{
"Description": "proxydescription1",
"AuthScheme": "SECRETS",
"SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret:proxysecret1-Abcd1e",
"IAMAuth": "DISABLED"
}
]",
"RoleArn": "arn:aws:iam::12345678912:role/ProxyPostgreSQLRole",
"Endpoint": "proxyExample.proxy-ab0cd1efghij.us-east-1.rds.amazonaws.com",
"RequireTLS": true,
"IdleClientTimeout": 1800,
"DebuggingLogging": false,
"CreatedDate": "2023-04-05T16:09:33.452000+00:00",
"UpdatedDate": "2023-04-13T01:49:38.568000+00:00"
}
}
```
Pour plus d’informations, consultez [Modify an RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) dans le *Guide de l’utilisateur Amazon RDS* et [Création d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-shard-group`
L'exemple de code suivant montre comment utiliser`modify-db-shard-group`.
**AWS CLI**
**Exemple 1 : pour modifier un groupe de partitions de base de données**
L’exemple `modify-db-shard-group` suivant modifie la capacité maximale d’un groupe de partitions de base de données.
```
aws rds modify-db-shard-group \
--db-shard-group-identifier {{my-db-shard-group}} \
--max-acu {{1000}}
```
Sortie :
```
{
"DBShardGroups": [
{
"DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
"DBShardGroupIdentifier": "my-db-shard-group",
"DBClusterIdentifier": "my-sv2-cluster",
"MaxACU": 768.0,
"ComputeRedundancy": 0,
"Status": "available",
"PubliclyAccessible": false,
"Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}
]
}
```
Pour plus d’informations, consultez [Clusters de bases de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 2 : pour décrire les groupes de partitions de base de données**
L’exemple `describe-db-shard-groups` suivant extrait les détails sur vos groupes de partitions de base de données une fois que vous avez exécuté la commande `modify-db-shard-group`. La capacité maximale du groupe de partitions de base de données `my-db-shard-group` est désormais de 1 000 unités de capacité Aurora (ACUs).
```
aws rds describe-db-shard-groups
```
Sortie :
```
{
"DBShardGroups": [
{
"DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
"DBShardGroupIdentifier": "limitless-test-shard-grp",
"DBClusterIdentifier": "limitless-test-cluster",
"MaxACU": 768.0,
"ComputeRedundancy": 0,
"Status": "available",
"PubliclyAccessible": true,
"Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
},
{
"DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
"DBShardGroupIdentifier": "my-db-shard-group",
"DBClusterIdentifier": "my-sv2-cluster",
"MaxACU": 1000.0,
"ComputeRedundancy": 0,
"Status": "available",
"PubliclyAccessible": false,
"Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}
]
}
```
Pour plus d’informations, consultez [Clusters de bases de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-shard-group.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-snapshot-attribute`
L'exemple de code suivant montre comment utiliser`modify-db-snapshot-attribute`.
**AWS CLI**
**Exemple 1 : pour permettre à deux AWS comptes de restaurer un instantané de base de données**
L'`modify-db-snapshot-attribute`exemple suivant accorde l'autorisation à deux AWS comptes, avec les identifiants `111122223333` et`444455556666`, de restaurer le snapshot de base de données nommé`mydbsnapshot`.
```
aws rds modify-db-snapshot-attribute \
--db-snapshot-identifier {{mydbsnapshot}} \
--attribute-name {{restore}} \
--values-to-add {"111122223333","444455556666"}
```
Sortie :
```
{
"DBSnapshotAttributesResult": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"111122223333",
"444455556666"
]
}
]
}
}
```
Pour plus d’informations, consultez [Partage d’un instantané](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) dans le *Guide de l’utilisateur Amazon RDS*.
**Exemple 2 : pour empêcher un AWS compte de restaurer un instantané de base de données**
L'`modify-db-snapshot-attribute`exemple suivant supprime l'autorisation d'un AWS compte particulier pour restaurer le snapshot de base de données nommé`mydbsnapshot`. Lorsque vous spécifiez un seul compte, l’identifiant du compte ne peut pas être entouré de guillemets ou d’accolades.
```
aws rds modify-db-snapshot-attribute \
--db-snapshot-identifier {{mydbsnapshot}} \
--attribute-name {{restore}} \
--values-to-remove {{444455556666}}
```
Sortie :
```
{
"DBSnapshotAttributesResult": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"111122223333"
]
}
]
}
}
```
Pour plus d’informations, consultez [Partage d’un instantané](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot-attribute.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-snapshot-attributes`
L'exemple de code suivant montre comment utiliser`modify-db-snapshot-attributes`.
**AWS CLI**
**Pour modifier un attribut d’instantané de base de données**
L'`modify-db-snapshot-attribute`exemple suivant autorise deux identifiants de AWS compte `111122223333` et permet de restaurer `444455556666` le snapshot de base de données nommé`mydbsnapshot`.
```
aws rds modify-db-snapshot-attribute \
--db-snapshot-identifier {{mydbsnapshot}} \
--attribute-name {{restore}} \
--values-to-add '{{["111122223333","444455556666"]}}'
```
Sortie :
```
{
"DBSnapshotAttributesResult": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"111122223333",
"444455556666"
]
}
]
}
}
```
Pour plus d’informations, consultez [Partage d’un instantané](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot-attributes.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-snapshot`
L'exemple de code suivant montre comment utiliser`modify-db-snapshot`.
**AWS CLI**
**Pour modifier un instantané de base de données**
L’exemple `modify-db-snapshot` suivant met à niveau un instantané PostgreSQL 10.6 nommé `db5-snapshot-upg-test` vers PostgreSQL 11.7. La nouvelle version du moteur de base de données est affichée une fois que la mise à niveau de l’instantané est terminée et que son statut est **disponible**.
```
aws rds modify-db-snapshot \
--db-snapshot-identifier {{db5-snapshot-upg-test}} \
--engine-version {{11.7}}
```
Sortie :
```
{
"DBSnapshot": {
"DBSnapshotIdentifier": "db5-snapshot-upg-test",
"DBInstanceIdentifier": "database-5",
"SnapshotCreateTime": "2020-03-27T20:49:17.092Z",
"Engine": "postgres",
"AllocatedStorage": 20,
"Status": "upgrading",
"Port": 5432,
"AvailabilityZone": "us-west-2a",
"VpcId": "vpc-2ff27557",
"InstanceCreateTime": "2020-03-27T19:59:04.735Z",
"MasterUsername": "postgres",
"EngineVersion": "10.6",
"LicenseModel": "postgresql-license",
"SnapshotType": "manual",
"OptionGroupName": "default:postgres-11",
"PercentProgress": 100,
"StorageType": "gp2",
"Encrypted": false,
"DBSnapshotArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-upg-test",
"IAMDatabaseAuthenticationEnabled": false,
"ProcessorFeatures": [],
"DbiResourceId": "db-GJMF75LM42IL6BTFRE4UZJ5YM4"
}
}
```
Pour plus d’informations, consultez [Mise à jour d’un instantané de base de données PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBSnapshot.PostgreSQL.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot.html)à la section *Référence des AWS CLI commandes*.
### `modify-db-subnet-group`
L'exemple de code suivant montre comment utiliser`modify-db-subnet-group`.
**AWS CLI**
**Pour modifier un groupe de sous-réseaux de base de données**
L’exemple `modify-db-subnet-group` suivant ajoute un sous-réseau avec l’ID `subnet-08e41f9e230222222` au groupe de sous-réseaux de base de données nommé `mysubnetgroup`. Pour conserver les sous-réseaux existants dans le groupe de sous-réseaux, incluez leurs IDs valeurs dans l'`--subnet-ids`option. Assurez-vous de disposer de sous-réseaux avec au moins deux zones de disponibilité distinctes dans le groupe de sous-réseaux de base de données.
```
aws rds modify-db-subnet-group \
--db-subnet-group-name {{mysubnetgroup}} \
--subnet-ids '{{["subnet-0a1dc4e1a6f123456","subnet-070dd7ecb3aaaaaaa","subnet-00f5b198bc0abcdef","subnet-08e41f9e230222222"]}}'
```
Sortie :
```
{
"DBSubnetGroup": {
"DBSubnetGroupName": "mysubnetgroup",
"DBSubnetGroupDescription": "test DB subnet group",
"VpcId": "vpc-0f08e7610a1b2c3d4",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-08e41f9e230222222",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-070dd7ecb3aaaaaaa",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-00f5b198bc0abcdef",
"SubnetAvailabilityZone": {
"Name": "us-west-2d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-0a1dc4e1a6f123456",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
],
"DBSubnetGroupArn": "arn:aws:rds:us-west-2:534026745191:subgrp:mysubnetgroup"
}
}
```
Pour plus d’informations, consultez [Étape 3 : Créer un groupe de sous-réseaux DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.CreateDBSubnetGroup) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-subnet-group.html)à la section *Référence des AWS CLI commandes*.
### `modify-event-subscription`
L'exemple de code suivant montre comment utiliser`modify-event-subscription`.
**AWS CLI**
**Pour modifier un abonnement à un événement**
L’exemple `modify-event-subscription` suivant désactive l’abonnement à un événement spécifié, de sorte qu’il ne publie plus de notifications sur la rubrique Amazon Simple Notification Service spécifiée.
```
aws rds modify-event-subscription \
--subscription-name {{my-instance-events}} \
--no-enabled
```
Sortie :
```
{
"EventSubscription": {
"EventCategoriesList": [
"backup",
"recovery"
],
"CustomerAwsId": "123456789012",
"SourceType": "db-instance",
"SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
"EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
"SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
"CustSubscriptionId": "my-instance-events",
"Status": "modifying",
"Enabled": false
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-event-subscription.html)à la section *Référence des AWS CLI commandes*.
### `modify-global-cluster`
L'exemple de code suivant montre comment utiliser`modify-global-cluster`.
**AWS CLI**
**Pour modifier un cluster de bases de données global**
L’exemple `modify-global-cluster` suivant active la protection contre la suppression d’un cluster de bases de données global compatible avec Aurora MySQL.
```
aws rds modify-global-cluster \
--global-cluster-identifier {{myglobalcluster}} \
--deletion-protection
```
Sortie :
```
{
"GlobalCluster": {
"GlobalClusterIdentifier": "myglobalcluster",
"GlobalClusterResourceId": "cluster-f0e523bfe07aabb",
"GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
"Status": "available",
"Engine": "aurora-mysql",
"EngineVersion": "5.7.mysql_aurora.2.07.2",
"StorageEncrypted": false,
"DeletionProtection": true,
"GlobalClusterMembers": []
}
}
```
Pour plus d’informations, consultez [Gestion d’une base de données Aurora globale](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ModifyGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-global-cluster.html)à la section *Référence des AWS CLI commandes*.
### `promote-read-replica-db-cluster`
L'exemple de code suivant montre comment utiliser`promote-read-replica-db-cluster`.
**AWS CLI**
**Pour promouvoir un réplica en lecture de cluster de bases de données**
L’exemple `promote-read-replica-db-cluster` suivant promeut le réplica en lecture spécifié pour en faire un cluster de bases de données autonome.
```
aws rds promote-read-replica-db-cluster \
--db-cluster-identifier {{mydbcluster-1}}
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1c"
],
"BackupRetentionPeriod": 1,
"DatabaseName": "",
"DBClusterIdentifier": "mydbcluster-1",
...some output truncated...
}
}
```
Pour plus d’informations, consultez [Promotion d’un réplica en lecture en cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Replication.CrossRegion.html#AuroraMySQL.Replication.CrossRegion.Promote) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [PromoteReadReplicaDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/promote-read-replica-db-cluster.html)à la section *Référence des AWS CLI commandes*.
### `promote-read-replica`
L'exemple de code suivant montre comment utiliser`promote-read-replica`.
**AWS CLI**
**Pour promouvoir un réplica en lecture**
L’exemple `promote-read-replica` suivant promeut le réplica en lecture spécifié pour en faire une instance de base de données autonome.
```
aws rds promote-read-replica \
--db-instance-identifier {{test-instance-repl}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl",
"StorageType": "standard",
"ReadReplicaSourceDBInstanceIdentifier": "test-instance",
"DBInstanceStatus": "modifying",
...some output truncated...
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [PromoteReadReplica](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/promote-read-replica.html)à la section *Référence des AWS CLI commandes*.
### `purchase-reserved-db-instance`
L'exemple de code suivant montre comment utiliser`purchase-reserved-db-instance`.
**AWS CLI**
**Pour acheter une offre d’instance de base de données réservée**
L’exemple `purchase-reserved-db-instances-offering` suivant achète une offre d’instance de base de données réservée. L’`reserved-db-instances-offering-id` doit être un ID d’offre valide, tel que renvoyé par la commande `describe-reserved-db-instances-offering`.
aws rds purchase-reserved-db-instances -offering -- reserved-db-instances-offering -id 438012d3-4a52-4cc7-b2e3-8dff72e0e706
+ Pour plus de détails sur l'API, reportez-vous [PurchaseReservedDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/purchase-reserved-db-instance.html)à la section *Référence des AWS CLI commandes*.
### `purchase-reserved-db-instances-offerings`
L'exemple de code suivant montre comment utiliser`purchase-reserved-db-instances-offerings`.
**AWS CLI**
**Exemple 1 : pour rechercher une instance de base de données réservée à acheter**
L’exemple `describe-reserved-db-instances-offerings` suivant crée une liste des instances de base de données MySQL réservées disponibles avec la classe d’instance db.t2.micro et d’une durée d’un an. L’ID d’offre est requis pour acheter une instance de base de données réservée.
```
aws rds describe-reserved-db-instances-offerings \
--product-description {{mysql}} \
--db-instance-class {{db.t2.micro}} \
--duration {{1}}
```
Sortie :
```
{
"ReservedDBInstancesOfferings": [
{
"ReservedDBInstancesOfferingId": "8ba30be1-b9ec-447f-8f23-6114e3f4c7b4",
"DBInstanceClass": "db.t2.micro",
"Duration": 31536000,
"FixedPrice": 51.0,
"UsagePrice": 0.0,
"CurrencyCode": "USD",
"ProductDescription": "mysql",
"OfferingType": "Partial Upfront",
"MultiAZ": false,
"RecurringCharges": [
{
"RecurringChargeAmount": 0.006,
"RecurringChargeFrequency": "Hourly"
}
]
},
... some output truncated ...
]
}
```
Pour plus d’informations, consultez [Reserved DB Instances for Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) dans le *Guide de l’utilisateur Amazon RDS*.
**Exemple 2 : pour acheter une instance de base de données réservée**
L’exemple `purchase-reserved-db-instances-offering` suivant montre comment acheter l’offre d’instance de base de données réservée de l’exemple précédent.
aws rds purchase-reserved-db-instances -offering -- -id 8ba30be1-b9ec-447f-8f23-6114e3f4c7b4 reserved-db-instances-offering
Sortie :
```
{
"ReservedDBInstance": {
"ReservedDBInstanceId": "ri-2020-06-29-16-54-57-670",
"ReservedDBInstancesOfferingId": "8ba30be1-b9ec-447f-8f23-6114e3f4c7b4",
"DBInstanceClass": "db.t2.micro",
"StartTime": "2020-06-29T16:54:57.670Z",
"Duration": 31536000,
"FixedPrice": 51.0,
"UsagePrice": 0.0,
"CurrencyCode": "USD",
"DBInstanceCount": 1,
"ProductDescription": "mysql",
"OfferingType": "Partial Upfront",
"MultiAZ": false,
"State": "payment-pending",
"RecurringCharges": [
{
"RecurringChargeAmount": 0.006,
"RecurringChargeFrequency": "Hourly"
}
],
"ReservedDBInstanceArn": "arn:aws:rds:us-west-2:123456789012:ri:ri-2020-06-29-16-54-57-670"
}
}
```
Pour plus d’informations, consultez [Reserved DB Instances for Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [PurchaseReservedDbInstancesOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/purchase-reserved-db-instances-offerings.html)à la section *Référence des AWS CLI commandes*.
### `reboot-db-instance`
L'exemple de code suivant montre comment utiliser`reboot-db-instance`.
**AWS CLI**
**Pour redémarrer une instance de base de données**
L’exemple `reboot-db-instance` suivant lance un redémarrage de l’instance de base de données spécifiée.
```
aws rds reboot-db-instance \
--db-instance-identifier {{test-mysql-instance}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "test-mysql-instance",
"DBInstanceClass": "db.t3.micro",
"Engine": "mysql",
"DBInstanceStatus": "rebooting",
"MasterUsername": "admin",
"Endpoint": {
"Address": "test-mysql-instance.############.us-west-2.rds.amazonaws.com",
"Port": 3306,
"HostedZoneId": "Z1PVIF0EXAMPLE"
},
... output omitted...
}
}
```
Pour plus d’informations, consultez [Redémarrage d’une instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, voir [Reboot DBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reboot-db-instance.html) dans *AWS CLI la référence des commandes*.
### `reboot-db-shard-group`
L'exemple de code suivant montre comment utiliser`reboot-db-shard-group`.
**AWS CLI**
**Exemple 1 : pour redémarrer un groupe de partitions de base de données**
L’exemple `reboot-db-shard-group` suivant redémarre un groupe de partitions de base de données.
```
aws rds reboot-db-shard-group \
--db-shard-group-identifier {{my-db-shard-group}}
```
Sortie :
```
{
"DBShardGroups": [
{
"DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
"DBShardGroupIdentifier": "my-db-shard-group",
"DBClusterIdentifier": "my-sv2-cluster",
"MaxACU": 1000.0,
"ComputeRedundancy": 0,
"Status": "available",
"PubliclyAccessible": false,
"Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}
]
}
```
Pour plus d’informations, consultez [Redémarrage d’un cluster de bases de données Amazon Aurora ou d’une instance de base de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RebootCluster.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 2 : pour décrire les groupes de partitions de base de données**
L’exemple `describe-db-shard-groups` suivant extrait les détails sur vos groupes de partitions de base de données une fois que vous avez exécuté la commande `reboot-db-shard-group`. Le groupe de partitions de base de données `my-db-shard-group` est en train de redémarrer.
```
aws rds describe-db-shard-groups
```
Sortie :
```
{
"DBShardGroups": [
{
"DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
"DBShardGroupIdentifier": "limitless-test-shard-grp",
"DBClusterIdentifier": "limitless-test-cluster",
"MaxACU": 768.0,
"ComputeRedundancy": 0,
"Status": "available",
"PubliclyAccessible": true,
"Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
},
{
"DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
"DBShardGroupIdentifier": "my-db-shard-group",
"DBClusterIdentifier": "my-sv2-cluster",
"MaxACU": 1000.0,
"ComputeRedundancy": 0,
"Status": "rebooting",
"PubliclyAccessible": false,
"Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}
]
}
```
Pour plus d’informations, consultez [Redémarrage d’un cluster de bases de données Amazon Aurora ou d’une instance de base de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RebootCluster.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [RebootDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reboot-db-shard-group.html)à la section *Référence des AWS CLI commandes*.
### `register-db-proxy-targets`
L'exemple de code suivant montre comment utiliser`register-db-proxy-targets`.
**AWS CLI**
**Pour enregistrer un proxy de base de données auprès d’une base de données**
L’exemple `register-db-proxy-targets` suivant crée l’association entre une base de données et un proxy.
```
aws rds register-db-proxy-targets \
--db-proxy-name {{proxyExample}} \
--db-cluster-identifiers {{database-5}}
```
Sortie :
```
{
"DBProxyTargets": [
{
"RdsResourceId": "database-5",
"Port": 3306,
"Type": "TRACKED_CLUSTER",
"TargetHealth": {
"State": "REGISTERING"
}
},
{
"Endpoint": "database-5instance-1.ab0cd1efghij.us-east-1.rds.amazonaws.com",
"RdsResourceId": "database-5",
"Port": 3306,
"Type": "RDS_INSTANCE",
"TargetHealth": {
"State": "REGISTERING"
}
}
]
}
```
Pour plus d’informations, consultez [Création d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-creating) dans le *Guide de l’utilisateur Amazon RDS* et [Création d’un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-creating) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [RegisterDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/register-db-proxy-targets.html)à la section *Référence des AWS CLI commandes*.
### `remove-from-global-cluster`
L'exemple de code suivant montre comment utiliser`remove-from-global-cluster`.
**AWS CLI**
**Pour détacher un cluster Aurora secondaire d’un cluster de bases de données Aurora global**
L’exemple `remove-from-global-cluster` suivant détache un cluster Aurora secondaire d’un cluster de bases de données Aurora global. Le cluster passe d’un cluster en lecture seule à un cluster autonome doté d’une capacité de lecture-écriture.
```
aws rds remove-from-global-cluster \
--region {{us-west-2}} \
--global-cluster-identifier {{myglobalcluster}} \
--db-cluster-identifier {{arn:aws:rds:us-west-2:123456789012:cluster:DB-1}}
```
Sortie :
```
{
"GlobalCluster": {
"GlobalClusterIdentifier": "myglobalcluster",
"GlobalClusterResourceId": "cluster-abc123def456gh",
"GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
"Status": "available",
"Engine": "aurora-postgresql",
"EngineVersion": "10.11",
"StorageEncrypted": true,
"DeletionProtection": false,
"GlobalClusterMembers": [
{
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:js-global-cluster",
"Readers": [
"arn:aws:rds:us-west-2:123456789012:cluster:DB-1"
],
"IsWriter": true
},
{
"DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:DB-1",
"Readers": [],
"IsWriter": false,
"GlobalWriteForwardingStatus": "disabled"
}
]
}
}
```
Pour plus d’informations, consultez [Dissociation d’un cluster d’une base de données Amazon Aurora globale](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html#aurora-global-database-detaching) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [RemoveFromGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-from-global-cluster.html)à la section *Référence des AWS CLI commandes*.
### `remove-option-from-option-group`
L'exemple de code suivant montre comment utiliser`remove-option-from-option-group`.
**AWS CLI**
**Pour supprimer une option d’un groupe d’options**
L’exemple `remove-option-from-option-group` suivant supprime l’option `OEM` de `myoptiongroup`.
```
aws rds remove-option-from-option-group \
--option-group-name {{myoptiongroup}} \
--options {{OEM}} \
--apply-immediately
```
Sortie :
```
{
"OptionGroup": {
"OptionGroupName": "myoptiongroup",
"OptionGroupDescription": "Test",
"EngineName": "oracle-ee",
"MajorEngineVersion": "19",
"Options": [],
"AllowsVpcAndNonVpcInstanceMemberships": true,
"OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:myoptiongroup"
}
}
```
Pour plus d’informations, consultez [Suppression d’une option d’un groupe d’options](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.RemoveOption) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [RemoveOptionFromOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-option-from-option-group.html)à la section *Référence des AWS CLI commandes*.
### `remove-role-from-db-cluster`
L'exemple de code suivant montre comment utiliser`remove-role-from-db-cluster`.
**AWS CLI**
**Pour dissocier un rôle AWS Identity and Access Management (IAM) d'un cluster de bases de données**
L’exemple `remove-role-from-db-cluster` suivant supprime un rôle d’un cluster de bases de données.
```
aws rds remove-role-from-db-cluster \
--db-cluster-identifier {{mydbcluster}} \
--role-arn {{arn:aws:iam::123456789012:role/RDSLoadFromS3}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Association d’un rôle IAM à un cluster de bases de données Amazon Aurora MySQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.IAM.AddRoleToDBCluster.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [RemoveRoleFromDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-role-from-db-cluster.html)à la section *Référence des AWS CLI commandes*.
### `remove-role-from-db-instance`
L'exemple de code suivant montre comment utiliser`remove-role-from-db-instance`.
**AWS CLI**
**Pour dissocier un rôle AWS Identity and Access Management (IAM) d'une instance de base de données**
L’exemple `remove-role-from-db-instance` suivant supprime le rôle nommé `rds-s3-integration-role` d’une instance de base de données Oracle nommée `test-instance`.
```
aws rds remove-role-from-db-instance \
--db-instance-identifier {{test-instance}} \
--feature-name {{S3_INTEGRATION}} \
--role-arn {{arn:aws:iam::111122223333:role/rds-s3-integration-role}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Désactivation de l’intégration RDS SQL Server avec S3](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/User.SQLServer.Options.S3-integration.html#Appendix.SQLServer.Options.S3-integration.disabling) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [RemoveRoleFromDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-role-from-db-instance.html)à la section *Référence des AWS CLI commandes*.
### `remove-source-identifier-from-subscription`
L'exemple de code suivant montre comment utiliser`remove-source-identifier-from-subscription`.
**AWS CLI**
**Pour supprimer un identifiant source d’un abonnement**
L’exemple `remove-source-identifier` suivant supprime l’identifiant source spécifié d’un abonnement existant.
```
aws rds remove-source-identifier-from-subscription \
--subscription-name {{my-instance-events}} \
--source-identifier {{test-instance-repl}}
```
Sortie :
```
{
"EventSubscription": {
"EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
"SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
"EventCategoriesList": [
"backup",
"recovery"
],
"SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
"Status": "modifying",
"CustSubscriptionId": "my-instance-events",
"CustomerAwsId": "123456789012",
"SourceIdsList": [
"test-instance"
],
"SourceType": "db-instance",
"Enabled": false
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveSourceIdentifierFromSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-source-identifier-from-subscription.html)à la section *Référence des AWS CLI commandes*.
### `remove-tags-from-resource`
L'exemple de code suivant montre comment utiliser`remove-tags-from-resource`.
**AWS CLI**
**Pour supprimer des balises d’une ressource**
L’exemple `remove-tags-from-resource` suivant supprime des balises d’une ressource.
```
aws rds remove-tags-from-resource \
--resource-name {{arn:aws:rds:us-east-1:123456789012:db:mydbinstance}} \
--tag-keys {{Name}} {{Environment}}
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Balisage de ressources Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) dans le *Guide de l’utilisateur Amazon RDS* et [Balisage de ressources Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [RemoveTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-tags-from-resource.html)à la section *Référence des AWS CLI commandes*.
### `reset-db-cluster-parameter-group`
L'exemple de code suivant montre comment utiliser`reset-db-cluster-parameter-group`.
**AWS CLI**
**Exemple 1 : pour réinitialiser tous les paramètres à leurs valeurs par défaut**
L’exemple `reset-db-cluster-parameter-group` suivant réinitialise toutes les valeurs par défaut des paramètres d’un groupe de paramètres de cluster de bases de données créé par le client.
```
aws rds reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name {{mydbclpg}} \
--reset-all-parameters
```
Sortie :
```
{
"DBClusterParameterGroupName": "mydbclpg"
}
```
Pour plus d’informations, consultez [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 2 : pour réinitialiser des paramètres spécifiques à leurs valeurs par défaut**
L’exemple `reset-db-cluster-parameter-group` suivant réinitialise les valeurs par défaut des paramètres spécifiques dans un groupe de paramètres de cluster de bases de données créé par le client.
```
aws rds reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name {{mydbclpgy}} \
--parameters {{"ParameterName=max_connections,ApplyMethod=immediate"}} \
{{"ParameterName=max_allowed_packet,ApplyMethod=immediate"}}
```
Sortie :
```
{
"DBClusterParameterGroupName": "mydbclpg"
}
```
Pour plus d’informations, consultez [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ResetDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reset-db-cluster-parameter-group.html)à la section *Référence des AWS CLI commandes*.
### `reset-db-parameter-group`
L'exemple de code suivant montre comment utiliser`reset-db-parameter-group`.
**AWS CLI**
**Exemple 1 : pour réinitialiser tous les paramètres à leurs valeurs par défaut**
L’exemple `reset-db-parameter-group` suivant réinitialise toutes les valeurs par défaut des paramètres d’un groupe de paramètres de base de données créé par le client.
```
aws rds reset-db-parameter-group \
--db-parameter-group-name {{mypg}} \
--reset-all-parameters
```
Sortie :
```
{
"DBParameterGroupName": "mypg"
}
```
Pour plus d’informations, consultez [Utilisation des groupes de paramètres DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon RDS* et [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
**Exemple 2 : pour réinitialiser des paramètres spécifiques à leurs valeurs par défaut**
L’exemple `reset-db-parameter-group` suivant réinitialise les valeurs par défaut des paramètres spécifiques dans un groupe de paramètres de cluster de bases de données créé par le client.
```
aws rds reset-db-parameter-group \
--db-parameter-group-name {{mypg}} \
--parameters {{"ParameterName=max_connections,ApplyMethod=immediate"}} \
{{"ParameterName=max_allowed_packet,ApplyMethod=immediate"}}
```
Sortie :
```
{
"DBParameterGroupName": "mypg"
}
```
Pour plus d’informations, consultez [Utilisation des groupes de paramètres DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon RDS* et [Utilisation de groupes de paramètres de base de données et de groupes de paramètres de cluster de bases de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [ResetDbParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reset-db-parameter-group.html)à la section *Référence des AWS CLI commandes*.
### `restore-db-cluster-from-s3`
L'exemple de code suivant montre comment utiliser`restore-db-cluster-from-s3`.
**AWS CLI**
**Pour restaurer un cluster de bases de données Amazon Aurora à partir d’Amazon S3**
L’exemple `restore-db-cluster-from-s3` suivant restaure un cluster de bases de données compatible avec Amazon Aurora MySQL version 5.7 à partir d’un fichier de sauvegarde de base de données MySQL 5.7 dans Amazon S3.
```
aws rds restore-db-cluster-from-s3 \
--db-cluster-identifier {{cluster-s3-restore}} \
--engine {{aurora-mysql}} \
--master-username {{admin}} \
--master-user-password {{mypassword}} \
--s3-bucket-name {{amzn-s3-demo-bucket}} \
--s3-prefix {{test-backup}} \
--s3-ingestion-role-arn {{arn:aws:iam::123456789012:role/service-role/TestBackup}} \
--source-engine {{mysql}} \
--source-engine-version {{5.7.28}}
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-west-2c",
"us-west-2a",
"us-west-2b"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "cluster-s3-restore",
"DBClusterParameterGroup": "default.aurora-mysql5.7",
"DBSubnetGroup": "default",
"Status": "creating",
"Endpoint": "cluster-s3-restore.cluster-co3xyzabc123.us-west-2.rds.amazonaws.com",
"ReaderEndpoint": "cluster-s3-restore.cluster-ro-co3xyzabc123.us-west-2.rds.amazonaws.com",
"MultiAZ": false,
"Engine": "aurora-mysql",
"EngineVersion": "5.7.12",
"Port": 3306,
"MasterUsername": "admin",
"PreferredBackupWindow": "11:15-11:45",
"PreferredMaintenanceWindow": "thu:12:19-thu:12:49",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-########",
"Status": "active"
}
],
"HostedZoneId": "Z1PVIF0EXAMPLE",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-SU5THYQQHOWCXZZDGXREXAMPLE",
"DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:cluster-s3-restore",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2020-07-27T14:22:08.095Z",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": []
}
}
```
Pour plus d’informations, consultez [Migration des données à partir de MySQL à l’aide d’un compartiment Amazon S3](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Migrating.ExtMySQL.html#AuroraMySQL.Migrating.ExtMySQL.S3) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, consultez [RestoreDbClusterFromS3](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-from-s3.html) dans *AWS CLI Command Reference*.
### `restore-db-cluster-from-snapshot`
L'exemple de code suivant montre comment utiliser`restore-db-cluster-from-snapshot`.
**AWS CLI**
**Pour restaurer un cluster de bases de données à partir d’un instantané**
L’exemple `restore-db-cluster-from-snapshot` suivant restaure un cluster de bases de données Aurora PostgreSQL compatible avec PostgreSQL version 10.7 à partir d’un instantané de cluster de bases de données nommé `test-instance-snapshot`.
```
aws rds restore-db-cluster-from-snapshot \
--db-cluster-identifier {{newdbcluster}} \
--snapshot-identifier {{test-instance-snapshot}} \
--engine {{aurora-postgresql}} \
--engine-version {{10.7}}
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-west-2c",
"us-west-2a",
"us-west-2b"
],
"BackupRetentionPeriod": 7,
"DatabaseName": "",
"DBClusterIdentifier": "newdbcluster",
"DBClusterParameterGroup": "default.aurora-postgresql10",
"DBSubnetGroup": "default",
"Status": "creating",
"Endpoint": "newdbcluster.cluster-############.us-west-2.rds.amazonaws.com",
"ReaderEndpoint": "newdbcluster.cluster-ro-############.us-west-2.rds.amazonaws.com",
"MultiAZ": false,
"Engine": "aurora-postgresql",
"EngineVersion": "10.7",
"Port": 5432,
"MasterUsername": "postgres",
"PreferredBackupWindow": "09:33-10:03",
"PreferredMaintenanceWindow": "sun:12:22-sun:12:52",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-########",
"Status": "active"
}
],
"HostedZoneId": "Z1PVIF0EXAMPLE",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/287364e4-33e3-4755-a3b0-a1b2c3d4e5f6",
"DbClusterResourceId": "cluster-5DSB5IFQDDUVAWOUWM1EXAMPLE",
"DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:newdbcluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2020-06-05T15:06:58.634Z",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": []
}
}
```
Pour plus d’informations, consultez [Restauration à partir d’un instantané de cluster de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RestoreFromSnapshot.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [RestoreDbClusterFromSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-from-snapshot.html)à la section *Référence des AWS CLI commandes*.
### `restore-db-cluster-to-point-in-time`
L'exemple de code suivant montre comment utiliser`restore-db-cluster-to-point-in-time`.
**AWS CLI**
**Pour restaurer un cluster de bases de données à un moment spécifié**
L’exemple `restore-db-cluster-to-point-in-time` suivant restaure un cluster de bases de données nommé `database-4` à la date la plus récente possible. L’utilisation de `copy-on-write` comme type de restauration restaure le nouveau cluster de bases de données sous la forme d’un clone du cluster de bases de données source.
```
aws rds restore-db-cluster-to-point-in-time \
--source-db-cluster-identifier {{database-4}} \
--db-cluster-identifier {{sample-cluster-clone}} \
--restore-type {{copy-on-write}} \
--use-latest-restorable-time
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-west-2c",
"us-west-2a",
"us-west-2b"
],
"BackupRetentionPeriod": 7,
"DatabaseName": "",
"DBClusterIdentifier": "sample-cluster-clone",
"DBClusterParameterGroup": "default.aurora-postgresql10",
"DBSubnetGroup": "default",
"Status": "creating",
"Endpoint": "sample-cluster-clone.cluster-############.us-west-2.rds.amazonaws.com",
"ReaderEndpoint": "sample-cluster-clone.cluster-ro-############.us-west-2.rds.amazonaws.com",
"MultiAZ": false,
"Engine": "aurora-postgresql",
"EngineVersion": "10.7",
"Port": 5432,
"MasterUsername": "postgres",
"PreferredBackupWindow": "09:33-10:03",
"PreferredMaintenanceWindow": "sun:12:22-sun:12:52",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-########",
"Status": "active"
}
],
"HostedZoneId": "Z1PVIF0EXAMPLE",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/287364e4-33e3-4755-a3b0-a1b2c3d4e5f6",
"DbClusterResourceId": "cluster-BIZ77GDSA2XBSTNPFW1EXAMPLE",
"DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster-clone",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"CloneGroupId": "8d19331a-099a-45a4-b4aa-11aa22bb33cc44dd",
"ClusterCreateTime": "2020-03-10T19:57:38.967Z",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false
}
}
```
Pour plus d’informations, consultez [Restauration d’un cluster de base de données à une date définie](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PIT.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [RestoreDbClusterToPointInTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-to-point-in-time.html)à la section *Référence des AWS CLI commandes*.
### `restore-db-instance-from-db-snapshot`
L'exemple de code suivant montre comment utiliser`restore-db-instance-from-db-snapshot`.
**AWS CLI**
**Pour restaurer une instance de base de données à partir d’un instantané de base de données**
L’exemple `restore-db-instance-from-db-snapshot` crée une nouvelle instance de base de données nommée `db7-new-instance` avec la classe d’instance de base de données `db.t3.small` à partir de l’instantané de base de données spécifié. L’instance de base de données source à partir de laquelle l’instantané a été pris utilise une classe d’instance de base de données obsolète, vous ne pouvez donc pas la mettre à niveau.
```
aws rds restore-db-instance-from-db-snapshot \
--db-instance-identifier {{db7-new-instance}} \
--db-snapshot-identifier {{db7-test-snapshot}} \
--db-instance-class {{db.t3.small}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "db7-new-instance",
"DBInstanceClass": "db.t3.small",
"Engine": "mysql",
"DBInstanceStatus": "creating",
...output omitted...
"PreferredMaintenanceWindow": "mon:07:37-mon:08:07",
"PendingModifiedValues": {},
"MultiAZ": false,
"EngineVersion": "5.7.22",
"AutoMinorVersionUpgrade": true,
"ReadReplicaDBInstanceIdentifiers": [],
"LicenseModel": "general-public-license",
...output omitted...
"DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:db7-new-instance",
"IAMDatabaseAuthenticationEnabled": false,
"PerformanceInsightsEnabled": false,
"DeletionProtection": false,
"AssociatedRoles": []
}
}
```
Pour plus d’informations, consultez [Restauration à partir d’un instantané de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RestoreFromSnapshot.html) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [RestoreDbInstanceFromDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-from-db-snapshot.html)à la section *Référence des AWS CLI commandes*.
### `restore-db-instance-from-s3`
L'exemple de code suivant montre comment utiliser`restore-db-instance-from-s3`.
**AWS CLI**
**Pour restaurer une instance de base de données à partir d’une sauvegarde dans Amazon S3**
L’exemple `restore-db-instance-from-s3` suivant crée une nouvelle instance de base de données nommée `restored-test-instance` à partir d’une sauvegarde existante dans le compartiment S3 `my-backups`.
```
aws rds restore-db-instance-from-s3 \
--db-instance-identifier {{restored-test-instance}} \
--allocated-storage {{250}} --db-instance-class {{db.m4.large}} --engine {{mysql}} \
--{{master}}-username master --master-user-password {{secret99}} \
--s3-bucket-name {{my-backups}} --s3-ingestion-role-arn {{arn:aws:iam::123456789012:role/my-role}} \
--source-engine {{mysql}} --source-engine-version {{5.6.27}}
```
+ Pour plus de détails sur l'API, consultez [RestoreDbInstanceFromS3](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-from-s3.html) dans *AWS CLI Command Reference*.
### `restore-db-instance-to-point-in-time`
L'exemple de code suivant montre comment utiliser`restore-db-instance-to-point-in-time`.
**AWS CLI**
**Exemple 1 : pour restaurer une instance de base de données à une date donnée**
L’exemple `restore-db-instance-to-point-in-time` suivant restaure `test-instance` vers une nouvelle instance de base de données nommée `restored-test-instance` à la date spécifiée.
```
aws rds restore-db-instance-to-point-in-time \
--source-db-instance-identifier {{test-instance}} \
--target-db-instance {{restored-test-instance}} \
--restore-time {{2018-07-30T23:45:00.000Z}}
```
Sortie :
```
{
"DBInstance": {
"AllocatedStorage": 20,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:restored-test-instance",
"DBInstanceStatus": "creating",
"DBInstanceIdentifier": "restored-test-instance",
...some output omitted...
}
}
```
Pour plus d’informations, consultez [Restauration d’une instance de base de données à une date spécifiée](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIT.html) dans le *Guide de l’utilisateur Amazon RDS*.
**Exemple 2 : pour restaurer une instance de base de données à une heure spécifiée à partir d’une sauvegarde répliquée**
L’exemple `restore-db-instance-to-point-in-time` suivant restaure une instance de base de données Oracle à l’heure spécifiée à partir d’une sauvegarde automatique répliquée.
```
aws rds restore-db-instance-to-point-in-time \
--source-db-instance-automated-backups-arn {{"arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"}} \
--target-db-instance-identifier {{myorclinstance-from-replicated-backup}} \
--restore-time {{2020-12-08T18:45:00.000Z}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceIdentifier": "myorclinstance-from-replicated-backup",
"DBInstanceClass": "db.t3.micro",
"Engine": "oracle-se2",
"DBInstanceStatus": "creating",
"MasterUsername": "admin",
"DBName": "ORCL",
"AllocatedStorage": 20,
"PreferredBackupWindow": "07:45-08:15",
"BackupRetentionPeriod": 14,
... some output omitted ...
"DbiResourceId": "db-KGLXG75BGVIWKQT7NQ4EXAMPLE",
"CACertificateIdentifier": "rds-ca-2019",
"DomainMemberships": [],
"CopyTagsToSnapshot": false,
"MonitoringInterval": 0,
"DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:myorclinstance-from-replicated-backup",
"IAMDatabaseAuthenticationEnabled": false,
"PerformanceInsightsEnabled": false,
"DeletionProtection": false,
"AssociatedRoles": [],
"TagList": []
}
}
```
Pour plus d’informations, consultez [Restauration à une heure spécifiée à partir d’une sauvegarde répliquée](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.PiTR) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [RestoreDbInstanceToPointInTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-to-point-in-time.html)à la section *Référence des AWS CLI commandes*.
### `start-activity-stream`
L'exemple de code suivant montre comment utiliser`start-activity-stream`.
**AWS CLI**
**Pour démarrer un flux d’activité de base de données**
L'`start-activity-stream`exemple suivant démarre un flux d'activité asynchrone pour surveiller un cluster Aurora nommé. my-pg-cluster
```
aws rds start-activity-stream \
--region {{us-east-1}} \
--mode {{async}} \
--kms-key-id {{arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1}} \
--resource-arn {{arn:aws:rds:us-east-1:1234567890123:cluster:my-pg-cluster}} \
--apply-immediately
```
Sortie :
```
{
"KmsKeyId": "arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1",
"KinesisStreamName": "aws-rds-das-cluster-0ABCDEFGHI1JKLM2NOPQ3R4S",
"Status": "starting",
"Mode": "async",
"ApplyImmediately": true
}
```
Pour plus d’informations, consultez [Démarrage d’un flux d’activité de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/DBActivityStreams.html#DBActivityStreams.Enabling) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [StartActivityStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-activity-stream.html)à la section *Référence des AWS CLI commandes*.
### `start-db-cluster`
L'exemple de code suivant montre comment utiliser`start-db-cluster`.
**AWS CLI**
**Pour démarrer un cluster de bases de données**
L’exemple `start-db-cluster` suivant démarre un cluster de bases de données et ses instances de base de données.
```
aws rds start-db-cluster \
--db-cluster-identifier {{mydbcluster}}
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1a",
"us-east-1e",
"us-east-1b"
],
"BackupRetentionPeriod": 1,
"DatabaseName": "mydb",
"DBClusterIdentifier": "mydbcluster",
...some output truncated...
}
}
```
Pour plus d’informations, consultez [Arrêt et démarrage d’un cluster de bases de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-cluster-stop-start.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [StartDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-cluster.html)à la section *Référence des AWS CLI commandes*.
### `start-db-instance-automated-backups-replication`
L'exemple de code suivant montre comment utiliser`start-db-instance-automated-backups-replication`.
**AWS CLI**
**Pour activer les sauvegardes automatiques entre régions**
L’exemple `start-db-instance-automated-backups-replication` suivant réplique les sauvegardes automatiques d’une instance de base de données de la région USA Est (Virginie du Nord) vers la région USA Ouest (Oregon). La période de conservation des sauvegardes est de 14 jours.
```
aws rds start-db-instance-automated-backups-replication \
--region {{us-west-2}} \
--source-db-instance-arn {{"arn:aws:rds:us-east-1:123456789012:db:new-orcl-db"}} \
--backup-retention-period {{14}}
```
Sortie :
```
{
"DBInstanceAutomatedBackup": {
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
"DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
"Region": "us-east-1",
"DBInstanceIdentifier": "new-orcl-db",
"RestoreWindow": {},
"AllocatedStorage": 20,
"Status": "pending",
"Port": 1521,
"InstanceCreateTime": "2020-12-04T15:28:31Z",
"MasterUsername": "admin",
"Engine": "oracle-se2",
"EngineVersion": "12.1.0.2.v21",
"LicenseModel": "bring-your-own-license",
"OptionGroupName": "default:oracle-se2-12-1",
"Encrypted": false,
"StorageType": "gp2",
"IAMDatabaseAuthenticationEnabled": false,
"BackupRetentionPeriod": 14,
"DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
}
}
```
Pour plus d’informations, consultez [Activation des sauvegardes automatiques entre régions](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Enable) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [StartDbInstanceAutomatedBackupsReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-instance-automated-backups-replication.html)à la section *Référence des AWS CLI commandes*.
### `start-db-instance`
L'exemple de code suivant montre comment utiliser`start-db-instance`.
**AWS CLI**
**Pour démarrer une instance de base de données**
L’exemple `start-db-instance` suivant démarre l’instance de base de données spécifiée.
```
aws rds start-db-instance \
--db-instance-identifier {{test-instance}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceStatus": "starting",
...some output truncated...
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [StartDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-instance.html)à la section *Référence des AWS CLI commandes*.
### `start-export-task`
L'exemple de code suivant montre comment utiliser`start-export-task`.
**AWS CLI**
**Pour exporter un instantané vers Amazon S3**
L’exemple `start-export-task` suivant exporte un instantané de base de données nommé `db5-snapshot-test` dans le compartiment Amazon S3 nommé `amzn-s3-demo-bucket`.
```
aws rds start-export-task \
--export-task-identifier {{my-s3-export}} \
--source-arn {{arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test}} \
--s3-bucket-name {{amzn-s3-demo-bucket}} \
--iam-role-arn {{arn:aws:iam::123456789012:role/service-role/ExportRole}} \
--kms-key-id {{arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff}}
```
Sortie :
```
{
"ExportTaskIdentifier": "my-s3-export",
"SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test",
"SnapshotTime": "2020-03-27T20:48:42.023Z",
"S3Bucket": "amzn-s3-demo-bucket",
"IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
"Status": "STARTING",
"PercentProgress": 0,
"TotalExtractedDataInGB": 0
}
```
Pour plus d’informations, consultez [Exportation d’un instantané vers un compartiment Amazon S3](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Exporting) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [StartExportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-export-task.html)à la section *Référence des AWS CLI commandes*.
### `stop-activity-stream`
L'exemple de code suivant montre comment utiliser`stop-activity-stream`.
**AWS CLI**
**Pour arrêter un flux d’activité de base de données**
L'`stop-activity-stream`exemple suivant arrête un flux d'activité dans un cluster Aurora nommé my-pg-cluster.
```
aws rds stop-activity-stream \
--region {{us-east-1}} \
--resource-arn {{arn:aws:rds:us-east-1:1234567890123:cluster:my-pg-cluster}} \
--apply-immediately
```
Sortie :
```
{
"KmsKeyId": "arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1",
"KinesisStreamName": "aws-rds-das-cluster-0ABCDEFGHI1JKLM2NOPQ3R4S",
"Status": "stopping"
}
```
Pour plus d’informations, consultez [Arrêt d’un flux d’activité](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/DBActivityStreams.html#DBActivityStreams.Disabling) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [StopActivityStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-activity-stream.html)à la section *Référence des AWS CLI commandes*.
### `stop-db-cluster`
L'exemple de code suivant montre comment utiliser`stop-db-cluster`.
**AWS CLI**
**Pour arrêter un cluster de bases de données**
L’exemple `stop-db-cluster` suivant arrête un cluster de bases de données et ses instances de base de données.
```
aws rds stop-db-cluster \
--db-cluster-identifier {{mydbcluster}}
```
Sortie :
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1a",
"us-east-1e",
"us-east-1b"
],
"BackupRetentionPeriod": 1,
"DatabaseName": "mydb",
"DBClusterIdentifier": "mydbcluster",
...some output truncated...
}
}
```
Pour plus d’informations, consultez [Arrêt et démarrage d’un cluster de bases de données Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-cluster-stop-start.html) dans le *Guide de l’utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [StopDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-cluster.html)à la section *Référence des AWS CLI commandes*.
### `stop-db-instance-automated-backups-replication`
L'exemple de code suivant montre comment utiliser`stop-db-instance-automated-backups-replication`.
**AWS CLI**
**Pour arrêter la réplication des sauvegardes automatisées**
`stop-db-instance-automated-backups-replication` ci-dessous met fin à la réplication des sauvegardes automatiques dans la région USA Ouest (Oregon). Les sauvegardes répliquées sont retenues conformément à la période de rétention des sauvegardes définie.
```
aws rds stop-db-instance-automated-backups-replication \
--region {{us-west-2}} \
--source-db-instance-arn {{"arn:aws:rds:us-east-1:123456789012:db:new-orcl-db"}}
```
Sortie :
```
{
"DBInstanceAutomatedBackup": {
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
"DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
"Region": "us-east-1",
"DBInstanceIdentifier": "new-orcl-db",
"RestoreWindow": {
"EarliestTime": "2020-12-04T23:13:21.030Z",
"LatestTime": "2020-12-07T19:59:57Z"
},
"AllocatedStorage": 20,
"Status": "replicating",
"Port": 1521,
"InstanceCreateTime": "2020-12-04T15:28:31Z",
"MasterUsername": "admin",
"Engine": "oracle-se2",
"EngineVersion": "12.1.0.2.v21",
"LicenseModel": "bring-your-own-license",
"OptionGroupName": "default:oracle-se2-12-1",
"Encrypted": false,
"StorageType": "gp2",
"IAMDatabaseAuthenticationEnabled": false,
"BackupRetentionPeriod": 7,
"DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
}
}
```
Pour plus d’informations, consultez [Arrêt de la réplication des sauvegardes automatiques](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.StopReplicating) dans le *Guide de l’utilisateur Amazon RDS*.
+ Pour plus de détails sur l'API, reportez-vous [StopDbInstanceAutomatedBackupsReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-instance-automated-backups-replication.html)à la section *Référence des AWS CLI commandes*.
### `stop-db-instance`
L'exemple de code suivant montre comment utiliser`stop-db-instance`.
**AWS CLI**
**Pour arrêter une instance de base de données**
L’exemple `stop-db-instance` suivant arrête l’instance de base de données spécifiée.
```
aws rds stop-db-instance \
--db-instance-identifier {{test-instance}}
```
Sortie :
```
{
"DBInstance": {
"DBInstanceStatus": "stopping",
...some output truncated...
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [StopDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-instance.html)à la section *Référence des AWS CLI commandes*.
### `switchover-blue-green-deployment`
L'exemple de code suivant montre comment utiliser`switchover-blue-green-deployment`.
**AWS CLI**
**Exemple 1 : pour changer de blue/green déploiement pour une instance de base de données RDS**
L’exemple `switchover-blue-green-deployment` suivant promeut l’environnement vert spécifié en tant que nouvel environnement de production.
```
aws rds switchover-blue-green-deployment \
--blue-green-deployment-identifier {{bgd-wi89nwzglccsfake}} \
--switchover-timeout {{300}}
```
Sortie :
```
{
"BlueGreenDeployment": {
"BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
"BlueGreenDeploymentName": "bgd-cli-test-instance",
"Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-blhi1e",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-blhi1e",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-k5fv7u",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ggsh8m",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-o2vwm0",
"Status": "AVAILABLE"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CONFIGURE_BACKUPS",
"Status": "COMPLETED"
},
{
"Name": "CREATING_TOPOLOGY_OF_SOURCE",
"Status": "COMPLETED"
}
],
"Status": "SWITCHOVER_IN_PROGRESS",
"CreateTime": "2022-02-25T22:33:22.225000+00:00"
}
}
```
Pour plus d'informations, consultez la section [Changer de blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-switching.html) dans le *guide de l'utilisateur Amazon RDS*.
**Exemple 2 : Pour promouvoir un blue/green déploiement pour un cluster de bases de données Aurora MySQL**
L’exemple `switchover-blue-green-deployment` suivant promeut l’environnement vert spécifié en tant que nouvel environnement de production.
```
aws rds switchover-blue-green-deployment \
--blue-green-deployment-identifier {{bgd-wi89nwzglccsfake}} \
--switchover-timeout {{300}}
```
Sortie :
```
{
"BlueGreenDeployment": {
"BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
"BlueGreenDeploymentName": "my-blue-green-deployment",
"Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3ud8z6",
"SwitchoverDetails": [
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3ud8z6",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-bvxc73",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-7wc4ie",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-p4xxkz",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-np1ikl",
"Status": "AVAILABLE"
},
{
"SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
"TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-miszlf",
"Status": "AVAILABLE"
}
],
"Tasks": [
{
"Name": "CREATING_READ_REPLICA_OF_SOURCE",
"Status": "COMPLETED"
},
{
"Name": "DB_ENGINE_VERSION_UPGRADE",
"Status": "COMPLETED"
},
{
"Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
"Status": "COMPLETED"
},
{
"Name": "CREATE_CUSTOM_ENDPOINTS",
"Status": "COMPLETED"
}
],
"Status": "SWITCHOVER_IN_PROGRESS",
"CreateTime": "2022-02-25T22:38:49.522000+00:00"
}
}
```
Pour plus d'informations, consultez la section [Changer de blue/green déploiement](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-switching.html) dans le *guide de l'utilisateur Amazon Aurora*.
+ Pour plus de détails sur l'API, reportez-vous [SwitchoverBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/switchover-blue-green-deployment.html)à la section *Référence des AWS CLI commandes*.