본문으로 건너뛰기

VPC & Network

VPC와 Network API의 네트워크 리소스별 작업을 안내합니다. 각 API 링크에서 요청 파라미터, 본문 스키마와 응답을 확인할 수 있습니다.

리소스별 API​

네트워크 인터페이스, 퍼블릭 IP, VPC, 서브넷 등 주요 리소스의 API를 선택하면 요청 정보와 응답 형식을 확인할 수 있습니다.

Network interfaces​

네트워크 인터페이스 설정과 허용 주소를 관리합니다.

기본 URL: https://vpc.kr-central-2.kakaocloud.com

API설명
Create network interface신규 네트워크 인터페이스를 생성합니다.
Delete network interface네트워크 인터페이스를 삭제합니다. 단, 인스턴스에 연결되지 않은 Available 상태의 네트워크 인터페이스만 삭제할 수 있습니다.
Get network interface특정 네트워크 인터페이스의 상세 정보를 조회합니다.
List network interfaces프로젝트 내 네트워크 인터페이스 목록을 조회합니다. 필터 조건을 설정하여 특정 조건에 맞는 인터페이스만 조회할 수 있으며, 정렬 및 페이지네이션도 지원합니다.
Update network interface네트워크 인터페이스의 이름, 설명, 보안 그룹 정보를 수정합니다.
Update network interface allowed addresses네트워크 인터페이스에 대해 송신이 허용된 IP 목록을 설정하거나 갱신합니다.

Public IPs​

퍼블릭 IP를 할당·조회·수정·삭제하고 네트워크 인터페이스 연결을 관리합니다.

기본 URL: https://network.kr-central-2.kakaocloud.com

API설명
Create public IP신규 퍼블릭 IP를 생성합니다.
Delete public IP지정한 퍼블릭 IP를 삭제합니다.
Get public IP지정한 퍼블릭 IP의 상세 정보를 조회합니다.
List public IPs프로젝트에 생성된 퍼블릭 IP 목록을 조회합니다.
Update public IP퍼블릭 IP에 대한 설명을 수정합니다.
Associate public IP퍼블릭 IP를 지정한 네트워크 인터페이스에 연결합니다.
Disassociate public IP지정한 퍼블릭 IP와 네트워크 인터페이스 간의 연결을 해제합니다.

Internet gateways​

인터넷 게이트웨이와 VPC 연결을 생성하고 관리합니다.

기본 URL: https://vpc.kr-central-2.kakaocloud.com

API설명
Create IGW attachment인터넷 게이트웨이(IGW)를 VPC에 연결하는 Attachment를 생성합니다.
Create internet gateway인터넷 게이트웨이(IGW)를 생성합니다. 생성된 인터넷 게이트웨이는 VPC에 연결하여 외부 인터넷 통신 경로로 사용할 수 있습니다.
Delete IGW attachment인터넷 게이트웨이(IGW)와 VPC의 연결을 해제하기 위해 IGW Attachment를 삭제합니다.
Delete internet gateway인터넷 게이트웨이(IGW)를 삭제합니다.
Get internet gateway인터넷 게이트웨이(IGW)의 상세 정보를 조회합니다. 응답에는 연결된 VPC와 Attachment 정보가 함께 포함될 수 있습니다.
List internet gateways인터넷 게이트웨이(IGW) 목록을 조회합니다. ID, 이름, 연결된 VPC, Attachment 상태 등의 조건으로 결과를 필터링할 수 있습니다.
Update internet gateway인터넷 게이트웨이(IGW)의 이름 또는 설명을 수정합니다.

Route tables​

라우팅 테이블, 개별 라우트 및 연결 정보를 관리합니다.

기본 URL: https://vpc.kr-central-2.kakaocloud.com

API설명
Add route라우팅 테이블에 새로운 라우팅 항목을 추가합니다.
Create route tableVPC에 새로운 라우팅 테이블을 생성합니다.
Delete route지정한 라우팅 테이블에서 개별 라우팅(Route) 항목을 삭제합니다.
Delete route table지정한 라우팅 테이블을 삭제합니다.
Get route table지정한 라우팅 테이블 ID에 해당하는 라우팅 테이블의 세부 정보를 조회합니다.
List route table associations지정한 라우팅 테이블에 연결된 모든 서브넷 목록을 조회합니다.
List route tables프로젝트 내 라우팅 테이블 목록을 조회합니다. 각 라우팅 테이블에는 관련 VPC 정보, 연결된 서브넷 수, 라우팅 경로 정보 등이 포함됩니다.
Set main route table지정한 라우팅 테이블을 VPC의 기본(main) 라우팅 테이블로 설정합니다.
Update route라우팅 테이블에 등록된 개별 라우팅 항목을 수정합니다. 목적지(CIDR) 또는 대상 리소스(ID)를 변경할 수 있으며, 수정 내용은 즉시 적용됩니다.
Update route table라우팅 테이블의 이름 및 설명을 수정합니다.
Update route table association라우팅 테이블과 서브넷 간 연결 정보를 수정합니다. 라우팅 테이블에 연결되어 있는 서브넷을 다른 대상 라우팅 테이블에 연결할 수 있습니다.

Security groups​

보안 그룹과 트래픽 허용 규칙을 관리합니다.

기본 URL: https://network.kr-central-2.kakaocloud.com

API설명
Create security group새로운 보안 그룹을 생성합니다.
Create security group rule보안 그룹에 대한 새로운 보안 그룹 규칙(인바운드 또는 아웃바운드)을 생성하여 특정 트래픽을 허용하거나 제한합니다.
Delete security group지정한 보안 그룹을 삭제합니다.
Delete security group rule지정한 보안 그룹 규칙(인바운드 또는 아웃바운드)을 삭제합니다.
Get security group지정한 보안 그룹에 대한 상세 정보를 조회합니다.
List security groups프로젝트 내에서 사용 중인 보안 그룹 목록을 조회합니다.
Update security group보안 그룹의 이름과 설명을 수정합니다.

Subnets​

서브넷 구성과 프로젝트 간 공유를 관리합니다.

기본 URL: https://vpc.kr-central-2.kakaocloud.com

API설명
Create subnetVPC 내에 새로운 서브넷을 생성합니다.
Delete subnet지정한 서브넷을 삭제합니다.
Get subnet특정 서브넷의 상세 정보를 조회합니다.
List subnet shared projects지정한 서브넷 ID에 대해 해당 서브넷을 공유받은 프로젝트 목록을 조회합니다.
List subnets프로젝트 내에서 사용 중인 서브넷 목록을 조회합니다.
Share subnet지정한 서브넷을 다른 프로젝트에 공유합니다.
Unshare subnet지정한 서브넷의 공유를 해제하여, 대상 프로젝트에서 더 이상 이 서브넷을 사용할 수 없도록 합니다.
Update subnet기존 서브넷의 이름을 수정합니다.

VPCs​

격리된 가상 네트워크를 생성하고 구성 정보를 관리합니다.

기본 URL: https://vpc.kr-central-2.kakaocloud.com

API설명
Create VPC새로운 VPC를 생성합니다.
Delete VPC지정한 VPC를 삭제합니다.
Get VPCVPC의 상세 정보를 조회합니다.
List VPCs프로젝트 내에서 생성된 VPC 목록을 조회합니다.
Update VPCVPC의 이름 및 설명을 수정합니다.