GetAccount
- 인쇄
- PDF
GetAccount
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
어카운트에 속한 컨테이너(버킷) 목록과 메타데이터를 조회합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
메서드 | URI |
---|---|
GET | /v1/AUTH_{project_id} |
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
X-Auth-Token | String | Required | 발급한 토큰(Token) 값 |
X-Newest | Boolean | Optional | 가장 최근 복제본의 정보로 응답할지 여부를 설정
|
Accept | String | Optional | 호출 결과의 포맷 지정
|
요청 경로 파라미터
파라미터에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
project_id | String | Required | 프로젝트 ID
|
요청 쿼리 파라미터
파라미터에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
limit | Integer | Optional | 호출 결과의 최대 개수 제한 |
marker | String | Optional | 특정 컨테이너(버킷) 이후 목록을 반환 |
end_marker | String | Optional | 특정 컨테이너(버킷) 이전 목록을 반환 |
format | String | Optional | 호출 결과의 포맷 지정 (json, xml, plain) |
prefix | String | Optional | 해당 문자열로 시작하는 컨테이너(버킷) 목록 반환 |
delimiter | String | Optional | 해당 문자열을 구분자로 사용하여, 컨테이너(버킷) 목록을 계층 구조로 표현 |
요청 예시
요청 예시는 다음과 같습니다.
format 쿼리 파라미터 없이 요청
format
쿼리 파라미터 없이 요청하는 예시는 다음과 같습니다.
curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
-H "X-Auth-Token: $token"
format 쿼리 파라미터를 JSON으로 요청
format
쿼리 파라미터를 JSON으로 요청하는 예시는 다음과 같습니다.
curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}?format=json"
-H "X-Auth-Token: $token"
format 쿼리 파라미터를 XML로 요청
format
쿼리 파라미터를 JSON으로 요청하는 예시는 다음과 같습니다.
curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}?format=xml"
-H "X-Auth-Token: $token"
응답
응답 형식을 설명합니다.
응답 헤더
헤더에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
Content-Type | String | - | 응답 결과의 MIME 타입 |
X-Account-Container-Count | Integer | Optional | 해당 어카운트에 있는 전체 컨테이너(버킷) 개수 |
X-Account-Object-Count | integer | Optional | 해당 어카운트의 전체 오브젝트 개수 |
X-Account-Bytes-Used | Integer | Optional | 해당 어카운트가 사용하는 전체 용량 크기(Byte) |
X-Timestamp | Integer | - | 어카운트가 생성된 시각(Unix Timestamp) |
X-Account-Storage-Policy-name-Container-Count | Integer | - | 헤더명의 name 에 해당하는 storage policy의 전체 컨테이너(버킷) 개수 |
X-Account-Storage-Policy-name-Object-Count | Integer | - | 헤더명의 name 에 해당하는 storage policy의 전체 오브젝트 개수 |
X-Account-Storage-Policy-name-Bytes-Used | Integer | - | 헤더명의 name 에 해당하는 storage policy의 전체 용량 크기(Byte) |
X-Account-Meta-Quota-Bytes | String | Optional | 해당 어카운트의 용량 제한(Byte) |
X-Account-Meta-name | String | - | 어카운트의 메타데이터
|
X-Account-Meta-Temp-URL-Key | String | - | temporary URL을 위한 Secret Key 값 |
X-Account-Meta-Temp-URL-Key-2 | String | - | temporary URL을 위한 두 번째 Secret Key 값 |
Accept-Ranges | String | - | 해당 어카운트가 허용하는 Range 타입 |
Content-Length | String | - | 응답 결과의 길이(Byte) |
x-account-project-domain-id | String | - | API 이용 시 필요한 Domain ID |
X-Trans-Id | String | - | 해당 요청의 트랜잭션 ID |
X-Openstack-Request-Id | String | - | 해당 요청의 트랜잭션 ID
|
Date | String | - | 해당 요청의 응답 시간(UTC) |
응답 구문
응답 구문은 다음과 같습니다.
format 쿼리 파라미터 없이 요청한 경우에는 컨테이너(버킷)에 속한 오브젝트의 이름만 plain 텍스트 포맷으로 응답합니다.
"string"
[
{
"count": "number",
"last_modified":"string",
"bytes": "number",
"name":"string"
}
]
<?xml version="1.0" encoding="UTF-8"?>
<account name="AUTH_5942771066a0482bb6aaf7f5bc792b00">
<container>
<name>"string"</name>
<count>"number"</count>
<bytes>"number"</bytes>
<last_modified>"string"</last_modified>
</container>
</account>
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
count | Integer | - | 해당 컨테이너에 있는 오브젝트 개수 |
bytes | Integer | - | 해당 컨테이너에 있는 전체 오브젝트의 크기(Byte) |
name | String | - | 해당 컨테이너의 이름 |
last_modified | String | - | 최종 수정 일시 |
응답 상태 코드
응답 상태 코드를 소개합니다.
HTTP 상태 코드 | 코드 | 메시지 | 설명 |
---|---|---|---|
200 | - | OK | 요청 성공 |
204 | - | No Content | Content-Type이 plain 이고, 요청에 해당되는 내용이 없는 경우 발생 |
응답 예시
응답 예시는 다음과 같습니다.
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-container-0
ncloud-container-1
format 쿼리 파라미터를 JSON으로 요청한 경우의 응답
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"
}
]
format 쿼리 파라미터를 XML로 요청한 경우의 응답
format
쿼리 파라미터를 JSON으로 요청하는 예시는 다음과 같습니다.
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>
이 문서가 도움이 되었습니까?