GetAccount
- 인쇄
- PDF
GetAccount
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
어카운트에 속한 컨테이너(버킷) 목록과 어카운트의 메타데이터를 조회합니다.
구문
GET /v1/AUTH_{project_id}
요청
| 명칭 | In | 타입 | 설명 |
|---|---|---|---|
| project_id | path | string | 프로젝트 ID 입력 |
| limit (Optional) | query | integer | 호출 결과의 최대 개수 제한 |
| marker (Optional) | query | string | 특정 컨테이너(버킷) 이후 목록을 가져옴 |
| end_marker (Optional) | query | string | 특정 컨테이너(버킷) 이전 목록을 가져옴 |
| format (Optional) | query | string | 호출 결과의 포맷을 지정함 (json, xml, plain) |
| prefix (Optional) | query | string | 해당 문자열로 시작하는 컨테이너(버킷) 목록 호출 |
| delimiter (Optional) | query | string | 해당 문자열을 구분자로 사용하여, 컨테이너(버킷) 목록을 계층구조로 표현 가능 |
| X-Auth-Token (Optional) | header | string | 발급한 Token 값을 입력함 |
| X-Newest (Optional) | header | boolean | true 인 경우, 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답 해당 헤더가 생략된 경우, 가장 응답이 빠른 정보로 응답 |
| Accept (Optional) | header | string | 호출 결과의 포맷을 지정함 (application/json, application/xml, text/xml) |
응답
| 명칭 | In | 타입 | 설명 |
|---|---|---|---|
| Content-Length | header | string | 응답 결과의 길이 (Bytes) |
X-Account-Meta-name (Optional) | header | string | 어카운트의 메타데이터 (헤더명의 name 부분이 메타데이터의 키 역할을 함) |
| X-Account-Meta-Temp-URL-Key (Optional) | header | string | temporary URL을 위한 Secret Key 값 |
| X-Account-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와 동일) |
| Date | header | string | 해당 요청의 응답 시간 (UTC) |
| X-Account-Bytes-Used | header | integer | 해당 어카운트가 사용하는 전체 크기 (Bytes) |
| X-Account-Container-Count | header | integer | 해당 어카운트에 있는 전체 컨테이너(버킷) 개수 |
| X-Account-Object-Count | header | integer | 해당 어카운트의 전체 오브젝트 개수 |
X-Account-Storage-Policy-name-Bytes-Used | header | integer | name 에 해당하는 storage policy 의 전체 크기 (Bytes) |
X-Account-Storage-Policy-name-Container-Count | header | integer | name 에 해당하는 storage policy 의 전체 컨테이너(버킷) 개수 |
X-Account-Storage-Policy-name-Object-Count | header | integer | name 에 해당하는 storage policy 의 전체 오브젝트 개수 |
| X-Account-Meta-Quota-Bytes (Optional) | header | string | 해당 어카운트의 용량 제한값 (Bytes) |
| Content-Type | header | string | 응답 결과의 MIME 타입 |
| count | body | integer | 해당 컨테이너에 있는 오브젝트 개수 |
| bytes | body | integer | 해당 컨테이너에 있는 전체 오브젝트의 크기 (Bytes) |
| name | body | string | 해당 컨테이너의 이름 |
예시
요청 예시
curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}
응답 예시
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-container-0
ncloud-container-1
요청 예시(JSON)
curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}?format=json
응답 예시
HTTP/1.1 200 OK
Content-Length: 206
Accept-Ranges: bytes
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 0
X-Account-Container-Count: 2
Content-Type: application/json; charset=utf-8
X-Account-Object-Count: 0
x-account-project-domain-id: default
X-Trans-Id: txddbf20f97d1043128d032-005b97260f
X-Openstack-Request-Id: txddbf20f97d1043128d032-005b97260f
Date: Tue, 11 Sep 2018 02:18:55 GMT
[
{
"count":0,
"last_modified":"2018-09-11T02:11:35.010250",
"bytes":0,
"name":"ncloud-container-0"
},
{
"count":0,
"last_modified":"2018-09-11T02:11:41.481410",
"bytes":0,
"name":"ncloud-container-1"
}
]
요청 예시(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: 392
Accept-Ranges: bytes
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 0
X-Account-Container-Count: 2
Content-Type: application/xml; charset=utf-8
X-Account-Object-Count: 0
x-account-project-domain-id: default
X-Trans-Id: tx1a6fca0d191645c186b35-005b9726d3
X-Openstack-Request-Id: tx1a6fca0d191645c186b35-005b9726d3
Date: Tue, 11 Sep 2018 02:22:11 GMT
<?xml version="1.0" encoding="UTF-8"?>
<account name="AUTH_5942771066a0482bb6aaf7f5bc792b00">
<container>
<name>ncloud-container-0</name>
<count>0</count>
<bytes>0</bytes>
<last_modified>2018-09-11T02:11:35.010250</last_modified>
</container>
<container>
<name>ncloud-container-1</name>
<count>0</count>
<bytes>0</bytes>
<last_modified>2018-09-11T02:11:41.481410</last_modified>
</container>
</account>
요청이 성공하게 되면 OK (200), No Content (204) 상태 코드를 응답합니다.
No Content (204)인 경우는 Content-Type이 plain 이고, 요청에 해당되는 내용이 없는 경우 발생합니다.
이 문서가 도움이 되었습니까?