File Storage

File Storage

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 File Storage in JSON format. 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.2CURRENT-
1.1SUPPORTED20261130

OpenAPI URL

https://filestorage.{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.2

File Storage has been updated to version 1.2.

Changes

  • [New] GET /replications/zones - List Volume Replication Zones API has been added.
  • [Updated] POST /volumes - Upon request, the following fields have been added and changed.
    • NEW zone - Required field added. Zone of the volume.
    • UPDATED type_name
      • 1.1 version
        • ^(HDD|SSD|HighPerformanceSSD|SSD_SAP_E|SSD_SAP_S)$
      • 1.2 version
        • Pattern removed (no longer restricted to predefined values).
  • [Updated] POST /volumes - Upon response, the following fields have been added.
    • NEW zone - Required field. Zone of the created volume.
  • [Updated] GET /volumes - Upon response, the following fields have been changed in the volume objects.
    • NEW zone - Required field. Zone of the volume.
    • NEW az_type - Required field. Availability zone type.
    • REMOVED type_id - Type ID field has been removed.
  • [Updated] GET /volumes/{volume_id} - Upon response, the following fields have been added and removed.
    • NEW zone - Required field. Zone of the volume.
    • NEW az_type - Required field. Availability zone type.
    • REMOVED type_id - Type ID field has been removed.
  • [Updated] POST /replications - Upon request, the following fields have been added and removed.
    • NEW zone - Required field added. Zone for the replication target. Replaces the previous region field.
    • REMOVED region - Region field has been removed. Use zone instead.
  • [Updated] POST /replications - Upon response, the following fields have been added.
    • NEW replication_volume_zone - Required field. Zone of the replication volume.
    • NEW source_volume_zone - Required field. Zone of the source volume.
  • [Updated] GET /replications - Upon response, the following fields have been changed in the replication objects.
    • NEW replication_volume_zone - Required field. Zone of the replication volume.
    • NEW source_volume_zone - Required field. Zone of the source volume.
  • [Updated] GET /replications/{replication_id} - Upon response, the following fields have been added.
    • NEW replication_volume_zone - Required field. Zone of the replication volume.
    • NEW source_volume_zone - Required field. Zone of the source volume.
  • [Removed] GET /replications/regions - List Volume Replication Regions API will be removed. Change to using GET /replications/zones.

1.1

File Storage has been updated to version 1.1.

Changes

  • [Updated] POST /volumes - Upon request, the following fields have been changed.
    • UPDATED type_name
      • 1.0 version
        • ^(HDD|SSD|HighPerformanceSSD)$
      • 1.1 version
        • ^(HDD|SSD|HighPerformanceSSD|SSD_SAP_E|SSD_SAP_S)$
  • [Updated] GET /volumes - Upon request, the following fields have been changed.
    • UPDATED type_name
      • Filter now accepts additional type values SSD_SAP_E, SSD_SAP_S in addition to the previous HDD, SSD, HighPerformanceSSD.

1.0

File Storage has been released.

Changes

  • [New] GET /replications - List Volume Replications API has been added.
  • [New] POST /replications - Create Volume Replication API has been added.
  • [New] GET /replications/regions - List Volume Replication Regions API has been added.
  • [New] GET /replications/{replication_id} - Show Volume Replication API has been added.
  • [New] PUT /replications/{replication_id} - Set Volume Replication API has been added.
  • [New] DELETE /replications/{replication_id} - Delete Volume Replication API has been added.
  • [New] GET /snapshot-schedules - List Snapshot Schedules API has been added.
  • [New] POST /snapshot-schedules - Create Snapshot Schedule API has been added.
  • [New] PUT /snapshot-schedules/{snapshot_schedule_id} - Set Snapshot Schedule API has been added.
  • [New] DELETE /snapshot-schedules/{snapshot_schedule_id} - Delete Snapshot Schedule API has been added.
  • [New] GET /snapshots - List Snapshots API has been added.
  • [New] POST /snapshots - Create Snapshot API has been added.
  • [New] DELETE /snapshots/{snapshot_id} - Delete Snapshot API has been added.
  • [New] PUT /snapshots/{snapshot_id}/restore - Restore Snapshot API has been added.
  • [New] GET /volumes - List Volumes API has been added.
  • [New] POST /volumes - Create Volume API has been added.
  • [New] GET /volumes/{volume_id} - Show Volume API has been added.
  • [New] PUT /volumes/{volume_id} - Set Volume API has been added.
  • [New] DELETE /volumes/{volume_id} - Delete Volume API has been added.
  • [New] GET /volumes/{volume_id}/access-rules - List Access Rules API has been added.
  • [New] PUT /volumes/{volume_id}/access-rules - Set Access Rule API has been added.