이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.

Storage

1: Archive Storage

1.1: CLIs

1.1.1: CancelArchiving

1.1.1.1: 1.1
1.1.1.2: 1.0

1.1.2: CancelRecovery

1.1.2.1: 1.1
1.1.2.2: 1.0

1.1.3: CreateArchivingPolicy

1.1.3.1: 1.1
1.1.3.2: 1.0

1.1.4: CreateBucket

1.1.4.1: 1.1
1.1.4.2: 1.0

1.1.5: DeleteBucket

1.1.5.1: 1.1
1.1.5.2: 1.0

1.1.6: DeleteBucketObjects

1.1.6.1: 1.1
1.1.6.2: 1.0

1.1.7: DeleteBucketObjectVersions

1.1.7.1: 1.1

1.1.8: ListArchivingHistories

1.1.8.1: 1.1
1.1.8.2: 1.0

1.1.9: ListArchivingPolicies

1.1.9.1: 1.1
1.1.9.2: 1.0

1.1.10: ListBucketObjects

1.1.10.1: 1.1
1.1.10.2: 1.0

1.1.11: ListBucketObjectVersions

1.1.11.1: 1.1

1.1.12: ListBuckets

1.1.12.1: 1.1
1.1.12.2: 1.0

1.1.13: ListRecoveryHistories

1.1.13.1: 1.1
1.1.13.2: 1.0

1.1.14: RecoverObjects

1.1.14.1: 1.1
1.1.14.2: 1.0

1.1.15: RecoverObjectVersions

1.1.15.1: 1.1

1.1.16: SetArchivingPolicy

1.1.16.1: 1.1
1.1.16.2: 1.0

1.1.17: SetArchivingPolicyState

1.1.17.1: 1.1

1.1.18: SetBucketEncryption

1.1.18.1: 1.1
1.1.18.2: 1.0

1.1.19: SetBucketVersioning

1.1.19.1: 1.1

1.1.20: ShowArchivingHistory

1.1.20.1: 1.1
1.1.20.2: 1.0

1.1.21: ShowArchivingPolicy

1.1.21.1: 1.1
1.1.21.2: 1.0

1.1.22: ShowBucket

1.1.22.1: 1.1
1.1.22.2: 1.0

1.1.23: ShowBucketEncryption

1.1.23.1: 1.1
1.1.23.2: 1.0

1.1.24: ShowBucketVersioning

1.1.24.1: 1.1

1.1.25: ShowRecoveryHistory

1.1.25.1: 1.1
1.1.25.2: 1.0

2: Backup

2.1: CLIs

2.1.1: Check Backup Master Connection State

2.1.1.1: 1.1
2.1.1.2: 1.0

2.1.2: Check Backup Name Duplicate

2.1.2.1: 1.1
2.1.2.2: 1.0

2.1.3: Check Backup Restore Server Name Duplicate

2.1.3.1: 1.1
2.1.3.2: 1.0

2.1.4: Check Filesystem Path Duplication

2.1.4.1: 1.1
2.1.4.2: 1.0

2.1.5: Create Backup

2.1.5.1: 1.1
2.1.5.2: 1.0

2.1.6: Create Backup Agent

2.1.6.1: 1.1
2.1.6.2: 1.0

2.1.7: Delete Backup

2.1.7.1: 1.1
2.1.7.2: 1.0

2.1.8: Delete Backup Agent

2.1.8.1: 1.1
2.1.8.2: 1.0

2.1.9: Delete Backup Restore Target

2.1.9.1: 1.1
2.1.9.2: 1.0

2.1.10: List Agent Backup Restore Target Servers

2.1.10.1: 1.1
2.1.10.2: 1.0

2.1.11: List Backup Agents

2.1.11.1: 1.1
2.1.11.2: 1.0

2.1.12: List Backup Histories

2.1.12.1: 1.1
2.1.12.2: 1.0

2.1.13: List Backup Region Relationship

2.1.13.1: 1.1
2.1.13.2: 1.0

2.1.14: List Backup Restore Histories

2.1.14.1: 1.1
2.1.14.2: 1.0

2.1.15: List Backup Restore Subnets

2.1.15.1: 1.1
2.1.15.2: 1.0

2.1.16: List Backup Restore Targets

2.1.16.1: 1.1
2.1.16.2: 1.0

2.1.17: List Backup Schedules

2.1.17.1: 1.1
2.1.17.2: 1.0

2.1.18: List Backup Targets

2.1.18.1: 1.1
2.1.18.2: 1.0

2.1.19: List Backups

2.1.19.1: 1.1
2.1.19.2: 1.0

2.1.20: List Targets of Backup Agent

2.1.20.1: 1.1
2.1.20.2: 1.0

2.1.21: Manual Backup

2.1.21.1: 1.1
2.1.21.2: 1.0

2.1.22: Restore Agent Backup

2.1.22.1: 1.1
2.1.22.2: 1.0

2.1.23: Restore Backup

2.1.23.1: 1.1
2.1.23.2: 1.0

2.1.24: Set Backup Schedule

2.1.24.1: 1.1
2.1.24.2: 1.0

2.1.25: Set Filesystem Path

2.1.25.1: 1.1
2.1.25.2: 1.0

2.1.26: Show Backup

2.1.26.1: 1.1
2.1.26.2: 1.0

2.1.27: Show Backup Agent

2.1.27.1: 1.1
2.1.27.2: 1.0

2.1.28: Show Backup Agent Install File Path

2.1.28.1: 1.1
2.1.28.2: 1.0

2.1.29: Update Replication Use

2.1.29.1: 1.1
2.1.29.2: 1.0

2.1.30: Update Retention Period

2.1.30.1: 1.1
2.1.30.2: 1.0

3: Block Storage(BM)

3.1: CLIs

3.1.1: Add Volume Group Member on Volume Group

3.1.1.1: 1.2
3.1.1.2: 1.1
3.1.1.3: 1.0

3.1.2: Attach Volume

3.1.2.1: 1.2
3.1.2.2: 1.1
3.1.2.3: 1.0

3.1.3: Create Volume

3.1.3.1: 1.2
3.1.3.2: 1.1
3.1.3.3: 1.0

3.1.4: Create Volume Group

3.1.4.1: 1.2
3.1.4.2: 1.1
3.1.4.3: 1.0

3.1.5: Create Volume Group Recovery

3.1.5.1: 1.2
3.1.5.2: 1.1

3.1.6: Create Volume Group Replication

3.1.6.1: 1.2
3.1.6.2: 1.1
3.1.6.3: 1.0

3.1.7: Create Volume Group Snapshot

3.1.7.1: 1.2
3.1.7.2: 1.1
3.1.7.3: 1.0

3.1.8: Create Volume Group Snapshot Schedule

3.1.8.1: 1.2
3.1.8.2: 1.1
3.1.8.3: 1.0

3.1.9: Create Volume Recovery

3.1.9.1: 1.2
3.1.9.2: 1.1

3.1.10: Create Volume Replication

3.1.10.1: 1.2
3.1.10.2: 1.1
3.1.10.3: 1.0

3.1.11: Create Volume Snapshot

3.1.11.1: 1.2
3.1.11.2: 1.1
3.1.11.3: 1.0

3.1.12: Create Volume Snapshot Rate

3.1.12.1: 1.2
3.1.12.2: 1.1
3.1.12.3: 1.0

3.1.13: Create Volume Snapshot Schedule

3.1.13.1: 1.2
3.1.13.2: 1.1
3.1.13.3: 1.0

3.1.14: Delete Volume

3.1.14.1: 1.2
3.1.14.2: 1.1
3.1.14.3: 1.0

3.1.15: Delete Volume Group Replication

3.1.15.1: 1.2
3.1.15.2: 1.1
3.1.15.3: 1.0

3.1.16: Delete Volume Group Snapshot

3.1.16.1: 1.2
3.1.16.2: 1.1
3.1.16.3: 1.0

3.1.17: Delete Volume Group Snapshot Schedule

3.1.17.1: 1.2
3.1.17.2: 1.1
3.1.17.3: 1.0

3.1.18: Delete Volume Replication

3.1.18.1: 1.2
3.1.18.2: 1.1
3.1.18.3: 1.0

3.1.19: Delete Volume Snapshot

3.1.19.1: 1.2
3.1.19.2: 1.1
3.1.19.3: 1.0

3.1.20: Delete Volume Snapshot Rate

3.1.20.1: 1.2
3.1.20.2: 1.1
3.1.20.3: 1.0

3.1.21: Delete Volume Snapshot Schedule

3.1.21.1: 1.2
3.1.21.2: 1.1
3.1.21.3: 1.0

3.1.22: Detach Volume

3.1.22.1: 1.2
3.1.22.2: 1.1
3.1.22.3: 1.0

3.1.23: List Volume Group Snapshots

3.1.23.1: 1.2
3.1.23.2: 1.1
3.1.23.3: 1.0

3.1.24: List Volume Groups

3.1.24.1: 1.2
3.1.24.2: 1.1
3.1.24.3: 1.0

3.1.25: List Volume Snapshots

3.1.25.1: 1.2
3.1.25.2: 1.1
3.1.25.3: 1.0

3.1.26: List Volumes

3.1.26.1: 1.2
3.1.26.2: 1.1
3.1.26.3: 1.0

3.1.27: Remove Volume Group Member on Volume Group

3.1.27.1: 1.2
3.1.27.2: 1.1
3.1.27.3: 1.0

3.1.28: Restore Volume Group Snapshot

3.1.28.1: 1.2
3.1.28.2: 1.1
3.1.28.3: 1.0

3.1.29: Restore Volume Snapshot

3.1.29.1: 1.2
3.1.29.2: 1.1
3.1.29.3: 1.0

3.1.30: Set Volume Group Replication Cycle

3.1.30.1: 1.2
3.1.30.2: 1.1
3.1.30.3: 1.0

3.1.31: Set Volume Group Replication Policy

3.1.31.1: 1.2
3.1.31.2: 1.1
3.1.31.3: 1.0

3.1.32: Set Volume Group Snapshot Schedule

3.1.32.1: 1.2
3.1.32.2: 1.1
3.1.32.3: 1.0

3.1.33: Set Volume QoS

3.1.33.1: 1.2

3.1.34: Set Volume Replication Cycle

3.1.34.1: 1.2
3.1.34.2: 1.1
3.1.34.3: 1.0

3.1.35: Set Volume Replication Policy

3.1.35.1: 1.2
3.1.35.2: 1.1
3.1.35.3: 1.0

3.1.36: Set Volume Snapshot Rate

3.1.36.1: 1.2
3.1.36.2: 1.1
3.1.36.3: 1.0

3.1.37: Set Volume Snapshot Schedule

3.1.37.1: 1.2
3.1.37.2: 1.1
3.1.37.3: 1.0

3.1.38: Show Volume

3.1.38.1: 1.2
3.1.38.2: 1.1
3.1.38.3: 1.0

3.1.39: Show Volume Group

3.1.39.1: 1.2
3.1.39.2: 1.1
3.1.39.3: 1.0

3.1.40: Show Volume Group Replication

3.1.40.1: 1.2
3.1.40.2: 1.1
3.1.40.3: 1.0

3.1.41: Show Volume Replication

3.1.41.1: 1.2
3.1.41.2: 1.1
3.1.41.3: 1.0

4: File Storage

4.1: CLIs

4.1.1: CreateSnapshot

4.1.1.1: 1.1
4.1.1.2: 1.0

4.1.2: CreateSnapshotSchedule

4.1.2.1: 1.1
4.1.2.2: 1.0

4.1.3: CreateVolume

4.1.3.1: 1.1
4.1.3.2: 1.0

4.1.4: CreateVolumeReplication

4.1.4.1: 1.1
4.1.4.2: 1.0

4.1.5: DeleteSnapshot

4.1.5.1: 1.1
4.1.5.2: 1.0

4.1.6: DeleteSnapshotSchedule

4.1.6.1: 1.1
4.1.6.2: 1.0

4.1.7: DeleteVolume

4.1.7.1: 1.1
4.1.7.2: 1.0

4.1.8: DeleteVolumeReplication

4.1.8.1: 1.1
4.1.8.2: 1.0

4.1.9: ListAccessRules

4.1.9.1: 1.1
4.1.9.2: 1.0

4.1.10: ListSnapshots

4.1.10.1: 1.1
4.1.10.2: 1.0

4.1.11: ListSnapshotSchedule

4.1.11.1: 1.1
4.1.11.2: 1.0

4.1.12: ListVolumeReplicationRegion

4.1.12.1: 1.1
4.1.12.2: 1.0

4.1.13: ListVolumeReplications

4.1.13.1: 1.1
4.1.13.2: 1.0

4.1.14: ListVolumes

4.1.14.1: 1.1
4.1.14.2: 1.0

4.1.15: RestoreSnapshot

4.1.15.1: 1.1
4.1.15.2: 1.0

4.1.16: SetAccessRule

4.1.16.1: 1.1
4.1.16.2: 1.0

4.1.17: SetSnapshotSchedule

4.1.17.1: 1.1
4.1.17.2: 1.0

4.1.18: SetVolume

4.1.18.1: 1.1
4.1.18.2: 1.0

4.1.19: SetVolumeReplication

4.1.19.1: 1.1
4.1.19.2: 1.0

4.1.20: ShowVolume

4.1.20.1: 1.1
4.1.20.2: 1.0

4.1.21: ShowVolumeReplication

4.1.21.1: 1.1
4.1.21.2: 1.0

5: Parallel File Storage

5.1: CLIs

5.1.1: CreateSnapshot

5.1.1.1: 1.0

5.1.2: CreateVolume

5.1.2.1: 1.0

5.1.3: DeleteSnapshot

5.1.3.1: 1.0

5.1.4: DeleteVolume

5.1.4.1: 1.0

5.1.5: ListAccessRule

5.1.5.1: 1.0

5.1.6: ListSnapshots

5.1.6.1: 1.0

5.1.7: ListVolumes

5.1.7.1: 1.0

5.1.8: SetAccessRule

5.1.8.1: 1.0

5.1.9: SetVolumeCapacity

5.1.9.1: 1.0

5.1.10: ShowVolume

5.1.10.1: 1.0

1 - Archive Storage

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.

본 가이드는 Archive Storage 서비스에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.

Version

Version	Status	Supported Until
1.0	DEPRECATED	20251231
1.1	CURRENT	-

1.1 - CLIs

1.1.1 - CancelArchiving

1.1.1.1 - 1.1

scpcli archivestorage archiving history cancel
--bucket_id <value>
--id <value>

Description

아카이빙을 취소한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`3d036efe-f576-48b0-8375-6d3704a95b63`
id required	string	아카이빙 이력 아이디	`EXE-8f35b491-a060-453b-b825-e78440ca46de`

1.1.1.2 - 1.0

scpcli archivestorage archiving history cancel
--bucket_id <value>
--id <value>

Description

아카이빙을 취소한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`3d036efe-f576-48b0-8375-6d3704a95b63`
id required	string	아카이빙 이력 아이디	`EXE-8f35b491-a060-453b-b825-e78440ca46de`

1.1.2 - CancelRecovery

1.1.2.1 - 1.1

scpcli archivestorage recovery history cancel
--bucket_id <value>
--id <value>

Description

복구를 취소한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`7d8d8c2b-d02a-421e-a6e3-5b981bfb507f`
id required	string	복구 이력 아이디	`EXE-9df439a5-9e6d-46a4-806e-1e9991520763`

1.1.2.2 - 1.0

scpcli archivestorage recovery history cancel
--bucket_id <value>
--id <value>

Description

복구를 취소한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`7d8d8c2b-d02a-421e-a6e3-5b981bfb507f`
id required	string	복구 이력 아이디	`EXE-9df439a5-9e6d-46a4-806e-1e9991520763`

1.1.3 - CreateArchivingPolicy

1.1.3.1 - 1.1

scpcli archivestorage archiving policy create
--bucket_id <value>
--object_path <value>
--object_lifecycle <value>
--archiving_source_bucket_name <value>

Description

아카이빙 정책을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
object_path required	string	오브젝트 경로	`/`
object_lifecycle required	string	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	`1`
archiving_source_bucket_name required	string	아카이빙 소스 버킷 이름	`obs-bucket-name`

Responses

Name	Description	Example
id	아카이빙 정책 아이디	SCH-XXXXXXX
bucket_id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
archiving_source	아카이빙 소스
object_lifecycle	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	1
state	아카이빙 정책 상태	ACTIVE

1.1.3.2 - 1.0

scpcli archivestorage archiving policy create
--bucket_id <value>
--object_path <value>
--object_lifecycle <value>
--archiving_source_bucket_name <value>

Description

아카이빙 정책을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
object_path required	string	오브젝트 경로	`/`
object_lifecycle required	string	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	`1`
archiving_source_bucket_name required	string	아카이빙 소스 버킷 이름	`obs-bucket-name`

Responses

Name	Description	Example
id	아카이빙 정책 아이디	SCH-XXXXXXX
bucket_id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
archiving_source	아카이빙 소스
object_lifecycle	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	1
state	아카이빙 정책 상태	ACTIVE

1.1.4 - CreateBucket

1.1.4.1 - 1.1

scpcli archivestorage bucket create
--name <value>
[--tags <value>]

Description

버킷을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
name required	string	버킷 이름	`astest`
tags optional	array	태그 목록	`'{"key": "key", "value": "value"}'`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2

1.1.4.2 - 1.0

scpcli archivestorage bucket create
--name <value>
[--tags <value>]

Description

버킷을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
name required	string	버킷 이름	`astest`
tags optional	array	태그 목록	`'{"key": "key", "value": "value"}'`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2

1.1.5 - DeleteBucket

1.1.5.1 - 1.1

scpcli archivestorage bucket delete
--bucket_id <value>

Description

버킷을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

1.1.5.2 - 1.0

scpcli archivestorage bucket delete
--bucket_id <value>

Description

버킷을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

1.1.6 - DeleteBucketObjects

1.1.6.1 - 1.1

scpcli archivestorage bucket object delete
--bucket_id <value>
--paths <value>

Description

버킷 오브젝트를 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
paths required	array	오브젝트 경로 목록	`test/`

1.1.6.2 - 1.0

scpcli archivestorage bucket object delete
--bucket_id <value>
--paths <value>

Description

버킷 오브젝트를 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
paths required	array	오브젝트 경로 목록	`test/`

1.1.7 - DeleteBucketObjectVersions

1.1.7.1 - 1.1

scpcli archivestorage bucket object version delete
--bucket_id <value>
--versions <value>
--path <value>

Description

버킷 오브젝트 버전을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
versions required	array	오브젝트 버전 목록	`Oc9nEYWV.6VjzsIMXFZWM1zL8HcYvKl`
path required	string	오브젝트 경로	`hello/my_file.txt`

1.1.8 - ListArchivingHistories

1.1.8.1 - 1.1

scpcli archivestorage archiving history list
--start_at_to <value>
--start_at_from <value>
--bucket_id <value>
[--state <value>]
[--limit <value>]
[--offset <value>]

Description

아카이빙 이력 목록을 검색한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
start_at_to required	string	시작일까지	`2025-04-30T23:59:59+09:00`
start_at_from required	string	시작일부터	`2025-04-01T00:00:00+09:00`
bucket_id required	string	버킷 아이디	`3d036efe-f576-48b0-8375-6d3704a95b63`
state optional	string	상태	`SUCCESS`
limit optional	integer	조회 개수	`20`
offset optional	integer	오프셋	`0`

Responses

Name	Description	Example
id	아카이빙 이력 아이디	EXE-8f35b491-a060-453b-b825-e78440ca46de
archiving_id	아카이빙 아이디	SCH-02d48456-0f35-47e2-8056-b00e09366cac
state	상태	SUCCESS
archiving_policy_id	아카이빙 정책 아이디	SCH-02d48456-0f35-47e2-8056-b00e09366cac
start_at	시작 일시	2025-04-01T00:00:00+09:00
end_at	종료 일시	2025-04-30T23:59:59+09:00

1.1.8.2 - 1.0

scpcli archivestorage archiving history list
--start_at_to <value>
--start_at_from <value>
--bucket_id <value>
[--state <value>]
[--limit <value>]
[--offset <value>]

Description

아카이빙 이력 목록을 검색한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
start_at_to required	string	시작일까지	`2025-04-30T23:59:59+09:00`
start_at_from required	string	시작일부터	`2025-04-01T00:00:00+09:00`
bucket_id required	string	버킷 아이디	`3d036efe-f576-48b0-8375-6d3704a95b63`
state optional	string	상태	`SUCCESS`
limit optional	integer	조회 개수	`20`
offset optional	integer	오프셋	`0`

Responses

Name	Description	Example
id	아카이빙 이력 아이디	EXE-8f35b491-a060-453b-b825-e78440ca46de
archiving_id	아카이빙 아이디	SCH-02d48456-0f35-47e2-8056-b00e09366cac
state	상태	SUCCESS
archiving_policy_id	아카이빙 정책 아이디	SCH-02d48456-0f35-47e2-8056-b00e09366cac
start_at	시작 일시	2025-04-01T00:00:00+09:00
end_at	종료 일시	2025-04-30T23:59:59+09:00

1.1.9 - ListArchivingPolicies

1.1.9.1 - 1.1

scpcli archivestorage archiving policy list
--bucket_id <value>

Description

아카이빙 정책 목록을 검색한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	아카이빙 정책 아이디	SCH-XXXXXXX
object_lifecycle	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	1
object_path	오브젝트 경로	/
state	아카이빙 정책 상태	ACTIVE

1.1.9.2 - 1.0

scpcli archivestorage archiving policy list
--bucket_id <value>

Description

아카이빙 정책 목록을 검색한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	아카이빙 정책 아이디	SCH-XXXXXXX
object_lifecycle	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	1
object_path	오브젝트 경로	/
state	아카이빙 정책 상태	ACTIVE

1.1.10 - ListBucketObjects

1.1.10.1 - 1.1

scpcli archivestorage bucket object list
--bucket_id <value>
[--marker <value>]
[--object_path <value>]
[--object_name <value>]
[--object_type <value>]
[--limit <value>]

Description

버킷 오브젝트 목록을 검색한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
marker optional	string	마커	`TODO.txt`
object_path optional	string	오브젝트 경로	`/`
object_name optional	string	오브젝트 이름	`hello/TODO.txt`
object_type optional	string	오브젝트 타입	`FILE`
limit optional	integer	조회 개수	`20`

Responses

Name	Description	Example
object_name	오브젝트 이름	hello/TODO.txt
object_type	오브젝트 타입	FILE
object_size	오브젝트 크기	3581
modified_at	수정일	2025-04-09T05:54:46.244000+00:00

1.1.10.2 - 1.0

scpcli archivestorage bucket object list
--bucket_id <value>
[--marker <value>]
[--object_path <value>]
[--object_name <value>]
[--object_type <value>]
[--limit <value>]

Description

버킷 오브젝트 목록을 검색한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
marker optional	string	마커	`TODO.txt`
object_path optional	string	오브젝트 경로	`/`
object_name optional	string	오브젝트 이름	`hello/TODO.txt`
object_type optional	string	오브젝트 타입	`FILE`
limit optional	integer	조회 개수	`20`

Responses

Name	Description	Example
object_name	오브젝트 이름	hello/TODO.txt
object_type	오브젝트 타입	FILE
object_size	오브젝트 크기	3581
modified_at	수정일	2025-04-09T05:54:46.244000+00:00

1.1.11 - ListBucketObjectVersions

1.1.11.1 - 1.1

scpcli archivestorage bucket object version list
--bucket_id <value>
--object_path <value>
[--offset <value>]
[--limit <value>]

Description

버킷 오브젝트 버전 목록을 검색한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
object_path required	string	오브젝트 경로	`hello/my_file.txt`
offset optional	integer	오프셋	`0`
limit optional	integer	조회 개수	`20`

Responses

Name	Description	Example
object_path	오브젝트 경로	hello/my_file.txt
object_version_id	오브젝트 버전 아이디	Oc9nEYWV.6VjzsIMXFZWM1zL8HcYvKl
latest	오브젝트의 최신버전	True
modified_at	수정일	2025-04-09T05:54:46.244000+00:00
etag	ETag	4f6094f1e0619a6504efcb5e69e63bec
size	크기	20

1.1.12 - ListBuckets

1.1.12.1 - 1.1

scpcli archivestorage bucket list
[--name <value>]
[--limit <value>]

Description

버킷 목록을 검색한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
name optional	string	버킷 이름	`astest`
limit optional	integer	조회 개수	`20`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
name	버킷 이름	astest

1.1.12.2 - 1.0

scpcli archivestorage bucket list
[--name <value>]
[--limit <value>]

Description

버킷 목록을 검색한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
name optional	string	버킷 이름	`astest`
limit optional	integer	조회 개수	`20`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
name	버킷 이름	astest

1.1.13 - ListRecoveryHistories

1.1.13.1 - 1.1

scpcli archivestorage recovery history list
--start_at_to <value>
--start_at_from <value>
--bucket_id <value>
[--state <value>]
[--limit <value>]
[--offset <value>]

Description

복구 이력 목록을 검색한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
start_at_to required	string	시작일까지	`2025-04-30T23:59:59+09:00`
start_at_from required	string	시작일부터	`2025-04-01T00:00:00+09:00`
bucket_id required	string	버킷 아이디	`7d8d8c2b-d02a-421e-a6e3-5b981bfb507f`
state optional	string	상태	`SUCCESS`
limit optional	integer	조회 개수	`20`
offset optional	integer	오프셋	`0`

Responses

Name	Description	Example
id	복구 이력 아이디	EXE-9df439a5-9e6d-46a4-806e-1e9991520763
recovery_id	복구 아이디	ARC-f9eab563-312b-4bbf-a4bf-d377448d66b5
state	상태	SUCCESS
recovery_target_bucket_name	복구 대상 버킷 이름	test-obs-bucket
start_at	시작 일시	2025-04-01T00:00:00+09:00
end_at	종료 일시	2025-04-30T23:59:59+09:00

1.1.13.2 - 1.0

scpcli archivestorage recovery history list
--start_at_to <value>
--start_at_from <value>
--bucket_id <value>
[--state <value>]
[--limit <value>]
[--offset <value>]

Description

복구 이력 목록을 검색한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
start_at_to required	string	시작일까지	`2025-04-30T23:59:59+09:00`
start_at_from required	string	시작일부터	`2025-04-01T00:00:00+09:00`
bucket_id required	string	버킷 아이디	`7d8d8c2b-d02a-421e-a6e3-5b981bfb507f`
state optional	string	상태	`SUCCESS`
limit optional	integer	조회 개수	`20`
offset optional	integer	오프셋	`0`

Responses

Name	Description	Example
id	복구 이력 아이디	EXE-9df439a5-9e6d-46a4-806e-1e9991520763
recovery_id	복구 아이디	ARC-f9eab563-312b-4bbf-a4bf-d377448d66b5
state	상태	SUCCESS
recovery_target_bucket_name	복구 대상 버킷 이름	test-obs-bucket
start_at	시작 일시	2025-04-01T00:00:00+09:00
end_at	종료 일시	2025-04-30T23:59:59+09:00

1.1.14 - RecoverObjects

1.1.14.1 - 1.1

scpcli archivestorage bucket object recover
--bucket_id <value>
--overwrite <value>
--recovery_infos <value>
--recovery_target_bucket_name <value>

Description

오브젝트를 오브젝트 스토리지에 복구한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
overwrite required	boolean	덮어쓰기	`True`
recovery_infos required	array	오브젝트 복구 정보 목록	`'{"source_object_path": "/", "object_type": "FILE"}'`
recovery_target_bucket_name required	string	복구 대상 버킷 이름	`obs-bucket-name`

1.1.14.2 - 1.0

scpcli archivestorage bucket object recover
--bucket_id <value>
--overwrite <value>
--recovery_infos <value>
--recovery_target_bucket_name <value>

Description

오브젝트를 오브젝트 스토리지에 복구한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
overwrite required	boolean	덮어쓰기	`True`
recovery_infos required	array	오브젝트 복구 정보 목록	`'{"source_object_path": "/", "object_type": "FILE"}'`
recovery_target_bucket_name required	string	복구 대상 버킷 이름	`obs-bucket-name`

1.1.15 - RecoverObjectVersions

1.1.15.1 - 1.1

scpcli archivestorage bucket object recover versions
--bucket_id <value>
--overwrite <value>
--source_object_version <value>
--source_object_path <value>
--recovery_target_bucket_name <value>

Description

오브젝트 버전을 오브젝트 스토리지에 복구한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
overwrite required	boolean	덮어쓰기	`True`
source_object_version required	string	복구 소스 오브젝트 버전	`Oc9nEYWV.6VjzsIMXFZWM1zL8HcYvKl`
source_object_path required	string	복구 소스 오브젝트 경로	`/`
recovery_target_bucket_name required	string	복구 대상 버킷 이름	`obs-bucket-name`

1.1.16 - SetArchivingPolicy

1.1.16.1 - 1.1

scpcli archivestorage archiving policy set
--archiving_policy_id <value>
--bucket_id <value>
--object_lifecycle <value>

Description

아카이빙 정책을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
archiving_policy_id required	string	아카이빙 정책 아이디	`SCH-XXXXXXX`
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
object_lifecycle required	string	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	`1`

1.1.16.2 - 1.0

scpcli archivestorage archiving policy set
--archiving_policy_id <value>
--bucket_id <value>
--object_lifecycle <value>

Description

아카이빙 정책을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
archiving_policy_id required	string	아카이빙 정책 아이디	`SCH-XXXXXXX`
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
object_lifecycle required	string	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	`1`

1.1.17 - SetArchivingPolicyState

1.1.17.1 - 1.1

scpcli archivestorage archiving policy state set
--archiving_policy_id <value>
--bucket_id <value>
--state <value>

Description

아카이빙 정책 상태를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
archiving_policy_id required	string	아카이빙 정책 아이디	`SCH-XXXXXXX`
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
state required	string	아카이빙 정책 상태	`ACTIVE`

1.1.18 - SetBucketEncryption

1.1.18.1 - 1.1

scpcli archivestorage bucket encryption set
--bucket_id <value>
--enabled <value>

Description

버킷 암호화 정보를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
enabled required	boolean	암호화 여부	`True`

1.1.18.2 - 1.0

scpcli archivestorage bucket encryption set
--bucket_id <value>
--enabled <value>

Description

버킷 암호화 정보를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
enabled required	boolean	암호화 여부	`True`

1.1.19 - SetBucketVersioning

1.1.19.1 - 1.1

scpcli archivestorage bucket versioning set
--bucket_id <value>
--enabled <value>

Description

버킷 버저닝을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`
enabled required	boolean	버저닝 여부	`True`

1.1.20 - ShowArchivingHistory

1.1.20.1 - 1.1

scpcli archivestorage archiving history show
--bucket_id <value>
--id <value>

Description

아카이빙 이력을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`3d036efe-f576-48b0-8375-6d3704a95b63`
id required	string	아카이빙 이력 아이디	`EXE-8f35b491-a060-453b-b825-e78440ca46de`

Responses

Name	Description	Example
source_object_path	소스 오브젝트 경로	example_source_object_path/
usage	사용량	1024
total_object_count	총 오브젝트 개수	100
archiving_object_count	아카이빙 오브젝트 개수	50
archiving_rate	아카이빙 진행률	100

1.1.20.2 - 1.0

scpcli archivestorage archiving history show
--bucket_id <value>
--id <value>

Description

아카이빙 이력을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`3d036efe-f576-48b0-8375-6d3704a95b63`
id required	string	아카이빙 이력 아이디	`EXE-8f35b491-a060-453b-b825-e78440ca46de`

Responses

Name	Description	Example
source_object_path	소스 오브젝트 경로	example_source_object_path/
usage	사용량	1024
total_object_count	총 오브젝트 개수	100
archiving_object_count	아카이빙 오브젝트 개수	50
archiving_rate	아카이빙 진행률	100

1.1.21 - ShowArchivingPolicy

1.1.21.1 - 1.1

scpcli archivestorage archiving policy show
--archiving_policy_id <value>
--bucket_id <value>

Description

아카이빙 정책을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
archiving_policy_id required	string	아카이빙 정책 아이디	`SCH-XXXXXXX`
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	아카이빙 정책 아이디	SCH-XXXXXXX
bucket_id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
archiving_source	아카이빙 소스
object_lifecycle	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	1
state	아카이빙 정책 상태	ACTIVE

1.1.21.2 - 1.0

scpcli archivestorage archiving policy show
--archiving_policy_id <value>
--bucket_id <value>

Description

아카이빙 정책을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
archiving_policy_id required	string	아카이빙 정책 아이디	`SCH-XXXXXXX`
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	아카이빙 정책 아이디	SCH-XXXXXXX
bucket_id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
archiving_source	아카이빙 소스
object_lifecycle	Object Storage에 저장된 각 오브젝트의 생성 후 경과 일수를 기준으로 아카이빙 조건을 설정하는 값	1
state	아카이빙 정책 상태	ACTIVE

1.1.22 - ShowBucket

1.1.22.1 - 1.1

scpcli archivestorage bucket show
--bucket_id <value>

Description

버킷을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
name	버킷 이름	astest
state	버킷 상태	ACTIVE
usage	버킷 사용량	10
archiving_source_bucket_name	아카이빙 소스 버킷 이름	obstest

1.1.22.2 - 1.0

scpcli archivestorage bucket show
--bucket_id <value>

Description

버킷을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
name	버킷 이름	astest
state	버킷 상태	ACTIVE
usage	버킷 사용량	10
archiving_source_bucket_name	아카이빙 소스 버킷 이름	obstest

1.1.23 - ShowBucketEncryption

1.1.23.1 - 1.1

scpcli archivestorage bucket encryption show
--bucket_id <value>

Description

버킷 암호화 정보를 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
enabled	암호화 여부	True

1.1.23.2 - 1.0

scpcli archivestorage bucket encryption show
--bucket_id <value>

Description

버킷 암호화 정보를 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
enabled	암호화 여부	True

1.1.24 - ShowBucketVersioning

1.1.24.1 - 1.1

scpcli archivestorage bucket versioning show
--bucket_id <value>

Description

버킷 버저닝 정보를 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2`

Responses

Name	Description	Example
id	버킷 아이디	138c2-fc8c2-9a449-dbfa86-81f8f-1d78e2
enabled	암호화 여부	True

1.1.25 - ShowRecoveryHistory

1.1.25.1 - 1.1

scpcli archivestorage recovery history show
--bucket_id <value>
--id <value>

Description

복구 이력을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`7d8d8c2b-d02a-421e-a6e3-5b981bfb507f`
id required	string	복구 이력 아이디	`EXE-9df439a5-9e6d-46a4-806e-1e9991520763`

Responses

Name	Description	Example
source_object_path	소스 오브젝트 경로	example_source_object_path/
usage	사용량	1024
total_object_count	총 오브젝트 개수	100
recovery_object_count	복구 오브젝트 개수	50
recovery_rate	복구 진행률	50

1.1.25.2 - 1.0

scpcli archivestorage recovery history show
--bucket_id <value>
--id <value>

Description

복구 이력을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
bucket_id required	string	버킷 아이디	`7d8d8c2b-d02a-421e-a6e3-5b981bfb507f`
id required	string	복구 이력 아이디	`EXE-9df439a5-9e6d-46a4-806e-1e9991520763`

Responses

Name	Description	Example
source_object_path	소스 오브젝트 경로	example_source_object_path/
usage	사용량	1024
total_object_count	총 오브젝트 개수	100
recovery_object_count	복구 오브젝트 개수	50
recovery_rate	복구 진행률	50

2 - Backup

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.

본 가이드는 Backup 서비스에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.

Version

Version	Status	Supported Until
1.0	DEPRECATED	20260331
1.1	CURRENT	-

2.1 - CLIs

2.1.1 - Check Backup Master Connection State

2.1.1.1 - 1.1

scpcli backup backup agent connection state check
--backup_agent_id <value>

Description

백업 마스터 연결 상태 확인

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_agent_id required	string	Backup Agent ID	`BACKUP_AGENT-abcd`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.1.2 - 1.0

scpcli backup backup agent connection state check
--backup_agent_id <value>

Description

백업 마스터 연결 상태 확인

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_agent_id required	string	Backup Agent ID	`BACKUP_AGENT-abcd`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.2 - Check Backup Name Duplicate

2.1.2.1 - 1.1

scpcli backup backup name duplicate check
--backup_name <value>

Description

Backup명을 중복 체크한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_name required	string	Backup명	`backup-001`

Responses

Name	Description	Example
result	결과	True

2.1.2.2 - 1.0

scpcli backup backup name duplicate check
--backup_name <value>

Description

Backup명을 중복 체크한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_name required	string	Backup명	`backup-001`

Responses

Name	Description	Example
result	결과	True

2.1.3 - Check Backup Restore Server Name Duplicate

2.1.3.1 - 1.1

scpcli backup backup restore server name duplicate check
--restore_server_name <value>

Description

복구 서버명을 중복 체크한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
restore_server_name required	string	복구 서버명	`restoretest1`

Responses

Name	Description	Example
result	결과	True

2.1.3.2 - 1.0

scpcli backup backup restore server name duplicate check
--restore_server_name <value>

Description

복구 서버명을 중복 체크한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
restore_server_name required	string	복구 서버명	`restoretest1`

Responses

Name	Description	Example
result	결과	True

2.1.4 - Check Filesystem Path Duplication

2.1.4.1 - 1.1

scpcli backup backup agent filesystem duplication check
--server_uuid <value>
--filesystem_path <value>

Description

Filesystem 경로 중복 체크

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
server_uuid required	string	Backup 서버 UUID	`89f5ef44-1021-4a5c-8e06-fbb289eac366`
filesystem_path required	string	백업 대상 파일 시스템 경로	`/aaa`

Responses

Name	Description	Example
result	결과	True

2.1.4.2 - 1.0

scpcli backup backup agent filesystem duplication check
--server_uuid <value>
--filesystem_path <value>

Description

Filesystem 경로 중복 체크

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
server_uuid required	string	Backup 서버 UUID	`89f5ef44-1021-4a5c-8e06-fbb289eac366`
filesystem_path required	string	백업 대상 파일 시스템 경로	`/aaa`

Responses

Name	Description	Example
result	결과	True

2.1.5 - Create Backup

2.1.5.1 - 1.1

scpcli backup backup create
--server_uuid <value>
--server_category <value>
--schedules <value>
--policy_type <value>
--policy_category <value>
--name <value>
[--dr_enabled <value>]
[--encrypt_enabled <value>]
[--filesystem_paths <value>]
[--region <value>]
[--retention_period <value>]
[--server_guid <value>]
[--tags <value>]

Description

Backup을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
server_uuid required	string	Backup 서버 UUID	`89f5ef44-1021-4a5c-8e06-fbb289eac366`
server_category required	string	대상 서버 카테고리	```VIRTUAL_SERVER
schedules required	array	스케줄 목록	`'{"frequency": "DAILY", "start_day": "MON", "start_time": "09:00:00", "start_week": "WEEK_2", "type": "FULL"}'`
policy_type required	string	Backup 정책 유형	`VM_IMAGE`
policy_category required	string	Backup 정책 카테고리	`AGENTLESS`
name required	string	Backup명	`backup-001`
dr_enabled optional	boolean	DR 사용 여부	-
encrypt_enabled optional	boolean	암호화 사용 여부	`True`
filesystem_paths optional	array	백업 대상 파일 시스템 경로	`/aaa`
region optional	string	위치	`kr-west1`
retention_period optional	string	Backup 보관 기간	`WEEK_2`
server_guid optional	string	Backup 서버 GUID	`9ab33c66-3dbd-46cd-b0af-abccd3eb3170`
tags optional	array		`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.5.2 - 1.0

scpcli backup backup create
--server_uuid <value>
--server_category <value>
--schedules <value>
--policy_type <value>
--policy_category <value>
--name <value>
[--encrypt_enabled <value>]
[--filesystem_paths <value>]
[--region <value>]
[--retention_period <value>]
[--server_guid <value>]
[--tags <value>]

Description

Backup을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
server_uuid required	string	Backup 서버 UUID	`89f5ef44-1021-4a5c-8e06-fbb289eac366`
server_category required	string	대상 서버 카테고리	```VIRTUAL_SERVER
schedules required	array	스케줄 목록	`'{"frequency": "DAILY", "start_day": "MON", "start_time": "09:00:00", "start_week": "WEEK_2", "type": "FULL"}'`
policy_type required	string	Backup 정책 유형	`VM_IMAGE`
policy_category required	string	Backup 정책 카테고리	`AGENTLESS`
name required	string	Backup명	`backup-001`
encrypt_enabled optional	boolean	암호화 사용 여부	`True`
filesystem_paths optional	array	백업 대상 파일 시스템 경로	`/aaa`
region optional	string	위치	`kr-west1`
retention_period optional	string	Backup 보관 기간	`WEEK_2`
server_guid optional	string	Backup 서버 GUID	`9ab33c66-3dbd-46cd-b0af-abccd3eb3170`
tags optional	array		`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.6 - Create Backup Agent

2.1.6.1 - 1.1

scpcli backup backup agent create
--server_uuid <value>
[--tags <value>]

Description

Backup Agent을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
server_uuid required	string	Backup Agent 대상 서버 UUID	`89f5ef44-1021-4a5c-8e06-fbb289eac366`
tags optional	array		`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.6.2 - 1.0

scpcli backup backup agent create
--server_uuid <value>
[--tags <value>]

Description

Backup Agent을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
server_uuid required	string	Backup Agent 대상 서버 UUID	`89f5ef44-1021-4a5c-8e06-fbb289eac366`
tags optional	array		`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.7 - Delete Backup

2.1.7.1 - 1.1

scpcli backup backup delete
--backup_id <value>

Description

Backup을 해지한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`

2.1.7.2 - 1.0

scpcli backup backup delete
--backup_id <value>

Description

Backup을 해지한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`

2.1.8 - Delete Backup Agent

2.1.8.1 - 1.1

scpcli backup backup agent delete
--backup_agent_id <value>

Description

Backup Agent를 해지한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_agent_id required	string	Backup Agent ID	`BACKUP_AGENT-abcd`

2.1.8.2 - 1.0

scpcli backup backup agent delete
--backup_agent_id <value>

Description

Backup Agent를 해지한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_agent_id required	string	Backup Agent ID	`BACKUP_AGENT-abcd`

2.1.9 - Delete Backup Restore Target

2.1.9.1 - 1.1

scpcli backup backup restore target delete
--backup_id <value>
--restore_target_ids <value>

Description

복구 대상을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
restore_target_ids required	array	복구 대상 목록	`ca1a8e76-af49-40ea-93f8-a5989ffe138b`

2.1.9.2 - 1.0

scpcli backup backup restore target delete
--backup_id <value>
--restore_target_ids <value>

Description

복구 대상을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
restore_target_ids required	array	복구 대상 목록	`ca1a8e76-af49-40ea-93f8-a5989ffe138b`

2.1.10 - List Agent Backup Restore Target Servers

2.1.10.1 - 1.1

scpcli backup agent backup restore target server list
--backup_id <value>
[--server_name <value>]
[--page <value>]
[--size <value>]

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
server_name optional	string	Backup 서버명	`server-001`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`

Responses

Name	Description	Example
server_name	Backup 서버명	server-001
server_os_version	서버의 OS Type 과 버전	UBUNTU 22.04
server_uuid	Backup 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366

2.1.10.2 - 1.0

scpcli backup agent backup restore target server list
--backup_id <value>
[--server_name <value>]
[--page <value>]
[--size <value>]

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
server_name optional	string	Backup 서버명	`server-001`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`

Responses

Name	Description	Example
server_name	Backup 서버명	server-001
server_os_version	서버의 OS Type 과 버전	UBUNTU 22.04
server_uuid	Backup 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366

2.1.11 - List Backup Agents

2.1.11.1 - 1.1

scpcli backup backup agent list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]
[--server_backup_agent_ip <value>]
[--server_name <value>]

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
name optional	string	Backup Agent명	`agent_abcd12`
server_backup_agent_ip optional	string	대상 서버 Backup Agent IP	`11.22.33.44`
server_name optional	string	Backup Agent 대상 서버명	`server-001`

Responses

Name	Description	Example
id	Backup Agent ID	BACKUP_AGENT-abcd
account_id	Account ID	fnsd89fus0f9ds09f90dshf9dshfds09
backup_policy_count	Backup 정책 수	3
connection_state	Backup Agent 연결 상태	SUCCESS
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Backup Agent명	agent_abcd12
server_backup_agent_ip	대상 서버 Backup Agent IP	11.22.33.44
server_name	Backup 서버명	server-001
state	Backup Agent 상태	AVAILABLE

2.1.11.2 - 1.0

scpcli backup backup agent list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]
[--server_backup_agent_ip <value>]
[--server_name <value>]

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
name optional	string	Backup Agent명	`agent_abcd12`
server_backup_agent_ip optional	string	대상 서버 Backup Agent IP	`11.22.33.44`
server_name optional	string	Backup Agent 대상 서버명	`server-001`

Responses

Name	Description	Example
id	Backup Agent ID	BACKUP_AGENT-abcd
account_id	Account ID	fnsd89fus0f9ds09f90dshf9dshfds09
backup_policy_count	Backup 정책 수	3
connection_state	Backup Agent 연결 상태	SUCCESS
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Backup Agent명	agent_abcd12
server_backup_agent_ip	대상 서버 Backup Agent IP	11.22.33.44
server_name	Backup 서버명	server-001
state	Backup Agent 상태	AVAILABLE

2.1.12 - List Backup Histories

2.1.12.1 - 1.1

scpcli backup backup history list
--backup_id <value>
[--backup_start_time <value>]
[--backup_end_time <value>]
[--backup_job_state <value>]
[--page <value>]
[--size <value>]
[--sort <value>]

Description

Backup 이력을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
backup_start_time optional	string	시작 일시	`2024-09-30T15:00:00Z`
backup_end_time optional	string	검색 종료 일시	`2024-10-31T14:59:59Z`
backup_job_state optional	****	Backup 이력 상태	`SUCCESS`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`
sort optional	string	정렬 조건	`backup_start_time:desc`

Responses

Name	Description	Example
backup_end_time	검색 종료 일시	2024-10-31T14:59:59Z
backup_job_guid	Backup job GUID	3b1da7ba-3f38-45cb-9538-e921826f80d7
backup_job_state	Backup 이력 상태	SUCCESS
backup_start_time	시작 일시	2024-09-30T15:00:00Z
schedule_id	스케줄 ID	f5b8e22b-0d88-4698-9996-fb44217c8227
schedule_name	스케줄명	INCREMENTAL_DAILY_15:00:00-chg4By

2.1.12.2 - 1.0

scpcli backup backup history list
--backup_id <value>
[--backup_start_time <value>]
[--backup_end_time <value>]
[--backup_job_state <value>]
[--page <value>]
[--size <value>]
[--sort <value>]

Description

Backup 이력을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
backup_start_time optional	string	시작 일시	`2024-09-30T15:00:00Z`
backup_end_time optional	string	검색 종료 일시	`2024-10-31T14:59:59Z`
backup_job_state optional	****	Backup 이력 상태	`SUCCESS`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`
sort optional	string	정렬 조건	`backup_start_time:desc`

Responses

Name	Description	Example
backup_end_time	검색 종료 일시	2024-10-31T14:59:59Z
backup_job_guid	Backup job GUID	3b1da7ba-3f38-45cb-9538-e921826f80d7
backup_job_state	Backup 이력 상태	SUCCESS
backup_start_time	시작 일시	2024-09-30T15:00:00Z
schedule_id	스케줄 ID	f5b8e22b-0d88-4698-9996-fb44217c8227
schedule_name	스케줄명	INCREMENTAL_DAILY_15:00:00-chg4By

2.1.13 - List Backup Region Relationship

2.1.13.1 - 1.1

scpcli backup backup region relationship list
[--from_region <value>]
[--from_availability_zone <value>]
[--to_region <value>]
[--to_availability_zone <value>]
[--backup_master_type <value>]

Description

List Backup Region Relationship.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
from_region optional	string	위치	`kr-west1`
from_availability_zone optional	string	Availability Zone명	`kr-west1`
to_region optional	string	위치	`kr-west1`
to_availability_zone optional	string	Availability Zone명	`kr-west1`
backup_master_type optional	****	Backup Master 유형	`AGENTLESS`

Responses

Name	Description	Example
from_availability_zone	Availability Zone명	kr-west1
from_region	위치	kr-west1
to_availability_zone	Availability Zone명	kr-west1
to_region	위치	kr-west1

2.1.13.2 - 1.0

scpcli backup backup region relationship list
[--from_region <value>]
[--from_availability_zone <value>]
[--to_region <value>]
[--to_availability_zone <value>]

Description

List Backup Region Relationship.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
from_region optional	string	위치	`kr-west1`
from_availability_zone optional	string	Availability Zone명	`kr-west1`
to_region optional	string	위치	`kr-west1`
to_availability_zone optional	string	Availability Zone명	`kr-west1`

Responses

Name	Description	Example
from_availability_zone	Availability Zone명	kr-west1
from_region	위치	kr-west1
to_availability_zone	Availability Zone명	kr-west1
to_region	위치	kr-west1

2.1.14 - List Backup Restore Histories

2.1.14.1 - 1.1

scpcli backup backup restore history list
--backup_id <value>
[--page <value>]
[--size <value>]
[--sort <value>]
[--restore_state <value>]
[--start_time <value>]
[--end_time <value>]

Description

복구 이력을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`
sort optional	string	정렬 조건	`backup_start_time:desc`
restore_state optional	****	복구 상태	`COMPLETED`
start_time optional	string	시작 일시	`2024-09-30T15:00:00Z`
end_time optional	string	검색 종료 일시	`2024-10-31T14:59:59Z`

Responses

Name	Description	Example
backup_id	Backup ID	00cd2538fbf94d12b36aabbdd607e974
backup_start_time	Backup 일시	2024-10-28T05:38:48
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
restore_end_time	복구 완료 일시	2024-10-28T05:52:47
restore_server_id	복구 서버 ID	26895cb7-2059-49e7-b6fe-9c9c4b0d3db0
restore_server_name	복구 서버명	restoretest1
restore_start_time	복구 시작 일시	2024-10-28T05:52:47
restore_state	복구 상태	COMPLETED
schedule_name	스케줄명	INCREMENTAL_DAILY_15:00:00-chg4By

2.1.14.2 - 1.0

scpcli backup backup restore history list
--backup_id <value>
[--page <value>]
[--size <value>]
[--sort <value>]
[--restore_state <value>]
[--start_time <value>]
[--end_time <value>]

Description

복구 이력을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`
sort optional	string	정렬 조건	`backup_start_time:desc`
restore_state optional	****	복구 상태	`COMPLETED`
start_time optional	string	시작 일시	`2024-09-30T15:00:00Z`
end_time optional	string	검색 종료 일시	`2024-10-31T14:59:59Z`

Responses

Name	Description	Example
backup_id	Backup ID	00cd2538fbf94d12b36aabbdd607e974
backup_start_time	Backup 일시	2024-10-28T05:38:48
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
restore_end_time	복구 완료 일시	2024-10-28T05:52:47
restore_server_id	복구 서버 ID	26895cb7-2059-49e7-b6fe-9c9c4b0d3db0
restore_server_name	복구 서버명	restoretest1
restore_start_time	복구 시작 일시	2024-10-28T05:52:47
restore_state	복구 상태	COMPLETED
schedule_name	스케줄명	INCREMENTAL_DAILY_15:00:00-chg4By

2.1.15 - List Backup Restore Subnets

2.1.15.1 - 1.1

scpcli backup backup restore subnet list
--backup_id <value>
--region <value>
[--vpc_id <value>]
[--state <value>]

Description

원본 서버와 다른 위치에 복구하기 위해 서브넷 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
region required	string	서버를 복구할 리전	`kr-west1`
vpc_id optional	string	VPC ID	`7df8abb4912e4709b1cb237daccca7a8`
state optional	string	Subnet 상태	`ACTIVE`

Responses

Name	Description	Example
id	서브넷 ID	023c57b14f11483689338d085e061492
account_id	Account ID	fnsd89fus0f9ds09f90dshf9dshfds09
cidr	Subnet Cidr	192.167.1.0/24
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
gateway_ip_address	Gateway IP	192.167.1.1
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Subnet명	subnetName
state	Subnet 상태	ACTIVE
type	Subnet 유형	GENERAL
vpc_id	VPC ID	7df8abb4912e4709b1cb237daccca7a8
vpc_name	VPC명	vpcName

2.1.15.2 - 1.0

scpcli backup backup restore subnet list
--backup_id <value>
--region <value>
[--vpc_id <value>]
[--state <value>]

Description

원본 서버와 다른 위치에 복구하기 위해 서브넷 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
region required	string	서버를 복구할 리전	`kr-west1`
vpc_id optional	string	VPC ID	`7df8abb4912e4709b1cb237daccca7a8`
state optional	string	Subnet 상태	`ACTIVE`

Responses

Name	Description	Example
id	서브넷 ID	023c57b14f11483689338d085e061492
account_id	Account ID	fnsd89fus0f9ds09f90dshf9dshfds09
cidr	Subnet Cidr	192.167.1.0/24
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
gateway_ip_address	Gateway IP	192.167.1.1
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Subnet명	subnetName
state	Subnet 상태	ACTIVE
type	Subnet 유형	GENERAL
vpc_id	VPC ID	7df8abb4912e4709b1cb237daccca7a8
vpc_name	VPC명	vpcName

2.1.16 - List Backup Restore Targets

2.1.16.1 - 1.1

scpcli backup backup restore target list
--backup_id <value>
[--backup_start_time <value>]
[--backup_end_time <value>]
[--page <value>]
[--size <value>]
[--sort <value>]

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
backup_start_time optional	string	시작 일시	`2024-09-30T15:00:00Z`
backup_end_time optional	string	검색 종료 일시	`2024-10-31T14:59:59Z`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`
sort optional	string	정렬 조건	`backup_start_time:desc`

Responses

Name	Description	Example
backup_start_time	시작 일시	2024-09-30T15:00:00Z
is_restore_available	해당 백업 Image로 복구 가능 여부	true
restore_target_id	복구 대상 목록	ca1a8e76-af49-40ea-93f8-a5989ffe138b
retention_period	Backup 보관 기간	WEEK_2
schedule_id	스케줄 ID	f5b8e22b-0d88-4698-9996-fb44217c8227
schedule_name	스케줄명	INCREMENTAL_DAILY_15:00:00-chg4By
usage_gb	백업 용량(GB)	123.4

2.1.16.2 - 1.0

scpcli backup backup restore target list
--backup_id <value>
[--backup_start_time <value>]
[--backup_end_time <value>]
[--page <value>]
[--size <value>]
[--sort <value>]

Description

복구 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
backup_start_time optional	string	시작 일시	`2024-09-30T15:00:00Z`
backup_end_time optional	string	검색 종료 일시	`2024-10-31T14:59:59Z`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`
sort optional	string	정렬 조건	`backup_start_time:desc`

Responses

Name	Description	Example
backup_start_time	시작 일시	2024-09-30T15:00:00Z
is_restore_available	해당 백업 Image로 복구 가능 여부	true
restore_target_id	복구 대상 목록	ca1a8e76-af49-40ea-93f8-a5989ffe138b
retention_period	Backup 보관 기간	WEEK_2
schedule_id	스케줄 ID	f5b8e22b-0d88-4698-9996-fb44217c8227
schedule_name	스케줄명	INCREMENTAL_DAILY_15:00:00-chg4By
usage_gb	백업 용량(GB)	123.4

2.1.17 - List Backup Schedules

2.1.17.1 - 1.1

scpcli backup backup schedule list
--backup_id <value>

Description

스케줄 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
backup_id	Backup ID	00cd2538fbf94d12b36aabbdd607e974
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
frequency	스케줄 주기 유형	DAILY
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	스케줄명	INCREMENTAL_DAILY_15:00:00-chg4By
start_day	스케줄 시작 요일	MON
start_time	스케줄 시작 시간	14:00:00
start_week	스케줄 시작 주	WEEK_1
state	Backup 스케줄 상태	AVAILABLE
type	스케줄 유형	FULL

2.1.17.2 - 1.0

scpcli backup backup schedule list
--backup_id <value>

Description

스케줄 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
backup_id	Backup ID	00cd2538fbf94d12b36aabbdd607e974
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
frequency	스케줄 주기 유형	DAILY
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	스케줄명	INCREMENTAL_DAILY_15:00:00-chg4By
start_day	스케줄 시작 요일	MON
start_time	스케줄 시작 시간	14:00:00
start_week	스케줄 시작 주	WEEK_1
state	Backup 스케줄 상태	AVAILABLE
type	스케줄 유형	FULL

2.1.18 - List Backup Targets

2.1.18.1 - 1.1

scpcli backup backup target list
--server_category <value>
[--server_name <value>]
[--region <value>]
[--page <value>]
[--size <value>]

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
server_category required	****	대상 서버 카테고리	```VIRTUAL_SERVER
server_name optional	string	Backup 서버명	`server-001`
region optional	string	위치	`kr-west1`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`

Responses

Name	Description	Example
server_guid	Backup 서버 GUID	9ab33c66-3dbd-46cd-b0af-abccd3eb3170
server_name	Backup 서버명	server-001
server_os_version	서버의 OS Type 과 버전	UBUNTU 22.04
server_type	백업 서버 타입	s1v1m2
server_uuid	Backup 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366

2.1.18.2 - 1.0

scpcli backup backup target list
--server_category <value>
[--server_name <value>]
[--region <value>]
[--page <value>]
[--size <value>]

Description

Backup 대상 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
server_category required	****	대상 서버 카테고리	```VIRTUAL_SERVER
server_name optional	string	Backup 서버명	`server-001`
region optional	string	위치	`kr-west1`
page optional	integer	페이지	`0`
size optional	integer	항목 수	`20`

Responses

Name	Description	Example
server_guid	Backup 서버 GUID	9ab33c66-3dbd-46cd-b0af-abccd3eb3170
server_name	Backup 서버명	server-001
server_os_version	서버의 OS Type 과 버전	UBUNTU 22.04
server_type	백업 서버 타입	s1v1m2
server_uuid	Backup 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366

2.1.19 - List Backups

2.1.19.1 - 1.1

scpcli backup backup list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]
[--server_name <value>]

Description

Backup 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
name optional	string	Backup명	`backup-001`
server_name optional	string	Backup 서버명	`server-001`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Backup명	backup-001
policy_type	Backup 정책 유형	VM_IMAGE
retention_period	Backup 보관 기간	WEEK_2
role_type	백업 역할 유형	ORIGINAL
server_name	Backup 서버명	server-001
state	Backup 상태	AVAILABLE

2.1.19.2 - 1.0

scpcli backup backup list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]
[--server_name <value>]

Description

Backup 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
name optional	string	Backup명	`backup-001`
server_name optional	string	Backup 서버명	`server-001`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Backup명	backup-001
policy_type	Backup 정책 유형	VM_IMAGE
retention_period	Backup 보관 기간	WEEK_2
role_type	백업 역할 유형	ORIGINAL
server_name	Backup 서버명	server-001
state	Backup 상태	AVAILABLE

2.1.20 - List Targets of Backup Agent

2.1.20.1 - 1.1

scpcli backup backup agent target list
--server_category <value>
[--size <value>]
[--page <value>]
[--sort <value>]
[--server_name <value>]

Description

Backup Agent 대상 서버 목록

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
server_category required	string	대상 서버 카테고리	`BAREMETAL_SERVER`
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	정렬 조건	-
server_name optional	string	Backup 서버명	`server-001`

Responses

Name	Description	Example
server_backup_agent_ip	대상 서버 Backup Agent IP	11.22.33.44
server_name	Backup Agent 대상 서버명	server-001
server_state	Backup 서버 상태	RUNNING
server_uuid	Backup Agent 대상 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366

2.1.20.2 - 1.0

scpcli backup backup agent target list
--server_category <value>
[--size <value>]
[--page <value>]
[--sort <value>]
[--server_name <value>]

Description

Backup Agent 대상 서버 목록

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
server_category required	string	대상 서버 카테고리	`BAREMETAL_SERVER`
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	정렬 조건	-
server_name optional	string	Backup 서버명	`server-001`

Responses

Name	Description	Example
server_backup_agent_ip	대상 서버 Backup Agent IP	11.22.33.44
server_name	Backup Agent 대상 서버명	server-001
server_state	Backup 서버 상태	RUNNING
server_uuid	Backup Agent 대상 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366

2.1.21 - Manual Backup

2.1.21.1 - 1.1

scpcli backup backup manual backup create
--backup_id <value>

Description

즉시 Backup을 수행한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.21.2 - 1.0

scpcli backup backup manual backup create
--backup_id <value>

Description

즉시 Backup을 수행한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.22 - Restore Agent Backup

2.1.22.1 - 1.1

scpcli backup agent backup restore
--backup_id <value>
--restore_target_id <value>
--restore_server_uuid <value>
--filesystem_paths <value>
[--overwrite <value>]

Description

백업을 복구한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
restore_target_id required	string	복구 대상 목록	`ca1a8e76-af49-40ea-93f8-a5989ffe138b`
restore_server_uuid required	string	복구 서버 ID	`89f5ef44-1021-4a5c-8e06-fbb289eac366`
filesystem_paths required	array	백업 대상 파일 시스템 경로	`'{"destination": "/data", "source": "/data"}'`
overwrite optional	boolean	덮어쓰기	`True`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.22.2 - 1.0

scpcli backup agent backup restore
--backup_id <value>
--restore_target_id <value>
--restore_server_uuid <value>
--filesystem_paths <value>
[--overwrite <value>]

Description

백업을 복구한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
restore_target_id required	string	복구 대상 목록	`ca1a8e76-af49-40ea-93f8-a5989ffe138b`
restore_server_uuid required	string	복구 서버 ID	`89f5ef44-1021-4a5c-8e06-fbb289eac366`
filesystem_paths required	array	백업 대상 파일 시스템 경로	`'{"destination": "/data", "source": "/data"}'`
overwrite optional	boolean	덮어쓰기	`True`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.23 - Restore Backup

2.1.23.1 - 1.1

scpcli backup backup restore
--backup_id <value>
--server_type_id <value>
--restore_target_id <value>
--restore_server_name <value>
[--networks <value>]
[--restore_region <value>]
[--security_groups <value>]

Description

백업을 복구한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
server_type_id required	string	서버 유형 ID	`s1v1m2`
restore_target_id required	string	복구 대상 목록	`ca1a8e76-af49-40ea-93f8-a5989ffe138b`
restore_server_name required	string	복구 서버명	`restoretest1`
networks optional	array	복구용 네트워크 정보	`'{"subnet_id": "023c57b14f11483689338d085e061492"}'`
restore_region optional	string	서버를 복구할 리전	`kr-west1`
security_groups optional	array	Security Group ID 목록	`023c57b14f11483689338d085e061492`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.23.2 - 1.0

scpcli backup backup restore
--backup_id <value>
--server_type_id <value>
--restore_target_id <value>
--restore_server_name <value>
[--networks <value>]
[--restore_region <value>]
[--security_groups <value>]

Description

백업을 복구한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
server_type_id required	string	서버 유형 ID	`s1v1m2`
restore_target_id required	string	복구 대상 목록	`ca1a8e76-af49-40ea-93f8-a5989ffe138b`
restore_server_name required	string	복구 서버명	`restoretest1`
networks optional	array	복구용 네트워크 정보	`'{"subnet_id": "023c57b14f11483689338d085e061492"}'`
restore_region optional	string	서버를 복구할 리전	`kr-west1`
security_groups optional	array	Security Group ID 목록	`023c57b14f11483689338d085e061492`

Responses

Name	Description	Example
request_id	요청 ID
resource	자원

2.1.24 - Set Backup Schedule

2.1.24.1 - 1.1

scpcli backup backup schedule set
--backup_id <value>
--schedules <value>

Description

스케줄 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
schedules required	array	Backup 스케줄 목록	`'{"frequency": "DAILY", "start_day": "MON", "start_time": "09:00:00", "start_week": "WEEK_2", "type": "FULL"}'`

2.1.24.2 - 1.0

scpcli backup backup schedule set
--backup_id <value>
--schedules <value>

Description

스케줄 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
schedules required	array	Backup 스케줄 목록	`'{"frequency": "DAILY", "start_day": "MON", "start_time": "09:00:00", "start_week": "WEEK_2", "type": "FULL"}'`

2.1.25 - Set Filesystem Path

2.1.25.1 - 1.1

scpcli backup backup agent filesystem path set
--backup_id <value>
--backup_filesystem_paths <value>

Description

파일 시스템 경로 설정

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
backup_filesystem_paths required	array	백업 대상 파일 시스템 경로	`/aaa`

2.1.25.2 - 1.0

scpcli backup backup agent filesystem path set
--backup_id <value>
--backup_filesystem_paths <value>

Description

파일 시스템 경로 설정

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
backup_filesystem_paths required	array	백업 대상 파일 시스템 경로	`/aaa`

2.1.26 - Show Backup

2.1.26.1 - 1.1

scpcli backup backup show
--backup_id <value>

Description

Backup을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
backup_agent_id	Backup Agent ID	BACKUP_AGENT-abcd
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
dr_enabled	DR 사용 여부
dr_region	DR Region	kr-west1
encrypt_enabled	암호화 사용 여부	False
filesystem_paths	백업 대상 파일 시스템 경로	[’/aaa’, ‘/bbb’]
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Backup명	backup-001
origin_backup_id	Backup ID	00cd2538fbf94d12b36aabbdd607e974
policy_category	Backup 정책 카테고리	AGENTLESS
policy_type	Backup 정책 유형	VM_IMAGE
region	위치	kr-west1
replica_backup_id	Backup ID	00cd2538fbf94d12b36aabbdd607e974
retention_period	Backup 보관 기간	WEEK_2
role_type	백업 역할 유형	ORIGINAL
server_category	대상 서버 카테고리	VIRTUAL_SERVER
server_name	Backup 서버명	server-001
server_os_type	서버 OS Type	WINDOWS
server_region	위치	kr-west1
server_uuid	Backup 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366
state	Backup 상태	AVAILABLE

2.1.26.2 - 1.0

scpcli backup backup show
--backup_id <value>

Description

Backup을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
backup_agent_id	Backup Agent ID	BACKUP_AGENT-abcd
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
encrypt_enabled	암호화 사용 여부	False
filesystem_paths	백업 대상 파일 시스템 경로	[’/aaa’, ‘/bbb’]
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Backup명	backup-001
policy_category	Backup 정책 카테고리	AGENTLESS
policy_type	Backup 정책 유형	VM_IMAGE
region	위치	kr-west1
retention_period	Backup 보관 기간	WEEK_2
role_type	백업 역할 유형	ORIGINAL
server_category	대상 서버 카테고리	VIRTUAL_SERVER
server_name	Backup 서버명	server-001
server_os_type	서버 OS Type	WINDOWS
server_region	위치	kr-west1
server_uuid	Backup 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366
state	Backup 상태	AVAILABLE

2.1.27 - Show Backup Agent

2.1.27.1 - 1.1

scpcli backup backup agent show
--backup_agent_id <value>

Description

Backup Agent를 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_agent_id required	string	Backup Agent ID	`BACKUP_AGENT-abcd`

Responses

Name	Description	Example
id	Backup Agent ID	BACKUP_AGENT-abcd
account_id	Account ID	fnsd89fus0f9ds09f90dshf9dshfds09
backup_master_ip	Backup Master IP	33.44.55.66
backup_master_name	Backup Master명	backupmastertest
backup_policy_count	Backup 정책 수	3
connection_check_time	Backup Agent 연결 확인 시간	2024-11-11T09:13:48Z
connection_state	Backup Agent 연결 상태	SUCCESS
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
install_file_path	설치 파일 경로	http://linux-agent
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Backup Agent명	agent_abcd12
server_backup_agent_ip	대상 서버 Backup Agent IP	11.22.33.44
server_category	대상 서버 카테고리	VIRTUAL_SERVER
server_gateway_ip	서버 Gateway IP	22.33.44.55
server_name	Backup Agent 대상 서버명	server-001
server_os_type	서버 OS Type	WINDOWS
server_uuid	Backup Agent 대상 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366
state	Backup Agent 상태	AVAILABLE

2.1.27.2 - 1.0

scpcli backup backup agent show
--backup_agent_id <value>

Description

Backup Agent를 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_agent_id required	string	Backup Agent ID	`BACKUP_AGENT-abcd`

Responses

Name	Description	Example
id	Backup Agent ID	BACKUP_AGENT-abcd
account_id	Account ID	fnsd89fus0f9ds09f90dshf9dshfds09
backup_master_ip	Backup Master IP	33.44.55.66
backup_master_name	Backup Master명	backupmastertest
backup_policy_count	Backup 정책 수	3
connection_check_time	Backup Agent 연결 확인 시간	2024-11-11T09:13:48Z
connection_state	Backup Agent 연결 상태	SUCCESS
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
install_file_path	설치 파일 경로	http://linux-agent
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	Backup Agent명	agent_abcd12
server_backup_agent_ip	대상 서버 Backup Agent IP	11.22.33.44
server_category	대상 서버 카테고리	VIRTUAL_SERVER
server_gateway_ip	서버 Gateway IP	22.33.44.55
server_name	Backup Agent 대상 서버명	server-001
server_os_type	서버 OS Type	WINDOWS
server_uuid	Backup Agent 대상 서버 UUID	89f5ef44-1021-4a5c-8e06-fbb289eac366
state	Backup Agent 상태	AVAILABLE

2.1.28 - Show Backup Agent Install File Path

2.1.28.1 - 1.1

scpcli backup backup agent install file path show
--os_type <value>

Description

Backup Agent 설치 파일 경로 조회

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
os_type required	string	OS 유형	-

Responses

Name	Description	Example
install_file_path	설치 파일 경로	http://linux-agent

2.1.28.2 - 1.0

scpcli backup backup agent install file path show
--os_type <value>

Description

Backup Agent 설치 파일 경로 조회

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
os_type required	string	OS 유형	-

Responses

Name	Description	Example
install_file_path	설치 파일 경로	http://linux-agent

2.1.29 - Update Replication Use

2.1.29.1 - 1.1

scpcli backup backup replication use set
--backup_id <value>
--dr_enabled <value>

Description

복제 사용 여부를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
dr_enabled required	boolean	DR 사용 여부	`False`

2.1.29.2 - 1.0

scpcli backup backup replication use set
--backup_id <value>
--dr_enabled <value>

Description

복제 사용 여부를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
dr_enabled required	boolean	DR 사용 여부	`False`

2.1.30 - Update Retention Period

2.1.30.1 - 1.1

scpcli backup backup retention period set
--backup_id <value>
--retention_period <value>

Description

보관 기간을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
retention_period required	string	Backup 보관 기간	`WEEK_2`

2.1.30.2 - 1.0

scpcli backup backup retention period set
--backup_id <value>
--retention_period <value>

Description

보관 기간을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20260331

Parameters

Name	Type	Description	Example
backup_id required	string	Backup ID	`00cd2538fbf94d12b36aabbdd607e974`
retention_period required	string	Backup 보관 기간	`WEEK_2`

3 - Block Storage(BM)

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.

본 가이드는 Block Storage(BM) 서비스에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.

Version

Version	Status	Supported Until
1.0	DEPRECATED	20251231
1.1	DEPRECATED	20260331
1.2	CURRENT	-

3.1 - CLIs

3.1.1 - Add Volume Group Member on Volume Group

3.1.1.1 - 1.2

scpcli baremetal-blockstorage volume-group member add
--volume_group_id <value>
--volume_ids <value>

Description

볼륨 그룹에 볼륨 그룹 멤버를 추가한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
volume_ids required	array	List of volume(Block Storage) id	`13666d6c32d4456e8421f7768d0bf225`

3.1.1.2 - 1.1

scpcli baremetal-blockstorage volume-group member add
--volume_group_id <value>
--volume_ids <value>

Description

볼륨 그룹에 볼륨 그룹 멤버를 추가한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
volume_ids required	array	List of volume(Block Storage) id	`13666d6c32d4456e8421f7768d0bf225`

3.1.1.3 - 1.0

scpcli baremetal-blockstorage volume-group member add
--volume_group_id <value>
--volume_ids <value>

Description

볼륨 그룹에 볼륨 그룹 멤버를 추가한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
volume_ids required	array	List of volume(Block Storage) id	`13666d6c32d4456e8421f7768d0bf225`

3.1.2 - Attach Volume

3.1.2.1 - 1.2

scpcli baremetal-blockstorage volume attachment create
--volume_id <value>
--attachments <value>

Description

서버에 볼륨을 연결한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
attachments required	array	서버 id, 유형 목록	`'{"object_id": "83c3c73d457345e3829ee6d5557c0016", "object_type": "BM"}'`

Responses

Name	Description	Example
object_id	Object id	83c3c73d457345e3829ee6d5557c0016
object_type	Object 유형

3.1.2.2 - 1.1

scpcli baremetal-blockstorage volume attachment create
--volume_id <value>
--attachments <value>

Description

서버에 볼륨을 연결한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
attachments required	array	서버 id, 유형 목록	`'{"object_id": "83c3c73d457345e3829ee6d5557c0016", "object_type": "BM"}'`

Responses

Name	Description	Example
result	볼륨 상세 정보

3.1.2.3 - 1.0

scpcli baremetal-blockstorage volume attachment create
--volume_id <value>
--attachments <value>

Description

서버에 볼륨을 연결한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
attachments required	array	서버 id, 유형 목록	`'{"object_id": "83c3c73d457345e3829ee6d5557c0016", "object_type": "BM"}'`

Responses

Name	Description	Example
result	볼륨 상세 정보

3.1.3 - Create Volume

3.1.3.1 - 1.2

scpcli baremetal-blockstorage volume create
--throughput <value>
--iops <value>
--size_gb <value>
--name <value>
--disk_type <value>
--attachments <value>
[--tags <value>]

Description

볼륨을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
throughput required	integer	Enter the value between at least 125MB/s and up to 1,000MB/s.	`125`
iops required	integer	Enter the value between at least 3,000 IOPS and up to 16,000 IOPS.	`3000`
size_gb required	integer	Volume capacity(GB)	`10`
name required	string	볼륨명	`bs-01`
disk_type required	string	디스크 유형	-
attachments required	array	서버 id, 유형 목록	`'{"object_id": "83c3c73d457345e3829ee6d5557c0016", "object_type": "BM"}'`
tags optional	array	태그	`'{"key": "my_tag_1", "value": "my_value_1"}'`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.3.2 - 1.1

scpcli baremetal-blockstorage volume create
--size_gb <value>
--name <value>
--disk_type <value>
--attachments <value>
[--tags <value>]

Description

볼륨을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
size_gb required	integer	Volume capacity(GB)	`10`
name required	string	볼륨명	`bs-01`
disk_type required	string	디스크 유형	-
attachments required	array	서버 id, 유형 목록	`'{"object_id": "83c3c73d457345e3829ee6d5557c0016", "object_type": "BM"}'`
tags optional	array	태그	`'{"key": "my_tag_1", "value": "my_value_1"}'`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.3.3 - 1.0

scpcli baremetal-blockstorage volume create
--size_gb <value>
--name <value>
--disk_type <value>
--attachments <value>
[--tags <value>]

Description

볼륨을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
size_gb required	integer	Volume capacity(GB)	`10`
name required	string	볼륨명	`bs-01`
disk_type required	string	디스크 유형	-
attachments required	array	서버 id, 유형 목록	`'{"object_id": "83c3c73d457345e3829ee6d5557c0016", "object_type": "BM"}'`
tags optional	array	태그	`'{"key": "my_tag_1", "value": "my_value_1"}'`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.4 - Create Volume Group

3.1.4.1 - 1.2

scpcli baremetal-blockstorage volume-group create
--volume_ids <value>
--name <value>
[--tags <value>]

Description

볼륨 그룹을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_ids required	array	List of volume(Block Storage) id to add	`17e0b4fd27784dfb843440ec08bdd148`
name required	string	볼륨 그룹명	`vg-01`
tags optional	array	태그	`'{"key": "my_tag_1", "value": "my_value_1"}'`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.4.2 - 1.1

scpcli baremetal-blockstorage volume-group create
--volume_ids <value>
--name <value>
[--tags <value>]

Description

볼륨 그룹을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_ids required	array	List of volume(Block Storage) id to add	`17e0b4fd27784dfb843440ec08bdd148`
name required	string	볼륨 그룹명	`vg-01`
tags optional	array	태그	`'{"key": "my_tag_1", "value": "my_value_1"}'`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.4.3 - 1.0

scpcli baremetal-blockstorage volume-group create
--volume_ids <value>
--name <value>
[--tags <value>]

Description

볼륨 그룹을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_ids required	array	List of volume(Block Storage) id to add	`17e0b4fd27784dfb843440ec08bdd148`
name required	string	볼륨 그룹명	`vg-01`
tags optional	array	태그	`'{"key": "my_tag_1", "value": "my_value_1"}'`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.5 - Create Volume Group Recovery

3.1.5.1 - 1.2

scpcli baremetal-blockstorage volume-group recovery create
--volume_group_id <value>
--snapshot_id <value>
--block_storage_name_prefix <value>

Description

복구본 볼륨 그룹을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
block_storage_name_prefix required	string	Block Storage명 접두사	`prefix-`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.5.2 - 1.1

scpcli baremetal-blockstorage volume-group recovery create
--volume_group_id <value>
--snapshot_id <value>
--block_storage_name_prefix <value>

Description

복구본 볼륨 그룹을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
block_storage_name_prefix required	string	Block Storage명 접두사	`prefix-`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.6 - Create Volume Group Replication

3.1.6.1 - 1.2

scpcli baremetal-blockstorage volume-group replication create
--volume_group_id <value>
--replication_volume_name_prefix <value>
--region <value>
--name <value>
--cycle <value>

Description

복제본 볼륨 그룹을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
replication_volume_name_prefix required	string	복제본 볼륨명 접두사	`dr`
region required	string	리전	`kr-west1`
name required	string	복제본 볼륨 그룹명	`replica-vg-01`
cycle required	string	복제 주기	-

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.6.2 - 1.1

scpcli baremetal-blockstorage volume-group replication create
--volume_group_id <value>
--replication_volume_name_prefix <value>
--region <value>
--name <value>
--cycle <value>

Description

복제본 볼륨 그룹을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
replication_volume_name_prefix required	string	복제본 볼륨명 접두사	`dr`
region required	string	리전	`kr-west1`
name required	string	복제본 볼륨 그룹명	`replica-vg-01`
cycle required	string	복제 주기	-

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.6.3 - 1.0

scpcli baremetal-blockstorage volume-group replication create
--volume_group_id <value>
--replication_volume_name_prefix <value>
--region <value>
--name <value>
--cycle <value>

Description

복제본 볼륨 그룹을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
replication_volume_name_prefix required	string	복제본 볼륨명 접두사	`dr`
region required	string	리전	`kr-west1`
name required	string	복제본 볼륨 그룹명	`replica-vg-01`
cycle required	string	복제 주기	-

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.7 - Create Volume Group Snapshot

3.1.7.1 - 1.2

scpcli baremetal-blockstorage volume-group snapshot create
--volume_group_id <value>

Description

볼륨 그룹 스냅샷을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
volume_group_id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063

3.1.7.2 - 1.1

scpcli baremetal-blockstorage volume-group snapshot create
--volume_group_id <value>

Description

볼륨 그룹 스냅샷을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
volume_group_id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063

3.1.7.3 - 1.0

scpcli baremetal-blockstorage volume-group snapshot create
--volume_group_id <value>

Description

볼륨 그룹 스냅샷을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
volume_group_id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063

3.1.8 - Create Volume Group Snapshot Schedule

3.1.8.1 - 1.2

scpcli baremetal-blockstorage volume-group snapshot-schedule create
--volume_group_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 그룹 스냅샷 스케줄을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

Responses

Name	Description	Example
day_of_week	요일
frequency	주기 DAILY	WEEKLY
hour	시간	18
volume_group_id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063

3.1.8.2 - 1.1

scpcli baremetal-blockstorage volume-group snapshot-schedule create
--volume_group_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 그룹 스냅샷 스케줄을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

Responses

Name	Description	Example
day_of_week	요일
frequency	주기 DAILY	WEEKLY
hour	시간	18
volume_group_id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063

3.1.8.3 - 1.0

scpcli baremetal-blockstorage volume-group snapshot-schedule create
--volume_group_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 그룹 스냅샷 스케줄을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

Responses

Name	Description	Example
day_of_week	요일
frequency	주기 DAILY	WEEKLY
hour	시간	18
volume_group_id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063

3.1.9 - Create Volume Recovery

3.1.9.1 - 1.2

scpcli baremetal-blockstorage volume recovery create
--volume_id <value>
--snapshot_id <value>
--name <value>

Description

복구본 볼륨을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
name required	string	복구 볼륨명	`recovery-volume`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.9.2 - 1.1

scpcli baremetal-blockstorage volume recovery create
--volume_id <value>
--snapshot_id <value>
--name <value>

Description

복구본 볼륨을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
name required	string	복구 볼륨명	`recovery-volume`

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.10 - Create Volume Replication

3.1.10.1 - 1.2

scpcli baremetal-blockstorage volume replication create
--volume_id <value>
--region <value>
--name <value>
--cycle <value>

Description

복제본 볼륨을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
region required	string	리전	`kr-west1`
name required	string	복제본 볼륨 목록	`replica-bs-01`
cycle required	string	복제 주기	-

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.10.2 - 1.1

scpcli baremetal-blockstorage volume replication create
--volume_id <value>
--region <value>
--name <value>
--cycle <value>

Description

복제본 볼륨을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
region required	string	리전	`kr-west1`
name required	string	복제본 볼륨 목록	`replica-bs-01`
cycle required	string	복제 주기	-

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.10.3 - 1.0

scpcli baremetal-blockstorage volume replication create
--volume_id <value>
--region <value>
--name <value>
--cycle <value>

Description

복제본 볼륨을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
region required	string	리전	`kr-west1`
name required	string	복제본 볼륨 목록	`replica-bs-01`
cycle required	string	복제 주기	-

Responses

Name	Description	Example
request_id	요청 id	req-0006064c-c008-458c-8977-19671c6b32d4
resource_id	자원 id	8bf55e738d4e44b5a21dbe133a42ecbe

3.1.11 - Create Volume Snapshot

3.1.11.1 - 1.2

scpcli baremetal-blockstorage volume snapshot create
--volume_id <value>

Description

볼륨 스냅샷을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.11.2 - 1.1

scpcli baremetal-blockstorage volume snapshot create
--volume_id <value>

Description

볼륨 스냅샷을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.11.3 - 1.0

scpcli baremetal-blockstorage volume snapshot create
--volume_id <value>

Description

볼륨 스냅샷을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.12 - Create Volume Snapshot Rate

3.1.12.1 - 1.2

scpcli baremetal-blockstorage volume snapshot-rate create
--volume_id <value>
--snapshot_rate <value>

Description

볼륨 스냅샷 용량을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
snapshot_rate required	integer	스냅샷 용량	`100`

Responses

Name	Description	Example
is_snapshot_activated	스냅샷 활성화 여부	True
snapshot_rate	스냅샷 용량	100
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.12.2 - 1.1

scpcli baremetal-blockstorage volume snapshot-rate create
--volume_id <value>
--snapshot_rate <value>

Description

볼륨 스냅샷 용량을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
snapshot_rate required	integer	스냅샷 용량	`100`

Responses

Name	Description	Example
is_snapshot_activated	스냅샷 활성화 여부	True
snapshot_rate	스냅샷 용량	100
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.12.3 - 1.0

scpcli baremetal-blockstorage volume snapshot-rate create
--volume_id <value>
--snapshot_rate <value>

Description

볼륨 스냅샷 용량을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
snapshot_rate required	integer	스냅샷 용량	`100`

Responses

Name	Description	Example
is_snapshot_activated	스냅샷 활성화 여부	True
snapshot_rate	스냅샷 용량	100
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.13 - Create Volume Snapshot Schedule

3.1.13.1 - 1.2

scpcli baremetal-blockstorage volume snapshot-schedule create
--volume_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 스냅샷 스케줄을 생성한다

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

Responses

Name	Description	Example
day_of_week	요일
frequency	주기 DAILY	WEEKLY
hour	시간	18
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.13.2 - 1.1

scpcli baremetal-blockstorage volume snapshot-schedule create
--volume_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 스냅샷 스케줄을 생성한다

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

Responses

Name	Description	Example
day_of_week	요일
frequency	주기 DAILY	WEEKLY
hour	시간	18
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.13.3 - 1.0

scpcli baremetal-blockstorage volume snapshot-schedule create
--volume_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 스냅샷 스케줄을 생성한다

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

Responses

Name	Description	Example
day_of_week	요일
frequency	주기 DAILY	WEEKLY
hour	시간	18
volume_id	볼륨 id	92cd16fe8ebc4f73832513a172bf0000

3.1.14 - Delete Volume

3.1.14.1 - 1.2

scpcli baremetal-blockstorage volume delete
--volume_id <value>

Description

볼륨을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.14.2 - 1.1

scpcli baremetal-blockstorage volume delete
--volume_id <value>

Description

볼륨을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.14.3 - 1.0

scpcli baremetal-blockstorage volume delete
--volume_id <value>

Description

볼륨을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.15 - Delete Volume Group Replication

3.1.15.1 - 1.2

scpcli baremetal-blockstorage volume-group replication delete
--volume_group_id <value>

Description

복제본 볼륨 그룹을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.15.2 - 1.1

scpcli baremetal-blockstorage volume-group replication delete
--volume_group_id <value>

Description

복제본 볼륨 그룹을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.15.3 - 1.0

scpcli baremetal-blockstorage volume-group replication delete
--volume_group_id <value>

Description

복제본 볼륨 그룹을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.16 - Delete Volume Group Snapshot

3.1.16.1 - 1.2

scpcli baremetal-blockstorage volume-group snapshot delete
--snapshot_id <value>
--volume_group_id <value>

Description

볼륩 그룹 스냅샷을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.16.2 - 1.1

scpcli baremetal-blockstorage volume-group snapshot delete
--snapshot_id <value>
--volume_group_id <value>

Description

볼륩 그룹 스냅샷을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.16.3 - 1.0

scpcli baremetal-blockstorage volume-group snapshot delete
--snapshot_id <value>
--volume_group_id <value>

Description

볼륩 그룹 스냅샷을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.17 - Delete Volume Group Snapshot Schedule

3.1.17.1 - 1.2

scpcli baremetal-blockstorage volume-group snapshot-schedule delete
--volume_group_id <value>

Description

볼륨 그룹 스냅샷 스케줄을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.17.2 - 1.1

scpcli baremetal-blockstorage volume-group snapshot-schedule delete
--volume_group_id <value>

Description

볼륨 그룹 스냅샷 스케줄을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.17.3 - 1.0

scpcli baremetal-blockstorage volume-group snapshot-schedule delete
--volume_group_id <value>

Description

볼륨 그룹 스냅샷 스케줄을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.18 - Delete Volume Replication

3.1.18.1 - 1.2

scpcli baremetal-blockstorage volume replication delete
--volume_id <value>

Description

복제본 볼륨을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.18.2 - 1.1

scpcli baremetal-blockstorage volume replication delete
--volume_id <value>

Description

복제본 볼륨을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.18.3 - 1.0

scpcli baremetal-blockstorage volume replication delete
--volume_id <value>

Description

복제본 볼륨을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.19 - Delete Volume Snapshot

3.1.19.1 - 1.2

scpcli baremetal-blockstorage volume snapshot delete
--snapshot_id <value>
--volume_id <value>

Description

볼륨 스냅샷을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.19.2 - 1.1

scpcli baremetal-blockstorage volume snapshot delete
--snapshot_id <value>
--volume_id <value>

Description

볼륨 스냅샷을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.19.3 - 1.0

scpcli baremetal-blockstorage volume snapshot delete
--snapshot_id <value>
--volume_id <value>

Description

볼륨 스냅샷을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.20 - Delete Volume Snapshot Rate

3.1.20.1 - 1.2

scpcli baremetal-blockstorage volume snapshot-rate delete
--volume_id <value>

Description

볼륨 스냅샷 용량을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.20.2 - 1.1

scpcli baremetal-blockstorage volume snapshot-rate delete
--volume_id <value>

Description

볼륨 스냅샷 용량을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.20.3 - 1.0

scpcli baremetal-blockstorage volume snapshot-rate delete
--volume_id <value>

Description

볼륨 스냅샷 용량을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.21 - Delete Volume Snapshot Schedule

3.1.21.1 - 1.2

scpcli baremetal-blockstorage volume snapshot-schedule delete
--volume_id <value>

Description

볼륨 스냅샷 스케줄을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.21.2 - 1.1

scpcli baremetal-blockstorage volume snapshot-schedule delete
--volume_id <value>

Description

볼륨 스냅샷 스케줄을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.21.3 - 1.0

scpcli baremetal-blockstorage volume snapshot-schedule delete
--volume_id <value>

Description

볼륨 스냅샷 스케줄을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.22 - Detach Volume

3.1.22.1 - 1.2

scpcli baremetal-blockstorage volume attachment delete
--volume_id <value>
--attachments <value>

Description

서버에 연결된 볼륨을 분리한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
attachments required	array	연결해지 object id 목록	-

3.1.22.2 - 1.1

scpcli baremetal-blockstorage volume attachment delete
--volume_id <value>
--attachments <value>

Description

서버에 연결된 볼륨을 분리한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
attachments required	array	연결해지 object id 목록	-

3.1.22.3 - 1.0

scpcli baremetal-blockstorage volume attachment delete
--volume_id <value>
--attachments <value>

Description

서버에 연결된 볼륨을 분리한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
attachments required	array	연결해지 object id 목록	-

3.1.23 - List Volume Group Snapshots

3.1.23.1 - 1.2

scpcli baremetal-blockstorage volume-group snapshot list
--volume_group_id <value>

Description

볼륨 그룹 스냅샷의 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
created_dt	생성일시	2024-08-01T07:07:23.315Z
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932

3.1.23.2 - 1.1

scpcli baremetal-blockstorage volume-group snapshot list
--volume_group_id <value>

Description

볼륨 그룹 스냅샷의 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
created_dt	생성일시	2024-08-01T07:07:23.315Z
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932

3.1.23.3 - 1.0

scpcli baremetal-blockstorage volume-group snapshot list
--volume_group_id <value>

Description

볼륨 그룹 스냅샷의 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
created_dt	생성일시	2024-08-01T07:07:23.315Z
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932

3.1.24 - List Volume Groups

3.1.24.1 - 1.2

scpcli baremetal-blockstorage volume-group list
[--limit <value>]
[--offset <value>]
[--sort <value>]
[--name <value>]

Description

볼륨 그룹 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
limit optional	integer	페이지에 표시될 번호	`20`
offset optional	integer	Offset	`0`
sort optional	string	정렬	`column1:asc,column2:desc`
name optional	string	볼륨 그룹명	`vg-01`

Responses

Name	Description	Example
id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
created_at	생성일시	2024-08-01T07:06:23.315Z
created_by	생성자	samsung-cloud-platform1@samsung.com
modified_at	수정일시	2024-08-01T07:06:25.315Z
modified_by	수정자	samsung-cloud-platform2@samsung.com
name	볼륨 그룹명	vg-01
num_of_block_storages	볼륨 수	2
purpose	볼륨 그룹 구분	ORG
state	현재 상태

3.1.24.2 - 1.1

scpcli baremetal-blockstorage volume-group list
[--limit <value>]
[--offset <value>]
[--sort <value>]
[--name <value>]

Description

볼륨 그룹 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
limit optional	integer	페이지에 표시될 번호	`20`
offset optional	integer	Offset	`0`
sort optional	string	정렬	`column1:asc,column2:desc`
name optional	string	볼륨 그룹명	`vg-01`

Responses

Name	Description	Example
id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
created_at	생성일시	2024-08-01T07:06:23.315Z
created_by	생성자	samsung-cloud-platform1@samsung.com
modified_at	수정일시	2024-08-01T07:06:25.315Z
modified_by	수정자	samsung-cloud-platform2@samsung.com
name	볼륨 그룹명	vg-01
num_of_block_storages	볼륨 수	2
purpose	볼륨 그룹 구분	ORG
state	현재 상태

3.1.24.3 - 1.0

scpcli baremetal-blockstorage volume-group list
[--limit <value>]
[--offset <value>]
[--sort <value>]
[--name <value>]

Description

볼륨 그룹 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
limit optional	integer	페이지에 표시될 번호	`20`
offset optional	integer	Offset	`0`
sort optional	string	정렬	`column1:asc,column2:desc`
name optional	string	볼륨 그룹명	`vg-01`

Responses

Name	Description	Example
id	볼륨 그룹 id	c9ecae8b973b425c81c3817893cd8063
account_id	계정 id	36827d9b643f46c2ae6bb7e63d633bfe
created_at	생성일시	2024-08-01T07:06:23.315Z
created_by	생성자	samsung-cloud-platform1@samsung.com
modified_at	수정일시	2024-08-01T07:06:25.315Z
modified_by	수정자	samsung-cloud-platform2@samsung.com
name	볼륨 그룹명	vg-01
num_of_block_storages	볼륨 수	2
purpose	볼륨 그룹 구분	ORG
state	현재 상태

3.1.25 - List Volume Snapshots

3.1.25.1 - 1.2

scpcli baremetal-blockstorage volume snapshot list
--volume_id <value>

Description

볼륨 스냅샷 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
created_dt	생성일시	2024-08-01T07:07:23.315Z
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
snapshot_size_mb	스냅샷 크기(MB)	0

3.1.25.2 - 1.1

scpcli baremetal-blockstorage volume snapshot list
--volume_id <value>

Description

볼륨 스냅샷 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
created_dt	생성일시	2024-08-01T07:07:23.315Z
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
snapshot_size_mb	스냅샷 크기(MB)	0

3.1.25.3 - 1.0

scpcli baremetal-blockstorage volume snapshot list
--volume_id <value>

Description

볼륨 스냅샷 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
created_dt	생성일시	2024-08-01T07:07:23.315Z
snapshot_id	스냅샷 id	05600123-6e78-11f0-a3f0-d039eab8d501
snapshot_name	스냅샷 이름	vo240812063154d4a6abf418e___snapshot-create-bm-blockstorage.2024-08-13_141932
snapshot_size_mb	스냅샷 크기(MB)	0

3.1.26 - List Volumes

3.1.26.1 - 1.2

scpcli baremetal-blockstorage volume list
[--limit <value>]
[--offset <value>]
[--sort <value>]
[--name <value>]
[--object_name <value>]
[--volume_group_name <value>]

Description

볼륨 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
limit optional	integer	페이지에 표시될 번호	`20`
offset optional	integer	Offset	`0`
sort optional	string	정렬	`column1:asc,column2:desc`
name optional	string	볼륨명	`bs-01`
object_name optional	string	연결 서버명	`baremetal-server-name`
volume_group_name optional	string	볼륨 그룹명	`vg-01`

Responses

Name	Description	Example
id	id	7239779c01e3405f82bb71c7f4b55fcd
attachments	연결 서버	[{‘id’: ‘d7682135392e42489948c189e29011cc’, ’name’: ‘baremetal-01’}]
created_at	생성일시
created_by	생성자	samsung-cloud-platform1@samsung.com
disk_type	디스크 유형
has_relation	관계 존재 여부	False
is_in_volume_group	볼륨 그룹 소속 여부	False
is_snapshot_activated	스냅샷 활성화 여부	True
iscsi_target_ips	iscsi ip 목록	{‘description’: ‘List of iscsi ips’, ’example’: [‘172.30.4.3’, ‘172.30.4.4’]}
modified_at	수정일시
modified_by	수정자	samsung-cloud-platform2@samsung.com
name	볼륨명	bs-01
purpose	볼륨 구분
size_gb	볼륨 용량(GB)	10
state	현재 상태
volume_group	볼륨 그룹

3.1.26.2 - 1.1

scpcli baremetal-blockstorage volume list
[--limit <value>]
[--offset <value>]
[--sort <value>]
[--name <value>]
[--object_name <value>]
[--volume_group_name <value>]

Description

볼륨 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
limit optional	integer	페이지에 표시될 번호	`20`
offset optional	integer	Offset	`0`
sort optional	string	정렬	`column1:asc,column2:desc`
name optional	string	볼륨명	`bs-01`
object_name optional	string	연결 서버명	`baremetal-server-name`
volume_group_name optional	string	볼륨 그룹명	`vg-01`

Responses

Name	Description	Example
id	id	7239779c01e3405f82bb71c7f4b55fcd
attachments	연결 서버	[{‘id’: ‘d7682135392e42489948c189e29011cc’, ’name’: ‘baremetal-01’}]
created_at	생성일시
created_by	생성자	samsung-cloud-platform1@samsung.com
disk_type	디스크 유형
has_relation	관계 존재 여부	False
is_in_volume_group	볼륨 그룹 소속 여부	False
is_snapshot_activated	스냅샷 활성화 여부	True
iscsi_target_ips	iscsi ip 목록	{‘description’: ‘List of iscsi ips’, ’example’: [‘172.30.4.3’, ‘172.30.4.4’]}
modified_at	수정일시
modified_by	수정자	samsung-cloud-platform2@samsung.com
name	볼륨명	bs-01
purpose	볼륨 구분
size_gb	볼륨 용량(GB)	10
state	현재 상태
volume_group	볼륨 그룹

3.1.26.3 - 1.0

scpcli baremetal-blockstorage volume list
[--limit <value>]
[--offset <value>]
[--sort <value>]
[--name <value>]
[--object_name <value>]
[--volume_group_name <value>]

Description

볼륨 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
limit optional	integer	페이지에 표시될 번호	`20`
offset optional	integer	Offset	`0`
sort optional	string	정렬	`column1:asc,column2:desc`
name optional	string	볼륨명	`bs-01`
object_name optional	string	연결 서버명	`baremetal-server-name`
volume_group_name optional	string	볼륨 그룹명	`vg-01`

Responses

Name	Description	Example
id	id	7239779c01e3405f82bb71c7f4b55fcd
attachments	연결 서버	[{‘id’: ‘d7682135392e42489948c189e29011cc’, ’name’: ‘baremetal-01’}]
created_at	생성일시
created_by	생성자	samsung-cloud-platform1@samsung.com
disk_type	디스크 유형
has_relation	관계 존재 여부	False
is_in_volume_group	볼륨 그룹 소속 여부	False
is_snapshot_activated	스냅샷 활성화 여부	True
iscsi_target_ips	iscsi ip 목록	{‘description’: ‘List of iscsi ips’, ’example’: [‘172.30.4.3’, ‘172.30.4.4’]}
modified_at	수정일시
modified_by	수정자	samsung-cloud-platform2@samsung.com
name	볼륨명	bs-01
purpose	볼륨 구분
size_gb	볼륨 용량(GB)	10
state	현재 상태
volume_group	볼륨 그룹

3.1.27 - Remove Volume Group Member on Volume Group

3.1.27.1 - 1.2

scpcli baremetal-blockstorage volume-group member remove
--volume_group_id <value>
--volume_ids <value>

Description

볼륨 그룹에서 볼륨 그룹 멤버를 제거한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
volume_ids required	array	List of volume(Block Storage) id	`13666d6c32d4456e8421f7768d0bf225`

3.1.27.2 - 1.1

scpcli baremetal-blockstorage volume-group member remove
--volume_group_id <value>
--volume_ids <value>

Description

볼륨 그룹에서 볼륨 그룹 멤버를 제거한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
volume_ids required	array	List of volume(Block Storage) id	`13666d6c32d4456e8421f7768d0bf225`

3.1.27.3 - 1.0

scpcli baremetal-blockstorage volume-group member remove
--volume_group_id <value>
--volume_ids <value>

Description

볼륨 그룹에서 볼륨 그룹 멤버를 제거한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
volume_ids required	array	List of volume(Block Storage) id	`13666d6c32d4456e8421f7768d0bf225`

3.1.28 - Restore Volume Group Snapshot

3.1.28.1 - 1.2

scpcli baremetal-blockstorage volume-group snapshot restore
--snapshot_id <value>
--volume_group_id <value>

Description

볼륨 그룹 스냅샷을 복원한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.28.2 - 1.1

scpcli baremetal-blockstorage volume-group snapshot restore
--snapshot_id <value>
--volume_group_id <value>

Description

볼륨 그룹 스냅샷을 복원한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.28.3 - 1.0

scpcli baremetal-blockstorage volume-group snapshot restore
--snapshot_id <value>
--volume_group_id <value>

Description

볼륨 그룹 스냅샷을 복원한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

3.1.29 - Restore Volume Snapshot

3.1.29.1 - 1.2

scpcli baremetal-blockstorage volume snapshot restore
--snapshot_id <value>
--volume_id <value>

Description

스냅샷에서 볼륨을 복원한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.29.2 - 1.1

scpcli baremetal-blockstorage volume snapshot restore
--snapshot_id <value>
--volume_id <value>

Description

스냅샷에서 볼륨을 복원한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.29.3 - 1.0

scpcli baremetal-blockstorage volume snapshot restore
--snapshot_id <value>
--volume_id <value>

Description

스냅샷에서 볼륨을 복원한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 id	`05600123-6e78-11f0-a3f0-d039eab8d501`
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

3.1.30 - Set Volume Group Replication Cycle

3.1.30.1 - 1.2

scpcli baremetal-blockstorage volume-group replication-cycle set
--volume_group_id <value>
--cycle <value>

Description

볼륨 그룹 복제 주기를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
cycle required	string	복제 주기	-

3.1.30.2 - 1.1

scpcli baremetal-blockstorage volume-group replication-cycle set
--volume_group_id <value>
--cycle <value>

Description

볼륨 그룹 복제 주기를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
cycle required	string	복제 주기	-

3.1.30.3 - 1.0

scpcli baremetal-blockstorage volume-group replication-cycle set
--volume_group_id <value>
--cycle <value>

Description

볼륨 그룹 복제 주기를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
cycle required	string	복제 주기	-

3.1.31 - Set Volume Group Replication Policy

3.1.31.1 - 1.2

scpcli baremetal-blockstorage volume-group replication-policy set
--volume_group_id <value>
--policy <value>

Description

볼륨 그룹 복제 정책을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
policy required	string	정책	-

3.1.31.2 - 1.1

scpcli baremetal-blockstorage volume-group replication-policy set
--volume_group_id <value>
--policy <value>

Description

볼륨 그룹 복제 정책을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
policy required	string	정책	-

3.1.31.3 - 1.0

scpcli baremetal-blockstorage volume-group replication-policy set
--volume_group_id <value>
--policy <value>

Description

볼륨 그룹 복제 정책을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
policy required	string	정책	-

3.1.32 - Set Volume Group Snapshot Schedule

3.1.32.1 - 1.2

scpcli baremetal-blockstorage volume-group snapshot-schedule set
--volume_group_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 그룹 스냅샷 스케줄을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

3.1.32.2 - 1.1

scpcli baremetal-blockstorage volume-group snapshot-schedule set
--volume_group_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 그룹 스냅샷 스케줄을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

3.1.32.3 - 1.0

scpcli baremetal-blockstorage volume-group snapshot-schedule set
--volume_group_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 그룹 스냅샷 스케줄을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

3.1.33 - Set Volume QoS

3.1.33.1 - 1.2

scpcli baremetal-blockstorage volume qos set
--volume_id <value>
[--iops <value>]
[--throughput <value>]

Description

볼륨 QoS를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
iops optional	integer	IOPS. If omitted, the existing value will be retained.	`3000`
throughput optional	integer	Throughput. If omitted, the existing value will be retained.	`125`

3.1.34 - Set Volume Replication Cycle

3.1.34.1 - 1.2

scpcli baremetal-blockstorage volume replication-cycle set
--volume_id <value>
--cycle <value>

Description

복제본 볼륨 주기를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
cycle required	string	복제 주기	`5MIN`

3.1.34.2 - 1.1

scpcli baremetal-blockstorage volume replication-cycle set
--volume_id <value>
--cycle <value>

Description

복제본 볼륨 주기를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
cycle required	string	복제 주기	`5MIN`

3.1.34.3 - 1.0

scpcli baremetal-blockstorage volume replication-cycle set
--volume_id <value>
--cycle <value>

Description

복제본 볼륨 주기를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
cycle required	string	복제 주기	`5MIN`

3.1.35 - Set Volume Replication Policy

3.1.35.1 - 1.2

scpcli baremetal-blockstorage volume replication-policy set
--volume_id <value>
--policy <value>

Description

복제본 볼륨 정책을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
policy required	string	정책	-

3.1.35.2 - 1.1

scpcli baremetal-blockstorage volume replication-policy set
--volume_id <value>
--policy <value>

Description

복제본 볼륨 정책을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
policy required	string	정책	-

3.1.35.3 - 1.0

scpcli baremetal-blockstorage volume replication-policy set
--volume_id <value>
--policy <value>

Description

복제본 볼륨 정책을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
policy required	string	정책	-

3.1.36 - Set Volume Snapshot Rate

3.1.36.1 - 1.2

scpcli baremetal-blockstorage volume snapshot-rate set
--volume_id <value>
--snapshot_rate <value>

Description

볼륨 스냅샷 용량을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
snapshot_rate required	integer	스냅샷 용량	`100`

3.1.36.2 - 1.1

scpcli baremetal-blockstorage volume snapshot-rate set
--volume_id <value>
--snapshot_rate <value>

Description

볼륨 스냅샷 용량을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
snapshot_rate required	integer	스냅샷 용량	`100`

3.1.36.3 - 1.0

scpcli baremetal-blockstorage volume snapshot-rate set
--volume_id <value>
--snapshot_rate <value>

Description

볼륨 스냅샷 용량을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
snapshot_rate required	integer	스냅샷 용량	`100`

3.1.37 - Set Volume Snapshot Schedule

3.1.37.1 - 1.2

scpcli baremetal-blockstorage volume snapshot-schedule set
--volume_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 스냅샷 스케줄을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

3.1.37.2 - 1.1

scpcli baremetal-blockstorage volume snapshot-schedule set
--volume_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 스냅샷 스케줄을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

3.1.37.3 - 1.0

scpcli baremetal-blockstorage volume snapshot-schedule set
--volume_id <value>
--hour <value>
[--day_of_week <value>]

Description

볼륨 스냅샷 스케줄을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`
hour required	integer	시간	`18`
day_of_week optional	string	Day of week(If this field is excluded, the schedule frequency is set to DAILY.)	-

3.1.38 - Show Volume

3.1.38.1 - 1.2

scpcli baremetal-blockstorage volume show
--volume_id <value>

Description

볼륨을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
result	볼륨 상세 정보

3.1.38.2 - 1.1

scpcli baremetal-blockstorage volume show
--volume_id <value>

Description

볼륨을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
result	볼륨 상세 정보

3.1.38.3 - 1.0

scpcli baremetal-blockstorage volume show
--volume_id <value>

Description

볼륨을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
result	볼륨 상세 정보

3.1.39 - Show Volume Group

3.1.39.1 - 1.2

scpcli baremetal-blockstorage volume-group show
--volume_group_id <value>

Description

볼륨 그룹을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
result	볼륨 그룹 상세 정보

3.1.39.2 - 1.1

scpcli baremetal-blockstorage volume-group show
--volume_group_id <value>

Description

볼륨 그룹을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
result	볼륨 그룹 상세 정보

3.1.39.3 - 1.0

scpcli baremetal-blockstorage volume-group show
--volume_group_id <value>

Description

볼륨 그룹을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
result	볼륨 그룹 상세 정보

3.1.40 - Show Volume Group Replication

3.1.40.1 - 1.2

scpcli baremetal-blockstorage volume-group replication show
--volume_group_id <value>

Description

복제본 볼륨 그룹을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
result	볼륨 그룹 복제 정보

3.1.40.2 - 1.1

scpcli baremetal-blockstorage volume-group replication show
--volume_group_id <value>

Description

복제본 볼륨 그룹을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
result	볼륨 그룹 복제 정보

3.1.40.3 - 1.0

scpcli baremetal-blockstorage volume-group replication show
--volume_group_id <value>

Description

복제본 볼륨 그룹을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_group_id required	string	볼륨 그룹 id	`c9ecae8b973b425c81c3817893cd8063`

Responses

Name	Description	Example
result	볼륨 그룹 복제 정보

3.1.41 - Show Volume Replication

3.1.41.1 - 1.2

scpcli baremetal-blockstorage volume replication show
--volume_id <value>

Description

복제본 볼륨을 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.2	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
result	볼륨 복제 정보

3.1.41.2 - 1.1

scpcli baremetal-blockstorage volume replication show
--volume_id <value>

Description

복제본 볼륨을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.1	20260331

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
result	볼륨 복제 정보

3.1.41.3 - 1.0

scpcli baremetal-blockstorage volume replication show
--volume_id <value>

Description

복제본 볼륨을 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 id	`92cd16fe8ebc4f73832513a172bf0000`

Responses

Name	Description	Example
result	볼륨 복제 정보

4 - File Storage

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.

본 가이드는 File Storage 서비스에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.

Version

Version	Status	Supported Until
1.0	DEPRECATED	20251231
1.1	CURRENT	-

4.1 - CLIs

4.1.1 - CreateSnapshot

4.1.1.1 - 1.1

scpcli filestorage volume snapshot create
--volume_id <value>

Description

파일스토리지 스냅샷을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	스냅샷 아이디	40htrre5b-eww25-ff2b-a426-6afefas65a3b
name	스냅샷 이름	my_volume.2024-10-01_14215
state	스냅샷 상태	available
size	스냅샷 크기	100
created_at	생성 시간	2024-07-30T04:54:33.219373
volume_id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438

4.1.1.2 - 1.0

scpcli filestorage volume snapshot create
--volume_id <value>

Description

파일스토리지 스냅샷을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	스냅샷 아이디	40htrre5b-eww25-ff2b-a426-6afefas65a3b
name	스냅샷 이름	my_volume.2024-10-01_14215
state	스냅샷 상태	available
size	스냅샷 크기	100
created_at	생성 시간	2024-07-30T04:54:33.219373
volume_id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438

4.1.2 - CreateSnapshotSchedule

4.1.2.1 - 1.1

scpcli filestorage volume snapshot schedule create
--hour <value>
--frequency <value>
--volume_id <value>
[--snapshot_retention_count <value>]
[--day_of_week <value>]

Description

파일스토리지 스냅샷 스케줄을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
hour required	string	스냅샷 스케줄 시간	`23`
frequency required	string	스냅샷 주기	`WEEKLY`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
snapshot_retention_count optional	integer	보관 개수	`10`
day_of_week optional	string	스냅샷 스케줄 설정 요일	`MON`

Responses

Name	Description	Example
frequency	스냅샷 주기	WEEKLY
day_of_week	스냅샷 스케줄 설정 요일	MON
hour	스냅샷 스케줄 시간	23

4.1.2.2 - 1.0

scpcli filestorage volume snapshot schedule create
--hour <value>
--frequency <value>
--volume_id <value>
[--snapshot_retention_count <value>]
[--day_of_week <value>]

Description

파일스토리지 스냅샷 스케줄을 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
hour required	string	스냅샷 스케줄 시간	`23`
frequency required	string	스냅샷 주기	`WEEKLY`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
snapshot_retention_count optional	integer	보관 개수	`10`
day_of_week optional	string	스냅샷 스케줄 설정 요일	`MON`

Responses

Name	Description	Example
frequency	스냅샷 주기	WEEKLY
day_of_week	스냅샷 스케줄 설정 요일	MON
hour	스냅샷 스케줄 시간	23

4.1.3 - CreateVolume

4.1.3.1 - 1.1

scpcli filestorage volume create
--type_name <value>
--protocol <value>
--name <value>
[--snapshot_id <value>]
[--cifs_password <value>]
[--tags <value>]

Description

파일스토리지를 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
type_name required	string	볼륨 유형 이름	`HDD`
protocol required	string	프로토콜	`NFS`
name required	string	볼륨 이름	`my_volume`
snapshot_id optional	string	스냅샷 아이디	`40htrre5b-eww25-ff2b-a426-6afefas65a3b`
cifs_password optional	string	CIFS 비밀번호	`cifspwd0!!`
tags optional	array		`'{"key": "key", "value": "value"}'`

Responses

Name	Description	Example
protocol	프로토콜	NFS
snapshot_id	스냅샷 아이디	40htrre5b-eww25-ff2b-a426-6afefas65a3b
type_name	볼륨 유형 이름	HDD
volume_id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
volume_name	볼륨 이름	my_volume

4.1.3.2 - 1.0

scpcli filestorage volume create
--type_name <value>
--protocol <value>
--name <value>
[--snapshot_id <value>]
[--cifs_password <value>]
[--tags <value>]

Description

파일스토리지를 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
type_name required	string	볼륨 유형 이름	`HDD`
protocol required	string	프로토콜	`NFS`
name required	string	볼륨 이름	`my_volume`
snapshot_id optional	string	스냅샷 아이디	`40htrre5b-eww25-ff2b-a426-6afefas65a3b`
cifs_password optional	string	CIFS 비밀번호	`cifspwd0!!`
tags optional	array		`'{"key": "key", "value": "value"}'`

Responses

Name	Description	Example
protocol	프로토콜	NFS
snapshot_id	스냅샷 아이디	40htrre5b-eww25-ff2b-a426-6afefas65a3b
type_name	볼륨 유형 이름	HDD
volume_id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
volume_name	볼륨 이름	my_volume

4.1.4 - CreateVolumeReplication

4.1.4.1 - 1.1

scpcli filestorage volume replication create
--replication_type <value>
--volume_id <value>
--region <value>
--replication_frequency <value>
--name <value>
[--cifs_password <value>]
[--backup_retention_count <value>]

Description

파일스토리지 복제를 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
replication_type required	string	복제 유형	`replication`
volume_id required	string	원본 볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
region required	string	복제본 리전	`kr-west1`
replication_frequency required	string	복제 주기	`5min`
name required	string	복제본 볼륨 이름	`my_volume`
cifs_password optional	string	CIFS 비밀번호	`cifspwd0!!`
backup_retention_count optional	integer	백업 보관 개수	`2`

Responses

Name	Description	Example
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

4.1.4.2 - 1.0

scpcli filestorage volume replication create
--replication_type <value>
--volume_id <value>
--region <value>
--replication_frequency <value>
--name <value>
[--cifs_password <value>]
[--backup_retention_count <value>]

Description

파일스토리지 복제를 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
replication_type required	string	복제 유형	`replication`
volume_id required	string	원본 볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
region required	string	복제본 리전	`kr-west1`
replication_frequency required	string	복제 주기	`5min`
name required	string	복제본 볼륨 이름	`my_volume`
cifs_password optional	string	CIFS 비밀번호	`cifspwd0!!`
backup_retention_count optional	integer	백업 보관 개수	`2`

Responses

Name	Description	Example
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

4.1.5 - DeleteSnapshot

4.1.5.1 - 1.1

scpcli filestorage volume snapshot delete
--snapshot_id <value>
--volume_id <value>

Description

파일스토리지 스냅샷을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 아이디	`40htrre5b-eww25-ff2b-a426-6afefas65a3b`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.5.2 - 1.0

scpcli filestorage volume snapshot delete
--snapshot_id <value>
--volume_id <value>

Description

파일스토리지 스냅샷을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 아이디	`40htrre5b-eww25-ff2b-a426-6afefas65a3b`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.6 - DeleteSnapshotSchedule

4.1.6.1 - 1.1

scpcli filestorage volume snapshot schedule delete
--snapshot_schedule_id <value>
--volume_id <value>

Description

파일스토리지 스냅샷 스케줄을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
snapshot_schedule_id required	string	스냅샷 스케줄 아이디	`d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.6.2 - 1.0

scpcli filestorage volume snapshot schedule delete
--snapshot_schedule_id <value>
--volume_id <value>

Description

파일스토리지 스냅샷 스케줄을 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
snapshot_schedule_id required	string	스냅샷 스케줄 아이디	`d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.7 - DeleteVolume

4.1.7.1 - 1.1

scpcli filestorage volume delete
--volume_id <value>

Description

파일스토리지를 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.7.2 - 1.0

scpcli filestorage volume delete
--volume_id <value>

Description

파일스토리지를 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.8 - DeleteVolumeReplication

4.1.8.1 - 1.1

scpcli filestorage volume replication delete
--replication_id <value>
--volume_id <value>

Description

파일스토리지 복제를 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
replication_id required	string	복제 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.8.2 - 1.0

scpcli filestorage volume replication delete
--replication_id <value>
--volume_id <value>

Description

파일스토리지 복제를 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
replication_id required	string	복제 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.9 - ListAccessRules

4.1.9.1 - 1.1

scpcli filestorage volume access rule list
--volume_id <value>

Description

접근제어 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
access_rule_state	접근제어 상태	active
object_type	오브젝트 유형	VM
object_id	오브젝트 아이디	43fq3347-02q4-4aa8-ccf9-affe4917bb6f

4.1.9.2 - 1.0

scpcli filestorage volume access rule list
--volume_id <value>

Description

접근제어 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
access_rule_state	접근제어 상태	active
object_type	오브젝트 유형	VM
object_id	오브젝트 아이디	43fq3347-02q4-4aa8-ccf9-affe4917bb6f

4.1.10 - ListSnapshots

4.1.10.1 - 1.1

scpcli filestorage volume snapshot list
--volume_id <value>

Description

파일스토리지 스냅샷 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	스냅샷 아이디	40htrre5b-eww25-ff2b-a426-6afefas65a3b
name	스냅샷 이름	my_volume.2024-10-01_14215
state	스냅샷 상태	available
size	스냅샷 크기	100
created_at	생성 시간	2024-07-30T04:54:33.219373

4.1.10.2 - 1.0

scpcli filestorage volume snapshot list
--volume_id <value>

Description

파일스토리지 스냅샷 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	스냅샷 아이디	40htrre5b-eww25-ff2b-a426-6afefas65a3b
name	스냅샷 이름	my_volume.2024-10-01_14215
state	스냅샷 상태	available
size	스냅샷 크기	100
created_at	생성 시간	2024-07-30T04:54:33.219373

4.1.11 - ListSnapshotSchedule

4.1.11.1 - 1.1

scpcli filestorage volume snapshot schedule list
--volume_id <value>

Description

파일스토리지 스냅샷 스케줄 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	스냅샷 스케줄 아이디	d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31
frequency	스냅샷 주기	WEEKLY
day_of_week	스냅샷 스케줄 설정 요일	MON
hour	스냅샷 스케줄 시간	23

4.1.11.2 - 1.0

scpcli filestorage volume snapshot schedule list
--volume_id <value>

Description

파일스토리지 스냅샷 스케줄 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	스냅샷 스케줄 아이디	d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31
frequency	스냅샷 주기	WEEKLY
day_of_week	스냅샷 스케줄 설정 요일	MON
hour	스냅샷 스케줄 시간	23

4.1.12 - ListVolumeReplicationRegion

4.1.12.1 - 1.1

scpcli filestorage volume replication region list
--replication_type <value>
--source_region_name <value>
[--type_name <value>]

Description

파일스토리지 복제 리전 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
replication_type required	string	복제 유형	`replication`
source_region_name required	string	리전	`kr-west1`
type_name optional	string	볼륨 유형 이름	`HDD`

Responses

Name	Description	Example
regions	복제 리전 목록	[‘kr-west1’]

4.1.12.2 - 1.0

scpcli filestorage volume replication region list
--replication_type <value>
--source_region_name <value>
[--type_name <value>]

Description

파일스토리지 복제 리전 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
replication_type required	string	복제 유형	`replication`
source_region_name required	string	리전	`kr-west1`
type_name optional	string	볼륨 유형 이름	`HDD`

Responses

Name	Description	Example
regions	복제 리전 목록	[‘kr-west1’]

4.1.13 - ListVolumeReplications

4.1.13.1 - 1.1

scpcli filestorage volume replication list
--volume_id <value>

Description

파일스토리지 복제 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
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

4.1.13.2 - 1.0

scpcli filestorage volume replication list
--volume_id <value>

Description

파일스토리지 복제 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
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

4.1.14 - ListVolumes

4.1.14.1 - 1.1

scpcli filestorage volume list
[--offset <value>]
[--limit <value>]
[--name <value>]
[--type_name <value>]
[--sort <value>]

Description

파일스토리지 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
offset optional	integer	offset	-
limit optional	integer	limit	-
name optional	string	볼륨 이름	`my_volume`
type_name optional	string	볼륨 유형 이름	`HDD`
sort optional	string	정렬	-

Responses

Name	Description	Example
id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
name	볼륨 이름	my_volume
protocol	프로토콜	NFS
state	볼륨 상태	available
account_id	Account 아이디	rwww523320dfvwbbefefsdvwdadsfa24c
created_at	생성 시간	2024-07-30T04:54:33.219373
type_id	볼륨 유형 아이디	jef22f67-ee83-4gg2-2ab6-3lf774ekfjdu
type_name	볼륨 유형 이름	HDD
purpose	볼륨 용도	replication

4.1.14.2 - 1.0

scpcli filestorage volume list
[--offset <value>]
[--limit <value>]
[--name <value>]
[--type_name <value>]
[--sort <value>]

Description

파일스토리지 목록을 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
offset optional	integer	offset	-
limit optional	integer	limit	-
name optional	string	볼륨 이름	`my_volume`
type_name optional	string	볼륨 유형 이름	`HDD`
sort optional	string	정렬	-

Responses

Name	Description	Example
id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
name	볼륨 이름	my_volume
protocol	프로토콜	NFS
state	볼륨 상태	available
account_id	Account 아이디	rwww523320dfvwbbefefsdvwdadsfa24c
created_at	생성 시간	2024-07-30T04:54:33.219373
type_id	볼륨 유형 아이디	jef22f67-ee83-4gg2-2ab6-3lf774ekfjdu
type_name	볼륨 유형 이름	HDD
purpose	볼륨 용도	replication

4.1.15 - RestoreSnapshot

4.1.15.1 - 1.1

scpcli filestorage volume snapshot set
--snapshot_id <value>
--volume_id <value>

Description

파일스토리지 스냅샷을 복구한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 아이디	`40htrre5b-eww25-ff2b-a426-6afefas65a3b`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.15.2 - 1.0

scpcli filestorage volume snapshot set
--snapshot_id <value>
--volume_id <value>

Description

파일스토리지 스냅샷을 복구한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 아이디	`40htrre5b-eww25-ff2b-a426-6afefas65a3b`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

4.1.16 - SetAccessRule

4.1.16.1 - 1.1

scpcli filestorage volume access rule set
--volume_id <value>
--action <value>
--object_type <value>
--object_id <value>

Description

파일스토리지 접근제어를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
action required	string	접근제어 액션	`add`
object_type required	string	오브젝트 유형	`VM`
object_id required	string	오브젝트 아이디	`43fq3347-02q4-4aa8-ccf9-affe4917bb6f`

4.1.16.2 - 1.0

scpcli filestorage volume access rule set
--volume_id <value>
--action <value>
--object_type <value>
--object_id <value>

Description

파일스토리지 접근제어를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
action required	string	접근제어 액션	`add`
object_type required	string	오브젝트 유형	`VM`
object_id required	string	오브젝트 아이디	`43fq3347-02q4-4aa8-ccf9-affe4917bb6f`

4.1.17 - SetSnapshotSchedule

4.1.17.1 - 1.1

scpcli filestorage volume snapshot schedule set
--snapshot_schedule_id <value>
--volume_id <value>
--hour <value>
--frequency <value>
[--snapshot_retention_count <value>]
[--day_of_week <value>]

Description

파일스토리지 스냅샷 스케줄을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
snapshot_schedule_id required	string	스냅샷 스케줄 아이디	`d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
hour required	string	스냅샷 스케줄 시간	`23`
frequency required	string	스냅샷 주기	`WEEKLY`
snapshot_retention_count optional	integer	보관 개수	`10`
day_of_week optional	string	스냅샷 스케줄 설정 요일	`MON`

4.1.17.2 - 1.0

scpcli filestorage volume snapshot schedule set
--snapshot_schedule_id <value>
--volume_id <value>
--hour <value>
--frequency <value>
[--snapshot_retention_count <value>]
[--day_of_week <value>]

Description

파일스토리지 스냅샷 스케줄을 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
snapshot_schedule_id required	string	스냅샷 스케줄 아이디	`d02d1a74-1871-4a3d-bdfc-6e60e9ea0f31`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
hour required	string	스냅샷 스케줄 시간	`23`
frequency required	string	스냅샷 주기	`WEEKLY`
snapshot_retention_count optional	integer	보관 개수	`10`
day_of_week optional	string	스냅샷 스케줄 설정 요일	`MON`

4.1.18 - SetVolume

4.1.18.1 - 1.1

scpcli filestorage volume set
--volume_id <value>
--file_unit_recovery_enabled <value>

Description

파일스토리지를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
file_unit_recovery_enabled required	boolean	볼륨 파일 단위 복구 사용 여부	`True`

4.1.18.2 - 1.0

scpcli filestorage volume set
--volume_id <value>
--file_unit_recovery_enabled <value>

Description

파일스토리지를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
file_unit_recovery_enabled required	boolean	볼륨 파일 단위 복구 사용 여부	`True`

4.1.19 - SetVolumeReplication

4.1.19.1 - 1.1

scpcli filestorage volume replication set
--replication_id <value>
--volume_id <value>
--replication_update_type <value>
[--replication_policy <value>]
[--replication_frequency <value>]
[--backup_retention_count <value>]

Description

파일스토리지 복제를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
replication_id required	string	복제 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
replication_update_type required	string	복제 수정 유형	`policy`
replication_policy optional	****	복제 정책	`use`
replication_frequency optional	****	복제 주기	`5min`
backup_retention_count optional	integer	백업 보관 개수	`2`

4.1.19.2 - 1.0

scpcli filestorage volume replication set
--replication_id <value>
--volume_id <value>
--replication_update_type <value>
[--replication_policy <value>]
[--replication_frequency <value>]
[--backup_retention_count <value>]

Description

파일스토리지 복제를 수정한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
replication_id required	string	복제 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
replication_update_type required	string	복제 수정 유형	`policy`
replication_policy optional	****	복제 정책	`use`
replication_frequency optional	****	복제 주기	`5min`
backup_retention_count optional	integer	백업 보관 개수	`2`

4.1.20 - ShowVolume

4.1.20.1 - 1.1

scpcli filestorage volume show
--volume_id <value>

Description

파일스토리지를 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
name	볼륨 이름	my_volume
protocol	프로토콜	NFS
state	볼륨 상태	available
account_id	Account 아이디	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	볼륨 사용량	100000
encryption_enabled	볼륨 암호화 사용 여부	True
file_unit_recovery_enabled	볼륨 파일 단위 복구 사용 여부	True
cifs_id	CIFS 아이디	cifsid
endpoint_path	볼륨 엔드포인트 경로	xxx.xx.xxx.xxx

4.1.20.2 - 1.0

scpcli filestorage volume show
--volume_id <value>

Description

파일스토리지를 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
name	볼륨 이름	my_volume
protocol	프로토콜	NFS
state	볼륨 상태	available
account_id	Account 아이디	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	볼륨 사용량	100000
encryption_enabled	볼륨 암호화 사용 여부	True
file_unit_recovery_enabled	볼륨 파일 단위 복구 사용 여부	True
cifs_id	CIFS 아이디	cifsid
endpoint_path	볼륨 엔드포인트 경로	xxx.xx.xxx.xxx

4.1.21 - ShowVolumeReplication

4.1.21.1 - 1.1

scpcli filestorage volume replication show
--replication_id <value>
--volume_id <value>

Description

파일스토리지 복제를 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
replication_id required	string	복제 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
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

4.1.21.2 - 1.0

scpcli filestorage volume replication show
--replication_id <value>
--volume_id <value>

Description

파일스토리지 복제를 상세 조회한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
replication_id required	string	복제 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
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

5 - Parallel File Storage

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.

본 가이드는 Parallel File Storage 서비스에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.

Version

Version	Status	Supported Until
1.0	CURRENT	-

5.1 - CLIs

5.1.1 - CreateSnapshot

5.1.1.1 - 1.0

scpcli parallel-filestorage snapshot create
--volume_id <value>

Description

병렬 파일스토리지 스냅샷을 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
snapshot	스냅샷

5.1.2 - CreateVolume

5.1.2.1 - 1.0

scpcli parallel-filestorage volume create
--capacity_tb <value>
--name <value>
[--tags <value>]

Description

병렬 파일스토리지를 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
capacity_tb required	integer	볼륨 용량	`100`
name required	string	볼륨 이름	`my_volume`
tags optional	array		`'{"key": "key", "value": "value"}'`

Responses

Name	Description	Example
id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
name	볼륨 이름	my_volume
state	볼륨 상태	available
created_at	생성 시간	2024-07-30T04:54:33.219373
capacity_tb	볼륨 용량	100
account_id	어카운트 아이디	rwww523320dfvwbbefefsdvwdadsfa24c

5.1.3 - DeleteSnapshot

5.1.3.1 - 1.0

scpcli parallel-filestorage snapshot delete
--snapshot_id <value>
--volume_id <value>

Description

병렬 파일스토리지 스냅샷을 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
snapshot_id required	string	스냅샷 아이디	`40htrre5b-eww25-ff2b-a426-6afefas65a3b`
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

5.1.4 - DeleteVolume

5.1.4.1 - 1.0

scpcli parallel-filestorage volume delete
--volume_id <value>

Description

병렬 파일스토리지를 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

5.1.5 - ListAccessRule

5.1.5.1 - 1.0

scpcli parallel-filestorage access rule list
--volume_id <value>

Description

병렬 파일스토리지 접근제어 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
object_id	오브젝트 아이디	43fq3347-02q4-4aa8-ccf9-affe4917bb6f
object_type	오브젝트 유형	GPU_NODE
object_name	오브젝트 이름	objectname
object_state	오브젝트 상태	RUNNING
access_state	접근제어 상태	all
access_ip_list

5.1.6 - ListSnapshots

5.1.6.1 - 1.0

scpcli parallel-filestorage snapshot list
--volume_id <value>

Description

병렬 파일스토리지 스냅샷 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	스냅샷 아이디	40htrre5b-eww25-ff2b-a426-6afefas65a3b
name	스냅샷 이름	snapshot.2025-10-30_121212
size	스냅샷 크기	100
state	스냅샷 상태	available
created_at	생성 시간	2024-10-30T04:54:33.219373

5.1.7 - ListVolumes

5.1.7.1 - 1.0

scpcli parallel-filestorage volume list
[--offset <value>]
[--limit <value>]
[--name <value>]
[--sort <value>]

Description

병렬 파일스토리지 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
offset optional	integer	offset	-
limit optional	integer	limit	-
name optional	string	볼륨 이름	`my_volume`
sort optional	string	정렬	-

Responses

Name	Description	Example
id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
name	볼륨 이름	my_volume
state	볼륨 상태	available
created_at	생성 시간	2024-07-30T04:54:33.219373
capacity_tb	볼륨 용량	100
account_id	어카운트 아이디	rwww523320dfvwbbefefsdvwdadsfa24c

5.1.8 - SetAccessRule

5.1.8.1 - 1.0

scpcli parallel-filestorage access rule set
--volume_id <value>
--remove_access_rules <value>
--add_access_rules <value>

Description

병렬 파일스토리지 접근제어를 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
remove_access_rules required	array		`'{"object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f", "object_type": "GPU_NODE"}'`
add_access_rules required	array		`'{"object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f", "object_type": "GPU_NODE"}'`

5.1.9 - SetVolumeCapacity

5.1.9.1 - 1.0

scpcli parallel-filestorage volume capacity set
--volume_id <value>
--capacity_tb <value>

Description

병렬 파일스토리지 용량을 수정한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`
capacity_tb required	integer	볼륨 용량	`100`

5.1.10 - ShowVolume

5.1.10.1 - 1.0

scpcli parallel-filestorage volume show
--volume_id <value>

Description

병렬 파일스토리지를 상세 조회한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.0	-

Parameters

Name	Type	Description	Example
volume_id required	string	볼륨 아이디	`bfdbabf2-04d9-4e8b-a205-020f8e6da438`

Responses

Name	Description	Example
id	볼륨 아이디	bfdbabf2-04d9-4e8b-a205-020f8e6da438
name	볼륨 이름	my_volume
state	볼륨 상태	available
created_at	생성 시간	2024-07-30T04:54:33.219373
capacity_tb	볼륨 용량	100
account_id	어카운트 아이디	rwww523320dfvwbbefefsdvwdadsfa24c
mount_path	볼륨 마운트 경로	xxx.xx.xxx:/xxxxxxxx