GetContainer

Classic/VPC 환경에서 이용 가능합니다.

컨테이너(버킷)에 속한 오브젝트 목록과 메타데이터를 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

요청 예시

요청 예시는 다음과 같습니다.

format 쿼리 파라미터 없이 요청

format 쿼리 파라미터 없이 요청하는 예시는 다음과 같습니다.

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

format 쿼리 파라미터를 JSON으로 요청

format 쿼리 파라미터를 JSON으로 요청하는 예시는 다음과 같습니다.

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

format 쿼리 파라미터를 XML로 요청

format 쿼리 파라미터를 JSON으로 요청하는 예시는 다음과 같습니다.

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

응답

응답 형식을 설명합니다.

응답 헤더

헤더에 대한 설명은 다음과 같습니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

응답 구문

응답 구문은 다음과 같습니다.

format 쿼리 파라미터 없이 요청한 경우에는 컨테이너(버킷)에 속한 오브젝트의 이름만 plain 텍스트 포맷으로 응답합니다.

"string"

[
   {
      "hash":"string",
      "last_modified":"string",
      "bytes":"number",
      "name":"string",
      "content_type":"string"
   }
]

<?xml version="1.0" encoding="UTF-8"?>
<container name="string">
   <object>
      <name>"string"</name>
      <hash>"string"</hash>
      <bytes>"number"</bytes>
      <content_type>"string"</content_type>
      <last_modified>"string"</last_modified>
   </object>
</container>

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

응답 예시

응답 예시는 다음과 같습니다.

format 쿼리 파라미터 없이 요청한 경우의 응답

format 쿼리 파라미터 없이 요청했을 때의 응답 예시는 다음과 같습니다.

HTTP/1.1 200 OK
Content-Length: 38
Accept-Ranges: bytes
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 0
X-Account-Container-Count: 2
Content-Type: text/plain; charset=utf-8
X-Account-Object-Count: 0
x-account-project-domain-id: default
X-Trans-Id: tx928992622dd248ee9b3e8-005b972569
X-Openstack-Request-Id: tx928992622dd248ee9b3e8-005b972569
Date: Tue, 11 Sep 2018 02:16:09 GMT

ncloud-test-object-0.txt
ncloud-test-object-1.txt

format 쿼리 파라미터를 JSON으로 요청한 경우의 응답

format 쿼리 파라미터를 JSON으로 요청했을 때의 응답 예시는 다음과 같습니다.

HTTP/1.1 200 OK
Content-Length: 352
X-Container-Object-Count: 2
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
X-Storage-Policy: standard01
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 420024
Content-Type: application/json; charset=utf-8
X-Trans-Id: tx6bb706abe32b4ae5a49e8-005b978263
X-Openstack-Request-Id: tx6bb706abe32b4ae5a49e8-005b978263
Date: Tue, 11 Sep 2018 08:52:51 GMT

[
   {
      "hash":"9bd5b4f25faf491080654a34d57c3636",
      "last_modified":"2018-09-11T02:12:29.991410",
      "bytes":210012,
      "name":"ncloud-test-object-0.txt",
      "content_type":"text/plain"
   },
   {
      "hash":"9bd5b4f25faf491080654a34d57c3636",
      "last_modified":"2018-09-11T02:12:29.992600",
      "bytes":210012,
      "name":"ncloud-test-object-1.txt",
      "content_type":"text/plain"
   }
]

format 쿼리 파라미터를 XML로 요청한 경우의 응답

format 쿼리 파라미터를 JSON으로 요청하는 예시는 다음과 같습니다.

HTTP/1.1 200 OK
Content-Length: 520
X-Container-Object-Count: 2
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
X-Storage-Policy: standard01
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 420024
Content-Type: application/xml; charset=utf-8
X-Trans-Id: txfff4e8574d7e43f38b8e8-005b9782ef
X-Openstack-Request-Id: txfff4e8574d7e43f38b8e8-005b9782ef
Date: Tue, 11 Sep 2018 08:55:11 GMT

<?xml version="1.0" encoding="UTF-8"?>
<container name="ncloud-container-0">
   <object>
      <name>ncloud-test-object-0.txt</name>
      <hash>9bd5b4f25faf491080654a34d57c3636</hash>
      <bytes>210012</bytes>
      <content_type>text/plain</content_type>
      <last_modified>2018-09-11T02:12:29.991410</last_modified>
   </object>
   <object>
      <name>ncloud-test-object-1.txt</name>
      <hash>9bd5b4f25faf491080654a34d57c3636</hash>
      <bytes>210012</bytes>
      <content_type>text/plain</content_type>
      <last_modified>2018-09-11T02:12:29.992600</last_modified>
   </object>
</container>