PUT /accounts/{account_id}/r2/buckets/{bucket_name}/lifecycle

Set the object lifecycle rules for a bucket.

Servers

Path parameters

Name Type Required Description
bucket_name String Yes
account_id String Yes

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

cf-r2-jurisdiction String No

Possible values:

  • "eu"
  • "fedramp"
  • "default"

Default value: "default"

Request body fields

Name Type Required Description
rules[] Array No
rules[].id String Yes

Unique identifier for this rule.

rules[].storageClassTransitions[] Array No

Transitions to change the storage class of objects.

rules[].storageClassTransitions[].condition Object Yes
rules[].storageClassTransitions[].storageClass String Yes

Possible values:

  • "InfrequentAccess"
rules[].deleteObjectsTransition Object No

Transition to delete objects.

rules[].deleteObjectsTransition.condition No
rules[].conditions Object Yes

Conditions that apply to all transitions of this rule.

rules[].conditions.prefix String Yes

Transitions will only apply to objects/uploads in the bucket that start with the given prefix, an empty prefix can be provided to scope rule to all objects/uploads.

rules[].enabled Boolean Yes

Whether or not this rule is in effect.

rules[].abortMultipartUploadsTransition Object No

Transition to abort ongoing multipart uploads.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.