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

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
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, você pode obter o ARN de um cluster de banco de dados da guia Configuração dos detalhes do cluster de banco de dados.


                    ARN do cluster 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-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