getStorageOperation

GET

/api/v1/storages/{storage_id}/operations/{operation_id}

curl --request GET \
  --url https://dev.api.endueos.com/api/v1/storages/wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC/operations/wso_01J9ZK3Q8M4XW7D2N5R6T0V1BC \
  --header 'Authorization: Bearer <token>'

• 개발 환경
• 로컬 스택 — local/up.sh
• 운영 — 예정, 아직 열지 않았다

인증

• Bearer 토큰 — 사용자 JWT 또는 osk_ 키
• X-API-Key 헤더 — osk_ 키

파라미터

경로 파라미터

storage_id

필수

string

/^wst_[0-9A-HJKMNP-TV-Z]{26}$/

예시

wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC

operation_id

필수

string

/^wso_[0-9A-HJKMNP-TV-Z]{26}$/

예시

wso_01J9ZK3Q8M4XW7D2N5R6T0V1BC

쿼리 파라미터

wait_ms

integer format: int32

<= 25000

응답

200

성공.

Media typeapplication/json

object

data

필수

object

operation_id

필수

string

/^wso_[0-9A-HJKMNP-TV-Z]{26}$/

operation_storage_id

필수

string

/^wst_[0-9A-HJKMNP-TV-Z]{26}$/

kind

필수

string

허용 값: clone restore transfer cleanup delete attach detach checkpoint copy move

status

필수

string

허용 값: queued running waiting succeeded failed cancelled

phase

필수

string

status_url

필수

string

bytes_done

필수

integer format: int64

<= 9007199254740991

bytes_total

필수

integer format: int64

<= 9007199254740991

entries_done

필수

integer format: int64

<= 9007199254740991

entries_total

필수

integer format: int64

<= 9007199254740991

cancel_requested

필수

boolean

result

필수

Any of:

object

object

null

null

error

필수

Any of:

object

object

code

필수

오류 코드. 예: RESOURCE_NOT_FOUND

string

message

필수

string

details

필수

object

suggest

필수

Any of:

string

string

null

null

null

null

source_storage_id

필수

Any of:

string

string

/^wst_[0-9A-HJKMNP-TV-Z]{26}$/

null

null

source_revision

필수

Any of:

integer

integer format: int64

<= 9007199254740991

null

null

clone_cut_at

필수

Any of:

string

string format: date-time

null

null

source_committed_at

필수

Any of:

string

string format: date-time

null

null

transfer

Kind 가 copy·move 일 때만 있다 (ENDUE-1162)

object

source

필수

object

storage_id

필수

string

/^wst_[0-9A-HJKMNP-TV-Z]{26}$/

path

필수

string

revision

필수

Any of:

integer

integer format: int64

<= 9007199254740991

null

null

committed_at

필수

Any of:

string

string format: date-time

null

null

saved_now

필수

boolean

destination

필수

object

storage_id

필수

string

/^wst_[0-9A-HJKMNP-TV-Z]{26}$/

path

필수

string

>= 1 characters <= 4096 characters

revision

필수

Any of:

integer

integer format: int64

<= 9007199254740991

null

null

deadline_at

필수

string format: date-time

destination_committed

필수

이동의 원본 제거 단계에서 기한이 지나면 destination_committed=true · source_removed=false 로 끝난다(양쪽에 남는다)

boolean

source_removed

필수

boolean

created_at

필수

string format: date-time

updated_at

필수

string format: date-time

meta

필수

object

request_id

필수

string

timestamp

필수

string format: date-time

duration

서버 처리 시간(ms).

integer format: int32

예시

{
  "data": {
    "operation_id": "wso_01J9ZK3Q8M4XW7D2N5R6T0V1BC",
    "operation_storage_id": "wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC",
    "kind": "clone",
    "status": "queued",
    "source_storage_id": "wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC",
    "transfer": {
      "source": {
        "storage_id": "wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC"
      },
      "destination": {
        "storage_id": "wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC"
      }
    }
  }
}

401

인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.

404

없거나 내 것이 아니다 — *_NOT_FOUND. 본문은 오류 봉투.

429

한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.

500

서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.

503

의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.