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
Leste dos EUA (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
Leste dos EUA (Norte da Virgínia)	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 dos EUA (Norte da Califórnia)	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 dos EUA (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
África (Cidade do Cabo)	af-south-1	rds.af-south-1.amazonaws.com rds.af-south-1.api.aws	HTTPS HTTPS
Ásia-Pacífico (Hong Kong)	ap-east-1	rds.ap-east-1.amazonaws.com rds.ap-east-1.api.aws	HTTPS HTTPS
Ásia-Pacífico (Hyderabad)	ap-south-2	rds.ap-south-2.amazonaws.com rds.ap-south-2.api.aws	HTTPS HTTPS
Ásia-Pacífico (Jacarta)	ap-southeast-3	rds.ap-southeast-3.amazonaws.com rds.ap-southeast-3.api.aws	HTTPS HTTPS
Ásia-Pacífico (Melbourne)	ap-southeast-4	rds.ap-southeast-4.amazonaws.com rds.ap-southeast-4.api.aws	HTTPS HTTPS
Ásia-Pacífico (Mumbai)	ap-south-1	rds.ap-south-1.amazonaws.com rds.ap-south-1.api.aws	HTTPS HTTPS
Ásia-Pacífico (Osaka)	ap-northeast-3	rds.ap-northeast-3.amazonaws.com rds.ap-northeast-3.api.aws	HTTPS HTTPS
Ásia-Pacífico (Seul)	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
Ásia-Pacífico (Sydney)	ap-southeast-2	rds.ap-southeast-2.amazonaws.com rds.ap-southeast-2.api.aws	HTTPS HTTPS
Ásia-Pacífico (Tóquio)	ap-northeast-1	rds.ap-northeast-1.amazonaws.com rds.ap-northeast-1.api.aws	HTTPS HTTPS
Canadá (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
Oeste do Canadá (Calgary)	ca-west-1	rds.ca-west-1.amazonaws.com rds-fips.ca-west-1.amazonaws.com	HTTPS HTTPS
Europa (Frankfurt)	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ão)	eu-south-1	rds.eu-south-1.amazonaws.com rds.eu-south-1.api.aws	HTTPS HTTPS
Europa (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 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 (Zurique)	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
Oriente Médio (Barém)	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 rds.me-central-1.api.aws	HTTPS HTTPS
América do Sul (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 rds.us-gov-east-1.api.aws	HTTPS HTTPS
AWS GovCloud (Oeste dos EUA)	us-gov-west-1	rds.us-gov-west-1.amazonaws.com rds.us-gov-west-1.api.aws	HTTPS 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`
Grupo de opções do banco de dados	arn:aws:rds:`<region>`:`<account>`:og:`<name>` Por exemplo: `arn:aws:rds:us-east-2:123456789012:og:my-og`
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, é possível obter o ARN de uma instância de banco de dados da guia Configuração dos detalhes da instância de banco de dados.

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-option-groups	OptionGroupArn
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
DescribeOptionGroups	OptionGroupArn
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

Trabalhar com armazenamento