Subnet 목록 조회

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

설명

사용할 수 있는 Subnet 목록을 조회합니다

요청

요청 URL

POST https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/cluster/getSubnetList [수도권]
POST https://clouddatastreamingservice.apigw.gov-ntruss.com/api/krs-v1/cluster/getSubnetList [남부권]

요청 헤더

헤더명	설명
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 액션을 통해 획득 가능

요청 예시

POST https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/cluster/getSubnetList
HOST: clouddatastreamingservice.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

{
  "softwareProductCode": "SW.VELST.OS.LNX64.CNTOS.0703.B050",
  "vpcNo": 36752
}

curl -X POST "https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/cluster/getSubnetList" \
-H "accept: application/json" \
-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=" \
-d \
'{
  "softwareProductCode": "SW.VELST.OS.LNX64.CNTOS.0703.B050",
  "vpcNo": 36752
}'

응답 파라미터

public class GetSubnetListResponseVo {
    ArrayList<SubnetListDetailVo> content;
}

public class SubnetListDetailVo {
    Boolean isPublic;
    String subnet;
    String subnetName;
    Integer subnetNo;
    String vpcName;
    Integer vpcNo;
    String zoneName;
    Integer zoneNo;
    String permission;
}

필드

파라미터명	타입	설명
content	ArrayList<SubnetListDetailVo>	Subnet 목록
isPublic	Boolean	Public 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": {
		"error": null,
		"content": [{
			"isPublic": false,
			"subnet": "10.0.2.0/24",
			"subnetName": "clean-private2",
			"subnetNo": 1507,
			"vpcName": "clean",
			"vpcNo": 1236,
			"zoneName": "KR-2",
			"zoneNo": 3,
			"actionName": "View/getSubnetDetail",
			"permission": "Allow"
		}, {
			"isPublic": false,
			"subnet": "10.0.1.0/24",
			"subnetName": "clean-private",
			"subnetNo": 1301,
			"vpcName": "clean",
			"vpcNo": 1236,
			"zoneName": "KR-1",
			"zoneNo": 2,
			"actionName": "View/getSubnetDetail",
			"permission": "Allow"
		}, {
			"isPublic": true,
			"subnet": "10.0.0.0/24",
			"subnetName": "clean-pub",
			"subnetNo": 1300,
			"vpcName": "clean",
			"vpcNo": 1236,
			"zoneName": "KR-1",
			"zoneNo": 2,
			"actionName": "View/getSubnetDetail",
			"permission": "Allow"
		}]
	},
	"requestId": "2fc8b391-fcb8-4280-aae2-a88571b842e4"
}