Bucket の確認

ある Bucket が既に作成されているか確認できます。

確認方法は以下のとおりです。

アプリケーションスコープの Bucket

curl -v -X HEAD \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  "https://api-jp.kii.com/api/apps/{APP_ID}/buckets/{BUCKET_ID}"

グループスコープの Bucket

curl -v -X HEAD \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  "https://api-jp.kii.com/api/apps/{APP_ID}/groups/{GROUP_ID}/buckets/{BUCKET_ID}"

ユーザースコープの Bucket

curl -v -X HEAD \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  "https://api-jp.kii.com/api/apps/{APP_ID}/users/me/buckets/{BUCKET_ID}"

Thing スコープの Bucket

curl -v -X HEAD \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  "https://api-jp.kii.com/api/apps/{APP_ID}/things/{THING_ID}/buckets/{BUCKET_ID}"

いずれの場合も、Kii Cloud は以下の応答を返します。

  • Bucket が存在する場合は 204 応答
  • Bucket が存在しない場合は 404 応答
  • 対象スコープに対するアクセス権限がない場合は 401 応答