Supprimer des fichiers

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

requis

La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.

Delete supprime un fichier, ou jusqu’à 100 fichiers en une seule requête. Une suppression est immédiate et définitive : le fichier cesse d’être servi et son espace est libéré de votre quota. Nécessite le scope blob:write. La suppression ne nécessite pas de plan actif, vous pouvez donc toujours faire le ménage.

Un seul id (object, ou objects avec une seule entrée) : répond 200 lorsqu’il est supprimé, 404 OBJECT_NOT_FOUND lorsque le fichier n’existe pas.
Deux id ou plus (objects) : répond toujours 200 avec le résultat de chaque fichier, de sorte qu’un fichier manquant ne fait pas échouer les autres. Les id répétés ne comptent qu’une fois.

Un id mal formé ou appartenant à un autre compte fait échouer toute la requête avec 400 INVALID_OBJECT, avant toute suppression. Pour trouver les id, utilisez Liste d’objets.

Paramètres

string

L’id du fichier à supprimer. Envoyez object ou objects.

string[]

Jusqu’à 100 id à supprimer en une seule requête.

Limites de débit

1000 fichiers par 10 secondes, comptés par fichier : un lot de 100 compte pour 100. Au-delà, le compte est bloqué pendant une courte période (RATE_LIMITED, 429).

Réponse

string

“success” en cas de succès, “error” sinon.

object

Présent uniquement pour les lots (deux id ou plus).

Afficher Afficher l'objet

string[]

Les id qui ont été supprimés.

string[]

Les id qui n’existaient pas.

object[]

Les id qui n’ont pas pu être supprimés, chacun sous la forme { "id", "code" }. Réessayez-les.

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": []
  }
}

Erreurs

Code	HTTP	Quand
`INVALID_BODY`	400	Le corps est absent ou n’est pas un objet JSON.
`INVALID_OBJECT`	400	Aucun id n’a été envoyé, ou un id est mal formé ou ne vous appartient pas.
`TOO_MANY_OBJECTS`	400	Plus de 100 id.
`OBJECT_NOT_FOUND`	404	Le fichier n’existe pas (fichier unique).
`RATE_LIMITED`	429	Plus de 1000 fichiers supprimés en 10 secondes.
`DELETE_FAILED`	500	Le stockage a échoué et le fichier existe peut-être encore. Réessayez.

Voir aussi

SDK 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": []
  }
}

Premiers pas

Objets

Uploads par morceaux

Compte

Liens de partage

S3

Paramètres

Limites de débit

Réponse

Erreurs

Voir aussi

​Paramètres

​Limites de débit

​Réponse

​Erreurs

​Voir aussi

Paramètres

Limites de débit

Réponse

Erreurs

Voir aussi