3.4.4. S3 put object lock
put 오브젝트 잠금 API는 선택한 버킷에 잠금 구성을 배치합니다. 오브젝트 잠금을 사용하면 WORM(Write-Once-Read-Many) 모델을 사용하여 오브젝트를 저장할 수 있습니다. 개체 잠금을 사용하면 고정된 시간 또는 무기한으로 오브젝트를 삭제하거나 덮어쓰지 않도록 합니다. 오브젝트 잠금 구성에 지정된 규칙은 선택한 버킷에 배치된 모든 새 오브젝트에 기본적으로 적용됩니다.
중요
버킷을 생성할 때 오브젝트 잠금을 활성화합니다. 그렇지 않으면 작업이 실패합니다.
구문
PUT /BUCKET?object-lock HTTP/1.1
예
PUT /testbucket?object-lock HTTP/1.1
요청 엔터티
ObjectLockConfiguration- 설명
- 요청에 대한 컨테이너입니다.
- 유형
- 컨테이너
- 필수 항목
- 제공됨
ObjectLockEnabled- 설명
- 이 버킷에 오브젝트 잠금 구성이 활성화되어 있는지 여부를 나타냅니다.
- 유형
- 문자열
- 필수 항목
- 제공됨
Rule- 설명
- 지정된 버킷에 대한 오브젝트 잠금 규칙입니다.
- 유형
- 컨테이너
- 필수 항목
- 없음
DefaultRetention- 설명
- 지정된 버킷에 배치된 새 오브젝트에 적용되는 기본 보존 기간입니다.
- 유형
- 컨테이너
- 필수 항목
- 없음
모드- 설명
- 기본 오브젝트 잠금 보존 모드입니다. 유효한 값: GOVERNANCE/COMPLIANCE.
- 유형
- 컨테이너
- 필수 항목
- 제공됨
일- 설명
- 기본 보존 기간에 지정된 일 수입니다.
- 유형
- 정수
- 필수 항목
- 없음
년- 설명
- 기본 보존 기간에 지정된 연도 수입니다.
- 유형
- 정수
- 필수 항목
- 없음
HTTP 응답
400- 상태 코드
-
MalformedXML - 설명
- XML이 제대로 구성되어 있지 않습니다.
409- 상태 코드
-
InvalidBucketState - 설명
- 버킷 오브젝트 잠금이 활성화되지 않습니다.