메타데이터 서비스에서 반환한 데이터 요약

메타데이터 서비스를 사용하여 인스턴스, SSH 키 및 배치 그룹에 대한 정보에 액세스하십시오. 다음 요약에는 URI 경로와 메타데이터 키가 포함되어 있으며, 메타데이터를 설명합니다.

각 메타데이터 유형에 대한 API 응답은 메타데이터 키-값 쌍을 포함하는 JSON 형식으로 제공됩니다.

인스턴스에 대한 메타데이터의 요약

인스턴스에 대해 리턴되는 메타데이터의 유형에 대해 알아보려면 표 1의 정보를 사용하십시오. 모든 메타데이터에 액세스하려면 인스턴스에서 메타데이터 검색하기를 참조하세요.

인스턴스의 메타데이터
인스턴스 URI 경로 메타데이터 키 메타데이터에 대한 설명
/instance availability_policy 이 가상 서버 인스턴스에 대한 가용성 정책입니다.
/instance bandwidth 가상 서버 인스턴스의 네트워크 인터페이스와 Block Storage 볼륨 간에 공유되는 총 대역폭(메가비트/초 단위).
/instance boot_volume_attachment 볼륨 이름, CRN 및 ID가 포함된 부트 볼륨 연결입니다.
/instance catalog_offering 이 정보는 가상 서버 인스턴스가 사설 카탈로그의 사용자 지정 이미지로 프로비저닝된 경우에 표시됩니다.
/instance created_at 가상 서버 인스턴스가 작성된 날짜 및 시간입니다.
/instance crn 이 가상 서버 인스턴스의 클라우드 리소스 이름입니다.
/instance dedicated_host CRN, 삭제된 호스트, ID, 이름 및 resource_type을 포함하는 전용 호스트 참조 모음입니다.
/instance disks 인스턴스의 디스크의 목록입니다.
/instance gpu 가상 서버 인스턴스 GPU 구성
/instance id 이 가상 서버 인스턴스의 고유 ID입니다.
/instance image 가상 서버 인스턴스가 프로비저닝될 때의 소스 이미지입니다. 예를 들면 Debian Linux 재고 이미지와 같습니다.
/instance lifecycle_reasons 현재 lifecycle_state의 이유입니다.
/instance lifecycle_state 가상 서버 인스턴스의 라이프사이클 상태입니다.
/instance memory 메모리 용량; 기가바이트 단위로 반올림됨.
/instance metadata_service 가상 서버 인스턴스에서 메타데이터 서비스 엔드포인트를 사용할 수 있는지 여부를 나타냅니다. (사용 상태는 true 또는 false입니다.)
/instance name 이 가상 서버 인스턴스의 사용자 정의 이름(및 기본 시스템 호스트 이름)입니다.
/instance network_interfaces 기본 네트워크 인터페이스를 비롯한, 가상 서버 인스턴스의 네트워크 인터페이스의 목록입니다.
/instance placement_target 가상 서버 인스턴스에 대한 배치 제한사항입니다.
/instance primary_network_interface 인스턴스의 기본 네트워크 인터페이스입니다.
/instance profile 이 가상 서버 인스턴스 프로파일의, 글로벌 범위에서 고유한 이름입니다. 예를 들면 bx2-2x8, balanced profile과 같습니다.
/instance software_attachments 가상 서버 인스턴스의 소프트웨어 첨부 파일 목록입니다.
/instance startable 가상 서버 인스턴스의 상태가 시작 요청을 허용하는지 여부를 나타냅니다.
/instance status 인스턴스의 상태입니다(삭제 중, 실패, 일시정지됨, 일시정지 중, 보류 중, 재시작 중, 재개 중, 실행 중, 시작 중, 중지됨 또는 중지 중).
/instance status_reasons 현재 상태의 이유입니다.
/instance total_network_bandwidth 인스턴스 네트워크 인터페이스에 독점적으로 할당된 초당 메가비트의 대역폭 크기입니다.
/instance total_volume_bandwidth 인스턴스의 블록 스토리지 볼륨에 독점적으로 할당된 초당 메가비트의 대역폭 크기입니다. 이 값을 늘리면 total_network_bandwidth도 그에 따라 줄어듭니다.
/instance vcpu count 및 architecture 속성을 포함하는 구조를 통해 할당되는 VCPU의 수입니다.
/instance volume_attachments 가상 서버 인스턴스의 볼륨 연결 목록입니다.
/instance boot_volume_attachment 인스턴스의 부트 볼륨 연결입니다.
/instance volume_bandwidth_qos_mode 이 가상 서버 인스턴스의 볼륨 대역폭 QoS 모드입니다. 풀링 또는 가중치 적용.
/instance vpc 가상 서버 인스턴스가 있는 VPC입니다.
/instance zone 구역의, 글로벌 범위에서 고유한 이름입니다.
/instance/initialization default_trusted_profile 가상 서버 인스턴스 생성 시 지정된 기본 신뢰 프로필 구성입니다.
/instance/initialization keys 인스턴스 초기화 시 사용된 공개 SSH 키에 대한 참조 목록입니다.
/instance/initialization password encryption_key를 사용하여 암호화되며 Base64로 인코딩되어 리턴되는, 초기화 시의 관리자 비밀번호입니다.
/instance/initialization user_data 새 가상 서버 인스턴스를 설정할 때 사용할 수 있는 사용자 데이터입니다.
/instance/network_interfaces network_interfaces 네트워크 인터페이스의 목록입니다. 세부사항은 /instance/network_interfaces/{id}를 참조하십시오.
/instance/network_interfaces/{id} allow_ip_spoofing 이 인터페이스에서 소스 IP 스푸핑이 허용되는지 여부를 나타냅니다. false인 경우 소스 이 인터페이스에서 IP 스푸핑이 차단됩니다. true인 경우 이 인터페이스에서 소스 IP 스푸핑이 허용됩니다.
/instance/network_interfaces/{id} created_at 네트워크 인터페이스가 작성된 날짜 및 시간입니다.
/instance/network_interfaces/{id} floating_ips 네트워크 인터페이스와 연결된 플로팅 IP 주소에 대한 참조 배열.
/instance/network_interfaces/{id} id 네트워크 인터페이스의 고유 ID입니다.
/instance/network_interfaces/{id} name 네트워크 인터페이스의 사용자 정의 이름입니다.
/instance/network_interfaces/{id} port_speed 네트워크 인터페이스 포트 속도(Mbps)입니다.
/instance/network_interfaces/{id} primary_ipv4_address 기본 IPv4 주소입니다.
/instance/network_interfaces/{id} resource_type 리소스 유형입니다.
/instance/network_interfaces/{id} security_groups 보안 그룹의 목록입니다.
/instance/network_interfaces/{id} status 네트워크 인터페이스의 상태입니다.
/instance/network_interfaces/{id} subnet 인스턴스와 연관된 서브넷입니다.
/instance/network_interfaces/{id} type 인스턴스와 관련된 이 네트워크 인터페이스의 유형입니다.
/instance/software_attachments software_attachments 0개 이상의 소프트웨어 첨부 객체로 구성된 배열입니다.
/instance/software_attachments/{id} id 이 소프트웨어 첨부 파일의 고유 식별자(UUID).
/instance/software_attachments/{id} name 이 소프트웨어 첨부 파일의 이름. 이 이름은 가상 서버 인스턴스와 연결된 소프트웨어 첨부 파일 집합 내에서 고유합니다.
/instance/software_attachments/{id} href 이 소프트웨어 부속물에 대한 URL.
/instance/software_attachments/{id} catalog_offering 해당 소프트웨어를 나타내는 카탈로그 오퍼링 버전 CRN 및 관련 소프트웨어 플랜 CRN을 포함하는 객체.
/instance/software_attachments/{id} offering_instance 소프트웨어 플랜에서 인스턴스화된 소프트웨어 제공 인스턴스를 나타내는 객체입니다. 소프트웨어 제공 인스턴스의 CRN이 포함되어 있습니다.
/instance/software_attachments/{id} entitlement 소프트웨어 제공 인스턴스에 대한 라이선스 권한을 나타내는 객체입니다. 이 속성은 라이선스 관리자에 대한 호출이 성공적으로 완료되어 사용 권한을 획득한 후 동적으로 채워집니다.
/instance/software_attachments/{id} entitlement.licensed_software 0개 이상의 객체로 구성된 배열로, 각 객체는 가상 서버 인스턴스에 설치되고 라이선스가 부여된 소프트웨어 프로그램 또는 기능을 나타냅니다.
/instance/software_attachments/{id} entitlement.licensed_software[].sku 소프트웨어 플랜과 연계되어 가상 서버 인스턴스에서 실행되는, 라이선스가 부여 가능한 하나의 소프트웨어 프로그램 또는 기능에 해당하는 SKU(재고 관리 단위).
/instance/software_attachments/{id} entitlement.licensed_software[].key 소프트웨어 사용 권한에 대한 라이선스 키. 이 자산의 가치는 시간이 지남에 따라 변동될 수 있습니다.
/instance/software_attachments/{id} lifecycle_state 소프트웨어 첨부 파일의 수명 주기 상태로, 해당 파일이 완성되어 사용 가능한지 여부를 나타냅니다.
/instance/software_attachments/{id} lifecycle_reasons 현재 lifecycle_state의 다양한 원인.
/instance/software_attachments/{id} resource_type 리소스 유형입니다. instance_software_attachment로 설정하십시오.
/instance/software_attachments/{id} created_at 이 소프트웨어 첨부 파일이 생성된 날짜와 시간입니다.
/instance/volume_attachments/{id} bandwidth 이 인스턴스에 연결되었을 때 해당 볼륨의 최대 대역폭(메가비트/초 단위). 인스턴스의 구성에 따라 이 값은 볼륨 대역폭보다 작을 수 있습니다.
/instance/volume_attachments/{id} created_at 볼륨이 연결된 날짜 및 시간입니다.
/instance/volume_attachments/{id} delete_volume_on_instance_delete true 로 설정된 경우, 인스턴스를 삭제하면 볼륨도 함께 삭제됩니다.
/instance/volume_attachments/{id} device 볼륨이 인스턴스 운영 체제에 노출되는 방법에 대한 정보입니다.
/instance/volume_attachments/{id} id 볼륨 연결의 고유 ID입니다.
/instance/volume_attachments/{id} name 볼륨 연결의 사용자 정의 이름입니다.
/instance/volume_attachments/{id} status 볼륨 연결의 상태입니다(연결됨, 연결 중, 삭제 중 또는 분리 중).
/instance/volume_attachments/{id} type 볼륨 연결, 부트 또는 데이터의 유형입니다.
/instance/volume_attachments/{id} volume 볼륨이 삭제될 때 CRN, ID, 이름 및 deleted 값을 포함하는 연결된 볼륨입니다.

SSH 키에 대한 메타데이터의 요약

SSH 키에 대해 리턴되는 메타데이터의 유형에 대해 알아보려면 표 2의 정보를 사용하십시오.

SSH 키 메타데이터
SSH 키 URI 경로 메타데이터 키 메타데이터에 대한 설명
/keys keys 키의 집합입니다. 세부사항은 keys/{id}을(를) 참조하십시오.
/keys/{id} created_at 키가 작성된 날짜 및 시간입니다.
/keys/{id} crn 해당 키의 클라우드 리소스 이름입니다.
/keys/{id} fingerprint 키에 대한 지문. 이 값은 Base64로 인코딩되어 리턴되며 해시 알고리즘(항상 SHA256)이 접두부로 붙습니다.
/keys/{id} id 키에 대한 고유 식별자입니다.
/keys/{id} length 키의 길이(비트 단위).
/keys/{id} name 키에 대한 고유한 사용자 정의 이름입니다. 명시되지 않은 경우, 이름은 무작위로 선택된 단어들을 하이픈으로 연결한 목록이 됩니다(예: elderly-mountain-troop-opponent)
/keys/{id} public_key 공용 SSH 키입니다.
/keys/{id} type 해당 키가 사용하는 암호 체계.

배치 그룹에 대한 메타데이터의 요약

배치 그룹에 대해 리턴되는 메타데이터의 유형에 대해 알아보려면 표 3의 정보를 사용하십시오.

게재 그룹에 대한 메타데이터
배치 그룹 URI 경로 메타데이터 키 메타데이터에 대한 설명
/placement_groups placement_groups 배치 그룹의 집합입니다. 세부사항은 placement_groups/{id}을(를) 참조하십시오.
/placement_groups/{id} created_at 배치 그룹이 작성된 날짜 및 시간입니다.
/placement_groups/{id} crn 배치 그룹의 클라우드 리소스 이름.
/placement_groups/{id} id 배치 그룹의 고유 식별자입니다.
/placement_groups/{id} lifecycle_state 배치 그룹의 라이프사이클 상태입니다.
/placement_groups/{id} name 배치 그룹의 사용자 정의 이름입니다.
/placement_groups/{id} resource_type 리소스 유형입니다.
/placement_groups/{id} strategy 배치 그룹을 위한 전략.

소프트웨어 첨부 파일의 메타데이터 요약

다음 표에 있는 정보를 참고하여 소프트웨어 첨부 파일에 대해 반환되는 메타데이터의 유형을 파악하십시오.

/metadata/v1/instance/software_attachments 엔드포인트는 0개 이상의 소프트웨어 첨부 객체로 구성된 배열을 반환합니다. 각 객체는 소프트웨어 계획에 해당하는, 리소스 컨트롤러에 등록된 소프트웨어 인스턴스를 나타냅니다.

소프트웨어 첨부 파일의 메타데이터
소프트웨어 첨부 파일의 URI 경로 메타데이터 키 메타데이터에 대한 설명
/instance/software_attachments/{id} id 소프트웨어 첨부 파일에 대한 고유한 UUID입니다.
/instance/software_attachments/{id} name 가상 서버 인스턴스와 연결된 소프트웨어 첨부 파일 집합 내에서 고유한 이름입니다. 이 이름은 시스템에서 생성한 임의의 값으로 설정되며, 소유자는 원할 경우 나중에 이를 변경할 수 있습니다. 가상 서버 인스턴스의 소프트웨어 첨부 파일에서 이름을 업데이트하더라도, 첨부된 부팅 볼륨의 이름이나 해당 볼륨을 기반으로 이미 생성된 스냅샷에는 아무런 영향이 없음을 유의하십시오.
/instance/software_attachments/{id} href 이 소프트웨어 부속물에 대한 URL.
/instance/software_attachments/{id} catalog_offering 동일한 이름의 인스턴스 객체와 값이 동일한 객체로, 해당 소프트웨어를 나타내는 카탈로그 오퍼링 버전 CRN 및 관련 소프트웨어 플랜 CRN을 포함합니다.
/instance/software_attachments/{id} offering_instance 소프트웨어 플랜에서 인스턴스화된 소프트웨어 제공 인스턴스를 나타내는 객체입니다.
/instance/software_attachments/{id} offering_instance.crn CRN 소프트웨어 제공 인스턴스.
/instance/software_attachments/{id} entitlement(선택사항) 소프트웨어 제공 인스턴스에 대한 라이선스 권한을 나타내는 객체입니다. 이 항목이 없으면 해당 소프트웨어 플랜에는 라이선스가 연결되어 있지 않습니다.
/instance/software_attachments/{id} entitlement.licensed_software 0개 이상의 객체로 구성된 배열로, 각 객체는 가상 서버 인스턴스에 설치되고 라이선스가 부여된 소프트웨어 프로그램 또는 기능을 나타냅니다.
/instance/software_attachments/{id} entitlement.licensed_software[].sku 소프트웨어 플랜과 연계되어 가상 서버 인스턴스에서 실행되는, 라이선스가 부여 가능한 하나의 소프트웨어 프로그램 또는 기능에 해당하는 SKU(재고 관리 단위). 이는 해당 소프트웨어 공급업체에게 의미가 있습니다.
/instance/software_attachments/{id} entitlement.licensed_software[].key(선택사항) 소프트웨어 사용 권한에 대한 라이선스 키. 해당 항목이 없는 경우, 아직 라이선스를 취득하지 않은 것입니다.
/instance/software_attachments/{id} lifecycle_state 소프트웨어 첨부 파일의 수명 주기 상태. "stable"인 경우, 소프트웨어 인스턴스가 성공적으로 생성된 것입니다.
/instance/software_attachments/{id} lifecycle_reasons[] 현재 lifecycle_state의 이유입니다.
/instance/software_attachments/{id} resource_type instance_software_attachment 로 설정된 리소스 유형.
/instance/software_attachments/{id} created_at 이 소프트웨어 첨부 파일이 생성된 날짜와 시간입니다.

다음 단계

메타데이터 서비스를 사용하여 데이터를 검색하십시오.