コンテンツにスキップ

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

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

env.NAMESPACE.delete(key);

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

export default {
async fetch(request, env, ctx) {
try {
await env.NAMESPACE.delete("first-key");
return new Response("削除に成功しました", {
status: 200
});
}
catch (e)
{
return new Response(e.message, {status: 500});
}
},
};

参照

KVから削除するために提供されているメソッド:

delete() メソッド

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

env.NAMESPACE.delete(key);

パラメータ

  • key: string
    • 値に関連付けるキー。

レスポンス

  • response: Promise<void>
    • 削除が成功した場合に解決されるPromise

このメソッドは、成功した削除を確認するためにawaitする必要があるプロミスを返します。存在しないキーに対してdelete()を呼び出すと、成功した削除として返されます。

delete()メソッドを呼び出すと、あなたのKV名前空間からキーと値が削除されます。すべての操作と同様に、Cloudflareのグローバルネットワークのさまざまなポイントからキーが削除されるまでに時間がかかる場合があります。

ガイダンス

データを一括削除する

Wranglerを使用するか、API経由で一度に複数のキーと値のペアを削除します。

一括APIは、一度に最大10,000のKVペアを受け入れることができます。KVバインディングを使用した一括書き込みはサポートされていません。

KVにアクセスするための他のメソッド

コマンドラインでWranglerを使用してキーと値のペアを削除することも、APIを使用して行うこともできます。