Search VPC list
    • PDF

    Search VPC list

    • PDF

    Article summary

    Available in VPC

    Description

    Search a list of available VPCs.

    Request

    Request URL

    GET https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getVpcList [KR]
    GET https://vpcsearchengine.apigw.ntruss.com/api/sgn-v2/cluster/getVpcList [SGN]
    GET https://vpcsearchengine.apigw.ntruss.com/api/jpn-v2/cluster/getVpcList [JPN]
    

    Request headers

    HeaderDescription
    x-ncp-apigw-timestampThis is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC.
    If the time difference compared to the API Gateway server is more than 5 minutes, then the request is considered invalid.
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyThis is the Access Key ID value issued by the Naver Cloud Platform portal.
    x-ncp-iam-access-key:{Account Access Key}
    x-ncp-apigw-signature-v2This is the signature encrypted Access Key ID value and Secret Key.
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    Content-TypeSpecifies the request body content type as application/json
    Content-Type: application/json

    Request example

    GET https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getVpcList
    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
    
    curl -X GET "https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getVpcList" \
    -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=" 
    

    Response parameters

    public class GetVpcListResponseVo {
        ArrayList<VpcListDetailVo> content;
    }
    
    public class VpcListDetailVo {
        DateTimeVo createdDate;
        String ipv4Cidr;
        String regionNo;
        String statusCode;
        String vpcName;
        Integer vpcNo;
        String permission;
    }
    
    public class DateTimeVo {
        @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd", timezone = "Asia/Seoul")
        Date formattedDate;
        @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss SSSSSS", timezone = "Asia/Seoul")
        Date formattedDateTime;
        Long utc;
    }
    

    Field

    Parameter NameTypeDescription
    contentArrayList<SubnetListDetailVo>List of VPCs
    createdDateDateTimeVoCreated date
    ipv4CidrStringVPC range
    regionNoStringNCP region no.
    statusCodeStringVPC status code
    vpcNameStringVPC name
    vpcNoIntegerVPC no.
    permissionStringThis is the availability status of a Subaccount account. If it's set to Deny, then it means it is not available since you have no getVPCDetail permissions.
    formattedDateDateCreation date
    formattedDateTimeDateCreation date and time
    utcLongConvert the UTC time created into milliseconds

    Response example

    {
      "code": 0,
      "message": "SUCCESS",
      "result": {
        "content": [
          {
            "createdDate": {
              "formattedDate": "2020-06-22",
              "formattedDateTime": "2020-06-22 10:18:24 000686",
              "utc": 1592788704686
            },
            "ipv4Cidr": "10.0.0.0/20",
            "regionNo": "1",
            "statusCode": "RUN",
            "vpcName": "test",
            "vpcNo": 36752,
            "permission": "Allow"
          }
        ]
      },
      "requestId": "73cb1de6-c3e1-4a9d-9215-470158dd199f"
    }
    

    Was this article helpful?

    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.