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.

OpenAPI URL

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

Environment and Region List

API Version History

1.4

Virtual Server API has been updated to support Multi-AZ resources.

Changes

• [Updated] POST /v1/servers - The following field has been added to the request.
  • zone
• [Updated] GET /v1/servers - The following query parameter and response fields have been added/changed.
  • Query parameter added: zone
  • Response field added: zone
  • Response field changed: addresses
• [Updated] GET /v1/servers/{server_id} - The following response fields have been added/changed.
  • Added: zone
  • Changed: addresses
• [Updated] PUT /v1/servers/{server_id} - The following response fields have been added/changed.
  • Added: zone
  • Changed: addresses
• [Updated] POST /v1/volumes - The following field has been added to the request and response.
  • zone
• [Updated] GET /v1/volumes - The following query parameter and response field have been added.
  • Query parameter added: zone
  • Response field added: zone
• [Updated] GET /v1/volumes/{volume_id} - The following field has been added to the response.
  • zone
• [Updated] PUT /v1/volumes/{volume_id} - The following field has been added to the response.
  • zone
• [Updated] PUT /v1/volumes/{volume_id}/size - The following field has been added to the response.
  • zone
• [Updated] GET /v1/snapshots - The following query parameter has been added.
  • zone
• [Updated] POST /v1/auto-scaling-groups - The following fields have been added to the request and response.
  • zones
  • placement_strategy
• [Updated] GET /v1/auto-scaling-groups - The following fields have been added to the response.
  • zones
  • placement_strategy
• [Updated] GET /v1/auto-scaling-groups/{auto_scaling_group_id} - The following fields have been added to the response.
  • zones
  • placement_strategy
• [Updated] GET /v1/auto-scaling-groups/{auto_scaling_group_id}/virtual-servers - The following response fields have been added/changed.
  • Added: zone
  • Changed: addresses
• [Updated] GET /v1/server-types - The following field has been added to the response.
  • zones
• [Updated] GET /v1/server-types/{server_type_id} - The following field has been added to the response.
  • zones
• [Updated] GET /v1/images - The following field has been added to the response.
  • zone
• [Updated] GET /v1/images/{image_id} - The following fields have been added to the response.
  • scp_supported_class_types
  • zone
• [Updated] POST /v1/images - The following fields have been added to the response.
  • scp_supported_class_types
  • zone
• [Updated] PUT /v1/images/{image_id} - The following fields have been added to the response.
  • scp_supported_class_types
  • zone
• [Updated] POST /v1/launch-configurations - The following field has been added to the response.
  • zones
• [Updated] GET /v1/launch-configurations/{launch_configuration_id} - The following field has been added to the response.
  • zones
• [Updated] PUT /v1/servers/{server_id}/interfaces/{port_id} - The following request field has been changed to required.
  • fixed_ip_address
• [Removed] GET /v1/servers/{server_id}/ips - API has been removed.
• [Removed] GET /v1/servers/{server_id}/ips/{subnet_id} - API has been removed.

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.