VPC 환경에서 이용 가능합니다.
ACG 목록을 조회합니다.
구문
getAccessControlGroupList 구문은 다음과 같습니다.
./ncloud vserver getAccessControlGroupList \
[--vpcNo <vpc-no>] \
[--accessControlGroupNoList <acg-no-list>] \
[--accessControlGroupName <acg-name>] \
[--accessControlGroupStatusCode <INIT|SET|RUN|TERMTING>] \
[--pageNo <page-no>] \
[--pageSize <page-size>] \
[--regionCode <KR|SGN|JPN>] \
[--output <json|xml>]
옵션
getAccessControlGroupList 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
getAccessControlGroupList의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--pageSize |
Integer | Conditional | 페이지당 항목 수
|
선택 옵션
getAccessControlGroupList의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--vpcNo |
String | Optional | VPC 번호
|
--accessControlGroupNoList |
List | Optional | ACG 번호 목록
|
--accessControlGroupName |
String | Optional | ACG 이름 |
--accessControlGroupStatusCode |
String | Optional | ACG 상태 코드
|
--pageNo |
Integer | Optional | 페이지 번호
|
공통 옵션
vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server (VPC) 옵션을 참조해 주십시오.
예시
ACG 목록 조회 요청이 성공하면 각 ACG의 식별 정보와 운영 상태가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vserver getAccessControlGroupList \
--vpcNo 12345678 \
--accessControlGroupNoList 67890123 67890124 \
--accessControlGroupStatusCode RUN \
--pageNo 1 \
--pageSize 10 \
--regionCode KR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"getAccessControlGroupListResponse": {
"totalRows": 2,
"accessControlGroupList": [
{
"accessControlGroupNo": "67890123",
"accessControlGroupName": "test-acg-01",
"isDefault": false,
"vpcNo": "12345678",
"accessControlGroupStatus": {
"code": "RUN",
"codeName": "운영중"
},
"accessControlGroupDescription": "ACG for web tier"
},
{
"accessControlGroupNo": "67890124",
"accessControlGroupName": "test-acg-02",
"isDefault": false,
"vpcNo": "12345678",
"accessControlGroupStatus": {
"code": "RUN",
"codeName": "운영중"
},
"accessControlGroupDescription": "ACG for database tier"
}
],
"requestId": "b2c3d4e5-f678-9012-bcde-f23456789012",
"returnCode": "0",
"returnMessage": "success"
}
}