Documentation Index

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

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

getPlacementGroupList

Prev Next

VPC 환경에서 이용 가능합니다.

개요

서버 인스턴스(VM)가 소속되는 물리 배치 그룹 리스트를 조회합니다.

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
regionCode No String - 리전 코드
물리 배치 그룹 리스트가 조회될 리전(Region)을 결정 가능
regionCode는 getRegionList 액션을 통해 획득 가능
Default : getRegionList 조회 결과의 첫 번째 리전을 선택
placementGroupNoList.N No List<String> - 물리 배치 그룹 번호 리스트
물리 배치 그룹 번호로 필터링하여 검색 가능
placementGroupNo는 getPlacementGroupList 액션을 통해 획득 가능
ex) --placementGroupNoList 1234 2345
placementGroupName No String - 물리 배치 그룹 이름
물리 배치 그룹 이름으로 필터링하여 검색 가능
output No String 응답 결과의 포맷 타입
  • Options : xml | json
  • Default : json

응답

응답 데이터 타입

  • PlacementGroupList 타입
PlacementGroupList extends CommonResponse
private Integer totalRows;
private List placementGroupList = new ArrayList<>();
PlacementGroup
private String placementGroupNo;
private String placementGroupName;
private CommonCode placementGroupType;

예시

요청 예시

ncloud vserver getPlacementGroupList --regionCode KR --placementGroupNoList ***61 --placementGroupName test-***

응답 예시

<getPlacementGroupListResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <placementGroupList>
    <placementGroup>
      <placementGroupNo>***61</placementGroupNo>
      <placementGroupName>test-***</placementGroupName>
      <placementGroupType>
        <code>AA</code>
        <codeName>Anti-Affinity</codeName>
      </placementGroupType>
    </placementGroup>
  </placementGroupList>
</getPlacementGroupListResponse>