이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.
APIs
- 1: CreateSnapshot
- 1.1: 1.0
- 2: CreateVolume
- 2.1: 1.0
- 3: DeleteSnapshot
- 3.1: 1.0
- 4: DeleteVolume
- 4.1: 1.0
- 5: ListAccessRule
- 5.1: 1.0
- 6: ListSnapshots
- 6.1: 1.0
- 7: ListVolumes
- 7.1: 1.0
- 8: SetAccessRule
- 8.1: 1.0
- 9: SetVolumeCapacity
- 9.1: 1.0
- 10: ShowVolume
- 10.1: 1.0
1 - CreateSnapshot
1.1 - 1.0
post /v1/snapshots
Description
병렬 파일스토리지 스냅샷을 생성한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | SnapshotCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Accepted | SnapshotCreateResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/snapshots
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Request body
{
"volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
}
Example HTTP response
Response 202
{
"snapshot": {
"id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
"name": "snapshot.2025-10-30_121212",
"size": 100,
"state": "available",
"created_at": "2024-10-30T04:54:33.219373",
"volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
}
}
2 - CreateVolume
2.1 - 1.0
post /v1/volumes
Description
병렬 파일스토리지를 생성한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | VolumeCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Accepted | Volume |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/volumes
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Request body
{
"name": "my_volume",
"capacity_tb": 100,
"tags": [
{
"key": "key",
"value": "value"
}
]
}
Example HTTP response
Response 202
{
"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"
}
3 - DeleteSnapshot
3.1 - 1.0
delete /v1/snapshots/{snapshot_id}
Description
병렬 파일스토리지 스냅샷을 삭제한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | snapshot_id required | 스냅샷 아이디 Example : 40htrre5b-eww25-ff2b-a426-6afefas65a3b | string | None |
| query | volume_id required | 볼륨 아이디 Example : bfdbabf2-04d9-4e8b-a205-020f8e6da438 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Accepted | None |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/snapshots/{snapshot_id}?volume_id={volume_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Example HTTP response
Response 202
4 - DeleteVolume
4.1 - 1.0
delete /v1/volumes/{volume_id}
Description
병렬 파일스토리지를 삭제한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | volume_id required | 볼륨 아이디 Example : bfdbabf2-04d9-4e8b-a205-020f8e6da438 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Accepted | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/volumes/{volume_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Example HTTP response
Response 202
5 - ListAccessRule
5.1 - 1.0
get /v1/access-rules
Description
병렬 파일스토리지 접근제어 목록을 조회한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | volume_id required | 볼륨 아이디 Example : bfdbabf2-04d9-4e8b-a205-020f8e6da438 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccessRuleListResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/access-rules?volume_id={volume_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Example HTTP response
Response 200
{
"count": 1,
"volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438",
"access_rules": [
{
"object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
"object_type": "GPU_NODE",
"object_name": "objectname",
"object_state": "RUNNING",
"access_state": "all",
"access_ip_list": [
{
"access_ip": "xxx.xxx.xxx.xxx",
"access_ip_state": "active"
}
]
}
]
}
6 - ListSnapshots
6.1 - 1.0
get /v1/snapshots
Description
병렬 파일스토리지 스냅샷 목록을 조회한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | volume_id required | 볼륨 아이디 Example : bfdbabf2-04d9-4e8b-a205-020f8e6da438 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | SnapshotListResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/snapshots?volume_id={volume_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Example HTTP response
Response 200
{
"count": 1,
"snapshot_size_total_byte": 100,
"snapshots": [
{
"id": "40htrre5b-eww25-ff2b-a426-6afefas65a3b",
"name": "snapshot.2025-10-30_121212",
"size": 100,
"state": "available",
"created_at": "2024-10-30T04:54:33.219373"
}
]
}
7 - ListVolumes
7.1 - 1.0
get /v1/volumes
Description
병렬 파일스토리지 목록을 조회한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | offset optional | offset Example : 0 | integer | 0 |
| query | limit optional | limit Example : 20 | integer | 20 |
| query | name optional | 볼륨 이름 Example : my_volume | any of [string, null] | None |
| query | sort optional | 정렬 Example : | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | VolumeListResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/volumes
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Example HTTP response
Response 200
{
"count": 1,
"parallel_filestorages": [
{
"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"
}
]
}
8 - SetAccessRule
8.1 - 1.0
put /v1/access-rules
Description
병렬 파일스토리지 접근제어를 수정한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | volume_id required | 볼륨 아이디 Example : bfdbabf2-04d9-4e8b-a205-020f8e6da438 | string | None |
| body | body required | AccessRuleUpdateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Accepted | AccessRuleUpdateResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/access-rules?volume_id={volume_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Request body
{
"add_access_rules": [
{
"object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
"object_type": "GPU_NODE"
}
],
"remove_access_rules": [
{
"object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
"object_type": "GPU_NODE"
}
]
}
Example HTTP response
Response 202
{
"add_access_rules": [
{
"object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
"object_type": "GPU_NODE"
}
],
"remove_access_rules": [
{
"object_id": "43fq3347-02q4-4aa8-ccf9-affe4917bb6f",
"object_type": "GPU_NODE"
}
],
"volume_id": "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
}
9 - SetVolumeCapacity
9.1 - 1.0
put /v1/volumes/{volume_id}/capacity
Description
병렬 파일스토리지 용량을 수정한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | volume_id required | 볼륨 아이디 Example : bfdbabf2-04d9-4e8b-a205-020f8e6da438 | string | None |
| body | body required | VolumeCapacityRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Accepted | None |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/volumes/{volume_id}/capacity
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Request body
{
"capacity_tb": 100
}
Example HTTP response
Response 202
10 - ShowVolume
10.1 - 1.0
get /v1/volumes/{volume_id}
Description
병렬 파일스토리지를 상세 조회한다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | volume_id required | 볼륨 아이디 Example : bfdbabf2-04d9-4e8b-a205-020f8e6da438 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | VolumeShowResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/volumes/{volume_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = parallel-filestorage 1.0"
Example HTTP response
Response 200
{
"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"
}