메뉴
Amazon Relational Database Service
사용 설명서 (API Version 2014-10-31)

Amazon RDS의 Amazon 리소스 이름(ARN)을 사용한 작업

Amazon Web Services에 생성되는 리소스는 각기 고유한 Amazon 리소스 이름(ARN)으로 식별됩니다. 특정 Amazon Relational Database Service (Amazon RDS) 작업에서는 ARN을 지정하여 Amazon RDS 리소스를 고유한 이름으로 식별해야 합니다. 예를 들어, Amazon RDS 리소스에 메타데이터를 추가하려면 해당 Amazon RDS 리소스에 ARN을 부여해야 합니다. 이와 마찬가지로 RDS DB 인스턴스 읽기 전용 복제본을 생성할 때에도 해당 소스 DB 인스턴스에 ARN을 부여해야 합니다.

다음 단원에서는 새 ARN을 생성하거나 기존 ARN을 가져오는 방법에 대해 설명합니다.

새 Amazon RDS ARN 생성

Amazon Web Services에 생성되는 리소스는 각기 고유한 Amazon 리소스 이름(ARN)으로 식별됩니다. 다음 구문을 사용하여 Amazon RDS 리소스에 대한 ARN을 생성할 수 있습니다.

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

이 구문에서 표시된 항목들에는 다음과 같은 의미가 있습니다.

  • <region>us-west-2와 같이 Amazon RDS 리소스가 생성된 AWS 리전의 ID입니다.

  • <account number>는 대시가 생략된 계정 번호입니다. 계정 번호를 찾으려면 http://aws.amazon.com에서 AWS 계정으로 로그인하고 [My Account/Console], [My Account]를 차례로 선택합니다.

  • <resourcetype>은 Amazon RDS 리소스의 유형입니다(예: DB 인스턴스 또는 클러스터).

  • <name>은 Amazon RDS 리소스의 리소스 식별자입니다.

다음 표에는 AWS 리전 이름, ARN 생성 시 사용해야 하는 리전 ID 이름, 그리고 참조용 리전 엔드포인트가 나와 있습니다.

리전 이름 엔드포인트
미국 서부(오레곤) 지역 us-west-2 https://rds.us-west-2.amazonaws.com
미국 서부(캘리포니아 북부) 리전 us-west-1 https://rds.us-west-1.amazonaws.com
미국 동부(오하이오) 리전 us-east-2 https://rds.us-east-2.amazonaws.com
미국 동부(버지니아 북부) 지역 us-east-1 https://rds.us-east-1.amazonaws.com
아시아 태평양(뭄바이) 리전 ap-south-1 https://rds.ap-south-1.amazonaws.com
아시아 태평양(서울) 리전 ap-northeast-2 https://rds.ap-northeast-2.amazonaws.com
아시아 태평양(싱가포르) 리전 ap-southeast-1 https://rds.ap-southeast-1.amazonaws.com
아시아 태평양(시드니) 리전 ap-southeast-2 https://rds.ap-southeast-2.amazonaws.com
아시아 태평양(도쿄) 리전 ap-northeast-1 https://rds.ap-northeast-1.amazonaws.com
캐나다(중부) 리전 ca-central-1 https://rds.ca-central-1.amazonaws.com
중국(북경) 지역 cn-north-1 https://rds.cn-north-1.amazonaws.com.cn
EU(프랑크푸르트) 리전 eu-central-1 https://rds.eu-central-1.amazonaws.com
EU(아일랜드) 지역 eu-west-1 https://rds.eu-west-1.amazonaws.com
EU(런던) 리전 eu-west-2 https://rds.eu-west-2.amazonaws.com
남아메리카(상파울루) 리전 sa-east-1 https://rds.sa-east-1.amazonaws.com
AWS GovCloud (US) us-gov-west-1 https://rds.us-gov-west-1.amazonaws.com

다음 표에는 특정 Amazon RDS 리소스 유형에 대한 ARN 생성 시 사용해야 하는 형식이 나와 있습니다.

리소스 유형 ARN 형식
DB 인스턴스 arn:aws:rds:<region>:<account>:db:<dbinstance name>
DB 클러스터 arn:aws:rds:<region>:<account>:cluster:<dbcluster name>
이벤트 구독 arn:aws:rds:<region>:<account>:es:<subscription name>
DB 옵션 그룹 arn:aws:rds:<region>:<account>:og:<option group name>
DB 파라미터 그룹 arn:aws:rds:<region>:<account>:pg:<parameter group name>
DB 클러스터 파라미터 그룹 arn:aws:rds:<region>:<account>:cluster-pg:<cluster parameter group name>
예약 DB 인스턴스 arn:aws:rds:<region>:<account>:ri:<reserve instance name>
DB 보안 그룹 arn:aws:rds:<region>:<account>:secgrp:<security group name>
DB 스냅샷 arn:aws:rds:<region>:<account>:snapshot:<snapshot name>
DB 클러스터 스냅샷 arn:aws:rds:<region>:<account>:cluster-snapshot:<snapshot name>
DB 서브넷 그룹 arn:aws:rds:<region>:<account>:subgrp:<subnet group name>

다음 표에는 미국 동부(오하이오) 리전에 생성된, 123456789012이라는 AWS 계정의 RDS 리소스에 대한 ARN의 예가 나와 있습니다.

리소스 유형 샘플 ARN
DB 인스턴스 arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance
DB 클러스터 arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster
이벤트 구독 arn:aws:rds:us-east-2:123456789012:es:my-subscription
DB 옵션 그룹 arn:aws:rds:us-east-2:123456789012:og:my-option-group-oracle-tde
DB 파라미터 그룹 arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs
DB 클러스터 파라미터 그룹 arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone
예약 DB 인스턴스 arn:aws:rds:us-east-2:123456789012:ri:my-reserved-multiaz
DB 보안 그룹 arn:aws:rds:us-east-2:123456789012:secgrp:my-public
DB 스냅샷 arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-snap-20130507
DB 클러스터 스냅샷 arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-snap-20160407
DB 서브넷 그룹 arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10

기존 ARN 가져오기

Amazon Web Services에 생성되는 리소스는 각기 고유한 Amazon 리소스 이름(ARN)으로 식별됩니다. AWS Management Console, AWS Command Line Interface (AWS CLI) 또는 RDS API를 사용해 RDS 리소스에 대한 ARN을 가져올 수 있습니다.

AWS Management Console

다음 리소스의 경우에는 AWS Management Console에서 Amazon 리소스 이름(ARN)을 가져올 수 있습니다.

AWS Management Console에서 ARN을 가져오려면 ARN을 얻고자 하는 리소스를 탐색하거나 그 리소스에 대해 [See Details]를 선택합니다. 예를 들어, 다음과 같이 [Configuration Details] 페이지에서 DB 인스턴스에 대한 ARN을 가져올 수 있습니다.

 DB 인스턴스 ARN

AWS CLI

AWS CLI에서 특정 RDS 리소스에 대한 ARN을 가져오려면 그 리소스에 대해 describe 명령을 사용하면 됩니다. 다음 표에는 각 RDS CLI 명령, 그리고 명령과 함께 사용해 ARN을 가져오는 ARN 속성이 나와 있습니다.

RDS 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-option-groups OptionGroupArn
describe-db-clusters DBClusterArn
describe-db-cluster-snapshots DBClusterSnapshotArn

예를 들어, 다음 AWS CLI 명령은 DB 인스턴스에 대한 ARN을 가져옵니다.

Linux, OS X, Unix의 경우:

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

Windows의 경우:

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

API

특정 RDS 리소스에 대한 ARN을 가져오려면, 다음과 같은 RDS API 작업을 호출하고 ARN 속성을 사용할 수 있습니다.

RDS CLI 명령 ARN 속성
DescribeEventSubscriptions EventSubscriptionArn
DescribeCertificates CertificateArn
DescribeDBParameterGroups DBParameterGroupArn
DescribeDBClusterParameterGroups DBClusterParameterGroupArn
DescribeDBInstances DBInstanceArn
DescribeDBSecurityGroups DBSecurityGroupArn
DescribeDBSnapshots DBSnapshotArn
DescribeEvents SourceArn
DescribeReservedDBInstances ReservedDBInstanceArn
DescribeDBSubnetGroups DBSubnetGroupArn
DescribeOptionGroups OptionGroupArn
DescribeDBClusters DBClusterArn
DescribeDBClusterSnapshots DBClusterSnapshotArn

관련 주제