PostContainer
    • PDF

    PostContainer

    • PDF

    Article Summary

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

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

    요청

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

    메서드URI
    POST/{containerName}

    요청 헤더

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

    필드타입필수 여부설명
    x-ncp-apigw-timestampStringRequired타임스탬프 값
    • 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초로 나타낸 것
    • APIGW 서버와 시간차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
    x-ncp-iam-access-keyStringRequired네이버 클라우드 플랫폼에서 발급받은 API Key 또는 Sub Account에서 발급받은 Access Key
    x-ncp-apigw-signature-v2StringRequiredBody를 Access Key ID와 맵핑되는 Secret Key로 암호화한 서명값
    • HMAC 암호화 알고리즘은 HmacSHA256 사용
    x-ncp-region_codeStringRequired컨테이너의 리전 코드
    • <예시> 한국: KR | 싱가포르: SGN
    X-Container-Meta-Access-Control-Allow-OriginStringOptionalCORS 설정
    • 접근 가능한 소스 도메인
    X-Container-Meta-Access-Control-Max-AgeStringOptionalCORS 설정
    • 결과를 캐싱할 수 있는 최대 시간(초)
    X-Container-Meta-Access-Control-Expose-HeadersStringOptionalCORS 설정
    • 노출되지 않으나 접근을 허용하는 헤더

    요청 경로 파라미터

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

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

    요청 예시

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

    curl -X POST "https://archivestorage.apigw.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}"
    

    응답

    응답 형식을 설명합니다.

    응답 헤더

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

    필드타입필수 여부설명
    ServerString-응답 서버
    DateString-해당 요청의 응답 시간(UTC)
    ConnectionString-클라이언트와 서버 간의 TCP 연결 상태
    X-Storage-PolicyInteger-컨테이너의 스토리지 정책 값
    X-TimestampInteger-컨테이너가 생성된 시각(Unix Timestamp)
    X-Container-Bytes-UsedInteger-컨테이너가 사용 중인 용량
    X-Trans-IdString-해당 요청의 트랜잭션 ID
    X-Openstack-Request-IdString-해당 요청의 트랜잭션 ID
    • X-Trans-Id와 동일
    X-Container-Object-CountInteger-컨테이너에 저장된 오브젝트 개수
    X-Container-Meta-Access-Control-Allow-OriginString-CORS 설정
    • 입력된 접근 가능 도메인
    Referrer-PolicyString-HTTP Referrer 헤더 처리 방식
    x-ncp-apigw-response-originString-응답의 원본 출처
    x-ncp-trace-idString-트랜잭션 추적용 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
    

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.