Saltar al contenido principal
PUT
Crear o actualizar una regla de carpeta
Crea la regla de un prefijo de carpeta o la cambia, y deja las demás reglas intactas. Pon el prefijo en la URL, codificado en URL (por ejemplo tmp%2F). La respuesta es la lista completa con su nuevo etag. Ámbito: blob:write.
string
requerido
Prefijo de carpeta, codificado en URL. Se guarda con / al final.
Una regla necesita al menos un campo además del prefijo; una regla vacía devuelve VALIDATION_ERROR.
string
Visibilidad por defecto de los objetos nuevos de la carpeta: public o private.
number
Caducidad por defecto de cada objeto nuevo, en segundos. Como mínimo el plazo mínimo de caducidad del plan (7 días, o 1 hora en Enterprise-26 o superior).
number
Archivo aceptado más grande, de 512 bytes a 10 GB.
string[]
Extensiones aceptadas: de 1 a 50 elementos, cada uno de 1 a 16 caracteres en minúsculas (letras y dígitos), sin el punto.
string
cache_control por defecto de los objetos nuevos. no-cache requiere Enterprise-26 o superior.
number
Elimina los objetos estos días después de subirlos, de 1 a 3650. Se aplica 24 horas después de guardar la regla.
string
El ID del workspace, cuando el blob pertenece a un workspace. La petición actúa sobre el blob del propietario del workspace y necesita el permiso blob:read del workspace (blob:manage en las rutas que modifican datos). Omítelo para actuar sobre tu propio blob.

Ejemplo de petición

Respuesta

object
La lista completa de reglas y su nuevo etag.

Respuestas de error

string
El código de error que indica el motivo del fallo. Valores posibles:
  • AUTH_TOKEN_MISSING (401): No se envió la cabecera Authorization.
  • API_KEY_INVALID (401): La clave de API no existe, fue revocada o su secreto no coincide.
  • API_KEY_SCOPE_DENIED (403): La clave no tiene el ámbito que necesita esta ruta (blob:read o blob:write); details.required lo indica.
  • WORKSPACE_PERMISSION_DENIED (403): Solo con workspace_id: no eres miembro, o tu rol no tiene el permiso de blob.
  • WORKSPACE_NOT_FOUND (404): Solo con workspace_id: no existe un workspace con ese ID, o no eres miembro.
  • BLOB_NAMESPACE_SUSPENDED (403): El almacenamiento de blob de la cuenta está suspendido, o su plan expiró. Las subidas y otras escrituras se rechazan desde el inicio del periodo de gracia de 72 horas.
  • VALIDATION_ERROR (400): Un parámetro o un campo del cuerpo no superó la validación. details.path indica el campo.
  • BLOB_RULE_LIMIT (409): Añadir esta regla superaría el límite de reglas del plan: 5, 10 o 20.
  • PLAN_RESTRICTED_FEATURE (403): cache_control es no-cache en un plan inferior a Enterprise-26.
Última modificación el 28 de octubre de 2026