Subnet 목록 조회
- 인쇄
- PDF
Subnet 목록 조회
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
VPC 환경에서 이용 가능합니다.
설명
사용할 수 있는 Subnet 목록을 조회합니다
요청
요청 URL
GET https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/cluster/getSubnetList
?softwareProductCode={softwareProductCode}
&vpcNo={vpcNo} [수도권]
GET https://vpcsearchengine.apigw.gov-ntruss.com/api/krs-v2/cluster/getSubnetList
?softwareProductCode={softwareProductCode}
&vpcNo={vpcNo} [남부권]
요청 헤더
| 헤더명 | 설명 |
|---|---|
| x-ncp-apigw-timestamp | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값x-ncp-iam-access-key:{Account Access Key} |
| x-ncp-apigw-signature-v2 | Access Key ID 값과 Secret Key로 암호화한 서명x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | Request body content type을 application/json으로 지정Content-Type: application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| softwareProductCode | String | Y | - 사용할 OS 타입 getOsProductList 액션을 통해 획득 가능 |
| vpcNo | Integer | Y | - 사용할 VPC No getVpcList 액션을 통해 획득 가능 |
요청 예시
GET https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/cluster/getSubnetList
?softwareProductCode=SW.VELST.OS.LNX64.CNTOS.0708.B050
&vpcNo=1236
HOST: vpcsearchengine.apigw.gov-ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw
curl -X GET "https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/cluster/getSubnetList
?softwareProductCode=SW.VELST.OS.LNX64.CNTOS.0708.B050
&vpcNo=1236" \
-H "accept: application/json" \
-H "X-NCP-REGION_NO: 1" \
-H "Content-Type: application/json" \
-H "x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw" \
-H "x-ncp-apigw-timestamp: 1601971222179" \
-H "x-ncp-apigw-signature-v2: zrCelnR48AADdK/uh6Xe3yy468i8KpQoewYHUmeqYh4=" \
응답 파라미터
public class GetSubnetListResponseVo {
ArrayList<SubnetListDetailVo> content;
}
public class SubnetListDetailVo {
String subnet;
String subnetName;
Integer subnetNo;
String vpcName;
Integer vpcNo;
String zoneName;
Integer zoneNo;
String permission;
}
필드
| 파라미터명 | 타입 | 설명 |
|---|---|---|
| content | ArrayList<SubnetListDetailVo> | Subnet 목록 |
| subnet | String | Subnet IP 주소 범위 |
| subnetName | String | Subnet 이름 |
| subnetNo | Integer | Subnet 번호 |
| vpcName | String | VPC 이름 |
| vpcNo | Integer | VPC 번호 |
| zoneName | String | zone 이름 |
| zoneNo | Integer | zone 번호 |
| permission | String | - Subaccount 계정에서의 사용 가능 여부 Deny일 경우 getSubnetDetail 권한이 없어 사용이 불가능한 상태를 의미 |
응답 예시
{
"code": 0,
"message": "SUCCESS",
"result": {
"content": [
{
"subnet": "10.0.2.16/28",
"subnetName": "privatesmall",
"subnetNo": 22632,
"vpcName": "test",
"vpcNo": 36752,
"zoneName": "KR-1",
"zoneNo": 2,
"permission": "Allow"
},
{
"subnet": "10.0.1.0/24",
"subnetName": "testpri",
"subnetNo": 22630,
"vpcName": "test",
"vpcNo": 36752,
"zoneName": "KR-1",
"zoneNo": 2,
"permission": "Allow"
}
]
},
"requestId": "79e63e0c-9cdb-4736-89c6-8a61dab0d687"
}
이 문서가 도움이 되었습니까?