Documentation Index

Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

PutObjectLockConfiguration

Prev Next

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

Ncloud Storage 버킷에 Object Lock 설정을 적용합니다. Object Lock을 사용하면 객체를 일정 기간 또는 무기한 삭제·변경되지 않도록 보관할 수 있습니다.

요청

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

메서드 URI
PUT -

요청 헤더

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

참고

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오.

필드 필수 여부 설명
Content-MD5 Conditional 요청 바디의 Base64 인코딩된 128비트 MD5 해시값
  • 요청 바디 무결성 검증에 사용
  • x-amz-checksum-*를 입력하지 않은 경우, 필수 입력
x-amz-checksum-* Conditional 체크섬 해시 값
  • 키의 *에 사용한 알고리즘 입력
    • 지원 알고리즘: crc32 | crc32c | sha1 | sha256 | crc64nvme
  • Content-MD5를 입력하지 않은 경우, 필수 입력

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
ObjectLockConfiguration Object Required Object Lock 설정
ObjectLockConfiguration.ObjectLockEnabled String Required Object Lock 활성화 여부
  • Enabled (유효 값)
ObjectLockConfiguration.Rule Object Optional 기본 보존 규칙
  • 미 지정 시 기본 보존 기간을 설정하지 않음
ObjectLockConfiguration.Rule.DefaultRetention Object Optional 기본 보존 설정
  • Rule 지정 시 필수
ObjectLockConfiguration.Rule.DefaultRetention.Mode String Optional 기본 보존 모드
  • GOVERNANCE | COMPLIANCE
    • GOVERNANCE: 특별 권한으로 우회 가능
    • COMPLIANCE: 누구도 우회 불가
ObjectLockConfiguration.Rule.DefaultRetention.Days Integer Optional 기본 보존 기간(일)
  • 1~36,500
  • Years와 함께 지정 불가(택 1)
ObjectLockConfiguration.Rule.DefaultRetention.Years Integer Optional 기본 보존 기간(년)
  • 1~100
  • Days와 함께 지정 불가(택 1)

요청 예시

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

PUT /?object-lock HTTP/1.1
Host: {Bucket}.kr.ncloudstorage.com
Content-MD5: {MD5 해시값}

<?xml version="1.0" encoding="UTF-8"?>
<ObjectLockConfiguration>
    <ObjectLockEnabled>Enabled</ObjectLockEnabled>
    <Rule>
        <DefaultRetention>
            <Mode>GOVERNANCE</Mode>
            <Days>30</Days>
        </DefaultRetention>
    </Rule>
</ObjectLockConfiguration>

응답

응답 형식을 설명합니다.

응답 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 응답 헤더를 참조해 주십시오.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Storage 응답 상태 코드를 참조해 주십시오.

에러 코드 HTTP 상태 코드 설명
InvalidArgument 400 기본 보존 기간이 유효 범위를 벗어남
  • Days/Years가 양의 정수가 아님
  • Days(36,500)/Years(100) 상한 초과
MalformedXML 400 요청 바디 XML이 스키마에 맞지 않음
  • ObjectLockEnabledEnabled가 아님
  • ModeGOVERNANCE/COMPLIANCE가 아님
  • DaysYears를 동시에 지정하거나 둘 다 미지정

응답 예시

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

HTTP/1.1 200 OK