Criação de um ARN Obter um ARN existente

Trabalhar com nomes de recurso da Amazon (ARNs) no Amazon RDS

Os recursos criados na Amazon Web Services são identificados de forma exclusiva com um nome de recurso da Amazon (ARN). Para determinadas operações do Amazon RDS, você precisará identificar exclusivamente um recurso do Amazon RDS especificando seu ARN. Por exemplo, quando você cria uma réplica de leitura da instância de banco de dados do RDS, é necessário fornecer o ARN para a instância de banco de dados de origem.

Criar um ARN para o Amazon RDS

Os recursos criados na Amazon Web Services são identificados de forma exclusiva com um nome de recurso da Amazon (ARN). Você pode criar um ARN para um recurso do Amazon RDS usando a seguinte sintaxe.

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

Nome da região	Região	Endpoint	Protocolo
US East (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
US East (N. 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
US West (N. 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
US West (Oregon)	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
Africa (Cape Town)	af-south-1	rds.af-south-1.amazonaws.com rds.af-south-1.api.aws	HTTPS HTTPS
Asia Pacific (Hong Kong)	ap-east-1	rds.ap-east-1.amazonaws.com rds.ap-east-1.api.aws	HTTPS HTTPS
Ásia-Pacífico (Haiderabade)	ap-south-2	rds.ap-south-2.amazonaws.com	HTTPS
Ásia-Pacífico (Jacarta)	ap-southeast-3	rds.ap-southeast-3.amazonaws.com	HTTPS
Ásia-Pacífico (Melbourne)	ap-southeast-4	rds.ap-southeast-4.amazonaws.com	HTTPS
Asia Pacific (Mumbai)	ap-south-1	rds.ap-south-1.amazonaws.com rds.ap-south-1.api.aws	HTTPS HTTPS
Asia Pacific (Osaka)	ap-northeast-3	rds.ap-northeast-3.amazonaws.com rds.ap-northeast-3.api.aws	HTTPS HTTPS
Asia Pacific (Seoul)	ap-northeast-2	rds.ap-northeast-2.amazonaws.com rds.ap-northeast-2.api.aws	HTTPS HTTPS
Ásia-Pacífico (Singapura)	ap-southeast-1	rds.ap-southeast-1.amazonaws.com rds.ap-southeast-1.api.aws	HTTPS HTTPS
Asia Pacific (Sydney)	ap-southeast-2	rds.ap-southeast-2.amazonaws.com rds.ap-southeast-2.api.aws	HTTPS HTTPS
Asia Pacific (Tokyo)	ap-northeast-1	rds.ap-northeast-1.amazonaws.com rds.ap-northeast-1.api.aws	HTTPS HTTPS
Canada (Central)	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
Europe (Frankfurt)	eu-central-1	rds.eu-central-1.amazonaws.com rds.eu-central-1.api.aws	HTTPS HTTPS
Europe (Ireland)	eu-west-1	rds.eu-west-1.amazonaws.com rds.eu-west-1.api.aws	HTTPS HTTPS
Europe (London)	eu-west-2	rds.eu-west-2.amazonaws.com rds.eu-west-2.api.aws	HTTPS HTTPS
Europe (Milan)	eu-south-1	rds.eu-south-1.amazonaws.com rds.eu-south-1.api.aws	HTTPS HTTPS
Europe (Paris)	eu-west-3	rds.eu-west-3.amazonaws.com rds.eu-west-3.api.aws	HTTPS HTTPS
Europa (Espanha)	eu-south-2	rds.eu-south-2.amazonaws.com	HTTPS
Europe (Stockholm)	eu-north-1	rds.eu-north-1.amazonaws.com rds.eu-north-1.api.aws	HTTPS HTTPS
Europa (Zurique)	eu-central-2	rds.eu-central-2.amazonaws.com	HTTPS
Oriente Médio (Bahrein)	me-south-1	rds.me-south-1.amazonaws.com rds.me-south-1.api.aws	HTTPS HTTPS
Oriente Médio (Emirados Árabes Unidos)	me-central-1	rds.me-central-1.amazonaws.com	HTTPS
South America (São Paulo)	sa-east-1	rds.sa-east-1.amazonaws.com rds.sa-east-1.api.aws	HTTPS HTTPS
AWS GovCloud (Leste dos EUA)	us-gov-east-1	rds.us-gov-east-1.amazonaws.com	HTTPS
AWS GovCloud (Oeste dos EUA)	us-gov-west-1	rds.us-gov-west-1.amazonaws.com	HTTPS

A tabela a seguir mostra o formato que deve ser usado para criar um ARN para um tipo de recurso específico do Amazon RDS.

Tipo de recurso	Formato ARN
Instância de banco de dados	arn:aws:rds:`<region>`:`<account>`:db:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance-1`
Cluster de banco de dados	arn:aws:rds:`<region>`:`<account>`:cluster:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1`
Assinatura de eventos	arn:aws:rds:`<region>`:`<account>`:es:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:es:my-subscription`
DB parameter group (Grupo de parâmetros de banco de dados)	arn:aws:rds:`<region>`:`<account>`:pg:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs`
Parameter group do cluster de banco de dados	arn:aws:rds:`<region>`:`<account>`:cluster-pg:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone`
Instância de banco de dados reservada	arn:aws:rds:`<region>`:`<account>`:ri:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:ri:my-reserved-postgresql`
Grupo de segurança de banco de dados	arn:aws:rds:`<region>`:`<account>`:secgrp:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:secgrp:my-public`
Snapshot de banco de dados automatizado	arn:aws:rds:`<region>`:`<account>`:snapshot:rds:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:snapshot:rds:my-mysql-db-2019-07-22-07-23`
Snapshot de cluster de banco de dados automatizado	arn:aws:rds:`<region>`:`<account>`:cluster-snapshot:rds:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:cluster-snapshot:rds:my-aurora-cluster-2019-07-22-16-16`
Snapshot de banco de dados manual	arn:aws:rds:`<region>`:`<account>`:snapshot:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-db-snap`
Snapshot de cluster de banco de dados manual	arn:aws:rds:`<region>`:`<account>`:cluster-snapshot:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-cluster-snap`
Grupo de sub-rede de banco de dados	arn:aws:rds:`<region>`:`<account>`:subgrp:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10`

Obter um ARN existente

Você pode obter o ARN de um recurso do RDS usando o AWS Management Console, a AWS Command Line Interface (AWS CLI) ou a API do RDS.

Console

Para obter um ARN do AWS Management Console, navegue até o recurso para o qual deseja um ARN e veja os detalhes desse recurso. Por exemplo, obtenha o ARN de uma instância de banco de dados da guia Configuration (Configuração) dos detalhes da instância de banco de dados conforme mostrado a seguir.

AWS CLI

Para obter um ARN a partir da AWS CLI para um recurso do RDS específico, use o comando describe para esse recurso. A tabela a seguir mostra cada comando da AWS CLI e a propriedade do ARN usada com o comando para obter um ARN.

AWS CLI command	Propriedade do 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-db-clusters	DBClusterArn
describe-db-cluster-snapshots	DBClusterSnapshotArn

Por exemplo, o seguinte comando da AWS CLI obtém o ARN para uma instância de banco de dados.

exemplo

Para Linux, macOS ou Unix:


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

Para Windows:


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

A saída desse comando é semelhante à seguinte:



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

API do RDS

Para obter um ARN para um recurso do RDS específico, é possível chamar as seguintes operações da API do RDS e usar as propriedades do ARN mostradas a seguir.

Operação da API do RDS	Propriedade do ARN
DescribeEventSubscriptions	EventSubscriptionArn
DescribeCertificates	CertificateArn
DescribeDBParameterGroups	DBParameterGroupArn
DescribeDBClusterParameterGroups	DBClusterParameterGroupArn
DescribeDBInstances	DBInstanceArn
DescribeDBSecurityGroups	DBSecurityGroupArn
DescribeDBSnapshots	DBSnapshotArn
DescribeEvents	SourceArn
DescribeReservedDBInstances	ReservedDBInstanceArn
DescribeDBSubnetGroups	DBSubnetGroupArn
DescribeDBClusters	DBClusterArn
DescribeDBClusterSnapshots	DBClusterSnapshotArn

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Marcar recursos do RDS

Atualizações do Aurora