Trabalhar com ARNs administrativos no Amazon Neptune

Os recursos criados na Amazon Web Services são identificados de forma exclusiva com um nome do recurso da Amazon (ARN). Para determinadas operações do Amazon Neptune, você deve identificar um recurso do Neptune de forma exclusiva especificando seu ARN.

Importante

O Amazon Neptune compartilha o formato dos ARNs do Amazon RDS para ações administrativas que usam o Referência da API de gerenciamento. Os ARNs administrativos do Neptune contêm rds e não neptune-db. Para ARNs de plano de dados que identificam recursos de dados do Neptune, consulte Especificar recursos de dados.

Criar um ARN para o Neptune

Você pode criar um ARN para um recurso do Amazon Neptune usando a sintaxe a seguir. Observe que o Neptune compartilha o formato dos ARNs do Amazon RDS.

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

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

Tipo de recurso	Formato do 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-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-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
Grupo de parâmetros 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
Snapshot de cluster de banco de dados	arn:aws:rds:<region>:<account>:cluster-snapshot:<name> Por exemplo: . arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-snap-20160809
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 no Amazon Neptune

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

Obtendo um ARN existente usando o AWS Management Console

Para obter um ARN usando o console, navegue até o recurso para o qual deseja um ARN e veja os detalhes desse recurso. Por exemplo, para obter o ARN para uma instância de banco de dados, selecione Instances (Instâncias) no painel de navegação e selecione a instância que deseja na lista. O ARN está na seção Instance Details (Detalhes da instância).

Obtendo um ARN existente usando o AWS CLI

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

AWS CLI Comando	Propriedade do ARN
describe-event-subscriptions	EventSubscriptionArn
describe-certificates	CertificateArn
describe-db-parameter-groups	Braço DB ParameterGroup
describe-db-cluster-parameter-groups	DB ClusterParameter GroupArn
describe-db-instances	DB InstanceArn
describe-events	SourceArn
describe-db-subnet-groups	Braço DB SubnetGroup
describe-db-clusters	DB ClusterArn
describe-db-cluster-snapshots	Braço DB ClusterSnapshot

Por exemplo, o AWS CLI comando a seguir obtém o ARN de uma instância de banco de dados.

exemplo

Para Linux, OS X ou Unix:

aws neptune describe-db-instances \
--db-instance-identifier DBInstanceIdentifier \
--region us-west-2

Para Windows:

aws neptune describe-db-instances ^
--db-instance-identifier DBInstanceIdentifier ^
--region us-west-2

Obter um ARN existente usando a API

Para obter um ARN para um recurso específico do Neptune, chame as seguintes ações da API e use as propriedades do ARN mostradas a seguir.

Ação da API Neptune	Propriedade do ARN
DescribeEventAssinaturas	EventSubscriptionArn
DescribeCertificates	CertificateArn
Descreva o DB ParameterGroups	Braço DB ParameterGroup
Grupos de banco de dados descritos ClusterParameter	DB ClusterParameter GroupArn
DescribeDBInstances	DB InstanceArn
DescribeEvents	SourceArn
Descreva o DB SubnetGroups	Braço DB SubnetGroup
DescribeDBClusters	DB ClusterArn
Descreva o DB ClusterSnapshots	Braço DB ClusterSnapshot