Registrar un almacenamiento

PUT /storages/{name} registra uno de sus almacenamientos compatibles con S3 (AWS S3, Cloudflare R2, Backblaze B2, Wasabi, MinIO, DigitalOcean Spaces …) con el nombre que elija, o reemplaza el que tenga con ese nombre. Una vez registrado, indíquelo en las solicitudes para leer plantillas desde él (source) y guardar archivos en él (Save).

El nombre consta de letras minúsculas, dígitos, - y _, hasta 63. El cuerpo:

Campo
`serviceUrl`	El endpoint del servicio: `https://s3.eu-west-2.amazonaws.com`, `https://ACCOUNT.r2.cloudflarestorage.com` … Debe ser `https`, en la Internet pública.
`region`	La región para la que se firman las solicitudes: la región del bucket en AWS, `auto` en R2, `us-east-1` (el valor predeterminado) en la mayoría de los demás.
`bucket`	El bucket.
`prefix`	Una carpeta del bucket que constituye este almacenamiento: las claves están dentro de ella y no pueden llegar por encima. Si se omite: todo el bucket.
`pathStyle`	Direccionamiento por ruta (endpoint/bucket/clave), como requieren la mayoría de los servicios distintos de AWS. True si no se indica.
`accessKeyId`, `secretAccessKey`	Las claves. Proporcione claves que solo puedan leer y escribir en este bucket o prefijo.

Ejemplo

PUT /storages/main
X-API-KEY: your-api-key
Content-Type: application/json

{
  "serviceUrl": "https://ACCOUNT.r2.cloudflarestorage.com",
  "region": "auto",
  "bucket": "my-bucket",
  "prefix": "piq/",
  "accessKeyId": "your-access-key-id",
  "secretAccessKey": "your-secret-access-key"
}

201 Created para un almacenamiento nuevo, 200 para uno registrado de nuevo:

{
  "name": "main",
  "serviceUrl": "https://ACCOUNT.r2.cloudflarestorage.com",
  "region": "auto",
  "bucket": "my-bucket",
  "prefix": "piq/",
  "pathStyle": true,
  "accessKeyId": "…MPLE",
  "createdAt": "2026-10-31T09:59:42.527Z",
  "updatedAt": "2026-10-31T09:59:42.527Z"
}

El almacenamiento se prueba antes de guardarlo, enumerando su contenido con las claves dadas. Si no se puede acceder a él, no tiene ese bucket o rechaza las claves, no se registra, y la respuesta (502, o 504 si no responde a tiempo) indica el motivo. La clave de acceso secreta se guarda cifrada y nunca se devuelve; el ID de la clave de acceso, solo por sus cuatro últimos caracteres.

Una licencia puede tener hasta 10 almacenamientos: uno más se rechaza (409).

Consulte también: API, Sus almacenamientos, Probar un almacenamiento, Save.