HeadContainer
- 인쇄
- PDF
HeadContainer
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
컨테이너(버킷)의 메타데이터를 조회합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| HEAD | /{containerName} |
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
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 | 컨테이너의 리전 코드
|
요청 경로 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
containerName | String | Required | 조회할 컨테이너(버킷) 이름 |
요청 예시
요청 예시는 다음과 같습니다.
curl -X HEAD "https://archivestorage.apigw.ntruss.com/swift/v1/{containerName}" -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}"
응답
응답 형식을 설명합니다.
응답 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
Server | String | - | 응답 서버 |
Date | String | - | 해당 요청의 응답 시간(UTC) |
Connection | String | - | 클라이언트와 서버 간의 TCP 연결 상태 |
X-Storage-Policy | Integer | - | 해당 컨테이너(버킷)의 Storage Policy 값 |
X-Timestamp | Integer | - | 컨테이너(버킷)이 생성된 시각(Unix Timestamp) |
X-Container-Bytes-Used | Integer | - | 해당 컨테이너(버킷)가 사용하는 전체 용량 크기(Byte) |
X-Trans-Id | String | - | 해당 요청의 트랜잭션 ID |
X-Openstack-Request-Id | String | - | 해당 요청의 트랜잭션 ID
|
X-Container-Object-Count | Integer | - | 해당 컨테이너(버킷)의 전체 오브젝트 개수 |
Referrer-Policy | String | - | HTTP Referrer 헤더 처리 방식 |
x-ncp-apigw-response-origin | String | - | 응답의 원본 출처 |
x-ncp-trace-id | String | - | 트랜잭션 추적용 ID |
응답 예시
응답 예시는 다음과 같습니다.
HTTP/1.1 200 OK
Server: nginx
Date: Mon, 15 Apr 2024 23:43:11 GMT
Connection: keep-alive
X-Storage-Policy: standard00
X-Timestamp: 1711960998.26335
X-Container-Bytes-Used: 16969
X-Openstack-Request-Id: tx4b43dc3e46d2471daaafb-00661dbb8f
X-Container-Object-Count: 2
X-Trans-Id: tx4b43dc3e46d2471daaafb-00661dbb8f
Referrer-Policy: unsafe-url
x-ncp-trace-id: 6cd9l6lj66d356cchgc4rjcc1o
x-ncp-apigw-response-origin: ENDPOINT
이 문서가 도움이 되었습니까?