createSubnet

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

사용자가 지정한 조건에 따라 Subnet을 생성합니다.

구문

createSubnet 구문은 다음과 같습니다.

./ncloud vpc createSubnet \
    --vpcNo <vpc-no> \
    --zoneCode <zone-code> \
    --subnet <subnet-ip-range> \
    --subnetTypeCode <PUBLIC|PRIVATE> \
    --networkAclNo <network-acl-no> \
    [--subnetName <subnet-name>] \
    [--usageTypeCode <GEN|LOADB|BM|NATGW>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

createSubnet 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createSubnet의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--vpcNo`	String	Required	VPC 번호 getVpcList 참조
`--zoneCode`	String	Required	존 코드 getZoneList 참조
`--subnet`	String	Required	IP 주소 범위 `/16`~`/28` Private 대역(`10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) 사용
`--subnetTypeCode`	String	Required	Subnet 유형 코드 `PUBLIC` \| `PRIVATE` `PUBLIC`: 인터넷 게이트웨이 허용 `PRIVATE`: 인터넷 게이트웨이 비허용
`--networkAclNo`	String	Required	네트워크 ACL 번호 getNetworkAclList 참조

선택 옵션

createSubnet의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--subnetName`	String	Optional	Subnet 이름 영문 소문자, 숫자, 특수 문자 `-`를 조합하여 3~30자 이내로 입력 문자열은 영문자로 시작해서 영문자 또는 숫자로 끝나야 함 미입력 시 네이버 클라우드 플랫폼에서 자동으로 부여
`--usageTypeCode`	String	Optional	Subnet의 용도 유형 코드 `GEN` \| `LOADB` \| `BM` \| `NATGW` `GEN`: 일반 `LOADB`: 로드밸런서 전용 `BM`: 베어메탈 전용 `NATGW`: NAT Gateway 전용

공통 옵션

vpc 명령에서 공통으로 사용하는 옵션에 대한 정보는 VPC 옵션을 참조해 주십시오.

예시

Subnet 생성 요청이 성공하면 Subnet의 구성 정보와 생성 상태가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vpc createSubnet \
    --vpcNo 12345678 \
    --zoneCode KR-1 \
    --subnet 192.168.2.0/24 \
    --subnetTypeCode PUBLIC \
    --networkAclNo 56789011 \
    --subnetName test-subnet-01 \
    --usageTypeCode GEN \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "createSubnetResponse": {
    "totalRows": 1,
    "subnetList": [
      {
        "subnetNo": "23456789",
        "vpcNo": "12345678",
        "zoneCode": "KR-1",
        "subnetName": "test-subnet-01",
        "subnet": "192.168.2.0/24",
        "subnetStatus": {
          "code": "CREATING",
          "codeName": "생성중"
        },
        "createDate": "2026-07-16T11:37:06+0900",
        "subnetType": {
          "code": "PUBLIC",
          "codeName": "Public"
        },
        "usageType": {
          "code": "GEN",
          "codeName": "General"
        },
        "networkAclNo": "56789011"
      }
    ],
    "requestId": "4d510f0b-91b1-4f7e-96c3-08fe18c21157",
    "returnCode": "0",
    "returnMessage": "success"
  }
}