OpenAICloudflare Developer Platform2026/06/03 0:00

Workers - New Workers bulk secrets API endpoint

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

Workers: 新しい一括シークレットAPIエンドポイント

Key Points

  • 一括作成・更新・削除
  • nullで削除
  • 最大100操作

Summary

Workers向けに、複数のシークレットを単一リクエストで作成・更新・削除できる新しいbulk secrets APIが利用可能になりました。プログラムからJSONをPOSTするか、CLIのwrangler secret bulkで操作できます。

Key Points

  • リクエストはsecretsオブジェクトを含むJSONを送信
  • 値を含むエントリは作成または更新、値をnullにすると削除
  • リクエストに含まれない既存シークレットは変更されない
  • CLI例: npx wrangler secret bulk <secrets.json>.envファイルでの削除は非対応)
  • 1リクエストあたり最大100操作(作成+更新+削除の合計)

Example: {"secrets":{"API_KEY":{"type":"secret_text","name":"API_KEY","text":"my-api-key"},"DB_PASSWORD":{"type":"secret_text","name":"DB_PASSWORD","text":"my-db-password"},"OLD_SECRET":null}}

運用上の注意: 操作の合計が100を超えないよう分割してください。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

Workers - 新しい Workers bulk secrets API エンドポイント

新しい Workers bulk secrets API エンドポイント

Cloudflare の更新: Worker の複数シークレットを単一リクエストで作成、更新、削除できる bulk secrets エンドポイントが利用可能になりました。

  • シークレットを作成または更新するには、値を含めて送信します。
  • シークレットを削除するには、その値を null に設定します。
  • リクエストに含まれていないシークレットは変更されません。

以下の例は API_KEY を作成し、既存の DB_PASSWORD を更新し、OLD_SECRET を削除します:

{
  "secrets": {
    "API_KEY": {
      "type": "secret_text",
      "name": "API_KEY",
      "text": "my-api-key"
    },
    "DB_PASSWORD": {
      "type": "secret_text",
      "name": "DB_PASSWORD",
      "text": "my-db-password"
    },
    "OLD_SECRET": null
  }
}

コマンドラインからは wrangler を使って同じ操作ができます:

npx wrangler secret bulk < secrets.json

注意事項:

  • キーを削除するには JSON ファイルで値を null に設定してください。
  • 削除は .env ファイルではサポートされていません。
  • 各リクエストは最大 100 件の操作(作成、更新、削除の合計)をサポートします。

関連リソース:

  • Resources API
Workers - 新しい Workers bulk secrets API エンドポイント | Cloudflare Developer Platform | DocsDigest