[AWS CDK] AWS Lambda の Provisioned Concurrency を平日日中帯のみ有効化する（EventBridge Scheduler 使用版）

import * as cdk from "aws-cdk-lib";
import * as iam from "aws-cdk-lib/aws-iam";
import * as lambda from "aws-cdk-lib/aws-lambda";
import * as scheduler from "aws-cdk-lib/aws-scheduler";
import * as scheduler_targets from "aws-cdk-lib/aws-scheduler-targets";
import { Construct } from "constructs";

interface EnablePcSchedulerProps {
  alias: lambda.Alias;
}

/**
 * Lambda の Provisioned Concurrency を有効化するスケジューラーを作成する Construct
 */
export class EnablePcScheduler extends Construct {
  constructor(scope: Construct, id: string, props: EnablePcSchedulerProps) {
    super(scope, id);

    const { alias } = props;

    /**
     * Scheduler Target の作成
     */
    const target = new scheduler_targets.Universal({
      service: "lambda",
      action: "putProvisionedConcurrencyConfig",

      /**
       * 権限自動付与を回避するため、policyStatements で明示的に権限を指定する。
       * @see https://dev.classmethod.jp/articles/aws-cdk-eventbridge-scheduler-target-universal-iam-control/
       */
      policyStatements: [
        new iam.PolicyStatement({
          actions: ["lambda:PutProvisionedConcurrencyConfig"],
          resources: [alias.functionArn],
        }),
      ],

      input: scheduler.ScheduleTargetInput.fromObject({
        FunctionName: alias.functionName,
        Qualifier: alias.aliasName,
        ProvisionedConcurrentExecutions: 5,
      }),
    });

    /**
     * 平日8時に Provisioned Concurrency を有効化するスケジューラー
     */
    new scheduler.Schedule(this, "Default", {
      schedule: scheduler.ScheduleExpression.cron({
        minute: "0",
        hour: "8",
        weekDay: "MON-FRI",
        timeZone: cdk.TimeZone.ASIA_TOKYO,
      }),
      target,
    });
  }
}

import * as cdk from "aws-cdk-lib";
import * as iam from "aws-cdk-lib/aws-iam";
import * as lambda from "aws-cdk-lib/aws-lambda";
import * as scheduler from "aws-cdk-lib/aws-scheduler";
import * as scheduler_targets from "aws-cdk-lib/aws-scheduler-targets";
import { Construct } from "constructs";

interface DisablePcSchedulerProps {
  alias: lambda.Alias;
}

/**
 * Lambda の Provisioned Concurrency を無効化するスケジューラーを作成する Construct
 */
export class DisablePcScheduler extends Construct {
  constructor(scope: Construct, id: string, props: DisablePcSchedulerProps) {
    super(scope, id);

    const { alias } = props;

    /**
     * Scheduler Target の作成
     */
    const target = new scheduler_targets.Universal({
      service: "lambda",
      action: "deleteProvisionedConcurrencyConfig",

      /**
       * 権限自動付与を回避するため、policyStatements で明示的に権限を指定する。
       * @see https://dev.classmethod.jp/articles/aws-cdk-eventbridge-scheduler-target-universal-iam-control/
       */
      policyStatements: [
        new iam.PolicyStatement({
          actions: ["lambda:DeleteProvisionedConcurrencyConfig"],
          resources: [alias.functionArn],
        }),
      ],

      input: scheduler.ScheduleTargetInput.fromObject({
        FunctionName: alias.functionName,
        Qualifier: alias.aliasName,
      }),
    });

    /**
     * 毎日23時に Provisioned Concurrency を無効化するスケジューラー
     *
     * MEMO: 不整合により休日に Provisioned Concurrency が有効化されたままとならないように無効化は毎日実行するようにしている。
     */
    new scheduler.Schedule(this, "Default", {
      schedule: scheduler.ScheduleExpression.cron({
        minute: "0",
        hour: "23",
        weekDay: "*", // デプロイ不整合による PC 無効化漏れを防止するため毎日実行
        timeZone: cdk.TimeZone.ASIA_TOKYO,
      }),
      target,
    });
  }
}

import * as cdk from "aws-cdk-lib";
import * as apigateway from "aws-cdk-lib/aws-apigateway";
import * as lambda from "aws-cdk-lib/aws-lambda";
import * as lambda_nodejs from "aws-cdk-lib/aws-lambda-nodejs";
import { Construct } from "constructs";

import { DisablePcScheduler } from "./constructs/disable-pc-scheduler";
import { EnablePcScheduler } from "./constructs/enable-pc-scheduler";

export class SampleStack extends cdk.Stack {
  constructor(scope: Construct, id: string) {
    super(scope, id);

    /**
     * Lambda 関数
     */
    const sampleFunction = new lambda_nodejs.NodejsFunction(
      this,
      "SampleFunction",
      {
        entry: "src/handler.ts",
        tracing: lambda.Tracing.ACTIVE, // コールドスタート発生状況を X-Ray で確認できるようにするため有効化
      }
    );

    /**
     * Lambda エイリアス
     */
    const sampleFunctionAlias = new lambda.Alias(this, "SampleFunctionAlias", {
      aliasName: "Prod",
      version: sampleFunction.currentVersion,

      // デプロイ時の "No Provisioned Concurrency Config found for this function" エラー回避のため、
      // 既定では Provisioned Concurrency を無効にする。
    });

    /**
     * テスト呼び出し用 API Gateway Rest API Lambda プロキシ統合
     */
    new apigateway.LambdaRestApi(this, "SampleApi", {
      handler: sampleFunctionAlias, // REST API がエイリアスを呼び出すように設定
      deployOptions: {
        tracingEnabled: true, // コールドスタート発生状況を X-Ray で確認できるようにするため有効化
      },
    });

    /**
     * Lambda の Provisioned Concurrency を有効化するスケジューラー
     */
    new EnablePcScheduler(this, "EnablePcScheduler", {
      alias: sampleFunctionAlias,
    });

    /**
     * Lambda の Provisioned Concurrency を無効化するスケジューラー
     */
    new DisablePcScheduler(this, "DisablePcScheduler", {
      alias: sampleFunctionAlias,
    });
  }
}

$ aws lambda get-provisioned-concurrency-config \
  --function-name ${FUNCTION_NAME} \
  --qualifier Prod

An error occurred (ProvisionedConcurrencyConfigNotFoundException) when calling the GetProvisionedConcurrencyConfig operation: No Provisioned Concurrency Config found for this function

$ aws lambda put-provisioned-concurrency-config \
  --function-name ${FUNCTION_NAME} \
  --qualifier Prod \
  --provisioned-concurrent-executions 5
{
    "RequestedProvisionedConcurrentExecutions": 5,
    "AvailableProvisionedConcurrentExecutions": 0,
    "AllocatedProvisionedConcurrentExecutions": 0,
    "Status": "IN_PROGRESS",
    "LastModified": "2026-01-17T07:06:13+0000"
}

aws lambda get-provisioned-concurrency-config \
  --function-name ${FUNCTION_NAME} \
  --qualifier Prod

An error occurred (ProvisionedConcurrencyConfigNotFoundException) when calling the GetProvisionedConcurrencyConfig operation: No Provisioned Concurrency Config found for this function

$ aws lambda get-provisioned-concurrency-config \
  --function-name ${FUNCTION_NAME} \
  --qualifier Prod
{
    "RequestedProvisionedConcurrentExecutions": 5,
    "AvailableProvisionedConcurrentExecutions": 5,
    "AllocatedProvisionedConcurrentExecutions": 5,
    "Status": "READY",
    "LastModified": "2026-01-13T23:00:28+0000"
}

curl https://${API_ID}.execute-api.ap-northeast-1.amazonaws.com/prod/

export const handler = async (): Promise<Object> => {
  return {
    statusCode: 200,
    body: JSON.stringify({
      AWS_LAMBDA_INITIALIZATION_TYPE:
        process.env.AWS_LAMBDA_INITIALIZATION_TYPE || "N/A",
    }),
  };
};

$ curl https://${API_ID}.execute-api.ap-northeast-1.amazonaws.com/prod/
{"AWS_LAMBDA_INITIALIZATION_TYPE":"provisioned-concurrency"}

/**
 * Lambda エイリアス
 */
const sampleFunctionAlias = new lambda.Alias(this, "SampleFunctionAlias", {
  aliasName: "Prod",
  version: sampleFunction.currentVersion,
  provisionedConcurrentExecutions: 5,
});