AWS AppSync で GraphQL API を使ってみた

appsync-graphql-sample/
├── bin/
│   └── appsync-graphql-sample.ts
├── lib/
│   ├── appsync-graphql-sample-stack.ts
│   └── schema.graphql                  # GraphQL スキーマ
├── cdk.json
├── package.json
└── tsconfig.json

mkdir appsync-graphql-sample && cd appsync-graphql-sample
npx cdk init app --language typescript

# ブログ投稿を表す型。id は自動採番、createdAt はサーバ側で生成する前提。
type Post {
  id: ID!
  title: String!
  body: String!
  createdAt: AWSDateTime!
}

# 作成時はサーバ側で id / createdAt を採番するのでクライアントからは受け取らない
input CreatePostInput {
  title: String!
  body: String!
}

# 更新は id 必須、それ以外は null 許容にして「変更するフィールドだけ渡す」形にした
input UpdatePostInput {
  id: ID!
  title: String
  body: String
}

type Query {
  getPost(id: ID!): Post
  listPosts: [Post!]!
}

type Mutation {
  createPost(input: CreatePostInput!): Post!
  updatePost(input: UpdatePostInput!): Post!
  deletePost(id: ID!): Post
}

import * as path from "node:path";
import {
  Stack,
  StackProps,
  Duration,
  Expiration,
  CfnOutput,
  RemovalPolicy,
} from "aws-cdk-lib";
import * as appsync from "aws-cdk-lib/aws-appsync";
import * as dynamodb from "aws-cdk-lib/aws-dynamodb";
import { Construct } from "constructs";

export class AppsyncGraphqlSampleStack extends Stack {
  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);

    /**
     * Posts CRUD 用の GraphQL API。
     * 認可は最短で試せる API キー方式にしている
     */
    const api = new appsync.GraphqlApi(this, "PostsApi", {
      name: "posts-api",
      definition: appsync.Definition.fromFile(
        path.join(__dirname, "schema.graphql"), // スキーマは別ファイルに切り出して IDE の GraphQL 補完を効かせる
      ),
      authorizationConfig: {
        defaultAuthorization: {
          authorizationType: appsync.AuthorizationType.API_KEY,
          apiKeyConfig: {
            expires: Expiration.after(Duration.days(30)), // AppSync の API キーは最長 365 日。検証用途は 30 日で十分
          },
        },
      },
    });

    /**
     * 投稿データを保存する DynamoDB テーブル。
     */
    const postsTable = new dynamodb.Table(this, "PostsTable", {
      partitionKey: {
        name: "id", // 単一アイテム取得を最速にしたいので id をハッシュキーに採用
        type: dynamodb.AttributeType.STRING, // AppSync の $util.autoId() が UUID 文字列を返すため
      },
      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,
      removalPolicy: RemovalPolicy.DESTROY, // 本番では RETAIN 推奨。ハンズオン用に destroy で消える設定
    });

    // AppSync から DynamoDB を読み書きする IAM ロールもここで自動生成される
    const postsDS = api.addDynamoDbDataSource("PostsDataSource", postsTable);

    // GetItem は CDK 標準のヘルパーで済ませて VTL の直書きを避ける
    postsDS.createResolver("QueryGetPostResolver", {
      typeName: "Query",
      fieldName: "getPost",
      requestMappingTemplate: appsync.MappingTemplate.dynamoDbGetItem("id", "id"),
      responseMappingTemplate: appsync.MappingTemplate.dynamoDbResultItem(),
    });

    // Scan は件数が増えると高コストだが、検証用テーブルなので割り切って採用
    postsDS.createResolver("QueryListPostsResolver", {
      typeName: "Query",
      fieldName: "listPosts",
      requestMappingTemplate: appsync.MappingTemplate.dynamoDbScanTable(),
      responseMappingTemplate: appsync.MappingTemplate.dynamoDbResultList(),
    });

    /**
     * createPost はサーバ側で id と createdAt を採番したいので VTL を直書き。
     * ヘルパー（dynamoDbPutItem）だと自動採番＋タイムスタンプが両立させにくいのが理由。
     */
    postsDS.createResolver("MutationCreatePostResolver", {
      typeName: "Mutation",
      fieldName: "createPost",
      requestMappingTemplate: appsync.MappingTemplate.fromString(`
        {
          "version": "2018-05-29",
          "operation": "PutItem",
          "key": {
            "id": $util.dynamodb.toDynamoDBJson($util.autoId())
          },
          "attributeValues": {
            "title": $util.dynamodb.toDynamoDBJson($ctx.args.input.title),
            "body": $util.dynamodb.toDynamoDBJson($ctx.args.input.body),
            "createdAt": $util.dynamodb.toDynamoDBJson($util.time.nowISO8601())
          }
        }
      `),
      responseMappingTemplate: appsync.MappingTemplate.dynamoDbResultItem(),
    });

    /**
     * updatePost は SET 式で title と body だけを更新する。
     */
    postsDS.createResolver("MutationUpdatePostResolver", {
      typeName: "Mutation",
      fieldName: "updatePost",
      requestMappingTemplate: appsync.MappingTemplate.fromString(`
        {
          "version": "2018-05-29",
          "operation": "UpdateItem",
          "key": {
            "id": $util.dynamodb.toDynamoDBJson($ctx.args.input.id)
          },
          "update": {
            "expression": "SET title = :title, body = :body",
            "expressionValues": {
              ":title": $util.dynamodb.toDynamoDBJson($ctx.args.input.title),
              ":body": $util.dynamodb.toDynamoDBJson($ctx.args.input.body)
            }
          }
        }
      `),
      responseMappingTemplate: appsync.MappingTemplate.dynamoDbResultItem(),
    });

    postsDS.createResolver("MutationDeletePostResolver", {
      typeName: "Mutation",
      fieldName: "deletePost",
      requestMappingTemplate: appsync.MappingTemplate.dynamoDbDeleteItem("id", "id"),
      responseMappingTemplate: appsync.MappingTemplate.dynamoDbResultItem(),
    });

    // curl から動作確認できるようにエンドポイントと API キーをスタック出力に出す
    new CfnOutput(this, "GraphQLApiUrl", {
      value: api.graphqlUrl,
    });
    new CfnOutput(this, "GraphQLApiKey", {
      value: api.apiKey ?? "", // API_KEY 認可時のみ値が入る。他の認可方式に切り替えたら undefined
    });
  }
}

mutation CreatePost {
  createPost(input: { title: "はじめての投稿", body: "GraphQL 便利です" }) {
    id
    title
    body
    createdAt
  }
}

query ListPosts {
  listPosts {
    id
    title
    createdAt
  }
}

export GRAPHQL_URL="https://xxxxxxxx.appsync-api.ap-northeast-1.amazonaws.com/graphql"
export GRAPHQL_API_KEY="da2-xxxxxxxxxxxxxxxxxxxxxxxxxx"

curl -s -X POST "$GRAPHQL_URL" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $GRAPHQL_API_KEY" \
  -d '{"query":"query { listPosts { id title createdAt } }"}'

{
  "data": {
    "listPosts": [
      {
        "id": "c9eb15f1-a41f-4039-998c-75bde1e7da38",
        "title": "はじめての投稿",
        "createdAt": "2026-07-19T05:58:43.124Z"
      },
      {
        "id": "103f82fb-c005-4698-8cad-adb1601927b7",
        "title": "はじめての投稿",
        "createdAt": "2026-07-19T05:18:02.512Z"
      }
    ]
  }
}