キーと値のペアを削除する

キーと値のペアを削除するには、Worker コードにバインドした任意の KV 名前空間に対して、KV バインディングの delete() メソッドを呼び出します。

env.NAMESPACE.delete(key);

self.env.NAMESPACE.delete(key)

例

Worker 内からキーと値のペアを削除する例です。

export default {
  async fetch(request, env, ctx) {
    try {
      await env.NAMESPACE.delete("first-key");

      return new Response("Successful delete", {
        status: 200
      });
    }
    catch (e)
    {
      return new Response(e.message, {status: 500});
    }
  },
};

from workers import WorkerEntrypoint, Response

class Default(WorkerEntrypoint):
    async def fetch(self, request):
        try:
            await self.env.NAMESPACE.delete("first-key")

            return Response("Successful delete", status=200)
        except Exception as e:
            return Response(str(e), status=500)

リファレンス

KV からの削除には、次のメソッドを使います。

delete()

`delete()` メソッド

キーと値のペアを削除するには、Worker コードにバインドした任意の KV 名前空間で、KV バインディングの delete() メソッドを呼び出します。

env.NAMESPACE.delete(key);

await self.env.NAMESPACE.delete(key)

パラメーター

key: string
- 値に関連付けるキーです。

レスポンス

response: Promise<void>
- 削除が成功すると解決する Promise です。

このメソッドは Promise を返します。削除の成功を確認するには await してください。存在しないキーに対する delete() も、成功として返されます。

delete() メソッドを呼ぶと、KV 名前空間からキーと値が削除されます。他の操作と同様に、Cloudflare のグローバルネットワーク上の各拠点からキーが削除されるまで、時間がかかることがあります。

ガイダンス

データを一括で削除する

Wrangler または REST API で、一度に複数のキーと値のペアを削除できます。

一括 REST API は、一度に最大 10,000 個の KV ペアを受け取れます。一括削除は KV バインディングでは使えません。

KV にアクセスする他の方法

Wrangler のコマンドラインからキーと値のペアを削除する方法と、REST API で削除する方法もあります。