Documentation Index

Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

getInstanceTagList

Prev Next

개요

인스턴스 태그를 조회합니다.

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
instanceNoList.N No List<String> 중복 불가 - 인스턴스 태그를 조회할 서버 인스턴스 번호 리스트 [서버 한정]
ex)instanceNoList.1=1088217
tagKeyList.N No List<String> 중복 불가 - 조회 할 인스턴스의 태그 키
Instance의 TagKey는 getInstanceTagList 액션을 통해 획득 가능
ex) tagKeyList.1=tag1
tagValueList.N No List<String> 중복 불가 - 조회 할 인스턴스의 태그 값
Instance의 TagValue는 getInstanceTagList 액션을 통해 획득 가능
tagValueList.1=dolphins
pageNo No Integer - 페이징된 결과의 페이지 번호
결과값을 pageNo를 이용하여 페이징 처리 가능
pageSize No Integer - 페이징 시 보여줄 각 페이지 사이즈
결과값을 pageSize를 이용하여 페이징 처리 가능
responseFormatType No String - 응답 결과의 포맷 타입
Options : xml | json
Default : xml

응답

응답 바디

예시

요청 예시

GET {SERVER_API_URL}/getInstanceTagList
?tagKeyList.1=tag1

응답 예시

<getInstanceTagListResponse>
  <requestId>8b3584cc-d7c6-44fb-9976-3b8a11180bf7</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <instanceTagList>
    <instanceTag>
      <instanceNo>1088217</instanceNo>
      <instanceType>
        <code>SVR</code>
        <codeName>Server</codeName>
      </instanceType>
      <tagKey>tag1</tagKey>
      <tagValue>dolphins</tagValue>
    </instanceTag>
  </instanceTagList>
</getInstanceTagListResponse>