Virtual Server

Virtual Server

Overview

Provides an Application Programming Interface (API) that supports programmatic use of IaaS/PaaS products provided by SCP.

This guide provides a brief description of Virtual Server service and how to call API. The API is provided as a RESTful API, and it responds in JSON format.

Version

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

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 API has been updated to allow querying the server type groups supported by GPU images.

Changes

  • [Updated] GET /v1/images - The following fields have been added/removed from the response.
    • Added: scp_supported_class_types

1.2

Virtual Server API has been released.

Changes

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