Eliminar archivos de Blob Storage

DELETE

objects

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "object": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png" }'

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "objects": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png",
      "pub/3155597145698959364/images/old.png"
    ]
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ objects: ids.slice(0, 100) }),
});

{
  "status": "success"
}

{
  "status": "success",
  "response": {
    "deleted": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png"
    ],
    "not_found": ["pub/3155597145698959364/images/old.png"],
    "failed": []
  }
}

string

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Delete elimina un archivo, o hasta 100 archivos en una sola solicitud. Una eliminación es inmediata y definitiva: el archivo deja de servirse y su espacio se libera de tu cuota. Requiere el scope blob:write. Eliminar no requiere un plan activo, así que siempre puedes hacer limpieza.

Un id (object, u objects con una sola entrada): responde 200 cuando se elimina, 404 OBJECT_NOT_FOUND cuando el archivo no existe.
Dos o más ids (objects): siempre responde 200 con el resultado de cada archivo, así que un archivo inexistente no hace fallar al resto. Los ids repetidos cuentan una vez.

Un id mal formado o que pertenece a otra cuenta hace fallar toda la solicitud con 400 INVALID_OBJECT, antes de eliminar nada. Para encontrar los ids, usa Object List.

Parámetros

string

El id del archivo a eliminar. Envía object u objects.

string[]

Hasta 100 ids a eliminar en una solicitud.

Límites de tasa

1000 archivos cada 10 segundos, contados por archivo: un lote de 100 cuenta como 100. Por encima de eso, la cuenta se bloquea durante un breve periodo (RATE_LIMITED, 429).

Respuesta

string

“success” si tuvo éxito, “error” si no.

object

Solo aparece en los lotes (dos o más ids).

Mostrar Alternar objeto

string[]

Los ids que se eliminaron.

string[]

Los ids que no existían.

object[]

Los ids que no se pudieron eliminar, cada uno como { "id", "code" }. Reinténtalos.

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "object": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png" }'

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "objects": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png",
      "pub/3155597145698959364/images/old.png"
    ]
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ objects: ids.slice(0, 100) }),
});

{
  "status": "success"
}

{
  "status": "success",
  "response": {
    "deleted": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png"
    ],
    "not_found": ["pub/3155597145698959364/images/old.png"],
    "failed": []
  }
}

Errores

Código	HTTP	Cuándo
`INVALID_BODY`	400	El cuerpo falta o no es un objeto JSON.
`INVALID_OBJECT`	400	No se envió ningún id, o un id está mal formado o no es tuyo.
`TOO_MANY_OBJECTS`	400	Más de 100 ids.
`OBJECT_NOT_FOUND`	404	El archivo no existe (un solo archivo).
`RATE_LIMITED`	429	Más de 1000 archivos eliminados en 10 segundos.
`DELETE_FAILED`	500	El almacenamiento falló y el archivo puede seguir existiendo. Reintenta.

Relacionado

SDK de Blob: blob.delete()

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "object": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png" }'

curl --request DELETE \
  --url 'https://blob.squarecloud.app/v1/objects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "objects": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png",
      "pub/3155597145698959364/images/old.png"
    ]
  }'

const response = await fetch('https://blob.squarecloud.app/v1/objects', {
  method: 'DELETE',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ objects: ids.slice(0, 100) }),
});

{
  "status": "success"
}

{
  "status": "success",
  "response": {
    "deleted": [
      "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "prv/3155597145698959364/images/draft_mugws5c0-1b4f0e9851971998e732078544c96b36.png"
    ],
    "not_found": ["pub/3155597145698959364/images/old.png"],
    "failed": []
  }
}

Primeros pasos

Objetos

Subidas por partes

Cuenta

Enlaces compartidos

S3

Eliminar archivos de Blob Storage

Parámetros

Límites de tasa

Respuesta

Errores

Relacionado

​Parámetros

​Límites de tasa

​Respuesta

​Errores

​Relacionado

Parámetros

Límites de tasa

Respuesta

Errores

Relacionado