Eliminar una regla de carpeta
curl --request DELETE \
--url https://blob.vertracloud.app/v1/rules/{prefix} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/rules/{prefix}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/rules/{prefix}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/rules/{prefix}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"rules": [],
"etag": "v4"
}
}
Reglas de carpeta
Eliminar una regla de carpeta
Elimina la regla de un prefijo de carpeta y devuelve las reglas restantes con el nuevo etag.
DELETE
/
v1
/
rules
/
{prefix}
Eliminar una regla de carpeta
curl --request DELETE \
--url https://blob.vertracloud.app/v1/rules/{prefix} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/rules/{prefix}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/rules/{prefix}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/rules/{prefix}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"rules": [],
"etag": "v4"
}
}
Elimina la regla de un prefijo de carpeta. Los objetos que ya están guardados en la carpeta no cambian. La respuesta es la
lista restante con su nuevo
etag. Eliminar una regla que no existe no es un error: responde 200 con la lista actual,
así que la llamada se puede repetir sin problema.
Ámbito: blob:write.
string
requerido
Prefijo de carpeta, codificado en URL.
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
curl -X DELETE "https://blob.vertracloud.app/v1/rules/tmp%2F" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object
Las reglas restantes y su nuevo etag.
Mostrar propiedades
Mostrar propiedades
object[]
Reglas de carpeta. Se aplica el prefijo coincidente más largo.
string
Prefijo de carpeta, que siempre se guarda con
/ al final.string
Visibilidad por defecto de los objetos nuevos de la carpeta.
number
Caducidad por defecto de cada objeto nuevo, en segundos.
number
Archivo aceptado más grande, en bytes, de 512 B a 10 GB.
string[]
Extensiones aceptadas, de 1 a 50, en minúsculas, sin el punto.
string
cache_control por defecto de los objetos nuevos.number
Los objetos se eliminan estos días después de subirlos, de 1 a 3650.
string
Cuándo empieza a aplicarse
delete_after_days, lo fija la plataforma (24 horas después de guardar la regla).string
Fecha ISO 8601 de creación de la regla.
string
Versión de la lista completa de reglas. Envíala de vuelta en
If-Match cuando reemplaces la lista.{
"response": {
"rules": [],
"etag": "v4"
}
}
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 cabeceraAuthorization.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:readoblob:write);details.requiredlo indica.WORKSPACE_PERMISSION_DENIED(403): Solo conworkspace_id: no eres miembro, o tu rol no tiene el permiso de blob.WORKSPACE_NOT_FOUND(404): Solo conworkspace_id: no existe un workspace con ese ID, o no eres miembro.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026