GetContainerList
- 인쇄
- PDF
GetContainerList
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
계정에 등록된 컨테이너 목록을 조회합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| GET | - |
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
x-ncp-apigw-timestamp | String | Required | 타임스탬프 값
|
x-ncp-iam-access-key | String | Required | 네이버 클라우드 플랫폼에서 발급받은 API Key 또는 Sub Account에서 발급받은 Access Key |
x-ncp-apigw-signature-v2 | String | Required | Body를 Access Key ID와 맵핑되는 Secret Key로 암호화한 서명값
|
x-ncp-region_code | String | Required | 컨테이너의 리전 코드
|
요청 쿼리 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
limit | Integer | Optional | 호출 결과의 최대 개수 제한 |
marker | String | Optional | 특정 컨테이너(버킷) 이후 목록을 반환 |
end_marker | String | Optional | 특정 컨테이너(버킷) 이전 목록을 반환 |
prefix | String | Optional | 해당 문자열로 시작하는 컨테이너(버킷) 목록 반환 |
reverse | String | Optional | 컨테이너의 이름으로 정렬하여 목록을 출력
|
요청 예시
요청 예시는 다음과 같습니다.
curl -X GET "https://archivestorage.apigw.ntruss.com/swift/v1/?limit=1&marker=test" -H "accept: application/json" -H "x-ncp-region-code: {regionCode}"
-H "x-ncp-iam-access-key: {AccessKey} "
-H "x-ncp-apigw-timestamp: {current timestamp}"
-H "x-ncp-apigw-signature-v2: {generated signature}"
응답
응답 형식을 설명합니다.
응답 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
Connection | String | - | 클라이언트와 서버 간의 TCP 연결 상태 |
Content-Type | String | - | 응답 결과의 MIME 타입 |
Date | String | - | 해당 요청의 응답 시간(UTC) |
Referrer-Policy | String | - | HTTP Referrer 헤더 처리 방식 |
Server | String | - | 응답 서버 |
Transfer-Encoding | String | - | 응답 데이터의 전송 방식 |
X-Account-Bytes-Used | Integer | - | 컨테이너가 사용 중인 용량 |
X-Account-Container-Count | Integer | - | 해당 어카운트에 있는 전체 컨테이너(버킷) 개수 |
X-Account-Object-Count | Integer | - | 해당 어카운트의 전체 오브젝트 개수 |
x-account-project-domain-id | String | - | API 이용 시 필요한 Domain ID |
X-Account-Storage-Policy-name-Bytes-Used | Integer | - | 헤더명의 name에 해당하는 storage policy의 전체 용량 크기(Byte) |
X-Account-Storage-Policy-name-Container-Count | Integer | - | 헤더명의 name에 해당하는 Storage Policy의 전체 컨테이너(버킷) 개수 |
X-Account-Storage-Policy-name-Object-Count | Integer | - | 헤더명의 name에 해당하는 storage policy의 전체 오브젝트 개수 |
x-ncp-apigw-response-origin | String | - | 응답의 원본 출처 |
x-ncp-trace-id | String | - | 트랜잭션 추적용 ID |
X-Trans-Id | String | - | 요청의 트랜잭션 ID |
X-Openstack-Request-Id | String | - | 요청의 트랜잭션 ID
|
X-Timestamp | Integer | - | 컨테이너가 생성된 시각(Unix Time) |
응답 구문
응답 구문은 다음과 같습니다.
[
{
“name”: “test”,
“count”: 0,
“bytes”: 0,
“last_modified”: “2022-04-20T01:10:10.123456”
}
]
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
name | String | - | 해당 컨테이너의 이름 |
count | Integer | - | 해당 컨테이너에 있는 오브젝트 개수 |
bytes | Integer | - | 해당 컨테이너에 있는 전체 오브젝트의 크기(Byte) |
last_modified | String | - | 최종 수정 일시 |
응답 상태 코드
네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Ncloud API 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
HTTP/1.1 200 OK
connection: keep-alive
content-type: application/json
date: Tue,16 Apr 2024 02:18:45 GMT
referrer-policy: unsafe-url
server: nginx
transfer-encoding: chunked
x-account-bytes-used: 30129
x-account-container-count: 3
x-account-object-count: 3
x-account-project-domain-id: default
x-account-storage-policy-standard00-bytes-used: 30129
x-account-storage-policy-standard00-container-count: 3
x-account-storage-policy-standard00-object-count: 3
x-ncp-apigw-response-origin: ENDPOINT
x-ncp-trace-id: 38cb565j34pho32or46pij0opg
x-openstack-request-id: tx5c30c46d8a0a450ea6291-00661de005
x-timestamp: 1711960998.26335
x-trans-id: tx5c30c46d8a0a450ea6291-00661de005
[
{
"name": "c11",
"count": 1,
"bytes": 13160,
"last_modified": "2024-04-01T05:43:18.300410"
},
{
"name": "c12",
"count": 2,
"bytes": 16969,
"last_modified": "2024-04-08T02:40:30.317280"
},
{
"name": "c33",
"count": 0,
"bytes": 0,
"last_modified": "2024-04-16T08:42:57.160680"
}
]
이 문서가 도움이 되었습니까?