This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

File Storage

1: APIs

1.1: CreateSnapshot

1.1.1: 1.2
1.1.2: 1.1

1.2: CreateSnapshotSchedule

1.2.1: 1.2
1.2.2: 1.1

1.3: CreateVolume

1.3.1: 1.2
1.3.2: 1.1

1.4: CreateVolumeReplication

1.4.1: 1.2
1.4.2: 1.1

1.5: DeleteSnapshot

1.5.1: 1.2
1.5.2: 1.1

1.6: DeleteSnapshotSchedule

1.6.1: 1.2
1.6.2: 1.1

1.7: DeleteVolume

1.7.1: 1.2
1.7.2: 1.1

1.8: DeleteVolumeReplication

1.8.1: 1.2
1.8.2: 1.1

1.9: ListAccessRules

1.9.1: 1.2
1.9.2: 1.1

1.10: ListSnapshots

1.10.1: 1.2
1.10.2: 1.1

1.11: ListSnapshotSchedule

1.11.1: 1.2
1.11.2: 1.1

1.12: ListVolumeReplicationRegion

1.12.1: 1.1

1.13: ListVolumeReplications

1.13.1: 1.2
1.13.2: 1.1

1.14: ListVolumeReplicationZones

1.14.1: 1.2

1.15: ListVolumes

1.15.1: 1.2
1.15.2: 1.1

1.16: RestoreSnapshot

1.16.1: 1.2
1.16.2: 1.1

1.17: SetAccessRule

1.17.1: 1.2
1.17.2: 1.1

1.18: SetSnapshotSchedule

1.18.1: 1.2
1.18.2: 1.1

1.19: SetVolume

1.19.1: 1.2
1.19.2: 1.1

1.20: SetVolumeReplication

1.20.1: 1.2
1.20.2: 1.1

1.21: ShowVolume

1.21.1: 1.2
1.21.2: 1.1

1.22: ShowVolumeReplication

1.22.1: 1.2
1.22.2: 1.1

2: Models

2.1: AccessRuleRequest
2.2: AccessRuleResponse
2.3: Replication
2.4: ReplicationCreateRequest
2.5: ReplicationCreateRequestV1Dot2
2.6: ReplicationCreateResponse
2.7: ReplicationCreateResponseV1Dot2
2.8: ReplicationListResponse
2.9: ReplicationListResponseV1Dot2
2.10: ReplicationRegionListResponse
2.11: ReplicationShowResponse
2.12: ReplicationShowResponseV1Dot2
2.13: ReplicationUpdateRequest
2.14: ReplicationUpdateResponse
2.15: ReplicationV1Dot2
2.16: ReplicationZonesListResponse
2.17: Snapshot
2.18: SnapshotCreateRequest
2.19: SnapshotDetail
2.20: SnapshotListResponse
2.21: SnapshotRestoreResponse
2.22: SnapshotSchedule
2.23: SnapshotScheduleCreateRequest
2.24: SnapshotScheduleCreateResponse
2.25: SnapshotScheduleListResponse
2.26: SnapshotScheduleSetRequest
2.27: SnapshotScheduleSetResponse
2.28: SnapshotScheduleShow
2.29: SnapshotShowResponse
2.30: Tag
2.31: Volume
2.32: VolumeCreateRequest
2.33: VolumeCreateRequestV1Dot2
2.34: VolumeCreateResponse
2.35: VolumeCreateResponseV1Dot2
2.36: VolumeListResponse
2.37: VolumeListResponseV1Dot2
2.38: VolumeObjectAccessRuleListBase
2.39: VolumeObjectAccessRuleListResponse
2.40: VolumeSetRequest
2.41: VolumeSetResponse
2.42: VolumeShowResponse
2.43: VolumeShowResponseV1Dot2
2.44: VolumeV1Dot2

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.

Version	Status	Not Before
1.2	CURRENT	-
1.1	SUPPORTED	20261130

OpenAPI URL

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

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-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.

1 - APIs

1.1 - CreateSnapshot

1.1.1 - 1.2

post /v1/snapshots

Description

Create snapshot

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		SnapshotCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshots

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Request body

{
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
}

Example HTTP response

Response 202

{
    "snapshot": {
        "id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
        "name": "my_volume.2024-10-01_14215",
        "state": "available",
        "size": "",
        "created_at": "2024-07-30T04:54:33.219373",
        "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
    }
}

1.1.2 - 1.1

post /v1/snapshots

Description

Create snapshot

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
body	body required		SnapshotCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshots

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Request body

{
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
}

Example HTTP response

Response 202

{
    "snapshot": {
        "id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
        "name": "my_volume.2024-10-01_14215",
        "state": "available",
        "size": "",
        "created_at": "2024-07-30T04:54:33.219373",
        "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
    }
}

1.2 - CreateSnapshotSchedule

1.2.1 - 1.2

post /v1/snapshot-schedules

Description

Create snapshot schedule

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		SnapshotScheduleCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotScheduleCreateResponse
400	Bad Request	None
403	Forbidden	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshot-schedules

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Request body

{
    "snapshot_retention_count": 10,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "snapshot_schedule": {
        "frequency": "WEEKLY",
        "day_of_week": "MON",
        "hour": "23"
    }
}

Example HTTP response

Response 202

{
    "snapshot_retention_count": 10,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "snapshot_schedule": {
        "frequency": "WEEKLY",
        "day_of_week": "MON",
        "hour": "23"
    }
}

1.2.2 - 1.1

post /v1/snapshot-schedules

Description

Create snapshot schedule

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
body	body required		SnapshotScheduleCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotScheduleCreateResponse
400	Bad Request	None
403	Forbidden	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshot-schedules

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Request body

{
    "snapshot_retention_count": 10,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "snapshot_schedule": {
        "frequency": "WEEKLY",
        "day_of_week": "MON",
        "hour": "23"
    }
}

Example HTTP response

Response 202

{
    "snapshot_retention_count": 10,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "snapshot_schedule": {
        "frequency": "WEEKLY",
        "day_of_week": "MON",
        "hour": "23"
    }
}

1.3 - CreateVolume

1.3.1 - 1.2

post /v1/volumes

Description

Create volume

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		VolumeCreateRequestV1Dot2

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeCreateResponseV1Dot2
403	Forbidden	None
401	Unauthorized	None
400	Bad Request	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Request body

{
    "name": "my_volume",
    "protocol": "NFS",
    "type_name": "HDD",
    "snapshot_id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
    "cifs_password": "cifspwd0!!",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ],
    "zone": "kr-west1-a"
}

Example HTTP response

Response 202

{
    "protocol": "NFS",
    "snapshot_id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
    "type_name": "HDD",
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "volume_name": "my_volume",
    "zone": "kr-west1-a"
}

1.3.2 - 1.1

post /v1/volumes

Description

Create volume

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
body	body required		VolumeCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeCreateResponse
403	Forbidden	None
401	Unauthorized	None
400	Bad Request	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Request body

{
    "name": "my_volume",
    "protocol": "NFS",
    "type_name": "HDD",
    "snapshot_id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
    "cifs_password": "cifspwd0!!",
    "tags": [
        {
            "key": "key",
            "value": "value"
        }
    ]
}

Example HTTP response

Response 202

{
    "protocol": "NFS",
    "snapshot_id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
    "type_name": "HDD",
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "volume_name": "my_volume"
}

1.4 - CreateVolumeReplication

1.4.1 - 1.2

post /v1/replications

Description

Create Volume Replication

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ReplicationCreateRequestV1Dot2

Responses

HTTP Code	Description	Schema
202	Accepted	ReplicationCreateResponseV1Dot2
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/replications

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Request body

{
    "name": "my_volume",
    "cifs_password": "cifspwd0!!",
    "replication_frequency": "5min",
    "zone": "kr-west1-a",
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "backup_retention_count": 2,
    "replication_type": "replication"
}

Example HTTP response

Response 202

{
    "replication_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_status": "creating",
    "source_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "source_volume_region": "kr-west1",
    "source_volume_zone": "kr-west1-a",
    "protocol": "NFS",
    "replication_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_volume_region": "kr-west1",
    "replication_volume_zone": "kr-west1-a"
}

1.4.2 - 1.1

post /v1/replications

Description

Create Volume Replication

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
body	body required		ReplicationCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ReplicationCreateResponse
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/replications

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Request body

{
    "name": "my_volume",
    "cifs_password": "cifspwd0!!",
    "replication_frequency": "5min",
    "region": "kr-west1",
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "backup_retention_count": 2,
    "replication_type": "replication"
}

Example HTTP response

Response 202

{
    "replication_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_status": "creating",
    "source_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "source_volume_region": "kr-west1",
    "protocol": "NFS",
    "replication_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_volume_region": "kr-west1"
}

1.5 - DeleteSnapshot

1.5.1 - 1.2

delete /v1/snapshots/{snapshot_id}

Description

Delete snapshots

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 202

1.5.2 - 1.1

delete /v1/snapshots/{snapshot_id}

Description

Delete snapshots

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 202

1.6 - DeleteSnapshotSchedule

1.6.1 - 1.2

delete /v1/snapshot-schedules/{snapshot_schedule_id}

Description

Delete snapshot schedule

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	snapshot_schedule_id required	Snapshot Schedule ID Example : `d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshot-schedules/{snapshot_schedule_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 202

1.6.2 - 1.1

delete /v1/snapshot-schedules/{snapshot_schedule_id}

Description

Delete snapshot schedule

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	snapshot_schedule_id required	Snapshot Schedule ID Example : `d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
400	Bad Request	None
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshot-schedules/{snapshot_schedule_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 202

1.7 - DeleteVolume

1.7.1 - 1.2

delete /v1/volumes/{volume_id}

Description

Delete volume

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 202

1.7.2 - 1.1

delete /v1/volumes/{volume_id}

Description

Delete volume

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 202

1.8 - DeleteVolumeReplication

1.8.1 - 1.2

delete /v1/replications/{replication_id}

Description

Delete Volume Replication

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/replications/{replication_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 202

1.8.2 - 1.1

delete /v1/replications/{replication_id}

Description

Delete Volume Replication

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	None
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/replications/{replication_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 202

1.9 - ListAccessRules

1.9.1 - 1.2

get /v1/volumes/{volume_id}/access-rules

Description

List access rules

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeObjectAccessRuleListResponse
403	Forbidden	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/access-rules

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 200

{
    "count": 1,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "access_rules": [
        {
            "access_rule_state": "active",
            "object_type": "VM",
            "object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f"
        }
    ]
}

1.9.2 - 1.1

get /v1/volumes/{volume_id}/access-rules

Description

List access rules

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeObjectAccessRuleListResponse
403	Forbidden	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/access-rules

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 200

{
    "count": 1,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "access_rules": [
        {
            "access_rule_state": "active",
            "object_type": "VM",
            "object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f"
        }
    ]
}

1.10 - ListSnapshots

1.10.1 - 1.2

get /v1/snapshots

Description

List snapshots

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/snapshots?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 200

{
    "count": 1,
    "snapshots": [
        {
            "id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
            "name": "my_volume.2024-10-01_14215",
            "state": "available",
            "size": "",
            "created_at": "2024-07-30T04:54:33.219373"
        }
    ],
    "snapshot_size_total_byte": ""
}

1.10.2 - 1.1

get /v1/snapshots

Description

List snapshots

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/snapshots?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 200

{
    "count": 1,
    "snapshots": [
        {
            "id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
            "name": "my_volume.2024-10-01_14215",
            "state": "available",
            "size": "",
            "created_at": "2024-07-30T04:54:33.219373"
        }
    ],
    "snapshot_size_total_byte": ""
}

1.11 - ListSnapshotSchedule

1.11.1 - 1.2

get /v1/snapshot-schedules

Description

List snapshot schedule

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotScheduleListResponse
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshot-schedules?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 200

{
    "snapshot_retention_count": 10,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "snapshot_policy_enabled": "true",
    "snapshot_schedule": [
        {
            "frequency": "WEEKLY",
            "day_of_week": "MON",
            "hour": "23",
            "id": "d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31"
        }
    ]
}

1.11.2 - 1.1

get /v1/snapshot-schedules

Description

List snapshot schedule

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	SnapshotScheduleListResponse
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/snapshot-schedules?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 200

{
    "snapshot_retention_count": 10,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "snapshot_policy_enabled": "true",
    "snapshot_schedule": [
        {
            "frequency": "WEEKLY",
            "day_of_week": "MON",
            "hour": "23",
            "id": "d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31"
        }
    ]
}

1.12 - ListVolumeReplicationRegion

1.12.1 - 1.1

get /v1/replications/regions

Description

List Volume Replication Region

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
query	type_name required	Volume Type Name Example : `HDD`	string	None
query	source_region_name required	Region Example : `kr-west1`	string	None
query	replication_type required	Replication Type Example : `replication`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ReplicationRegionListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/replications/regions?type_name={type_name}&source_region_name={source_region_name}&replication_type={replication_type}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 200

{
    "regions": "['kr-west1']"
}

1.13 - ListVolumeReplications

1.13.1 - 1.2

get /v1/replications

Description

List Volume Replications

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ReplicationListResponseV1Dot2
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/replications?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 200

{
    "count": 1,
    "replications": [
        {
            "replication_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
            "replication_frequency": "5min",
            "source_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
            "source_volume_region": "kr-west1",
            "source_volume_zone": "kr-west1-a",
            "source_volume_access_level": "ro",
            "replication_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
            "replication_volume_region": "kr-west1",
            "replication_volume_zone": "kr-west1-a",
            "replication_volume_access_level": "ro",
            "replication_type": "replication"
        }
    ]
}

1.13.2 - 1.1

get /v1/replications

Description

List Volume Replications

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ReplicationListResponse
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/replications?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 200

{
    "count": 1,
    "replications": [
        {
            "replication_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
            "replication_frequency": "5min",
            "source_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
            "source_volume_region": "kr-west1",
            "source_volume_access_level": "ro",
            "replication_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
            "replication_volume_region": "kr-west1",
            "replication_volume_access_level": "ro",
            "replication_type": "replication"
        }
    ]
}

1.14 - ListVolumeReplicationZones

1.14.1 - 1.2

get /v1/replications/zones

Description

List Volume Replication Zones

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	type_name required	Volume Type Name Example : `HDD`	string	None
query	source_zone required	Zone Example : `kr-west1-a`	string	None
query	replication_type required	Replication Type Example : `replication`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ReplicationZonesListResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/replications/zones?type_name={type_name}&source_zone={source_zone}&replication_type={replication_type}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 200

{
    "zones": "['kr-west1']"
}

1.15 - ListVolumes

1.15.1 - 1.2

get /v1/volumes

Description

List volumes

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	offset optional	offset Example : `0`	integer	0
query	limit optional	limit Example : `20`	integer	20
query	name optional	Volume Name Example : `my_volume`	any of [string, null]	None
query	type_name optional	Volume Type Name Example : `HDD`	any of [string, null]	None
query	sort optional	sort Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeListResponseV1Dot2
400	Bad Request	None
403	Forbidden	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 200

{
    "count": 1,
    "filestorages": [
        {
            "id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
            "name": "my_volume",
            "protocol": "NFS",
            "state": "available",
            "account_id": "rwww523320dfvwbbefefsdvwdadsfa24c",
            "created_at": "2024-07-30T04:54:33.219373",
            "type_id": "jef22f67-ee83-4gg2-2ab6-3lf774ekfjdu",
            "type_name": "HDD",
            "purpose": "replication",
            "zone": "kr-west1-a",
            "az_type": "single"
        }
    ]
}

1.15.2 - 1.1

get /v1/volumes

Description

List volumes

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
query	offset optional	offset Example : `0`	integer	0
query	limit optional	limit Example : `20`	integer	20
query	name optional	Volume Name Example : `my_volume`	any of [string, null]	None
query	type_name optional	Volume Type Name Example : `HDD`	any of [string, null]	None
query	sort optional	sort Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeListResponse
400	Bad Request	None
403	Forbidden	None
401	Unauthorized	None

Example HTTP request

Request path

/v1/volumes

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 200

{
    "count": 1,
    "filestorages": [
        {
            "id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
            "name": "my_volume",
            "protocol": "NFS",
            "state": "available",
            "account_id": "rwww523320dfvwbbefefsdvwdadsfa24c",
            "created_at": "2024-07-30T04:54:33.219373",
            "type_id": "jef22f67-ee83-4gg2-2ab6-3lf774ekfjdu",
            "type_name": "HDD",
            "purpose": "replication"
        }
    ]
}

1.16 - RestoreSnapshot

1.16.1 - 1.2

put /v1/snapshots/{snapshot_id}/restore

Description

Restore snapshot

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotRestoreResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_id}/restore?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 202

{
    "snapshot": {
        "id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
        "name": "my_volume.2024-10-01_14215",
        "state": "available",
        "size": "",
        "created_at": "2024-07-30T04:54:33.219373"
    }
}

1.16.2 - 1.1

put /v1/snapshots/{snapshot_id}/restore

Description

Restore snapshot

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	snapshot_id required	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotRestoreResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshots/{snapshot_id}/restore?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 202

{
    "snapshot": {
        "id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
        "name": "my_volume.2024-10-01_14215",
        "state": "available",
        "size": "",
        "created_at": "2024-07-30T04:54:33.219373"
    }
}

1.17 - SetAccessRule

1.17.1 - 1.2

put /v1/volumes/{volume_id}/access-rules

Description

Set access rule for volume

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
body	body required		AccessRuleRequest

Responses

HTTP Code	Description	Schema
202	Accepted	AccessRuleResponse
400	Bad Request	None
403	Forbidden	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/access-rules

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Request body

{
    "object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
    "object_type": "VM",
    "action": "add"
}

Example HTTP response

Response 202

{
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "object_type": "VM",
    "object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
    "action": "add"
}

1.17.2 - 1.1

put /v1/volumes/{volume_id}/access-rules

Description

Set access rule for volume

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
body	body required		AccessRuleRequest

Responses

HTTP Code	Description	Schema
202	Accepted	AccessRuleResponse
400	Bad Request	None
403	Forbidden	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}/access-rules

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Request body

{
    "object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
    "object_type": "VM",
    "action": "add"
}

Example HTTP response

Response 202

{
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "object_type": "VM",
    "object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
    "action": "add"
}

1.18 - SetSnapshotSchedule

1.18.1 - 1.2

put /v1/snapshot-schedules/{snapshot_schedule_id}

Description

Set snapshot schedule

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	snapshot_schedule_id required	Snapshot Schedule ID Example : `d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
body	body required		SnapshotScheduleSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotScheduleSetResponse
400	Bad Request	None
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshot-schedules/{snapshot_schedule_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Request body

{
    "snapshot_retention_count": 10,
    "snapshot_schedule": {
        "frequency": "WEEKLY",
        "day_of_week": "MON",
        "hour": "23"
    }
}

Example HTTP response

Response 202

{
    "snapshot_retention_count": 10,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "snapshot_schedule": {
        "frequency": "WEEKLY",
        "day_of_week": "MON",
        "hour": "23"
    }
}

1.18.2 - 1.1

put /v1/snapshot-schedules/{snapshot_schedule_id}

Description

Set snapshot schedule

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	snapshot_schedule_id required	Snapshot Schedule ID Example : `d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
body	body required		SnapshotScheduleSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	SnapshotScheduleSetResponse
400	Bad Request	None
404	Not Found	None
403	Forbidden	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/snapshot-schedules/{snapshot_schedule_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Request body

{
    "snapshot_retention_count": 10,
    "snapshot_schedule": {
        "frequency": "WEEKLY",
        "day_of_week": "MON",
        "hour": "23"
    }
}

Example HTTP response

Response 202

{
    "snapshot_retention_count": 10,
    "volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "snapshot_schedule": {
        "frequency": "WEEKLY",
        "day_of_week": "MON",
        "hour": "23"
    }
}

1.19 - SetVolume

1.19.1 - 1.2

put /v1/volumes/{volume_id}

Description

Set volume

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
body	body required		VolumeSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeSetResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Request body

{
    "file_unit_recovery_enabled": true
}

Example HTTP response

Response 202

{
    "file_unit_recovery_enabled": true
}

1.19.2 - 1.1

put /v1/volumes/{volume_id}

Description

Set volume

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
body	body required		VolumeSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	VolumeSetResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Request body

{
    "file_unit_recovery_enabled": true
}

Example HTTP response

Response 202

{
    "file_unit_recovery_enabled": true
}

1.20 - SetVolumeReplication

1.20.1 - 1.2

put /v1/replications/{replication_id}

Description

Set Volume Replication

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
body	body required		ReplicationUpdateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ReplicationUpdateResponse
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/replications/{replication_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Request body

{
    "replication_policy": "use",
    "replication_frequency": "5min",
    "backup_retention_count": 2,
    "replication_update_type": "policy"
}

Example HTTP response

Response 202

{
    "replication_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_frequency": "5min",
    "source_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "source_volume_region": "kr-west1",
    "source_volume_access_level": "ro",
    "replication_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_volume_region": "kr-west1",
    "replication_volume_access_level": "ro",
    "replication_type": "replication",
    "backup_retention_count": 2
}

1.20.2 - 1.1

put /v1/replications/{replication_id}

Description

Set Volume Replication

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
body	body required		ReplicationUpdateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ReplicationUpdateResponse
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/replications/{replication_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Request body

{
    "replication_policy": "use",
    "replication_frequency": "5min",
    "backup_retention_count": 2,
    "replication_update_type": "policy"
}

Example HTTP response

Response 202

{
    "replication_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_frequency": "5min",
    "source_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "source_volume_region": "kr-west1",
    "source_volume_access_level": "ro",
    "replication_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_volume_region": "kr-west1",
    "replication_volume_access_level": "ro",
    "replication_type": "replication",
    "backup_retention_count": 2
}

1.21 - ShowVolume

1.21.1 - 1.2

get /v1/volumes/{volume_id}

Description

Show volume

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeShowResponseV1Dot2
403	Forbidden	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 200

{
    "id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "name": "my_volume",
    "protocol": "NFS",
    "state": "available",
    "account_id": "rwww523320dfvwbbefefsdvwdadsfa24c",
    "created_at": "2024-07-30T04:54:33.219373",
    "type_name": "HDD",
    "purpose": "replication",
    "path": "xxx.xx.xxx:/xxxxxxxx",
    "usage": "",
    "encryption_enabled": true,
    "file_unit_recovery_enabled": true,
    "cifs_id": "cifsid",
    "endpoint_path": "xxx.xx.xxx.xxx",
    "zone": "kr-west1-a",
    "az_type": "single"
}

1.21.2 - 1.1

get /v1/volumes/{volume_id}

Description

Show volume

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	VolumeShowResponse
403	Forbidden	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/volumes/{volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 200

{
    "id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "name": "my_volume",
    "protocol": "NFS",
    "state": "available",
    "account_id": "rwww523320dfvwbbefefsdvwdadsfa24c",
    "created_at": "2024-07-30T04:54:33.219373",
    "type_id": "jef22f67-ee83-4gg2-2ab6-3lf774ekfjdu",
    "type_name": "HDD",
    "purpose": "replication",
    "path": "xxx.xx.xxx:/xxxxxxxx",
    "usage": "",
    "encryption_enabled": true,
    "file_unit_recovery_enabled": true,
    "cifs_id": "cifsid",
    "endpoint_path": "xxx.xx.xxx.xxx"
}

1.22 - ShowVolumeReplication

1.22.1 - 1.2

get /v1/replications/{replication_id}

Description

Show Volume Replication

State ACTIVE (CURRENT)

Version	Not Before
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ReplicationShowResponseV1Dot2
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/replications/{replication_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.2"

Example HTTP response

Response 200

{
    "replication_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_frequency": "5min",
    "source_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "source_volume_region": "kr-west1",
    "source_volume_zone": "kr-west1-a",
    "source_volume_access_level": "ro",
    "replication_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_volume_region": "kr-west1",
    "replication_volume_zone": "kr-west1-a",
    "replication_volume_access_level": "ro",
    "replication_type": "replication",
    "source_volume_name": "my_volume",
    "replication_policy": "use",
    "replication_status": "creating",
    "replication_volume_name": "my_volume",
    "backup_retention_count": 2
}

1.22.2 - 1.1

get /v1/replications/{replication_id}

Description

Show Volume Replication

State ACTIVE (SUPPORTED)

Version	Not Before
1.1	20261130

Parameters

Type	Name	Description	Schema	Default
path	replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None
query	volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ReplicationShowResponse
401	Unauthorized	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/replications/{replication_id}?volume_id={volume_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = filestorage 1.1"

Example HTTP response

Response 200

{
    "replication_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_frequency": "5min",
    "source_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "source_volume_region": "kr-west1",
    "source_volume_access_level": "ro",
    "replication_volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
    "replication_volume_region": "kr-west1",
    "replication_volume_access_level": "ro",
    "replication_type": "replication",
    "source_volume_name": "my_volume",
    "replication_policy": "use",
    "replication_status": "creating",
    "replication_volume_name": "my_volume",
    "backup_retention_count": 2
}

2 - Models

2.1 - AccessRuleRequest

Name	Description	Schema
object_id required	Object ID Example : `43fq3347-02q4-4aa8-ccf9-affe4917bb6f`	string
object_type required	Object Type Example : `VM` Pattern : `^(VM\|BM\|GPU\|GPU_NODE\|ENDPOINT)$`	string
action required	Access Rule Action Example : `add` Pattern : `^(add\|remove)$`	string

2.2 - AccessRuleResponse

Name	Description	Schema
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
object_type required	Object Type Example : `VM`	string
object_id required	Object ID Example : `43fq3347-02q4-4aa8-ccf9-affe4917bb6f`	string
action required	Access Rule Action Example : `add`	string

2.3 - Replication

Name	Description	Schema
replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_frequency required	Frequency Example : `5min`	string
source_volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
source_volume_region required	Source Region Example : `kr-west1`	string
source_volume_access_level required	Source Access Level Example : `ro`	string
replication_volume_id required	Target Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_volume_region required	Target Region Example : `kr-west1`	string
replication_volume_access_level required	Target Access Level Example : `ro`	string
replication_type required	Replication Type Example : `replication`	string

2.4 - ReplicationCreateRequest

Name	Description	Schema
name required	Target Volume Name Example : `my_volume` Pattern : `^[a-z]([a-z0-9_]){2,20}$`	string
cifs_password optional	CIFS Password Example : `cifspwd0!!`	any of [string, null]
replication_frequency required	Frequency Example : `5min` Pattern : `^(5min\|hourly\|daily\|weekly\|monthly)$`	string
region required	Target Region Example : `kr-west1`	string
volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
backup_retention_count optional	Backup Retention Count Example : `2`	any of [integer, null]
replication_type required	Replication Type Example : `replication` Pattern : `^(replication\|backup)$`	string

2.5 - ReplicationCreateRequestV1Dot2

Name	Description	Schema
name required	Target Volume Name Example : `my_volume` Pattern : `^[a-z]([a-z0-9_]){2,20}$`	string
cifs_password optional	CIFS Password Example : `cifspwd0!!`	any of [string, null]
replication_frequency required	Frequency Example : `5min` Pattern : `^(5min\|hourly\|daily\|weekly\|monthly)$`	string
zone required	Zone Example : `kr-west1-a`	string
volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
backup_retention_count optional	Backup Retention Count Example : `2`	any of [integer, null]
replication_type required	Replication Type Example : `replication` Pattern : `^(replication\|backup)$`	string

2.6 - ReplicationCreateResponse

Name	Description	Schema
replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_status required	Replication Status Example : `creating`	string
source_volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
source_volume_region required	Source Region Example : `kr-west1`	string
protocol required	Protocol Example : `NFS`	string
replication_volume_id required	Target Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_volume_region required	Target Region Example : `kr-west1`	string

2.7 - ReplicationCreateResponseV1Dot2

Name	Description	Schema
replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_status required	Replication Status Example : `creating`	string
source_volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
source_volume_region required	Source Region Example : `kr-west1`	string
source_volume_zone required	Source Zone Example : `kr-west1-a`	string
protocol required	Protocol Example : `NFS`	string
replication_volume_id required	Target Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_volume_region required	Target Region Example : `kr-west1`	string
replication_volume_zone required	Target Zone Example : `kr-west1-a`	string

2.8 - ReplicationListResponse

Name	Description	Schema	Default
count required	count Example : `1`	integer
replications required		array[Replication]

2.9 - ReplicationListResponseV1Dot2

Name	Description	Schema	Default
count required	count Example : `1`	integer
replications required		array[ReplicationV1Dot2]

2.10 - ReplicationRegionListResponse

Name	Description	Schema	Default
regions required	Replication Region List Example : `['kr-west1']`	array[string]

2.11 - ReplicationShowResponse

Name	Description	Schema
replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_frequency required	Frequency Example : `5min`	string
source_volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
source_volume_region required	Source Region Example : `kr-west1`	string
source_volume_access_level required	Source Access Level Example : `ro`	string
replication_volume_id required	Target Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_volume_region required	Target Region Example : `kr-west1`	string
replication_volume_access_level required	Target Access Level Example : `ro`	string
replication_type required	Replication Type Example : `replication`	string
source_volume_name required	Source Volume Name Example : `my_volume`	string
replication_policy required	Policy Example : `use`	string
replication_status required	Replication Status Example : `creating`	string
replication_volume_name required	Target Volume Name Example : `my_volume`	string
backup_retention_count optional	Backup Retention Count Example : `2`	any of [integer, null]

2.12 - ReplicationShowResponseV1Dot2

Name	Description	Schema
replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_frequency required	Frequency Example : `5min`	string
source_volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
source_volume_region required	Source Region Example : `kr-west1`	string
source_volume_zone required	Source Zone Example : `kr-west1-a`	string
source_volume_access_level required	Source Access Level Example : `ro`	string
replication_volume_id required	Target Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_volume_region required	Target Region Example : `kr-west1`	string
replication_volume_zone required	Target Zone Example : `kr-west1-a`	string
replication_volume_access_level required	Target Access Level Example : `ro`	string
replication_type required	Replication Type Example : `replication`	string
source_volume_name required	Source Volume Name Example : `my_volume`	string
replication_policy required	Policy Example : `use`	string
replication_status required	Replication Status Example : `creating`	string
replication_volume_name required	Target Volume Name Example : `my_volume`	string
backup_retention_count optional	Backup Retention Count Example : `2`	any of [integer, null]

2.13 - ReplicationUpdateRequest

Name	Description	Schema
replication_policy optional	Policy Example : `use`	any of [enum (use, paused), null]
replication_frequency optional	Frequency Example : `5min`	any of [enum (5min, hourly, daily, weekly, monthly), null]
backup_retention_count optional	Backup Retention Count Example : `2`	any of [integer, null]
replication_update_type required	Replication Update Type Example : `policy` Pattern : `^(policy\|modify_schedule)$`	string

2.14 - ReplicationUpdateResponse

Name	Description	Schema
replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_frequency required	Frequency Example : `5min`	string
source_volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
source_volume_region required	Source Region Example : `kr-west1`	string
source_volume_access_level required	Source Access Level Example : `ro`	string
replication_volume_id required	Target Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_volume_region required	Target Region Example : `kr-west1`	string
replication_volume_access_level required	Target Access Level Example : `ro`	string
replication_type required	Replication Type Example : `replication`	string
backup_retention_count optional	Backup Retention Count Example : `2`	any of [integer, null]

2.15 - ReplicationV1Dot2

Name	Description	Schema
replication_id required	Replication ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_frequency required	Frequency Example : `5min`	string
source_volume_id required	Source Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
source_volume_region required	Source Region Example : `kr-west1`	string
source_volume_zone required	Source Zone Example : `kr-west1-a`	string
source_volume_access_level required	Source Access Level Example : `ro`	string
replication_volume_id required	Target Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
replication_volume_region required	Target Region Example : `kr-west1`	string
replication_volume_zone required	Target Zone Example : `kr-west1-a`	string
replication_volume_access_level required	Target Access Level Example : `ro`	string
replication_type required	Replication Type Example : `replication`	string

2.16 - ReplicationZonesListResponse

Name	Description	Schema	Default
zones required	Replication Region List Example : `['kr-west1']`	array[string]

2.17 - Snapshot

Name	Description	Schema
id required	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	string
name required	Snapshot Name Example : `my_volume.2024-10-01_14215`	string
state required	Snapshot State Example : `available`	string
size optional	Example :	any of [integer, null]
created_at required	Created At Example : `2024-07-30T04:54:33.219373`	string (date-time)

2.18 - SnapshotCreateRequest

Name	Description	Schema	Default
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string

2.19 - SnapshotDetail

Name	Description	Schema
id required	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	string
name required	Snapshot Name Example : `my_volume.2024-10-01_14215`	string
state required	Snapshot State Example : `available`	string
size optional	Example :	any of [integer, null]
created_at required	Created At Example : `2024-07-30T04:54:33.219373`	string (date-time)
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string

2.20 - SnapshotListResponse

Name	Description	Schema
count required	count Example : `1`	integer
snapshots required		array[Snapshot]
snapshot_size_total_byte optional	Example :	any of [integer, null]

2.21 - SnapshotRestoreResponse

Name	Description	Schema	Default
snapshot required		Snapshot

2.22 - SnapshotSchedule

Name	Description	Schema
frequency required	Frequency of the snapshot Example : `WEEKLY` Pattern : `^(WEEKLY\|DAILY)$`	string
day_of_week optional	Day of week of the snapshot schedule Example : `MON` Pattern : `^(SUN\|MON\|TUE\|WED\|THU\|FRI\|SAT)$`	any of [string, null]
hour required	Hour of the snapshot schedule Example : `23` Pattern : `^([0-9]\|1[0-9]\|2[0-3])$`	string

2.23 - SnapshotScheduleCreateRequest

Name	Description	Schema
snapshot_retention_count optional	Retention count Example : `10`	any of [integer, null]
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
snapshot_schedule required		SnapshotSchedule

2.24 - SnapshotScheduleCreateResponse

Name	Description	Schema
snapshot_retention_count optional	Retention count Example : `10`	integer
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	any of [string, null]
snapshot_schedule required		SnapshotSchedule

2.25 - SnapshotScheduleListResponse

Name	Description	Schema
snapshot_retention_count optional	Retention count Example : `10`	integer
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
snapshot_policy_enabled optional	Snapshot Schedule Policy Enabled Example : `true`	any of [boolean, null]
snapshot_schedule required		array[SnapshotScheduleShow]

2.26 - SnapshotScheduleSetRequest

Name	Description	Schema	Default
snapshot_retention_count optional	Retention count Example : `10`	any of [integer, null]
snapshot_schedule required		SnapshotSchedule

2.27 - SnapshotScheduleSetResponse

Name	Description	Schema
snapshot_retention_count optional	Retention count Example : `10`	integer
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	any of [string, null]
snapshot_schedule required		SnapshotSchedule

2.28 - SnapshotScheduleShow

Name	Description	Schema
frequency required	Frequency of the snapshot Example : `WEEKLY` Pattern : `^(WEEKLY\|DAILY)$`	string
day_of_week optional	Day of week of the snapshot schedule Example : `MON` Pattern : `^(SUN\|MON\|TUE\|WED\|THU\|FRI\|SAT)$`	any of [string, null]
hour required	Hour of the snapshot schedule Example : `23` Pattern : `^([0-9]\|1[0-9]\|2[0-3])$`	string
id optional	Snapshot Schedule ID Example : `d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`	any of [string, null]

2.29 - SnapshotShowResponse

Name	Description	Schema	Default
snapshot required		SnapshotDetail

2.30 - Tag

Name	Description	Schema	Default
key required	Key Example : `key` Maximum length : `128`	string
value optional	Value Example : `value`	any of [string, null]

2.31 - Volume

Name	Description	Schema
id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
name required	Volume Name Example : `my_volume`	string
protocol required	Protocol Example : `NFS`	string
state required	Volume State Example : `available`	string
account_id required	Account ID Example : `rwww523320dfvwbbefefsdvwdadsfa24c`	string
created_at required	Created At Example : `2024-07-30T04:54:33.219373`	string (date-time)
type_id required	Volume Type ID Example : `jef22f67-ee83-4gg2-2ab6-3lf774ekfjdu`	string
type_name required	Volume Type Name Example : `HDD`	string
purpose required	Purpose Example : `replication`	string

2.32 - VolumeCreateRequest

Name	Description	Schema
name required	Volume Name Example : `my_volume` Pattern : `^[a-z]([a-z0-9_]){2,20}$`	string
protocol required	Protocol Example : `NFS` Pattern : `^(NFS\|CIFS)$`	string
type_name required	Volume Type Name Example : `HDD`	string
snapshot_id optional	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	any of [string, null]
cifs_password optional	CIFS Password Example : `cifspwd0!!`	any of [string, null]
tags optional		any of [array[Tag], null]

2.33 - VolumeCreateRequestV1Dot2

Name	Description	Schema
name required	Volume Name Example : `my_volume` Pattern : `^[a-z]([a-z0-9_]){2,20}$`	string
protocol required	Protocol Example : `NFS` Pattern : `^(NFS\|CIFS)$`	string
type_name required	Volume Type Name Example : `HDD`	string
snapshot_id optional	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	any of [string, null]
cifs_password optional	CIFS Password Example : `cifspwd0!!`	any of [string, null]
tags optional		any of [array[Tag], null]
zone required	Zone Example : `kr-west1-a`	string

2.34 - VolumeCreateResponse

Name	Description	Schema
protocol required	Protocol Example : `NFS`	string
snapshot_id optional	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	any of [string, null]
type_name required	Volume Type Name Example : `HDD`	string
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
volume_name required	Volume Name Example : `my_volume`	string

2.35 - VolumeCreateResponseV1Dot2

Name	Description	Schema
protocol required	Protocol Example : `NFS`	string
snapshot_id optional	Snapshot ID Example : `40htrre5b-eww25-ff2b-a426-6afefas65a3b`	any of [string, null]
type_name required	Volume Type Name Example : `HDD`	string
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
volume_name required	Volume Name Example : `my_volume`	string
zone required	Zone Example : `kr-west1-a`	string

2.36 - VolumeListResponse

Name	Description	Schema	Default
count required	count Example : `1`	integer
filestorages required		array[Volume]

2.37 - VolumeListResponseV1Dot2

Name	Description	Schema	Default
count required	count Example : `1`	integer
filestorages required		array[VolumeV1Dot2]

2.38 - VolumeObjectAccessRuleListBase

Name	Description	Schema
access_rule_state required	Access Rule State Example : `active`	string
object_type required	Object Type Example : `VM`	string
object_id required	Object ID Example : `43fq3347-02q4-4aa8-ccf9-affe4917bb6f`	string

2.39 - VolumeObjectAccessRuleListResponse

Name	Description	Schema
count required	count Example : `1`	integer
volume_id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
access_rules required		array[VolumeObjectAccessRuleListBase]

2.40 - VolumeSetRequest

Name	Description	Schema	Default
file_unit_recovery_enabled required	Volume File Unit Recovery Enabled Example : `True`	boolean

2.41 - VolumeSetResponse

Name	Description	Schema	Default
file_unit_recovery_enabled required	Volume File Unit Recovery Enabled Example : `True`	boolean

2.42 - VolumeShowResponse

Name	Description	Schema
id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
name required	Volume Name Example : `my_volume`	string
protocol required	Protocol Example : `NFS`	string
state required	Volume State Example : `available`	string
account_id required	Account ID Example : `rwww523320dfvwbbefefsdvwdadsfa24c`	string
created_at required	Created At Example : `2024-07-30T04:54:33.219373`	string (date-time)
type_id required	Volume Type ID Example : `jef22f67-ee83-4gg2-2ab6-3lf774ekfjdu`	string
type_name required	Volume Type Name Example : `HDD`	string
purpose required	Purpose Example : `replication`	string
path optional	Volume Mount Path Example : `xxx.xx.xxx:/xxxxxxxx`	any of [string, null]
usage optional	Example :	any of [integer, null]
encryption_enabled required	Volume Encryption Enabled Example : `True`	boolean
file_unit_recovery_enabled optional	Volume File Unit Recovery Enabled Example : `True`	any of [boolean, null]
cifs_id optional	CIFS ID Example : `cifsid`	any of [string, null]
endpoint_path optional	Volume Endpoint Path Example : `xxx.xx.xxx.xxx`	any of [string, null]

2.43 - VolumeShowResponseV1Dot2

Name	Description	Schema
id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
name required	Volume Name Example : `my_volume`	string
protocol required	Protocol Example : `NFS`	string
state required	Volume State Example : `available`	string
account_id required	Account ID Example : `rwww523320dfvwbbefefsdvwdadsfa24c`	string
created_at required	Created At Example : `2024-07-30T04:54:33.219373`	string (date-time)
type_name required	Volume Type Name Example : `HDD`	string
purpose required	Purpose Example : `replication`	string
path optional	Volume Mount Path Example : `xxx.xx.xxx:/xxxxxxxx`	any of [string, null]
usage optional	Example :	any of [integer, null]
encryption_enabled required	Volume Encryption Enabled Example : `True`	boolean
file_unit_recovery_enabled optional	Volume File Unit Recovery Enabled Example : `True`	any of [boolean, null]
cifs_id optional	CIFS ID Example : `cifsid`	any of [string, null]
endpoint_path optional	Volume Endpoint Path Example : `xxx.xx.xxx.xxx`	any of [string, null]
zone required	Zone Example : `kr-west1-a`	string
az_type required	Availability Zone Type Example : `single`	any of [string, null]

2.44 - VolumeV1Dot2

Name	Description	Schema
id required	Volume ID Example : `bfdbabf2-04d9-4e8b-a205-020f8e6da438`	string
name required	Volume Name Example : `my_volume`	string
protocol required	Protocol Example : `NFS`	string
state required	Volume State Example : `available`	string
account_id required	Account ID Example : `rwww523320dfvwbbefefsdvwdadsfa24c`	string
created_at required	Created At Example : `2024-07-30T04:54:33.219373`	string (date-time)
type_id required	Volume Type ID Example : `jef22f67-ee83-4gg2-2ab6-3lf774ekfjdu`	string
type_name required	Volume Type Name Example : `HDD`	string
purpose required	Purpose Example : `replication`	string
zone required	Zone Example : `kr-west1-a`	string
az_type required	Availability Zone Type Example : `single`	any of [string, null]