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 façon unique en spécifiant son ARN.

Important

Amazon Neptune partage le format des ARN Amazon RDS pour les actions administratives utilisant l'Référence de l'API de gestion. Les ARN administratifs Neptune contiennent rds et non neptune-db. Pour les ARN du plan de données qui identifient les ressources de données Neptune, consultez Spécification des ressources de données.

Création d'un ARN pour Neptune

Vous pouvez créer 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 de ressource administative Neptune spécifique.

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

Obtention d'un ARN existant dans Amazon Neptune

Vous pouvez obtenir l'ARN d'une ressource Neptune en utilisant l'API AWS Management Console, AWS Command Line Interface (AWS CLI) ou Neptune.

Obtenir un ARN existant à l'aide du 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).

Obtenir un ARN existant à l'aide du AWS CLI

Pour utiliser le AWS CLI afin d'obtenir un ARN pour une ressource Neptune particulière, utilisez la describe commande correspondant à cette ressource. Le tableau suivant indique chaque AWS CLI commande et la propriété ARN utilisée avec la commande pour obtenir un ARN.

AWS CLI Commande	Propriété d'ARN
describe-event-subscriptions	EventSubscriptionArn
describe-certificates	CertificateArn
describe-db-parameter-groups	DB ParameterGroupArn
describe-db-cluster-parameter-groupes	DB ClusterParameterGroupArn
describe-db-instances	DB InstanceArn
describe-events	SourceArn
describe-db-subnet-groups	DB SubnetGroupArn
describe-db-clusters	DB ClusterArn
describe-db-cluster-snapshots	DB ClusterSnapshotArn

Par exemple, la AWS CLI commande suivante obtient l'ARN d'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 indiquées.

Action d'API Neptune	Propriété d'ARN
DescribeEventSubscriptions	EventSubscriptionArn
DescribeCertificates	CertificateArn
Décrit B ParameterGroups	DB ParameterGroupArn
Décrit B ClusterParameterGroups	DB ClusterParameterGroupArn
DescribeDBInstances	DB InstanceArn
DescribeEvents	SourceArn
Décrit B SubnetGroups	DB SubnetGroupArn
DescribeDBClusters	DB ClusterArn
Décrit B ClusterSnapshots	DB ClusterSnapshotArn