# Durable Objects

コンピュートとストレージを組み合わせた、特別な種類の Cloudflare Worker です

> 以下のリンクは、各ページの Markdown 版を直接指します。 任意のページは、`index.md` サフィックスなしの URL に `Accept: text/markdown` ヘッダーを付けて取得することもできます（例: `curl -H "Accept: text/markdown" https://developers.cloudflare.com/durable-objects/`）。
>
> その他の Cloudflare 製品は、[Cloudflare ドキュメントディレクトリ](https://developers.cloudflare.com/llms.txt) を参照してください。

## 概要

- [Cloudflare Durable Objects](https://developers.cloudflare.com/durable-objects/index.md): Durable Objects でステートフルなサーバーレスアプリケーションを構築します。AI エージェント、リアルタイムチャット、共同作業アプリなどです。

## はじめに

- [はじめに](https://developers.cloudflare.com/durable-objects/get-started/index.md): SQLite ストレージを持つ最初の Durable Object と、連携する Worker を作成してデプロイします。

## REST API

- [REST API](https://developers.cloudflare.comhttps://developers.cloudflare.com/api/resources/durable_objects/subresources/namespaces/methods/list/index.md): Cloudflare REST API を使って Durable Objects の名前空間とオブジェクトを管理します。

## 例

- [例](https://developers.cloudflare.com/durable-objects/examples/index.md): カウンター、WebSocket、アラームなど、Durable Objects の一般的なパターンを示すコード例です。
- [Agents](https://developers.cloudflare.com/agents/index.md): Cloudflare 上で AI 搭載の Agents を構築します。
- [Alarms API を使う](https://developers.cloudflare.com/durable-objects/examples/alarms-api/index.md): Durable Objects の Alarms API を使い、Durable Object へのリクエストをバッチ処理します。
- [カウンターを作る](https://developers.cloudflare.com/durable-objects/examples/build-a-counter/index.md): Durable Objects と Workers の RPC メソッドでカウンターを作ります。
- [Durable Object のインメモリ状態](https://developers.cloudflare.com/durable-objects/examples/durable-object-in-memory-state/index.md): 最後にアクセスされた場所をメモリ上に保存する Durable Object を作成します。
- [Durable Object の Time To Live](https://developers.cloudflare.com/durable-objects/examples/durable-object-ttl/index.md): Durable Objects の Alarms API を使い、Durable Object インスタンスに Time To Live（TTL）を実装します。
- [Durable Object と Workers で ReadableStream を使う](https://developers.cloudflare.com/durable-objects/examples/readable-stream/index.md): Durable Objects から ReadableStream をストリームします。
- [RpcTarget クラスで Durable Object のメタデータを扱う](https://developers.cloudflare.com/durable-objects/examples/reference-do-name-using-init/index.md): RpcTarget を使い、Durable Object 内から名前にアクセスします。
- [Durable Objects をテストする](https://developers.cloudflare.com/durable-objects/examples/testing-with-durable-objects/index.md): Workers Vitest 連携を使い、Durable Objects のテストを書きます。
- [Durable Objects から Workers KV を使う](https://developers.cloudflare.com/durable-objects/examples/use-kv-from-durable-objects/index.md): Durable Object 内から KV を読み書きします
- [WebSocket Hibernation で WebSocket サーバーを作る](https://developers.cloudflare.com/durable-objects/examples/websocket-hibernation-server/index.md): Durable Objects と Workers の WebSocket Hibernation を使い、WebSocket サーバーを作ります。
- [WebSocket サーバーを構築する](https://developers.cloudflare.com/durable-objects/examples/websocket-server/index.md): Durable Objects と Workers で WebSocket サーバーを構築します。

## チュートリアル

- [チュートリアル](https://developers.cloudflare.com/durable-objects/tutorials/index.md): 実際のアプリケーションを作るための、Durable Objects の手順付きチュートリアルです。
- [Durable Objects の SQLite で座席予約アプリを作る](https://developers.cloudflare.com/durable-objects/tutorials/build-a-seat-booking-app/index.md): このチュートリアルでは、Durable Objects を使って座席予約アプリを作る方法を説明します。

## デモとアーキテクチャ

- [デモとアーキテクチャ](https://developers.cloudflare.com/durable-objects/demos/index.md): Durable Objects を使うデモアプリケーションとリファレンスアーキテクチャを確認できます。

## 動画

- [動画](https://developers.cloudflare.com/durable-objects/video-tutorials/index.md): Durable Objects でステートフルアプリケーションを構築する動画チュートリアルを視聴します。

## リリースノート

- [リリースノート](https://developers.cloudflare.com/durable-objects/release-notes/index.md): Durable Objects の最新の変更、修正、新機能を確認します。

## api

- [Alarms](https://developers.cloudflare.com/durable-objects/api/alarms/index.md): Alarms API を使い、Durable Objects を将来の時刻に起こすスケジュールを設定します。少なくとも 1 回（at-least-once）の実行が保証されます。
- [Durable Object 基底クラス](https://developers.cloudflare.com/durable-objects/api/base/index.md): DurableObject 抽象基底クラスと、そのハンドラーメソッドの API リファレンスです。
- [Durable Object Container](https://developers.cloudflare.com/durable-objects/api/container/index.md): Durable Object に関連付けたコンテナへアクセスし、開始、停止、やり取りのメソッドを管理します。
- [Durable Object ID](https://developers.cloudflare.com/durable-objects/api/id/index.md): Durable Object を指定するために使う 64 桁の 16 進識別子 DurableObjectId の API リファレンスです。
- [KV-backed Durable Object Storage（レガシー）](https://developers.cloudflare.com/durable-objects/api/legacy-kv-storage-api/index.md): レガシーの KV バックエンド Durable Objects ストレージメソッド（get、put、delete、list を含む）の API リファレンスです。
- [Durable Object Namespace](https://developers.cloudflare.com/durable-objects/api/namespace/index.md): DurableObjectNamespace の API リファレンスです。ID を作成し、Durable Objects とやり取りするためのスタブを取得します。
- [SQLite バックエンドの Durable Object Storage](https://developers.cloudflare.com/durable-objects/api/sqlite-storage-api/index.md): SQLite バックエンドの Durable Object ストレージの API リファレンスです。SQL API とキーバリューメソッドを含みます。
- [Durable Object State](https://developers.cloudflare.com/durable-objects/api/state/index.md): 並行性、WebSocket の接続、ストレージアクセスを制御する DurableObjectState の API リファレンスです。
- [Durable Object Stub](https://developers.cloudflare.com/durable-objects/api/stub/index.md): リモート Durable Object の RPC メソッドを呼び出すクライアント DurableObjectStub の API リファレンスです。
- [WebGPU](https://developers.cloudflare.com/durable-objects/api/webgpu/index.md): ローカル開発の Durable Objects 内から、WebGPU API で GPU にアクセスします。

## best-practices

- [Durable Objects ストレージへのアクセス](https://developers.cloudflare.com/durable-objects/best-practices/access-durable-objects-storage/index.md): Worker 内または外部から、Storage API を使って Durable Objects の永続データを読み書きします。
- [メソッドを呼び出す](https://developers.cloudflare.com/durable-objects/best-practices/create-durable-object-stubs-and-send-requests/index.md): Worker からスタブを使い、Durable Objects の RPC メソッドを呼ぶか、fetch リクエストを送ります。
- [エラー処理](https://developers.cloudflare.com/durable-objects/best-practices/error-handling/index.md): 再試行可能なエラーと過負荷エラーを含め、Durable Objects からの例外を推奨パターンで処理します。
- [Durable Objects のルール](https://developers.cloudflare.com/durable-objects/best-practices/rules-of-durable-objects/index.md): Durable Objects アプリケーションを正しく効果的に作るための設計ガイドラインです。使うタイミングと使い方を説明します。
- [WebSocket を使う](https://developers.cloudflare.com/durable-objects/best-practices/websockets/index.md): Durable Objects から WebSocket 接続を提供します。標準 API と Hibernation API を含みます。

## concepts

- [Durable Object のライフサイクル](https://developers.cloudflare.com/durable-objects/concepts/durable-object-lifecycle/index.md): Durable Object の作成、起動、リクエスト処理、最終的なエビクションまでの流れを理解します。
- [Durable Objects とは](https://developers.cloudflare.com/durable-objects/concepts/what-are-durable-objects/index.md): Durable Objects は、永続ストレージを持つ、グローバルに一意でシングルスレッドのコンピュートインスタンスを Cloudflare 上で提供します。

## observability

- [Data Studio](https://developers.cloudflare.com/durable-objects/observability/data-studio/index.md): Cloudflare dashboard UI から、SQLite バックエンドの Durable Object ストレージデータを表示・編集します。
- [メトリクスとアナリティクス](https://developers.cloudflare.com/durable-objects/observability/metrics-and-analytics/index.md): Cloudflare ダッシュボードまたは GraphQL API で、Durable Objects の名前空間レベルおよびリクエストレベルのメトリクス、アナリティクス、ログを確認します。
- [トラブルシューティング](https://developers.cloudflare.com/durable-objects/observability/troubleshooting/index.md): wrangler dev と wrangler tail で Durable Objects をデバッグし、過負荷やストレージに関するよくあるエラーを解決します。

## platform

- [既知の問題](https://developers.cloudflare.com/durable-objects/platform/known-issues/index.md): Durable Objects の既知の問題です。グローバル一意性の保証、コード更新、開発ツールの制限を含みます。
- [上限](https://developers.cloudflare.com/durable-objects/platform/limits/index.md): Free プランと Workers Paid プランにおける、Durable Objects のアカウント、ストレージ、CPU、SQL の上限です。
- [料金](https://developers.cloudflare.com/durable-objects/platform/pricing/index.md): Durable Objects のコンピュートとストレージの課金です。料金例と無料枠の上限を含みます。
- [データまたはストレージ製品を選ぶ](https://developers.cloudflare.com/workers/platform/storage-options/index.md): Cloudflare のストレージおよびデータ製品を比較し、Durable Objects の用途に合う選択肢を見つけます。

## reference

- [データの所在地](https://developers.cloudflare.com/durable-objects/reference/data-location/index.md): Durable Objects を特定の管轄に制限するか、location hint を指定して、データの保存と処理の場所を制御します。
- [データセキュリティ](https://developers.cloudflare.com/durable-objects/reference/data-security/index.md): Durable Objects のデータセキュリティ特性です。保存時の暗号化、転送時の暗号化、コンプライアンス認証を含みます。
- [Durable Object class のマイグレーション（レガシー）](https://developers.cloudflare.com/durable-objects/reference/durable-object-class-migrations-legacy/index.md): レガシーの Wrangler `migrations` 配列を使い、Durable Object class の作成、名前変更、削除、転送を行います。
- [段階的デプロイ](https://developers.cloudflare.com/workers/versions-and-deployments/gradual-deployments/index.md#gradual-deployments-for-durable-objects): Durable Objects への変更を段階的にデプロイします。
- [Durable Object クラスの exports](https://developers.cloudflare.com/durable-objects/reference/durable-objects-migrations/index.md): `wrangler.json` の宣言的な `exports` フィールドで、Durable Object クラスのライフサイクル（作成、削除、名前変更、転送）を管理します。
- [環境](https://developers.cloudflare.com/durable-objects/reference/environments/index.md): ステージング、本番、カスタムデプロイ向けに、Wrangler 環境ごとの Durable Object バインディングを設定します。
- [よくある質問](https://developers.cloudflare.com/durable-objects/reference/faq/index.md): Durable Objects の料金、上限、メトリクスに関するよくある質問です。
- [用語集](https://developers.cloudflare.com/durable-objects/reference/glossary/index.md): Cloudflare Durable Objects ドキュメントで使う主な用語の定義です。
- [Durable Object のインメモリ状態](https://developers.cloudflare.com/durable-objects/reference/in-memory-state/index.md): リクエスト間で、Durable Object インスタンス内の一時的なインメモリ状態を保存し、アクセスします。