Lifecycle Rules

Configure automatic object expiration and cleanup policies for your Stook Buckets.

List lifecycle rules

get

Retrieves a list of all lifecycle rules configured for a specific storage bucket.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

bucket_uuidstringRequired

Unique identifier for the storage bucket.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the request was successful.

422

Validation error

application/json

get/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle

GET /api/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle HTTP/1.1
Host: cloud.medianova.com
Accept: */*

{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "status": true,
      "expiration_days": 1,
      "filter_prefix": "text",
      "filter_tags": [
        {
          "key": "text",
          "label": "text"
        }
      ]
    }
  ]
}

Retrieve lifecycle rule details

get

Retrieves configuration details for a specific lifecycle rule applied to a storage bucket.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

bucket_uuidstringRequired

Unique identifier for the storage bucket.

lifecycle_uuidstringRequired

Unique identifier for the specific lifecycle rule.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the request was successful.

422

Validation error

application/json

get/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle/{lifecycle_uuid}

GET /api/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle/{lifecycle_uuid} HTTP/1.1
Host: cloud.medianova.com
Accept: */*

{
  "status": true,
  "data": {
    "uuid": "text",
    "status": true,
    "expiration_days": 1,
    "filter_prefix": "text",
    "filter_tags": [
      {
        "key": "text",
        "label": "text"
      }
    ]
  }
}

Create a lifecycle rule

post

Creates a new lifecycle rule for a specific storage bucket to automate object expiration in the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

bucket_uuidstringRequired

Unique identifier for the storage bucket.

Body

expiration_daysintegerRequired

Number of days before objects in the bucket expire.

filter_prefixstringOptional

Path prefix to limit the rule to specific objects.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the lifecycle rule was created successfully.

422

Validation error

application/json

post/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle

POST /api/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "expiration_days": 1,
  "filter_prefix": "text",
  "filter_tags": [
    {
      "key": "text",
      "label": "text"
    }
  ]
}

{
  "status": true,
  "data": {
    "uuid": "text",
    "status": true,
    "expiration_days": 1,
    "filter_prefix": "text"
  }
}

Update a lifecycle rule

put

Updates the configuration of an existing lifecycle rule for a specific storage bucket in the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

bucket_uuidstringRequired

Unique identifier for the storage bucket.

lifecycle_uuidstringRequired

Unique identifier for the lifecycle rule to be updated.

Body

statusbooleanOptional

Sets the active status of the lifecycle rule.

expiration_daysintegerOptional

Updated number of days before object expiration.

filter_prefixstringOptional

Updated path prefix for object filtering.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the lifecycle rule update was successful.

422

Validation error

application/json

put/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle/{lifecycle_uuid}

PUT /api/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle/{lifecycle_uuid} HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "status": true,
  "expiration_days": 1,
  "filter_prefix": "text"
}

{
  "status": true,
  "data": {
    "uuid": "text",
    "status": true,
    "expiration_days": 1,
    "filter_prefix": "text"
  }
}

Delete a lifecycle rule

delete

Permanently removes a specific lifecycle rule from a storage bucket in the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

bucket_uuidstringRequired

Unique identifier for the storage bucket.

lifecycle_uuidstringRequired

Unique identifier for the lifecycle rule to be deleted.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the lifecycle rule was successfully deleted.

messagestringOptional

Confirmation message regarding the deletion operation.

operation_idstringOptional

Unique identifier for the operation log.

422

Validation error

application/json

delete/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle/{lifecycle_uuid}

DELETE /api/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/lifecycle/{lifecycle_uuid} HTTP/1.1
Host: cloud.medianova.com
Accept: */*

{
  "status": true,
  "message": "text",
  "operation_id": "text"
}