Amazon RDS の Amazon リソースネーム (ARN) の使用
Amazon Web Services で作成されたリソースは、Amazon リソースネーム (ARN) によってそれぞれ一意に識別されます。特定の Amazon RDS オペレーションでは、ARN を指定して、Amazon RDS リソースを一意に識別する必要があります。例えば、RDS DB インスタンスのリードレプリカを作成する場合、ソース DB インスタンスの ARN を指定する必要があります。
Amazon RDS 用 ARN の構築
Amazon Web Services で作成されたリソースは、Amazon リソースネーム (ARN) によってそれぞれ一意に識別されます。次の構文を使用して Amazon RDS リソースの ARN を構築できます。
arn:aws:rds:
<region>
:<account number>
:<resourcetype>
:<name>
リージョン名 | リージョン | エンドポイント | プロトコル |
---|---|---|---|
米国東部 (オハイオ) | 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 |
米国東部 (バージニア北部) | 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 |
米国西部 (北カリフォルニア) | 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 |
米国西部 (オレゴン) | 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 |
アフリカ (ケープタウン) | af-south-1 |
rds.af-south-1.amazonaws.com rds.af-south-1.api.aws |
HTTPS HTTPS |
アジアパシフィック (香港) | ap-east-1 |
rds.ap-east-1.amazonaws.com rds.ap-east-1.api.aws |
HTTPS HTTPS |
アジアパシフィック (ハイデラバード) | ap-south-2 |
rds.ap-south-2.amazonaws.com rds.ap-south-2.api.aws |
HTTPS HTTPS |
アジアパシフィック (ジャカルタ) | ap-southeast-3 |
rds.ap-southeast-3.amazonaws.com rds.ap-southeast-3.api.aws |
HTTPS HTTPS |
アジアパシフィック (メルボルン) | ap-southeast-4 |
rds.ap-southeast-4.amazonaws.com rds.ap-southeast-4.api.aws |
HTTPS HTTPS |
アジアパシフィック (ムンバイ) | ap-south-1 |
rds.ap-south-1.amazonaws.com rds.ap-south-1.api.aws |
HTTPS HTTPS |
アジアパシフィック (大阪) | ap-northeast-3 |
rds.ap-northeast-3.amazonaws.com rds.ap-northeast-3.api.aws |
HTTPS HTTPS |
アジアパシフィック (ソウル) | ap-northeast-2 |
rds.ap-northeast-2.amazonaws.com rds.ap-northeast-2.api.aws |
HTTPS HTTPS |
アジアパシフィック (シンガポール) | ap-southeast-1 |
rds.ap-southeast-1.amazonaws.com rds.ap-southeast-1.api.aws |
HTTPS HTTPS |
アジアパシフィック (シドニー) | ap-southeast-2 |
rds.ap-southeast-2.amazonaws.com rds.ap-southeast-2.api.aws |
HTTPS HTTPS |
アジアパシフィック (東京) | ap-northeast-1 |
rds.ap-northeast-1.amazonaws.com rds.ap-northeast-1.api.aws |
HTTPS HTTPS |
カナダ (中部) | 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 |
カナダ西部 (カルガリー) | ca-west-1 |
rds.ca-west-1.amazonaws.com rds-fips.ca-west-1.amazonaws.com |
HTTPS HTTPS |
欧州 (フランクフルト) | eu-central-1 |
rds.eu-central-1.amazonaws.com rds.eu-central-1.api.aws |
HTTPS HTTPS |
欧州 (アイルランド) | eu-west-1 |
rds.eu-west-1.amazonaws.com rds.eu-west-1.api.aws |
HTTPS HTTPS |
欧州 (ロンドン) | eu-west-2 |
rds.eu-west-2.amazonaws.com rds.eu-west-2.api.aws |
HTTPS HTTPS |
ヨーロッパ (ミラノ) | eu-south-1 |
rds.eu-south-1.amazonaws.com rds.eu-south-1.api.aws |
HTTPS HTTPS |
欧州 (パリ) | eu-west-3 |
rds.eu-west-3.amazonaws.com rds.eu-west-3.api.aws |
HTTPS HTTPS |
欧州 (スペイン) | eu-south-2 |
rds.eu-south-2.amazonaws.com rds.eu-south-2.api.aws |
HTTPS HTTPS |
欧州 (ストックホルム) | eu-north-1 |
rds.eu-north-1.amazonaws.com rds.eu-north-1.api.aws |
HTTPS HTTPS |
欧州 (チューリッヒ) | eu-central-2 |
rds.eu-central-2.amazonaws.com rds.eu-central-2.api.aws |
HTTPS HTTPS |
イスラエル (テルアビブ) | il-central-1 |
rds.il-central-1.amazonaws.com rds.il-central-1.api.aws |
HTTPS HTTPS |
中東 (バーレーン) | me-south-1 |
rds.me-south-1.amazonaws.com rds.me-south-1.api.aws |
HTTPS HTTPS |
中東 (アラブ首長国連邦) | me-central-1 |
rds.me-central-1.amazonaws.com rds.me-central-1.api.aws |
HTTPS HTTPS |
南米 (サンパウロ) | sa-east-1 |
rds.sa-east-1.amazonaws.com rds.sa-east-1.api.aws |
HTTPS HTTPS |
AWS GovCloud (米国東部) | us-gov-east-1 |
rds.us-gov-east-1.amazonaws.com rds.us-gov-east-1.api.aws |
HTTPS HTTPS |
AWS GovCloud (米国西部) | us-gov-west-1 |
rds.us-gov-west-1.amazonaws.com rds.us-gov-west-1.api.aws |
HTTPS HTTPS |
次の表に、特定の Amazon RDS リソースの ARN の構築時に使用する形式を示します。
リソースタイプ | ARN 形式 |
---|---|
DB インスタンス |
arn:aws:rds: 例:
|
DB クラスター |
arn:aws:rds: 例:
|
イベントサブスクリプション |
arn:aws:rds: 例:
|
DB パラメータグループ |
arn:aws:rds: 例:
|
DB クラスターのパラメータグループ |
arn:aws:rds: 例:
|
リザーブド DB インスタンス |
arn:aws:rds: 例:
|
DB セキュリティグループ |
arn:aws:rds: 例:
|
Automated DB スナップショット |
arn:aws:rds: 例:
|
自動 DB クラスタースナップショット |
arn:aws:rds: 例:
|
手動 DB スナップショット |
arn:aws:rds: 例:
|
手動の DB クラスタースナップショット |
arn:aws:rds: 例:
|
DB サブネットグループ |
arn:aws:rds: 例:
|
既存の ARN の取得
AWS Management Console、AWS Command Line Interface (AWS CLI)、または RDS API を使用して、RDS リソースの ARN を取得できます。
コンソール
AWS Management Console から ARN を取得するには、ARN を取得したいリソースに移動し、リソースの詳細を表示します。
例えば、DB クラスターの詳細の [設定] タブから、DB クラスターの ARN を取得できます。
AWS CLI
特定の RDS リソースの AWS CLI から ARN を取得するには、そのリソースに対して describe
コマンドを使用します。次の表に、各 AWS CLI コマンド、および ARN を取得するコマンドで使用された ARN のプロパティを示します。
AWS CLI コマンド | 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 |
例えば、次の AWS CLI コマンドで DB インスタンスの ARN を取得します。
例
Linux、macOS、Unix の場合:
aws rds describe-db-instances \ --db-instance-identifier
DBInstanceIdentifier
\ --regionus-west-2
\ --query "*[].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceArn:DBInstanceArn}"
Windows の場合:
aws rds describe-db-instances ^ --db-instance-identifier
DBInstanceIdentifier
^ --regionus-west-2
^ --query "*[].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceArn:DBInstanceArn}"
このコマンドの出力は次のようになります。
[
{
"DBInstanceArn": "arn:aws:rds:us-west-2:account_id
:db:instance_id
",
"DBInstanceIdentifier": "instance_id
"
}
]
RDS API
特定の RDS リソースの ARN を取得するには、次の RDS API のオペレーションを呼び出し、次に示す ARN のプロパティを使用できます。
RDS API オペレーション | 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 |