GetContainerList

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

계정에 등록된 컨테이너 목록을 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET -

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
x-ncp-apigw-timestamp String Required 타임스탬프 값
  • 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초로 나타낸 것
  • APIGW 서버와 시간차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
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로 암호화한 서명값
  • HMAC 암호화 알고리즘은 HmacSHA256 사용
x-ncp-region_code String Required 컨테이너의 리전 코드
  • <예시> 한국: KR | 싱가포르: SGN

요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
limit Integer Optional 호출 결과의 최대 개수 제한
marker String Optional 특정 컨테이너(버킷) 이후 목록을 반환
end_marker String Optional 특정 컨테이너(버킷) 이전 목록을 반환
prefix String Optional 해당 문자열로 시작하는 컨테이너(버킷) 목록 반환
reverse String Optional 컨테이너의 이름으로 정렬하여 목록을 출력
  • true | false (기본값)
    • false: 내림차순

요청 예시

요청 예시는 다음과 같습니다.

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-Trans-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"
  }
]