Virtual Server

Virtual Server

Overview

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

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

Version

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

VersionStatusNot Before
1.3CURRENT-
1.2SUPPORTED20260831
1.1DEPRECATED20260531
1.0DEPRECATED20251231

OpenAPI URL

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

Environment and Region List

environmentregion
skr-west1
skr-east1
gkr-south1
gkr-south2
gkr-south3
ekr-west1
ekr-east1

API Version History

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가 추가되었습니다.