getAccessControlGroupList
- 인쇄
- PDF
getAccessControlGroupList
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
개요
ACG 리스트를 조회합니다. ACG는 네트워크 인터페이스에 설정하여 접근 제어 기능을 할 수 있습니다.
요청
요청 파라미터
| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
|---|---|---|---|---|
| regionCode | No | String | - 리전 코드 ACG 리스트가 조회될 리전(Region) 결정 가능 regionCode는 getRegionList 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택 | |
| vpcNo | No | String | - VPC 번호 VPC 번호로 필터링하여 검색 가능 vpcNo는 getVpcList 액션을 통해 획득 가능 | |
| accessControlGroupNoList.N | No | List<String> | - ACG 번호 리스트 ACG 번호로 필터링하여 검색 가능 accessControlGroupNo는 getAccessControlGroupList 액션을 통해 획득 가능 ex) accessControlGroupNoList 1234 2345 | |
| accessControlGroupName | No | String | - ACG 이름 ACG 이름으로 필터링하여 검색 가능 | |
| accessControlGroupStatusCode | No | String | - ACG 상태 코드 ACG 상태 코드로 필터링하여 검색 가능 Options : INIT | SET | RUN | TERMTING | |
| pageNo | No | Integer | - 페이징된 결과의 페이지 번호 결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능 | |
| pageSize | Conditional | Integer | - 페이징 시 보여줄 각 페이지 사이즈 결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능 pageNo 입력시 반드시 입력 필요 | |
| responseFormatType | No | String | - 응답 결과의 포맷 타입 Options : xml | json Default : xml |
응답
응답 데이터 타입
- AccessControlGroupList 타입
| AccessControlGroupList extends CommonResponse |
|---|
| private Integer totalRows; |
| private List<AccessControlGroup> accessControlGroupList = new ArrayList<>(); |
| AccessControlGroup |
|---|
| private String accessControlGroupNo; |
| private String accessControlGroupName; |
| private Boolean isDefault; |
| private String vpcNo; |
| private CommonCode accessControlGroupStatus; |
| private String accessControlGroupDescription; |
예시
요청 예시
ncloud vserver getAccessControlGroupList --regionCode KR --vpcNo ***04 --accessControlGroupNoList ***63 ***64 --accessControlGroupName test-*** --accessControlGroupStatusCode RUN
응답 예시
<getAccessControlGroupListResponse>
<requestId>aca35644-739e-42b3-bdcb-55c2eedc54b9</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<accessControlGroupList>
<accessControlGroup>
<accessControlGroupNo>***63</accessControlGroupNo>
<accessControlGroupName>test-***</accessControlGroupName>
<isDefault>false</isDefault>
<vpcNo>***04</vpcNo>
<accessControlGroupStatus>
<code>RUN</code>
<codeName>run</codeName>
</accessControlGroupStatus>
<accessControlGroupDescription></accessControlGroupDescription>
</accessControlGroup>
</accessControlGroupList>
</getAccessControlGroupListResponse>
이 문서가 도움이 되었습니까?