Skip to main content
GET
Get bucket lifecycle configuration
Requires the IAM action storage:GetLifecycleConfiguration. See STORAGE permissions for the full list, what each one covers, and an example policy.

Authorizations

Authorization
string
header
required

An OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. This is the recommended way to authenticate.

Get one by exchanging a service account's access key pair at POST /v1/oauth/token with grant_type=client_credentials. It is the standard client-credentials grant, so any OAuth-aware library will obtain and refresh it for you.

Tokens last an hour by default. The same access key pair is separately your AWS SigV4 credential for the S3-compatible object endpoint, which speaks nothing else.

Path Parameters

bucket
string
required
Example:

"my-app-assets"

Response

Current lifecycle configuration and revision. An unset configuration returns an empty rules array and revision none.

revision
string
required

Opaque configuration revision. Supply this value in double quotes as If-Match on PUT or DELETE. The empty configuration has revision none.

Example:

"none"

lifecycle_rules
object[]
required