createVpcPeeringInstance

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

Peering 요청을 통해서 VPC Peering 인스턴스를 생성합니다.

구문

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

./ncloud vpc createVpcPeeringInstance \
    --sourceVpcNo <source-vpc-no> \
    --targetVpcNo <target-vpc-no> \
    [--targetVpcName <target-vpc-name>] \
    [--targetVpcLoginId <target-vpc-login-id>] \
    [--vpcPeeringName <vpc-peering-name>] \
    [--vpcPeeringDescription <vpc-peering-description>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

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

필수 옵션

createVpcPeeringInstance의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--sourceVpcNo`	String	Required	Peering 요청을 보내는 VPC 번호 getVpcList 참조
`--targetVpcNo`	String	Required	Peering 요청을 받는 VPC 번호 Peering 요청을 보내는 VPC와 요청을 받는 VPC의 IPv4 CIDR 블록이 겹치면 VPC Peering으로 연결할 수 없음 요청을 받는 계정에서 getVpcList 참조
`--targetVpcName`	String	Conditional	Peering 요청을 받는 VPC 이름 Peering 요청을 받는 계정이 보내는 계정과 다른 경우, 요청을 받는 VPC의 이름을 입력해야 함
`--targetVpcLoginId`	String	Conditional	Peering 요청을 받는 VPC 소유자 ID (이메일 형식) 요청을 받는 계정이 보내는 계정과 다른 경우, 요청을 받는 계정을 입력해야 함

선택 옵션

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

옵션	타입	필수 여부	설명
`--vpcPeeringName`	String	Optional	VPC Peering 이름 영문 소문자, 숫자, 특수문자 `-`를 조합하여 3~30자 이내로 입력 문자열은 영문자로 시작해서 영문자 또는 숫자로 끝나야 함 미입력 시 네이버 클라우드 플랫폼에서 자동으로 부여
`--vpcPeeringDescription`	String	Optional	VPC Peering에 대한 설명 (Byte) 0~1,000

공통 옵션

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

예시

VPC Peering 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.

명령

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

./ncloud vpc createVpcPeeringInstance \
    --sourceVpcNo 12345678 \
    --targetVpcNo 12345679 \
    --targetVpcName test-vpc-02 \
    --targetVpcLoginId user2@example.com \
    --vpcPeeringName test-peering \
    --vpcPeeringDescription "VPC peering example" \
    --regionCode KR \
    --output json

출력

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

{
  "createVpcPeeringInstanceResponse": {
    "totalRows": 1,
    "vpcPeeringInstanceList": [
      {
        "vpcPeeringInstanceNo": "67890123",
        "vpcPeeringName": "test-peering",
        "regionCode": "KR",
        "createDate": "2026-07-20T14:58:05+0900",
        "lastModifyDate": "2026-07-20T14:58:05+0900",
        "vpcPeeringInstanceStatus": {
          "code": "INIT",
          "codeName": "INIT 상태"
        },
        "vpcPeeringInstanceStatusName": "Waiting",
        "vpcPeeringInstanceOperation": {
          "code": "NULL",
          "codeName": "NULL OP"
        },
        "sourceVpcNo": "12345678",
        "sourceVpcName": "vpc01",
        "sourceVpcIpv4CidrBlock": "192.168.0.0/16",
        "sourceVpcLoginId": "user@example.com",
        "targetVpcNo": "12345679",
        "targetVpcName": "test-vpc-02",
        "targetVpcIpv4CidrBlock": "10.0.0.0/16",
        "targetVpcLoginId": "user2@example.com",
        "vpcPeeringDescription": "VPC peering example",
        "hasReverseVpcPeering": false,
        "isBetweenAccounts": true,
        "reverseVpcPeeringInstanceNo": ""
      }
    ],
    "requestId": "a0b26de6-b1c2-4e9a-8667-778b24e14ea9",
    "returnCode": "0",
    "returnMessage": "success"
  }
}