개요
컨테이너(버킷)의 목록을 조회합니다.
주의
Subaccount의 경우, Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다.
자세한 내용은 Subaccount를 참고해 주십시오.
구문
GET v1/AUTH_{project_id}
요청
요청 파라미터
| Name | In | Type | Description |
|---|---|---|---|
| limit (Optional) | query | integer | 호출 결과의 최대 개수 제한 |
| marker (Optional) | query | string | 특정 컨테이너 이후 목록을 가져옴 |
| end_marker (Optional) | query | string | 특정 컨테이너 이전 목록을 가져옴 |
| prefix (Optional) | query | string | 해당 문자열로 시작하는 컨테이너 목록 호출 |
| reverse (Optional) | query | string | 컨테이너의 이름으로 정렬하여 목록 출력 default : false (descending) |
| X-Auth-Token (Optional) | header | string | 발급한 Token 값 입력 |
| Accept (Optional) | header | string | 호출 결과의 포맷 지정 (application/json, application/xml, text/xml) |
응답
응답 헤더
| Name | In | Type | Description |
|---|---|---|---|
X-Account-Meta-name |
header | string | - 해당 계정의 메타데이터 정보 - 헤더명의 name 부분이 메타데이터의 키 역할을 함 |
| Content-Length | header | string | 응답 결과의 길이 (Bytes) |
| X-Container-Object-Count | header | integer | 해당 컨테이너(버킷)의 오브젝트 개수 |
| X-Container-Bytes-Used | header | integer | 해당 컨테이너(버킷)가 사용하는 전체 용량 크기 (Bytes) |
| X-Container-Meta-Temp-URL-Key (Optional) | header | string | temporary URL을 위한 Secret Key 값 |
| X-Container-Meta-Temp-URL-Key-2 (Optional) | header | string | temporary URL을 위한 두 번째 Secret Key 값 |
| X-Timestamp | header | integer | 해당 컨테이너(버킷)가 생성된 시각 (UNIX Time) |
| X-Trans-Id | header | string | 해당 요청의 트랜젝션 ID |
| X-Openstack-Request-Id | header | string | 해당 요청의 트랜젝션 ID (X-Trans-Id와 동일) |
| Content-Type | header | string | 응답 결과의 포맷 |
| Date | header | string | 해당 요청의 응답 시간 (UTC) |
응답 바디
| Name | In | Type | Description |
|---|---|---|---|
| name | body | string | 해당 오브젝트의 이름 |
| count | body | integer | 해당 컨테이너(버킷)의 오브젝트 개수 |
| bytes | body | integer | 해당 컨테이너(버킷)가 사용하는 전체 용량 크기 (Bytes) |
| last_modified | body | string | 해당 컨테이너가 마지막으로 변경된 시각 (UTC) |
예시
요청 예시(JSON)
curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=json
응답 예시
HTTP/1.1 200 OK
Content-Length: 96
X-Account-Object-Count: 1
X-Timestamp: 1389453423.35964
X-Account-Meta-Subject: Literature
X-Account-Bytes-Used: 14
X-Account-Container-Count: 2
Content-Type: application/json; charset=utf-8
Accept-Ranges: bytes
X-Trans-Id: tx274a77a8975c4a66aeb24-0052d95365
X-Openstack-Request-Id: tx274a77a8975c4a66aeb24-0052d95365
Date: Fri, 17 Jan 2014 15:59:33 GMT
[
{
"count": 0,
"bytes": 0,
"name": "janeausten",
"last_modified": "2013-11-19T20:08:13.283452"
},
{
"count": 1,
"bytes": 14,
"name": "marktwain",
"last_modified": "2016-04-29T16:23:50.460230"
}
]
요청 예시(XML)
curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}?format=XML
응답 예시
HTTP/1.1 200 OK
Content-Length: 262
X-Account-Object-Count: 1
X-Timestamp: 1389453423.35964
X-Account-Meta-Subject: Literature
X-Account-Bytes-Used: 14
X-Account-Container-Count: 2
Content-Type: application/xml; charset=utf-8
Accept-Ranges: bytes
X-Trans-Id: tx69f60bc9f7634a01988e6-0052d9544b
X-Openstack-Request-Id: tx69f60bc9f7634a01988e6-0052d9544b
Date: Fri, 17 Jan 2014 16:03:23 GMT
<?xml version="1.0" encoding="UTF-8"?>
<account name="my_account">
<container>
<name>janeausten</name>
<count>0</count>
<bytes>0</bytes>
<last_modified>2013-11-19T20:08:13.283452</last_modified>
</container>
<container>
<name>marktwain</name>
<count>1</count>
<bytes>14</bytes>
<last_modified>2016-04-29T16:23:50.460230</last_modified>
</container>
</account>
요청이 성공하게 되면 OK(200), No Content(204) 상태 코드를 응답합니다.
No Content (204)인 경우는 Content-Type이 plain 이고, 요청에 해당되는 내용이 없는 경우 발생합니다.
컨테이너(버킷)이 존재하지 않는 경우는 Not Found (403) 상태 코드를 응답합니다.
주의
SubAccount의 경우 SubAccount전용 목록 조회 API를 사용해야 합니다.