MENU
      Subnet 목록 조회

        Subnet 목록 조회


        기사 요약

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

        설명

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

        요청

        요청 URL

        GET https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getSubnetList
        ?softwareProductCode={softwareProductCode}
        &vpcNo={vpcNo} [KR]
        
        GET https://vpcsearchengine.apigw.ntruss.com/api/sgn-v2/cluster/getSubnetList
        ?softwareProductCode={softwareProductCode}
        &vpcNo={vpcNo} [SGN]
        
        GET https://vpcsearchengine.apigw.ntruss.com/api/jpn-v2/cluster/getSubnetList
        ?softwareProductCode={softwareProductCode}
        &vpcNo={vpcNo} [JPN]
        HTTP

        요청 헤더

        헤더명설명
        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-v2Access Key ID 값과 Secret Key로 암호화한 서명
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeRequest body content type을 application/json으로 지정
        Content-Type: application/json

        요청 파라미터

        파라미터타입필수 여부설명
        softwareProductCodeStringY- 사용할 할 OS 타입
        getOsProductList 액션을 통해 획득 가능
        vpcNoIntegerY- 사용할 VPC No
        getVpcList 액션을 통해 획득 가능

        요청 예시

        GET https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getSubnetList
        ?softwareProductCode=SW.VELST.OS.LNX64.CNTOS.0708.B050
        &vpcNo=1236
        HOST: vpcsearchengine.apigw.ntruss.com
        Content-Type: application/json
        x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
        x-ncp-apigw-timestamp: 1593848345548
        x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw
        HTTP
        curl -X GET "https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getSubnetList
        ?softwareProductCode=SW.VELST.OS.LNX64.CNTOS.0708.B050
        &vpcNo=1236" \
        -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=" \
        Bash

        응답 파라미터

        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;
        }
        Java

        필드

        파라미터명타입설명
        contentArrayList<SubnetListDetailVo>Subnet 목록
        subnetStringSubnet IP 주소 범위
        subnetNameStringSubnet 이름
        subnetNoIntegerSubnet 번호
        vpcNameStringVPC 이름
        vpcNoIntegerVPC 번호
        zoneNameStringzone 이름
        zoneNoIntegerzone 번호
        permissionStringSubaccount 계정에서의 사용 가능 여부
        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"
        }
        JSON

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.