---
title: "AWS Blocksとは？Block一覧と使い方・0.9.0の変更点、CDKとの違いと採用判断"
url: "https://www.issoh.co.jp/tech/details/12663/"
published: 2026-06-22
updated: 2026-11-14
categories: ["AWS"]
publisher: "株式会社一創"
---

# AWS Blocksとは？Block一覧と使い方・0.9.0の変更点、CDKとの違いと採用判断

AWS Blocksは、データベース・認証・リアルタイム通信・AIエージェントといったバックエンド機能を「Block」という部品として組み合わせ、TypeScriptのコードからAWSのインフラまで生成するオープンソースのフレームワークです。2026年6月16日に[Public Previewとして発表](https://aws.amazon.com/about-aws/whats-new/2026/06/aws-blocks-preview/)され、2026年11月14日時点の最新版は`@aws-blocks/blocks` 0.9.0（11月2日公開）です。公開直後に書かれた試用記事の多くは0.1.x時点の内容で、Blockの数・作成コマンド・本番向けの設定が今とは違います。本記事はnpmで配布されている0.9.0の同梱ドキュメントと変更履歴、公式デベロッパーガイドを照合し、テンプレートを実際に作成・合成した結果も交えて現行仕様を整理します。GPU容量を予約するEC2 Capacity Blocksとは別物です。

## まとめ｜AWS Blocks 0.9.0の現状と採用判断の結論

AWS Blocksは、`aws-blocks/index.ts`に書いたアプリケーションコードからインフラを導出する「Infrastructure from Code」型のフレームワークです。`npm run dev`ならAWSアカウントもDockerも使わずに手元で動き、同じコードを`npm run sandbox`と`npm run deploy`でAWSへ出せます。フレームワーク自体は追加料金なしで、払うのは使ったAWSサービスの料金だけです。

- Blockは0.9.0で22種。9月以降に`Secret`（Secrets Manager）と`Compute`（LambdaとFargateの選択）が加わった
- SQLが要るときの既定は`DistributedDatabase`（Aurora DSQL）。`Database`（Aurora Serverless v2）は既定構成だと最小0.5 ACUの容量料金が常にかかる
- 0.7.0から0.9.0の間に、エラーの返し方・メール送信の検証・Secretの書き込み権限など、デプロイ済みアプリに効く挙動変更が複数入った
- Block ID（コンストラクターの第2引数）の変更でデータが消える危険は0.9.0でも残る。coreにベースライン検査の仕組みは入ったが、公開版のBlockはまだ使っていない

結論として、PoC・社内ツール・新規プロダクトの立ち上げには有力です。一方で、リポジトリの表題は今も「AWS Blocks (Preview)」で、マイナー版ごとに挙動が変わる段階です。停止が許されない基幹系での全面採用は見送り、採用するならバージョンを固定し、更新のたびに変更履歴を読む運用を前提にしてください。

## AWS Blocksの仕組み｜Block・IFC層・conditional exports

### Blockの定義｜ローカル実装・CDK構成・SDK呼び出しを1つにまとめた部品

1つのBlockは、クラウドリソース・実行時のAPI・ローカル実装をまとめた完結した機能で、それぞれが個別のnpmパッケージ（`@aws-blocks/bb-kv-store`など）として配布されています。アンブレラパッケージの`@aws-blocks/blocks`が全Blockとコアランタイムを再エクスポートするので、アプリ側は1つのパッケージからimportするだけです。ライセンスはApache-2.0、リポジトリは[aws-devtools-labs/aws-blocks](https://github.com/aws-devtools-labs/aws-blocks)です。2026年11月14日時点でスター410・フォーク55、未解決のIssueは101件（クローズ済み125件）、`@aws-blocks/blocks`の週次ダウンロードは15,064件（11月6日から12日）で、9月15日から21日の6,815件の約2.2倍に増えています。

### IFC層とApiNamespace｜1つのファイルによるAPIとインフラの定義

バックエンドの入口は`aws-blocks/index.ts`で、[公式のコンセプト解説](https://docs.aws.amazon.com/blocks/latest/devguide/concepts.html)はこれをIFC（Infrastructure from Code）層と呼びます。別管理のインフラ定義ファイルを持つIaCとの違いは、[IaCとは？Infrastructure as Codeの仕組み・メリットと導入判断を解説](/column/details/13004/)で整理しています。Blockはすべて`Scope`の中に生成し、`ApiNamespace`で公開したメソッドをフロントエンドが直接importします。

```
// aws-blocks/index.ts
import { Scope, ApiNamespace, KVStore } from '@aws-blocks/blocks';

const scope = new Scope('my-app');
const store = new KVStore(scope, 'cache');

export const api = new ApiNamespace(scope, 'api', (context) => ({
  async getValue(key: string) {
    return await store.get(key);
  },
  async setValue(key: string, value: string) {
    await store.put(key, value);
  },
}));
```

フロントエンドは`import { api } from 'aws-blocks'`と書くだけで、クライアント生成やURL設定は不要です。通信は`/aws-blocks/api`配下へのJSON-RPCのPOSTで、REST風のパスはありません。注意点として、`ApiNamespace`のメソッドは既定で認証なしの公開エンドポイントです。READMEは、守るメソッドの先頭で`auth.requireAuth(context)`を呼ぶよう求めており、ローカル実装もこれを検出しません。

0.9.0では、`ApiNamespace`に第4引数`{ compute }`を渡して、特定のAPIだけを別のLambda（メモリ4,096MBなど）で動かせるようになりました。ただしAPI呼び出しはゲートウェイ側で約29秒が上限で、それより長い処理は`AsyncJob`に回します。ネイティブアプリ向けには、`npx blocks-generate-spec`で生成するOpenRPC仕様から[Swift・Kotlin・Dartの型付きクライアント](https://docs.aws.amazon.com/blocks/latest/devguide/supported-platforms.html)を作れます。

### conditional exportsの4条件｜実行文脈に応じたimportの切り替え

同じ`new KVStore(scope, 'todos')`が、手元ではファイル保存、synth時にはDynamoDBテーブル、Lambda上ではSDK呼び出しになるのは、Node.jsのconditional exportsで読み込むファイルを切り替えているためです。0.9.0の`@aws-blocks/bb-kv-store`のpackage.jsonを見ると、条件は`default`（ローカル実装）・`cdk`・`aws-runtime`・`browser`の4つです。ローカル実装が`default`なので、本番用のバンドルに`aws-runtime`条件を付け忘れるとモックがそのまま載ります。0.9.0からは、デプロイ環境でモックが読み込まれると起動時（Lambdaでは最初の呼び出し時）に例外で止まるようになりました。

## AWS Blocksで使える22種のBlockとAWSサービスの対応

0.9.0のアンブレラパッケージがエクスポートするBlockと、CDK層で使う`Hosting`を合わせた22種の対応は次のとおりです。[デベロッパーガイドの一覧](https://docs.aws.amazon.com/blocks/latest/devguide/what-is-blocks.html)は2026年11月14日時点でも20種のままで、`Secret`と`Compute`は同梱のREADMEにしか載っていません。

| Block               | 分類    | ローカル実装              | AWS上のサービス                    |
| ------------------- | ----- | ------------------- | ---------------------------- |
| KVStore             | データ   | .bb-data のファイル      | DynamoDB                     |
| DistributedTable    | データ   | .bb-data（索引つき）      | DynamoDB（GSI）                |
| Database            | データ   | PGlite（実Postgres）   | Aurora Serverless v2         |
| DistributedDatabase | データ   | PGlite＋dsql-lint    | Aurora DSQL                  |
| FileBucket          | ストレージ | .bb-data のディレクトリ    | S3                           |
| AuthBasic           | 認証    | ローカルのJWT            | DynamoDB＋JWT                 |
| AuthCognito         | 認証    | ユーザープールの模擬          | Cognito                      |
| AuthOIDC            | 認証    | 疑似IdP（stubIdp）      | 外部のOIDCプロバイダー                |
| AsyncJob            | 非同期   | プロセス内キュー            | SQS＋Lambda／Fargate           |
| CronJob             | 非同期   | プロセス内スケジューラ         | EventBridge Scheduler＋Lambda |
| Compute（0.9.0）      | 実行基盤  | 開発サーバー内             | Lambda／Fargate               |
| Agent               | AI    | Ollama等のOpenAI互換API | Bedrock                      |
| KnowledgeBase       | AI    | ローカル索引              | Bedrock Knowledge Bases      |
| Realtime            | 通信    | 開発サーバーのWebSocket    | API Gateway WebSocket        |
| EmailClient         | 通信    | emails.json へ書き出し   | SES                          |
| AppSetting          | 設定    | .bb-data のファイル      | SSM パラメータストア                 |
| Secret（0.8.0）       | 設定    | モック                 | Secrets Manager              |
| Logger              | 観測性   | 端末へ構造化ログ            | CloudWatch Logs              |
| Metrics             | 観測性   | 端末へEMF出力            | CloudWatch                   |
| Tracer              | 観測性   | ローカル記録              | X-Ray                        |
| Dashboard           | 観測性   | なし                  | CloudWatch ダッシュボード           |
| Hosting             | 配信    | 開発サーバー              | CloudFront＋S3＋Lambda         |

### データBlockの選び方｜既定はDistributedTable、SQLならDistributedDatabase

同梱READMEの「Choosing a data block」は、まず`DistributedTable`（DynamoDB）を既定にし、複数レコードをまたぐ結合・トランザクション・多次元の絞り込みが要るときだけSQL系へ進むよう指示しています。SQL系の第一候補は`DistributedDatabase`（Aurora DSQL）で、待機コストがなくマルチリージョンのアクティブ・アクティブ書き込みもできます。`Database`を選ぶのは、行レベルセキュリティ・トリガー・PL/pgSQL関数、1トランザクションで3,000行を超えて変更する処理（DSQLの変更行数の上限）、既存Postgres（Supabase・Neonなど）への接続が要るときです。DSQL側の制約は[Aurora DSQLとは？東京のDPU料金・PostgreSQL非対応機能とCLI接続手順【2026年11月】](/tech/details/4487/)で確認してください。

| 観点                       | Database                       | DistributedDatabase |
| ------------------------ | ------------------------------ | ------------------- |
| エンジン                     | Aurora Serverless v2（Data API） | Aurora DSQL（pg＋IAM） |
| 競合制御                     | ロック方式（PostgreSQL標準）            | 楽観的（競合時にコミット失敗）     |
| withRLS()・fromExisting() | 対応                             | 非対応                 |
| マルチリージョン                 | 非対応                            | アクティブ・アクティブ         |
| VPC                      | 必要                             | 不要                  |

`Database`のクエリは`sql`タグ付きテンプレートで書き、値は自動でパラメーター化されます。Kyselyを使いたい場合は`createKyselyAdapter`で包みます。同梱READMEの目安は約0.12ドル/ACU時で、既定の最小値0.5 ACUを730時間動かすと容量料金だけで月約44ドルです（ストレージ等は別）。`minCapacity: 0`を指定すれば[自動一時停止](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2-auto-pause.html)で無通信時の容量料金を止められますが、再開時に約500ミリ秒のコールドスタートが入ります。東京リージョンの単価は料金ページで確かめてください。

### 認証Blockの選び方｜AuthBasicは試作向け、本番はAuthCognito

READMEは`AuthBasic`を「プロトタイプ・MVP向け」、MFAやグループが要る場合を`AuthCognito`、外部IdPは`AuthOIDC`と振り分けています。`AuthBasic`も0.9.0で、連続失敗によるアカウントロック・サインアウト時のサーバー側セッション失効・確認コードの試行回数上限が入りました。Cognito自体の機能と料金は[Amazon Cognito（コグニート）とは？料金・できること・使い方をCLIとコード例で解説【2026年10月】](/tech/details/3108/)で扱っています。なお、GitHubのmainブランチのREADMEは認証を1つの`Auth`にまとめた表記に変わっており、npmの0.9.0（3種に分かれたまま）より先行しています。

### SecretとCompute｜0.8.0・0.9.0で増えた2種

`Secret`は0.8.0で入ったSecrets Managerベースの機密値で、READMEはAPIキーやOAuthシークレットにはこちらを推奨し、`AppSetting`の`secret: true`は低価値の値向けの無料の代替と位置づけています。0.9.0から既定で実行時は読み取り専用になり、アプリ自身が値を書き換える場合だけ`allowRuntimeWrite: true`を付けます。

```
// 既定は読み取り専用（put() が存在せず、IAMも読み取りのみ）
const stripeKey = new Secret(scope, 'stripe-api-key');
const key = await stripeKey.get();

// アプリが値を更新する場合だけ書き込みを許可する
const token = new Secret(scope, 'self-rotating-token', { allowRuntimeWrite: true });
await token.put('t-abc123');
```

`Compute`は処理を載せる基盤を`serverless`（Lambda）か`container`（Fargate）で指定するBlockです。`AsyncJob`はコンテナ上でも動かせるため、15分を超える処理やメモリを多く使う処理を逃がせます。一方、`ApiNamespace`と`CronJob`は現時点ではserverlessにしか置けず、container指定は型エラーかsynthエラーになります。

## AWS Blocksの使い方｜作成からローカル実行・デプロイまで

### プロジェクト作成｜作成コマンドと10種のテンプレート

必要なのはNode.js 22以降とnpm 10以降です。作成コマンドは`npx @aws-blocks/create-blocks-app`（[CLIリファレンス](https://docs.aws.amazon.com/blocks/latest/devguide/cli-reference.html)の`npm create @aws-blocks/blocks-app@latest`も同じパッケージを呼ぶ）です。既存プロジェクトの中で実行すれば`aws-blocks/`だけを後から足せます。

```
npx @aws-blocks/create-blocks-app@0.4.0 my-app --template sql
cd my-app
npm install @aws-blocks/blocks@0.9.0   # 生成直後の依存は "*" なので版を固定する
npm run dev          # http://localhost:3000（backend系テンプレートはAPIが3001）
npm run test:e2e     # 型付きimportでAPIを呼ぶテスト
npm run sandbox      # 実サービスへ出す検証環境（ホットスワップ）
npm run deploy       # 本番デプロイ
```

`@aws-blocks/create-blocks-app` 0.4.0の配布物にあるテンプレートは、amplify・api-only・auth-cognito・backend・bare・default・demo・nextjs・react・sqlの10種です。同じパッケージのREADMEは8種、CLIリファレンスはdefaultとdemoの2種しか挙げていません。使えるテンプレートは`--help`の一覧で確かめてください。

| テンプレート       | 中身                                 |
| ------------ | ---------------------------------- |
| default      | Vite＋lit-html、認証・DynamoDB・Realtime |
| react        | Vite＋React 19、認証・DynamoDB・Realtime |
| nextjs       | Next.js 16 App Router              |
| sql          | Database＋SQLマイグレーション（Aurora）       |
| api-only     | フロントなしのJSON API（モバイル等向け）           |
| backend      | フロントなしのAPI＋CDK                     |
| auth-cognito | Cognitoのメールワンタイムコード認証              |
| amplify      | 既存のAmplify Gen 2へ重ねる               |
| bare・demo    | 最小構成・Todoの見本                       |

### ローカル実行｜.bb-dataに残る実データとe2eテスト

2026年11月14日にmacOS・Node.js 26.5.0でsqlテンプレートを作成し、`npm run test:e2e`を3回実行すると、2件のテスト（サーバー設定の配信・ノートの作成と取得）はすべて成功し、所要時間は19.1秒・12.8秒・11.5秒でした（初回はPGliteの初期化を含む）。実行後のプロジェクト直下には`.bb-data/`ができ、`my-app-main`にはPostgresのデータディレクトリ（`pg_wal`など）、`my-app-auth-users`には`store.json`が置かれていました。ローカルの`Database`は単なるモックではなく、マイグレーションやトランザクションが実際に動くPGliteです。リセットしたいときは`.bb-data/`を消し、開発サーバーは0.8.0で入った`npm run dev:stop`で止められます。

IAMの権限、クォータとスロットリング、本番規模のクエリ性能、Bedrockの実際の応答は、ローカルでは確かめられません。`npm run sandbox`で実サービスに出して確認します。

### AWSへのデプロイ｜synthによる79リソースの合成結果

同じsqlテンプレートで`npx cdk synth`を実行すると、AWS認証情報なしで30秒ほどで合成が終わり、CloudFormationテンプレートには79のリソースが並びました。Lambda関数8・IAMロール8・API Gateway一式に加え、`Database`のためのVPC（サブネット2）、Aurora PostgreSQL 16.13のクラスター（最小0.5・最大2 ACU）、Secrets Managerの資格情報が含まれます。本番用の合成ではAuroraクラスターとDynamoDBテーブルの`DeletionPolicy`が`Retain`で、スタックを消してもデータは残ります。

実際にデプロイする`npm run sandbox`と`npm run deploy`は、合成の前に認証情報とCDKのブートストラップ（SSMパラメーター`/cdk-bootstrap/<qualifier>/version`）を確認し、未実施なら`npx cdk bootstrap aws://<account-id>/<region> --app=`を表示して止まります。デプロイ先は[すべての商用リージョン](https://aws.amazon.com/about-aws/whats-new/2026/06/aws-blocks-preview/)です。

## 0.7.0から0.9.0までの破壊的変更と本番向けの新設定

0.9.0の変更履歴には、メンテナーの「1.0未満のAWS Blocksでは、挙動の変更はマイナー版で出す」という注記があります。つまり0.xのマイナー更新は、デプロイ済みアプリの挙動が変わりうる更新です。[npmの公開履歴](https://www.npmjs.com/package/@aws-blocks/blocks?activeTab=versions)では0.7.0が10月5日、0.8.0が10月16日、0.9.0が11月2日で、npmに公開された正式版（canary版を除く）は0.1.0から数えて20本目です。

### デプロイ済みアプリに効く挙動変更

| 対象          | 版     | 変更内容                             |
| ----------- | ----- | -------------------------------- |
| Database    | 0.9.0 | RLS拒否・制約違反が500から名前付き4xxへ         |
| Database    | 0.9.0 | withRLS()でclaimsのsub・roleを上書き不可  |
| EmailClient | 0.9.0 | SES送信前にアドレスを検証・SendRawEmail権限を外す |
| AuthOIDC    | 0.9.0 | stubIdp()はsandbox以外でsynth失敗      |
| Secret      | 0.9.0 | 実行時は読み取り専用が既定                    |
| 全Block      | 0.9.0 | デプロイ環境でモックが読まれたら例外               |
| core        | 0.8.0 | BlocksStack.handler等を削除          |

影響が大きいのは`Database`のエラーです。行レベルセキュリティの拒否（SQLSTATE 42501）が`DatabaseErrors.PermissionDenied`（403）、外部キー違反（23503）が`ForeignKeyViolation`（409）のように返るようになり、`QueryFailed`で一括判定していたコードは書き換えが要ります。PostgreSQL 16以降で`withRLS()`を使う場合は、マイグレーションに`GRANT authenticated TO CURRENT_USER;`も必要です。SESのSDKを直接呼んで添付ファイルを送っていたアプリは、`ses:SendRawEmail`の権限を自分で付け直します。

### 本番運用向けに増えた設定｜WAF・権限境界・VPC

- `apiWaf`（0.9.0・既定オフ）：`{ enabled: true }`でAWSマネージドのCommon・Known Bad Inputsルールと、IPごとに5分1,000リクエストのレート制限を付けたWeb ACLを作る。RealtimeのWebSocket APIは対象外
- `defaults.permissionsBoundary`（0.9.0）：Blocksが作る全IAMロールに権限境界を付ける。境界の有無にかかわらず、synthのたびに`cdk.out/<stack>.blocks-iam.json`へ実行ロールの権限一覧を書き出す（上のsqlテンプレートでは9ステートメント）
- アクセスログの警告（0.9.0）：`BlocksPresets.production`のようにデータを残す構成でAPI Gatewayのアクセスログが無効だと、synthで警告が出る。`cdk deploy --strict`では失敗扱い
- VPC：同梱のVPC.mdは「ほとんどのアプリにVPCは不要」としたうえで、2AZ・NAT 1台・インターフェースエンドポイント5種の例で月約104ドルの上乗せを試算している

SSRのフロントは、`Hosting`の`compute.type: 'web-function'`で、2026年10月12日に発表された[AWS Lambda Web Functions](https://aws.amazon.com/about-aws/whats-new/2026/10/aws-lambda-web-functions/)上でも動かせるようになりました（CloudFront経由の構成のみ）。

## AWS BlocksとCDK・Amplify Gen 2の使い分け

### AWS CDKとの関係｜CDKを土台とする構成と直接の拡張

AWS BlocksのアプリケーションはCDKアプリケーションです。抽象化で足りない設定は、CDK層の`aws-blocks/index.cdk.ts`でリソースを直接書けます。BlocksはCDKの代わりではなく、CDKの上でよくある構成を短く書くための層です。CDKのスタックや`cdk deploy`の基本は[AWS CDK（cdk）とは？スタックの仕組みとcdk deployの使い方、CloudFormation・Terraformとの違い](/column/details/2892/)を参照してください。

### Amplify Gen 2との関係｜入れ子のCDKスタックによる機能追加

[Amplifyのドキュメント](https://docs.amplify.aws/vue/build-a-backend/aws-blocks/)は、BlocksをAmplify Gen 2の置き換えではなく補完と位置づけています。既存のGen 2プロジェクトで作成コマンドを実行すると`amplify/backend.ts`を検出し、Blocksを入れ子のCDKスタックとして組み込みます。デプロイは`ampx`のまま1回で済み、BlocksのAPIのURLは`amplify_outputs.json`の`custom.blocks_api_url`に出ます。認証はAmplifyのCognitoユーザープールをそのまま使えます。Gen 2側の操作は[AWS Amplify Gen 2の使い方｜作成からサンドボックス・デプロイ・Gen 1移行まで【ampx 1.10対応】](/tech/details/2842/)にまとめています。

| 観点        | AWS Blocks     | AWS CDK | Amplify Gen 2       |
| --------- | -------------- | ------- | ------------------- |
| 定義の主役     | アプリコード（IFC）    | インフラコード | defineBackend       |
| ローカル実行    | 全Block（AWS不要）  | なし      | cloud sandbox（AWS上） |
| フロントとの型共有 | import（生成なし）   | なし      | 生成したクライアント          |
| 成熟度       | Preview（0.9.0） | GA      | GA                  |

同じく生成コードでAWS構成を作る選択肢として、Nxのジェネレーターで雛形を出す[Nx Plugin for AWSとは：生成コードのレビュー観点と本番投入までの手順](/tech/details/18221/)があります。こちらは実行時の抽象を持たず、生成後のコードを自分で保守する方式です。

## 既存AWS構成への組み込み｜fromExisting・CDK直書き・カスタムBlock・vendorize

[既存インフラとの統合ガイド](https://docs.aws.amazon.com/blocks/latest/devguide/existing-infrastructure.html)は4つのパターンを示しています。手数が少ないのは`fromExisting`で、デプロイ済みのリソースを包んで型付きAPIとローカル実装だけを使い、所有権は元のまま残します。

```
import { KVStore } from '@aws-blocks/blocks';
import { Database, fromExisting } from '@aws-blocks/bb-data';

// 既存のDynamoDBテーブルを包む（npm run dev ではローカル保存を使う）
const sessions = new KVStore(scope, 'sessions', {
  table: KVStore.fromExisting('my-legacy-sessions-table'),
});

// 既存のPostgreSQL（Supabase・Neonなど）へ接続する
const db = new Database(scope, 'external', {
  connection: fromExisting({ connectionString: process.env.DATABASE_URL! }),
});
```

ガイドの対応表はKVStore・DistributedTable・FileBucket・Database・AuthCognitoの5種ですが、0.9.0の同梱ドキュメントでは`Secret.fromExisting(arn)`・`Metrics.fromExisting(namespace)`・`AppSetting.fromExisting`も使えます。`DistributedDatabase`は非対応です。外部PostgreSQLへの接続では証明書の検証が既定で有効で、Supabase・Neon・RDSの独自CAは`ssl.ca`にPEMの中身を渡して指定します。

該当するBlockが無いリソース（SQSのキューなど）は、`BlocksStack`か既存スタックへ差し込む`BlocksBackend`の横にCDKで直接書きます。`BlocksBackend.create()`は非同期なので、コンストラクターではなく静的なファクトリーから呼びます。同じ構成を複数のアプリで使い回すならカスタムBlockを作り、Blockの実装そのものを書き換えたいときは`npm run vendorize`でソースをプロジェクトへ取り込みます。vendorizeすると以後の更新は自分で追うことになるので、最後の手段です。

## 運用で事故になりやすい2点｜Block IDの変更とテレメトリ

### Block ID変更の影響｜リソースの再作成とベースライン検査の適用範囲

デベロッパーガイドのコンセプト解説は、Block ID（コンストラクターの第2引数）を変えると次のデプロイで対応するリソースが削除・再作成され、`KVStore`・`DistributedTable`・`Database`・`FileBucket`のような状態を持つBlockでは恒久的なデータ消失になると警告しています。0.9.0のcoreには、Blockが`aws-blocks/baselines/<stack>/`に書くベースラインファイルを照合し、名前の変更や削除で状態を持つリソースが消える場合にsynthを止める仕組みが入りました。ただし同梱のcore READMEが最初の対象に挙げる`Auth`は、mainブランチで統合中の未リリースの認証Blockです。0.9.0として配布されている各Blockのコードを検索すると、ベースラインを書く処理（`claimBaseline`）を呼ぶものは無く、`AuthCognito`を含めて公開版にはまだこの保護が効きません。

現時点では、認証・データを問わずIDはデプロイ後に変更しないという運用で守るしかありません。IDの変更をレビューで止め、将来ベースラインファイルが生成されるようになったらリポジトリにコミットします（ファイルが無いチェックアウトでは保護が効きません）。本番の合成で`Retain`になる表も、IDを変えればアプリは新しい空の表を使い始め、古いデータは取り残されます。

### 料金とテレメトリ｜追加料金なしと停止方法

[AWSの製品ページ](https://aws.amazon.com/products/developer-tools/blocks/)によると、AWS Blocks自体は追加料金なしで、アプリが使うAWSリソースに標準料金がかかるだけです。CLIは既定で匿名の利用データを送ります。止める方法は`npx blocks-telemetry --disable`（`--global`で全プロジェクト）、環境変数`AWS_BLOCKS_DISABLE_TELEMETRY`（0.8.0から`1`に加えて`true`・`yes`も可）、`.blocks/config.json`の設定の3つで、[テレメトリのページ](https://docs.aws.amazon.com/blocks/latest/devguide/telemetry.html)によればBlocksが起動するCDK CLIの送信も止まります。0.9.0からは、グローバルで止めた送信をプロジェクトの設定で再び有効にはできません。

## AWS Blocksを採用すべき場面と見送るべき場面

効くのは、作って見せるまでの速さが価値になる場面です。認証・ファイル保存・ジョブ・AIエージェントを手元で動かし、e2eテストを書いてからAWSへ出せるので、PoC・社内ツール・新規SaaSの立ち上げに向きます。既存のAmplify Gen 2やCDKがあっても、入れ子のスタックや`fromExisting`で1つのBlockから試せます。

見送るべきなのは次のような場合です。

- 停止できない基幹系：0.7.0から0.9.0までの更新で、Databaseのエラー形式・メール送信・Secretの権限という本番の挙動に効く変更が続いた。1.0までは同様の変更が続く前提で考える
- Block IDを開発者が気軽に変える体制：公開版ではID変更をsynthで止める保護がまだ効かないので、レビューで止める仕組みが無いならデータ消失のリスクを抱える
- 待機コストを嫌う小規模アプリで`Database`を選ぶ場合：既定構成では0.5 ACUが常時かかり、VPCも作られる。`minCapacity: 0`で止められるがコールドスタートと引き換えになる。DynamoDBかAurora DSQLで足りるならそちらにする

採用する場合は、`@aws-blocks/blocks`の版を固定し、更新のたびに変更履歴のBreaking表記と同梱のTROUBLESHOOTING.mdを読み、`blocks-iam.json`の差分をCIで確認する運用から始めてください。CDKやネットワーク設計を含めたAWS基盤の設計・構築を任せたい場合は、[インフラ構築（AWS・Google Cloud・Azure）](/service/system/aws/)の支援も用意しています。

## よくある質問

### AWS Blocksは無料で使えますか？

フレームワーク自体は追加料金なしで、Apache-2.0のオープンソースです。ローカル開発だけならAWSアカウントも不要です。デプロイ後はLambda・DynamoDB・Auroraなど、アプリが使うサービスの標準料金がかかります。`Database`は既定構成だと0.5 ACU分の容量料金が常にかかり、`minCapacity: 0`で自動一時停止を有効にした場合だけ無通信時の容量料金が止まります。

### AWS BlocksとAWS Amplifyはどう違いますか？

Amplifyのドキュメントは、BlocksをAmplify Gen 2の置き換えではなく補完と説明しています。既存のGen 2プロジェクトでは、Blocksが入れ子のCDKスタックとして組み込まれ、`ampx`の1回のデプロイでまとめて出せます。Gen 2のバックエンドはcloud sandboxでAWS上に作るのに対し、Blocksは全Blockを手元で動かせる点が違います。

### AWS Blocksは本番環境で使えますか？

すべての商用リージョンにデプロイできますが、2026年11月時点でもPublic Previewの0.9.0です。WAFや権限境界などの本番向け設定は揃ってきた一方で、マイナー版ごとに挙動の変更が入ります。社内ツールや新規プロダクトから始め、版を固定して更新を管理できる体制で使ってください。

### ローカル開発にDockerやAWSアカウントは必要ですか？

どちらも不要で、必要なのはNode.js 22以降とnpm 10以降です。`npm run dev`でPostgres（PGlite）・認証・リアルタイム通信・ファイル保存・ジョブが立ち上がり、データは`.bb-data/`に残ります。`Compute`の`container`を使う場合も、イメージはECSがタスク起動時に取得するため、デプロイにローカルのDockerは要りません。

### EC2 Capacity Blocksとの違いは何ですか？

まったく別のものです。EC2 Capacity Blocks for MLは機械学習向けにGPUインスタンスの容量を予約する購入オプションで、本記事のAWS Blocksはバックエンドを組むTypeScriptのフレームワークです。VPCのCIDRブロックや一般的な「ビルディングブロック」という言い方とも関係ありません。

## 関連記事

- [AWS CDK（cdk）とは？スタックの仕組みとcdk deployの使い方、CloudFormation・Terraformとの違い](/column/details/2892/)
- [AWS Amplify Gen 2の使い方｜作成からサンドボックス・デプロイ・Gen 1移行まで【ampx 1.10対応】](/tech/details/2842/)
- [Aurora DSQLとは？東京のDPU料金・PostgreSQL非対応機能とCLI接続手順【2026年11月】](/tech/details/4487/)
- [Amazon Cognito（コグニート）とは？料金・できること・使い方をCLIとコード例で解説【2026年10月】](/tech/details/3108/)
- [Nx Plugin for AWSとは：生成コードのレビュー観点と本番投入までの手順](/tech/details/18221/)

---

出典: [AWS Blocksとは？Block一覧と使い方・0.9.0の変更点、CDKとの違いと採用判断](<https://www.issoh.co.jp/tech/details/12663/>)（株式会社一創）
