> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Obtener configuración del ciclo de vida del bucket
Requiere la acción de IAM **`storage:GetLifecycleConfiguration`**. Consulte [permisos de almacenamiento](/es/storage/permissions) para obtener la lista completa, lo que cubre cada una y un ejemplo de política.
## OpenAPI
````yaml /es/api-reference/specs/storage.yaml get /v1/buckets/{bucket}/lifecycle
openapi: 3.0.3
info:
title: API de almacenamiento de Basaltic
version: 1.0.0
description: >
Las referencias de almacenamiento aceptan UUID, CRN o nombres de ámbito en
un campo. Los nombres de instantáneas requieren un volumen fijo;
source_snapshot solo acepta UUID o CRN anidado. Bloquee volúmenes con sus
instantáneas y políticas de instantáneas, además de la administración de
buckets para el almacenamiento de objetos. El protocolo de cable S3 en sí se
sirve por separado en `objects.{region}.basaltic.cloud`.
contact:
name: Basaltic Support
email: ping@basaltic.sh
license:
name: Proprietary
url: https://basaltic.sh/terms
servers:
- url: https://storage.{region}.basaltic.sh
description: Punto final de API regional
variables:
region:
default: sa-saopaulo-1
description: Código de región
security:
- BearerAuth: []
paths:
/v1/buckets/{bucket}/lifecycle:
parameters:
- name: bucket
in: path
required: true
schema:
type: string
example: my-app-assets
get:
tags:
- Buckets
summary: Obtener configuración del ciclo de vida del bucket
operationId: getBucketLifecycle
responses:
'200':
description: >-
Configuración y revisión actual del ciclo de vida. Una configuración
sin establecer devuelve un array de reglas vacío y ninguna revisión.
headers:
ETag:
description: >-
Etiqueta de entidad fuerte para esta configuración, adecuada
para If-Match.
schema:
type: string
example: '"none"'
content:
application/json:
schema:
$ref: '#/components/schemas/BucketLifecycleResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
description: No hay tal bucket.
security:
- BearerAuth: []
components:
schemas:
BucketLifecycleResponse:
type: object
required:
- lifecycle
- revision
properties:
revision:
type: string
description: >-
Revisión de configuración opaca. Proporcione este valor entre
comillas dobles como If-Match en PUT o DELETE. La configuración
vacía tiene la revisión none.
example: none
lifecycle:
$ref: '#/components/schemas/LifecycleConfig'
LifecycleConfig:
type: object
required:
- rules
properties:
rules:
type: array
items:
$ref: '#/components/schemas/LifecycleRule'
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- request_id
properties:
code:
type: string
description: Código de error que identifica el tipo de error
example: INVALID_INPUT
message:
type: string
description: Mensaje de error legible por el ser humano
example: Invalid request parameters
params:
type: object
additionalProperties: true
description: >-
Valores no sensibles opcionales para la interpolación de errores
localizados, codificados por código de error. Nunca presente por
errores del servidor.
example:
instances: 2
pools: 0
request_id:
type: string
format: uuid
description: Solicitar ID para depuración
example: 550e8400-e29b-41d4-a716-446655440000
LifecycleRule:
type: object
required:
- status
properties:
id:
type: string
example: expire-old-logs
status:
type: string
description: >-
`disabled` mantiene la regla en la configuración pero la omite
durante la evaluación. El punto final compatible con S3 escribe los
mismos estados `Enabled` / `Disabled` en su XML.
enum:
- enabled
- disabled
example: enabled
filter:
type: object
properties:
prefix:
type: string
example: logs/
transition:
type: object
description: >-
Mover los objetos coincidentes a otra clase de almacenamiento una
vez que sean lo suficientemente antiguos. El objeto mantiene su
identidad (miembros de la misma clave, mismo id de versión, misma
última modificación) y solo sus bytes se mueven entre grupos, por lo
que emparejar una transición con una expiración funciona: el reloj
de expiración no se reinicia al moverse. `days` o `date`. Cuando la
regla también tiene un `expiration`, la transición debe venir
estrictamente primero, de lo contrario el objeto se eliminará antes
de que se mueva y la regla se rechazará.Solo una transición por
regla: la plataforma sirve a dos clases, por lo que una segunda no
tiene a dónde ir.El endpoint compatible con S3 acepta un elemento
único `` La lista de opciones se actualiza
automáticamente y rechaza las más largas en lugar de aplicar
silenciosamente la primera.
required:
- storage_class
properties:
days:
type: integer
minimum: 1
description: Días después de la última hora de modificación del objeto.
example: 30
date:
type: string
format: date-time
description: >-
Corte absoluto; se enciende en el siguiente barrido después de
este instante.
storage_class:
type: string
description: >-
Clase de destino. Mantiene el encaje del estándar S3 en lugar de
la convención de minúsculas de la plataforma, porque el
vocabulario de la clase es de S3. Los valores no soportados son
rechazados — una transición a una clase que no existe nunca se
ejecutaría silenciosamente.
enum:
- STANDARD
- COLD
example: COLD
expiration:
type: object
properties:
days:
type: integer
example: 30
date:
type: string
format: date-time
noncurrent_version_expiration:
type: object
properties:
noncurrent_days:
type: integer
example: 7
newer_noncurrent_versions:
type: integer
example: 3
abort_incomplete_multipart_upload:
type: object
properties:
days_after_initiation:
type: integer
example: 7
responses:
Unauthorized:
description: Se requiere autenticación o el token no es válido
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: Authentication required
request_id: 550e8400-e29b-41d4-a716-446655440000
Forbidden:
description: Permisos insuficientes
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: ACCESS_DENIED
message: You don't have permission to perform this action
request_id: 550e8400-e29b-41d4-a716-446655440000
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >+
Un token bearer de OAuth 2.0, enviado como `Authorization: Bearer
`. Esta es la forma recomendada de autenticación.
Obtén el token intercambiando el par de claves de acceso de una cuenta
de servicio en `POST /v1/oauth/token` con
`grant_type=client_credentials`. Es el flujo estándar de credenciales de
cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar
el token por ti.
```
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
```
Los tokens duran una hora por defecto. El mismo par de claves de acceso
también sirve como credencial AWS SigV4 para el endpoint de objetos
compatible con S3, que solo acepta ese método de autenticación.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.