Obtener las reglas de carpeta y su ETag
curl --request GET \
--url https://blob.vertracloud.app/v1/rules \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/rules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/rules"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/rules"
req, _ := http.NewRequest("GET", 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": [
{
"prefix": "tmp/",
"delete_after_days": 30,
"active_from": "2026-10-15T12:00:00.000Z",
"created_at": "2026-10-14T12:00:00.000Z"
}
],
"etag": "v3"
}
}
Reglas de carpeta
Obtener las reglas de carpeta y su ETag
Devuelve las reglas de carpeta de la cuenta y el etag que debes enviar de vuelta al reemplazarlas.
GET
/
v1
/
rules
Obtener las reglas de carpeta y su ETag
curl --request GET \
--url https://blob.vertracloud.app/v1/rules \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/rules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/rules"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/rules"
req, _ := http.NewRequest("GET", 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": [
{
"prefix": "tmp/",
"delete_after_days": 30,
"active_from": "2026-10-15T12:00:00.000Z",
"created_at": "2026-10-14T12:00:00.000Z"
}
],
"etag": "v3"
}
}
Devuelve todas las reglas de carpeta de la cuenta y el
etag de la lista. Lee la lista antes de cambiarla, y envía el
etag de vuelta en If-Match al reemplazar todas las reglas.
Ámbito: blob:read.
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 "https://blob.vertracloud.app/v1/rules" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object
La lista de reglas y su 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": [
{
"prefix": "tmp/",
"delete_after_days": 30,
"active_from": "2026-10-15T12:00:00.000Z",
"created_at": "2026-10-14T12:00:00.000Z"
}
],
"etag": "v3"
}
}
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