API de almacenamiento de objetos

Gestiona los buckets y objetos del equipo. Los nombres de los buckets son globalmente únicos. Los objetos se suben usando el cuerpo del archivo sin procesar. Las credenciales S3 recién creadas aparecen en las respuestas; mantén esas respuestas privadas.

Usa Autenticación de la API para las solicitudes protegidas. Los ejemplos usan tus propios IDs de recursos y un token temporal; las respuestas de ejemplo guardadas son sintéticas.

Método	Ruta	Operación
GET	/v1/object_bucket	Listar buckets
POST	/v1/object_bucket	Crear bucket
GET	/v1/object_bucket/{id}	Obtener bucket
PUT	/v1/object_bucket/{id}	Actualizar bucket
DELETE	/v1/object_bucket/{id}	Eliminar bucket
GET	/v1/object_bucket/{id}/objects	Listar objetos del bucket
GET	/v1/object_bucket/{id}/object	Descargar objeto del bucket
PUT	/v1/object_bucket/{id}/object	Subir objeto al bucket
DELETE	/v1/object_bucket/{id}/object	Eliminar objeto del bucket
POST	/v1/object_bucket/{id}/folders	Crear carpeta del bucket
DELETE	/v1/object_bucket/{id}/folders	Eliminar carpeta del bucket
GET	/v1/object_bucket/{id}/access-keys	Listar claves de acceso al bucket
POST	/v1/object_bucket/{id}/access-keys	Crear clave de acceso al bucket
DELETE	/v1/object_bucket/{id}/access-keys/{access_key_id}	Eliminar clave de acceso al bucket

Listar buckets

GET /v1/object_bucket

Devuelve una lista paginada de ObjectBucket

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
page	consulta	no	Número de página
per_page	consulta	no	Elementos por página

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Lista de ObjectBucket

Campos de respuesta

Campo	Tipo	Descripción
data	array
data[].acl_policy	object	Política ACL de objetos de Adios. Es privada de forma predeterminada, con reglas opcionales de prefijos públicos.
data[].backend_bucket	string	Nombre del bucket en el proveedor. Usa de forma predeterminada el nombre normalizado del bucket de objetos.
data[].bucket_id	string
data[].cache_policy	object	Política de caché del gateway para lecturas públicas de objetos.
data[].canonical_hostname	string	Nombre de host del bucket generado por Adios, como bucket.s3.adios.dev.
data[].cdn_policy	object	Política CDN de Adios para lecturas públicas de objetos. Sustituye a cache_policy cuando está configurada.
data[].config	object	Opciones adicionales del proveedor y referencias a secretos.
data[].cors_policy	object	Política CORS de S3 aplicada por Adios antes de pasar por el proxy al backend de objetos.
data[].created_at	integer	(marca de tiempo Unix)
data[].deleted_at	integer	(marca de tiempo Unix)
data[].endpoint	string	Endpoint opcional compatible con S3 para sustituir el de los buckets importados.
data[].managed	boolean
data[].name	string	Espacio de nombres de bucket globalmente único usado para el enrutamiento de bucket.s3.adios.dev y s3.adios.dev/bucket.
data[].provider	string	Valores permitidos: adios, minio, ceph_rgw, external_s3.
data[].public_hostname	string	Nombre de host personalizado opcional propiedad del usuario, servido a través del gateway anycast para acceder al bucket; los espacios de nombres adios.dev y adios.run están reservados.
data[].public_read	boolean
data[].region	string
data[].route_id	string	Ruta del gateway sincronizada para los dominios personalizados de public_hostname.
data[].s3_path_endpoint	string	Endpoint S3 compartido con acceso mediante ruta, como https://s3.adios.dev.
data[].status	string	Valores permitidos: pending, available, failed, deleted.
data[].team_id	string
data[].updated_at	integer	(marca de tiempo Unix)
data[].versioning	boolean
pagination	object
pagination.page	integer	Número de página actual
pagination.per_page	integer	Número de elementos por página
pagination.total	integer	Número total de elementos

Ejemplo ilustrativo; no es una respuesta real:

{
  "data": [
    {
      "acl_policy": {},
      "backend_bucket": "example",
      "bucket_id": "000000000000000000000000001",
      "cache_policy": {},
      "canonical_hostname": "example",
      "cdn_policy": {},
      "config": {},
      "cors_policy": {},
      "created_at": 1791072000,
      "deleted_at": 0,
      "endpoint": "example",
      "managed": true,
      "name": "postman-example",
      "provider": "adios",
      "public_hostname": "example",
      "public_read": false,
      "region": "default",
      "route_id": "000000000000000000000000001",
      "s3_path_endpoint": "example",
      "status": "pending",
      "team_id": "000000000000000000000000001",
      "updated_at": 1791072000,
      "versioning": false
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Crear bucket

POST /v1/object_bucket

Crea un nuevo ObjectBucket

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Campos de la solicitud (el cuerpo contiene un ejemplo editable):

Campo	Tipo	Obligatorio	Descripción
acl_policy	object	no	Política ACL de objetos de Adios. Es privada de forma predeterminada, con reglas opcionales de prefijos públicos.
backend_bucket	string	no	Nombre del bucket en el proveedor. Usa de forma predeterminada el nombre normalizado del bucket de objetos.
cache_policy	object	no	Política de caché del gateway para lecturas públicas de objetos.
canonical_hostname	string	no	Nombre de host del bucket generado por Adios, como bucket.s3.adios.dev.
cdn_policy	object	no	Política CDN de Adios para lecturas públicas de objetos. Sustituye a cache_policy cuando está configurada.
config	object	no	Opciones adicionales del proveedor y referencias a secretos.
cors_policy	object	no	Política CORS de S3 aplicada por Adios antes de pasar por el proxy al backend de objetos.
endpoint	string	no	Endpoint opcional compatible con S3 para sustituir el de los buckets importados.
managed	boolean	sí	Valor predeterminado: true.
name	string	sí	Espacio de nombres de bucket globalmente único usado para el enrutamiento de bucket.s3.adios.dev y s3.adios.dev/bucket.
provider	string	sí	Valores permitidos: adios, minio, ceph_rgw, external_s3. Valor predeterminado: "adios".
public_hostname	string	no	Nombre de host personalizado opcional propiedad del usuario, servido a través del gateway anycast para acceder al bucket; los espacios de nombres adios.dev y adios.run están reservados.
public_read	boolean	sí	Valor predeterminado: false.
region	string	no	Valor predeterminado: "default".
route_id	string	no	Ruta del gateway sincronizada para los dominios personalizados de public_hostname.
s3_path_endpoint	string	no	Endpoint S3 compartido con acceso mediante ruta, como https://s3.adios.dev.
status	string	sí	Valores permitidos: pending, available, failed, deleted. Valor predeterminado: "pending".
team_id	string	sí
versioning	boolean	sí	Valor predeterminado: false.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/object_bucket" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "name": "YOUR_BUCKET_NAME",
  "provider": "adios",
  "managed": true,
  "public_read": false,
  "versioning": false,
  "status": "pending",
  "region": "YOUR_REGION"
}
JSON

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 201

ObjectBucket creado

Campos de respuesta

Campo	Tipo	Descripción
acl_policy	object	Política ACL de objetos de Adios. Es privada de forma predeterminada, con reglas opcionales de prefijos públicos.
backend_bucket	string	Nombre del bucket en el proveedor. Usa de forma predeterminada el nombre normalizado del bucket de objetos.
bucket_id	string
cache_policy	object	Política de caché del gateway para lecturas públicas de objetos.
canonical_hostname	string	Nombre de host del bucket generado por Adios, como bucket.s3.adios.dev.
cdn_policy	object	Política CDN de Adios para lecturas públicas de objetos. Sustituye a cache_policy cuando está configurada.
config	object	Opciones adicionales del proveedor y referencias a secretos.
cors_policy	object	Política CORS de S3 aplicada por Adios antes de pasar por el proxy al backend de objetos.
created_at	integer	(marca de tiempo Unix)
deleted_at	integer	(marca de tiempo Unix)
endpoint	string	Endpoint opcional compatible con S3 para sustituir el de los buckets importados.
managed	boolean
name	string	Espacio de nombres de bucket globalmente único usado para el enrutamiento de bucket.s3.adios.dev y s3.adios.dev/bucket.
provider	string	Valores permitidos: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nombre de host personalizado opcional propiedad del usuario, servido a través del gateway anycast para acceder al bucket; los espacios de nombres adios.dev y adios.run están reservados.
public_read	boolean
region	string
route_id	string	Ruta del gateway sincronizada para los dominios personalizados de public_hostname.
s3_path_endpoint	string	Endpoint S3 compartido con acceso mediante ruta, como https://s3.adios.dev.
status	string	Valores permitidos: pending, available, failed, deleted.
team_id	string
updated_at	integer	(marca de tiempo Unix)
versioning	boolean

Ejemplo ilustrativo; no es una respuesta real:

{
  "acl_policy": {},
  "backend_bucket": "example",
  "bucket_id": "000000000000000000000000001",
  "cache_policy": {},
  "canonical_hostname": "example",
  "cdn_policy": {},
  "config": {},
  "cors_policy": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "endpoint": "example",
  "managed": true,
  "name": "postman-example",
  "provider": "adios",
  "public_hostname": "example",
  "public_read": false,
  "region": "default",
  "route_id": "000000000000000000000000001",
  "s3_path_endpoint": "example",
  "status": "pending",
  "team_id": "000000000000000000000000001",
  "updated_at": 1791072000,
  "versioning": false
}

Obtener bucket

GET /v1/object_bucket/{id}

Devuelve un único ObjectBucket

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

ObjectBucket

Campos de respuesta

Campo	Tipo	Descripción
acl_policy	object	Política ACL de objetos de Adios. Es privada de forma predeterminada, con reglas opcionales de prefijos públicos.
backend_bucket	string	Nombre del bucket en el proveedor. Usa de forma predeterminada el nombre normalizado del bucket de objetos.
bucket_id	string
cache_policy	object	Política de caché del gateway para lecturas públicas de objetos.
canonical_hostname	string	Nombre de host del bucket generado por Adios, como bucket.s3.adios.dev.
cdn_policy	object	Política CDN de Adios para lecturas públicas de objetos. Sustituye a cache_policy cuando está configurada.
config	object	Opciones adicionales del proveedor y referencias a secretos.
cors_policy	object	Política CORS de S3 aplicada por Adios antes de pasar por el proxy al backend de objetos.
created_at	integer	(marca de tiempo Unix)
deleted_at	integer	(marca de tiempo Unix)
endpoint	string	Endpoint opcional compatible con S3 para sustituir el de los buckets importados.
managed	boolean
name	string	Espacio de nombres de bucket globalmente único usado para el enrutamiento de bucket.s3.adios.dev y s3.adios.dev/bucket.
provider	string	Valores permitidos: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nombre de host personalizado opcional propiedad del usuario, servido a través del gateway anycast para acceder al bucket; los espacios de nombres adios.dev y adios.run están reservados.
public_read	boolean
region	string
route_id	string	Ruta del gateway sincronizada para los dominios personalizados de public_hostname.
s3_path_endpoint	string	Endpoint S3 compartido con acceso mediante ruta, como https://s3.adios.dev.
status	string	Valores permitidos: pending, available, failed, deleted.
team_id	string
updated_at	integer	(marca de tiempo Unix)
versioning	boolean

Ejemplo ilustrativo; no es una respuesta real:

{
  "acl_policy": {},
  "backend_bucket": "example",
  "bucket_id": "000000000000000000000000001",
  "cache_policy": {},
  "canonical_hostname": "example",
  "cdn_policy": {},
  "config": {},
  "cors_policy": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "endpoint": "example",
  "managed": true,
  "name": "postman-example",
  "provider": "adios",
  "public_hostname": "example",
  "public_read": false,
  "region": "default",
  "route_id": "000000000000000000000000001",
  "s3_path_endpoint": "example",
  "status": "pending",
  "team_id": "000000000000000000000000001",
  "updated_at": 1791072000,
  "versioning": false
}

Actualizar bucket

PUT /v1/object_bucket/{id}

Actualiza un ObjectBucket existente

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Campos de la solicitud (el cuerpo contiene un ejemplo editable):

Campo	Tipo	Obligatorio	Descripción
acl_policy	object	no	Política ACL de objetos de Adios. Es privada de forma predeterminada, con reglas opcionales de prefijos públicos.
backend_bucket	string	no	Nombre del bucket en el proveedor. Usa de forma predeterminada el nombre normalizado del bucket de objetos.
cache_policy	object	no	Política de caché del gateway para lecturas públicas de objetos.
canonical_hostname	string	no	Nombre de host del bucket generado por Adios, como bucket.s3.adios.dev.
cdn_policy	object	no	Política CDN de Adios para lecturas públicas de objetos. Sustituye a cache_policy cuando está configurada.
config	object	no	Opciones adicionales del proveedor y referencias a secretos.
cors_policy	object	no	Política CORS de S3 aplicada por Adios antes de pasar por el proxy al backend de objetos.
endpoint	string	no	Endpoint opcional compatible con S3 para sustituir el de los buckets importados.
managed	boolean	sí	Valor predeterminado: true.
name	string	sí	Espacio de nombres de bucket globalmente único usado para el enrutamiento de bucket.s3.adios.dev y s3.adios.dev/bucket.
provider	string	sí	Valores permitidos: adios, minio, ceph_rgw, external_s3. Valor predeterminado: "adios".
public_hostname	string	no	Nombre de host personalizado opcional propiedad del usuario, servido a través del gateway anycast para acceder al bucket; los espacios de nombres adios.dev y adios.run están reservados.
public_read	boolean	sí	Valor predeterminado: false.
region	string	no	Valor predeterminado: "default".
route_id	string	no	Ruta del gateway sincronizada para los dominios personalizados de public_hostname.
s3_path_endpoint	string	no	Endpoint S3 compartido con acceso mediante ruta, como https://s3.adios.dev.
status	string	sí	Valores permitidos: pending, available, failed, deleted. Valor predeterminado: "pending".
team_id	string	sí
versioning	boolean	sí	Valor predeterminado: false.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request PUT "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "name": "YOUR_BUCKET_NAME",
  "provider": "adios",
  "managed": true,
  "public_read": false,
  "versioning": false,
  "status": "pending",
  "region": "YOUR_REGION"
}
JSON

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 200

ObjectBucket actualizado

Campos de respuesta

Campo	Tipo	Descripción
acl_policy	object	Política ACL de objetos de Adios. Es privada de forma predeterminada, con reglas opcionales de prefijos públicos.
backend_bucket	string	Nombre del bucket en el proveedor. Usa de forma predeterminada el nombre normalizado del bucket de objetos.
bucket_id	string
cache_policy	object	Política de caché del gateway para lecturas públicas de objetos.
canonical_hostname	string	Nombre de host del bucket generado por Adios, como bucket.s3.adios.dev.
cdn_policy	object	Política CDN de Adios para lecturas públicas de objetos. Sustituye a cache_policy cuando está configurada.
config	object	Opciones adicionales del proveedor y referencias a secretos.
cors_policy	object	Política CORS de S3 aplicada por Adios antes de pasar por el proxy al backend de objetos.
created_at	integer	(marca de tiempo Unix)
deleted_at	integer	(marca de tiempo Unix)
endpoint	string	Endpoint opcional compatible con S3 para sustituir el de los buckets importados.
managed	boolean
name	string	Espacio de nombres de bucket globalmente único usado para el enrutamiento de bucket.s3.adios.dev y s3.adios.dev/bucket.
provider	string	Valores permitidos: adios, minio, ceph_rgw, external_s3.
public_hostname	string	Nombre de host personalizado opcional propiedad del usuario, servido a través del gateway anycast para acceder al bucket; los espacios de nombres adios.dev y adios.run están reservados.
public_read	boolean
region	string
route_id	string	Ruta del gateway sincronizada para los dominios personalizados de public_hostname.
s3_path_endpoint	string	Endpoint S3 compartido con acceso mediante ruta, como https://s3.adios.dev.
status	string	Valores permitidos: pending, available, failed, deleted.
team_id	string
updated_at	integer	(marca de tiempo Unix)
versioning	boolean

Ejemplo ilustrativo; no es una respuesta real:

{
  "acl_policy": {},
  "backend_bucket": "example",
  "bucket_id": "000000000000000000000000001",
  "cache_policy": {},
  "canonical_hostname": "example",
  "cdn_policy": {},
  "config": {},
  "cors_policy": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "endpoint": "example",
  "managed": true,
  "name": "postman-example",
  "provider": "adios",
  "public_hostname": "example",
  "public_read": false,
  "region": "default",
  "route_id": "000000000000000000000000001",
  "s3_path_endpoint": "example",
  "status": "pending",
  "team_id": "000000000000000000000000001",
  "updated_at": 1791072000,
  "versioning": false
}

Eliminar bucket

DELETE /v1/object_bucket/{id}

Elimina un ObjectBucket

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Recurso eliminado.

Campos de respuesta

Campo	Tipo	Descripción
message	string

Ejemplo ilustrativo; no es una respuesta real:

{
  "message": "Deleted successfully"
}

Listar objetos del bucket

GET /v1/object_bucket/{id}/objects

Explora los objetos de un prefijo opcional.

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
prefix	consulta	no	Prefijo de las claves de objetos.
limit	consulta	no	Número de entradas entre 1 y 5000.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/objects" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Descargar objeto del bucket

GET /v1/object_bucket/{id}/object

Lee el cuerpo del objeto sin procesar. Usa la opción de descarga de Postman para guardarlo.

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
key	consulta	sí	Clave de objeto obligatoria.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/object?key=${ADIOS_OBJECT_KEY}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Subir objeto al bucket

PUT /v1/object_bucket/{id}/object

Selecciona un archivo en Body → binary antes de enviar la solicitud. El endpoint acepta bytes sin procesar, no datos de formulario multipart; el límite de subida es 5 GiB.

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
key	consulta	sí	Clave de objeto obligatoria.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request PUT "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/object?key=${ADIOS_OBJECT_KEY}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @./upload.bin

Respuesta: HTTP 201

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Eliminar objeto del bucket

DELETE /v1/object_bucket/{id}/object

Elimina el objeto seleccionado.

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
key	consulta	sí	Clave de objeto obligatoria.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/object?key=${ADIOS_OBJECT_KEY}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 204

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Crear carpeta del bucket

POST /v1/object_bucket/{id}/folders

Crea un marcador de carpeta de objetos.

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/folders" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "prefix": "YOUR_OBJECT_PREFIX"
}
JSON

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 201

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Eliminar carpeta del bucket

DELETE /v1/object_bucket/{id}/folders

Elimina una carpeta y su contenido.

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
prefix	consulta	sí	Prefijo de carpeta obligatorio.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/folders?prefix=${ADIOS_OBJECT_PREFIX}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Listar claves de acceso al bucket

GET /v1/object_bucket/{id}/access-keys

Lista los metadatos de las claves S3 del bucket.

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/access-keys" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Crear clave de acceso al bucket

POST /v1/object_bucket/{id}/access-keys

Crea credenciales S3 para este bucket. Guarda en privado el secreto devuelto; no publiques la respuesta.

Configura object_bucket_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request POST "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/access-keys" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "name": "postman-example"
}
JSON

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 201

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Eliminar clave de acceso al bucket

DELETE /v1/object_bucket/{id}/access-keys/{access_key_id}

Revoca la clave de acceso S3 seleccionada.

Configura object_bucket_id, access_key_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
access_key_id	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-ID	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request DELETE "$ADIOS_API_URL/v1/object_bucket/${ADIOS_OBJECT_BUCKET_ID}/access-keys/${ADIOS_ACCESS_KEY_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.