copyIntoStorage

POST

/api/v1/storages/{storage_id}/copies

const url = 'https://dev.api.endueos.com/api/v1/storages/wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC/copies';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"source_storage_id":"wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC","source_path":"example","path":"example","timeout_seconds":600,"wait_ms":0}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://dev.api.endueos.com/api/v1/storages/wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC/copies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "source_storage_id": "wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC", "source_path": "example", "path": "example", "timeout_seconds": 600, "wait_ms": 0 }'

인증

파라미터

경로 파라미터

storage_id

필수

string

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

예시

wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC

헤더 파라미터

X-Idempotency-Key

string

/^[A-Za-z0-9._:-]{1,200}$/

요청 본문^필수

application/json

이 Storage(대상)로 원본의 파일·폴더를 넣는다. 경로는 모두 Storage 루트 기준 상대 경로다.

object

source_storage_id

필수

string

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

예시

wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC

source_path

생략하면 원본 Storage 의 루트 전체

string

>= 1 characters <= 4096 characters

path

필수

대상 Storage 안의 새 경로. 파일·폴더·링크가 이미 있으면 409 STORAGE_PATH_EXISTS

string

>= 1 characters <= 4096 characters

timeout_seconds

작업 기한(초). 접수 시각부터 센다. 넘기면 확정 전이면 아무것도 바꾸지 않고 STORAGE_OPERATION_TIMEOUT 으로 끝난다

integer format: int32

default: 600 >= 10 <= 3600

wait_ms

이 시간 안에 끝나면 201, 아니면 202 와 작업 주소

integer format: int32

0 <= 25000

응답

201

만들었다.

application/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
null

object

error

필수

Any of:

object
null

object

code

필수

오류 코드. 예: RESOURCE_NOT_FOUND

string

message

필수

string

details

필수

object

suggest

필수

Any of:

string
null

string

source_storage_id

필수

Any of:

string
null

string

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

source_revision

필수

Any of:

integer
null

integer format: int64

<= 9007199254740991

clone_cut_at

필수

Any of:

string
null

string format: date-time

source_committed_at

필수

Any of:

string
null

string format: date-time

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
null

integer format: int64

<= 9007199254740991

committed_at

필수

Any of:

string
null

string format: date-time

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
null

integer format: int64

<= 9007199254740991

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"
      }
    }
  }
}

202

받았지만 아직 끝나지 않았다. Location 으로 상태를 묻는다. Retry-After 는 다음 조회까지 기다릴 초.

application/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
null

object

error

필수

Any of:

object
null

object

code

필수

오류 코드. 예: RESOURCE_NOT_FOUND

string

message

필수

string

details

필수

object

suggest

필수

Any of:

string
null

string

source_storage_id

필수

Any of:

string
null

string

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

source_revision

필수

Any of:

integer
null

integer format: int64

<= 9007199254740991

clone_cut_at

필수

Any of:

string
null

string format: date-time

source_committed_at

필수

Any of:

string
null

string format: date-time

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
null

integer format: int64

<= 9007199254740991

committed_at

필수

Any of:

string
null

string format: date-time

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
null

integer format: int64

<= 9007199254740991

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"
      }
    }
  }
}

응답 헤더

Location

필수

string

Retry-After

필수

integer format: int32

400

요청 형식이 틀렸다 — VALIDATION_ERROR(details.errors[]) 또는 BAD_REQUEST. 본문은 오류 봉투.

401

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

402

크레딧이 없다 — INSUFFICIENT_CREDITS (충전하면 다시 된다). 본문은 오류 봉투.

404

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

409

지금 상태와 충돌한다 — 코드는 위 설명을 본다. 본문은 오류 봉투.

422

형식은 맞지만 할 수 없다 — 코드는 위 설명을 본다. 본문은 오류 봉투.

429

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

500

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

503

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

copyIntoStorage

인증

파라미터

경로 파라미터

예시

헤더 파라미터

요청 본문필수

예시

응답

201

예시

202

예시

응답 헤더

400

401

402

404

409

422

429

500

503

요청 본문^필수