Virtual Server

Overview

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

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

Version

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

OpenAPI URL

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

Environment and Region List

API Version History

1.4

Virtual Server API에 Multi-AZ 리소스 지원이 추가되었습니다.

변경사항

• [변경] POST /v1/servers - 요청 시, 아래와 같은 필드가 추가됩니다.
  • zone
• [변경] GET /v1/servers - 요청 및 응답 시, 아래와 같은 항목이 추가/변경됩니다.
  • 요청 파라미터 추가: zone
  • 응답 필드 추가: zone
  • 응답 필드 변경: addresses
• [변경] GET /v1/servers/{server_id} - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가: zone
  • 변경: addresses
• [변경] PUT /v1/servers/{server_id} - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가: zone
  • 변경: addresses
• [변경] POST /v1/volumes - 요청 및 응답 시, 아래와 같은 필드가 추가됩니다.
  • zone
• [변경] GET /v1/volumes - 요청 및 응답 시, 아래와 같은 항목이 추가됩니다.
  • 요청 파라미터 추가: zone
  • 응답 필드 추가: zone
• [변경] GET /v1/volumes/{volume_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zone
• [변경] PUT /v1/volumes/{volume_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zone
• [변경] PUT /v1/volumes/{volume_id}/size - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zone
• [변경] GET /v1/snapshots - 요청 시, 아래와 같은 파라미터가 추가됩니다.
  • zone
• [변경] POST /v1/auto-scaling-groups - 요청 및 응답 시, 아래와 같은 필드가 추가됩니다.
  • zones
  • placement_strategy
• [변경] GET /v1/auto-scaling-groups - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zones
  • placement_strategy
• [변경] GET /v1/auto-scaling-groups/{auto_scaling_group_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zones
  • placement_strategy
• [변경] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가: zone
  • 변경: addresses
• [변경] GET /v1/server-types - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zones
• [변경] GET /v1/server-types/{server_type_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zones
• [변경] GET /v1/images - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zone
• [변경] GET /v1/images/{image_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • scp_supported_class_types
  • zone
• [변경] POST /v1/images - 응답 시, 아래와 같은 필드가 추가됩니다.
  • scp_supported_class_types
  • zone
• [변경] PUT /v1/images/{image_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • scp_supported_class_types
  • zone
• [변경] POST /v1/launch-configurations - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zones
• [변경] GET /v1/launch-configurations/{launch_configuration_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
  • zones
• [변경] PUT /v1/servers/{server_id}/interfaces/{port_id} - 아래와 같은 요청 필드가 필수로 변경됩니다.
  • fixed_ip_address
• [삭제] GET /v1/servers/{server_id}/ips - API가 삭제되었습니다.
• [삭제] GET /v1/servers/{server_id}/ips/{subnet_id} - API가 삭제되었습니다.

1.3

Virtual Server의 GPU 이미지에서 지원하는 서버 타입 군을 조회할 수 있도록 파라미터 추가 되었습니다.

변경사항

• [변경] GET /v1/images - 응답 시, 아래와 같은 필드가 추가/변경됩니다.
  • 추가: scp_supported_class_types

1.2

Virtual Server API가 출시되었습니다.

변경사항

• [신규] POST /v1/volume-transfer/{transfer_id}/accept - api가 추가되었습니다.
• [신규] POST /v1/volumes/{volume_id}/servers - api가 추가되었습니다.
• [신규] POST /v1/snapshots - api가 추가되었습니다.
• [신규] POST /v1/volume-transfer - api가 추가되었습니다.
• [신규] POST /v1/auto-scaling-groups - api가 추가되었습니다.
• [신규] POST /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications - api가 추가되었습니다.
• [신규] POST /v1/auto-scaling-groups/{auto_scaling_group_id}/policies - api가 추가되었습니다.
• [신규] POST /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules - api가 추가되었습니다.
• [신규] POST /v1/images - api가 추가되었습니다.
• [신규] POST /v1/images/{image_id}/members - api가 추가되었습니다.
• [신규] POST /v1/keypairs - api가 추가되었습니다.
• [신규] POST /v1/launch-configurations - api가 추가되었습니다.
• [신규] POST /v1/server-groups - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/interfaces - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/interfaces/{port_id}/static-nats - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/interfaces/{port_id}/private-static-nats - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/volumes - api가 추가되었습니다.
• [신규] POST /v1/images/{image_id}/share - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/images - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/dump - api가 추가되었습니다.
• [신규] POST /v1/volumes - api가 추가되었습니다.
• [신규] DELETE /v1/snapshots/{snapshot_id} - api가 추가되었습니다.
• [신규] DELETE /v1/volume-transfer/{transfer_id} - api가 추가되었습니다.
• [신규] DELETE /v1/auto-scaling-groups/{auto_scaling_group_id} - api가 추가되었습니다.
• [신규] DELETE /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id} - api가 추가되었습니다.
• [신규] DELETE /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id} - api가 추가되었습니다.
• [신규] DELETE /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id} - api가 추가되었습니다.
• [신규] DELETE /v1/images/{image_id} - api가 추가되었습니다.
• [신규] DELETE /v1/images/{image_id}/members/{member_id} - api가 추가되었습니다.
• [신규] DELETE /v1/keypairs/{keypair_name} - api가 추가되었습니다.
• [신규] DELETE /v1/launch-configurations/{launch_configuration_id} - api가 추가되었습니다.
• [신규] DELETE /v1/server-groups/{server_group_id} - api가 추가되었습니다.
• [신규] DELETE /v1/servers/{server_id}/interfaces/{port_id} - api가 추가되었습니다.
• [신규] DELETE /v1/servers/{server_id}/interfaces/{port_id}/static-nats/{nat_id} - api가 추가되었습니다.
• [신규] DELETE /v1/servers/{server_id}/interfaces/{port_id}/private-static-nats/{nat_id} - api가 추가되었습니다.
• [신규] DELETE /v1/servers/{server_id}/volumes/{volume_id} - api가 추가되었습니다.
• [신규] DELETE /v1/servers/{server_id} - api가 추가되었습니다.
• [신규] DELETE /v1/volumes/{volume_id} - api가 추가되었습니다.
• [신규] DELETE /v1/servers/{server_id}/security-groups/{security_group_id} - api가 추가되었습니다.
• [신규] DELETE /v1/volumes/{volume_id}/servers/{server_id} - api가 추가되었습니다.
• [신규] PUT /v1/volumes/{volume_id}/size - api가 추가되었습니다.
• [신규] GET /v1/server-groups/partition-sizes - api가 추가되었습니다.
• [신규] POST /v1/images/{image_id}/import - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/policies - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups - api가 추가되었습니다.
• [신규] GET /v1/default-configs - api가 추가되었습니다.
• [신규] GET /v1/images/{image_id}/members - api가 추가되었습니다.
• [신규] GET /v1/images - api가 추가되었습니다.
• [신규] GET /v1/keypairs - api가 추가되었습니다.
• [신규] GET /v1/launch-configurations - api가 추가되었습니다.
• [신규] GET /v1/pending-images - api가 추가되었습니다.
• [신규] GET /v1/server-groups - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id}/interfaces - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id}/ips - api가 추가되었습니다.
• [신규] GET /v1/server-types - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id}/volumes - api가 추가되었습니다.
• [신규] GET /v1/snapshots - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id}/security-groups - api가 추가되었습니다.
• [신규] GET /v1/servers - api가 추가되었습니다.
• [신규] GET /v1/volume-transfer - api가 추가되었습니다.
• [신규] GET /v1/volume-types - api가 추가되었습니다.
• [신규] GET /v1/volumes - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/lock - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/reboot - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/rebuild - api가 추가되었습니다.
• [신규] POST /v1/volumes/{volume_id}/revert - api가 추가되었습니다.
• [신규] PUT /v1/volumes/{volume_id}/qos - api가 추가되었습니다.
• [신규] GET /v1/snapshots/{snapshot_id} - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id} - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id} - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id} - api가 추가되었습니다.
• [신규] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id} - api가 추가되었습니다.
• [신규] GET /v1/volume-types/default - api가 추가되었습니다.
• [신규] GET /v1/images/{image_id} - api가 추가되었습니다.
• [신규] GET /v1/images/{image_id}/members/{member_id} - api가 추가되었습니다.
• [신규] GET /v1/keypairs/{keypair_name} - api가 추가되었습니다.
• [신규] GET /v1/launch-configurations/{launch_configuration_id} - api가 추가되었습니다.
• [신규] GET /v1/server-groups/{server_group_id} - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id}/interfaces/{port_id} - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id}/ips/{subnet_id} - api가 추가되었습니다.
• [신규] GET /v1/quota-sets - api가 추가되었습니다.
• [신규] GET /v1/server-types/{server_type_id} - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id}/volumes/{volume_id} - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id} - api가 추가되었습니다.
• [신규] GET /v1/servers/{server_id}/console-log - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/password - api가 추가되었습니다.
• [신규] GET /v1/volumes/quota-sets - api가 추가되었습니다.
• [신규] GET /v1/volume-transfer/{transfer_id} - api가 추가되었습니다.
• [신규] GET /v1/volume-types/{volume_type_id} - api가 추가되었습니다.
• [신규] GET /v1/volumes/{volume_id} - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/start - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/stop - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/unlock - api가 추가되었습니다.
• [신규] PUT /v1/snapshots/{snapshot_id} - api가 추가되었습니다.
• [신규] PUT /v1/auto-scaling-groups/{auto_scaling_group_id} - api가 추가되었습니다.
• [신규] PUT /v1/auto-scaling-groups/{auto_scaling_group_id}/lb-server-groups - api가 추가되었습니다.
• [신규] PUT /v1/auto-scaling-groups/{auto_scaling_group_id}/notifications/{notification_id} - api가 추가되었습니다.
• [신규] PUT /v1/auto-scaling-groups/{auto_scaling_group_id}/policies/{policy_id} - api가 추가되었습니다.
• [신규] PUT /v1/auto-scaling-groups/{auto_scaling_group_id}/schedules/{schedule_id} - api가 추가되었습니다.
• [신규] PUT /v1/auto-scaling-groups/{auto_scaling_group_id}/server-count - api가 추가되었습니다.
• [신규] PUT /v1/images/{image_id} - api가 추가되었습니다.
• [신규] PUT /v1/images/{image_id}/members/{member_id} - api가 추가되었습니다.
• [신규] PUT /v1/servers/{server_id}/interfaces/{port_id} - api가 추가되었습니다.
• [신규] PUT /v1/servers/{server_id}/volumes/{volume_id} - api가 추가되었습니다.
• [신규] PUT /v1/servers/{server_id} - api가 추가되었습니다.
• [신규] POST /v1/servers/{server_id}/server-type - api가 추가되었습니다.
• [신규] PUT /v1/volumes/{volume_id} - api가 추가되었습니다.