リクエストの構文 URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

UpdateFunctionCode

Lambda 関数のコードを更新します。関数でコード署名が有効になっている場合、コードパッケージは信頼できる発行元によって署名されている必要があります。詳細については、「Lambda でのコード署名の設定」を参照してください。

関数のパッケージタイプが Image の場合は、ImageUri 内コードパッケージを、Amazon ECR レジストリ内コンテナイメージの URI として指定する必要があります。

関数のパッケージタイプが Zip の場合は、デプロイパッケージを .zip ファイルアーカイブとして指定する必要があります。コードの .zip ファイルロケーションの Amazon S3 バケットとキーを入力します。また、ZipFile フィールドを使用してインラインで関数コードを入力することもできます。

デプロイパッケージのコードは、関数 (x86-64 または arm64) のターゲット命令セットアーキテクチャと互換性を持たせる必要があります。

バージョンを公開すると、関数のコードがロックされます。公開バージョンのコードを変更することはできません。未公開バージョンのみです。

注記

コンテナイメージとして定義された関数の場合、Lambda はイメージタグをイメージダイジェストに転換します。Amazon ECR では、イメージタグを新しいイメージに更新しても、Lambda は関数を自動的に更新しません。

リクエストの構文


PUT /2015-03-31/functions/FunctionName/code HTTP/1.1
Content-type: application/json

{
   "Architectures": [ "string" ],
   "DryRun": boolean,
   "ImageUri": "string",
   "Publish": boolean,
   "RevisionId": "string",
   "S3Bucket": "string",
   "S3Key": "string",
   "S3ObjectVersion": "string",
   "ZipFile": blob
}

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

FunctionName

Lambda 関数の名前

名前の形式

関数名 – my-function。
関数 ARN – arn:aws:lambda:us-west-2:123456789012:function:my-function。
部分的な ARN – 123456789012:function:my-function。

完全な ARN にのみ適用される長さの制限関数名のみを指定する場合、64 文字の長さに制限されます。

長さの制限: 最小長は 1 です。最大長は 140 です。

Pattern: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

必須: はい

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

Architectures

関数がサポートする命令セットアーキテクチャです。有効な値 (arm64 または x86_64) の 1 つを含む文字列配列を入力します。デフォルト値は x86_64 です。

型: 文字列の配列

配列メンバー: 定数は 1 項目です。

有効な値: x86_64 | arm64

必須：いいえ

DryRun

関数コードを変更せずにリクエストパラメータとアクセス許可を検証するには、true に設定します。

型: ブール値

必須: いいえ

ImageUri

Amazon ECR レジストリ内のコンテナイメージの URI。.zip ファイルアーカイブで定義された関数には使用しないでください。

型: 文字列

必須: いいえ

Publish

true に設定すると、コードの更新後に関数の新しいバージョンが公開されます。これは PublishVersion を個別に呼び出すのと同じ効果があります。

型: ブール値

必須: いいえ

RevisionId

リビジョン ID が指定された ID と一致する場合にのみ、関数を更新します。このオプションを使用して最後に読み取りを行った後に変更した関数を、変更しないようにします。

型: 文字列

必須: いいえ

S3Bucket

関数と同じ AWS リージョン内にある Amazon S3 バケットです。バケットは、異なる AWS アカウント内に存在する場合があります。.zip ファイルアーカイブのデプロイパッケージで定義された関数でのみ使用します。

型: 文字列

長さの制限: 最小長は 3 です。最大長は 63 です。

パターン: ^[0-9A-Za-z\.\-_]*(?<!\.)$

必須: いいえ

S3Key

デプロイパッケージの Amazon S3 キーです。.zip ファイルアーカイブのデプロイパッケージで定義された関数でのみ使用します。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 1,024 です。

必須: いいえ

S3ObjectVersion

バージョニングオブエクトの場合、使用するデプロイパッケージオブジェクトのバージョンです。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 1,024 です。

必須: いいえ

ZipFile

デプロイパッケージの base64 エンコードコンテンツ。AWSSDK および AWS CLI クライアントがエンコーディングを処理します。.zip ファイルアーカイブのデプロイパッケージで定義された関数でのみ使用します。

型: Base64 でエンコードされたバイナリデータオブジェクト

必須: いいえ

レスポンスの構文


HTTP/1.1 200
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CodeSha256": "string",
   "CodeSize": number,
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionArn": "string",
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfigResponse": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "ImageConfig": { 
         "Command": [ "string" ],
         "EntryPoint": [ "string" ],
         "WorkingDirectory": "string"
      }
   },
   "KMSKeyArn": "string",
   "LastModified": "string",
   "LastUpdateStatus": "string",
   "LastUpdateStatusReason": "string",
   "LastUpdateStatusReasonCode": "string",
   "Layers": [ 
      { 
         "Arn": "string",
         "CodeSize": number,
         "SigningJobArn": "string",
         "SigningProfileVersionArn": "string"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

Architectures

関数がサポートする命令セットアーキテクチャです。アーキテクチャは、有効な値の 1 つを含む文字列配列です。デフォルトアーキテクチャ値はx86_64です。

型: 文字列の配列

配列メンバー: 定数は 1 項目です。

有効な値: x86_64 | arm64

CodeSha256

関数のデプロイパッケージの SHA256 ハッシュ

型: 文字列

CodeSize

関数のデプロイパッケージのサイズ (バイト単位)

型: Long

DeadLetterConfig

関数のデッドレターキュー

型: DeadLetterConfig オブジェクト

Description

関数の説明

型: 文字列

長さの制限: 最小長は 0 です。最大長は 256 です。

Environment

関数の環境変数 AWS CloudTrail ログから除外。

型: EnvironmentResponse オブジェクト

EphemeralStorage

関数の /tmp ディレクトリのサイズ (MB 単位) です。デフォルト値は 512 ですが、512 から 10,240 MB の範囲内で任意の整数を指定できます。詳細については、「エフェメラルストレージの設定 (コンソール)」を参照してください。

型: EphemeralStorage オブジェクト

FileSystemConfigs

Amazon EFS ファイルシステムの接続設定

型: FileSystemConfig オブジェクトの配列

配列メンバー: 最大数は 1 項目です。

FunctionArn

関数の Amazon リソースネーム (ARN)

型: 文字列

パターン: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

FunctionName

関数の名前

型: 文字列

長さの制限: 最小長は 1 です。最大長は 170 です。

パターン: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Handler

Lambda が関数の実行を開始するために呼び出す関数です。

型: 文字列

長さの制限：最大長は 128 です。

パターン: [^\s]+

ImageConfigResponse

関数のイメージ設定値

型: ImageConfigResponse オブジェクト

KMSKeyArn

関数の環境変数を暗号化するために使用される AWS KMS key。Lambda SnapStart を有効にすると、このキーは関数のスナップショットの暗号化にも使用されます。このキーが返されるのは、カスタマーマネージドキーを設定している場合のみです。

型: 文字列

パターン: (arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()

LastModified

関数が最後に更新された日付と時刻 (ISO-8601 形式 (YYYY-MM-DDThh:mm:ss.sTZD))

型: 文字列

LastUpdateStatus

関数で最後に実行された更新のステータスこれは、関数の作成完了後、最初に Successful に設定されます。

型: 文字列

有効な値: Successful | Failed | InProgress

LastUpdateStatusReason

関数で最後に実行された更新の理由

型: 文字列

LastUpdateStatusReasonCode

関数で最後に実行された更新の理由コード

型: 文字列

Layers

関数のレイヤー

タイプ: Layer オブジェクトの配列

LoggingConfig

関数の Amazon CloudWatch Logs 構成の設定。

型: LoggingConfig オブジェクト

MasterArn

Lambda@Edge 関数の場合、メイン関数の ARN。

型: 文字列

パターン: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

MemorySize

ランタイム時に関数で使用できるメモリの量

型: 整数

値の範囲: 最小値は 128 です。最大値は 10,240 です。

PackageType

デプロイパッケージのタイプコンテナイメージでは Image に設定し、.zip ファイルアーカイブでは Zip を設定します。

型: 文字列

有効な値: Zip | Image

RevisionId

関数またはエイリアスの最後に更新されたリビジョン

型: 文字列

Role

関数の実行ロール

型: 文字列

パターン: arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Runtime

関数のランタイムの識別子デプロイパッケージが .zip ファイルアーカイブの場合は、ランタイムが必要です。

以下のリストには、廃止されたランタイムが含まれています。詳細については、「廃止されたランタイムでのポリシー」を参照してください。

型: 文字列

RuntimeVersionConfig

ランタイムの ARN と発生したエラー

型: RuntimeVersionConfig オブジェクト

SigningJobArn

署名ジョブの ARN

型: 文字列

パターン: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SigningProfileVersionArn

署名プロファイルバージョンの ARN

型: 文字列

パターン: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SnapStart

ApplyOn を PublishedVersions に設定すると、関数バージョンを発行するときに、初期化された実行環境のスナップショットが作成されます。詳細については、「Improving startup performance with Lambda SnapStart」(Lambda SnapStart を使用した起動パフォーマンスの向上) を参照してください。

型: SnapStartResponse オブジェクト

State

関数の現在の状態状態が Inactive の場合、関数を呼び出すことで再アクティブ化できます。

型: 文字列

有効な値: Pending | Active | Inactive | Failed

StateReason

関数の現在の状態の理由

型: 文字列

StateReasonCode

関数の現在の状態の理由コードコードが Creating のときは、関数を呼び出したり変更したりすることはできません。

型: 文字列

Timeout

Lambda が関数を停止するまでに関数に許可する実行時間 (秒) です。

型: 整数

有効範囲: 最小値は 1

TracingConfig

関数の AWS X-Ray トレース設定

型: TracingConfigResponse オブジェクト

Version

Lambda 関数のバージョン

型: 文字列

長さの制限: 最小長は 1 です。最大長は 1,024 です。

パターン: (\$LATEST|[0-9]+)

VpcConfig

関数のネットワーク設定

型: VpcConfigResponse オブジェクト

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

CodeSigningConfigNotFoundException

指定されたコード署名設定が存在しません。

HTTP ステータスコード: 404

CodeStorageExceededException

AWS アカウントが、最大合計コードサイズを超過しました。詳細については、「Lambda クォータ」を参照してください。

HTTP ステータスコード：400

CodeVerificationFailedException

コード署名が、署名の不一致または有効期限の検証チェックの 1 つ以上に失敗し、コード署名ポリシーが ENSORCE に設定されています。Lambda はデプロイをブロックします。

HTTP ステータスコード：400

InvalidCodeSignatureException

コード署名が整合性チェックに失敗しました。整合性チェックに失敗すると、Lambda は、コード署名ポリシーが WARN に設定されている場合でも、デプロイをブロックします。

HTTP ステータスコード：400

InvalidParameterValueException

リクエストに含まれているパラメータの 1 つが無効です。

HTTP ステータスコード：400

PreconditionFailedException

指定された RevisionId が、Lambda 関数またはエイリアスの最新 RevisionId と一致しません。GetFunction または GetAlias API 操作を呼び出して、リソースの最新の RevisionId を取得します。

HTTP ステータスコード: 412

ResourceConflictException

リソースが既に存在しているか、別のオペレーションが進行中です。

HTTP ステータスコード: 409

ResourceNotFoundException

リクエストで指定されたリソースは存在しません。

HTTP ステータスコード: 404

ServiceException

AWS Lambda サービスで内部エラーが発生しました。

HTTP ステータスコード: 500

TooManyRequestsException

リクエストスループット制限を超えました。詳細については、「Lambda クォータ」を参照してください。

HTTP ステータスコード: 429

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

UpdateEventSourceMapping

UpdateFunctionConfiguration