Saltar al contenido principal
PUT
Reemplazar todas las reglas de carpeta
Reemplaza la lista completa de reglas de carpeta por la lista que envías. La cabecera If-Match debe contener el etag de tu última lectura; si la lista cambió desde entonces, la llamada falla con BLOB_RULES_CONFLICT y no se guarda nada. Para cambiar una sola regla, usa Crear o actualizar una regla. Ámbito: blob:write.
string
requerido
El etag de la última lectura de la lista de reglas.
object[]
requerido
La lista completa de reglas. Cada elemento acepta prefix (obligatorio) más los campos de Crear o actualizar una regla. Hasta 100 reglas, y cada regla necesita al menos un campo además del prefijo. expire_seconds no puede ser menor que el plazo mínimo de caducidad del plan.
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 guardada 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.
  • VALIDATION_ERROR (400): Un parámetro o un campo del cuerpo no superó la validación. details.path indica el campo; si falta la cabecera If-Match, devuelve este error con details.path en if-match.
  • BLOB_NAMESPACE_SUSPENDED (403): El almacenamiento de blob de la cuenta está suspendido, o su plan expiró.
  • PLAN_RESTRICTED_FEATURE (403): Una regla pone cache_control en no-cache en un plan inferior a Enterprise-26.
  • BLOB_RULES_CONFLICT (409): El etag de If-Match no está actualizado. Vuelve a leer la lista y reintenta.
  • BLOB_RULE_LIMIT (409): La lista tiene más reglas de las que permite el plan: 5, 10 o 20.
Última modificación el 28 de octubre de 2026