CompleteBucketWorm is used to lock a retention policy.

Usage notes

By default, a time-based policy is in the InProgress state after the policy is created for a bucket. The state remains valid for 24 hours. Within the validity period, the retention policy protects the data in the bucket.

  • In the 24-hour window after the retention policy is enabled: If the retention policy is not locked, the bucket owner and authorized users can delete this policy. If the retention policy is locked, the protection period of the policy cannot be shortened and the policy cannot be deleted. The protection period can only be prolonged.
  • 24 hours after the retention policy is enabled: If the retention policy is not locked, the policy becomes invalid.

Examples

  • Sample requests
    POST /? wormId=xxx HTTP/1.1
    Date: GMT Date
    Host: BucketName.oss.aliyuncs.com
    Authorization: SignatureValue
  • Sample responses
    HTTP/1.1 200 OK
    x-oss-request-id: RequestId
    Date: Date
    Content-Type: application/xml
    Content-Length: length