VPC

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다.

본 가이드는 VPC 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다. API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.

Version

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

OpenAPI URL

https://vpc.{region}.{environment}.samsungsdscloud.com

Environment and Region List

API Version History

1.3

Multi AZ 기능이 추가됩니다.

변경사항

• [변경] POST /v1/vpcs - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : zones, zone_type
• [변경] GET /v1/vpcs - 요청 및 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : zone, zones, zone_type
• [변경] GET /v1/vpcs/{vpc_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : zones, zone_type
• [변경] PUT /v1/vpcs/{vpc_id} - 응답 시, description 필드 외 모두 제거됩니다.
• [변경] POST /v1/vpcs/{vpc_id}/cidrs - 응답 시, cidr 필드 외 모두 제거됩니다.
• [변경] POST /v1/subnets - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : zones, role, primary_subnet_id, secondary_subnet_ids
  • 변경 : type의 boundary value 변경 및 추가(General -> Public 으로 변경, Private 신규)
• [변경] GET /v1/subnets - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : zones, role, primary_subnet_id
  • 변경 : type의 boundary value 변경 및 추가(General -> Public 으로 변경, Private 신규)
• [변경] GET /v1/subnets/{subnet_id} - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : zones, role, primary_subnet_id, secondary_subnet_ids
  • 변경 : type의 boundary value 변경 및 추가(General -> Public 으로 변경, Private 신규)
• [변경] PUT /v1/subnets/{subnet_id} - 응답 시, description, dhcp_ip_address 필드 외 모두 제거됩니다.
• [변경] POST /v1/internet-gateways - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : multi_zone_enabled
• [변경] GET /v1/internet-gateways - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : multi_zone_enabled
• [변경] GET /v1/internet-gateways/{internet_gateway_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : multi_zone_enabled
• [변경] PUT /v1/internet-gateways/{internet_gateway_id} - 응답 시, description, loggable 필드 외 모두 제거됩니다.
• [변경] POST /v1/nat-gateways - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : publicip_ids, multi_zone_enabled, nat_gateway_ip_addresses
  • 제거 : publicip_id, nat_gateway_ip_address
• [변경] GET /v1/nat-gateways - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : multi_zone_enabled, nat_gateway_ip_addresses
  • 제거 : nat_gateway_ip_address
• [변경] GET /v1/nat-gateways/{nat_gateway_id} - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : multi_zone_enabled, nat_gateway_ip_addresses
  • 제거 : nat_gateway_ip_address
• [변경] PUT /v1/nat-gateways/{nat_gateway_id} - 응답 시, description 필드 외 모두 제거됩니다.
• [변경] POST /v1/publicips - 요청 및 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : zone
• [변경] GET /v1/publicips - 요청 및 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : zone
• [변경] GET /v1/publicips/{publicip_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : zone
• [변경] PUT /v1/publicips/{publicip_id} - 응답 시, description 필드 외 모두 제거됩니다.
• [변경] GET /v1/transit-gateways - 요청 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : uplink_zone_state
• [변경] POST /v1/transit-gateways - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : uplink_active_zone, uplink_standby_zone, uplink_zone_state
• [변경] GET /v1/transit-gateways/{transit_gateway_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : uplink_active_zone, uplink_standby_zone, uplink_zone_state
• [변경] PUT /v1/transit-gateways/{transit_gateway_id} - 응답 시, description 필드 외 모두 제거됩니다.
• [변경] POST /v1/transit-gateways/{transit_gateway_id}/firewall-connections - 응답 시, firewall_connection_state 필드 외 모두 제거됩니다.
• [변경] DELETE /v1/transit-gateways/{transit_gateway_id}/firewall-connections - 응답 시, firewall_connection_state 필드 외 모두 제거됩니다.
• [변경] POST /v1/transit-gateways/{transit_gateway_id}/firewalls - 요청 및 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : uplink_active_zone, uplink_standby_zone, uplink_zone_state
• [변경] DELETE /v1/transit-gateways/{transit_gateway_id}/firewalls/{firewall_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : uplink_active_zone, uplink_standby_zone, uplink_zone_state

1.2

Virtual IP 기능 및 Transit Gateway Firewall 연결 기능이 추가되었습니다.

변경사항

• [신규] GET /v1/subnets/{subnet_id}/vips - api가 추가되었습니다.
• [신규] POST /v1/subnets/{subnet_id}/vips - api가 추가되었습니다.
• [신규] GET /v1/subnets/{subnet_id}/vips/{vip_id} - api가 추가되었습니다.
• [신규] PUT /v1/subnets/{subnet_id}/vips/{vip_id} - api가 추가되었습니다.
• [신규] DELETE /v1/subnets/{subnet_id}/vips/{vip_id} - api가 추가되었습니다.
• [신규] POST /v1/subnets/{subnet_id}/vips/{vip_id}/connected-ports - api가 추가되었습니다.
• [신규] DELETE /v1/subnets/{subnet_id}/vips/{vip_id}/connected-ports/{connected_port_id} - api가 추가되었습니다.
• [신규] POST /v1/subnets/{subnet_id}/vips/{vip_id}/static-nat-ips - api가 추가되었습니다.
• [신규] DELETE /v1/subnets/{subnet_id}/vips/{vip_id}/static-nat-ips/{static_nat_id} - api가 추가되었습니다.
• [신규] POST /v1/transit-gateways/{transit_gateway_id}/firewall-connections - api가 추가되었습니다.
• [신규] DELETE /v1/transit-gateways/{transit_gateway_id}/firewall-connections - api가 추가되었습니다.
• [신규] POST /v1/transit-gateways/{transit_gateway_id}/firewalls - api가 추가되었습니다.
• [신규] DELETE /v1/transit-gateways/{transit_gateway_id}/firewalls/{firewall_id} - api가 추가되었습니다.
• [신규] POST /v1/vpcs/{vpc_id}/cidrs - api가 추가되었습니다.
• [변경] GET /v1/vpcs - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : size, page, cidr_count, cidrs
  • 제거 : limit, marker, cidr
• [변경] GET /v1/vpcs/{vpc_id} - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : cidr_count, cidrs
  • 제거 : cidr
• [변경] : POST /v1/vpcs - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : cidr_count, cidrs
  • 제거 : cidr
• [변경] : PUT /v1/vpcs/{vpc_id} - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : cidr_count, cidrs
  • 제거 : cidr
• [변경] : GET /v1/subnets - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : size, page
  • 제거 : limit, marker
• [변경] : GET /v1/subnets/{subnet_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : dhcp_ip_addres
• [변경] : POST /v1/subnets - 요청 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : gateway_ip_address
• [변경] : PUT /v1/subnets/{subnet_id} - 요청 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : dhcp_ip_address
• [변경] : GET /v1/ports - 요청 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : attached_resource_types
• [변경] : GET /v1/ports/{port_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : virtual_ip_addresses
• [변경] : POST /v1/ports - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : virtual_ip_addresses
• [변경] : PUT /v1/ports/{port_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : virtual_ip_addresses
• [변경] : GET /v1/internet-gateways - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : size, page
  • 제거 : limit, marker
• [변경] : GET /v1/nat-gateways - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : size, page
  • 제거 : limit, marker
• [변경] : GET /v1/publicips - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : size, page
  • 제거 : limit, marker
• [변경] : GET /v1/publicips/{publicip_id} - attached_resource_type 필드의 Boundary Value가 확장 되었습니다.
• [변경] : GET /v1/vpc-endpoints - 요청 및 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가 : size, page
  • 제거 : limit, marker
• [변경] : GET /v1/private-nats - 요청 및 응답 시, 아래와 같은 필드가 추가되며 vpc, dcon 관련 필드는 제거됩니다.
  • 추가 : service_type, service_resource_id, service_resource_name
• [변경] : GET /v1/private-nats/{private_nat_id} - 요청 및 응답 시, 아래와 같은 필드가 추가되며 vpc, dcon 관련 필드는 제거됩니다.
  • 추가 : service_type, service_resource_id, service_resource_name
• [변경] : POST /v1/private-nats - 요청 및 응답 시, 아래와 같은 필드가 추가되며 vpc, dcon 관련 필드는 제거됩니다.
  • 추가 : service_type, service_resource_id, service_resource_name
• [변경] : PUT /v1/private-nats/{private_nat_id} - 요청 및 응답 시, 아래와 같은 필드가 추가되며 vpc, dcon 관련 필드는 제거됩니다.
  • 추가 : service_type, service_resource_id, service_resource_name
• [변경] : GET /v1/vpc-peerings/{vpc_peering_id}/routing-rules - 요청 시, 아래와 같은 필드가 변경됩니다.
  • 제거 : name
• [변경] : GET /v1/transit-gateways - 요청 및 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : firewall_connection_state
• [변경] : GET /v1/transit-gateways/{transit_gateway_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : firewall_connection_state
• [변경] : POST /v1/transit-gateways - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : firewall_connection_state
• [변경] : PUT /v1/transit-gateways/{transit_gateway_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : firewall_connection_state
• [변경] : GET /v1/transit-gateways/{transit_gateway_id}/routing-rules - 요청 및 응답 시, 아래와 같은 필드가 추가됩니다.
  • 추가 : rule_type

1.1

VPC API가 출시되었습니다.

변경사항

• [신규] GET /v1/privatelink-endpoints - api가 추가되었습니다.
• [신규] POST /v1/privatelink-endpoints - api가 추가되었습니다.
• [신규] GET /v1/privatelink-endpoints/{privatelink_endpoint_id} - api가 추가되었습니다.
• [신규] PUT /v1/privatelink-endpoints/{privatelink_endpoint_id} - api가 추가되었습니다.
• [신규] DELETE /v1/privatelink-endpoints/{privatelink_endpoint_id} - api가 추가되었습니다.
• [신규] PUT /v1/privatelink-endpoints/{privatelink_endpoint_id}/approval - api가 추가되었습니다.
• [신규] PUT /v1/privatelink-endpoints/{privatelink_endpoint_id}/connection - api가 추가되었습니다.
• [신규] PUT /v1/privatelink-endpoints/{privatelink_endpoint_id}/request - api가 추가되었습니다.
• [신규] GET /v1/privatelink-services - api가 추가되었습니다.
• [신규] POST /v1/privatelink-services - api가 추가되었습니다.
• [신규] GET /v1/privatelink-services/{privatelink_service_id} - api가 추가되었습니다.
• [신규] PUT /v1/privatelink-services/{privatelink_service_id} - api가 추가되었습니다.
• [신규] DELETE /v1/privatelink-services/{privatelink_service_id} - api가 추가되었습니다.
• [신규] GET /v1/privatelink-services/{privatelink_service_id}/connected-endpoints - api가 추가되었습니다.
• [신규] PUT /v1/vpc-peerings/{vpc_peering_id}/approval - api가 추가되었습니다.
• [신규] GET /v1/subnets/{subnet_id}/sap-secondary-subnets - api가 추가되었습니다.

1.0

VPC API가 출시되었습니다.

변경사항

• [신규] GET /v1/internet-gateways - api가 추가되었습니다.
• [신규] POST /v1/internet-gateways - api가 추가되었습니다.
• [신규] GET /v1/internet-gateways/{internet_gateway_id} - api가 추가되었습니다.
• [신규] PUT /v1/internet-gateways/{internet_gateway_id} - api가 추가되었습니다.
• [신규] DELETE /v1/internet-gateways/{internet_gateway_id} - api가 추가되었습니다.
• [신규] GET /v1/nat-gateways - api가 추가되었습니다.
• [신규] POST /v1/nat-gateways - api가 추가되었습니다.
• [신규] GET /v1/nat-gateways/{nat_gateway_id} - api가 추가되었습니다.
• [신규] PUT /v1/nat-gateways/{nat_gateway_id} - api가 추가되었습니다.
• [신규] DELETE /v1/nat-gateways/{nat_gateway_id} - api가 추가되었습니다.
• [신규] GET /v1/ports - api가 추가되었습니다.
• [신규] POST /v1/ports - api가 추가되었습니다.
• [신규] GET /v1/ports/{port_id} - api가 추가되었습니다.
• [신규] PUT /v1/ports/{port_id} - api가 추가되었습니다.
• [신규] DELETE /v1/ports/{port_id} - api가 추가되었습니다.
• [신규] GET /v1/private-nats - api가 추가되었습니다.
• [신규] POST /v1/private-nats - api가 추가되었습니다.
• [신규] GET /v1/private-nats/{private_nat_id} - api가 추가되었습니다.
• [신규] PUT /v1/private-nats/{private_nat_id} - api가 추가되었습니다.
• [신규] DELETE /v1/private-nats/{private_nat_id} - api가 추가되었습니다.
• [신규] GET /v1/private-nats/{private_nat_id}/private-nat-ips - api가 추가되었습니다.
• [신규] POST /v1/private-nats/{private_nat_id}/private-nat-ips - api가 추가되었습니다.
• [신규] DELETE /v1/private-nats/{private_nat_id}/private-nat-ips/{private_nat_ip_id} - api가 추가되었습니다.
• [신규] GET /v1/publicips - api가 추가되었습니다.
• [신규] POST /v1/publicips - api가 추가되었습니다.
• [신규] GET /v1/publicips/{publicip_id} - api가 추가되었습니다.
• [신규] PUT /v1/publicips/{publicip_id} - api가 추가되었습니다.
• [신규] DELETE /v1/publicips/{publicip_id} - api가 추가되었습니다.
• [신규] GET /v1/subnets - api가 추가되었습니다.
• [신규] POST /v1/subnets - api가 추가되었습니다.
• [신규] GET /v1/subnets/{subnet_id} - api가 추가되었습니다.
• [신규] PUT /v1/subnets/{subnet_id} - api가 추가되었습니다.
• [신규] DELETE /v1/subnets/{subnet_id} - api가 추가되었습니다.
• [신규] GET /v1/transit-gateways - api가 추가되었습니다.
• [신규] POST /v1/transit-gateways - api가 추가되었습니다.
• [신규] GET /v1/transit-gateways/{transit_gateway_id} - api가 추가되었습니다.
• [신규] PUT /v1/transit-gateways/{transit_gateway_id} - api가 추가되었습니다.
• [신규] DELETE /v1/transit-gateways/{transit_gateway_id} - api가 추가되었습니다.
• [신규] GET /v1/transit-gateways/{transit_gateway_id}/routing-rules - api가 추가되었습니다.
• [신규] POST /v1/transit-gateways/{transit_gateway_id}/routing-rules - api가 추가되었습니다.
• [신규] DELETE /v1/transit-gateways/{transit_gateway_id}/routing-rules/{routing_rule_id} - api가 추가되었습니다.
• [신규] POST /v1/transit-gateways/{transit_gateway_id}/uplink-routing-rules - api가 추가되었습니다.
• [신규] DELETE /v1/transit-gateways/{transit_gateway_id}/uplink-routing-rules/{routing_rule_id} - api가 추가되었습니다.
• [신규] GET /v1/transit-gateways/{transit_gateway_id}/vpc-connections - api가 추가되었습니다.
• [신규] POST /v1/transit-gateways/{transit_gateway_id}/vpc-connections - api가 추가되었습니다.
• [신규] DELETE /v1/transit-gateways/{transit_gateway_id}/vpc-connections/{vpc_connection_id} - api가 추가되었습니다.
• [신규] GET /v1/vpc-endpoints - api가 추가되었습니다.
• [신규] POST /v1/vpc-endpoints - api가 추가되었습니다.
• [신규] GET /v1/vpc-endpoints/connectable-resources - api가 추가되었습니다.
• [신규] GET /v1/vpc-endpoints/{vpc_endpoint_id} - api가 추가되었습니다.
• [신규] PUT /v1/vpc-endpoints/{vpc_endpoint_id} - api가 추가되었습니다.
• [신규] DELETE /v1/vpc-endpoints/{vpc_endpoint_id} - api가 추가되었습니다.
• [신규] GET /v1/vpc-peerings - api가 추가되었습니다.
• [신규] POST /v1/vpc-peerings - api가 추가되었습니다.
• [신규] GET /v1/vpc-peerings/{vpc_peering_id} - api가 추가되었습니다.
• [신규] PUT /v1/vpc-peerings/{vpc_peering_id} - api가 추가되었습니다.
• [신규] DELETE /v1/vpc-peerings/{vpc_peering_id} - api가 추가되었습니다.
• [신규] GET /v1/vpc-peerings/{vpc_peering_id}/routing-rules - api가 추가되었습니다.
• [신규] POST /v1/vpc-peerings/{vpc_peering_id}/routing-rules - api가 추가되었습니다.
• [신규] DELETE /v1/vpc-peerings/{vpc_peering_id}/routing-rules/{routing_rule_id} - api가 추가되었습니다.
• [신규] GET /v1/vpcs - api가 추가되었습니다.
• [신규] POST /v1/vpcs - api가 추가되었습니다.
• [신규] GET /v1/vpcs/{vpc_id} - api가 추가되었습니다.
• [신규] PUT /v1/vpcs/{vpc_id} - api가 추가되었습니다.
• [신규] DELETE /v1/vpcs/{vpc_id} - api가 추가되었습니다.