포털 바로가기 네이버 클라우드 플랫폼 설명서

오브젝트 오퍼레이션

오브젝트 다운로드 및 메타데이터 조회

구문

GET /v1/AUTH_{project_id}/{container}/{object}

Response Header를 통해 오브젝트 메타데이터를 응답받고, Response Body를 통해 오브젝트 내용을 다운로드합니다. 만약 대용량 오브젝트인 경우, Response Body는 세그먼트 오브젝트의 연결 내용을 포함합니다. Static 대용량 오브젝트에 대한 매니페스트를 가져오려면 multipart-manifest 파라미터를 사용하시면 됩니다.

요청 예

curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예

HTTP/1.1 200 OK
Content-Length: 210012
Accept-Ranges: bytes
Last-Modified: Tue, 11 Sep 2018 02:12:30 GMT
Etag: 9bd5b4f25faf491080654a34d57c3636
X-Timestamp: 1536631949.99141
Content-Type: text/plain
X-Trans-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
X-Openstack-Request-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
Date: Wed, 12 Sep 2018 05:10:15 GMT

요청이 성공하게 되면 OK (200) 상태 코드를 응답합니다. Range 파라미터를 통해 오브젝트 내용의 일부분의 요청이 성공하게 되면 Partial Content (206) 상태코드를 응답합니다. 해당 오브젝트가 없으면 Not Found (400) 상태코드를 응답합니다.

요청 파라미터

응답 파라미터

오브젝트 생성 및 변경

구문

PUT /v1/AUTH_{project_id}/{container}/{object}

오브젝트의 내용과 메타데이터를 생성 및 변경합니다.
기존에 있는 오브젝트는 덮어쓰고 기존에 있는 메타데이터는 변경합니다.

요청 예

curl -i -X PUT -H "X-Auth-Token: $token" -T "/FILE_PATH/OBJECT" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예

HTTP/1.1 201 Created
Last-Modified: Mon, 17 Sep 2018 07:36:47 GMT
Content-Length: 0
Etag: 95444a08aec383972a52eaaac43e6dce
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txe5ad93db05334b1cb44d2-005b9f598e
X-Openstack-Request-Id: txe5ad93db05334b1cb44d2-005b9f598e
Date: Mon, 17 Sep 2018 07:36:46 GMT

요청이 성공하게 되면 Created (201) 상태 코드를 응답합니다. 요청이 Timeout이 되면 Request Timeout (408) 상태 코드를 응답합니다.

요청 파라미터

응답 파라미터

오브젝트 복사

구문

COPY /v1/AUTH_{project_id}/{container}/{object}

요청 예

curl -i -X COPY -H "X-Auth-Token: $token" -H "Destination: $copy_destination" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예

HTTP/1.1 201 Created
Last-Modified: Mon, 17 Sep 2018 08:21:36 GMT
Content-Length: 0
Etag: f1c9645dbc14efddc7d8a322685f26eb
Content-Type: text/html; charset=UTF-8
X-Copied-From-Account: AUTH_{project_id}
X-Copied-From-Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
X-Copied-From: ncloud-container-0/ncloud-object-0
X-Trans-Id: tx851b895d7fcf47f987a5a-005b9f640f
X-Openstack-Request-Id: tx851b895d7fcf47f987a5a-005b9f640f
Date: Mon, 17 Sep 2018 08:21:35 GMT

오브젝트를 복사합니다. 요청이 성공하게 되면 Created (201) 상태 코드를 응답합니다.

요청 파라미터

응답 파라미터

오브젝트 삭제

구문

DELETE /v1/AUTH_{project_id}/{container}/{object}

요청 예

curl -i -X DELETE -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예

HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx1fe22f08d64b4cf48a1fa-005b9f6647
X-Openstack-Request-Id: tx1fe22f08d64b4cf48a1fa-005b9f6647
Date: Mon, 17 Sep 2018 08:31:03 GMT

오브젝트를 삭제합니다. 요청이 성공하게 되면 No Content (204) 상태 코드를 응답합니다.

요청 파라미터

응답 파라미터

오브젝트 메타데이터 조회

구문

HEAD /v1/AUTH_{project_id}/{container}/{object}

요청 예

curl -i -X HEAD -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예

HTTP/1.1 200 OK
Content-Length: 10485760
Accept-Ranges: bytes
Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
Etag: f1c9645dbc14efddc7d8a322685f26eb
X-Timestamp: 1537170219.48936
Content-Type: application/x-www-form-urlencoded
X-Trans-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
X-Openstack-Request-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
Date: Mon, 17 Sep 2018 08:49:21 GMT

오브젝트 메타데이터를 조회합니다. 요청이 성공하게 되면 OK (200) 상태 코드를 응답합니다.

요청 파라미터

응답 파라미터

오브젝트 메타데이터 생성 및 변경

구문

POST /v1/AUTH_{project_id}/{container}/{object}

요청 예

curl -i -X POST -H "X-Auth-Token: $token" -H "X-Object-Meta-Subject: test-object" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예

HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx31cb8b345bac4fe7b33ab-005b9f7388
X-Openstack-Request-Id: tx31cb8b345bac4fe7b33ab-005b9f7388
Date: Mon, 17 Sep 2018 09:27:37 GMT

오브젝트 메타데이터를 생성 및 변경합니다. 요청이 성공하게 되면 Accepted (202) 상태 코드를 응답합니다.

요청 파라미터

응답 파라미터