# Ejemplos de Amazon RDS usando AWS CLI
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Amazon RDS.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `add-option-to-option-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-option-to-option-group`.
**AWS CLI**
**Para agregar una opción a un grupo de opción**
El siguiente ejemplo de `add-option-to-option-group` agrega una opción a un grupo de opción especificado.
```
aws rds add-option-to-option-group \
--option-group-name myoptiongroup \
--options OptionName=OEM,Port=5500,DBSecurityGroupMemberships=default \
--apply-immediately
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Agregar una opción a un grupo de opciones](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.AddOption) en la *Guía del usuario de Amazon RDS*.
+ Para obtener detalles de la API, consulte [AddOptionToOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-option-to-option-group.html) en la *Referencia de comandos de la AWS CLI*.
### `add-role-to-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-role-to-db-cluster`.
**AWS CLI**
**Para asociar un rol de AWS Identity and Access Management (IAM) con un clúster de base de datos**
El siguiente ejemplo de `add-role-to-db-cluster` asocia un rol con un clúster de base de datos.
```
aws rds add-role-to-db-cluster \
--db-cluster-identifier mydbcluster \
--role-arn arn:aws:iam::123456789012:role/RDSLoadFromS3
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Asociación de un rol de IAM con un clúster de base de datos Amazon Aurora MySQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.IAM.AddRoleToDBCluster.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [AddRoleToDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-role-to-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `add-role-to-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-role-to-db-instance`.
**AWS CLI**
**Para asociar un rol de AWS Identity and Access Management (IAM) con una instancia de base de datos**
El siguiente ejemplo de `add-role-to-db-instance` agrega el rol a una instancia de base de datos de Oracle denominada `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
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Prerequisites for Amazon RDS Oracle Integration with Amazon S3](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-s3-integration.html#oracle-s3-integration.preparing) en la *Guía del usuario de Amazon RDS*.
+ Para obtener detalles sobre la API, consulte [AddRoleToDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-role-to-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `add-source-identifier-to-subscription`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-source-identifier-to-subscription`.
**AWS CLI**
**Para agregar un identificador de origen a una suscripción**
El siguiente ejemplo de `add-source-identifier` agrega otro identificador de origen a una suscripción existente.
```
aws rds add-source-identifier-to-subscription \
--subscription-name my-instance-events \
--source-identifier test-instance-repl
```
Salida:
```
{
"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"
]
}
}
```
+ Para obtener información sobre la API, consulte [AddSourceIdentifierToSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-source-identifier-to-subscription.html) en la *Referencia de comandos de la AWS CLI*.
### `add-tags-to-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-tags-to-resource`.
**AWS CLI**
**Para agregar etiquetas a un recurso**
En el siguiente ejemplo de `add-tags-to-resource` se agregan etiquetas a una base de datos de 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\"}]"
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Etiquetado de los recursos de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [AddTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/add-tags-to-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `apply-pending-maintenance-action`
En el siguiente ejemplo de código, se muestra cómo utilizar `apply-pending-maintenance-action`.
**AWS CLI**
**Para aplicar acciones de mantenimiento pendientes**
El siguiente ejemplo de `apply-pending-maintenance-action` aplica las acciones de mantenimiento pendientes para un clúster de base de datos.
```
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
```
Salida:
```
{
"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"
}
]
}
}
```
Para obtener más información, consulte [Mantenimiento de una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html) en la *Guía del usuario de Amazon RDS* y [Mantenimiento de un clúster de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [ApplyPendingMaintenanceAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/apply-pending-maintenance-action.html) en la *Referencia de comandos de la AWS CLI*.
### `authorize-db-security-group-ingress`
En el siguiente ejemplo de código, se muestra cómo utilizar `authorize-db-security-group-ingress`.
**AWS CLI**
**Para asociar un rol de AWS Identity and Access Management (IAM) con una instancia de base de datos**
En el siguiente ejemplo de `authorize-db-security-group-ingress`, se configura el grupo de seguridad predeterminado con una regla de entrada para el rango de IP CIDR 192.0.2.0/24.
```
aws rds authorize-db-security-group-ingress \
--db-security-group-name default \
--cidrip 192.0.2.0/24
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Authorizing Network Access to a DB Security Group from an IP Range](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html#USER_WorkingWithSecurityGroups.Authorizing) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [AuthorizeDbSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/authorize-db-security-group-ingress.html) en la *Referencia de comandos de la AWS CLI*.
### `backtrack-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `backtrack-db-cluster`.
**AWS CLI**
**Para buscar datos anteriores en un clúster de base de datos de Aurora**
El siguiente ejemplo de `backtrack-db-cluster` realiza una búsqueda de datos anteriores en el clúster de base de datos sample-cluster hasta el 19 de marzo de 2018 a las 10:00 horas.
```
aws rds backtrack-db-cluster --db-cluster-identifier sample-cluster --backtrack-to 2018-03-19T10:00:00+00:00
```
Este comando genera un bloque JSON que reconoce el cambio en el recurso de RDS.
+ Para obtener información sobre la API, consulte [BacktrackDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/backtrack-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `cancel-export-task`
En el siguiente ejemplo de código, se muestra cómo utilizar `cancel-export-task`.
**AWS CLI**
**Para cancelar una exportación de instantánea a Amazon S3**
El siguiente ejemplo de `cancel-export-task` cancela una tarea de exportación en curso que exporta una instantánea a Amazon S3.
```
aws rds cancel-export-task \
--export-task-identifier my-s3-export-1
```
Salida:
```
{
"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
}
```
Para obtener más información, consulte [Canceling a snapshot export task](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Canceling) en la *Guía del usuario de Amazon RDS* o [Canceling a snapshot export task](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Canceling) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [CancelExportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/cancel-export-task.html) en la *Referencia de comandos de la AWS CLI*.
### `copy-db-cluster-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `copy-db-cluster-parameter-group`.
**AWS CLI**
**Para copiar un grupo de parámetros del clúster de una base de datos**
En el siguiente ejemplo de `copy-db-cluster-parameter-group`, se realiza una copia de un grupo de parámetros de clúster de una base de datos.
```
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"
```
Salida:
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "mydbclusterpgcopy",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy",
"DBParameterGroupFamily": "aurora-mysql5.7",
"Description": "Copy of mydbclusterpg parameter group"
}
}
```
Para obtener más información, consulte [Copying a DB Cluster Parameter Group](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.CopyingCluster) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [CopyDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-cluster-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `copy-db-cluster-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `copy-db-cluster-snapshot`.
**AWS CLI**
**Para copiar una instantánea de clúster de base de datos**
En el siguiente ejemplo de `copy-db-cluster-snapshot`, se crea una copia de una instantánea de un clúster de base de datos, incluidas sus etiquetas.
```
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
```
Salida:
```
{
"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
}
}
```
Para obtener más información, consulte [Copying a Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CopySnapshot.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [CopyDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-cluster-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `copy-db-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `copy-db-parameter-group`.
**AWS CLI**
**Para copiar un grupo de parámetros del clúster de una base de datos**
En el siguiente ejemplo de `copy-db-parameter-group`, se crea un grupo de parámetros de base de datos.
```
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"
```
Salida:
```
{
"DBParameterGroup": {
"DBParameterGroupName": "mydbpgcopy",
"DBParameterGroupArn": "arn:aws:rds:us-east-1:814387698303:pg:mydbpgcopy",
"DBParameterGroupFamily": "mysql5.7",
"Description": "Copy of mydbpg parameter group"
}
}
```
Para obtener más información, consulte [Copying a DB Parameter Group](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Copying) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [CopyDbParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `copy-db-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `copy-db-snapshot`.
**AWS CLI**
**Para copiar la instantánea de una base de datos**
El siguiente ejemplo de `copy-db-snapshot` crea la copia de una instantánea de una base de datos.
```
aws rds copy-db-snapshot \
--source-db-snapshot-identifier rds:database-mysql-2019-06-06-08-38
--target-db-snapshot-identifier mydbsnapshotcopy
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Copying a Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [CopyDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-db-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `copy-option-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `copy-option-group`.
**AWS CLI**
**Para copiar un grupo de opciones**
En el siguiente ejemplo de `copy-option-group`, se realiza una copia de un grupo de opciones.
```
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"
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Copia de un grupo de opciones](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.Copy) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [CopyOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/copy-option-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-blue-green-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-blue-green-deployment`.
**AWS CLI**
**Ejemplo 1: crear una implementación azul/verde para un RDS en una instancia de base de datos de MySQL DB**
En el siguiente ejemplo de `create-blue-green-deployment`, se crea una implementación azul/verde para una instancia de base de datos de 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
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Creación de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-creating.html) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: crear una implementación azul/verde para un clúster de base de datos en Aurora MySQL**
En el siguiente ejemplo de `create-blue-green-deployment`, se crea una implementación azul/verde para un clúster de base de datos de 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
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Creación de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-creating.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [CreateBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-blue-green-deployment.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-cluster-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-cluster-endpoint`.
**AWS CLI**
**Para crear un punto de conexión de clúster de base de datos personalizado**
El siguiente ejemplo de `create-db-cluster-endpoint` crea un punto de conexión de clúster de base de datos personalizado y lo asocia a un clúster de base de datos Aurora especificado.
```
aws rds create-db-cluster-endpoint \
--db-cluster-endpoint-identifier mycustomendpoint \
--endpoint-type reader \
--db-cluster-identifier mydbcluster \
--static-members dbinstance1 dbinstance2
```
Salida:
```
{
"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"
}
```
Para obtener más información, consulte [Amazon Aurora Connection Management](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [CreateDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-cluster-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-cluster-parameter-group`.
**AWS CLI**
**Para crear un grupo de parámetros de clúster de base de datos**
En el siguiente ejemplo de `create-db-cluster-parameter-group`, se crea un grupo de parámetros de clúster de base de datos.
```
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"
```
Salida:
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "mydbclusterparametergroup",
"DBParameterGroupFamily": "aurora5.6",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
}
}
```
Para obtener más información, consulte [Creating a DB Cluster Parameter Group](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.CreatingCluster) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [CreateDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-cluster-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-cluster-snapshot`.
**AWS CLI**
**Para crear una instantánea de clúster de base de datos**
En el siguiente ejemplo de `create-db-cluster-snapshot`, se crea una instantánea de clúster de base de datos.
```
aws rds create-db-cluster-snapshot \
--db-cluster-identifier mydbcluster \
--db-cluster-snapshot-identifier mydbclustersnapshot
```
Salida:
```
{
"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
}
}
```
Para obtener más información, consulte [Creación de una instantánea de clúster de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CreateSnapshotCluster.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [CreateDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-cluster`.
**AWS CLI**
**Ejemplo 1: crear un clúster de base de datos compatible con MySQL 5.7**
En el siguiente ejemplo de `create-db-cluster`, se crea un clúster de base de datos compatible con MySQL 5.7 con la versión predeterminada del motor. Reemplace la contraseña de muestra `secret99` con una contraseña segura. Cuando usa la consola para crear un clúster de base de datos, Amazon RDS crea automáticamente la instancia de base de datos de escritura para el clúster de base de datos. Sin embargo, cuando usa la CLI de AWS para crear un clúster de base de datos, debe crear expresamente la instancia de base de datos escritura para su clúster de base de datos mediante el comando de la CLI `create-db-instance` AWS.
```
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
```
Salida:
```
{
"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
}
}
```
**Ejemplo 2: crear un clúster de base de datos compatible con PostgreSQL**
En el siguiente ejemplo de `create-db-cluster`, se crea un clúster de base de datos compatible con PostgreSQL con la versión predeterminada del motor. Reemplace la contraseña de ejemplo `secret99` con una contraseña segura. Cuando usa la consola para crear un clúster de base de datos, Amazon RDS crea automáticamente la instancia de base de datos de escritura para el clúster de base de datos. Sin embargo, cuando usa la CLI de AWS para crear un clúster de base de datos, debe crear expresamente la instancia de base de datos escritura para su clúster de base de datos mediante el comando de la CLI `create-db-instance` AWS.
```
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
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Creación de un clúster de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [CreateDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-instance-read-replica`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-instance-read-replica`.
**AWS CLI**
**Para crear una réplica de lectura de una instancia de base de datos**
En este ejemplo, se crea una réplica de lectura de una instancia de base de datos existente denominada `test-instance`. La réplica de lectura denominada `test-instance-repl`.
```
aws rds create-db-instance-read-replica \
--db-instance-identifier test-instance-repl \
--source-db-instance-identifier test-instance
```
Salida:
```
{
"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...
}
}
```
+ Para obtener información sobre la API, consulte [CreateDbInstanceReadReplica](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-instance-read-replica.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-instance`.
**AWS CLI**
**Creación de una instancia de base de datos**
En el siguiente ejemplo `create-db-instance`, se utilizan las opciones necesarias para lanzar una nueva instancia de base de datos.
```
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
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Creación de una instancia de base de datos de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [CreateDBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-parameter-group`.
**AWS CLI**
**Creación de un grupo de parámetros de base de datos**
En el siguiente ejemplo `create-db-parameter-group`, se crea un grupo de parámetros de base de datos.
```
aws rds create-db-parameter-group \
--db-parameter-group-name mydbparametergroup \
--db-parameter-group-family MySQL5.6 \
--description "My new parameter group"
```
Salida:
```
{
"DBParameterGroup": {
"DBParameterGroupName": "mydbparametergroup",
"DBParameterGroupFamily": "mysql5.6",
"Description": "My new parameter group",
"DBParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:pg:mydbparametergroup"
}
}
```
Para obtener más información, consulte [Creación de un grupo de parámetros de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Creating) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [CreateDBParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-proxy-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-proxy-endpoint`.
**AWS CLI**
**Para crear un punto de conexión de proxy de base de datos para una base de datos de RDS**
En el siguiente ejemplo de `create-db-proxy-endpoint`, se crea un punto de conexión de proxy de base de datos.
```
aws rds create-db-proxy-endpoint \
--db-proxy-name proxyExample \
--db-proxy-endpoint-name "proxyep1" \
--vpc-subnet-ids subnetgroup1 subnetgroup2
```
Salida:
```
{
"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
}
}
```
Para obtener más información, consulte [Creating a proxy endpoint](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.CreatingEndpoint) en la *Guía del usuario de Amazon RDS* y [Creating a proxy endpoint](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.CreatingEndpoint) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [CreateDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-proxy-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-proxy`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-proxy`.
**AWS CLI**
**Para crear un proxy de base de datos para una base de datos de RDS**
En el siguiente ejemplo de `create-db-proxy`, se crea un proxy de base de datos.
```
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
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Creación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-creating) en la *Guía del usuario de Amazon RDS* y [Creación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-creating) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [CreateDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-proxy.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-security-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-security-group`.
**AWS CLI**
**Para crear un grupo de seguridad de base de datos de Amazon RDS**
El siguiente comando `create-db-security-group` crea un nuevo grupo de seguridad de base de datos de Amazon RDS:
```
aws rds create-db-security-group --db-security-group-name mysecgroup --db-security-group-description "My Test Security Group"
```
En el ejemplo, el nuevo grupo de seguridad de base de datos recibe el nombre `mysecgroup` y tiene una descripción.
Salida:
```
{
"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"
}
}
```
+ Para obtener información sobre la API, consulte [CreateDbSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-security-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-shard-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-shard-group`.
**AWS CLI**
**Ejemplo 1: crear un clúster de base de datos principal en Aurora PostgreSQL**
En el siguiente ejemplo de `create-db-cluster`, se crea un clúster de base de datos principal de SQL en Aurora PostgreSQL que es compatible con Aurora sin servidor versión 2 y 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
```
Salida:
```
{
"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
}
}
}
```
**Ejemplo 2: crear la instancia de base de datos principal (de escritura)**
En el siguiente ejemplo de `create-db-instance`, se crea una instancia de base de datos principal (de escritura) en Aurora sin servidor versión 2. Cuando usa la consola para crear un clúster de base de datos, Amazon RDS crea automáticamente la instancia de base de datos de escritura para el clúster de base de datos. Sin embargo, cuando usa la CLI de AWS para crear un clúster de base de datos, debe crear expresamente la instancia de base de datos escritura para su clúster de base de datos mediante el comando de la CLI `create-db-instance` AWS.
```
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
```
Salida:
```
{
"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
}
}
```
**Ejemplo 3: crear el grupo de partición de base de datos**
En el siguiente ejemplo de `create-db-shard-group`, se crea un grupo de partición de base de datos en el clúster de base de datos principal de 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
```
Salida:
```
{
"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"
}
```
Para obtener más información, consulte [Uso de Aurora Serverless v2](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [CreateDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-shard-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-snapshot`.
**AWS CLI**
**Creación de una instantánea de base de datos**
En el siguiente ejemplo `create-db-snapshot`, se crea una instantánea de base de datos.
```
aws rds create-db-snapshot \
--db-instance-identifier database-mysql \
--db-snapshot-identifier mydbsnapshot
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Creación de una instantánea de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [CreateDBSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `create-db-subnet-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-db-subnet-group`.
**AWS CLI**
**Para crear un grupo de subredes de base de datos**
En el siguiente ejemplo de `create-db-subnet-group`, se crea un grupo de subredes de base de datos denominado `mysubnetgroup` utilizando las subredes existentes.
```
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"]'
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Creación de una instancia de base de datos en una VPC](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.InstanceInVPC) en la *Guía del usuario de Amazon RDS*.
+ Para obtener detalles sobre la API, consulte [CreateDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-subnet-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-event-subscription`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-event-subscription`.
**AWS CLI**
**Para crear una suscripción de evento**
En el siguiente ejemplo de `create-event-subscription`, se crea una suscripción para eventos de copia de seguridad y recuperación de instancias de base de datos en la cuenta de AWS actual. Las notificaciones se envían a un tema de Amazon Simple Notification Service, especificado por `--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
```
Salida:
```
{
"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
}
}
```
+ Para obtener detalles sobre la API, consulte [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-event-subscription.html) en la *Referencia de comandos de la AWS CLI*.
### `create-global-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-global-cluster`.
**AWS CLI**
**Para crear un clúster de base de datos global**
En el siguiente ejemplo de `create-global-cluster`, se crea un nuevo clúster de base de datos global compatible con Aurora MySQL.
```
aws rds create-global-cluster \
--global-cluster-identifier myglobalcluster \
--engine aurora-mysql
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Creating an Aurora global database](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-getting-started.html#aurora-global-database-creating) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [CreateGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-global-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `create-option-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-option-group`.
**AWS CLI**
**Para crear un grupo de opción de Amazon RDS**
El siguiente comando `create-option-group` crea un nuevo grupo de opciones de Amazon RDS para la versión de `Oracle Enterprise Edition` `11.2`, is named ``MyOptionGroup` e incluye una descripción.
```
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"
```
Salida:
```
{
"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"
}
}
```
+ Para obtener información sobre la API, consulte [CreateOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-option-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-blue-green-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-blue-green-deployment`.
**AWS CLI**
**Ejemplo 1: eliminar recursos en un entorno verde de una instancia de base de datos de RDS para MySQL**
El siguiente ejemplo de `delete-blue-green-deployment` elimina los recursos de un entorno verde para un RDS de una instancia de base de datos en MySQL.
```
aws rds delete-blue-green-deployment \
--blue-green-deployment-identifier bgd-v53303651eexfake \
--delete-target
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Eliminación de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-deleting.html) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: eliminar recursos en un entorno verde de un clúster de base de datos de Aurora MySQL**
El siguiente ejemplo de `delete-blue-green-deployment` elimina los recursos de un entorno verde para un clúster de base de datos en Aurora MySQL.
```
aws rds delete-blue-green-deployment \
--blue-green-deployment-identifier bgd-wi89nwzglccsfake \
--delete-target
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Eliminación de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-deleting.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DeleteBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-blue-green-deployment.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-cluster-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-cluster-endpoint`.
**AWS CLI**
**Para eliminar un punto de conexión de clúster de base de datos personalizado**
En el siguiente ejemplo de `delete-db-cluster-endpoint` se elimina el punto de conexión de clúster de base de datos personalizado especificado.
```
aws rds delete-db-cluster-endpoint \
--db-cluster-endpoint-identifier mycustomendpoint
```
Salida:
```
{
"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"
}
```
Para obtener más información, consulte [Amazon Aurora Connection Management](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DeleteDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-cluster-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-cluster-parameter-group`.
**AWS CLI**
**Para eliminar un grupo de parámetros de clúster de base de datos**
En el siguiente ejemplo de `delete-db-cluster-parameter-group`, se elimina el grupo de parámetros de clúster de base de datos especificado.
```
aws rds delete-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbclusterparametergroup
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Working with DB Parameter Groups and DB Cluster Parameter Groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DeleteDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-cluster-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-cluster-snapshot`.
**AWS CLI**
**Para eliminar una instantánea de clúster de base de datos**
En el siguiente ejemplo de `delete-db-cluster-snapshot`, se elimina la instantánea del clúster de base de datos especificada.
```
aws rds delete-db-cluster-snapshot \
--db-cluster-snapshot-identifier mydbclustersnapshot
```
Salida:
```
{
"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
}
}
```
Para obtener más información, consulte [Deleting a Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteSnapshot.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DeleteDbClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-cluster`.
**AWS CLI**
**Ejemplo 1: eliminar una instancia de base de datos en un clúster de base de datos**
En el siguiente ejemplo de `delete-db-instance`, se elimina la instancia de base de datos final de un clúster de base de datos. No puede eliminar un clúster de base de datos si contiene instancias de base de datos que no están en el estado de **eliminación**. No puede tomar una instantánea final al eliminar una instancia de base de datos de un clúster de base de datos.
```
aws rds delete-db-instance \
--db-instance-identifier database-3
```
Salida:
```
{
"DBInstance": {
"DBInstanceIdentifier": "database-3",
"DBInstanceClass": "db.r4.large",
"Engine": "aurora-postgresql",
"DBInstanceStatus": "deleting",
...output omitted...
}
}
```
Para obtener más información, consulte [Deleting a DB Instance in an Aurora DB Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteInstance.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 2: eliminar un clúster de una base de datos**
En el siguiente ejemplo de `delete-db-cluster`, se elimina el clúster de base de datos denominado `mycluster` y se toma una instantánea final con el nombre `mycluster-final-snapshot`. El estado del clúster de base de datos está **disponible** mientras se realiza la instantánea. Para seguir el progreso de la eliminación, utilice el comando de CLI `describe-db-clusters`.
```
aws rds delete-db-cluster \
--db-cluster-identifier mycluster \
--no-skip-final-snapshot \
--final-db-snapshot-identifier mycluster-final-snapshot
```
Salida:
```
{
"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...
}
}
```
Para obtener más información, consulte [Aurora Clusters with a Single DB Instance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteInstance.html#USER_DeleteInstance.LastInstance) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DeleteDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-instance-automated-backup`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-instance-automated-backup`.
**AWS CLI**
**Para eliminar una copia de seguridad automatizada replicada de una región**
En el siguiente ejemplo de `delete-db-instance-automated-backup`, se elimina la copia de seguridad automatizada con el ARN (Amazon Resource Name) especificado.
```
aws rds delete-db-instance-automated-backup \
--db-instance-automated-backups-arn "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Deleting replicated backups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Delete) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DeleteDbInstanceAutomatedBackup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-instance-automated-backup.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-instance`.
**AWS CLI**
**Para eliminar una instancia de base de datos**
En el siguiente ejemplo `delete-db-instance`, se elimina la instancia de base de datos especificada tras crear una instantánea de base de datos final denominada `test-instance-final-snap`.
```
aws rds delete-db-instance \
--db-instance-identifier test-instance \
--final-db-snapshot-identifier test-instance-final-snap
```
Salida:
```
{
"DBInstance": {
"DBInstanceIdentifier": "test-instance",
"DBInstanceStatus": "deleting",
...some output truncated...
}
}
```
+ Para obtener información sobre la API, consulte [DeleteDBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-parameter-group`.
**AWS CLI**
**Eliminación de un grupo de parámetros de base de datos**
En el siguiente ejemplo `command`, se elimina un grupo de parámetros de base de datos.
```
aws rds delete-db-parameter-group \
--db-parameter-group-name mydbparametergroup
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [ Trabajo con los grupos de parámetros de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DeleteDBParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-proxy-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-proxy-endpoint`.
**AWS CLI**
**Para eliminar un punto de conexión de proxy de base de datos para una base de datos de RDS**
En el siguiente ejemplo de `delete-db-proxy-endpoint`, se elimina un punto de conexión de proxy de base de datos de la base de datos de destino.
```
aws rds delete-db-proxy-endpoint \
--db-proxy-endpoint-name proxyEP1
```
Salida:
```
{
"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
}
}
```
Para obtener más información, consulte [Deleting a proxy endpoint](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DeletingEndpoint) en la *Guía del usuario de Amazon RDS* y [Deleting a proxy endpoint](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DeletingEndpoint) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DeleteDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-proxy-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-proxy`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-proxy`.
**AWS CLI**
**Para eliminar un proxy de base de datos para una base de datos de RDS**
En el siguiente ejemplo de `delete-db-proxy` se elimina un proxy de base de datos.
```
aws rds delete-db-proxy \
--db-proxy-name proxyExample
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Eliminación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-deleting) en la *Guía del usuario de Amazon RDS* y [Eliminación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-deleting) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DeleteDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-proxy.html) en la *Referencia de comandos de AWS CLI*.
### `delete-db-security-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-security-group`.
**AWS CLI**
**Para eliminar un grupo de seguridad de la base de datos**
En el siguiente ejemplo de `delete-db-security-group`, se elimina un grupo de seguridad denominado `mysecuritygroup`.
```
aws rds delete-db-security-group \
--db-security-group-name mysecuritygroup
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Working with DB security groups (EC2-Classic platform)](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DeleteDbSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-security-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-shard-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-shard-group`.
**AWS CLI**
**Ejemplo 1: eliminar un grupo de partición de base de datos sin éxito**
El siguiente ejemplo de `delete-db-shard-group` muestra el error que se produce cuando se intenta eliminar un grupo de partición de base de datos antes de eliminar todas las bases de datos y los esquemas.
```
aws rds delete-db-shard-group \
--db-shard-group-identifier limitless-test-shard-grp
```
Salida:
```
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.
```
**Ejemplo 2: eliminar un grupo de partición de base de datos correctamente**
En el siguiente ejemplo de `delete-db-shard-group`, se elimina un grupo de partición de base de datos después de haber eliminado todas las bases de datos y los esquemas, incluido el esquema `public`.
```
aws rds delete-db-shard-group \
--db-shard-group-identifier limitless-test-shard-grp
```
Salida:
```
{
"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"
}
```
Para obtener más información, consulte [Eliminación de clústeres e instancias de base de datos de Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteCluster.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DeleteDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-shard-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-snapshot`.
**AWS CLI**
**Para eliminar una instantánea de base de datos**
En el siguiente ejemplo de `delete-db-snapshot`, se elimina una instantánea de base de datos especificada.
```
aws rds delete-db-snapshot \
--db-snapshot-identifier mydbsnapshot
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Deleting a Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteSnapshot.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DeleteDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-db-subnet-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-db-subnet-group`.
**AWS CLI**
**Para eliminar un grupo de subred de base de datos**
En el siguiente ejemplo de `delete-db-subnet-group`, se elimina el grupo de subred de base de datos llamado `mysubnetgroup`.
```
aws rds delete-db-subnet-group --db-subnet-group-name mysubnetgroup
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Working with a DB instance in a VPC](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener detalles sobre la API, consulte [DeleteDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-db-subnet-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-event-subscription`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-event-subscription`.
**AWS CLI**
**Para eliminar la suscripción a un evento**
En el siguiente ejemplo de `delete-event-subscription`, se elimina la suscripción a un evento especificado.
```
aws rds delete-event-subscription --subscription-name my-instance-events
```
Salida:
```
{
"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"
}
}
```
+ Para obtener información sobre la API, consulte [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-event-subscription.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-global-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-global-cluster`.
**AWS CLI**
**Para eliminar un clúster de base de datos global**
En el siguiente ejemplo de `delete-global-cluster`, se elimina un nuevo clúster de base de datos global compatible con Aurora MySQL. El resultado muestra el clúster que va a eliminar, pero los comandos `describe-global-clusters` posteriores no generan una lista de ese clúster de base de datos.
```
aws rds delete-global-cluster \
--global-cluster-identifier myglobalcluster
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Eliminación de una base de datos global de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html#aurora-global-database-deleting) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DeleteGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-global-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-option-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-option-group`.
**AWS CLI**
**Para eliminar un grupo de opciones**
En el siguiente ejemplo de `delete-option-group`, se elimina el grupo de opciones especificado.
```
aws rds delete-option-group \
--option-group-name myoptiongroup
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Eliminación de un grupo de opciones](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.Delete) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DeleteOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/delete-option-group.html) en la *Referencia de comandos de la AWS CLI*.
### `deregister-db-proxy-targets`
En el siguiente ejemplo de código, se muestra cómo utilizar `deregister-db-proxy-targets`.
**AWS CLI**
**Para anular el registro de un destino proxy de base de datos del grupo de destino de la base de datos**
En el siguiente ejemplo de `deregister-db-proxy-targets`, se elimina la asociación entre el proxy `proxyExample` y su destino.
```
aws rds deregister-db-proxy-targets \
--db-proxy-name proxyExample \
--db-instance-identifiers database-1
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Eliminación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-deleting) en la *Guía del usuario de Amazon RDS* y [Eliminación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-deleting) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DeregisterDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/deregister-db-proxy-targets.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-account-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-account-attributes`.
**AWS CLI**
**Descripción de atributos de cuenta**
En el siguiente ejemplo `describe-account-attributes`, se recuperan los atributos de la cuenta actual de AWS.
```
aws rds describe-account-attributes
```
Salida:
```
{
"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"
}
]
}
```
+ Para obtener información sobre la API, consulte [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-account-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-blue-green-deployments`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-blue-green-deployments`.
**AWS CLI**
**Ejemplo 1: describir una implementación azul/verde de una instancia de base de datos de RDS una vez finalizada la creación**
En el siguiente ejemplo de `describe-blue-green-deployment`, se recuperan los detalles de una implementación azul/verde una vez que se completa la creación.
```
aws rds describe-blue-green-deployments \
--blue-green-deployment-identifier bgd-v53303651eexfake
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Visualización de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-viewing.html) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: describir una implementación azul/verde para un clúster de base de datos en Aurora MySQL**
En el siguiente ejemplo de `describe-blue-green-deployment`, se recuperan los detalles de una implementación azul/verde.
```
aws rds describe-blue-green-deployments \
--blue-green-deployment-identifier bgd-wi89nwzglccsfake
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Visualización de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 3: describir una implementación azul/verde para un clúster de Aurora MySQL después de una transición**
En el siguiente ejemplo de `describe-blue-green-deployment`, se recuperan los detalles sobre una implementación azul/verde después de que el entorno verde se haya convertido en el entorno de producción.
```
aws rds describe-blue-green-deployments \
--blue-green-deployment-identifier bgd-wi89nwzglccsfake
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Visualización de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 4: describir una implementación azul/verde combinada**
En el siguiente ejemplo de `describe-blue-green-deployment`, se recuperan los detalles de una implementación azul/verde combinada.
```
aws rds describe-blue-green-deployments
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Visualización de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-viewing.html) en la *Guía del usuario de Amazon RDS* y [Visualización de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-viewing.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeBlueGreenDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-blue-green-deployments.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-certificates`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-certificates`.
**AWS CLI**
**Para describir certificados**
En el siguiente ejemplo de `describe-certificates`, se recuperan los detalles del certificado asociado a la región predeterminada del usuario.
```
aws rds describe-certificates
```
Salida:
```
{
"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"
}
```
Para obtener más información, consulte [Uso de SSL/TLS para cifrar una conexión a una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html) en la *Guía del usuario de Amazon RDS* y [Uso de SSL/TLS para cifrar una conexión a un clúster de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DescribeCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-certificates.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-cluster-backtracks`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-cluster-backtracks`.
**AWS CLI**
**Para describir las búsquedas de datos anteriores en un clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-backtracks` se recuperan los detalles sobre el clúster de base de datos especificado.
```
aws rds describe-db-cluster-backtracks \
--db-cluster-identifier mydbcluster
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Búsqueda de datos anteriores de un clúster de base de datos de Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Managing.Backtrack.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeDbClusterBacktracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-backtracks.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-cluster-endpoints`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-cluster-endpoints`.
**AWS CLI**
**Ejemplo 1: describir los puntos de conexión de un clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-endpoints`, se recuperan los detalles de los puntos de conexión de su clúster de base de datos. Los tipos más comunes de clústeres de Aurora tienen dos puntos de conexión. Un punto de conexión tiene un tipo `WRITER`. Puede utilizar este punto de conexión para todas las instrucciones SQL. El otro punto de conexión tiene el tipo `READER`. Puede usar este punto de conexión solo para SELECT y otras instrucciones SQL de solo lectura.
```
aws rds describe-db-cluster-endpoints
```
Salida:
```
{
"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"
}
]
}
```
**Ejemplo 2: describir los puntos de conexión de un clúster de base de datos de un solo clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-endpoints`, se recuperan los detalles de los puntos de conexión del clúster de base de datos de un solo clúster de base de datos especificado. Los clústeres Aurora sin servidor solo tienen un punto de conexión con un tipo de `WRITER`.
```
aws rds describe-db-cluster-endpoints \
--db-cluster-identifier serverless-cluster
```
Salida:
```
{
"DBClusterEndpoints": [
{
"Status": "available",
"Endpoint": "serverless-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
"DBClusterIdentifier": "serverless-cluster",
"EndpointType": "WRITER"
}
]
}
```
Para obtener más información, consulte [Amazon Aurora Connection Management](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeDbClusterEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-endpoints.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-cluster-parameter-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-cluster-parameter-groups`.
**AWS CLI**
**Para describir los grupos de parámetro de un clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-parameter-groups`, se recuperan los detalles de los grupos de parámetros de su clúster de base de datos.
```
aws rds describe-db-cluster-parameter-groups
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Working with DB Parameter Groups and DB Cluster Parameter Groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DescribeDbClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-parameter-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-cluster-parameters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-cluster-parameters`.
**AWS CLI**
**Ejemplo 1: describir los parámetros de un grupo de parámetros de clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-parameters`, se recuperan los detalles sobre los parámetros en un grupo de parámetros de clúster de base de datos.
```
aws rds describe-db-cluster-parameters \
--db-cluster-parameter-group-name mydbclusterpg
```
Salida:
```
{
"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...
]
}
```
**Ejemplo 2: generar una lista solo de nombres de parámetros de un grupo de parámetros de clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-parameters`, se recuperan solo los nombres de los parámetros en un grupo de parámetros de clúster de base de datos.
```
aws rds describe-db-cluster-parameters \
--db-cluster-parameter-group-name default.aurora-mysql5.7 \
--query 'Parameters[].{ParameterName:ParameterName}'
```
Salida:
```
[
{
"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...
}
]
```
**Ejemplo 3: describir solo los parámetros modificables de un grupo de parámetros de clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-parameters`, se recuperan solo los nombres de los parámetros que se pueden modificar en un grupo de parámetros de clúster de base de datos.
```
aws rds describe-db-cluster-parameters \
--db-cluster-parameter-group-name default.aurora-mysql5.7 \
--query 'Parameters[].{ParameterName:ParameterName,IsModifiable:IsModifiable} | [?IsModifiable == `true`]'
```
Salida:
```
[
{
"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...
}
]
```
**Ejemplo 4: Describir solo los parámetros booleanos modificables de un grupo de parámetros de clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-parameters`, se recuperan solo los nombres de los parámetros que se pueden modificar en un grupo de parámetros de clúster de base de datos y que tienen un tipo de datos booleano.
```
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`]'
```
Salida:
```
[
{
"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...
}
]
```
Para obtener más información, consulte [Working with DB Parameter Groups and DB Cluster Parameter Groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DescribeDbClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-parameters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-cluster-snapshot-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-cluster-snapshot-attributes`.
**AWS CLI**
**Para describir los nombres y valores de los atributos de una instantánea de clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-snapshot-attributes`, se recuperan detalles de los nombres y valores de los atributos de la instantánea del clúster de base de datos especificado.
```
aws rds describe-db-cluster-snapshot-attributes \
--db-cluster-snapshot-identifier myclustersnapshot
```
Salida:
```
{
"DBClusterSnapshotAttributesResult": {
"DBClusterSnapshotIdentifier": "myclustersnapshot",
"DBClusterSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123456789012"
]
}
]
}
}
```
Para obtener más información, consulte [Sharing a DB Cluster Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_ShareSnapshot.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DescribeDbClusterSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-snapshot-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-cluster-snapshots`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-cluster-snapshots`.
**AWS CLI**
**Para describir una instantánea de clúster de base de datos para un clúster de base de datos**
En el siguiente ejemplo de `describe-db-cluster-snapshots`, se recuperan los detalles de las instantáneas del clúster de base de datos para el clúster de base de datos especificado.
```
aws rds describe-db-cluster-snapshots \
--db-cluster-identifier mydbcluster
```
Salida:
```
{
"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
}
]
}
```
Para obtener más información, consulte [Creación de una instantánea de clúster de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CreateSnapshotCluster.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DescribeDbClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-cluster-snapshots.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-clusters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-clusters`.
**AWS CLI**
**Ejemplo 1: describir un clúster de base de datos**
En el siguiente ejemplo de `describe-db-clusters` se recuperan los detalles sobre el clúster de base de datos especificado.
```
aws rds describe-db-clusters \
--db-cluster-identifier mydbcluster
```
Salida:
```
{
"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
}
]
}
```
**Ejemplo 2: generar una lista de determinados atributos de todos los clústeres de bases de datos**
El siguiente ejemplo de `describe-db-clusters` recupera solo los atributos `DBClusterIdentifier`, `Endpoint` y `ReaderEndpoint` de todos los clústeres de base de datos de la región AWS actual.
```
aws rds describe-db-clusters \
--query 'DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,Endpoint:Endpoint,ReaderEndpoint:ReaderEndpoint}'
```
Salida:
```
[
{
"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...
}
]
```
**Ejemplo 3: generar una lista de los clústeres de bases de datos con un atributo específico**
El siguiente ejemplo de `describe-db-clusters` recupera solo los atributos `DBClusterIdentifier` y `Engine` de los clústeres de base de datos que utilicen el motor de base de datos `aurora-postgresql`.
```
aws rds describe-db-clusters \
--query 'DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,Engine:Engine} | [?Engine == `aurora-postgresql`]'
```
Salida:
```
[
{
"Engine": "aurora-postgresql",
"DBClusterIdentifier": "pg2-cluster"
}
]
```
Para obtener más información, consulte la sección sobre [Clústeres de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [DescribeDbClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-clusters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-engine-versions`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-engine-versions`.
**AWS CLI**
**Descripción de las versiones del motor de base de datos para el motor de base de datos MySQL**
El siguiente ejemplo `describe-db-engine-versions` se muestran detalles sobre cada una de las versiones del motor de base de datos especificado.
```
aws rds describe-db-engine-versions \
--engine mysql
```
Salida:
```
{
"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...
]
}
```
Para obtener más información acerca de Amazon RDS, consulte [¿Qué es Amazon Relational Database Service (Amazon RDS)?](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeDBEngineVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-engine-versions.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-instance-automated-backups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-instance-automated-backups`.
**AWS CLI**
**Para describir las copias de seguridad automatizadas de una instancia de base de datos**
En el ejemplo siguiente de `describe-db-instance-automated-backups`, se muestran los detalles sobre las copias de seguridad automatizadas para la instancia de base de datos especificada. Los detalles incluyen copias de seguridad automatizadas replicadas en otras regiones de AWS.
```
aws rds describe-db-instance-automated-backups \
--db-instance-identifier new-orcl-db
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Finding information about replicated backups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Describe) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeDbInstanceAutomatedBackups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-instance-automated-backups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-instances`.
**AWS CLI**
**Descripción de una instancia de base de datos**
En el siguiente ejemplo de `describe-db-instances`, se recuperan los detalles sobre la instancia de base de datos especificada.
```
aws rds describe-db-instances \
--db-instance-identifier mydbinstancecf
```
Salida:
```
{
"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...
}
]
}
```
+ Para obtener información sobre la API, consulte [DescribeDBInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-instances.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-log-files`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-log-files`.
**AWS CLI**
**Para describir los archivos de registro de una instancia de base de datos**
En el siguiente ejemplo de `describe-db-log-files`, se recuperan los detalles sobre los archivos de registro para la instancia de base de datos especificada.
```
aws rds describe-db-log-files -\
-db-instance-identifier test-instance
```
Salida:
```
{
"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"
}
]
}
```
+ Para obtener información sobre la API, consulte [DescribeDbLogFiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-log-files.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-parameter-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-parameter-groups`.
**AWS CLI**
**Descripción del grupo de parámetros de base de datos**
En el siguiente ejemplo `describe-db-parameter-groups`, se recuperan los detalles sobre los grupos de parámetros de base de datos.
```
aws rds describe-db-parameter-groups
```
Salida:
```
{
"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...
]
}
```
Para obtener más información, consulte [ Trabajo con los grupos de parámetros de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeDBParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-parameter-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-parameters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-parameters`.
**AWS CLI**
**Descripción de los parámetros de un grupo de parámetros de base de datos**
En el siguiente ejemplo `describe-db-parameters`, se recuperan los detalles del grupo de parámetros de base de datos especificado.
```
aws rds describe-db-parameters \
--db-parameter-group-name mydbpg
```
Salida:
```
{
"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...
]
}
```
Para obtener más información, consulte [ Trabajo con los grupos de parámetros de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeDBParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-parameters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-proxies`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-proxies`.
**AWS CLI**
**Para describir un proxy de base de datos para una base de datos de RDS**
El siguiente ejemplo de `describe-db-proxies` proporciona información sobre proxies de base de datos.
```
aws rds describe-db-proxies
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Ver un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) en la *Guía del usuario de Amazon RDS* y [Ver un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeDbProxies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxies.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-proxy-endpoints`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-proxy-endpoints`.
**AWS CLI**
**Para describir los puntos de conexión de un proxy de base de datos**
El siguiente ejemplo de `describe-db-proxy-endpoints` proporciona información sobre puntos de conexión de proxies de base de datos.
```
aws rds describe-db-proxy-endpoints
```
Salida:
```
{
"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
}
]
}
```
Para obtener más información, consulte [Viewing a proxy endpoint](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DescribingEndpoint) en la *Guía del usuario de Amazon RDS* y [Viewing a proxy endpoint](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.DescribingEndpoint) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeDbProxyEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-endpoints.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-proxy-target-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-proxy-target-groups`.
**AWS CLI**
**Para describir los puntos de conexión de un proxy de base de datos**
El siguiente ejemplo de `describe-db-proxy-target-groups` proporciona información sobre grupos de destino de proxy de base de datos.
```
aws rds describe-db-proxy-target-groups \
--db-proxy-name proxyExample
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Ver un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) en la *Guía del usuario de Amazon RDS* y [Ver un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeDbProxyTargetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-target-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-proxy-targets`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-proxy-targets`.
**AWS CLI**
**Para describir los objetivos de un proxy de base de datos**
El siguiente ejemplo de `describe-db-proxy-targets` proporciona información sobre destinos de proxy de base de datos.
```
aws rds describe-db-proxy-targets \
--db-proxy-name proxyExample
```
Salida:
```
{
"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"
}
}
]
}
```
Para obtener más información, consulte [Ver un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-viewing) en la *Guía del usuario de Amazon RDS* y [Ver un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-viewing) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-proxy-targets.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-recommendations`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-recommendations`.
**AWS CLI**
**Ejemplo 1: generar listas de todas las recomendaciones de bases de datos**
En el siguiente ejemplo de `describe-db-recommendations`, se generan listas de todas las recomendaciones de bases de datos de su cuenta de AWS.
```
aws rds describe-db-recommendations
```
Salida:
```
{
"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"
}
]
}
]
}
```
Para obtener más información, consulte [Recomendaciones para Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) en la *Guía del usuario de Amazon RDS* y [Recomendaciones para Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 2: generar listas de las recomendaciones de bases de datos de alta gravedad**
En el siguiente ejemplo de `describe-db-recommendations`, se generan listas de las recomendaciones de bases de datos de alta gravedad en su cuenta de AWS.
```
aws rds describe-db-recommendations \
--filters Name=severity,Values=high
```
Salida:
```
{
"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/"
}
]
}
]
}
```
Para obtener más información, consulte [Viewing and responding to Amazon RDS recommendations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) en la *Guía del usuario de Amazon RDS* y [Viewing and responding to Amazon RDS recommendations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 3: generar listas de las recomendaciones de base de datos para una instancia de base de datos específica**
El siguiente ejemplo de `describe-db-recommendations` genera listas de todas las recomendaciones de base de datos para una instancia de base de datos específica.
```
aws rds describe-db-recommendations \
--filters Name=dbi-resource-id,Values=database-1
```
Salida:
```
{
"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"
}
]
}
]
}
```
Para obtener más información, consulte [Viewing and responding to Amazon RDS recommendations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) en la *Guía del usuario de Amazon RDS* y [Viewing and responding to Amazon RDS recommendations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 4: generar listas de todas las recomendaciones de bases de datos activas**
En el siguiente ejemplo de `describe-db-recommendations`, se generan listas de todas las recomendaciones de bases de datos activas de su cuenta de AWS.
```
aws rds describe-db-recommendations \
--filters Name=status,Values=active
```
Salida:
```
{
"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"
}
]
}
]
}
```
Para obtener más información, consulte [Viewing and responding to Amazon RDS recommendations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/monitoring-recommendations.html) en la *Guía del usuario de Amazon RDS* y [Viewing and responding to Amazon RDS recommendations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/monitoring-recommendations.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeDbRecommendations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-recommendations.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-security-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-security-groups`.
**AWS CLI**
**Para generar listas de los grupos de seguridad de bases de datos**
En el siguiente ejemplo de `describe-db-security-groups`, se generan listas de grupos de seguridad de base de datos.
```
aws rds describe-db-security-groups
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Listing Available DB Security Groups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithSecurityGroups.html#USER_WorkingWithSecurityGroups.Listing) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeDbSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-security-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-shard-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-shard-groups`.
**AWS CLI**
**Ejemplo 1: describir los grupos de partición de base de datos**
En el siguiente ejemplo de `describe-db-shard-groups`, se recuperan los detalles sobre los grupos de partición de base de datos.
```
aws rds describe-db-shard-groups
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte la sección sobre [Clústeres de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeDbShardGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-shard-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-snapshot-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-snapshot-attributes`.
**AWS CLI**
**Para describir los nombres y valores de los atributos de una instantánea de base de datos**
En el siguiente ejemplo de `describe-db-snapshot-attributes`, se describen los nombres y los valores de los atributos de una instantánea de base de datos.
```
aws rds describe-db-snapshot-attributes \
--db-snapshot-identifier mydbsnapshot
```
Salida:
```
{
"DBSnapshotAttributesResult": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123456789012",
"210987654321"
]
}
]
}
}
```
Para obtener más información, consulte [Uso compartido de una instantánea](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeDbSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-snapshot-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-snapshots`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-snapshots`.
**AWS CLI**
**Ejemplo 1: Descripción de una instantánea de base de datos para una instancia de base de datos**
En el siguiente ejemplo `describe-db-snapshots`, se recuperan los detalles de una instantánea de base de datos de una instancia de base de datos.
```
aws rds describe-db-snapshots \
--db-snapshot-identifier mydbsnapshot
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Creación de una instantánea de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: Búsqueda del número de instantáneas manuales realizadas**
En el siguiente ejemplo de `describe-db-snapshots` se utiliza el operador `length` como opción `--query` para devolver el número de instantáneas manuales que se han realizado en una región concreta de AWS.
```
aws rds describe-db-snapshots \
--snapshot-type manual \
--query "length(*[].{DBSnapshots:SnapshotType})" \
--region eu-central-1
```
Salida:
```
35
```
Para obtener más información, consulte [Creación de una instantánea de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeDBSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-snapshots.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-db-subnet-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-db-subnet-groups`.
**AWS CLI**
**Para describir un grupo de subred de base de datos**
En el siguiente ejemplo de `describe-db-subnet-groups`, se recuperan los detalles del grupo de subred de base de datos especificado.
```
aws rds describe-db-subnet-groups
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Amazon Virtual Private Cloud VPCs and Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener detalles sobre la API, consulte [DescribeDbSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-subnet-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-engine-default-cluster-parameters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-engine-default-cluster-parameters`.
**AWS CLI**
**Para describir la información de parámetro del sistema y del motor predeterminado para el motor de una base de datos de Aurora**
En el siguiente ejemplo de `describe-engine-default-cluster-parameters`, se recuperan los detalles del motor predeterminado y la información de los parámetros del sistema para los clústeres de bases de datos Aurora compatibles con MySQL 5.7.
```
aws rds describe-engine-default-cluster-parameters \
--db-parameter-group-family aurora-mysql5.7
```
Salida:
```
{
"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...
]
}
}
```
Para obtener más información, consulte [Working with DB Parameter Groups and DB Cluster Parameter Groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeEngineDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-engine-default-cluster-parameters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-engine-default-parameters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-engine-default-parameters`.
**AWS CLI**
**Para describir la información de motor predeterminado y la información de los parámetros del sistema para el motor de una base de datos**
En el siguiente ejemplo de `describe-engine-default-parameters`, se recuperan los detalles del motor predeterminado y la información de los parámetros del sistema para las instancias de base de datos MySQL 5.7.
```
aws rds describe-engine-default-parameters \
--db-parameter-group-family mysql5.7
```
Salida:
```
{
"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...
]
}
}
```
Para obtener más información, consulte [ Trabajo con los grupos de parámetros de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeEngineDefaultParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-engine-default-parameters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-event-categories`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-event-categories`.
**AWS CLI**
**Para describir las categorías de eventos**
El siguiente ejemplo de `describe-event-categories` recupera detalles sobre las categorías de eventos para todos los orígenes de eventos disponibles.
```
aws rds describe-event-categories
```
Salida:
```
{
"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"
]
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeEventCategories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-event-categories.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-event-subscriptions`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-event-subscriptions`.
**AWS CLI**
**Para describir suscripciones a eventos**
En este ejemplo se describen todas las suscripciones a eventos de Amazon RDS para la cuenta de AWS actual.
```
aws rds describe-event-subscriptions
```
Salida:
```
{
"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...
]
}
```
+ Para obtener información sobre la API, consulte [DescribeEventSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-event-subscriptions.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-events`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-events`.
**AWS CLI**
**Para describir eventos**
En el siguiente ejemplo de `describe-events`, se recuperan los detalles de los eventos que se han producido para la instancia de base de datos especificada.
```
aws rds describe-events \
--source-identifier test-instance \
--source-type db-instance
```
Salida:
```
{
"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"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-events.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-export-tasks`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-export-tasks`.
**AWS CLI**
**Para describir las tareas de exportación de instantáneas**
El siguiente ejemplo de `describe-export-tasks` devuelve información sobre las exportaciones de instantáneas a Amazon S3.
```
aws rds describe-export-tasks
```
Salida:
```
{
"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
}
]
}
```
Para obtener más información, consulte [Monitoreo de las exportaciones de instantáneas](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Monitoring) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeExportTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-export-tasks.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-global-clusters`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-global-clusters`.
**AWS CLI**
**Para describir los clústeres de bases de datos globales**
El siguiente ejemplo de `describe-global-clusters` genera una lista de los clústeres de bases de datos globales de Aurora en la región de AWS actual.
```
aws rds describe-global-clusters
```
Salida:
```
{
"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": []
}
]
}
```
Para obtener más información, consulte [Administración de una base de datos global de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [DescribeGlobalClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-global-clusters.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-option-group-options`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-option-group-options`.
**AWS CLI**
**Para describir todas las opciones disponibles**
El siguiente ejemplo de `describe-option-group-options` genera listas de las dos opciones para una instancia de Oracle Database 19c.
```
aws rds describe-option-group-options \
--engine-name oracle-ee \
--major-engine-version 19 \
--max-items 2
```
Salida:
```
{
"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=="
}
```
Para obtener más información, consulte [Descripción de opciones y configuración de opciones para un grupo de opciones](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.ListOption) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeOptionGroupOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-option-group-options.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-option-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-option-groups`.
**AWS CLI**
**Para describir los grupos de opción disponibles**
El siguiente ejemplo de `describe-option-groups` genera listas de los grupos de opciones para una instancia de Oracle Database 19c.
```
aws rds describe-option-groups \
--engine-name oracle-ee \
--major-engine-version 19
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Descripción de opciones y configuración de opciones para un grupo de opciones](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.ListOption) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeOptionGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-option-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-orderable-db-instance-options`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-orderable-db-instance-options`.
**AWS CLI**
**Descripción de las opciones de instancias de base de datos ordenables**
En el siguiente ejemplo `describe-orderable-db-instance-options`, se recuperan detalles sobre las opciones ordenables de una instancia de base de datos que ejecuta el motor de base de datos MySQL.
```
aws rds describe-orderable-db-instance-options \
--engine mysql
```
Salida:
```
{
"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...
}
```
+ Para obtener información sobre la API, consulte [DescribeOrderableDBInstanceOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-orderable-db-instance-options.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-pending-maintenance-actions`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-pending-maintenance-actions`.
**AWS CLI**
**Para generar listas de los recursos con al menos una acción de mantenimiento pendiente**
En el siguiente ejemplo de `describe-pending-maintenance-actions` se enumeran las acciones de mantenimiento pendientes para una instancia de base de datos.
```
aws rds describe-pending-maintenance-actions
```
Salida:
```
{
"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"
}
]
}
]
}
```
Para obtener más información, consulte [Mantenimiento de una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener detalles sobre la API, consulte [DescribePendingMaintenanceActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-pending-maintenance-actions.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-reserved-db-instances-offerings`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-reserved-db-instances-offerings`.
**AWS CLI**
**Para describir ofertas de instancias reservadas de bases de datos**
El siguiente ejemplo de `describe-reserved-db-instances-offerings` recupera detalles sobre las opciones de instancias de base de datos reservadas para `oracle`.
```
aws rds describe-reserved-db-instances-offerings \
--product-description oracle
```
Salida:
```
{
"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...
}
```
+ Para obtener información sobre la API, consulte [DescribeReservedDbInstancesOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-reserved-db-instances-offerings.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-reserved-db-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-reserved-db-instances`.
**AWS CLI**
**Para describir instancias de bases de datos reservadas**
En el siguiente ejemplo de `describe-reserved-db-instances`, se recuperan los detalles sobre cualquier instancia de base de datos reservada de la cuenta de AWS actual.
```
aws rds describe-reserved-db-instances
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte la sección sobre [Instancias de base de datos reservadas para Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeReservedDbInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-reserved-db-instances.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-source-regions`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-source-regions`.
**AWS CLI**
**Para describir las regiones de origen**
El siguiente ejemplo de `describe-source-regions` recupera detalles sobre todas las regiones AWS de origen. También muestra que las copias de seguridad automatizadas se pueden replicar solo desde el Oeste de EE. UU. (Oregón) a la región de AWS de destino, Este de EE. UU. (Norte de Virginia).
```
aws rds describe-source-regions \
--region us-east-1
```
Salida:
```
{
"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
}
]
}
```
Para obtener más información, consulte [Búsqueda de información sobre las copias de seguridad replicadas](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Describe) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [DescribeSourceRegions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-source-regions.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-valid-db-instance-modifications`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-valid-db-instance-modifications`.
**AWS CLI**
**Para describir las modificaciones válidas de una instancia de base de datos**
En el siguiente ejemplo de `describe-valid-db-instance-modifications`, se recuperan los detalles sobre las modificaciones válidas de la instancia de base de datos especificada.
```
aws rds describe-valid-db-instance-modifications \
--db-instance-identifier test-instance
```
Salida:
```
{
"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"
}
]
}
}
```
+ Para obtener información sobre la API, consulte [DescribeValidDbInstanceModifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-valid-db-instance-modifications.html) en la *Referencia de comandos de la AWS CLI*.
### `download-db-log-file-portion`
En el siguiente ejemplo de código, se muestra cómo utilizar `download-db-log-file-portion`.
**AWS CLI**
**Ejemplo 1: descarga de la última parte de un archivo de registro de base de datos**
El siguiente ejemplo de `download-db-log-file-portion` descarga solo la parte más reciente del archivo de registro y la guarda en un archivo local denominado `tail.txt`.
```
aws rds download-db-log-file-portion \
--db-instance-identifier test-instance \
--log-file-name log.txt \
--output text > tail.txt
```
El archivo guardado puede contener líneas en blanco. Aparecen al final de cada parte del archivo de registro durante la descarga.
**Ejemplo 2: descarga de un archivo de registro de base de datos completo**
En el siguiente ejemplo de `download-db-log-file-portion`, se descarga el archivo de registro completo mediante el parámetro `--starting-token 0` y se guarda el resultado en un archivo local denominado `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
```
El archivo guardado puede contener líneas en blanco. Aparecen al final de cada parte del archivo de registro durante la descarga.
+ Para obtener información sobre la API, consulte [DownloadDbLogFilePortion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/download-db-log-file-portion.html) en la *Referencia de comandos de la AWS CLI*.
### `generate-auth-token`
En el siguiente ejemplo de código, se muestra cómo utilizar `generate-auth-token`.
**AWS CLI**
**Para generar un token de autenticación**
El siguiente ejemplo de `generate-db-auth-token` genera un token de autenticación para usarlo con la autenticación de la base de datos de 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
```
Salida:
```
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
```
+ Para obtener información sobre la API, consulte [GenerateAuthToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/generate-auth-token.html) en la *Referencia de comandos de la AWS CLI*.
### `generate-db-auth-token`
En el siguiente ejemplo de código, se muestra cómo utilizar `generate-db-auth-token`.
**AWS CLI**
**Para generar un token de autenticación de IAM**
El siguiente ejemplo de `generate-db-auth-token` genera un token de autenticación de IAM para conectarse a una base de datos.
```
aws rds generate-db-auth-token \
--hostname mydb.123456789012.us-east-1.rds.amazonaws.com \
--port 3306 \
--region us-east-1 \
--username db_user
```
Salida:
```
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
```
Para obtener más información, consulte [Conexión a la instancia con la autenticación de IAM](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.Connecting.html) en la *Guía del usuario de Amazon RDS* y [Conexión a la instancia con la autenticación de IAM](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.Connecting.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener más información sobre la API, consulte [GenerateDbAuthToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/generate-db-auth-token.html) en la *Referencia de comandos de la AWS CLI*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Para generar listas de etiquetas de un recurso en Amazon RDS**
En el siguiente ejemplo de `list-tags-for-resource`, se generan listas de todas las etiquetas de una instancia de base de datos.
```
aws rds list-tags-for-resource \
--resource-name arn:aws:rds:us-east-1:123456789012:db:orcl1
```
Salida:
```
{
"TagList": [
{
"Key": "Environment",
"Value": "test"
},
{
"Key": "Name",
"Value": "MyDatabase"
}
]
}
```
Para obtener más información, consulte [Etiquetado de los recursos de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) en la *Guía del usuario de Amazon RDS*.
+ Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-certificates`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-certificates`.
**AWS CLI**
**Para anular temporalmente el certificado SSL/TLS predeterminado del sistema para las nuevas instancias de base de datos**
El siguiente ejemplo de `modify-certificates` anula temporalmente el certificado SSL/TLS predeterminado del sistema para las nuevas instancias de la base de datos.
```
aws rds modify-certificates \
--certificate-identifier rds-ca-2019
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Rotar certificados SSL/TLS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html) en la *Guía del usuario de Amazon RDS* y [Rotar certificados SSL/TLS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html) en la *Guía del usuario de Amazon Aurora.*
+ Para obtener más información sobre la API, consulte [ModifyCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-certificates.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-current-db-cluster-capacity`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-current-db-cluster-capacity`.
**AWS CLI**
**Para escalar la capacidad de un clúster de base de datos Aurora sin servidor**
En el siguiente ejemplo de `modify-current-db-cluster-capacity` se escala la capacidad de un clúster de base de datos Aurora sin servidor a 8.
```
aws rds modify-current-db-cluster-capacity \
--db-cluster-identifier mydbcluster \
--capacity 8
```
Salida:
```
{
"DBClusterIdentifier": "mydbcluster",
"PendingCapacity": 8,
"CurrentCapacity": 1,
"SecondsBeforeTimeout": 300,
"TimeoutAction": "ForceApplyCapacityChange"
}
```
Para obtener más información, consulte [Escalado manual de la capacidad del clúster de bases de datos de Aurora sin servidor, versión 1](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.setting-capacity.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [ModifyCurrentDbClusterCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-current-db-cluster-capacity.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-cluster-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-cluster-endpoint`.
**AWS CLI**
**Para modificar un punto de conexión de clúster de base de datos personalizado**
En el siguiente ejemplo de `modify-db-cluster-endpoint`, se modifica el punto de conexión de clúster de base de datos personalizado especificado.
```
aws rds modify-db-cluster-endpoint \
--db-cluster-endpoint-identifier mycustomendpoint \
--static-members dbinstance1 dbinstance2 dbinstance3
```
Salida:
```
{
"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"
}
```
Para obtener más información, consulte [Amazon Aurora Connection Management](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.Endpoints.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [ModifyDbClusterEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-cluster-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-cluster-parameter-group`.
**AWS CLI**
**Para modificar parámetros de un grupo de parámetros de clúster de base de datos**
En el siguiente ejemplo de `modify-db-cluster-parameter-group`, se modifican los valores de los parámetros en un grupo de parámetros de clúster de base de datos.
```
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"
```
Salida:
```
{
"DBClusterParameterGroupName": "mydbclusterpg"
}
```
Para obtener más información, consulte [Working with DB Parameter Groups and DB Cluster Parameter Groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [ModifyDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-cluster-snapshot-attribute`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-cluster-snapshot-attribute`.
**AWS CLI**
**Para modificar un atributo de la instantánea del clúster de base de datos**
En el siguiente ejemplo de `modify-db-cluster-snapshot-attribute`, se realizan cambios en el atributo de la instantánea del clúster de base de datos especificado.
```
aws rds modify-db-cluster-snapshot-attribute \
--db-cluster-snapshot-identifier myclustersnapshot \
--attribute-name restore \
--values-to-add 123456789012
```
Salida:
```
{
"DBClusterSnapshotAttributesResult": {
"DBClusterSnapshotIdentifier": "myclustersnapshot",
"DBClusterSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123456789012"
]
}
]
}
}
```
Para obtener más información, consulte [Restauración de una instantánea de clúster de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RestoreFromSnapshot.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [ModifyDbClusterSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster-snapshot-attribute.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-cluster`.
**AWS CLI**
**Ejemplo 1: modificar el clúster de una base de datos**
El siguiente ejemplo de `modify-db-cluster` cambia la contraseña del usuario maestro del clúster de base de datos denominado `cluster-2` y establece el período de retención de la copia de seguridad en 14 días. El parámetro `--apply-immediately` hace que los cambios se produzcan de inmediato, en lugar de esperar hasta el siguiente período de mantenimiento.
```
aws rds modify-db-cluster \
--db-cluster-identifier cluster-2 \
--backup-retention-period 14 \
--master-user-password newpassword99 \
--apply-immediately
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Modificación de un clúster de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Modifying.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 2: asociar un grupo de seguridad VPC con un clúster de base de datos**
El siguiente ejemplo de `modify-db-instance` asocia un grupo de seguridad de VPC específico y elimina los grupos de seguridad de base de datos de un clúster de base de datos:
```
aws rds modify-db-cluster \
--db-cluster-identifier dbName \
--vpc-security-group-ids sg-ID
```
Salida:
```
{
"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...
}
}
```
Para obtener más información, consulte [Control de acceso con grupos de seguridad](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Overview.RDSSecurityGroups.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [ModifyDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-instance`.
**AWS CLI**
**Ejemplo 1: modificar una instancia de base de datos**
En el siguiente ejemplo de `modify-db-instance` se asocia un grupo de opciones y un grupo de parámetros a una instancia de base de datos de Microsoft SQL Server compatible. El parámetro `--apply-immediately` hace que los grupos de opciones y parámetros se asocien de inmediato, en lugar de esperar hasta el siguiente período de mantenimiento.
```
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
```
Salida:
```
{
"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
}
}
```
Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: asociar un grupo de seguridad VPC con una instancia de base de datos**
El siguiente ejemplo de `modify-db-instance` asocia un grupo de seguridad de VPC específico y elimina los grupos de seguridad de base de datos de una instancia de base de datos:
```
aws rds modify-db-instance \
--db-instance-identifier dbName \
--vpc-security-group-ids sg-ID
```
Salida:
```
{
"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 ...
}
}
```
Para obtener más información, consulte [Control de acceso con grupos de seguridad](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.RDSSecurityGroups.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [ModifyDBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-parameter-group`.
**AWS CLI**
**Modificación de un grupo de parámetros de base de datos**
En el siguiente ejemplo `modify-db-parameter-group`, se cambia el valor del parámetro `clr enabled` en un grupo de parámetros de base de datos. El parámetro `--apply-immediately` hace que el grupo de parámetros de la base de datos se modifique de inmediato, en lugar de esperar hasta el siguiente período de mantenimiento.
```
aws rds modify-db-parameter-group \
--db-parameter-group-name test-sqlserver-se-2017 \
--parameters "ParameterName='clr enabled',ParameterValue=1,ApplyMethod=immediate"
```
Salida:
```
{
"DBParameterGroupName": "test-sqlserver-se-2017"
}
```
Para obtener más información, consulte [Modificación de parámetros de un grupo de parámetros de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html#USER_WorkingWithParamGroups.Modifying) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [ModifyDBParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-proxy-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-proxy-endpoint`.
**AWS CLI**
**Para modificar un punto de conexión de proxy de base de datos para una base de datos de RDS**
El siguiente ejemplo de `modify-db-proxy-endpoint` modifica un punto de conexión de proxy de base de datos `proxyEndpoint` para establecer el tiempo de espera de lectura en 65 segundos.
```
aws rds modify-db-proxy-endpoint \
--db-proxy-endpoint-name proxyEndpoint \
--cli-read-timeout 65
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Modificación de un punto de conexión de proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.ModifyingEndpoint) en la *Guía del usuario de Amazon RDS* y [Viewing a proxy endpoint](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-endpoints.html#rds-proxy-endpoints.ModifyingEndpoint) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [ModifyDbProxyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-proxy-target-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-proxy-target-group`.
**AWS CLI**
**Para modificar los puntos de conexión de un proxy de base de datos**
El siguiente ejemplo de `modify-db-proxy-target-group` modifica un grupo de destino de proxy de base de datos para establecer el número máximo de conexiones en un 80 % y el máximo de conexiones inactivas en un 10 %.
```
aws rds modify-db-proxy-target-group \
--target-group-name default \
--db-proxy-name proxyExample \
--connection-pool-config MaxConnectionsPercent=80,MaxIdleConnectionsPercent=10
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Modificación de RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) en la *Guía del usuario de Amazon RDS* y [Modificación de RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [ModifyDbProxyTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy-target-group.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-proxy`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-proxy`.
**AWS CLI**
**Para modificar un proxy de base de datos para una base de datos de RDS**
El siguiente ejemplo de `modify-db-proxy` modifica un proxy de base de datos denominado `proxyExample` para que requiera SSL para sus conexiones.
```
aws rds modify-db-proxy \
--db-proxy-name proxyExample \
--require-tls
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Modificación de RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) en la *Guía del usuario de Amazon RDS* y [Creación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-managing.html#rds-proxy-modifying-proxy) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [ModifyDbProxy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-proxy.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-shard-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-shard-group`.
**AWS CLI**
**Ejemplo 1: modificar un grupo de partición de base de datos**
El siguiente ejemplo de `modify-db-shard-group` cambia la capacidad máxima de un grupo de partición de base de datos.
```
aws rds modify-db-shard-group \
--db-shard-group-identifier my-db-shard-group \
--max-acu 1000
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte la sección sobre [Clústeres de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 2: describir sus grupos de partición de base de datos**
En el siguiente ejemplo de `describe-db-shard-groups`, se recuperan los detalles sobre los grupos de partición de base de datos después de ejecutar `modify-db-shard-group`. La capacidad máxima del grupo de partición de base de datos `my-db-shard-group` es ahora de 1000 unidades de capacidad de Aurora (ACU).
```
aws rds describe-db-shard-groups
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte la sección sobre [Clústeres de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [ModifyDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-shard-group.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-snapshot-attribute`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-snapshot-attribute`.
**AWS CLI**
**Ejemplo 1: habilitar dos cuentas de AWS para que restauren una instantánea de base de datos**
El siguiente ejemplo de `modify-db-snapshot-attribute` da permiso a dos cuentas de AWS, con los identificadores `111122223333` y `444455556666`, para restaurar la instantánea de base de datos denominada `mydbsnapshot`.
```
aws rds modify-db-snapshot-attribute \
--db-snapshot-identifier mydbsnapshot \
--attribute-name restore \
--values-to-add {"111122223333","444455556666"}
```
Salida:
```
{
"DBSnapshotAttributesResult": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"111122223333",
"444455556666"
]
}
]
}
}
```
Para obtener más información, consulte [Uso compartido de una instantánea](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: evitar que una cuenta de AWS restaure una instantánea de base de datos**
El siguiente ejemplo de `modify-db-snapshot-attribute` elimina el permiso de una cuenta de AWS concreta para restaurar la instantánea de base de datos denominada `mydbsnapshot`. Al especificar una sola cuenta, el identificador de la cuenta no puede estar entre comillas o corchetes.
```
aws rds modify-db-snapshot-attribute \
--db-snapshot-identifier mydbsnapshot \
--attribute-name restore \
--values-to-remove 444455556666
```
Salida:
```
{
"DBSnapshotAttributesResult": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"111122223333"
]
}
]
}
}
```
Para obtener más información, consulte [Uso compartido de una instantánea](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [ModifyDbSnapshotAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot-attribute.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-snapshot-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-snapshot-attributes`.
**AWS CLI**
**Para modificar un atributo de la instantánea de una base de datos**
El siguiente ejemplo de `modify-db-snapshot-attribute` permite a dos identificadores de cuenta de AWS, `111122223333` y `444455556666`, restaurar la instantánea de base de datos denominada `mydbsnapshot`.
```
aws rds modify-db-snapshot-attribute \
--db-snapshot-identifier mydbsnapshot \
--attribute-name restore \
--values-to-add '["111122223333","444455556666"]'
```
Salida:
```
{
"DBSnapshotAttributesResult": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"111122223333",
"444455556666"
]
}
]
}
}
```
Para obtener más información, consulte [Uso compartido de una instantánea](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ShareSnapshot.html#USER_ShareSnapshot.Sharing) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [ModifyDbSnapshotAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-snapshot`.
**AWS CLI**
**Para modificar una instantánea de base de datos**
En el siguiente ejemplo de `modify-db-snapshot` se actualiza una instantánea de PostgreSQL 10.6 denominada `db5-snapshot-upg-test` a PostgreSQL 11.7. La nueva versión del motor de base de datos se muestra cuando la instantánea ha terminado de actualizarse y su estado está **disponible**.
```
aws rds modify-db-snapshot \
--db-snapshot-identifier db5-snapshot-upg-test \
--engine-version 11.7
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Upgrading a PostgreSQL DB Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBSnapshot.PostgreSQL.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [ModifyDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-db-subnet-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-db-subnet-group`.
**AWS CLI**
**Para modificar un grupo de subred de base de datos**
El siguiente ejemplo de `modify-db-subnet-group` agrega una subred con el ID `subnet-08e41f9e230222222` al grupo de subredes de base de datos denominado `mysubnetgroup`. Para mantener las subredes existentes en el grupo de subredes, incluya sus ID como valores en la opción `--subnet-ids`. Asegúrese de tener subredes con, al menos, dos zonas de disponibilidad distintas en el grupo de subred de base de datos.
```
aws rds modify-db-subnet-group \
--db-subnet-group-name mysubnetgroup \
--subnet-ids '["subnet-0a1dc4e1a6f123456","subnet-070dd7ecb3aaaaaaa","subnet-00f5b198bc0abcdef","subnet-08e41f9e230222222"]'
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Paso 3: Crear un grupo de subredes de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.CreateDBSubnetGroup) en la *Guía del usuario de Amazon RDS*.
+ Para obtener detalles sobre la API, consulte [ModifyDbSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-db-subnet-group.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-event-subscription`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-event-subscription`.
**AWS CLI**
**Para modificar una suscripción a un evento**
El siguiente ejemplo de `modify-event-subscription` deshabilita la suscripción al evento especificada, de modo que ya no publique notificaciones en el tema especificado de Amazon Simple Notification Service.
```
aws rds modify-event-subscription \
--subscription-name my-instance-events \
--no-enabled
```
Salida:
```
{
"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
}
}
```
+ Para obtener información sobre la API, consulte [ModifyEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-event-subscription.html) en la *Referencia de comandos de la AWS CLI*.
### `modify-global-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `modify-global-cluster`.
**AWS CLI**
**Para modificar un clúster de base de datos global**
En el siguiente ejemplo de `modify-global-cluster`, se habilita la protección contra la eliminación de un clúster de base de datos global compatible con Aurora MySQL.
```
aws rds modify-global-cluster \
--global-cluster-identifier myglobalcluster \
--deletion-protection
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Administración de una base de datos global de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [ModifyGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/modify-global-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `promote-read-replica-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `promote-read-replica-db-cluster`.
**AWS CLI**
**Para promocionar una réplica de lectura del clúster de base de datos**
En el siguiente ejemplo de `promote-read-replica-db-cluster`, se promociona que la réplica de lectura especificada sea un clúster de base de datos independiente.
```
aws rds promote-read-replica-db-cluster \
--db-cluster-identifier mydbcluster-1
```
Salida:
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1c"
],
"BackupRetentionPeriod": 1,
"DatabaseName": "",
"DBClusterIdentifier": "mydbcluster-1",
...some output truncated...
}
}
```
Para obtener más información, consulte [Promoting a read replica to be a DB cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Replication.CrossRegion.html#AuroraMySQL.Replication.CrossRegion.Promote) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [PromoteReadReplicaDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/promote-read-replica-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `promote-read-replica`
En el siguiente ejemplo de código, se muestra cómo utilizar `promote-read-replica`.
**AWS CLI**
**Para promocionar una réplica de lectura**
En el siguiente ejemplo de `promote-read-replica`, se promociona que la réplica de lectura especificada sea una instancia de base de datos independiente.
```
aws rds promote-read-replica \
--db-instance-identifier test-instance-repl
```
Salida:
```
{
"DBInstance": {
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl",
"StorageType": "standard",
"ReadReplicaSourceDBInstanceIdentifier": "test-instance",
"DBInstanceStatus": "modifying",
...some output truncated...
}
}
```
+ Para obtener información acerca de la API, consulte [PromoteReadReplica](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/promote-read-replica.html) en la *Referencia de comandos de la AWS CLI*.
### `purchase-reserved-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `purchase-reserved-db-instance`.
**AWS CLI**
**Para adquirir una oferta de instancia de base de datos reservada**
En el ejemplo siguiente de `purchase-reserved-db-instances-offering`, se adquiere una oferta de instancia de base de datos reservada. `reserved-db-instances-offering-id` debe ser un identificador de oferta válido, tal como lo devuelve el comando `describe-reserved-db-instances-offering`.
aws rds purchase-reserved-db-instances-offering --reserved-db-instances-offering-id 438012d3-4a52-4cc7-b2e3-8dff72e0e706
+ Para obtener información sobre la API, consulte [PurchaseReservedDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/purchase-reserved-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `purchase-reserved-db-instances-offerings`
En el siguiente ejemplo de código, se muestra cómo utilizar `purchase-reserved-db-instances-offerings`.
**AWS CLI**
**Ejemplo 1: buscar una instancia de base de datos reservada y comprarla**
En el siguiente ejemplo de `describe-reserved-db-instances-offerings`, se generan listas de las instancias de base de datos MySQL reservadas disponibles con la clase de instancia db.t2.micro y una duración de un año. El ID de oferta es obligatorio para comprar una instancia de base de datos reservada.
```
aws rds describe-reserved-db-instances-offerings \
--product-description mysql \
--db-instance-class db.t2.micro \
--duration 1
```
Salida:
```
{
"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 ...
]
}
```
Para obtener más información, consulte la sección sobre [Instancias de base de datos reservadas para Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: adquirir una instancia de base de datos reservada**
El siguiente ejemplo de `purchase-reserved-db-instances-offering` muestra cómo comprar la oferta de instancia de base de datos reservada del ejemplo anterior.
aws rds purchase-reserved-db-instances-offering --reserved-db-instances-offering-id 8ba30be1-b9ec-447f-8f23-6114e3f4c7b4
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte la sección sobre [Instancias de base de datos reservadas para Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithReservedDBInstances.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener más información sobre la API, consulte [PurchaseReservedDbInstancesOfferings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/purchase-reserved-db-instances-offerings.html) en la *Referencia de comandos de la AWS CLI*.
### `reboot-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `reboot-db-instance`.
**AWS CLI**
**Reinicio de una instancia de base de datos**
En el siguiente ejemplo `reboot-db-instance`, se inicia un reinicio de la instancia de base de datos especificada.
```
aws rds reboot-db-instance \
--db-instance-identifier test-mysql-instance
```
Salida:
```
{
"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...
}
}
```
Para obtener más información, consulte [Reinicio de una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [RebootDBInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reboot-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `reboot-db-shard-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `reboot-db-shard-group`.
**AWS CLI**
**Ejemplo 1: reiniciar un grupo de partición de base de datos**
En el siguiente ejemplo de `reboot-db-shard-group`, se reinicia un grupo de partición de base de datos.
```
aws rds reboot-db-shard-group \
--db-shard-group-identifier my-db-shard-group
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Reinicio de un clúster de base de datos de Amazon Aurora o de una instancia de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RebootCluster.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 2: describir sus grupos de partición de base de datos**
En el siguiente ejemplo de `describe-db-shard-groups`, se recuperan los detalles sobre los grupos de partición de base de datos después de ejecutar `reboot-db-shard-group`. El grupo de partición de base de datos `my-db-shard-group` se está reiniciando ahora.
```
aws rds describe-db-shard-groups
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Reinicio de un clúster de base de datos de Amazon Aurora o de una instancia de base de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RebootCluster.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener más información sobre la API, consulte [RebootDbShardGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reboot-db-shard-group.html) en la *Referencia de comandos de la AWS CLI*.
### `register-db-proxy-targets`
En el siguiente ejemplo de código, se muestra cómo utilizar `register-db-proxy-targets`.
**AWS CLI**
**Para registrar un proxy de base de datos con una base de datos**
En el siguiente ejemplo de `register-db-proxy-targets`, se crea la asociación entre una base de datos y un proxy.
```
aws rds register-db-proxy-targets \
--db-proxy-name proxyExample \
--db-cluster-identifiers database-5
```
Salida:
```
{
"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"
}
}
]
}
```
Para obtener más información, consulte [Creación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-proxy-setup.html#rds-proxy-creating) en la *Guía del usuario de Amazon RDS* y [Creación de un RDS Proxy](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-proxy-setup.html#rds-proxy-creating) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [RegisterDbProxyTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/register-db-proxy-targets.html) en la *Referencia de comandos de la AWS CLI*.
### `remove-from-global-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-from-global-cluster`.
**AWS CLI**
**Para separar un clúster secundario de Aurora de un clúster de base de datos global de Aurora**
El siguiente ejemplo de `remove-from-global-cluster` separa un clúster secundario de Aurora de un clúster de base de datos global de Aurora. El clúster pasa de ser de solo lectura a un clúster independiente con capacidad de lectura y escritura.
```
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
```
Salida:
```
{
"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"
}
]
}
}
```
Para obtener más información, consulte [Eliminación de un clúster de una base de datos global de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-managing.html#aurora-global-database-detaching) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [RemoveFromGlobalCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-from-global-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `remove-option-from-option-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-option-from-option-group`.
**AWS CLI**
**Para eliminar una opción de un grupo de opciones**
En el ejemplo siguiente `remove-option-from-option-group` se elimina la opción `OEM` de `myoptiongroup`.
```
aws rds remove-option-from-option-group \
--option-group-name myoptiongroup \
--options OEM \
--apply-immediately
```
Salida:
```
{
"OptionGroup": {
"OptionGroupName": "myoptiongroup",
"OptionGroupDescription": "Test",
"EngineName": "oracle-ee",
"MajorEngineVersion": "19",
"Options": [],
"AllowsVpcAndNonVpcInstanceMemberships": true,
"OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:myoptiongroup"
}
}
```
Para obtener más información, consulte [Quitar una opción de un grupo de opciones](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithOptionGroups.html#USER_WorkingWithOptionGroups.RemoveOption) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [RemoveOptionFromOptionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-option-from-option-group.html) en la *Referencia de comandos de la AWS CLI*.
### `remove-role-from-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-role-from-db-cluster`.
**AWS CLI**
**Para desasociar un rol de AWS Identity and Access Management (IAM) de un clúster de base de datos**
En el siguiente ejemplo de `remove-role-from-db-cluster`, se quita un rol de un clúster de base de datos.
```
aws rds remove-role-from-db-cluster \
--db-cluster-identifier mydbcluster \
--role-arn arn:aws:iam::123456789012:role/RDSLoadFromS3
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Asociación de un rol de IAM con un clúster de base de datos Amazon Aurora MySQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.IAM.AddRoleToDBCluster.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [RemoveRoleFromDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-role-from-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `remove-role-from-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-role-from-db-instance`.
**AWS CLI**
**Para desasociar un rol de AWS Identity and Access Management (IAM) de una instancia de base de datos**
El siguiente ejemplo de `remove-role-from-db-instance` elimina el rol denominado `rds-s3-integration-role` de una instancia de base de datos de Oracle denominada `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
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Desactivación de la integración de RDS for SQL Server con S3](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/User.SQLServer.Options.S3-integration.html#Appendix.SQLServer.Options.S3-integration.disabling) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [RemoveRoleFromDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-role-from-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `remove-source-identifier-from-subscription`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-source-identifier-from-subscription`.
**AWS CLI**
**Para quitar un identificador de origen de una suscripción**
En el siguiente ejemplo de `remove-source-identifier`, se elimina el identificador de origen especificado de una suscripción existente.
```
aws rds remove-source-identifier-from-subscription \
--subscription-name my-instance-events \
--source-identifier test-instance-repl
```
Salida:
```
{
"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
}
}
```
+ Para obtener información sobre la API, consulte [RemoveSourceIdentifierFromSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-source-identifier-from-subscription.html) en la *Referencia de comandos de la AWS CLI*.
### `remove-tags-from-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-tags-from-resource`.
**AWS CLI**
**Para eliminar etiquetas de un recurso**
En el siguiente ejemplo de `remove-tags-from-resource`, se eliminan las etiquetas de un recurso.
```
aws rds remove-tags-from-resource \
--resource-name arn:aws:rds:us-east-1:123456789012:db:mydbinstance \
--tag-keys Name Environment
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Etiquetado de los recursos de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) en la *Guía del usuario de Amazon RDS* y [Etiquetado de los recursos de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [RemoveTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/remove-tags-from-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `reset-db-cluster-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `reset-db-cluster-parameter-group`.
**AWS CLI**
**Ejemplo 1: restablecimiento de todos los parámetros a sus valores predeterminados**
El siguiente ejemplo de `reset-db-cluster-parameter-group` restablece todos los valores de los parámetros de un grupo de parámetros de clúster de base de datos creado por el cliente a sus valores predeterminados.
```
aws rds reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbclpg \
--reset-all-parameters
```
Salida:
```
{
"DBClusterParameterGroupName": "mydbclpg"
}
```
Para obtener más información, consulte [Working with DB Parameter Groups and DB Cluster Parameter Groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 2: restablecer los parámetros específicos a sus valores predeterminados**
El siguiente ejemplo de `reset-db-cluster-parameter-group` restablece todos los valores de los parámetros de unos parámetros especificados a sus valores predeterminados en un grupo de parámetros de clúster de base de datos creado por el cliente.
```
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"
```
Salida:
```
{
"DBClusterParameterGroupName": "mydbclpg"
}
```
Para obtener más información, consulte [Working with DB Parameter Groups and DB Cluster Parameter Groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [ResetDbClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reset-db-cluster-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `reset-db-parameter-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `reset-db-parameter-group`.
**AWS CLI**
**Ejemplo 1: restablecimiento de todos los parámetros a sus valores predeterminados**
El siguiente ejemplo de `reset-db-parameter-group` restablece todos los valores de los parámetros de un grupo de parámetros de base de datos creado por el cliente a sus valores predeterminados.
```
aws rds reset-db-parameter-group \
--db-parameter-group-name mypg \
--reset-all-parameters
```
Salida:
```
{
"DBParameterGroupName": "mypg"
}
```
Para obtener más información, consulte [Working with DB parameter groups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon RDS* y [Working with DB parameter groups and DB cluster parameter groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
**Ejemplo 2: restablecer los parámetros específicos a sus valores predeterminados**
El siguiente ejemplo de `reset-db-parameter-group` restablece todos los valores de los parámetros de unos parámetros específicos a sus valores predeterminados en un grupo de parámetros de base de datos creado por el cliente.
```
aws rds reset-db-parameter-group \
--db-parameter-group-name mypg \
--parameters "ParameterName=max_connections,ApplyMethod=immediate" \
"ParameterName=max_allowed_packet,ApplyMethod=immediate"
```
Salida:
```
{
"DBParameterGroupName": "mypg"
}
```
Para obtener más información, consulte [Working with DB parameter groups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon RDS* y [Working with DB parameter groups and DB cluster parameter groups](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [ResetDbParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/reset-db-parameter-group.html) en la *Referencia de comandos de la AWS CLI*.
### `restore-db-cluster-from-s3`
En el siguiente ejemplo de código, se muestra cómo utilizar `restore-db-cluster-from-s3`.
**AWS CLI**
**Para restaurar un clúster de base de datos de Amazon Aurora desde Amazon S3**
El siguiente ejemplo de `restore-db-cluster-from-s3` restaura un clúster de base de datos compatible con Amazon Aurora MySQL versión 5.7 a partir de un archivo de copia de seguridad de base de datos de MySQL 5.7 en 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
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Migrating Data from MySQL by Using an Amazon S3 Bucket](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Migrating.ExtMySQL.html#AuroraMySQL.Migrating.ExtMySQL.S3) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles de la API, consulte [RestoreDbClusterFromS3](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-from-s3.html) en la *Referencia de comandos de la AWS CLI*.
### `restore-db-cluster-from-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `restore-db-cluster-from-snapshot`.
**AWS CLI**
**Para para restaurar un clúster de base de datos desde una instantánea**
A continuación, `restore-db-cluster-from-snapshot` restaura un clúster de base de datos Aurora PostgreSQL compatible con la versión 10.7 de PostgreSQL a partir de una instantánea de clúster de base de datos denominada `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
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Restauración de una instantánea de clúster de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_RestoreFromSnapshot.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [RestoreDbClusterFromSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-from-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `restore-db-cluster-to-point-in-time`
En el siguiente ejemplo de código, se muestra cómo utilizar `restore-db-cluster-to-point-in-time`.
**AWS CLI**
**Para restaurar un clúster de bases de datos a un momento indicado**
En el siguiente ejemplo de `restore-db-cluster-to-point-in-time`, se restaura el clúster de base de datos denominado `database-4` al último momento posible. Si se usa `copy-on-write` como tipo de restauración, se restaura el nuevo clúster de base de datos como un clon del clúster de base de datos de origen.
```
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
```
Salida:
```
{
"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
}
}
```
Para obtener más información, consulte [Restauración de un clúster de base de dato a un momento indicado](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PIT.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [RestoreDbClusterToPointInTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-cluster-to-point-in-time.html) en la *Referencia de comandos de la AWS CLI*.
### `restore-db-instance-from-db-snapshot`
En el siguiente ejemplo de código, se muestra cómo utilizar `restore-db-instance-from-db-snapshot`.
**AWS CLI**
**Para restaurar una instancia de base de datos a partir de una instantánea de base de datos**
El siguiente ejemplo de `restore-db-instance-from-db-snapshot` crea una nueva instancia de base de datos denominada `db7-new-instance` con la clase de instancia de base de datos `db.t3.small` de la instantánea de base de datos especificada. La instancia de base de datos de origen de la que se tomó la instantánea utiliza una clase de instancia de base de datos obsoleta, por lo que no se puede actualizar.
```
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
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Restoring from a DB Snapshot](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RestoreFromSnapshot.html) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [RestoreDbInstanceFromDbSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-from-db-snapshot.html) en la *Referencia de comandos de la AWS CLI*.
### `restore-db-instance-from-s3`
En el siguiente ejemplo de código, se muestra cómo utilizar `restore-db-instance-from-s3`.
**AWS CLI**
**Para restaurar una instancia de base de datos a partir de una copia de seguridad en Amazon S3**
En el siguiente ejemplo de `restore-db-instance-from-s3`, se crea una nueva instancia de base de datos con el nombre `restored-test-instance` de una copia de seguridad existente en el bucket de 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
```
+ Para obtener detalles de la API, consulte [RestoreDbInstanceFromS3](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-from-s3.html) en la *Referencia de comandos de la AWS CLI*.
### `restore-db-instance-to-point-in-time`
En el siguiente ejemplo de código, se muestra cómo utilizar `restore-db-instance-to-point-in-time`.
**AWS CLI**
**Ejemplo 1: restaurar una instancia de base de datos a un momento en el tiempo**
En el siguiente ejemplo de `restore-db-instance-to-point-in-time`, se restaura `test-instance` a una nueva instancia de base de datos denominada `restored-test-instance`, en la hora especificada.
```
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
```
Salida:
```
{
"DBInstance": {
"AllocatedStorage": 20,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:restored-test-instance",
"DBInstanceStatus": "creating",
"DBInstanceIdentifier": "restored-test-instance",
...some output omitted...
}
}
```
Para obtener más información, consulte [Restauración de una instancia de base de datos a un momento especificado](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIT.html) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: restaurar una instancia de base de datos a un tiempo especificado desde una copia de seguridad replicada**
El siguiente ejemplo de `restore-db-instance-to-point-in-time` restaura una instancia de base de datos de Oracle a la hora especificada a partir de una copia de seguridad automatizada replicada.
```
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
```
Salida:
```
{
"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": []
}
}
```
Para obtener más información, consulte [Restoring to a specified time from a replicated backup](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.PiTR) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [RestoreDbInstanceToPointInTime](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/restore-db-instance-to-point-in-time.html) en la *Referencia de comandos de la AWS CLI*.
### `start-activity-stream`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-activity-stream`.
**AWS CLI**
**Para iniciar un flujo de actividad de la base de datos**
En el siguiente ejemplo de `start-activity-stream`, se inicia un flujo de actividad asíncrona para supervisar un clúster de Aurora denominado 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
```
Salida:
```
{
"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
}
```
Para obtener más información, consulte [Inicio de una secuencia de actividades de la base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/DBActivityStreams.html#DBActivityStreams.Enabling) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [StartActivityStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-activity-stream.html) en la *Referencia de comandos de la AWS CLI*.
### `start-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-db-cluster`.
**AWS CLI**
**Para iniciar un clúster de base de datos**
El siguiente ejemplo de `start-db-cluster` inicia un clúster de base de datos y sus instancias de base de datos.
```
aws rds start-db-cluster \
--db-cluster-identifier mydbcluster
```
Salida:
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1a",
"us-east-1e",
"us-east-1b"
],
"BackupRetentionPeriod": 1,
"DatabaseName": "mydb",
"DBClusterIdentifier": "mydbcluster",
...some output truncated...
}
}
```
Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-cluster-stop-start.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener detalles sobre la API, consulte [StartDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `start-db-instance-automated-backups-replication`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-db-instance-automated-backups-replication`.
**AWS CLI**
**Para habilitar copias de seguridad automatizadas entre regiones**
El siguiente ejemplo de `start-db-instance-automated-backups-replication` replica las copias de seguridad automatizadas desde una instancia de base de datos en el Este de EE. UU. (Norte de Virginia) hasta el Oeste de EE. UU. (Oregón). El período de retención de la copia de seguridad es de 14 días.
```
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
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Habilitación de copias de seguridad automatizadas entre regiones](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.Replicating.Enable) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [StartDbInstanceAutomatedBackupsReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-instance-automated-backups-replication.html) en la *Referencia de comandos de la AWS CLI*.
### `start-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-db-instance`.
**AWS CLI**
**Para iniciar una instancia de base de datos**
En el siguiente ejemplo de `start-db-instance`, se inicia una instancia de base de datos especificada.
```
aws rds start-db-instance \
--db-instance-identifier test-instance
```
Salida:
```
{
"DBInstance": {
"DBInstanceStatus": "starting",
...some output truncated...
}
}
```
+ Para obtener información sobre la API, consulte [StartDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `start-export-task`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-export-task`.
**AWS CLI**
**Para exportar una instantánea a Amazon S3**
El siguiente ejemplo de `start-export-task` exporta una instantánea de base de datos denominada `db5-snapshot-test` al bucket de Amazon S3 denominado `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
```
Salida:
```
{
"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
}
```
Para obtener más información, consulte [Exportación de una instantánea de base de datos a un bucket de Amazon S3](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Exporting) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [StartExportTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/start-export-task.html) en la *Referencia de comandos de la AWS CLI*.
### `stop-activity-stream`
En el siguiente ejemplo de código, se muestra cómo utilizar `stop-activity-stream`.
**AWS CLI**
**Para detener un flujo de actividades de la base de datos**
En el siguiente ejemplo de `stop-activity-stream`, se detiene un flujo de actividad en un clúster de Aurora denominado 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
```
Salida:
```
{
"KmsKeyId": "arn:aws:kms:us-east-1:1234567890123:key/a12c345d-6ef7-890g-h123-456i789jk0l1",
"KinesisStreamName": "aws-rds-das-cluster-0ABCDEFGHI1JKLM2NOPQ3R4S",
"Status": "stopping"
}
```
Para obtener más información, consulte [Detención de un flujo de actividad](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/DBActivityStreams.html#DBActivityStreams.Disabling) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [StopActivityStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-activity-stream.html) en la *Referencia de comandos de la AWS CLI*.
### `stop-db-cluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `stop-db-cluster`.
**AWS CLI**
**Para detener un clúster de base de datos**
El siguiente ejemplo de `stop-db-cluster` detiene un clúster de base de datos y sus instancias de base de datos.
```
aws rds stop-db-cluster \
--db-cluster-identifier mydbcluster
```
Salida:
```
{
"DBCluster": {
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1a",
"us-east-1e",
"us-east-1b"
],
"BackupRetentionPeriod": 1,
"DatabaseName": "mydb",
"DBClusterIdentifier": "mydbcluster",
...some output truncated...
}
}
```
Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-cluster-stop-start.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener información sobre la API, consulte [StopDbCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-cluster.html) en la *Referencia de comandos de la AWS CLI*.
### `stop-db-instance-automated-backups-replication`
En el siguiente ejemplo de código, se muestra cómo utilizar `stop-db-instance-automated-backups-replication`.
**AWS CLI**
**Para dejar de replicar las copias de seguridad automatizadas**
El siguiente `stop-db-instance-automated-backups-replication` finaliza la replicación de copias de seguridad automatizadas en la región del Oeste de EE. UU. (Oregón). Las copias de seguridad replicadas se conservan de acuerdo con el período de retención de copias de seguridad establecido.
```
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"
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Detención de la replicación de la copia de seguridad automatizada](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html#AutomatedBackups.StopReplicating) en la *Guía del usuario de Amazon RDS*.
+ Para obtener información sobre la API, consulte [StopDbInstanceAutomatedBackupsReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-instance-automated-backups-replication.html) en la *Referencia de comandos de la AWS CLI*.
### `stop-db-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `stop-db-instance`.
**AWS CLI**
**Para detener una instancia de base de datos**
En el siguiente ejemplo de `stop-db-instance`, se detiene una instancia de base de datos especificada.
```
aws rds stop-db-instance \
--db-instance-identifier test-instance
```
Salida:
```
{
"DBInstance": {
"DBInstanceStatus": "stopping",
...some output truncated...
}
}
```
+ Para obtener información sobre la API, consulte [StopDbInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/stop-db-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `switchover-blue-green-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `switchover-blue-green-deployment`.
**AWS CLI**
**Ejemplo 1: cambiar una implementación azul/verde por una instancia de base de datos de RDS**
En el siguiente ejemplo de `switchover-blue-green-deployment`, se promueve que el entorno verde especificado sea el nuevo entorno de producción.
```
aws rds switchover-blue-green-deployment \
--blue-green-deployment-identifier bgd-wi89nwzglccsfake \
--switchover-timeout 300
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Cambio de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments-switching.html) en la *Guía del usuario de Amazon RDS*.
**Ejemplo 2: promocionar una implementación azul/verde para un clúster de base de datos en Aurora MySQL**
En el siguiente ejemplo de `switchover-blue-green-deployment`, se promueve que el entorno verde especificado sea el nuevo entorno de producción.
```
aws rds switchover-blue-green-deployment \
--blue-green-deployment-identifier bgd-wi89nwzglccsfake \
--switchover-timeout 300
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Cambio de una implementación azul/verde](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments-switching.html) en la *Guía del usuario de Amazon Aurora*.
+ Para obtener más información sobre la API, consulte [SwitchoverBlueGreenDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/switchover-blue-green-deployment.html) en la *Referencia de comandos de la AWS CLI*.