Utilisation des ARN administratifs dans Amazon Neptune

Les ressources créées dans Amazon Web Services sont chacune identifiées de façon unique par un Amazon Resource Name (ARN). Pour certaines opérations Amazon Neptune, vous devez identifier une ressource Neptune de manière unique en spécifiant son ARN.

Important

Amazon Neptune partage le format des ARN Amazon RDS pour les actions administratives utilisant leAPI de gestion Neptune. Les ARN administratifs de Neptune contiennentrds et nonneptune-db. Pour les ARN de plans de données qui identifient les ressources de données Neptune, consultez la section Spécification des ressources de données.

Construction d'un ARN pour Neptune

Vous pouvez construire un ARN pour une ressource Amazon Neptune en utilisant la syntaxe suivante. Notez que Neptune partage le format des ARN Amazon RDS.

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

Le tableau suivant indique le format à utiliser lors de la création d'un ARN pour un type particulier de ressource administrative Neptune.

Type de ressource	Format ARN
instance de base de données	arn:aws:rds <region>: :db:<account><name> Par exemple : arn:aws:rds:us-east-2:123456789012:db:my-instance-1
Cluster DB	arn:aws:rds <region>: :cluster:<account><name> Par exemple : arn:aws:rds:us-east-2:123456789012:cluster:my-cluster-1
Abonnement aux événements	arn:aws:rds <region>: :es:<account><name> Par exemple : arn:aws:rds:us-east-2:123456789012:es:my-subscription
Groupe de paramètres de base de données	arn:aws:rds <region>: :pg:<account><name> Par exemple : arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs
Groupe de paramètres de cluster DB	arn:aws:rds <region>: :cluster-pg:<account><name> Par exemple : arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone
Instantané de cluster DB	arn:awsrds: <region>: :cluster-snapshot:<account><name> Par exemple : arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-snap-20160809
Groupe de sous-réseaux DB	arn:awsrds: <region>: :subgrp:<account><name> Par exemple : arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10

Obtenir un ARN existant dans Amazon Neptune

Vous pouvez obtenir l'ARN d'une ressource Neptune à l'aide de l'APIAWS Management Console,AWS Command Line Interface (AWS CLI) ou Neptune.

Obtention d'un ARN existant à l'aide de l'AWS Management Console

Pour obtenir un ARN à l'aide de la console, accédez à la ressource pour laquelle vous souhaitez obtenir un ARN, puis consultez les détails de cette ressource. Par exemple, pour obtenir l'ARN d'une instance de base de données, choisissez Instances dans le volet de navigation, puis choisissez l'instance souhaitée dans la liste. L'ARN se trouve dans la section Instance Details (Détails de l'instance).

Obtention d'un ARN existant à l'aide de l'AWS CLI

Pour utiliser laAWS CLI pour obtenir un ARN pour une ressource Neptune particulière, utilisez ladescribe commande pour cette ressource. Le tableau suivant présente chaque commande AWS CLI et la propriété d'ARN utilisée avec la commande pour obtenir un ARN.

AWS CLICommande de l'	Propriété d'ARN
describe-event-subscriptions	EventSubscriptionArn
describe-certificates	CertificateArn
describe-db-parameter-groups	DBParameterGroupArn
describe-db-cluster-parameter-groupes	DBClusterParameterGroupArn
describe-db-instances	DBInstanceArn
describe-events	SourceArn
describe-db-subnet-groups	DBSubnetGroupArn
describe-db-clusters	DBClusterArn
describe-db-cluster-snapshots	DBClusterSnapshotArn

Par exemple, la commande AWS CLI suivante permet d'obtenir l'ARN pour une instance de base de données.

Exemple

Pour Linux, OS X ou Unix :

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

Pour Windows :

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

Obtention d'un ARN existant à l'aide de l'API

Pour obtenir un ARN pour une ressource Neptune particulière, appelez les actions d'API suivantes et utilisez les propriétés d'ARN affichées.

Action d'API Neptune	Propriété d'ARN
DescribeEventSubscriptions	EventSubscriptionArn
DescribeCertificates	CertificateArn
DécriveBParameterGroups	DBParameterGroupArn
DécriveBClusterParameterGroups	DBClusterParameterGroupArn
DescribeDBInstances	DBInstanceArn
DescribeEvents	SourceArn
DécriveBSubnetGroups	DBSubnetGroupArn
DescribeDBClusters	DBClusterArn
DécriveBClusterSnapshots	DBClusterSnapshotArn