PostContainer

Prev Next

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

컨테이너(버킷)에 메타데이터를 설정하거나 변경합니다.

요청

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

메서드 URI
POST /{containerName}

요청 헤더

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

필드 타입 필수 여부 설명
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
X-Container-Meta-Access-Control-Allow-Origin String Optional CORS 설정
  • 접근 가능한 소스 도메인
X-Container-Meta-Access-Control-Max-Age String Optional CORS 설정
  • 결과를 캐싱할 수 있는 최대 시간(초)
X-Container-Meta-Access-Control-Expose-Headers String Optional CORS 설정
  • 노출되지 않으나 접근을 허용하는 헤더

요청 경로 파라미터

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

필드 타입 필수 여부 설명
containerName String Required 설정 또는 수정할 컨테이너(버킷) 이름

요청 예시

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

curl -X POST "https://archivestorage.apigw.gov-ntruss.com/swift/v1/{containerName}" -H "accept: application/json" -H "X-Container-Meta-Access-Control-Allow-Origin: http://localhost" -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 - 컨테이너의 스토리지 정책 값
X-Timestamp Integer - 컨테이너가 생성된 시각(Unix Timestamp)
X-Container-Bytes-Used Integer - 컨테이너가 사용 중인 용량
X-Trans-Id String - 해당 요청의 트랜잭션 ID
X-Openstack-Request-Id String - 해당 요청의 트랜잭션 ID
  • X-Trans-Id와 동일
X-Container-Object-Count Integer - 컨테이너에 저장된 오브젝트 개수
X-Container-Meta-Access-Control-Allow-Origin String - CORS 설정
  • 입력된 접근 가능 도메인
Referrer-Policy String - HTTP Referrer 헤더 처리 방식
x-ncp-apigw-response-origin String - 응답의 원본 출처
x-ncp-trace-id String - 트랜잭션 추적용 ID

응답 예시

응답 예시는 다음과 같습니다.

HTTP/1.1 204 No Content
Server: nginx
Date: Tue, 16 Apr 2024 01:56:58 GMT
Connection: keep-alive
X-Storage-Policy: standard00
X-Timestamp: 1711960998.26335
X-Container-Bytes-Used: 0
X-Openstack-Request-Id: txf770951820a44a91bc450-00661de4f8
X-Container-Object-Count: 0
X-Container-Meta-Access-Control-Allow-Origin: http://localhost
X-Trans-Id: txf770951820a44a91bc450-00661de4f8
Referrer-Policy: unsafe-url
x-ncp-trace-id: 6cd9l6lj66d356cchgc4rjcc1o
x-ncp-apigw-response-origin: ENDPOINT