콘텐츠로 이동

createStorageReadLease

POST
/api/v1/storages/{storage_id}/revisions/{revision}/read-leases
curl --request POST \
--url https://dev.api.endueos.com/api/v1/storages/wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC/revisions/1/read-leases \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "lease_id": "example" }'
storage_id
필수
string
/^wst_[0-9A-HJKMNP-TV-Z]{26}$/
예시
wst_01J9ZK3Q8M4XW7D2N5R6T0V1BC
revision
필수
integer format: int64
<= 9007199254740991
Media typeapplication/json
object
lease_id
string
예시자동 생성
{
"lease_id": "example"
}

비밀값이 든 응답 — 캐시하지 않는다.

Media typeapplication/json
object
data
필수
object
lease_id
필수
string
revision
필수
integer format: int64
<= 9007199254740991
expires_at
필수
string format: date-time
max_expires_at
필수
string format: date-time
meta
필수
object
request_id
필수
string
timestamp
필수
string format: date-time
duration

서버 처리 시간(ms).

integer format: int32
예시자동 생성
{
"data": {
"lease_id": "example",
"revision": 1,
"expires_at": "2026-04-15T12:00:00Z",
"max_expires_at": "2026-04-15T12:00:00Z"
},
"meta": {
"request_id": "example",
"timestamp": "2026-04-15T12:00:00Z",
"duration": 1
}
}
Cache-Control
필수
string
허용 값: no-store

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

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

보관 기간이 지났다 — OUTPUT_EXPIRED. 본문은 오류 봉투.

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

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

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