Creación de un nombre ARN Obtención de un ARN existente

Uso de nombres de recursos de Amazon (ARN) en Amazon RDS

Cada recurso que se crea en Amazon Web Services se identifica de forma inequívoca mediante un nombre de recurso de Amazon (ARN). Para determinadas operaciones de Amazon RDS, debe identificar de forma inequívoca un recurso de Amazon RDS mediante su ARN. Por ejemplo, al crear una réplica de lectura de una instancia de base de datos de RDS, debe proporcionar el ARN de la instancia de base de datos de origen.

Creación de un nombre ARN para Amazon RDS

Cada recurso que se crea en Amazon Web Services se identifica de forma inequívoca mediante un nombre de recurso de Amazon (ARN). Puede crear un ARN para un recurso de Amazon RDS utilizando la siguiente sintaxis.

arn:aws:rds:<region>:<account number>:<resourcetype>:<name>

Nombre de la región	Región	Punto de conexión	Protocolo
Este de EE. UU. (Ohio)	us-east-2	rds.us-east-2.amazonaws.com rds-fips.us-east-2.api.aws rds.us-east-2.api.aws rds-fips.us-east-2.amazonaws.com	HTTPS HTTPS HTTPS HTTPS
Este de EE. UU. (Norte de Virginia)	us-east-1	rds.us-east-1.amazonaws.com rds-fips.us-east-1.api.aws rds-fips.us-east-1.amazonaws.com rds.us-east-1.api.aws	HTTPS HTTPS HTTPS HTTPS
Oeste de EE. UU. (Norte de California)	us-west-1	rds.us-west-1.amazonaws.com rds.us-west-1.api.aws rds-fips.us-west-1.amazonaws.com rds-fips.us-west-1.api.aws	HTTPS HTTPS HTTPS HTTPS
Oeste de EE. UU. (Oregón)	us-west-2	rds.us-west-2.amazonaws.com rds-fips.us-west-2.amazonaws.com rds.us-west-2.api.aws rds-fips.us-west-2.api.aws	HTTPS HTTPS HTTPS HTTPS
África (Ciudad del Cabo)	af-south-1	rds.af-south-1.amazonaws.com rds.af-south-1.api.aws	HTTPS HTTPS
Asia-Pacífico (Hong Kong)	ap-east-1	rds.ap-east-1.amazonaws.com rds.ap-east-1.api.aws	HTTPS HTTPS
Asia-Pacífico (Hyderabad)	ap-south-2	rds.ap-south-2.amazonaws.com rds.ap-south-2.api.aws	HTTPS HTTPS
Asia-Pacífico (Yakarta)	ap-southeast-3	rds.ap-southeast-3.amazonaws.com rds.ap-southeast-3.api.aws	HTTPS HTTPS
Asia-Pacífico (Melbourne)	ap-southeast-4	rds.ap-southeast-4.amazonaws.com rds.ap-southeast-4.api.aws	HTTPS HTTPS
Asia-Pacífico (Bombay)	ap-south-1	rds.ap-south-1.amazonaws.com rds.ap-south-1.api.aws	HTTPS HTTPS
Asia-Pacífico (Osaka)	ap-northeast-3	rds.ap-northeast-3.amazonaws.com rds.ap-northeast-3.api.aws	HTTPS HTTPS
Asia-Pacífico (Seúl)	ap-northeast-2	rds.ap-northeast-2.amazonaws.com rds.ap-northeast-2.api.aws	HTTPS HTTPS
Asia-Pacífico (Singapur)	ap-southeast-1	rds.ap-southeast-1.amazonaws.com rds.ap-southeast-1.api.aws	HTTPS HTTPS
Asia-Pacífico (Sídney)	ap-southeast-2	rds.ap-southeast-2.amazonaws.com rds.ap-southeast-2.api.aws	HTTPS HTTPS
Asia-Pacífico (Tokio)	ap-northeast-1	rds.ap-northeast-1.amazonaws.com rds.ap-northeast-1.api.aws	HTTPS HTTPS
Canadá (centro)	ca-central-1	rds.ca-central-1.amazonaws.com rds.ca-central-1.api.aws rds-fips.ca-central-1.api.aws rds-fips.ca-central-1.amazonaws.com	HTTPS HTTPS HTTPS HTTPS
Oeste de Canadá (Calgary)	ca-west-1	rds.ca-west-1.amazonaws.com rds-fips.ca-west-1.amazonaws.com	HTTPS HTTPS
Europa (Fráncfort)	eu-central-1	rds.eu-central-1.amazonaws.com rds.eu-central-1.api.aws	HTTPS HTTPS
Europa (Irlanda)	eu-west-1	rds.eu-west-1.amazonaws.com rds.eu-west-1.api.aws	HTTPS HTTPS
Europa (Londres)	eu-west-2	rds.eu-west-2.amazonaws.com rds.eu-west-2.api.aws	HTTPS HTTPS
Europa (Milán)	eu-south-1	rds.eu-south-1.amazonaws.com rds.eu-south-1.api.aws	HTTPS HTTPS
Europa (París)	eu-west-3	rds.eu-west-3.amazonaws.com rds.eu-west-3.api.aws	HTTPS HTTPS
Europa (España)	eu-south-2	rds.eu-south-2.amazonaws.com rds.eu-south-2.api.aws	HTTPS HTTPS
Europa (Estocolmo)	eu-north-1	rds.eu-north-1.amazonaws.com rds.eu-north-1.api.aws	HTTPS HTTPS
Europa (Zúrich)	eu-central-2	rds.eu-central-2.amazonaws.com rds.eu-central-2.api.aws	HTTPS HTTPS
Israel (Tel Aviv)	il-central-1	rds.il-central-1.amazonaws.com rds.il-central-1.api.aws	HTTPS HTTPS
Medio Oriente (Baréin)	me-south-1	rds.me-south-1.amazonaws.com rds.me-south-1.api.aws	HTTPS HTTPS
Medio Oriente (EAU)	me-central-1	rds.me-central-1.amazonaws.com rds.me-central-1.api.aws	HTTPS HTTPS
América del Sur (São Paulo)	sa-east-1	rds.sa-east-1.amazonaws.com rds.sa-east-1.api.aws	HTTPS HTTPS
AWS GovCloud (Este de EE. UU.)	us-gov-east-1	rds.us-gov-east-1.amazonaws.com rds.us-gov-east-1.api.aws	HTTPS HTTPS
AWS GovCloud (Oeste de EE.UU.)	us-gov-west-1	rds.us-gov-west-1.amazonaws.com rds.us-gov-west-1.api.aws	HTTPS HTTPS

En la siguiente tabla se muestra el formato que debe utilizar al crear un ARN para un tipo de recurso concreto de Amazon RDS.

Tipo de recurso	Formato de ARN
Instancia de base de datos	arn:aws:rds:`<region>`:`<account>`:db:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance-1`
Clúster de base de datos	arn:aws:rds:`<region>`:`<account>`:cluster:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1`
Suscripción a eventos	arn:aws:rds:`<region>`:`<account>`:es:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:es:my-subscription`
Grupo de opciones de base de datos	arn:aws:rds:`<region>`:`<account>`:og:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:og:my-og`
DB Parameter Group (Grupo de parámetros de base de datos)	arn:aws:rds:`<region>`:`<account>`:pg:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs`
Grupo de parámetros de clúster de base de datos	arn:aws:rds:`<region>`:`<account>`:cluster-pg:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone`
Instancia de base de datos reservada	arn:aws:rds:`<region>`:`<account>`:ri:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:ri:my-reserved-postgresql`
Grupo de seguridad de base de datos	arn:aws:rds:`<region>`:`<account>`:secgrp:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:secgrp:my-public`
Instantánea de base de datos automatizada	arn:aws:rds:`<region>`:`<account>`:snapshot:rds:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:snapshot:rds:my-mysql-db-2019-07-22-07-23`
Instantánea de clúster de base de datos automatizada	arn:aws:rds:`<region>`:`<account>`:cluster-snapshot:rds:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:cluster-snapshot:rds:my-aurora-cluster-2019-07-22-16-16`
Instantánea de base de datos manual	arn:aws:rds:`<region>`:`<account>`:snapshot:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-db-snap`
Instantánea de un clúster de base de datos manual	arn:aws:rds:`<region>`:`<account>`:cluster-snapshot:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-cluster-snap`
Grupo de subred de base de datos	arn:aws:rds:`<region>`:`<account>`:subgrp:`<name>` Por ejemplo: `arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10`

Obtención de un ARN existente

Puede obtener el ARN de un recurso de RDS mediante la AWS Management Console, la AWS Command Line Interface (AWS CLI) o la API de RDS.

Consola

Para obtener un ARN desde la AWS Management Console, vaya al recurso cuyo ARN desea obtener y consulte los detalles de ese recurso.

Por ejemplo, puede obtener el ARN de una instancia de base de datos desde la pestaña Configuración de los detalles de la instancia de base de datos.

AWS CLI

Para obtener el ARN de un recurso concreto de RDS desde la AWS CLI, se utiliza el comando describe con dicho recurso. En la siguiente tabla se muestran los distintos comandos de AWS CLI, junto con la propiedad ARN que se utiliza con el comando para obtener un ARN.

AWS CLI command	Propiedad ARN
describe-event-subscriptions	EventSubscriptionArn
describe-certificates	CertificateArn
describe-db-parameter-groups	DBParameterGroupArn
describe-db-cluster-parameter-groups	DBClusterParameterGroupArn
describe-db-instances	DBInstanceArn
describe-db-security-groups	DBSecurityGroupArn
describe-db-snapshots	DBSnapshotArn
describe-events	SourceArn
describe-reserved-db-instances	ReservedDBInstanceArn
describe-db-subnet-groups	DBSubnetGroupArn
describe-option-groups	OptionGroupArn
describe-db-clusters	DBClusterArn
describe-db-cluster-snapshots	DBClusterSnapshotArn

Por ejemplo, el siguiente comando de la AWS CLI obtiene el ARN de una instancia de base de datos.

ejemplo

Para Linux, macOS o Unix:


aws rds describe-db-instances \
--db-instance-identifier DBInstanceIdentifier \
--region us-west-2 \
--query "*[].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceArn:DBInstanceArn}"

En Windows:


aws rds describe-db-instances ^
--db-instance-identifier DBInstanceIdentifier ^
--region us-west-2 ^
--query "*[].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceArn:DBInstanceArn}"

El resultado de ese comando es como el siguiente:



[
    {
        "DBInstanceArn": "arn:aws:rds:us-west-2:account_id:db:instance_id", 
        "DBInstanceIdentifier": "instance_id"
    }
]

API de RDS

Para obtener el ARN de un recurso concreto de RDS, puede llamar a las siguientes operaciones de la API de RDS y utilizar las propiedades ARN que se muestran a continuación.

Operación de la API de RDS	Propiedad ARN
DescribeEventSubscriptions	EventSubscriptionArn
DescribeCertificates	CertificateArn
DescribeDBParameterGroups	DBParameterGroupArn
DescribeDBClusterParameterGroups	DBClusterParameterGroupArn
DescribeDBInstances	DBInstanceArn
DescribeDBSecurityGroups	DBSecurityGroupArn
DescribeDBSnapshots	DBSnapshotArn
DescribeEvents	SourceArn
DescribeReservedDBInstances	ReservedDBInstanceArn
DescribeDBSubnetGroups	DBSubnetGroupArn
DescribeOptionGroups	OptionGroupArn
DescribeDBClusters	DBClusterArn
DescribeDBClusterSnapshots	DBClusterSnapshotArn

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Etiquetado de recursos de RDS

Uso de almacenamiento