---
title: "GetContainer "
slug: "storage-archivestorage-getcontainer"
updated: 2026-10-22T10:47:58Z
published: 2026-10-22T10:47:58Z
canonical: "api-gov.ncloud-docs.com/storage-archivestorage-getcontainer"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GetContainer
Classic/VPC 환경에서 이용 가능합니다.
컨테이너(버킷)에 속한 오브젝트 목록과 메타데이터를 조회합니다.
## 요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
| --- | --- |
| GET | /v1/AUTH_{project_id}/{container} |
### 요청 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Required | 발급한 토큰(Token) 값 |
| `X-Newest` | Boolean | Optional | 가장 최근 복제본의 정보로 응답할지 여부를 설정 - `true` \| `false` - `true`: 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답 - 헤더가 생략된 경우, 응답이 가장 빠른 정보로 응답 |
| `Accept` | String | Optional | 호출 결과의 포맷 지정 - `application/json` \|`application/xml` \|`text/xml` |
| `X-Account-Meta-Temp-URL-Key` | String | Optional | temporary URL을 위한 Secret Key 값 |
| `X-Account-Meta-Temp-URL-Key-2` | String | Optional | temporary URL을 위한 두 번째 Secret Key 값 |
### 요청 경로 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `project_id` | String | Required | 프로젝트 ID - 프로젝트 ID 확인 방법은 [Archive Storage 개요](/docs/storage-archivestorage#%EC%9D%B8%EC%A6%9D) 참조 |
| `container` | String | Required | 컨테이너(버킷) 이름 |
### 요청 쿼리 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `limit` | Integer | Optional | 호출 결과의 최대 개수 제한 |
| `marker` | String | Optional | 특정 컨테이너(버킷) 이후 목록을 반환 |
| `end_marker` | String | Optional | 특정 컨테이너(버킷) 이전 목록을 반환 |
| `prefix` | String | Optional | 해당 문자열로 시작하는 컨테이너(버킷) 목록 반환 |
| `format` | String | Optional | 호출 결과의 포맷 지정 (json, xml, plain) |
| `delimiter` | String | Optional | 해당 문자열을 구분자로 사용하여, 컨테이너(버킷) 목록을 계층 구조로 표현 |
| `path` | String | Optional | 해당 경로 내부의 오브젝트 목록을 반환 - `path` 옵션보다는 `prefix`, `delimiter` 옵션 권장 |
### 요청 예시
요청 예시는 다음과 같습니다.
#### format 쿼리 파라미터 없이 요청
`format` 쿼리 파라미터 없이 요청하는 예시는 다음과 같습니다.
```
curl -X GET "https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}"
-H "X-Auth-Token: $token"
```
#### format 쿼리 파라미터를 JSON으로 요청
`format` 쿼리 파라미터를 JSON으로 요청하는 예시는 다음과 같습니다.
```
curl -X GET "https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=json"
-H "X-Auth-Token: $token"
```
#### format 쿼리 파라미터를 XML로 요청
`format` 쿼리 파라미터를 JSON으로 요청하는 예시는 다음과 같습니다.
```
curl -X GET "https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=xml"
-H "X-Auth-Token: $token"
```
## 응답
응답 형식을 설명합니다.
### 응답 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `Content-Type` | String | - | 응답 결과의 MIME 타입 |
| `X-Container-Object-Count` | Integer | - | 해당 컨테이너(버킷)의 전체 오브젝트 개수 |
| `X-Container-Bytes-Used` | Integer | - | 해당 컨테이너(버킷)가 사용하는 전체 용량 크기(Byte) |
| `X-Timestamp` | Integer | - | 컨테이너(버킷)가 생성된 시각(Unix Timestamp) |
| `Last-Modified` | String | - | 해당 컨테이너(버킷)의 가장 최근 수정 시간(UTC) |
| `Accept-Ranges` | String | - | 해당 컨테이너(버킷)가 허용하는 Range 타입 |
| `Content-Length` | String | - | 응답 결과의 길이 (Bytes) |
| `X-Storage-Policy` | String | Optional | 해당 컨테이너(버킷)의 storage policy 값 |
| `X-Trans-Id` | String | - | 해당 요청의 트랜잭션 ID |
| `X-Openstack-Request-Id` | String | - | 해당 요청의 트랜잭션 ID - X-Trans-Id와 동일 |
| `X-Container-Meta-name` | String | | 해당 컨테이너(버킷)의 메타데이터 - 헤더명의 `name` 부분이 메타데이터의 키 역할을 함 |
| `X-Container-Meta-Temp-URL-Key` | String | Optional | temporary URL을 위한 Secret Key 값 |
| `X-Container-Meta-Temp-URL-Key-2` | String | Optional | temporary URL을 위한 두 번째 Secret Key 값 |
| `X-Container-Meta-Quota-Count` | String | Optional | 해당 컨테이너(버킷)의 오브젝트 수의 제한값 |
| `X-Container-Meta-Quota-Bytes` | String | Optional | 해당 컨테이너(버킷)의 용량 제한값 |
| `X-Container-Read` | String | Optional | 해당 컨테이너(버킷)의 READ ACL(접근 권한) |
| `X-Container-Write` | String | Optional | 해당 컨테이너(버킷)의 WRITE ACL(접근 권한) |
| `X-Container-Sync-Key` | String | Optional | 사용하지 않음 |
| `X-Container-Sync-To` | String | Optional | 사용하지 않음 |
| `X-Versions-Location` | String | Optional | 사용하지 않음 |
| `X-History-Location` | String | Optional | 사용하지 않음 |
| `Date` | String | - | 해당 요청의 응답 시간(UTC) |
### 응답 상태 코드
응답 상태 코드에 대한 설명은 다음과 같습니다.
| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
| --- | --- | --- | --- |
| 200 | - | OK | 요청 성공 |
| 204 | - | No Content | Content-Type이 `plain`이고, 요청에 해당되는 내용이 없는 경우 발생 |
| 404 | - | Not Found | 컨테이너(버킷)이 존재하지 않는 경우 발생 |
### 응답 구문
응답 구문은 다음과 같습니다.
format 쿼리 파라미터 없이 요청한 경우에는 컨테이너(버킷)에 속한 오브젝트의 이름만 plain 텍스트 포맷으로 응답합니다.
```
"string"
```
```
[
{
"hash":"string",
"last_modified":"string",
"bytes":"number",
"name":"string",
"content_type":"string"
}
]
```
```
```
### 응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `hash` | String | - | 해당 오브젝트의 MD5 체크섬 값 |
| `name` | String | - | 해당 컨테이너(버킷)의 이름 |
| `count` | Integer | - | 해당 컨테이너(버킷)에 있는 오브젝트 개수 |
| `bytes` | Integer | - | 해당 컨테이너(버킷)에 있는 전체 오브젝트의 크기(Byte) |
| `content_type` | String | - | 응답 결과의 MIME 타입 |
| `last_modified` | String | - | 최 수정 수정 일시 |
### 응답 예시
응답 예시는 다음과 같습니다.
#### 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
```
```
```