getPlacementGroupList

개요

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

요청

요청 파라미터

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

응답

응답 데이터 타입

  • 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 FKR --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>