Blob ファイルの削除

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

必須

アカウントの API キーです。これはアカウント設定で確認できます。

削除は、1 つのファイル、または 1 回のリクエストで最大 100 個のファイルを削除します。削除は即時かつ最終的なものです: ファイルは配信されなくなり、その容量はストレージ枠から解放されます。blob:write スコープが必要です。削除には有効なプランは不要なので、いつでもクリーンアップできます。

1 つの id (object、または要素が 1 つだけの objects): 削除されると 200、ファイルが存在しない場合は 404 OBJECT_NOT_FOUND を返します。
2 つ以上の id (objects): 常に 200 を返し、各ファイルの結果を含めるため、1 つのファイルが存在しなくても残りが失敗することはありません。重複した id は 1 回としてカウントされます。

形式が正しくない id や別のアカウントに属する id があると、何かが削除される前にリクエスト全体が 400 INVALID_OBJECT で失敗します。id を確認するにはオブジェクトの一覧を使用してください。

パラメーター

string

削除するファイルの id。object または objects を送信します。

string[]

1 回のリクエストで削除する最大 100 個の id。

レート制限

10 秒間に 1000 ファイル。ファイル単位でカウントされるため、100 個の一括削除は 100 としてカウントされます。超えるとアカウントは短時間ブロックされます (RATE_LIMITED、429)。

レスポンス

string

成功した場合は “success”、失敗した場合は “error” です。

object

一括削除 (2 つ以上の id) の場合のみ含まれます。

表示オブジェクトを切り替え

string[]

削除された id。

string[]

存在しなかった id。

object[]

削除できなかった id。それぞれ { "id", "code" } の形式です。再試行してください。

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

エラー

コード	HTTP	発生する状況
`INVALID_BODY`	400	本文がない、または JSON オブジェクトではない。
`INVALID_OBJECT`	400	id が送信されていない、または id の形式が正しくないか、あなたのものではない。
`TOO_MANY_OBJECTS`	400	id が 100 個を超えている。
`OBJECT_NOT_FOUND`	404	ファイルが存在しない (単一ファイルの場合)。
`RATE_LIMITED`	429	10 秒間に 1000 ファイルを超えて削除した。
`DELETE_FAILED`	500	ストレージでエラーが発生し、ファイルがまだ存在している可能性がある。再試行してください。

関連項目

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

はじめに

オブジェクト

チャンクアップロード

アカウント

共有リンク

S3

Blob ファイルの削除

パラメーター

レート制限

レスポンス

エラー

関連項目

​パラメーター

​レート制限

​レスポンス

​エラー

​関連項目

パラメーター

レート制限

レスポンス

エラー

関連項目