클라우드 리소스 이름
클라우드 리소스 이름(CRN)은 IBM Cloud® 리소스를 고유하게 식별합니다. CRN을 사용하면 전역적으로 고유성이 보장되는 명료한 방식으로 리소스를 지정합니다.
CRN은 리소스, 해당 위치 및 소속된 서비스를 계층 구조로 식별하는 "세그먼트"의 연결을 통해 구성됩니다. 세그먼트 구분 기호는 콜론(:)으로 설정됩니다. 모든 CRN은 세그먼트 ID crn(으)로 시작합니다.
CRN 형식
CRN의 기본적인 표준 형식은 다음과 같습니다.
crn:version:cname:ctype:service-name:location:scope:service-instance:resource-type:resource
버전
version 세그먼트는 CRN 형식의 버전을 식별합니다. 현재 유일하게 유효한 버전 세그먼트 값은 v1입니다.
cname
cname 세그먼트는 클라우드 인스턴스를 식별하며 리소스가 포함된 클라우드 인스턴스를 고유하게 식별하는 영숫자 ID입니다. cname은 식별된 리소스를 소유하는 독립적인 제어 영역을 식별합니다. IBM Cloud 를 사용하는 사용자의 경우, ‘ cname ’ 세그먼트의 값은 ‘ bluemix ’이어야 합니다.
ctype
ctype 세그먼트는 지정된 cname 세그먼트에서 표시하는 클라우드 인스턴스의 유형을 식별합니다.
유효 값:
public: 퍼블릭 카탈로그에서 사용 가능한 모든 서비스dedicated: 현재 IBM Cloud 데디케이티드 환경의 경우에만local: 사용자의 환경에 로컬로 배치된 모든 서비스
서비스 이름
IBM Cloud 서비스 이름의 전역 고유성을 보장합니다. service-name 세그먼트는 클라우드에서 제공하는 기능(서비스, 컴포넌트 또는 제품)을 식별합니다. 이 기능은 IBM Cloud 카탈로그에 나열된 서비스와 같은 사용자 제공 서비스이거나 IBM Cloud 기능에 중요한 내부 아키텍처 컴포넌트일 수 있습니다.
service-name 세그먼트는 리소스가 속하는 서비스를 표시합니다. service-name 세그먼트는 영숫자, 소문자여야 하며 - 이외의 특수 문자 또는 공백이 없어야 합니다. 하위 서비스의 서비스 이름을 식별하는 경우, 상위 서비스 이름을 하위 서비스와 구분하는 점 .이 있어야 합니다. 예를 들어 iam-service(이)라는
서비스와 micro(이)라는 서비스의 하위가 있는 경우, iam-service은(는) 상위 서비스이고 iam-service.micro은(는) 하위 서비스로 간주됩니다.
IBM Cloud 카탈로그에 등록된 서비스의 경우, service-name 세그먼트는 IBM Cloud 글로벌 카탈로그 서비스에 등록된 서비스 중 하나와 일치해야 합니다. 이는 IBM Cloud 전역 카탈로그 서비스 API( GET https://globalcatalog.cloud.ibm.com/api/v1/{id} )에서 해당 리소스 인스턴스에 대해 반환되는
name 속성이거나, 명령줄 인터페이스(CLI)( ibmcloud service offerings )의 service 열에 표시되는 service-name 값입니다.
위치
리소스가 상주하는 클라우드 지리적 위치/지역/구역/데이터 센터입니다.
location 세그먼트는 ibmcloud catalog locations CLI 명령에서 나열하는 위치 이름 중 하나여야 합니다.
일부 리소스는 글로벌로 간주될 수 있으므로 지역이 필요하지 않습니다. 이 경우에는 region 세그먼트가 global로 설정됩니다.
범위
scope 세그먼트는 리소스의 소유자 또는 포함을 식별합니다. 일부 리소스에서는 소유자가 필요하지 않습니다(global로 간주될 수 있음). 이 경우에는 scope 세그먼트가 비어 있습니다(공백 문자열).
scope 세그먼트의 값은 {scopePrefix}/{id}로 형식화되어야 합니다. scopePrefix는 소유자 또는 포함을 식별하는 데 사용되는 형식을 표시합니다. id는 scopePrefix에 특정한 형식의 포함 또는 소유자의 ID를 표시합니다.
| 범위 유형 | 범위 접두부 | 사용량 | 예 |
|---|---|---|---|
| 계정 | a/{account id} |
리소스가 작성된 계정입니다. | a/292558 |
| 조직 | o/{org guid} |
리소스가 지정된 IBM Cloud 조직입니다. | o/4716e2d1-35b7-431f-891a-b552bf0b3c66 |
| 영역 | s/{space guid} |
리소스가 지정된 IBM Cloud 영역입니다. | s/48b3cdcd-e804-4398-9032-73065863ad7c |
서비스-인스턴스
service-instance 세그먼트는 서비스 인스턴스를 고유하게 식별합니다. service-instance 세그먼트의 형식은 서비스별로 다양합니다. 각 서비스는 해당 서비스 메타데이터의 일부로서 해당 service_instance 세그먼트의 형식을 문서화해야 합니다. 인스턴스가 글로벌인 서비스에는 인스턴스가 없으며, 이 경우 service-instance 필드는 공백입니다.
service-instance는 영숫자 또는 소문자여야 하며 공백이나 '-' 및 '/' 이외의 특수 문자가 없어야 합니다.
예를 들어 작업 항목을 추적하고 계획하는 데 사용되는 DevOps 도구에는 단순 GUID 인스턴스 ID("1234-5678-9012-3456")가 있을 수 있습니다. 그러나 오토스케일 그룹 서비스의 정책 컴포넌트는 계층 구조의 이름 지정 규칙을 사용하고 다음의 service-id 세그먼트를 가질 수 있습니다.
c7a27f55-d35e-4153-b044-8ca9155fc467/my-test-asg1/my-scaleout-policy
다음 CLI 명령을 사용하여 IBM Cloud 리소스에서 CRN을 얻을 수 있습니다.
ibmcloud resource service-instance
resource-type, resource
resource-type 및 resource 세그먼트의 값은 서비스에 따라 다양합니다. 각 서비스는 서비스 메타데이터의 일부로 지원되는 리소스 유형과 리소스의 형식을 반드시 문서화해야 합니다. CRN이 서비스 인스턴스를 가리키는 경우, resource-type 및 resource 세그먼트는 비어 있어야 합니다. 리소스 유형을 전역적으로
참조하는 경우, ‘ resource ’ 세그먼트는 비어 있어야 합니다.
예를 들어, Object Storage 서비스의 ‘customer receipts’ 컨테이너에 있는 이미지의 ‘ resource-type ’ 값은 “object”이고, ‘ resource ’ 값은 “ 'CustomerReceipts/clientdinner.png”일 수 있습니다. resource-type 반드시 영문자와 숫자로 구성되어야 하며, 소문자만 사용해야
하고, 공백이나 ‘-’ 이외의 특수 문자는 사용할 수 없습니다
서비스 측에서 resource-type 를 선택 사항으로 지정할 수 있으며, 이 경우 생략할 수 있습니다.
resource 반드시 GUID이거나 , RFC 3986 ‘Uniform Resource Identifier(URI): Generic Syntax’의 2절에 설명된 URI 구문에 따라 인코딩된 문자열이어야 합니다. 특히 “/”
문자는 계층적 경로를 나타내는 데 사용할 수 있습니다.
CRN 예
다음 표에는 CRN 예 목록이 나열되어 있습니다.
| 예 | 값 |
|---|---|
| Kubernetes 작업자 | crn:v1:bluemix:public:containers-kubernetes:us-south:a/59bcbfa6ea2f006b4ed7094c1a08dcdd:8042b2a8af6a4a5cbf6dbe09e07311d2:worker:kube-hou02-pa8042b2a8af6a4a5cbf6dbe09e07311d2-w1 |
| 리소스 그룹 | crn:v1:bluemix:public:resource-controller:global:a/59bcbfa6ea2f006b4ed7094c1a08dcdd::resource-group:59bcbfa6ea2f006b4ed7094c1a08dcdd |
| 서비스 인스턴스 | crn:v1:bluemix:public:cloud-object-storage:global:a/59bcbfa6ea2f006b4ed7094c1a08dcdd:1a0ec336-f391-4091-a6fb-5e084a4c56f4:: |
| 버킷 | crn:v1:bluemix:public:cloud-object-storage:global:a/59bcbfa6ea2f006b4ed7094c1a08dcdd:1a0ec336-f391-4091-a6fb-5e084a4c56f4:bucket:mybucket |
| 하위 서비스 | crn:v1:bluemix:public:resource-catalog:global:a/9d67f37fdf745e1b3cbef0ee4e6f2eda::composite:is-vpn |
CRN 값을 검색하는 단계의 예시를 보려면 인스턴스 ID 및 클라우드 리소스 이름(CRN)검색하기를 참조하세요.