File Storage

File Storage

Overview

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

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

Version

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

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가 1.2 버전으로 업데이트되었습니다.

변경사항

  • [신규] GET /replications/zones - List Volume Replication Zones API가 추가 되었습니다.
  • [변경] POST /volumes - 요청 시, 아래와 같은 필드가 추가되고 변경 됩니다.
    • 추가 zone - 필수 필드로 추가. 볼륨의 존.
    • 변경 type_name
      • 1.1 버전
        • ^(HDD|SSD|HighPerformanceSSD|SSD_SAP_E|SSD_SAP_S)$
      • 1.2 버전
        • 패턴 제거 (사전 정의된 값으로 제한되지 않음).
  • [변경] POST /volumes - 응답 시, 아래와 같은 필드가 추가 됩니다.
    • 추가 zone - 필수 필드. 생성된 볼륨의 존.
  • [변경] GET /volumes - 응답 시, 볼륨 객체의 필드가 변경 됩니다.
    • 추가 zone - 필수 필드. 볼륨의 존.
    • 추가 az_type - 필수 필드. 존 유형.
    • 제거 type_id - 타입 ID 필드가 제거 되었습니다.
  • [변경] GET /volumes/{volume_id} - 응답 시, 필드가 추가되고 제거 됩니다.
    • 추가 zone - 필수 필드. 볼륨의 존.
    • 추가 az_type - 필수 필드. 존 유형.
    • 제거 type_id - 유형 ID 필드가 제거 되었습니다.
  • [변경] POST /replications - 요청 시, 필드가 추가되고 제거 됩니다.
    • 추가 zone - 필수 필드로 추가. 복제 대상 존. 기존 region 필드를 대체합니다.
    • 제거 region - 리전은 필드가 제거 되었습니다. 대신 zone을 사용하십시오.
  • [변경] POST /replications - 응답 시, 아래와 같은 필드가 추가 됩니다.
    • 추가 replication_volume_zone - 필수 필드. 복제 볼륨의 존.
    • 추가 source_volume_zone - 필수 필드. 소스 볼륨의 존.
  • [변경] GET /replications - 응답 시, 복제 객체의 필드가 변경 됩니다.
    • 추가 replication_volume_zone - 필수 필드. 복제 볼륨의 존.
    • 추가 source_volume_zone - 필수 필드. 소스 볼륨의 존.
  • [변경] GET /replications/{replication_id} - 응답 시, 아래와 같은 필드가 추가 됩니다.
    • 추가 replication_volume_zone - 필수 필드. 복제 볼륨의 존.
    • 추가 source_volume_zone - 필수 필드. 소스 볼륨의 존.
  • [제거] GET /replications/regions - List Volume Replication Regions API가 제거 됩니다. GET /replications/zones 로 변경하여 사용해주시길 바랍니다.

1.1

File Storage가 1.1 버전으로 업데이트되었습니다.

변경사항

  • [변경] POST /volumes - 요청 시, 아래와 같은 필드가 변경 됩니다.
    • 변경 type_name
      • 1.0 버전
        • ^(HDD|SSD|HighPerformanceSSD)$
      • 1.1 버전
        • ^(HDD|SSD|HighPerformanceSSD|SSD_SAP_E|SSD_SAP_S)$
  • [변경] GET /volumes - 요청 시, 아래와 같은 필드가 변경 됩니다.
    • 변경 type_name
      • 기존 HDD, SSD, HighPerformanceSSD 외에 SSD_SAP_E, SSD_SAP_S 필터값이 추가로 허용 됩니다.

1.0

File Storage가 출시되었습니다.

변경사항

  • [신규] GET /replications - List Volume Replications API가 추가되었습니다.
  • [신규] POST /replications - Create Volume Replication API가 추가되었습니다.
  • [신규] GET /replications/regions - List Volume Replication Regions API가 추가되었습니다.
  • [신규] GET /replications/{replication_id} - Show Volume Replication API가 추가되었습니다.
  • [신규] PUT /replications/{replication_id} - Set Volume Replication API가 추가되었습니다.
  • [신규] DELETE /replications/{replication_id} - Delete Volume Replication API가 추가되었습니다.
  • [신규] GET /snapshot-schedules - List Snapshot Schedules API가 추가되었습니다.
  • [신규] POST /snapshot-schedules - Create Snapshot Schedule API가 추가되었습니다.
  • [신규] PUT /snapshot-schedules/{snapshot_schedule_id} - Set Snapshot Schedule API가 추가되었습니다.
  • [신규] DELETE /snapshot-schedules/{snapshot_schedule_id} - Delete Snapshot Schedule API가 추가되었습니다.
  • [신규] GET /snapshots - List Snapshots API가 추가되었습니다.
  • [신규] POST /snapshots - Create Snapshot API가 추가되었습니다.
  • [신규] DELETE /snapshots/{snapshot_id} - Delete Snapshot API가 추가되었습니다.
  • [신규] PUT /snapshots/{snapshot_id}/restore - Restore Snapshot API가 추가되었습니다.
  • [신규] GET /volumes - List Volumes API가 추가되었습니다.
  • [신규] POST /volumes - Create Volume API가 추가되었습니다.
  • [신규] GET /volumes/{volume_id} - Show Volume API가 추가되었습니다.
  • [신규] PUT /volumes/{volume_id} - Set Volume API가 추가되었습니다.
  • [신규] DELETE /volumes/{volume_id} - Delete Volume API가 추가되었습니다.
  • [신규] GET /volumes/{volume_id}/access-rules - List Access Rules API가 추가되었습니다.
  • [신규] PUT /volumes/{volume_id}/access-rules - Set Access Rule API가 추가되었습니다.