---
title: "createVpcPeeringInstance"
slug: "networking-vpc-vpcpeering-createvpcpeeringinstance"
tags: ["Vpc Peering", "Vpc"]
updated: 2026-09-17T09:10:34Z
published: 2026-09-17T09:10:34Z
canonical: "api-fin.ncloud-docs.com/networking-vpc-vpcpeering-createvpcpeeringinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# createVpcPeeringInstance

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

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET, POST | /createVpcPeeringInstance |

### 요청 헤더

VPC API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 [VPC 공통 헤더](/docs/networking-vpc#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

### 요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `regionCode` | String | Optional | VPC Peering 인스턴스를 생성하려는 리전 코드조회 결과의 첫 번째 리전(기본값)[getRegionList](/docs/compute-vserver-server-common-getregionlist)를 통해 확인 |
| `vpcPeeringName` | String | Optional | 생성하려는 VPC Peering 이름네이버 클라우드 플랫폼이 자동으로 부여(기본값)3~30자로 영문자, 숫자, 특수 문자 '-'를 허용하며 영문자로 시작해서 영문자 또는 숫자로 끝나야 함 |
| `sourceVpcNo` | String | Required | Peering 요청을 보내는 VPC 번호[getVpcList](/docs/networking-vpc-vpcmanagement-getvpclist)를 통해 확인 |
| `targetVpcNo` | String | Required | Peering 요청을 받는 VPC 번호요청을 받는 계정에서 [getVpcList](/docs/networking-vpc-vpcmanagement-getvpclist)를 통해 확인Peering 요청을 보내는 VPC와 요청을 받는 VPC의 IPv4 CIDR 블록이 겹치면 VPC Peering으로 연결할 수 없음 |
| `targetVpcName` | String | Conditional | Peering 요청을 받는 VPC 이름Peering 요청을 받는 계정이 보내는 계정과 다른 경우에 요청을 받는 VPC의 이름을 입력해야 함 |
| `targetVpcLoginId` | String | Conditional | Peering 요청을 받는 VPC 소유자 ID (이메일 형식)요청을 받는 계정이 보내는 계정과 다른 경우에 요청을 받는 계정을 입력해야 함 |
| `vpcPeeringDescription` | String | Optional | 생성하려는 VPC Peering에 대한 설명 (Byte) 0~1000 |
| `responseFormatType` | String | Optional | 응답 결과의 형식 - `xml` (기본값) \| `json` |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location 'https://fin-ncloud.apigw.fin-ntruss.com/vpc/v2/createVpcPeeringInstance?regionCode=KR
&vpcPeeringName=test-***
&sourceVpcNo=***05
&targetVpcNo=***06'
--header 'x-ncp-apigw-timestamp: {Timestamp}'     
--header 'x-ncp-iam-access-key: {Access Key}' 
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디는 [VpcPeeringInstanceList](/docs/common-apidatatype-vpcpeeringinstancelist)를 참조해 주십시오.

### 응답 상태 코드

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 [Ncloud API 응답 상태 코드](/docs/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
<createVpcPeeringInstanceResponse>
  <requestId>450c98e2-dca5-46f7-9f35-5ec1a1728213</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <vpcPeeringInstanceList>
    <vpcPeeringInstance>
      <vpcPeeringInstanceNo>***6212</vpcPeeringInstanceNo>
      <vpcPeeringName>test-***</vpcPeeringName>
      <regionCode>KR</regionCode>
      <createDate>2020-08-07T17:53:06+0900</createDate>
      <lastModifyDate>2020-08-05T20:53:16+0900</lastModifyDate>
      <vpcPeeringInstanceStatus>
        <code>INIT</code>
        <codeName>init</codeName>
      </vpcPeeringInstanceStatus>
      <vpcPeeringInstanceStatusName>Creating</vpcPeeringInstanceStatusName>
      <vpcPeeringInstanceOperation>
        <code>NULL</code>
        <codeName>NULL OP</codeName>
      </vpcPeeringInstanceOperation>
      <sourceVpcNo>***05</sourceVpcNo>
      <sourceVpcName>test-***</sourceVpcName>
      <sourceVpcIpv4CidrBlock>***.**1.0.0/16</sourceVpcIpv4CidrBlock>
      <sourceVpcLoginId>test-***@naver.com</sourceVpcLoginId>
      <targetVpcNo>***06</targetVpcNo>
      <targetVpcName>test-***</targetVpcName>
      <targetVpcIpv4CidrBlock>***.**2.0.0/16</targetVpcIpv4CidrBlock>
      <targetVpcLoginId>test-***@naver.com</targetVpcLoginId>
      <vpcPeeringDescription></vpcPeeringDescription>
      <hasReverseVpcPeering>false</hasReverseVpcPeering>
      <isBetweenAccounts>false</isBetweenAccounts>
      <reverseVpcPeeringInstanceNo></reverseVpcPeeringInstanceNo>
    </vpcPeeringInstance>
  </vpcPeeringInstanceList>
</createVpcPeeringInstanceResponse>
```