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

이 페이지의 일반 화면으로 돌아가기.

Parallel File Storage

Overview

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

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

Version

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

VersionStatusNot Before
1.1CURRENT-
1.0SUPPORTED20261130

CLI Version History

1.1

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

변경사항

  • [변경] parallel-filestorage volume create - 옵션이 추가 됩니다.
    • 추가 --zone - 필수 옵션으로 추가. 볼륨의 존.
  • [변경] parallel-filestorage volume list - 출력 컬럼이 추가 됩니다.
    • 추가 zone - 볼륨의 존.
  • [변경] parallel-filestorage volume list - --sort 옵션에서 추가적인 정렬 값이 허용 됩니다.
    • 추가 protocol:asc, protocol:desc, zone:asc, zone:desc 정렬 옵션이 추가되었습니다.
  • [변경] parallel-filestorage volume show - 출력 필드가 추가 됩니다.
    • 추가 zone - 볼륨의 존.
  • [신규] parallel-filestorage volume snapshot restore - Snapshot 복구 명령어가 추가 되었습니다.
  • [변경] parallel-filestorage volume snapshot list - 출력 필드가 변경 됩니다.
    • 추가 snapshot_size_total_byte - 최상위 응답 객체에 선택 필드로 추가.
    • 변경 size - 필수 필드에서 선택 필드로 변경.
  • [변경] parallel-filestorage volume access rule list - 명령어가 --volume_id 쿼리 파라미터 대신 positional argument로 volume_id를 받습니다.
  • [변경] parallel-filestorage volume access rule set - 명령어가 --volume_id 쿼리 파라미터 대신 positional argument로 volume_id를 받습니다.

1.0

Parallel File Storage CLI가 출시되었습니다.

변경사항

  • [신규] parallel-filestorage volume list - Volume 목록 조회 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume create - Volume 생성 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume show - Volume 상세 조회 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume delete - Volume 삭제 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume capacity set - Volume 용량 설정 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume access rule list - Access rules 조회 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume access rule set - Volume의 access rule 설정 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume snapshot list - Snapshot 목록 조회 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume snapshot create - Snapshot 생성 명령어가 추가되었습니다.
  • [신규] parallel-filestorage volume snapshot delete - Snapshot 삭제 명령어가 추가되었습니다.

1 - CLIs

1.1 - CreateSnapshot

1.1.1 - 1.1

scp-cli parallel-filestorage snapshot create
--volume_id <value>

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

Responses

NameDescriptionExample
snapshot스냅샷

1.1.2 - 1.0

scp-cli parallel-filestorage snapshot create
--volume_id <value>

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

Responses

NameDescriptionExample
snapshot스냅샷

1.2 - CreateVolume

1.2.1 - 1.1

scp-cli parallel-filestorage volume create
--zone <value>
--capacity_tb <value>
--name <value>
[--tags <value>]

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
zone
required		string존kr-west1-a
capacity_tb
required		integer볼륨 용량100
name
required		string볼륨 이름my_volume
tags
optional		array'{"key": "key", "value": "value"}'

Responses

NameDescriptionExample
id볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438
name볼륨 이름my_volume
state볼륨 상태available
created_at생성 시간2024-07-30T04:54:33.219373
capacity_tb볼륨 용량100
account_id계정 IDrwww523320dfvwbbefefsdvwdadsfa24c
zone존kr-west1-a

1.2.2 - 1.0

scp-cli parallel-filestorage volume create
--capacity_tb <value>
--name <value>
[--tags <value>]

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
capacity_tb
required		integer볼륨 용량100
name
required		string볼륨 이름my_volume
tags
optional		array'{"key": "key", "value": "value"}'

Responses

NameDescriptionExample
id볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438
name볼륨 이름my_volume
state볼륨 상태available
created_at생성 시간2024-07-30T04:54:33.219373
capacity_tb볼륨 용량100
account_id계정 IDrwww523320dfvwbbefefsdvwdadsfa24c

1.3 - DeleteSnapshot

1.3.1 - 1.1

scp-cli parallel-filestorage snapshot delete
--snapshot_id <value>
--volume_id <value>

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
snapshot_id
required		string스냅샷 ID40htrre5b-eww25-ff2b-a426-6afefas65a3b
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

1.3.2 - 1.0

scp-cli parallel-filestorage snapshot delete
--snapshot_id <value>
--volume_id <value>

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
snapshot_id
required		string스냅샷 ID40htrre5b-eww25-ff2b-a426-6afefas65a3b
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

1.4 - DeleteVolume

1.4.1 - 1.1

scp-cli parallel-filestorage volume delete
--volume_id <value>

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

1.4.2 - 1.0

scp-cli parallel-filestorage volume delete
--volume_id <value>

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

1.5 - ListAccessRule

1.5.1 - 1.1

scp-cli parallel-filestorage access rule list
--volume_id <value>

Description

병렬 파일스토리지 접근제어 목록을 조회한다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

Responses

NameDescriptionExample
object_id오브젝트 ID43fq3347-02q4-4aa8-ccf9-affe4917bb6f
object_type오브젝트 유형GPU_NODE
object_name오브젝트 이름objectname
object_state오브젝트 상태RUNNING
access_state접근제어 상태all
access_ip_list

1.5.2 - 1.0

scp-cli parallel-filestorage access rule list
--volume_id <value>

Description

병렬 파일스토리지 접근제어 목록을 조회한다.

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

Responses

NameDescriptionExample
object_id오브젝트 ID43fq3347-02q4-4aa8-ccf9-affe4917bb6f
object_type오브젝트 유형GPU_NODE
object_name오브젝트 이름objectname
object_state오브젝트 상태RUNNING
access_state접근제어 상태all
access_ip_list

1.6 - ListSnapshots

1.6.1 - 1.1

scp-cli parallel-filestorage snapshot list
--volume_id <value>

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

Responses

NameDescriptionExample
id스냅샷 ID40htrre5b-eww25-ff2b-a426-6afefas65a3b
name스냅샷 이름snapshot.2025-10-30_121212
size
state스냅샷 상태available
created_at생성 시간2024-10-30T04:54:33.219373

1.6.2 - 1.0

scp-cli parallel-filestorage snapshot list
--volume_id <value>

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

Responses

NameDescriptionExample
id스냅샷 ID40htrre5b-eww25-ff2b-a426-6afefas65a3b
name스냅샷 이름snapshot.2025-10-30_121212
size
state스냅샷 상태available
created_at생성 시간2024-10-30T04:54:33.219373

1.7 - ListVolumes

1.7.1 - 1.1

scp-cli parallel-filestorage volume list
[--offset <value>]
[--limit <value>]
[--name <value>]
[--sort <value>]

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
offset
optional		integeroffset-
limit
optional		integerlimit-
name
optional		string볼륨 이름my_volume
sort
optional		string정렬-

Responses

NameDescriptionExample
id볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438
name볼륨 이름my_volume
state볼륨 상태available
created_at생성 시간2024-07-30T04:54:33.219373
capacity_tb볼륨 용량100
account_id계정 IDrwww523320dfvwbbefefsdvwdadsfa24c
zone존kr-west1-a

1.7.2 - 1.0

scp-cli parallel-filestorage volume list
[--offset <value>]
[--limit <value>]
[--name <value>]
[--sort <value>]

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
offset
optional		integeroffset-
limit
optional		integerlimit-
name
optional		string볼륨 이름my_volume
sort
optional		string정렬-

Responses

NameDescriptionExample
id볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438
name볼륨 이름my_volume
state볼륨 상태available
created_at생성 시간2024-07-30T04:54:33.219373
capacity_tb볼륨 용량100
account_id계정 IDrwww523320dfvwbbefefsdvwdadsfa24c

1.8 - RestoreSnapshot

1.8.1 - 1.1

scp-cli parallel-filestorage volume snapshot set
--snapshot_id <value>
--volume_id <value>

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
snapshot_id
required		string스냅샷 ID40htrre5b-eww25-ff2b-a426-6afefas65a3b
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

1.8.2 - 1.0

scp-cli parallel-filestorage volume snapshot set
--snapshot_id <value>
--volume_id <value>

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
snapshot_id
required		string스냅샷 ID40htrre5b-eww25-ff2b-a426-6afefas65a3b
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

1.9 - SetAccessRule

1.9.1 - 1.1

scp-cli parallel-filestorage access rule set
--volume_id <value>
--remove_access_rules <value>
--add_access_rules <value>

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-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"}'

1.9.2 - 1.0

scp-cli parallel-filestorage access rule set
--volume_id <value>
--remove_access_rules <value>
--add_access_rules <value>

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-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"}'

1.10 - SetVolumeCapacity

1.10.1 - 1.1

scp-cli parallel-filestorage volume capacity set
--volume_id <value>
--capacity_tb <value>

Description

병렬 파일스토리지 용량을 수정한다.

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438
capacity_tb
required		integer볼륨 용량100

1.10.2 - 1.0

scp-cli parallel-filestorage volume capacity set
--volume_id <value>
--capacity_tb <value>

Description

병렬 파일스토리지 용량을 수정한다.

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438
capacity_tb
required		integer볼륨 용량100

1.11 - ShowVolume

1.11.1 - 1.1

scp-cli parallel-filestorage volume show
--volume_id <value>

Description

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

상태 ACTIVE (CURRENT)

버전최소 지원 보장일
1.1-

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

Responses

NameDescriptionExample
id볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438
name볼륨 이름my_volume
state볼륨 상태available
created_at생성 시간2024-07-30T04:54:33.219373
capacity_tb볼륨 용량100
account_id계정 IDrwww523320dfvwbbefefsdvwdadsfa24c
zone존kr-west1-a
mount_path볼륨 마운트 경로xxx.xx.xxx:/xxxxxxxx

1.11.2 - 1.0

scp-cli parallel-filestorage volume show
--volume_id <value>

Description

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

상태 ACTIVE (SUPPORTED)

버전최소 지원 보장일
1.020261130

Parameters

NameTypeDescriptionExample
volume_id
required		string볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438

Responses

NameDescriptionExample
id볼륨 IDbfdbabf2-04d9-4e8b-a205-020f8e6da438
name볼륨 이름my_volume
state볼륨 상태available
created_at생성 시간2024-07-30T04:54:33.219373
capacity_tb볼륨 용량100
account_id계정 IDrwww523320dfvwbbefefsdvwdadsfa24c
mount_path볼륨 마운트 경로xxx.xx.xxx:/xxxxxxxx