# 操作支持以下操作： + [AddLayerVersionPermission](API_AddLayerVersionPermission.md) + [AddPermission](API_AddPermission.md) + [CreateAlias](API_CreateAlias.md) + [CreateCodeSigningConfig](API_CreateCodeSigningConfig.md) + [CreateEventSourceMapping](API_CreateEventSourceMapping.md) + [CreateFunction](API_CreateFunction.md) + [CreateFunctionUrlConfig](API_CreateFunctionUrlConfig.md) + [DeleteAlias](API_DeleteAlias.md) + [DeleteCodeSigningConfig](API_DeleteCodeSigningConfig.md) + [DeleteEventSourceMapping](API_DeleteEventSourceMapping.md) + [DeleteFunction](API_DeleteFunction.md) + [DeleteFunctionCodeSigningConfig](API_DeleteFunctionCodeSigningConfig.md) + [DeleteFunctionConcurrency](API_DeleteFunctionConcurrency.md) + [DeleteFunctionEventInvokeConfig](API_DeleteFunctionEventInvokeConfig.md) + [DeleteFunctionUrlConfig](API_DeleteFunctionUrlConfig.md) + [DeleteLayerVersion](API_DeleteLayerVersion.md) + [DeleteProvisionedConcurrencyConfig](API_DeleteProvisionedConcurrencyConfig.md) + [GetAccountSettings](API_GetAccountSettings.md) + [GetAlias](API_GetAlias.md) + [GetCodeSigningConfig](API_GetCodeSigningConfig.md) + [GetEventSourceMapping](API_GetEventSourceMapping.md) + [GetFunction](API_GetFunction.md) + [GetFunctionCodeSigningConfig](API_GetFunctionCodeSigningConfig.md) + [GetFunctionConcurrency](API_GetFunctionConcurrency.md) + [GetFunctionConfiguration](API_GetFunctionConfiguration.md) + [GetFunctionEventInvokeConfig](API_GetFunctionEventInvokeConfig.md) + [GetFunctionUrlConfig](API_GetFunctionUrlConfig.md) + [GetLayerVersion](API_GetLayerVersion.md) + [GetLayerVersionByArn](API_GetLayerVersionByArn.md) + [GetLayerVersionPolicy](API_GetLayerVersionPolicy.md) + [GetPolicy](API_GetPolicy.md) + [GetProvisionedConcurrencyConfig](API_GetProvisionedConcurrencyConfig.md) + [GetRuntimeManagementConfig](API_GetRuntimeManagementConfig.md) + [Invoke](API_Invoke.md) + [InvokeAsync](API_InvokeAsync.md) + [InvokeWithResponseStream](API_InvokeWithResponseStream.md) + [ListAliases](API_ListAliases.md) + [ListCodeSigningConfigs](API_ListCodeSigningConfigs.md) + [ListEventSourceMappings](API_ListEventSourceMappings.md) + [ListFunctionEventInvokeConfigs](API_ListFunctionEventInvokeConfigs.md) + [ListFunctions](API_ListFunctions.md) + [ListFunctionsByCodeSigningConfig](API_ListFunctionsByCodeSigningConfig.md) + [ListFunctionUrlConfigs](API_ListFunctionUrlConfigs.md) + [ListLayers](API_ListLayers.md) + [ListLayerVersions](API_ListLayerVersions.md) + [ListProvisionedConcurrencyConfigs](API_ListProvisionedConcurrencyConfigs.md) + [ListTags](API_ListTags.md) + [ListVersionsByFunction](API_ListVersionsByFunction.md) + [PublishLayerVersion](API_PublishLayerVersion.md) + [PublishVersion](API_PublishVersion.md) + [PutFunctionCodeSigningConfig](API_PutFunctionCodeSigningConfig.md) + [PutFunctionConcurrency](API_PutFunctionConcurrency.md) + [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md) + [PutProvisionedConcurrencyConfig](API_PutProvisionedConcurrencyConfig.md) + [PutRuntimeManagementConfig](API_PutRuntimeManagementConfig.md) + [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md) + [RemovePermission](API_RemovePermission.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateAlias](API_UpdateAlias.md) + [UpdateCodeSigningConfig](API_UpdateCodeSigningConfig.md) + [UpdateEventSourceMapping](API_UpdateEventSourceMapping.md) + [UpdateFunctionCode](API_UpdateFunctionCode.md) + [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) + [UpdateFunctionEventInvokeConfig](API_UpdateFunctionEventInvokeConfig.md) + [UpdateFunctionUrlConfig](API_UpdateFunctionUrlConfig.md) # AddLayerVersionPermission 为某个 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的某个版本添加基于资源的策略权限。使用此操作可将层使用权限授予其他账户。您可以向企业中的单个账户、所有账户或所有AWS账户授予权限。要撤销权限，请调用 [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md) 与您在添加时指定的语句 ID。 ## 请求语法 ``` POST /2018-10-31/layers/LayerName/versions/VersionNumber/policy?RevisionId=RevisionId HTTP/1.1 Content-type: application/json { "Action": "string", "OrganizationId": "string", "Principal": "string", "StatementId": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [LayerName](#API_AddLayerVersionPermission_RequestSyntax) ** 层的名称或 Amazon Resource Name (ARN)。长度限制：最小长度为 1。长度上限为 140。模式：`(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+` 必需：是 ** [RevisionId](#API_AddLayerVersionPermission_RequestSyntax) ** 仅当修订版 ID 与指定的 ID 匹配时才更新策略。使用此选项以避免修改自上次读取后已发生更改的策略。 ** [VersionNumber](#API_AddLayerVersionPermission_RequestSyntax) ** 版本号。必需：是 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [Action](#API_AddLayerVersionPermission_RequestSyntax) ** 授予层访问权限的 API 操作。例如，`lambda:GetLayerVersion`。类型：字符串长度约束：最大长度为 22。模式：`lambda:GetLayerVersion` 必需：是 ** [OrganizationId](#API_AddLayerVersionPermission_RequestSyntax) ** 如果将主体设置为 `*`，则为指定组织中的所有账户授予权限。类型：字符串长度约束：最大长度为 34。模式：`o-[a-z0-9]{10,32}` 必需：否 ** [Principal](#API_AddLayerVersionPermission_RequestSyntax) ** 账户 ID 或 `*` 为企业中的所有账户或所有AWS账户（如果 `organizationId` 未指定）授予层级使用权限。对于后一种情况，请确保您确实希望所有AWS账户都具有此层级的使用权限。类型：字符串模式：`\d{12}|\*|arn:(aws[a-zA-Z-]*):iam::\d{12}:root` 必需：是 ** [StatementId](#API_AddLayerVersionPermission_RequestSyntax) ** 将策略与同一层版本上的其他策略区分开来的标识符。类型：字符串长度约束：最小长度为 1。最大长度为 100。模式：`([a-zA-Z0-9-_]+)` 必需：是 ## 响应语法 ``` HTTP/1.1 201 Content-type: application/json { "RevisionId": "string", "Statement": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 201 响应。服务以 JSON 格式返回的以下数据。 ** [RevisionId](#API_AddLayerVersionPermission_ResponseSyntax) ** 策略当前修订版的唯一标识符。类型：字符串 ** [Statement](#API_AddLayerVersionPermission_ResponseSyntax) ** 权限语句。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** PolicyLengthExceededException ** 资源的权限策略太大。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 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 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/AddLayerVersionPermission) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddLayerVersionPermission) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddLayerVersionPermission) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddLayerVersionPermission) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddLayerVersionPermission) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddLayerVersionPermission) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddLayerVersionPermission) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddLayerVersionPermission) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddLayerVersionPermission) # AddPermission 授予 AWS 服务、AWS 账户或 AWS 组织使用函数的权限。您可以在函数级别应用策略，也可以指定限定符以限制对单个版本或别名的访问。如果您使用限定符，则调用程序必须使用该版本或别名的完整 Amazon Resource Name (ARN) 来调用该函数。注意：Lambda 不支持将策略添加到版本 \$1LATEST。要向另一个账户授予权限，请将账户 ID 指定为 `Principal`。要向在 AWS Organizations 中定义的组织授予权限，请将组织 ID 指定为 `PrincipalOrgID`。对于 AWS 服务，主体是服务定义的域样式标识符，例如 `s3.amazonaws.com` 或 `sns.amazonaws.com`。对于 AWS 服务，您还可以将关联资源的 ARN 指定为 `SourceArn`。如果在未指定源的情况下向服务主体授予权限，则其他账户可能会在其账户中配置资源以调用 Lambda 函数。此操作将一条语句添加到该函数的基于资源的权限策略。有关函数策略的更多信息，请参阅[将基于资源的策略用于 Lambda](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html)。 ## 请求语法 ``` POST /2015-03-31/functions/FunctionName/policy?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "Action": "string", "EventSourceToken": "string", "FunctionUrlAuthType": "string", "Principal": "string", "PrincipalOrgID": "string", "RevisionId": "string", "SourceAccount": "string", "SourceArn": "string", "StatementId": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_AddPermission_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_AddPermission_RequestSyntax) ** 指定版本或别名以向函数的发布版本添加权限。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [Action](#API_AddPermission_RequestSyntax) ** 主体可以对函数执行的操作。例如，`lambda:InvokeFunction` 或 `lambda:GetFunction`。类型：字符串模式：`(lambda:[*]|lambda:[a-zA-Z]+|[*])` 必需：是 ** [EventSourceToken](#API_AddPermission_RequestSyntax) ** 对于 Alexa Smart Home 函数，为必须由调用程序提供的令牌。类型：字符串长度约束：最小长度为 0。最大长度为 256。模式：`[a-zA-Z0-9._\-]+` 必需：否 ** [FunctionUrlAuthType](#API_AddPermission_RequestSyntax) ** 函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 `AWS_IAM`。如果想绕过 IAM 身份验证以创建公有端点，请设置为 `NONE`。有关更多信息，请参阅 [Lambda 函数 URL 的安全性和身份验证模型](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html)。类型：字符串有效值：`NONE | AWS_IAM` 必需：否 ** [Principal](#API_AddPermission_RequestSyntax) ** 调用函数的 AWS 服务或 AWS 账户。如果您指定一个服务，请使用 `SourceArn` 或 `SourceAccount` 来限制哪些人可以通过该服务调用该函数。类型：字符串模式：`[^\s]+` 必需：是 ** [PrincipalOrgID](#API_AddPermission_RequestSyntax) ** AWS Organizations 中的组织标识符。使用此函数向此组织下的所有 AWS 账户授予权限。类型：字符串长度限制：最小长度为 12。最大长度为 34。模式：`^o-[a-z0-9]{10,32}$` 必需：否 ** [RevisionId](#API_AddPermission_RequestSyntax) ** 仅当修订版 ID 与指定的 ID 匹配时才更新策略。使用此选项以避免修改自上次读取后已发生更改的策略。类型：字符串必需：否 ** [SourceAccount](#API_AddPermission_RequestSyntax) ** 对于 AWS 服务，为拥有此资源的 AWS 账户 ID。将其与 `SourceArn` 一起使用以确保资源归指定的账户所有。Amazon S3 存储桶的拥有者可以将其删除，并由其他账户重新创建。类型：字符串长度约束：最大长度为 12。模式：`\d{12}` 必需：否 ** [SourceArn](#API_AddPermission_RequestSyntax) ** 对于 AWS 服务，为调用该函数的 AWS 资源的 ARN。例如，Amazon S3 存储桶或 Amazon SNS 主题。请注意，Lambda 使用 `StringLike` 运算符配置该比较。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 必需：否 ** [StatementId](#API_AddPermission_RequestSyntax) ** 将语句与同一策略中的其他语句区分开来的语句标识符。类型：字符串长度约束：最小长度为 1。最大长度为 100。模式：`([a-zA-Z0-9-_]+)` 必需：是 ## 响应语法 ``` HTTP/1.1 201 Content-type: application/json { "Statement": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 201 响应。服务以 JSON 格式返回的以下数据。 ** [Statement](#API_AddPermission_ResponseSyntax) ** 添加到函数策略的权限语句。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** PolicyLengthExceededException ** 资源的权限策略太大。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 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 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/AddPermission) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddPermission) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddPermission) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddPermission) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddPermission) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddPermission) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddPermission) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddPermission) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddPermission) # CreateAlias 为 Lambda 函数版本创建一个[别名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)。别名用来为客户端提供函数标识符，您可以更新该标识符以调用其他版本。您还可以映射别名以在两个版本之间拆分调用请求。使用 `RoutingConfig` 参数可指定另一个版本以及该版本收到的调用请求的百分比。 ## 请求语法 ``` POST /2015-03-31/functions/FunctionName/aliases HTTP/1.1 Content-type: application/json { "Description": "string", "FunctionVersion": "string", "Name": "string", "RoutingConfig": { "AdditionalVersionWeights": { "string" : number } } } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_CreateAlias_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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 格式的以下数据。 ** [Description](#API_CreateAlias_RequestSyntax) ** 别名的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ** [FunctionVersion](#API_CreateAlias_RequestSyntax) ** 别名调用的函数版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` 必需：是 ** [Name](#API_CreateAlias_RequestSyntax) ** 别名的名称。类型：字符串长度限制：长度下限为 1。长度上限为 128。模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 必需：是 ** [RoutingConfig](#API_CreateAlias_RequestSyntax) ** 别名的[路由配置](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing)。类型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 对象必需：否 ## 响应语法 ``` HTTP/1.1 201 Content-type: application/json { "AliasArn": "string", "Description": "string", "FunctionVersion": "string", "Name": "string", "RevisionId": "string", "RoutingConfig": { "AdditionalVersionWeights": { "string" : number } } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 201 响应。服务以 JSON 格式返回的以下数据。 ** [AliasArn](#API_CreateAlias_ResponseSyntax) ** 是别名的 Amazon Resource Name (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-_]+))?` ** [Description](#API_CreateAlias_ResponseSyntax) ** 别名的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [FunctionVersion](#API_CreateAlias_ResponseSyntax) ** 别名调用的函数版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [Name](#API_CreateAlias_ResponseSyntax) ** 别名的名称。类型：字符串长度限制：长度下限为 1。长度上限为 128。模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)` ** [RevisionId](#API_CreateAlias_ResponseSyntax) ** 更新别名时更改的唯一标识符。类型：字符串 ** [RoutingConfig](#API_CreateAlias_ResponseSyntax) ** 别名的[路由配置](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html)。类型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateAlias) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateAlias) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateAlias) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateAlias) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateAlias) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateAlias) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateAlias) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateAlias) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateAlias) # CreateCodeSigningConfig 创建代码签名配置。[代码签名配置](https://docs.aws.amazon.com/lambda/latest/dg/configuration-codesigning.html)定义了允许的签名配置文件列表以及代码签名验证策略（在部署验证检查失败时要采取的操作）。 ## 请求语法 ``` POST /2020-04-22/code-signing-configs/ HTTP/1.1 Content-type: application/json { "AllowedPublishers": { "SigningProfileVersionArns": [ "string" ] }, "CodeSigningPolicies": { "UntrustedArtifactOnDeployment": "string" }, "Description": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [AllowedPublishers](#API_CreateCodeSigningConfig_RequestSyntax) ** 此代码签名配置的签名配置文件。类型：[AllowedPublishers](API_AllowedPublishers.md) 对象必需：是 ** [CodeSigningPolicies](#API_CreateCodeSigningConfig_RequestSyntax) ** 代码签名策略定义验证检查失败时要执行的操作。类型：[CodeSigningPolicies](API_CodeSigningPolicies.md) 对象必需：否 ** [Description](#API_CreateCodeSigningConfig_RequestSyntax) ** 此代码签名配置的描述性名称。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ## 响应语法 ``` HTTP/1.1 201 Content-type: application/json { "CodeSigningConfig": { "AllowedPublishers": { "SigningProfileVersionArns": [ "string" ] }, "CodeSigningConfigArn": "string", "CodeSigningConfigId": "string", "CodeSigningPolicies": { "UntrustedArtifactOnDeployment": "string" }, "Description": "string", "LastModified": "string" } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 201 响应。服务以 JSON 格式返回的以下数据。 ** [CodeSigningConfig](#API_CreateCodeSigningConfig_ResponseSyntax) ** 代码签名配置。类型：[CodeSigningConfig](API_CodeSigningConfig.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateCodeSigningConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateCodeSigningConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateCodeSigningConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateCodeSigningConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateCodeSigningConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateCodeSigningConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateCodeSigningConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateCodeSigningConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateCodeSigningConfig) # CreateEventSourceMapping 在事件源和 AWS Lambda 函数之间创建映射。Lambda 从事件源读取项目并调用该函数。有关如何配置不同事件源的详细信息，请参阅以下主题。 + [Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-dynamodb-eventsourcemapping) + [Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-eventsourcemapping) + [Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-eventsource) + [Amazon MQ 和 RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-eventsourcemapping) + [Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html) + [Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/kafka-smaa.html) + [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) 以下错误处理选项仅适用于流源（DynamoDB 和 Kinesis）： + `BisectBatchOnFunctionError` – 如果函数返回错误，则将批次拆分为两批并重试。 + `DestinationConfig` – 将丢弃的记录发送到 Amazon SQS 队列或 Amazon SNS 主题。 + `MaximumRecordAgeInSeconds` – 丢弃超过指定期限的记录。默认值为无限 (-1)。如果设置为无限 (-1)，则会一直重试失败的记录，直到记录过期。 + `MaximumRetryAttempts` – 在指定重试次数后丢弃记录。默认值为无限 (-1)。如果设置为无限 (-1)，则会一直重试失败的记录，直到记录过期。 + `ParallelizationFactor` – 同时处理来自每个分片的多个批次。有关适用于每个事件源的配置参数信息，请参阅以下主题。 + [Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-params) + [Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-params) + [Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-params) + [Amazon MQ 和 RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-params) + [Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-parms) + [Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-kafka-parms) + [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html#docdb-configuration) ## 请求语法 ``` POST /2015-03-31/event-source-mappings/ HTTP/1.1 Content-type: application/json { "AmazonManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "Enabled": boolean, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionName": "string", "FunctionResponseTypes": [ "string" ], "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "Queues": [ "string" ], "ScalingConfig": { "MaximumConcurrency": number }, "SelfManagedEventSource": { "Endpoints": { "string" : [ "string" ] } }, "SelfManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "StartingPosition": "string", "StartingPositionTimestamp": number, "Topics": [ "string" ], "TumblingWindowInSeconds": number } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [AmazonManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) ** Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件源的特定配置设置。类型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 对象必需：否 ** [BatchSize](#API_CreateEventSourceMapping_RequestSyntax) ** Lambda 从流或队列中提取并发送到函数的每个批处理中的最大记录数。Lambda 在单次调用中将批处理中的所有记录传递给函数，最高可传递同步调用的负载上限 (6 MB)。 + **Amazon Kinesis** – 默认值为 100。最大值为 10,000。 + **Amazon DynamoDB Streams** – 默认值为 100。最大值为 10,000。 + **Amazon Simple Queue Service** – 默认值为 10。对于标准队列，最大值为 10,000。对于 FIFO 队列，最大值为 10。 + **Amazon Managed Streaming for Apache Kafka** – 默认值为 100。最大值为 10,000。 + **自行管理的 Apache Kafka** – 默认值为 100。最大值为 10,000。 + **Amazon MQ（ActiveMQ 和 RabbitMQ）** – 默认值为 100。最大值为 10,000。 + **DocumentDB** – 默认值 100。最大值为 10,000。类型：整数有效范围：最小值为 1。最大值为 10000。必需：否 ** [BisectBatchOnFunctionError](#API_CreateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）如果函数返回错误，则将分处理拆分为两个并重试。类型：布尔值必需：否 ** [DestinationConfig](#API_CreateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis、DynamoDB Streams、Amazon MSK 和自行管理的 Kafka）用于在 Lambda 处理事件后指定事件目标的配置对象。类型：[DestinationConfig](API_DestinationConfig.md) 对象必需：否 ** [DocumentDBEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) ** DocumentB 事件源的特定配置设置。类型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 对象必需：否 ** [Enabled](#API_CreateEventSourceMapping_RequestSyntax) ** 当为 true 时，事件源映射处于活动状态。当为 false 时，Lambda 暂停轮询和调用。默认值：True 类型：布尔值必需：否 ** [EventSourceArn](#API_CreateEventSourceMapping_RequestSyntax) ** 事件源的 Amazon Resource Name (ARN)。 + **Amazon Kinesis** – 数据流或流使用者的 ARN。 + **Amazon DynamoDB Streams** – 流的 ARN。 + **Amazon Simple Queue Service** – 队列的 ARN。 + **Amazon Managed Streaming for Apache Kafka** – 集群的 ARN 或 VPC 连接的 ARN（用于[跨账户事件源映射](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#msk-multi-vpc)）。 + **Amazon MQ** – 代理的 ARN。 + **Amazon DocumentDB** – DocumentDB 更改流的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 必需：否 ** [FilterCriteria](#API_CreateEventSourceMapping_RequestSyntax) ** 定义用于确定 Lambda 是否应处理事件的筛选条件的对象。有关更多信息，请参阅 [Lambda 事件筛选](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。类型：[FilterCriteria](API_FilterCriteria.md) 对象必需：否 ** [FunctionName](#API_CreateEventSourceMapping_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `MyFunction`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **版本或别名 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD`。 + **部分 ARN** – `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度将限制为 64 个字符。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [FunctionResponseTypes](#API_CreateEventSourceMapping_RequestSyntax) ** （Kinesis、DynamoDB Streams 和 Amazon SQS）应用于事件源映射的当前响应类型枚举的列表。类型：字符串数组数组成员：最少 0 项。最多 1 项。有效值：`ReportBatchItemFailures` 必需：否 ** [MaximumBatchingWindowInSeconds](#API_CreateEventSourceMapping_RequestSyntax) ** Lambda 在调用函数之前收集记录的最长时间，以秒为单位。您可以将 `MaximumBatchingWindowInSeconds` 配置为介于 0 秒到 300 秒之间的任意值，以秒的整数倍调整。对于流和 Amazon SQS 事件源，默认批处理时段为 0 秒。对于 Amazon MSK、自行管理的 Apache Kafka、Amazon MQ 和 DocumentDB 事件源，默认批处理时间窗口为 500 毫秒。请注意，由于您只能以秒为增量更改 `MaximumBatchingWindowInSeconds`，所以在更改后无法恢复到 500 毫秒的默认批处理时段。要恢复原定设置的批处理时段，必须创建新的事件源映射。相关设置：对于流和 Amazon SQS 事件源，当将 `BatchSize` 设置为大于 10 的值时，必须将 `MaximumBatchingWindowInSeconds` 至少设置为 1。类型：整数有效范围：最小值为 0。最大值为 300。必需：否 ** [MaximumRecordAgeInSeconds](#API_CreateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）丢弃超过指定龄期的记录。默认值为无限 (-1)。类型：整数有效范围：最小值为 -1。最大值为 604800。必需：否 ** [MaximumRetryAttempts](#API_CreateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）在指定重试次数后丢弃记录。默认值为无限 (-1)。如果设置为无限 (-1)，则会一直重试失败的记录，直到记录过期。类型：整数有效范围：最小值为 -1。最大值为 10000。必需：否 ** [ParallelizationFactor](#API_CreateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）每个分片中同时处理的批处理数。类型：整数有效范围：最小值为 1。最大值为 10。必需：否 ** [Queues](#API_CreateEventSourceMapping_RequestSyntax) ** (MQ) 要使用的 Amazon MQ 代理目标队列的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。最大长度为 1000。模式：`[\s\S]*` 必需：否 ** [ScalingConfig](#API_CreateEventSourceMapping_RequestSyntax) ** （仅限 Amazon SQS）事件源的扩缩配置。有关更多信息，请参阅[为 Amazon SQS 事件源配置最大并发](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)。类型：[ScalingConfig](API_ScalingConfig.md) 对象必需：否 ** [SelfManagedEventSource](#API_CreateEventSourceMapping_RequestSyntax) ** 从中接收记录的自行管理的 Apache Kafka 集群。类型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 对象必需：否 ** [SelfManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) ** 自行管理的 Apache Kafka 事件源的特定配置设置。类型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 对象必需：否 ** [SourceAccessConfigurations](#API_CreateEventSourceMapping_RequestSyntax) ** 用于保护事件源的身份验证协议数组或 VPC 组件。类型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 对象数组数组成员：最少 0 项。最多 22 项。必需：否 ** [StartingPosition](#API_CreateEventSourceMapping_RequestSyntax) ** 在流中开始读取数据的位置。对于 Amazon Kinesis 和 Amazon DynamoDB Streams 事件源，为必需项。仅 Amazon Kinesis 流、Amazon DocumentDB、Amazon MSK 和自行管理的 Apache Kafka 支持 `AT_TIMESTAMP`。类型：字符串有效值：`TRIM_HORIZON | LATEST | AT_TIMESTAMP` 必需：否 ** [StartingPositionTimestamp](#API_CreateEventSourceMapping_RequestSyntax) ** 将 `StartingPosition` 设置为 `AT_TIMESTAMP` 时，即开始读取的时间（以 Unix 时间秒为单位）。`StartingPositionTimestamp` 不能是未来时间。类型：时间戳必需：否 ** [Topics](#API_CreateEventSourceMapping_RequestSyntax) ** Kafka 主题的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。长度上限为 249。模式：`^[^.]([a-zA-Z0-9\-_.]+)` 必需：否 ** [TumblingWindowInSeconds](#API_CreateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）DynamoDB 和 Kinesis Streams 事件源的处理时间窗口（以秒为单位）。值为 0 秒表示无滑动时间窗口。类型：整数有效范围：最小值为 0。最大值为 900。必需：否 ## 响应语法 ``` HTTP/1.1 202 Content-type: application/json { "AmazonManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionArn": "string", "FunctionResponseTypes": [ "string" ], "LastModified": number, "LastProcessingResult": "string", "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "Queues": [ "string" ], "ScalingConfig": { "MaximumConcurrency": number }, "SelfManagedEventSource": { "Endpoints": { "string" : [ "string" ] } }, "SelfManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "StartingPosition": "string", "StartingPositionTimestamp": number, "State": "string", "StateTransitionReason": "string", "Topics": [ "string" ], "TumblingWindowInSeconds": number, "UUID": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 202 响应。服务以 JSON 格式返回以下数据。 ** [AmazonManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件源的特定配置设置。类型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 对象 ** [BatchSize](#API_CreateEventSourceMapping_ResponseSyntax) ** Lambda 从流或队列中提取并发送到函数的每个批处理中的最大记录数。Lambda 在单次调用中将批处理中的所有记录传递给函数，最高可传递同步调用的负载上限 (6 MB)。默认值：因服务而异。对于 Amazon SQS，默认值为 10。对于所有其他服务，默认值为 100。相关设置：当将 `BatchSize` 设置为一个大于 10 的值时，必须至少将 `MaximumBatchingWindowInSeconds` 设置为 1。类型：整数有效范围：最小值为 1。最大值为 10000。 ** [BisectBatchOnFunctionError](#API_CreateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）如果函数返回错误，则将分处理拆分为两个并重试。默认值为 False。类型：布尔值 ** [DestinationConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis、DynamoDB Streams、Amazon MSK 和自行管理的 Apache Kafka 事件源）用于在 Lambda 处理事件后指定事件目标的配置对象。类型：[DestinationConfig](API_DestinationConfig.md) 对象 ** [DocumentDBEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** DocumentB 事件源的特定配置设置。类型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 对象 ** [EventSourceArn](#API_CreateEventSourceMapping_ResponseSyntax) ** 事件源的 Amazon Resource Name (ARN)。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [FilterCriteria](#API_CreateEventSourceMapping_ResponseSyntax) ** 定义用于确定 Lambda 是否应处理事件的筛选条件的对象。有关更多信息，请参阅 [Lambda 事件筛选](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。类型：[FilterCriteria](API_FilterCriteria.md) 对象 ** [FunctionArn](#API_CreateEventSourceMapping_ResponseSyntax) ** Lambda 函数的 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-_]+))?` ** [FunctionResponseTypes](#API_CreateEventSourceMapping_ResponseSyntax) ** （Kinesis、DynamoDB Streams 和 Amazon SQS）应用于事件源映射的当前响应类型枚举的列表。类型：字符串数组数组成员：最少 0 项。最多 1 项。有效值：`ReportBatchItemFailures` ** [LastModified](#API_CreateEventSourceMapping_ResponseSyntax) ** 上次更新事件源映射或其状态更改的日期（以 Unix 时间秒为单位）。类型：时间戳 ** [LastProcessingResult](#API_CreateEventSourceMapping_ResponseSyntax) ** 函数的最后一次 Lambda 调用结果。类型：字符串 ** [MaximumBatchingWindowInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) ** Lambda 在调用函数之前收集记录的最长时间，以秒为单位。您可以将 `MaximumBatchingWindowInSeconds` 配置为介于 0 秒到 300 秒之间的任意值，以秒的整数倍调整。对于流和 Amazon SQS 事件源，默认批处理时段为 0 秒。对于 Amazon MSK、自行管理的 Apache Kafka、Amazon MQ 和 DocumentDB 事件源，默认批处理时间窗口为 500 毫秒。请注意，由于您只能以秒为增量更改 `MaximumBatchingWindowInSeconds`，所以在更改后无法恢复到 500 毫秒的默认批处理时段。要恢复原定设置的批处理时段，必须创建新的事件源映射。相关设置：对于流和 Amazon SQS 事件源，当将 `BatchSize` 设置为大于 10 的值时，必须将 `MaximumBatchingWindowInSeconds` 至少设置为 1。类型：整数有效范围：最小值为 0。最大值为 300。 ** [MaximumRecordAgeInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）丢弃超过指定龄期的记录。原定设置值为 -1，该值将最大年龄设置为无限。将该值设置为无限后，Lambda 永远不会删除旧记录。最长记录期限的最小有效值为 60 秒。尽管小于 60 和大于 -1 的值都在参数的绝对范围内，但不允许使用它们类型：整数有效范围：最小值为 -1。最大值为 604800。 ** [MaximumRetryAttempts](#API_CreateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）在指定重试次数后丢弃记录。原定设置值为 -1，该值将最大重试次数设置为无限。将 MaximumRetryAttempts 设置为无限后，Lambda 会重试失败的记录，直到事件源中的记录过期为止。类型：整数有效范围：最小值为 -1。最大值为 10000。 ** [ParallelizationFactor](#API_CreateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）每个分片中同时处理的批处理数。默认值是 1。类型：整数有效范围：最小值为 1。最大值为 10。 ** [Queues](#API_CreateEventSourceMapping_ResponseSyntax) ** (Amazon MQ) 要使用的 Amazon MQ 代理目标队列的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。最大长度为 1000。模式：`[\s\S]*` ** [ScalingConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** （仅限 Amazon SQS）事件源的扩缩配置。有关更多信息，请参阅[为 Amazon SQS 事件源配置最大并发](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)。类型：[ScalingConfig](API_ScalingConfig.md) 对象 ** [SelfManagedEventSource](#API_CreateEventSourceMapping_ResponseSyntax) ** 适用于事件源的自行管理 Apache Kafka 集群。类型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 对象 ** [SelfManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** 自行管理的 Apache Kafka 事件源的特定配置设置。类型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 对象 ** [SourceAccessConfigurations](#API_CreateEventSourceMapping_ResponseSyntax) ** 用于保护与定义事件源的身份验证协议数组 VPC 组件或虚拟化主机。类型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 对象数组数组成员：最少 0 项。最多 22 项。 ** [StartingPosition](#API_CreateEventSourceMapping_ResponseSyntax) ** 在流中开始读取数据的位置。对于 Amazon Kinesis 和 Amazon DynamoDB Streams 事件源，为必需项。仅 Amazon Kinesis 流、Amazon DocumentDB、Amazon MSK 和自行管理的 Apache Kafka 支持 `AT_TIMESTAMP`。类型：字符串有效值：`TRIM_HORIZON | LATEST | AT_TIMESTAMP` ** [StartingPositionTimestamp](#API_CreateEventSourceMapping_ResponseSyntax) ** 将 `StartingPosition` 设置为 `AT_TIMESTAMP` 时，即开始读取的时间（以 Unix 时间秒为单位）。`StartingPositionTimestamp` 不能是未来时间。类型：时间戳 ** [State](#API_CreateEventSourceMapping_ResponseSyntax) ** 事件源映射的状态。此状态可以是以下值之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。类型：字符串 ** [StateTransitionReason](#API_CreateEventSourceMapping_ResponseSyntax) ** 表明是用户还是 Lambda 对事件源映射进行了最后一次更改。类型：字符串 ** [Topics](#API_CreateEventSourceMapping_ResponseSyntax) ** Kafka 主题的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。长度上限为 249。模式：`^[^.]([a-zA-Z0-9\-_.]+)` ** [TumblingWindowInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）DynamoDB 和 Kinesis Streams 事件源的处理时间窗口（以秒为单位）。值为 0 秒表示无滑动时间窗口。类型：整数有效范围：最小值为 0。最大值为 900。 ** [UUID](#API_CreateEventSourceMapping_ResponseSyntax) ** 事件源映射的标识符。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateEventSourceMapping) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateEventSourceMapping) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateEventSourceMapping) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateEventSourceMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateEventSourceMapping) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateEventSourceMapping) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateEventSourceMapping) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateEventSourceMapping) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateEventSourceMapping) # CreateFunction 创建 Lambda 函数。要创建函数，需要[部署程序包](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html)和[执行角色](https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role)。部署包是包含函数代码的 .zip 文件存档或容器映像。执行角色授予该函数使用 AWS 服务的权限，例如用于日志流的 Amazon CloudWatch Logs 和用于请求跟踪的 AWS X-Ray。如果部署包是[容器映像](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html)，则可将部署包类型设置为 `Image`。对于容器映像，代码属性必须在 Amazon ECR 注册表中包含容器映像的 URI。您无需指定处理程序和运行时属性。如果部署包是 [.zip 文件存档](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip)，则可将部署包类型设置为 `Zip`。对于 .zip 文件存档，代码属性会指定 .zip 文件的位置。您还必须指定处理程序和运行时属性。部署包中的代码必须与函数的目标指令集架构兼容（`x86-64` 或 `arm64`)。如果未指定架构，则默认值为 `x86-64`。创建函数时，Lambda 会预置该函数及其支持资源的实例。如果您的函数连接到 VPC，此过程可能需要一分钟左右。在此期间，您无法调用或修改函数。来自 [GetFunctionConfiguration](API_GetFunctionConfiguration.md) 的响应中的 `State`、`StateReason` 和 `StateReasonCode` 字段指示函数何时可进行调用。有关更多信息，请参阅 [Lambda 函数状态](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html)。函数具有未发布的版本，并且可以具有已发布的版本和别名。更新函数的代码和配置时，未发布的版本将会更改。已发布版本是函数代码和配置的快照，无法更改。别名是映射到版本的命名资源，并且可以更改为映射到其他版本。使用 `Publish` 参数，以通过其初始配置创建函数的版本 `1`。其他参数允许您配置特定于版本和函数级别的设置。稍后可以使用 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) 修改特定于版本的设置。函数级别设置同时应用于函数的未发布版本和已发布版本，并且包含标签 ([TagResource](API_TagResource.md)) 和每函数并发限制 ([PutFunctionConcurrency](API_PutFunctionConcurrency.md))。如果部署包是 .zip 文件存档，则可以使用代码签名。要为此函数启用代码签名，请指定代码签名配置的 ARN。当用户尝试使用 [UpdateFunctionCode](API_UpdateFunctionCode.md)部署代码包时，Lambda 会检查代码包是否具有可信发布者的有效签名。代码签名配置包括一组签名配置文件，这些配置文件定义了此函数的可信发布者。如果另一个 AWS 账户或 AWS 服务调用您的函数，请使用 [AddPermission](API_AddPermission.md) 通过创建基于资源的 AWS Identity and Access Management（IAM）policy 授予权限。您可以在函数级别授予版本或别名的权限。要直接调用函数，请使用 [Invoke](API_Invoke.md)。要调用您的函数以响应其他 AWS 服务，请创建事件源映射（[CreateEventSourceMapping](API_CreateEventSourceMapping.md)），或者在其他服务中配置函数触发器。有关更多信息，请参阅[调用 Lambda 函数](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html)。 ## 请求语法 ``` POST /2015-03-31/functions HTTP/1.1 Content-type: application/json { "Architectures": [ "string" ], "Code": { "ImageUri": "string", "S3Bucket": "string", "S3Key": "string", "S3ObjectVersion": "string", "ZipFile": blob }, "CodeSigningConfigArn": "string", "DeadLetterConfig": { "TargetArn": "string" }, "Description": "string", "Environment": { "Variables": { "string" : "string" } }, "EphemeralStorage": { "Size": number }, "FileSystemConfigs": [ { "Arn": "string", "LocalMountPath": "string" } ], "FunctionName": "string", "Handler": "string", "ImageConfig": { "Command": [ "string" ], "EntryPoint": [ "string" ], "WorkingDirectory": "string" }, "KMSKeyArn": "string", "Layers": [ "string" ], "LoggingConfig": { "ApplicationLogLevel": "string", "LogFormat": "string", "LogGroup": "string", "SystemLogLevel": "string" }, "MemorySize": number, "PackageType": "string", "Publish": boolean, "Role": "string", "Runtime": "string", "SnapStart": { "ApplyOn": "string" }, "Tags": { "string" : "string" }, "Timeout": number, "TracingConfig": { "Mode": "string" }, "VpcConfig": { "Ipv6AllowedForDualStack": boolean, "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ] } } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [Architectures](#API_CreateFunction_RequestSyntax) ** 该函数支持的指令集架构。输入具有其中一个有效值（arm64 或 x86\$164）的字符串数组。默认值为 `x86_64`。类型：字符串数组数组成员：固定数量为 1 项。有效值：`x86_64 | arm64` 必需：否 ** [Code](#API_CreateFunction_RequestSyntax) ** 函数的代码。类型：[FunctionCode](API_FunctionCode.md) 对象必需：是 ** [CodeSigningConfigArn](#API_CreateFunction_RequestSyntax) ** 要为此函数启用代码签名，请指定代码签名配置的 ARN。代码签名配置包括一组签名配置文件，这些配置文件定义了此函数的可信发布者。类型：字符串长度约束：最大长度为 200。模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` 必需：否 ** [DeadLetterConfig](#API_CreateFunction_RequestSyntax) ** 死信队列配置，用于指定 Lambda 在处理失败时发送异步事件的队列或主题。有关更多信息，请参阅[死信队列](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq)。类型：[DeadLetterConfig](API_DeadLetterConfig.md) 对象必需：否 ** [Description](#API_CreateFunction_RequestSyntax) ** 该函数的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ** [Environment](#API_CreateFunction_RequestSyntax) ** 执行期间可从函数代码访问的环境变量。类型：[Environment](API_Environment.md) 对象必需：否 ** [EphemeralStorage](#API_CreateFunction_RequestSyntax) ** 函数的 `/tmp` 目录大小（以 MB 为单位）。默认值为 512，但可以是介于 512 到 10240 MB 之间的任意整数。有关更多信息，请参阅[配置短暂存储（控制台）](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。类型：[EphemeralStorage](API_EphemeralStorage.md) 对象必需：否 ** [FileSystemConfigs](#API_CreateFunction_RequestSyntax) ** Amazon EFS 文件系统的连接设置。类型：[FileSystemConfig](API_FileSystemConfig.md) 对象数组数组成员：最多 1 个物品。必需：否 ** [FunctionName](#API_CreateFunction_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`(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](#API_CreateFunction_RequestSyntax) ** 代码中方法的名称，Lambda 可调用该方法来运行您的函数。如果部署包是 .zip 文件归档，则需要使用处理程序。该格式包括文件名，也可以包括命名空间和其他限定符，具体取决于运行时。有关更多信息，请参阅 [Lambda 编程模型](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html)。类型：字符串长度限制：最大长度为 128。模式：`[^\s]+` 必需：否 ** [ImageConfig](#API_CreateFunction_RequestSyntax) ** 覆盖容器镜像 Dockerfile 中的值的容器镜像[配置值](https://docs.aws.amazon.com/lambda/latest/dg/configuration-images.html#configuration-images-settings)。类型：[ImageConfig](API_ImageConfig.md) 对象必需：否 ** [KMSKeyArn](#API_CreateFunction_RequestSyntax) ** AWS Key Management Service (AWS KMS) 客户托管密钥的 ARN，用于加密函数的[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)。激活 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 后，Lambda 还使用此密钥对函数的快照进行加密。如果您使用容器映像部署函数，Lambda 还会在部署函数后使用此密钥对其进行加密。请注意，此密钥与在 Amazon Elastic Container Registry（Amazon ECR）中用于保护容器映像的密钥不同。如果您未提供客户托管密钥，Lambda 将使用默认服务密钥。类型：字符串模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 必需：否 ** [Layers](#API_CreateFunction_RequestSyntax) ** 要添加到函数执行环境中的[函数层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)列表。通过 ARN 指定每一层，包括版本。类型：字符串数组长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` 必需：否 ** [LoggingConfig](#API_CreateFunction_RequestSyntax) ** 该函数的 Amazon CloudWatch Logs 配置设置。类型：[LoggingConfig](API_LoggingConfig.md) 对象必需：否 ** [MemorySize](#API_CreateFunction_RequestSyntax) ** 在运行时 [可用于函数的内存](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console) 量。提高该函数的内存也会增加它的 CPU 分配。默认值为 128 MB。该值可以是 1 MB 的任意倍数。类型：整数有效范围：最小值为 128。最大值为 10240。必需：否 ** [PackageType](#API_CreateFunction_RequestSyntax) ** 部署程序包的类型。将容器映像设置为 `Image`，然后将 .zip 文件归档设置为 `Zip`。类型：字符串有效值：`Zip | Image` 必需：否 ** [Publish](#API_CreateFunction_RequestSyntax) ** 设置为 true 以在创建期间发布函数的第一个版本。类型：布尔值必需：否 ** [Role](#API_CreateFunction_RequestSyntax) ** 函数的执行角色的 Amazon Resource Name (ARN)。类型：字符串模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必需：是 ** [Runtime](#API_CreateFunction_RequestSyntax) ** 函数的[运行时](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)的标识符。如果部署包是 .zip 文件归档，则需要使用运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` 必需：否 ** [SnapStart](#API_CreateFunction_RequestSyntax) ** 函数的 [SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) 设置。类型：[SnapStart](API_SnapStart.md) 对象必需：否 ** [Tags](#API_CreateFunction_RequestSyntax) ** 要应用于函数的[标签](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)列表。类型：字符串到字符串映射必需：否 ** [Timeout](#API_CreateFunction_RequestSyntax) ** Lambda 在停止函数前允许其运行的时长（以秒为单位）。默认值为 3 秒。允许的最大值为 900 秒。有关更多信息，请参阅 [Lambda 执行环境](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html)。类型：整数有效范围：最小值为 1。必需：否 ** [TracingConfig](#API_CreateFunction_RequestSyntax) ** 将 `Mode` 设置为 `Active`，以使用 [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) 对传入请求的子集进行采样和跟踪。类型：[TracingConfig](API_TracingConfig.md) 对象必需：否 ** [VpcConfig](#API_CreateFunction_RequestSyntax) ** 对于与 VPC 中的AWS资源的网络连接，指定 VPC 中的安全组和子网列表。当您将函数连接到 VPC 时，它只能通过该 VPC 访问资源和互联网。有关更多信息，请参阅[配置 Lambda 函数以访问 VPC 中的资源](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html)。类型：[VpcConfig](API_VpcConfig.md) 对象必需：否 ## 响应语法 ``` HTTP/1.1 201 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 201 响应。服务以 JSON 格式返回的以下数据。 ** [Architectures](#API_CreateFunction_ResponseSyntax) ** 该函数支持的指令集架构。架构是具有有效值之一的字符串数组。默认架构值是 `x86_64`。类型：字符串数组数组成员：固定数量为 1 项。有效值：`x86_64 | arm64` ** [CodeSha256](#API_CreateFunction_ResponseSyntax) ** 函数部署包的 SHA256 哈希。类型：字符串 ** [CodeSize](#API_CreateFunction_ResponseSyntax) ** 函数部署包的大小（以字节为单位）。类型：长整型 ** [DeadLetterConfig](#API_CreateFunction_ResponseSyntax) ** 函数的死信队列。类型：[DeadLetterConfig](API_DeadLetterConfig.md) 对象 ** [Description](#API_CreateFunction_ResponseSyntax) ** 函数说明。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [Environment](#API_CreateFunction_ResponseSyntax) ** 函数[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。在 AWS CloudTrail 日志中被忽略。类型：[EnvironmentResponse](API_EnvironmentResponse.md) 对象 ** [EphemeralStorage](#API_CreateFunction_ResponseSyntax) ** 函数的 `/tmp` 目录大小（以 MB 为单位）。默认值为 512，但可以是介于 512 到 10240 MB 之间的任意整数。有关更多信息，请参阅[配置短暂存储（控制台）](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。类型：[EphemeralStorage](API_EphemeralStorage.md) 对象 ** [FileSystemConfigs](#API_CreateFunction_ResponseSyntax) ** [Amazon EFS 文件系统](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的连接设置。类型：[FileSystemConfig](API_FileSystemConfig.md) 对象数组数组成员：最多 1 个物品。 ** [FunctionArn](#API_CreateFunction_ResponseSyntax) ** 函数的 Amazon Resource Name (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](#API_CreateFunction_ResponseSyntax) ** 函数的名称。类型：字符串长度限制：最小长度为 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](#API_CreateFunction_ResponseSyntax) ** Lambda 为开始运行您的函数而调用的函数。类型：字符串长度限制：最大长度为 128。模式：`[^\s]+` ** [ImageConfigResponse](#API_CreateFunction_ResponseSyntax) ** 函数的镜像配置值。类型：[ImageConfigResponse](API_ImageConfigResponse.md) 对象 ** [KMSKeyArn](#API_CreateFunction_ResponseSyntax) ** 用于加密函数的[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)的 AWS KMS key。激活 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 时，此密钥还用于加密您的函数的快照。仅当您配置了客户托管密钥时，才会返回此密钥。类型：字符串模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` ** [LastModified](#API_CreateFunction_ResponseSyntax) ** 该函数上次更新的日期和时间，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [LastUpdateStatus](#API_CreateFunction_ResponseSyntax) ** 上次对函数执行的更新的状态。函数创建完成后，首先设置为 `Successful`。类型：字符串有效值：`Successful | Failed | InProgress` ** [LastUpdateStatusReason](#API_CreateFunction_ResponseSyntax) ** 上次对函数执行更新的原因。类型：字符串 ** [LastUpdateStatusReasonCode](#API_CreateFunction_ResponseSyntax) ** 函数上次更新的原因代码。类型：字符串有效值：`EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Layers](#API_CreateFunction_ResponseSyntax) ** 函数的[层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。类型：[Layer](API_Layer.md) 对象数组 ** [LoggingConfig](#API_CreateFunction_ResponseSyntax) ** 该函数的 Amazon CloudWatch Logs 配置设置。类型：[LoggingConfig](API_LoggingConfig.md) 对象 ** [MasterArn](#API_CreateFunction_ResponseSyntax) ** 对于 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](#API_CreateFunction_ResponseSyntax) ** 在运行时可用于函数的内存量。类型：整数有效范围：最小值为 128。最大值为 10240。 ** [PackageType](#API_CreateFunction_ResponseSyntax) ** 部署程序包的类型。将容器映像设置为 `Image`，然后将 .zip 文件存档设置为 `Zip`。类型：字符串有效值：`Zip | Image` ** [RevisionId](#API_CreateFunction_ResponseSyntax) ** 函数或别名的最新更新版本。类型：字符串 ** [Role](#API_CreateFunction_ResponseSyntax) ** 函数的执行角色。类型：字符串模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` ** [Runtime](#API_CreateFunction_ResponseSyntax) ** 函数的[运行时](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)的标识符。如果部署包是 .zip 文件归档，则需要使用运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [RuntimeVersionConfig](#API_CreateFunction_ResponseSyntax) ** 运行时的 ARN 和发生的任何错误。类型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 对象 ** [SigningJobArn](#API_CreateFunction_ResponseSyntax) ** 签名任务的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SigningProfileVersionArn](#API_CreateFunction_ResponseSyntax) ** 签名配置文件版本的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SnapStart](#API_CreateFunction_ResponseSyntax) ** 发布函数版本时，将 `ApplyOn` 设置为 `PublishedVersions` 以创建初始化执行环境的快照。有关更多信息，请参阅 [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)（使用 Lambda SnapStart 提高启动性能）。类型：[SnapStartResponse](API_SnapStartResponse.md) 对象 ** [State](#API_CreateFunction_ResponseSyntax) ** 函数的当前状态。当状态为 `Inactive`，您可以通过调用函数来重新激活该函数。类型：字符串有效值：`Pending | Active | Inactive | Failed` ** [StateReason](#API_CreateFunction_ResponseSyntax) ** 函数当前状态的原因。类型：字符串 ** [StateReasonCode](#API_CreateFunction_ResponseSyntax) ** 函数当前状态的原因代码。当代码为 `Creating` 时，无法调用或修改该函数。类型：字符串有效值：`Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Timeout](#API_CreateFunction_ResponseSyntax) ** Lambda 在停止函数前允许其运行的时长（以秒为单位）。类型：整数有效范围：最小值为 1。 ** [TracingConfig](#API_CreateFunction_ResponseSyntax) ** 函数的 AWS X-Ray 跟踪配置。类型：[TracingConfigResponse](API_TracingConfigResponse.md) 对象 ** [Version](#API_CreateFunction_ResponseSyntax) ** Lambda 函数的版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [VpcConfig](#API_CreateFunction_ResponseSyntax) ** 函数的网络配置。类型：[VpcConfigResponse](API_VpcConfigResponse.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** CodeSigningConfigNotFoundException ** 指定的代码签名配置不存在。 HTTP 状态代码：404 ** CodeStorageExceededException ** 您的 AWS 账户已超出最大总代码大小。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 状态代码：400 ** CodeVerificationFailedException ** 代码签名失败，一个或多个签名验证检查不匹配或过期，并且代码签名策略设置为“ENFORCE”。Lambda 阻止部署。 HTTP 状态代码：400 ** InvalidCodeSignatureException ** 代码签名未通过完整性检查。如果完整性检查失败，Lambda 会阻止部署，即使代码签名策略设置为 WARN 也是如此。 HTTP 状态代码：400 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateFunction) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateFunction) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunction) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunction) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunction) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunction) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunction) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunction) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunction) # CreateFunctionUrlConfig 使用指定的配置参数创建 Lambda 函数 URL。函数 URL 是专用的 HTTP(S) 端点，可用于调用函数。 ## 请求语法 ``` POST /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "AuthType": "string", "Cors": { "AllowCredentials": boolean, "AllowHeaders": [ "string" ], "AllowMethods": [ "string" ], "AllowOrigins": [ "string" ], "ExposeHeaders": [ "string" ], "MaxAge": number }, "InvokeMode": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_CreateFunctionUrlConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_CreateFunctionUrlConfig_RequestSyntax) ** 别名。长度限制：最小长度为 1。长度上限为 128。模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))` ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AuthType](#API_CreateFunctionUrlConfig_RequestSyntax) ** 函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 `AWS_IAM`。如果想绕过 IAM 身份验证以创建公有端点，请设置为 `NONE`。有关更多信息，请参阅 [Lambda 函数 URL 的安全性和身份验证模型](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html)。类型：字符串有效值：`NONE | AWS_IAM` 必需：是 ** [Cors](#API_CreateFunctionUrlConfig_RequestSyntax) ** 适用于函数 URL 的 [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)（跨源资源共享）设置。类型：[Cors](API_Cors.md) 对象必需：否 ** [InvokeMode](#API_CreateFunctionUrlConfig_RequestSyntax) ** 使用以下选项之一： + `BUFFERED` – 这是默认选项。Lambda 通过 `Invoke` API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。 + `RESPONSE_STREAM` – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 `InvokeWithResponseStream` API 操作调用函数。最大响应负载大小为 20MB，但是，您可以[请求提高限额](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。类型：字符串有效值：`BUFFERED | RESPONSE_STREAM` 必需：否 ## 响应语法 ``` HTTP/1.1 201 Content-type: application/json { "AuthType": "string", "Cors": { "AllowCredentials": boolean, "AllowHeaders": [ "string" ], "AllowMethods": [ "string" ], "AllowOrigins": [ "string" ], "ExposeHeaders": [ "string" ], "MaxAge": number }, "CreationTime": "string", "FunctionArn": "string", "FunctionUrl": "string", "InvokeMode": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 201 响应。服务以 JSON 格式返回的以下数据。 ** [AuthType](#API_CreateFunctionUrlConfig_ResponseSyntax) ** 函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 `AWS_IAM`。如果想绕过 IAM 身份验证以创建公有端点，请设置为 `NONE`。有关更多信息，请参阅 [Lambda 函数 URL 的安全性和身份验证模型](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html)。类型：字符串有效值：`NONE | AWS_IAM` ** [Cors](#API_CreateFunctionUrlConfig_ResponseSyntax) ** 适用于函数 URL 的 [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)（跨源资源共享）设置。类型：[Cors](API_Cors.md) 对象 ** [CreationTime](#API_CreateFunctionUrlConfig_ResponseSyntax) ** 创建函数 URL 时，使用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [FunctionArn](#API_CreateFunctionUrlConfig_ResponseSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` ** [FunctionUrl](#API_CreateFunctionUrlConfig_ResponseSyntax) ** 函数的 HTTP URL 端点。类型：字符串长度限制：最小长度为 40。最大长度为 100。 ** [InvokeMode](#API_CreateFunctionUrlConfig_ResponseSyntax) ** 使用以下选项之一： + `BUFFERED` – 这是默认选项。Lambda 通过 `Invoke` API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。 + `RESPONSE_STREAM` – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 `InvokeWithResponseStream` API 操作调用函数。最大响应负载大小为 20MB，但是，您可以[请求提高限额](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。类型：字符串有效值：`BUFFERED | RESPONSE_STREAM` ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateFunctionUrlConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateFunctionUrlConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunctionUrlConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunctionUrlConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunctionUrlConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunctionUrlConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunctionUrlConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunctionUrlConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunctionUrlConfig) # DeleteAlias 删除 Lambda 函数[别名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) ## 请求语法 ``` DELETE /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_DeleteAlias_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Name](#API_DeleteAlias_RequestSyntax) ** 别名的名称。长度限制：最小长度为 1。长度上限为 128。模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteAlias) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteAlias) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteAlias) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteAlias) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteAlias) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteAlias) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteAlias) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteAlias) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteAlias) # DeleteCodeSigningConfig 删除代码签名配置。只有在任何函数都未使用代码签名配置的情况下，才能删除该配置。 ## 请求语法 ``` DELETE /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [CodeSigningConfigArn](#API_DeleteCodeSigningConfig_RequestSyntax) ** 代码签名配置的 Amazon Resource Name (ARN)。长度约束：最大长度为 200。模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteCodeSigningConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteCodeSigningConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteCodeSigningConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteCodeSigningConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteCodeSigningConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteCodeSigningConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteCodeSigningConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteCodeSigningConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteCodeSigningConfig) # DeleteEventSourceMapping 删除[事件源映射](https://docs.aws.amazon.com/lambda/latest/dg/intro-invocation-modes.html)。您可以从 [ListEventSourceMappings](API_ListEventSourceMappings.md) 的输出中获取映射的标识符。删除事件源映射时，它会输入 `Deleting` 状态，并且可能不会在几秒钟内完全删除。 ## 请求语法 ``` DELETE /2015-03-31/event-source-mappings/UUID HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [UUID](#API_DeleteEventSourceMapping_RequestSyntax) ** 事件源映射的标识符。必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 202 Content-type: application/json { "AmazonManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionArn": "string", "FunctionResponseTypes": [ "string" ], "LastModified": number, "LastProcessingResult": "string", "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "Queues": [ "string" ], "ScalingConfig": { "MaximumConcurrency": number }, "SelfManagedEventSource": { "Endpoints": { "string" : [ "string" ] } }, "SelfManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "StartingPosition": "string", "StartingPositionTimestamp": number, "State": "string", "StateTransitionReason": "string", "Topics": [ "string" ], "TumblingWindowInSeconds": number, "UUID": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 202 响应。服务以 JSON 格式返回以下数据。 ** [AmazonManagedKafkaEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件源的特定配置设置。类型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 对象 ** [BatchSize](#API_DeleteEventSourceMapping_ResponseSyntax) ** Lambda 从流或队列中提取并发送到函数的每个批处理中的最大记录数。Lambda 在单次调用中将批处理中的所有记录传递给函数，最高可传递同步调用的负载上限 (6 MB)。默认值：因服务而异。对于 Amazon SQS，默认值为 10。对于所有其他服务，默认值为 100。相关设置：当将 `BatchSize` 设置为一个大于 10 的值时，必须至少将 `MaximumBatchingWindowInSeconds` 设置为 1。类型：整数有效范围：最小值为 1。最大值为 10000。 ** [BisectBatchOnFunctionError](#API_DeleteEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）如果函数返回错误，则将分处理拆分为两个并重试。默认值为 False。类型：布尔值 ** [DestinationConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis、DynamoDB Streams、Amazon MSK 和自行管理的 Apache Kafka 事件源）用于在 Lambda 处理事件后指定事件目标的配置对象。类型：[DestinationConfig](API_DestinationConfig.md) 对象 ** [DocumentDBEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** DocumentB 事件源的特定配置设置。类型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 对象 ** [EventSourceArn](#API_DeleteEventSourceMapping_ResponseSyntax) ** 事件源的 Amazon Resource Name (ARN)。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [FilterCriteria](#API_DeleteEventSourceMapping_ResponseSyntax) ** 定义用于确定 Lambda 是否应处理事件的筛选条件的对象。有关更多信息，请参阅 [Lambda 事件筛选](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。类型：[FilterCriteria](API_FilterCriteria.md) 对象 ** [FunctionArn](#API_DeleteEventSourceMapping_ResponseSyntax) ** Lambda 函数的 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-_]+))?` ** [FunctionResponseTypes](#API_DeleteEventSourceMapping_ResponseSyntax) ** （Kinesis、DynamoDB Streams 和 Amazon SQS）应用于事件源映射的当前响应类型枚举的列表。类型：字符串数组数组成员：最少 0 项。最多 1 项。有效值：`ReportBatchItemFailures` ** [LastModified](#API_DeleteEventSourceMapping_ResponseSyntax) ** 上次更新事件源映射或其状态更改的日期（以 Unix 时间秒为单位）。类型：时间戳 ** [LastProcessingResult](#API_DeleteEventSourceMapping_ResponseSyntax) ** 函数的最后一次 Lambda 调用结果。类型：字符串 ** [MaximumBatchingWindowInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) ** Lambda 在调用函数之前收集记录的最长时间，以秒为单位。您可以将 `MaximumBatchingWindowInSeconds` 配置为介于 0 秒到 300 秒之间的任意值，以秒的整数倍调整。对于流和 Amazon SQS 事件源，默认批处理时段为 0 秒。对于 Amazon MSK、自行管理的 Apache Kafka、Amazon MQ 和 DocumentDB 事件源，默认批处理时间窗口为 500 毫秒。请注意，由于您只能以秒为增量更改 `MaximumBatchingWindowInSeconds`，所以在更改后无法恢复到 500 毫秒的默认批处理时段。要恢复原定设置的批处理时段，必须创建新的事件源映射。相关设置：对于流和 Amazon SQS 事件源，当将 `BatchSize` 设置为大于 10 的值时，必须将 `MaximumBatchingWindowInSeconds` 至少设置为 1。类型：整数有效范围：最小值为 0。最大值为 300。 ** [MaximumRecordAgeInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）丢弃超过指定龄期的记录。原定设置值为 -1，该值将最大年龄设置为无限。将该值设置为无限后，Lambda 永远不会删除旧记录。最长记录期限的最小有效值为 60 秒。尽管小于 60 和大于 -1 的值都在参数的绝对范围内，但不允许使用它们类型：整数有效范围：最小值为 -1。最大值为 604800。 ** [MaximumRetryAttempts](#API_DeleteEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）在指定重试次数后丢弃记录。原定设置值为 -1，该值将最大重试次数设置为无限。将 MaximumRetryAttempts 设置为无限后，Lambda 会重试失败的记录，直到事件源中的记录过期为止。类型：整数有效范围：最小值为 -1。最大值为 10000。 ** [ParallelizationFactor](#API_DeleteEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）每个分片中同时处理的批处理数。默认值是 1。类型：整数有效范围：最小值为 1。最大值为 10。 ** [Queues](#API_DeleteEventSourceMapping_ResponseSyntax) ** (Amazon MQ) 要使用的 Amazon MQ 代理目标队列的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。最大长度为 1000。模式：`[\s\S]*` ** [ScalingConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** （仅限 Amazon SQS）事件源的扩缩配置。有关更多信息，请参阅[为 Amazon SQS 事件源配置最大并发](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)。类型：[ScalingConfig](API_ScalingConfig.md) 对象 ** [SelfManagedEventSource](#API_DeleteEventSourceMapping_ResponseSyntax) ** 适用于事件源的自行管理 Apache Kafka 集群。类型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 对象 ** [SelfManagedKafkaEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** 自行管理的 Apache Kafka 事件源的特定配置设置。类型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 对象 ** [SourceAccessConfigurations](#API_DeleteEventSourceMapping_ResponseSyntax) ** 用于保护与定义事件源的身份验证协议数组 VPC 组件或虚拟化主机。类型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 对象数组数组成员：最少 0 项。最多 22 项。 ** [StartingPosition](#API_DeleteEventSourceMapping_ResponseSyntax) ** 在流中开始读取数据的位置。对于 Amazon Kinesis 和 Amazon DynamoDB Streams 事件源，为必需项。仅 Amazon Kinesis 流、Amazon DocumentDB、Amazon MSK 和自行管理的 Apache Kafka 支持 `AT_TIMESTAMP`。类型：字符串有效值：`TRIM_HORIZON | LATEST | AT_TIMESTAMP` ** [StartingPositionTimestamp](#API_DeleteEventSourceMapping_ResponseSyntax) ** 将 `StartingPosition` 设置为 `AT_TIMESTAMP` 时，即开始读取的时间（以 Unix 时间秒为单位）。`StartingPositionTimestamp` 不能是未来时间。类型：时间戳 ** [State](#API_DeleteEventSourceMapping_ResponseSyntax) ** 事件源映射的状态。此状态可以是以下值之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。类型：字符串 ** [StateTransitionReason](#API_DeleteEventSourceMapping_ResponseSyntax) ** 表明是用户还是 Lambda 对事件源映射进行了最后一次更改。类型：字符串 ** [Topics](#API_DeleteEventSourceMapping_ResponseSyntax) ** Kafka 主题的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。长度上限为 249。模式：`^[^.]([a-zA-Z0-9\-_.]+)` ** [TumblingWindowInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）DynamoDB 和 Kinesis Streams 事件源的处理时间窗口（以秒为单位）。值为 0 秒表示无滑动时间窗口。类型：整数有效范围：最小值为 0。最大值为 900。 ** [UUID](#API_DeleteEventSourceMapping_ResponseSyntax) ** 事件源映射的标识符。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceInUseException ** 该操作与资源的可用性冲突。例如，您试图在 CREATING 状态中更新事件源映射，或尝试删除当前处于 UPDATING 状态的事件源映射。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteEventSourceMapping) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteEventSourceMapping) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteEventSourceMapping) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteEventSourceMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteEventSourceMapping) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteEventSourceMapping) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteEventSourceMapping) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteEventSourceMapping) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteEventSourceMapping) # DeleteFunction 删除 Lambda 函数。要删除特定函数版本，请使用 `Qualifier` 参数。否则，将删除所有版本和别名。这并不要求用户具有 [DeleteAlias](API_DeleteAlias.md) 的显式权限。要删除调用函数的 Lambda 事件源映射，请使用 [DeleteEventSourceMapping](API_DeleteEventSourceMapping.md)。对于直接调用函数的 AWS 服务和资源，请在最初配置它的服务中删除触发器。 ## 请求语法 ``` DELETE /2015-03-31/functions/FunctionName?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_DeleteFunction_RequestSyntax) ** Lambda 函数的名称或版本。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:1`（包含版本）。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_DeleteFunction_RequestSyntax) ** 指定要删除的版本。您无法删除别名引用的版本。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunction) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunction) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunction) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunction) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunction) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunction) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunction) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunction) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunction) # DeleteFunctionCodeSigningConfig 从函数中删除代码签名配置。 ## 请求语法 ``` DELETE /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_DeleteFunctionCodeSigningConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** CodeSigningConfigNotFoundException ** 指定的代码签名配置不存在。 HTTP 状态代码：404 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) # DeleteFunctionConcurrency 从函数中删除并发执行限制。 ## 请求语法 ``` DELETE /2017-10-31/functions/FunctionName/concurrency HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_DeleteFunctionConcurrency_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunctionConcurrency) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunctionConcurrency) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionConcurrency) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunctionConcurrency) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionConcurrency) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionConcurrency) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionConcurrency) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionConcurrency) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionConcurrency) # DeleteFunctionEventInvokeConfig 删除函数、版本或别名的异步调用配置。要配置异步调用的选项，请使用 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)。 ## 请求语法 ``` DELETE /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_DeleteFunctionEventInvokeConfig_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** - `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_DeleteFunctionEventInvokeConfig_RequestSyntax) ** 版本号或别名。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) # DeleteFunctionUrlConfig 删除 Lambda 函数 URL。删除函数 URL 后，将无法恢复。创建一个新函数 URL 会导致不同的 URL 地址。 ## 请求语法 ``` DELETE /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_DeleteFunctionUrlConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_DeleteFunctionUrlConfig_RequestSyntax) ** 别名。长度限制：最小长度为 1。长度上限为 128。模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunctionUrlConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunctionUrlConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionUrlConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunctionUrlConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionUrlConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionUrlConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionUrlConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionUrlConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionUrlConfig) # DeleteLayerVersion 删除某个 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的某个版本。已删除的版本无法再查看或添加到函数中。为了避免中断函数，版本的副本将保留在 Lambda 中，直到没有函数引用它。 ## 请求语法 ``` DELETE /2018-10-31/layers/LayerName/versions/VersionNumber HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [LayerName](#API_DeleteLayerVersion_RequestSyntax) ** 层的名称或 Amazon Resource Name (ARN)。长度限制：最小长度为 1。长度上限为 140。模式：`(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+` 必需：是 ** [VersionNumber](#API_DeleteLayerVersion_RequestSyntax) ** 版本号。必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteLayerVersion) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteLayerVersion) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteLayerVersion) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteLayerVersion) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteLayerVersion) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteLayerVersion) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteLayerVersion) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteLayerVersion) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteLayerVersion) # DeleteProvisionedConcurrencyConfig 删除为函数预置的并发配置。 ## 请求语法 ``` DELETE /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_DeleteProvisionedConcurrencyConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_DeleteProvisionedConcurrencyConfig_RequestSyntax) ** 版本号或别名。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) # GetAccountSettings 检索有关您账户[限制](https://docs.aws.amazon.com/lambda/latest/dg/limits.html)和在AWS区域中用量的详细信息。 ## 请求语法 ``` GET /2016-08-19/account-settings/ HTTP/1.1 ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AccountLimit": { "CodeSizeUnzipped": number, "CodeSizeZipped": number, "ConcurrentExecutions": number, "TotalCodeSize": number, "UnreservedConcurrentExecutions": number }, "AccountUsage": { "FunctionCount": number, "TotalCodeSize": number } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AccountLimit](#API_GetAccountSettings_ResponseSyntax) ** 与并发和代码存储相关的限制。类型：[AccountLimit](API_AccountLimit.md) 对象 ** [AccountUsage](#API_GetAccountSettings_ResponseSyntax) ** 正在使用的函数数量和存储容量。类型：[AccountUsage](API_AccountUsage.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetAccountSettings) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetAccountSettings) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetAccountSettings) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetAccountSettings) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetAccountSettings) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetAccountSettings) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetAccountSettings) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetAccountSettings) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetAccountSettings) # GetAlias 返回有关 Lambda 函数[别名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)的详细信息。 ## 请求语法 ``` GET /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetAlias_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Name](#API_GetAlias_RequestSyntax) ** 别名的名称。长度限制：最小长度为 1。长度上限为 128。模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AliasArn": "string", "Description": "string", "FunctionVersion": "string", "Name": "string", "RevisionId": "string", "RoutingConfig": { "AdditionalVersionWeights": { "string" : number } } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AliasArn](#API_GetAlias_ResponseSyntax) ** 是别名的 Amazon Resource Name (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-_]+))?` ** [Description](#API_GetAlias_ResponseSyntax) ** 别名的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [FunctionVersion](#API_GetAlias_ResponseSyntax) ** 别名调用的函数版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [Name](#API_GetAlias_ResponseSyntax) ** 别名的名称。类型：字符串长度限制：长度下限为 1。长度上限为 128。模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)` ** [RevisionId](#API_GetAlias_ResponseSyntax) ** 更新别名时更改的唯一标识符。类型：字符串 ** [RoutingConfig](#API_GetAlias_ResponseSyntax) ** 别名的[路由配置](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html)。类型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetAlias) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetAlias) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetAlias) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetAlias) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetAlias) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetAlias) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetAlias) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetAlias) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetAlias) # GetCodeSigningConfig 返回有关指定代码签名配置的信息。 ## 请求语法 ``` GET /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [CodeSigningConfigArn](#API_GetCodeSigningConfig_RequestSyntax) ** 代码签名配置的 Amazon Resource Name (ARN)。长度约束：最大长度为 200。模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "CodeSigningConfig": { "AllowedPublishers": { "SigningProfileVersionArns": [ "string" ] }, "CodeSigningConfigArn": "string", "CodeSigningConfigId": "string", "CodeSigningPolicies": { "UntrustedArtifactOnDeployment": "string" }, "Description": "string", "LastModified": "string" } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [CodeSigningConfig](#API_GetCodeSigningConfig_ResponseSyntax) ** 代码签名配置类型：[CodeSigningConfig](API_CodeSigningConfig.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetCodeSigningConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetCodeSigningConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetCodeSigningConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetCodeSigningConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetCodeSigningConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetCodeSigningConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetCodeSigningConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetCodeSigningConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetCodeSigningConfig) # GetEventSourceMapping 返回有关事件源映射的详细信息。您可以从 [ListEventSourceMappings](API_ListEventSourceMappings.md) 的输出中获取映射的标识符。 ## 请求语法 ``` GET /2015-03-31/event-source-mappings/UUID HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [UUID](#API_GetEventSourceMapping_RequestSyntax) ** 事件源映射的标识符。必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AmazonManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionArn": "string", "FunctionResponseTypes": [ "string" ], "LastModified": number, "LastProcessingResult": "string", "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "Queues": [ "string" ], "ScalingConfig": { "MaximumConcurrency": number }, "SelfManagedEventSource": { "Endpoints": { "string" : [ "string" ] } }, "SelfManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "StartingPosition": "string", "StartingPositionTimestamp": number, "State": "string", "StateTransitionReason": "string", "Topics": [ "string" ], "TumblingWindowInSeconds": number, "UUID": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AmazonManagedKafkaEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) ** Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件源的特定配置设置。类型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 对象 ** [BatchSize](#API_GetEventSourceMapping_ResponseSyntax) ** Lambda 从流或队列中提取并发送到函数的每个批处理中的最大记录数。Lambda 在单次调用中将批处理中的所有记录传递给函数，最高可传递同步调用的负载上限 (6 MB)。默认值：因服务而异。对于 Amazon SQS，默认值为 10。对于所有其他服务，默认值为 100。相关设置：当将 `BatchSize` 设置为一个大于 10 的值时，必须至少将 `MaximumBatchingWindowInSeconds` 设置为 1。类型：整数有效范围：最小值为 1。最大值为 10000。 ** [BisectBatchOnFunctionError](#API_GetEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）如果函数返回错误，则将分处理拆分为两个并重试。默认值为 False。类型：布尔值 ** [DestinationConfig](#API_GetEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis、DynamoDB Streams、Amazon MSK 和自行管理的 Apache Kafka 事件源）用于在 Lambda 处理事件后指定事件目标的配置对象。类型：[DestinationConfig](API_DestinationConfig.md) 对象 ** [DocumentDBEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) ** DocumentB 事件源的特定配置设置。类型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 对象 ** [EventSourceArn](#API_GetEventSourceMapping_ResponseSyntax) ** 事件源的 Amazon Resource Name (ARN)。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [FilterCriteria](#API_GetEventSourceMapping_ResponseSyntax) ** 定义用于确定 Lambda 是否应处理事件的筛选条件的对象。有关更多信息，请参阅 [Lambda 事件筛选](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。类型：[FilterCriteria](API_FilterCriteria.md) 对象 ** [FunctionArn](#API_GetEventSourceMapping_ResponseSyntax) ** Lambda 函数的 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-_]+))?` ** [FunctionResponseTypes](#API_GetEventSourceMapping_ResponseSyntax) ** （Kinesis、DynamoDB Streams 和 Amazon SQS）应用于事件源映射的当前响应类型枚举的列表。类型：字符串数组数组成员：最少 0 项。最多 1 项。有效值：`ReportBatchItemFailures` ** [LastModified](#API_GetEventSourceMapping_ResponseSyntax) ** 上次更新事件源映射或其状态更改的日期（以 Unix 时间秒为单位）。类型：时间戳 ** [LastProcessingResult](#API_GetEventSourceMapping_ResponseSyntax) ** 函数的最后一次 Lambda 调用结果。类型：字符串 ** [MaximumBatchingWindowInSeconds](#API_GetEventSourceMapping_ResponseSyntax) ** Lambda 在调用函数之前收集记录的最长时间，以秒为单位。您可以将 `MaximumBatchingWindowInSeconds` 配置为介于 0 秒到 300 秒之间的任意值，以秒的整数倍调整。对于流和 Amazon SQS 事件源，默认批处理时段为 0 秒。对于 Amazon MSK、自行管理的 Apache Kafka、Amazon MQ 和 DocumentDB 事件源，默认批处理时间窗口为 500 毫秒。请注意，由于您只能以秒为增量更改 `MaximumBatchingWindowInSeconds`，所以在更改后无法恢复到 500 毫秒的默认批处理时段。要恢复原定设置的批处理时段，必须创建新的事件源映射。相关设置：对于流和 Amazon SQS 事件源，当将 `BatchSize` 设置为大于 10 的值时，必须将 `MaximumBatchingWindowInSeconds` 至少设置为 1。类型：整数有效范围：最小值为 0。最大值为 300。 ** [MaximumRecordAgeInSeconds](#API_GetEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）丢弃超过指定龄期的记录。原定设置值为 -1，该值将最大年龄设置为无限。将该值设置为无限后，Lambda 永远不会删除旧记录。最长记录期限的最小有效值为 60 秒。尽管小于 60 和大于 -1 的值都在参数的绝对范围内，但不允许使用它们类型：整数有效范围：最小值为 -1。最大值为 604800。 ** [MaximumRetryAttempts](#API_GetEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）在指定重试次数后丢弃记录。原定设置值为 -1，该值将最大重试次数设置为无限。将 MaximumRetryAttempts 设置为无限后，Lambda 会重试失败的记录，直到事件源中的记录过期为止。类型：整数有效范围：最小值为 -1。最大值为 10000。 ** [ParallelizationFactor](#API_GetEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）每个分片中同时处理的批处理数。默认值是 1。类型：整数有效范围：最小值为 1。最大值为 10。 ** [Queues](#API_GetEventSourceMapping_ResponseSyntax) ** (Amazon MQ) 要使用的 Amazon MQ 代理目标队列的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。最大长度为 1000。模式：`[\s\S]*` ** [ScalingConfig](#API_GetEventSourceMapping_ResponseSyntax) ** （仅限 Amazon SQS）事件源的扩缩配置。有关更多信息，请参阅[为 Amazon SQS 事件源配置最大并发](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)。类型：[ScalingConfig](API_ScalingConfig.md) 对象 ** [SelfManagedEventSource](#API_GetEventSourceMapping_ResponseSyntax) ** 适用于事件源的自行管理 Apache Kafka 集群。类型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 对象 ** [SelfManagedKafkaEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) ** 自行管理的 Apache Kafka 事件源的特定配置设置。类型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 对象 ** [SourceAccessConfigurations](#API_GetEventSourceMapping_ResponseSyntax) ** 用于保护与定义事件源的身份验证协议数组 VPC 组件或虚拟化主机。类型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 对象数组数组成员：最少 0 项。最多 22 项。 ** [StartingPosition](#API_GetEventSourceMapping_ResponseSyntax) ** 在流中开始读取数据的位置。对于 Amazon Kinesis 和 Amazon DynamoDB Streams 事件源，为必需项。仅 Amazon Kinesis 流、Amazon DocumentDB、Amazon MSK 和自行管理的 Apache Kafka 支持 `AT_TIMESTAMP`。类型：字符串有效值：`TRIM_HORIZON | LATEST | AT_TIMESTAMP` ** [StartingPositionTimestamp](#API_GetEventSourceMapping_ResponseSyntax) ** 将 `StartingPosition` 设置为 `AT_TIMESTAMP` 时，即开始读取的时间（以 Unix 时间秒为单位）。`StartingPositionTimestamp` 不能是未来时间。类型：时间戳 ** [State](#API_GetEventSourceMapping_ResponseSyntax) ** 事件源映射的状态。此状态可以是以下值之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。类型：字符串 ** [StateTransitionReason](#API_GetEventSourceMapping_ResponseSyntax) ** 表明是用户还是 Lambda 对事件源映射进行了最后一次更改。类型：字符串 ** [Topics](#API_GetEventSourceMapping_ResponseSyntax) ** Kafka 主题的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。长度上限为 249。模式：`^[^.]([a-zA-Z0-9\-_.]+)` ** [TumblingWindowInSeconds](#API_GetEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）DynamoDB 和 Kinesis Streams 事件源的处理时间窗口（以秒为单位）。值为 0 秒表示无滑动时间窗口。类型：整数有效范围：最小值为 0。最大值为 900。 ** [UUID](#API_GetEventSourceMapping_ResponseSyntax) ** 事件源映射的标识符。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetEventSourceMapping) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetEventSourceMapping) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetEventSourceMapping) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetEventSourceMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetEventSourceMapping) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetEventSourceMapping) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetEventSourceMapping) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetEventSourceMapping) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetEventSourceMapping) # GetFunction 返回有关函数或函数版本的信息，其中包含部署包下载链接，有效时间 10 分钟。如果指定函数版本，则仅返回特定于该版本的详细信息。 ## 请求语法 ``` GET /2015-03-31/functions/FunctionName?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetFunction_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 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-_]+))?` 必需：是 ** [Qualifier](#API_GetFunction_RequestSyntax) ** 指定版本或别名以获取有关函数发布版本的详细信息。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Code": { "ImageUri": "string", "Location": "string", "RepositoryType": "string", "ResolvedImageUri": "string" }, "Concurrency": { "ReservedConcurrentExecutions": number }, "Configuration": { "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" } }, "Tags": { "string" : "string" } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Code](#API_GetFunction_ResponseSyntax) ** 函数或版本的部署包。类型：[FunctionCodeLocation](API_FunctionCodeLocation.md) 对象 ** [Concurrency](#API_GetFunction_ResponseSyntax) ** 函数的[预留并发](https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html)。类型：[Concurrency](API_Concurrency.md) 对象 ** [Configuration](#API_GetFunction_ResponseSyntax) ** 函数或版本的配置。类型：[FunctionConfiguration](API_FunctionConfiguration.md) 对象 ** [Tags](#API_GetFunction_ResponseSyntax) ** 函数的[标签](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)。类型：字符串到字符串映射 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunction) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunction) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunction) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunction) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunction) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunction) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunction) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunction) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunction) # GetFunctionCodeSigningConfig 返回指定函数的代码签名配置。 ## 请求语法 ``` GET /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetFunctionCodeSigningConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "CodeSigningConfigArn": "string", "FunctionName": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [CodeSigningConfigArn](#API_GetFunctionCodeSigningConfig_ResponseSyntax) ** 代码签名配置的 Amazon Resource Name (ARN)。类型：字符串长度约束：最大长度为 200。模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` ** [FunctionName](#API_GetFunctionCodeSigningConfig_ResponseSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionCodeSigningConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionCodeSigningConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionCodeSigningConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionCodeSigningConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionCodeSigningConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) # GetFunctionConcurrency 返回有关函数的预留并发配置的详细信息。要为函数设置并发限制，请使用 [PutFunctionConcurrency](API_PutFunctionConcurrency.md)。 ## 请求语法 ``` GET /2019-09-30/functions/FunctionName/concurrency HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetFunctionConcurrency_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "ReservedConcurrentExecutions": number } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [ReservedConcurrentExecutions](#API_GetFunctionConcurrency_ResponseSyntax) ** 为函数预留的同时执行次数。类型：整数有效范围：最小值为 0。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionConcurrency) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionConcurrency) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionConcurrency) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionConcurrency) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionConcurrency) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionConcurrency) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionConcurrency) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionConcurrency) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionConcurrency) # GetFunctionConfiguration 返回 Lambda 函数或版本的版本特定设置。输出仅包含在函数版本之间可能有所不同的选项。要修改这些设置，请使用 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md)。要获取某个函数的所有详细信息，包括函数级别设置，请使用 [GetFunction](API_GetFunction.md)。 ## 请求语法 ``` GET /2015-03-31/functions/FunctionName/configuration?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetFunctionConfiguration_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 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-_]+))?` 必需：是 ** [Qualifier](#API_GetFunctionConfiguration_RequestSyntax) ** 指定版本或别名以获取有关函数发布版本的详细信息。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` 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](#API_GetFunctionConfiguration_ResponseSyntax) ** 该函数支持的指令集架构。架构是具有有效值之一的字符串数组。默认架构值是 `x86_64`。类型：字符串数组数组成员：固定数量为 1 项。有效值：`x86_64 | arm64` ** [CodeSha256](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数部署包的 SHA256 哈希。类型：字符串 ** [CodeSize](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数部署包的大小（以字节为单位）。类型：长整型 ** [DeadLetterConfig](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的死信队列。类型：[DeadLetterConfig](API_DeadLetterConfig.md) 对象 ** [Description](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数说明。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [Environment](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。在 AWS CloudTrail 日志中被忽略。类型：[EnvironmentResponse](API_EnvironmentResponse.md) 对象 ** [EphemeralStorage](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的 `/tmp` 目录大小（以 MB 为单位）。默认值为 512，但可以是介于 512 到 10240 MB 之间的任意整数。有关更多信息，请参阅[配置短暂存储（控制台）](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。类型：[EphemeralStorage](API_EphemeralStorage.md) 对象 ** [FileSystemConfigs](#API_GetFunctionConfiguration_ResponseSyntax) ** [Amazon EFS 文件系统](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的连接设置。类型：[FileSystemConfig](API_FileSystemConfig.md) 对象数组数组成员：最多 1 个物品。 ** [FunctionArn](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的 Amazon Resource Name (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](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的名称。类型：字符串长度限制：最小长度为 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](#API_GetFunctionConfiguration_ResponseSyntax) ** Lambda 为开始运行您的函数而调用的函数。类型：字符串长度限制：最大长度为 128。模式：`[^\s]+` ** [ImageConfigResponse](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的镜像配置值。类型：[ImageConfigResponse](API_ImageConfigResponse.md) 对象 ** [KMSKeyArn](#API_GetFunctionConfiguration_ResponseSyntax) ** 用于加密函数的[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)的 AWS KMS key。激活 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 时，此密钥还用于加密您的函数的快照。仅当您配置了客户托管密钥时，才会返回此密钥。类型：字符串模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` ** [LastModified](#API_GetFunctionConfiguration_ResponseSyntax) ** 该函数上次更新的日期和时间，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [LastUpdateStatus](#API_GetFunctionConfiguration_ResponseSyntax) ** 上次对函数执行的更新的状态。函数创建完成后，首先设置为 `Successful`。类型：字符串有效值：`Successful | Failed | InProgress` ** [LastUpdateStatusReason](#API_GetFunctionConfiguration_ResponseSyntax) ** 上次对函数执行更新的原因。类型：字符串 ** [LastUpdateStatusReasonCode](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数上次更新的原因代码。类型：字符串有效值：`EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Layers](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的[层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。类型：[Layer](API_Layer.md) 对象数组 ** [LoggingConfig](#API_GetFunctionConfiguration_ResponseSyntax) ** 该函数的 Amazon CloudWatch Logs 配置设置。类型：[LoggingConfig](API_LoggingConfig.md) 对象 ** [MasterArn](#API_GetFunctionConfiguration_ResponseSyntax) ** 对于 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](#API_GetFunctionConfiguration_ResponseSyntax) ** 在运行时可用于函数的内存量。类型：整数有效范围：最小值为 128。最大值为 10240。 ** [PackageType](#API_GetFunctionConfiguration_ResponseSyntax) ** 部署程序包的类型。将容器映像设置为 `Image`，然后将 .zip 文件存档设置为 `Zip`。类型：字符串有效值：`Zip | Image` ** [RevisionId](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数或别名的最新更新版本。类型：字符串 ** [Role](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的执行角色。类型：字符串模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` ** [Runtime](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的[运行时](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)的标识符。如果部署包是 .zip 文件归档，则需要使用运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [RuntimeVersionConfig](#API_GetFunctionConfiguration_ResponseSyntax) ** 运行时的 ARN 和发生的任何错误。类型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 对象 ** [SigningJobArn](#API_GetFunctionConfiguration_ResponseSyntax) ** 签名任务的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SigningProfileVersionArn](#API_GetFunctionConfiguration_ResponseSyntax) ** 签名配置文件版本的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SnapStart](#API_GetFunctionConfiguration_ResponseSyntax) ** 发布函数版本时，将 `ApplyOn` 设置为 `PublishedVersions` 以创建初始化执行环境的快照。有关更多信息，请参阅 [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)（使用 Lambda SnapStart 提高启动性能）。类型：[SnapStartResponse](API_SnapStartResponse.md) 对象 ** [State](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的当前状态。当状态为 `Inactive`，您可以通过调用函数来重新激活该函数。类型：字符串有效值：`Pending | Active | Inactive | Failed` ** [StateReason](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数当前状态的原因。类型：字符串 ** [StateReasonCode](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数当前状态的原因代码。当代码为 `Creating` 时，无法调用或修改该函数。类型：字符串有效值：`Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Timeout](#API_GetFunctionConfiguration_ResponseSyntax) ** Lambda 在停止函数前允许其运行的时长（以秒为单位）。类型：整数有效范围：最小值为 1。 ** [TracingConfig](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的 AWS X-Ray 跟踪配置。类型：[TracingConfigResponse](API_TracingConfigResponse.md) 对象 ** [Version](#API_GetFunctionConfiguration_ResponseSyntax) ** Lambda 函数的版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [VpcConfig](#API_GetFunctionConfiguration_ResponseSyntax) ** 函数的网络配置。类型：[VpcConfigResponse](API_VpcConfigResponse.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionConfiguration) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionConfiguration) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionConfiguration) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionConfiguration) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionConfiguration) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionConfiguration) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionConfiguration) # GetFunctionEventInvokeConfig 检索函数、版本或别名的异步调用配置。要配置异步调用的选项，请使用 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)。 ## 请求语法 ``` GET /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetFunctionEventInvokeConfig_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** - `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_GetFunctionEventInvokeConfig_RequestSyntax) ** 版本号或别名。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "FunctionArn": "string", "LastModified": number, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [DestinationConfig](#API_GetFunctionEventInvokeConfig_ResponseSyntax) ** 在事件发送到函数以进行处理后的目标。 **目标** + **Function** - Lambda 函数的 Amazon 资源名称（ARN）。 + **Queue** - 标准 SQS 队列的 ARN。 + **Topic** - 标准 SNS 主题的 ARN。 + **Event Bus** - Amazon EventBridge 事件总线的 ARN。类型：[DestinationConfig](API_DestinationConfig.md) 对象 ** [FunctionArn](#API_GetFunctionEventInvokeConfig_ResponseSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` ** [LastModified](#API_GetFunctionEventInvokeConfig_ResponseSyntax) ** 上次更新配置的日期和时间（以 Unix 时间秒为单位）。类型：时间戳 ** [MaximumEventAgeInSeconds](#API_GetFunctionEventInvokeConfig_ResponseSyntax) ** Lambda 发送到函数以进行处理的请求的最长期限。类型：整数有效范围：最小值为 60。最大值为 21600。 ** [MaximumRetryAttempts](#API_GetFunctionEventInvokeConfig_ResponseSyntax) ** 在函数返回错误时重试的最大次数。类型：整数有效范围：最小值为 0。最大值为 2。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionEventInvokeConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionEventInvokeConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionEventInvokeConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionEventInvokeConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionEventInvokeConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) # GetFunctionUrlConfig 返回有关 Lambda 函数 URL 的详细信息。 ## 请求语法 ``` GET /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetFunctionUrlConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_GetFunctionUrlConfig_RequestSyntax) ** 别名。长度限制：最小长度为 1。长度上限为 128。模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AuthType": "string", "Cors": { "AllowCredentials": boolean, "AllowHeaders": [ "string" ], "AllowMethods": [ "string" ], "AllowOrigins": [ "string" ], "ExposeHeaders": [ "string" ], "MaxAge": number }, "CreationTime": "string", "FunctionArn": "string", "FunctionUrl": "string", "InvokeMode": "string", "LastModifiedTime": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AuthType](#API_GetFunctionUrlConfig_ResponseSyntax) ** 函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 `AWS_IAM`。如果想绕过 IAM 身份验证以创建公有端点，请设置为 `NONE`。有关更多信息，请参阅 [Lambda 函数 URL 的安全性和身份验证模型](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html)。类型：字符串有效值：`NONE | AWS_IAM` ** [Cors](#API_GetFunctionUrlConfig_ResponseSyntax) ** 适用于函数 URL 的 [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)（跨源资源共享）设置。类型：[Cors](API_Cors.md) 对象 ** [CreationTime](#API_GetFunctionUrlConfig_ResponseSyntax) ** 创建函数 URL 时，使用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [FunctionArn](#API_GetFunctionUrlConfig_ResponseSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` ** [FunctionUrl](#API_GetFunctionUrlConfig_ResponseSyntax) ** 函数的 HTTP URL 端点。类型：字符串长度限制：最小长度为 40。最大长度为 100。 ** [InvokeMode](#API_GetFunctionUrlConfig_ResponseSyntax) ** 使用以下选项之一： + `BUFFERED` – 这是默认选项。Lambda 通过 `Invoke` API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。 + `RESPONSE_STREAM` – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 `InvokeWithResponseStream` API 操作调用函数。最大响应负载大小为 20MB，但是，您可以[请求提高限额](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。类型：字符串有效值：`BUFFERED | RESPONSE_STREAM` ** [LastModifiedTime](#API_GetFunctionUrlConfig_ResponseSyntax) ** 上次更新函数 URL 时，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionUrlConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionUrlConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionUrlConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionUrlConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionUrlConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionUrlConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionUrlConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionUrlConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionUrlConfig) # GetLayerVersion 返回有关某个 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的某个版本的信息，其中包含层归档的下载链接，有效时间 10 分钟。 ## 请求语法 ``` GET /2018-10-31/layers/LayerName/versions/VersionNumber HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [LayerName](#API_GetLayerVersion_RequestSyntax) ** 层的名称或 Amazon Resource Name (ARN)。长度限制：最小长度为 1。长度上限为 140。模式：`(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+` 必需：是 ** [VersionNumber](#API_GetLayerVersion_RequestSyntax) ** 版本号。必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "CompatibleArchitectures": [ "string" ], "CompatibleRuntimes": [ "string" ], "Content": { "CodeSha256": "string", "CodeSize": number, "Location": "string", "SigningJobArn": "string", "SigningProfileVersionArn": "string" }, "CreatedDate": "string", "Description": "string", "LayerArn": "string", "LayerVersionArn": "string", "LicenseInfo": "string", "Version": number } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [CompatibleArchitectures](#API_GetLayerVersion_ResponseSyntax) ** 兼容[指令集架构](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)列表。类型：字符串数组数组成员：最多 15 项。有效值：`x86_64 | arm64` ** [CompatibleRuntimes](#API_GetLayerVersion_ResponseSyntax) ** 层的兼容运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串数组数组成员：最多 15 项。有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [Content](#API_GetLayerVersion_ResponseSyntax) ** 有关层版本的详细信息。类型：[LayerVersionContentOutput](API_LayerVersionContentOutput.md) 对象 ** [CreatedDate](#API_GetLayerVersion_ResponseSyntax) ** 层版本的创建日期，为 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [Description](#API_GetLayerVersion_ResponseSyntax) ** 关于版本的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [LayerArn](#API_GetLayerVersion_ResponseSyntax) ** 层的 ARN。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+` ** [LayerVersionArn](#API_GetLayerVersion_ResponseSyntax) ** 层版本的 ARN。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` ** [LicenseInfo](#API_GetLayerVersion_ResponseSyntax) ** 层的软件许可证。类型：字符串长度约束：最大长度为 512。 ** [Version](#API_GetLayerVersion_ResponseSyntax) ** 版本号。类型：长整型 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetLayerVersion) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetLayerVersion) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersion) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetLayerVersion) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersion) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersion) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersion) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersion) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersion) # GetLayerVersionByArn 返回有关某个 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的某个版本的信息，其中包含层归档的下载链接，有效时间 10 分钟。 ## 请求语法 ``` GET /2018-10-31/layers?find=LayerVersion&Arn=Arn HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [Arn](#API_GetLayerVersionByArn_RequestSyntax) ** 层版本的 ARN。长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "CompatibleArchitectures": [ "string" ], "CompatibleRuntimes": [ "string" ], "Content": { "CodeSha256": "string", "CodeSize": number, "Location": "string", "SigningJobArn": "string", "SigningProfileVersionArn": "string" }, "CreatedDate": "string", "Description": "string", "LayerArn": "string", "LayerVersionArn": "string", "LicenseInfo": "string", "Version": number } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [CompatibleArchitectures](#API_GetLayerVersionByArn_ResponseSyntax) ** 兼容[指令集架构](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)列表。类型：字符串数组数组成员：最多 15 项。有效值：`x86_64 | arm64` ** [CompatibleRuntimes](#API_GetLayerVersionByArn_ResponseSyntax) ** 层的兼容运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串数组数组成员：最多 15 项。有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [Content](#API_GetLayerVersionByArn_ResponseSyntax) ** 有关层版本的详细信息。类型：[LayerVersionContentOutput](API_LayerVersionContentOutput.md) 对象 ** [CreatedDate](#API_GetLayerVersionByArn_ResponseSyntax) ** 层版本的创建日期，为 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [Description](#API_GetLayerVersionByArn_ResponseSyntax) ** 关于版本的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [LayerArn](#API_GetLayerVersionByArn_ResponseSyntax) ** 层的 ARN。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+` ** [LayerVersionArn](#API_GetLayerVersionByArn_ResponseSyntax) ** 层版本的 ARN。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` ** [LicenseInfo](#API_GetLayerVersionByArn_ResponseSyntax) ** 层的软件许可证。类型：字符串长度约束：最大长度为 512。 ** [Version](#API_GetLayerVersionByArn_ResponseSyntax) ** 版本号。类型：长整型 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetLayerVersionByArn) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetLayerVersionByArn) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersionByArn) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetLayerVersionByArn) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersionByArn) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersionByArn) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersionByArn) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersionByArn) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersionByArn) # GetLayerVersionPolicy 返回某个 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的某个版本的权限策略。有关更多信息，请参阅[AddLayerVersionPermission](API_AddLayerVersionPermission.md)。 ## 请求语法 ``` GET /2018-10-31/layers/LayerName/versions/VersionNumber/policy HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [LayerName](#API_GetLayerVersionPolicy_RequestSyntax) ** 层的名称或 Amazon Resource Name (ARN)。长度限制：最小长度为 1。长度上限为 140。模式：`(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+` 必需：是 ** [VersionNumber](#API_GetLayerVersionPolicy_RequestSyntax) ** 版本号。必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Policy": "string", "RevisionId": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Policy](#API_GetLayerVersionPolicy_ResponseSyntax) ** 策略文档。类型：字符串 ** [RevisionId](#API_GetLayerVersionPolicy_ResponseSyntax) ** 策略当前修订版的唯一标识符。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetLayerVersionPolicy) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetLayerVersionPolicy) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersionPolicy) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetLayerVersionPolicy) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersionPolicy) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersionPolicy) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersionPolicy) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersionPolicy) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersionPolicy) # GetPolicy 返回函数、版本或别名的[基于资源的 IAM policy](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html)。 ## 请求语法 ``` GET /2015-03-31/functions/FunctionName/policy?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetPolicy_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 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-_]+))?` 必需：是 ** [Qualifier](#API_GetPolicy_RequestSyntax) ** 指定版本或别名以获取该资源的策略。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Policy": "string", "RevisionId": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Policy](#API_GetPolicy_ResponseSyntax) ** 基于资源的策略。类型：字符串 ** [RevisionId](#API_GetPolicy_ResponseSyntax) ** 策略当前修订版的唯一标识符。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetPolicy) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetPolicy) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetPolicy) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetPolicy) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetPolicy) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetPolicy) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetPolicy) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetPolicy) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetPolicy) # GetProvisionedConcurrencyConfig 检索函数的别名或版本的预置并发配置。 ## 请求语法 ``` GET /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetProvisionedConcurrencyConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_GetProvisionedConcurrencyConfig_RequestSyntax) ** 版本号或别名。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AllocatedProvisionedConcurrentExecutions": number, "AvailableProvisionedConcurrentExecutions": number, "LastModified": "string", "RequestedProvisionedConcurrentExecutions": number, "Status": "string", "StatusReason": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AllocatedProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) ** 输入要分配的预置并发数量。在线性部署和金丝雀部署期间使用加权别名时，该值会根据为函数版本预配置的并发量而波动。类型：整数有效范围：最小值为 0。 ** [AvailableProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) ** 可用的预置并发数量。类型：整数有效范围：最小值为 0。 ** [LastModified](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) ** 用户上次更新配置的日期和时间，格式为 [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。类型：字符串 ** [RequestedProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) ** 请求的预置并发数量。类型：整数有效范围：最小值为 1。 ** [Status](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) ** 分配过程的状态。类型：字符串有效值：`IN_PROGRESS | READY | FAILED` ** [StatusReason](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) ** 分配失败的原因，即无法分配预置并发的原因。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ProvisionedConcurrencyConfigNotFoundException ** 指定的配置不存在。 HTTP 状态代码：404 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetProvisionedConcurrencyConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetProvisionedConcurrencyConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetProvisionedConcurrencyConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetProvisionedConcurrencyConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) # GetRuntimeManagementConfig 检索函数版本的运行时管理配置。如果运行时更新模式为**手动**，则将包括运行时版本的 ARN 和运行时更新模式。如果运行时更新模式为**自动**或**函数更新**，则将包括运行时更新模式，并且会为 ARN 返回 `null`。有关更多信息，请参阅 [Runtime updates](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html)（运行时更新）。 ## 请求语法 ``` GET /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_GetRuntimeManagementConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 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-_]+))?` 必需：是 ** [Qualifier](#API_GetRuntimeManagementConfig_RequestSyntax) ** 指定该函数的版本。可以是 `$LATEST` 或已发布的版本号。如果未指定任何值，则将返回 `$LATEST` 版本的配置。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "FunctionArn": "string", "RuntimeVersionArn": "string", "UpdateRuntimeOn": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [FunctionArn](#API_GetRuntimeManagementConfig_ResponseSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` ** [RuntimeVersionArn](#API_GetRuntimeManagementConfig_ResponseSyntax) ** 配置函数所使用的运行时的 ARN。如果运行时更新模式为**手动**，则将返回 ARN，否则将返回 `null`。类型：字符串长度限制：最小长度为 26。最大长度为 2048。模式：`^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$` ** [UpdateRuntimeOn](#API_GetRuntimeManagementConfig_ResponseSyntax) ** 函数的当前运行时更新模式。类型：字符串有效值：`Auto | Manual | FunctionUpdate` ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetRuntimeManagementConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetRuntimeManagementConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetRuntimeManagementConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetRuntimeManagementConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetRuntimeManagementConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetRuntimeManagementConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetRuntimeManagementConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetRuntimeManagementConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetRuntimeManagementConfig) # Invoke 调用 Lambda 函数。您可以同步调用函数（并等待响应），也可以异步调用函数。默认情况下，Lambda 会同步调用函数（即 `InvocationType` 是 `RequestResponse`）。要异步调用函数，请将 `InvocationType` 设置为 `Event`。Lambda 将 `ClientContext` 对象传递给函数（仅限同步调用）。对于[同步调用](https://docs.aws.amazon.com/lambda/latest/dg/invocation-sync.html)，有关函数响应的详细信息（包括错误）包含在响应正文和标题中。对于任一调用类型，您可以在[执行日志](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-functions.html)和[跟踪](https://docs.aws.amazon.com/lambda/latest/dg/lambda-x-ray.html)中找到更多信息。当发生错误时，您的函数可能会被多次调用。重试行为因错误类型、客户端、事件源和调用类型而异。例如，如果您异步调用函数并返回错误，则 Lambda 最多再执行两次该函数。有关更多信息，请参阅 [Lambda 中的错误处理和自动重试](https://docs.aws.amazon.com/lambda/latest/dg/invocation-retries.html)。对于[异步调用](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html)，Lambda 会将事件添加到队列，然后将它们发送到函数。如果您的函数没有足够的容量来跟上队列，事件可能会丢失。有时，您的函数可能会多次收到相同的事件，即使没有发生错误。要保留未处理的事件，请使用[死信队列](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq)配置函数。 API 响应中的状态代码不反映函数错误。错误代码是为阻止函数执行的错误而预留的，例如权限错误、[限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)错误或与函数的代码和配置有关的问题。例如，如果运行该函数会导致您超出账户级别（`ConcurrentInvocationLimitExceeded`）或函数级别（`ReservedFunctionConcurrentInvocationLimitExceeded`）的并发限制，则 Lambda 将返回 `TooManyRequestsException`。对于超时很长的函数，在等待响应的同步调用期间，客户端可能会断开连接。配置您的 HTTP 客户端、软件开发工具包、防火墙、代理或操作系统，以允许针对超时或保持活动设置保持长时间的连接。此操作需要 [lambda:InvokeFunction](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awslambda.html) 操作的权限。有关如何设置跨账户调用权限的详细信息，请参阅[向其他账户授予函数访问权](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html#permissions-resource-xaccountinvoke)。 ## 请求语法 ``` POST /2015-03-31/functions/FunctionName/invocations?Qualifier=Qualifier HTTP/1.1 X-Amz-Invocation-Type: InvocationType X-Amz-Log-Type: LogType X-Amz-Client-Context: ClientContext Payload ``` ## URI 请求参数请求使用以下 URI 参数。 ** [ClientContext](#API_Invoke_RequestSyntax) ** 有关要传递给上下文对象中的函数的调用客户端的 base64 编码数据，最多为 3,583 字节。Lambda 将 `ClientContext` 对象传递给函数（仅限同步调用）。 ** [FunctionName](#API_Invoke_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 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-_]+))?` 必需：是 ** [InvocationType](#API_Invoke_RequestSyntax) ** 从以下选项中进行选择。 + `RequestResponse`（默认）– 同步调用函数。保持连接打开，直到函数返回响应或超时。API 响应包括函数响应和其他数据。 + `Event` – 异步调用函数。将多次失败的事件发送到函数的死信队列（如果已配置）。API 响应仅包含状态代码。 + `DryRun` – 验证参数值并验证用户或角色是否具有调用函数的权限。有效值：`Event | RequestResponse | DryRun` ** [LogType](#API_Invoke_RequestSyntax) ** 设置 `Tail` 以在响应中包含执行日志。仅适用于同步调用的函数。有效值：`None | Tail` ** [Qualifier](#API_Invoke_RequestSyntax) ** 指定版本或别名以调用函数的已发布版本。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文请求接受以下二进制数据。 ** [Payload](#API_Invoke_RequestSyntax) ** 您想要作为输入提供到您的 Lambda 函数的 JSON。您可以直接输入 JSON。例如，`--payload '{ "key": "value" }'`。此外，您还可以指定文件路径。例如，`--payload file://payload.json`。 ## 响应语法 ``` HTTP/1.1 StatusCode X-Amz-Function-Error: FunctionError X-Amz-Log-Result: LogResult X-Amz-Executed-Version: ExecutedVersion Payload ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 响应。 ** [StatusCode](#API_Invoke_ResponseSyntax) ** 对于成功请求，HTTP 状态代码在 200 范围内。对于 `RequestResponse` 调用类型，状态代码为 200。对于 `Event` 调用类型，状态代码为 202。对于 `DryRun` 调用类型，状态代码为 204。响应将返回以下 HTTP 标头。 ** [ExecutedVersion](#API_Invoke_ResponseSyntax) ** 执行的函数的版本。当您调用带有别名的函数时，这将指示别名解析为哪个版本。长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [FunctionError](#API_Invoke_ResponseSyntax) ** 如果存在，则表示函数执行过程中发生错误。响应负载中包含有关错误的详细信息。 ** [LogResult](#API_Invoke_ResponseSyntax) ** Base64 编码执行日志的最后 4 KB。响应将以下内容作为 HTTP 正文返回。 ** [Payload](#API_Invoke_ResponseSyntax) ** 来自函数或错误对象的响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** EC2AccessDeniedException ** 需要额外的权限才能配置 VPC 设置。 HTTP 状态代码：502 ** EC2ThrottledException ** AWS Lambda 是由 Amazon EC2 在 Lambda 函数初始化期间使用为函数提供的执行角色进行节流的。 HTTP 状态代码：502 ** EC2UnexpectedException ** AWS Lambda 在设置 Lambda 函数时收到意外的 Amazon EC2 客户端异常。 HTTP 状态代码：502 ** EFSIOException ** 从连接的文件系统读取或向其中写入时发生了错误。 HTTP 状态代码：410 ** EFSMountConnectivityException ** Lambda 函数无法与配置的文件系统建立网络连接。 HTTP 状态代码：408 ** EFSMountFailureException ** 由于权限或配置问题，Lambda 函数无法挂载配置的文件系统。 HTTP 状态代码：403 ** EFSMountTimeoutException ** Lambda 函数能够连接到配置的文件系统，但挂载操作超时。 HTTP 状态代码：408 ** ENILimitReachedException ** AWS Lambda 无法在 VPC 中创建指定为 Lambda 函数配置一部分的弹性网络接口，因为已达到网络接口限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 状态代码：502 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** InvalidRequestContentException ** 请求正文无法解析为 JSON。 HTTP 状态代码：400 ** InvalidRuntimeException ** 运行时或运行时版本不受支持。 HTTP 状态代码：502 ** InvalidSecurityGroupIDException ** Lambda 函数 VPC 配置中提供的安全组 ID 无效。 HTTP 状态代码：502 ** InvalidSubnetIDException ** Lambda 函数 VPC 配置中提供的子网 ID 无效。 HTTP 状态代码：502 ** InvalidZipFileException ** AWS Lambda 无法解压缩部署程序包。 HTTP 状态代码：502 ** KMSAccessDeniedException ** Lambda 无法解密环境变量，因为对 AWS KMS 的访问已被拒绝。检查 Lambda 函数的 KMS 权限。 HTTP 状态代码：502 ** KMSDisabledException ** Lambda 无法解密环境变量，因为使用的 AWS KMS key 已被禁用。检查 Lambda 函数的 KMS 密钥设置。 HTTP 状态代码：502 ** KMSInvalidStateException ** Lambda 无法解密环境变量，因为所使用的 AWS KMS key 的状态对解密无效。检查函数的 KMS 密钥设置。 HTTP 状态代码：502 ** KMSNotFoundException ** Lambda 无法解密环境变量，因为找不到 AWS KMS key。检查函数的 KMS 密钥设置。 HTTP 状态代码：502 ** RecursiveInvocationException ** Lambda 检测到您的函数在涉及其他 AWS 资源的递归循环中被调用，因而停止了调用您的函数。 HTTP 状态代码：400 ** RequestTooLargeException ** 请求负载已超出 `Invoke` 请求正文 JSON 输入限额。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 状态代码：413 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ResourceNotReadyException ** 函数处于非活动状态，其 VPC 连接不再可用。等待 VPC 连接重新建立，然后重试。 HTTP 状态代码：502 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** SnapStartException ** `afterRestore()` [运行时挂钩](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-runtime-hooks.html)遇到错误。有关更多信息，请查看 Amazon CloudWatch 日志。 HTTP 状态代码：400 ** SnapStartNotReadyException ** Lambda 正在初始化函数。您可以在[函数状态](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html)变为 `Active` 时调用该函数。 HTTP 状态代码：409 ** SnapStartTimeoutException ** Lambda 无法在超时限制内还原快照。 HTTP 状态代码：408 ** SubnetIPAddressLimitReachedException ** 由于配置的一个或多个子网没有可用的 IP 地址，因此 AWS Lambda 无法为 Lambda 函数设置 VPC 访问。 HTTP 状态代码：502 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ** UnsupportedMediaTypeException ** `Invoke` 的内容类型请求体不是 JSON。 HTTP 状态代码：415 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/Invoke) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/Invoke) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/Invoke) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/Invoke) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/Invoke) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/Invoke) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/Invoke) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/Invoke) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/Invoke) # InvokeAsync *此操作已弃用。* **重要** 对于异步函数调用，请使用 [Invoke](API_Invoke.md)。异步调用函数。 **注意** 如果您确实使用了 InvokeAsync 操作，请注意它不支持使用 X-Ray 活动跟踪。即使开启了 X-Ray 活动追踪，也不会将跟踪 ID 传播到该函数。 ## 请求语法 ``` POST /2014-11-13/functions/FunctionName/invoke-async/ HTTP/1.1 InvokeArgs ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_InvokeAsync_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 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-_]+))?` 必需：是 ## 请求正文请求接受以下二进制数据。 ** [InvokeArgs](#API_InvokeAsync_RequestSyntax) ** 您想要作为输入提供到您的 Lambda 函数的 JSON。必需：是 ## 响应语法 ``` HTTP/1.1 Status ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 响应。 ** [Status](#API_InvokeAsync_ResponseSyntax) ** 状态代码。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidRequestContentException ** 请求正文无法解析为 JSON。 HTTP 状态代码：400 ** InvalidRuntimeException ** 运行时或运行时版本不受支持。 HTTP 状态代码：502 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/InvokeAsync) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/InvokeAsync) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/InvokeAsync) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/InvokeAsync) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/InvokeAsync) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/InvokeAsync) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/InvokeAsync) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/InvokeAsync) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/InvokeAsync) # InvokeWithResponseStream 配置 Lambda 函数以将响应负载流式传输回客户端。有关更多信息，请参阅[配置 Lambda 函数以流式处理响应](https://docs.aws.amazon.com/lambda/latest/dg/configuration-response-streaming.html)。此操作需要 [lambda:InvokeFunction](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awslambda.html) 操作的权限。有关如何设置跨账户调用权限的详细信息，请参阅[向其他账户授予函数访问权](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html#permissions-resource-xaccountinvoke)。 ## 请求语法 ``` POST /2021-11-15/functions/FunctionName/response-streaming-invocations?Qualifier=Qualifier HTTP/1.1 X-Amz-Invocation-Type: InvocationType X-Amz-Log-Type: LogType X-Amz-Client-Context: ClientContext Payload ``` ## URI 请求参数请求使用以下 URI 参数。 ** [ClientContext](#API_InvokeWithResponseStream_RequestSyntax) ** 有关要传递给上下文对象中的函数的调用客户端的 base64 编码数据，最多为 3,583 字节。 ** [FunctionName](#API_InvokeWithResponseStream_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 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-_]+))?` 必需：是 ** [InvocationType](#API_InvokeWithResponseStream_RequestSyntax) ** 使用以下选项之一： + `RequestResponse`（默认）– 同步调用函数。保持连接打开，直到函数返回响应或超时。API 操作响应包括函数响应和其他数据。 + `DryRun` – 验证参数值并验证 IAM 用户或角色是否具有调用函数的权限。有效值：`RequestResponse | DryRun` ** [LogType](#API_InvokeWithResponseStream_RequestSyntax) ** 设置 `Tail` 以在响应中包含执行日志。仅适用于同步调用的函数。有效值：`None | Tail` ** [Qualifier](#API_InvokeWithResponseStream_RequestSyntax) ** 别名。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文请求接受以下二进制数据。 ** [Payload](#API_InvokeWithResponseStream_RequestSyntax) ** 您想要作为输入提供到您的 Lambda 函数的 JSON。您可以直接输入 JSON。例如，`--payload '{ "key": "value" }'`。此外，您还可以指定文件路径。例如，`--payload file://payload.json`。 ## 响应语法 ``` HTTP/1.1 StatusCode X-Amz-Executed-Version: ExecutedVersion Content-Type: ResponseStreamContentType Content-type: application/json { "InvokeComplete": { "ErrorCode": "string", "ErrorDetails": "string", "LogResult": "string" }, "PayloadChunk": { "Payload": blob } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 响应。 ** [StatusCode](#API_InvokeWithResponseStream_ResponseSyntax) ** 对于成功请求，HTTP 状态代码在 200 范围内。对于 `RequestResponse` 调用类型，状态代码为 200。对于 `DryRun` 调用类型，状态代码为 204。响应将返回以下 HTTP 标头。 ** [ExecutedVersion](#API_InvokeWithResponseStream_ResponseSyntax) ** 执行的函数的版本。当您调用带有别名的函数时，这将指示别名解析为哪个版本。长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [ResponseStreamContentType](#API_InvokeWithResponseStream_ResponseSyntax) ** 流返回的数据类型。服务以 JSON 格式返回以下数据。 ** [InvokeComplete](#API_InvokeWithResponseStream_ResponseSyntax) ** 当流结束并且所有负载区块均已返回后所返回的对象。类型：[InvokeWithResponseStreamCompleteEvent](API_InvokeWithResponseStreamCompleteEvent.md) 对象 ** [PayloadChunk](#API_InvokeWithResponseStream_ResponseSyntax) ** 流式处理响应负载的区块。类型：[InvokeResponseStreamUpdate](API_InvokeResponseStreamUpdate.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** EC2AccessDeniedException ** 需要额外的权限才能配置 VPC 设置。 HTTP 状态代码：502 ** EC2ThrottledException ** AWS Lambda 是由 Amazon EC2 在 Lambda 函数初始化期间使用为函数提供的执行角色进行节流的。 HTTP 状态代码：502 ** EC2UnexpectedException ** AWS Lambda 在设置 Lambda 函数时收到意外的 Amazon EC2 客户端异常。 HTTP 状态代码：502 ** EFSIOException ** 从连接的文件系统读取或向其中写入时发生了错误。 HTTP 状态代码：410 ** EFSMountConnectivityException ** Lambda 函数无法与配置的文件系统建立网络连接。 HTTP 状态代码：408 ** EFSMountFailureException ** 由于权限或配置问题，Lambda 函数无法挂载配置的文件系统。 HTTP 状态代码：403 ** EFSMountTimeoutException ** Lambda 函数能够连接到配置的文件系统，但挂载操作超时。 HTTP 状态代码：408 ** ENILimitReachedException ** AWS Lambda 无法在 VPC 中创建指定为 Lambda 函数配置一部分的弹性网络接口，因为已达到网络接口限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 状态代码：502 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** InvalidRequestContentException ** 请求正文无法解析为 JSON。 HTTP 状态代码：400 ** InvalidRuntimeException ** 运行时或运行时版本不受支持。 HTTP 状态代码：502 ** InvalidSecurityGroupIDException ** Lambda 函数 VPC 配置中提供的安全组 ID 无效。 HTTP 状态代码：502 ** InvalidSubnetIDException ** Lambda 函数 VPC 配置中提供的子网 ID 无效。 HTTP 状态代码：502 ** InvalidZipFileException ** AWS Lambda 无法解压缩部署程序包。 HTTP 状态代码：502 ** KMSAccessDeniedException ** Lambda 无法解密环境变量，因为对 AWS KMS 的访问已被拒绝。检查 Lambda 函数的 KMS 权限。 HTTP 状态代码：502 ** KMSDisabledException ** Lambda 无法解密环境变量，因为使用的 AWS KMS key 已被禁用。检查 Lambda 函数的 KMS 密钥设置。 HTTP 状态代码：502 ** KMSInvalidStateException ** Lambda 无法解密环境变量，因为所使用的 AWS KMS key 的状态对解密无效。检查函数的 KMS 密钥设置。 HTTP 状态代码：502 ** KMSNotFoundException ** Lambda 无法解密环境变量，因为找不到 AWS KMS key。检查函数的 KMS 密钥设置。 HTTP 状态代码：502 ** RecursiveInvocationException ** Lambda 检测到您的函数在涉及其他 AWS 资源的递归循环中被调用，因而停止了调用您的函数。 HTTP 状态代码：400 ** RequestTooLargeException ** 请求负载已超出 `Invoke` 请求正文 JSON 输入限额。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 状态代码：413 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ResourceNotReadyException ** 函数处于非活动状态，其 VPC 连接不再可用。等待 VPC 连接重新建立，然后重试。 HTTP 状态代码：502 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** SnapStartException ** `afterRestore()` [运行时挂钩](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-runtime-hooks.html)遇到错误。有关更多信息，请查看 Amazon CloudWatch 日志。 HTTP 状态代码：400 ** SnapStartNotReadyException ** Lambda 正在初始化函数。您可以在[函数状态](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html)变为 `Active` 时调用该函数。 HTTP 状态代码：409 ** SnapStartTimeoutException ** Lambda 无法在超时限制内还原快照。 HTTP 状态代码：408 ** SubnetIPAddressLimitReachedException ** 由于配置的一个或多个子网没有可用的 IP 地址，因此 AWS Lambda 无法为 Lambda 函数设置 VPC 访问。 HTTP 状态代码：502 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ** UnsupportedMediaTypeException ** `Invoke` 的内容类型请求体不是 JSON。 HTTP 状态代码：415 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/InvokeWithResponseStream) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/InvokeWithResponseStream) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/InvokeWithResponseStream) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/InvokeWithResponseStream) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/InvokeWithResponseStream) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/InvokeWithResponseStream) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/InvokeWithResponseStream) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/InvokeWithResponseStream) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/InvokeWithResponseStream) # ListAliases 返回为 Lambda 函数创建的[别名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)列表。 ## 请求语法 ``` GET /2015-03-31/functions/FunctionName/aliases?FunctionVersion=FunctionVersion&Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_ListAliases_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [FunctionVersion](#API_ListAliases_RequestSyntax) ** 指定函数版本以仅列出调用该版本的别名。长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [Marker](#API_ListAliases_RequestSyntax) ** 指定上次请求返回的分页令牌以检索下一页结果。 ** [MaxItems](#API_ListAliases_RequestSyntax) ** 限制别名返回的数量。有效范围：最小值为 1。最大值为 10000。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Aliases": [ { "AliasArn": "string", "Description": "string", "FunctionVersion": "string", "Name": "string", "RevisionId": "string", "RoutingConfig": { "AdditionalVersionWeights": { "string" : number } } } ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Aliases](#API_ListAliases_ResponseSyntax) ** 别名列表。类型：[AliasConfiguration](API_AliasConfiguration.md) 对象数组 ** [NextMarker](#API_ListAliases_ResponseSyntax) ** 有更多结果可用时包含的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListAliases) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListAliases) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListAliases) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListAliases) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListAliases) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListAliases) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListAliases) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListAliases) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListAliases) # ListCodeSigningConfigs 返回[代码签名配置](https://docs.aws.amazon.com/lambda/latest/dg/configuring-codesigning.html)列表。每次调用最多返回 10000 个配置。您可以使用 `MaxItems` 参数以便在每次调用时返回较少的配置。 ## 请求语法 ``` GET /2020-04-22/code-signing-configs/?Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [Marker](#API_ListCodeSigningConfigs_RequestSyntax) ** 指定上次请求返回的分页令牌以检索下一页结果。 ** [MaxItems](#API_ListCodeSigningConfigs_RequestSyntax) ** 要返回的最大项目数量。有效范围：最小值为 1。最大值为 10000。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "CodeSigningConfigs": [ { "AllowedPublishers": { "SigningProfileVersionArns": [ "string" ] }, "CodeSigningConfigArn": "string", "CodeSigningConfigId": "string", "CodeSigningPolicies": { "UntrustedArtifactOnDeployment": "string" }, "Description": "string", "LastModified": "string" } ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [CodeSigningConfigs](#API_ListCodeSigningConfigs_ResponseSyntax) ** 代码签名配置类型：[CodeSigningConfig](API_CodeSigningConfig.md) 对象数组 ** [NextMarker](#API_ListCodeSigningConfigs_ResponseSyntax) ** 有更多结果可用时包含的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListCodeSigningConfigs) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListCodeSigningConfigs) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListCodeSigningConfigs) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListCodeSigningConfigs) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListCodeSigningConfigs) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListCodeSigningConfigs) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListCodeSigningConfigs) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListCodeSigningConfigs) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListCodeSigningConfigs) # ListEventSourceMappings 列出事件源映射。指定 `EventSourceArn` 以仅显示单个事件源的事件源映射。 ## 请求语法 ``` GET /2015-03-31/event-source-mappings/?EventSourceArn=EventSourceArn&FunctionName=FunctionName&Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [EventSourceArn](#API_ListEventSourceMappings_RequestSyntax) ** 事件源的 Amazon 资源名称（ARN）。 + **Amazon Kinesis** – 数据流或流使用者的 ARN。 + **Amazon DynamoDB Streams** – 流的 ARN。 + **Amazon Simple Queue Service** – 队列的 ARN。 + **Amazon Managed Streaming for Apache Kafka** – 集群的 ARN 或 VPC 连接的 ARN（用于[跨账户事件源映射](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#msk-multi-vpc)）。 + **Amazon MQ** – 代理的 ARN。 + **Amazon DocumentDB** – DocumentDB 更改流的 ARN。模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [FunctionName](#API_ListEventSourceMappings_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `MyFunction`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **版本或别名 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD`。 + **部分 ARN** – `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度将限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` ** [Marker](#API_ListEventSourceMappings_RequestSyntax) ** 由上一次调用返回的分页令牌。 ** [MaxItems](#API_ListEventSourceMappings_RequestSyntax) ** 要返回的事件源映射最大数量。请注意，即使您设置的数字较高，ListEventSourceMappings 在每个响应中最多返回 100 个项目。有效范围：最小值为 1。最大值为 10000。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "EventSourceMappings": [ { "AmazonManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionArn": "string", "FunctionResponseTypes": [ "string" ], "LastModified": number, "LastProcessingResult": "string", "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "Queues": [ "string" ], "ScalingConfig": { "MaximumConcurrency": number }, "SelfManagedEventSource": { "Endpoints": { "string" : [ "string" ] } }, "SelfManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "StartingPosition": "string", "StartingPositionTimestamp": number, "State": "string", "StateTransitionReason": "string", "Topics": [ "string" ], "TumblingWindowInSeconds": number, "UUID": "string" } ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [EventSourceMappings](#API_ListEventSourceMappings_ResponseSyntax) ** 事件源映射的列表。类型：[EventSourceMappingConfiguration](API_EventSourceMappingConfiguration.md) 对象数组 ** [NextMarker](#API_ListEventSourceMappings_ResponseSyntax) ** 当响应不包含所有事件源映射时返回的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListEventSourceMappings) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListEventSourceMappings) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListEventSourceMappings) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListEventSourceMappings) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListEventSourceMappings) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListEventSourceMappings) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListEventSourceMappings) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListEventSourceMappings) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListEventSourceMappings) # ListFunctionEventInvokeConfigs 检索函数异步调用的配置列表。要配置异步调用的选项，请使用 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)。 ## 请求语法 ``` GET /2019-09-25/functions/FunctionName/event-invoke-config/list?Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_ListFunctionEventInvokeConfigs_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `my-function`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** - `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Marker](#API_ListFunctionEventInvokeConfigs_RequestSyntax) ** 指定上次请求返回的分页令牌以检索下一页结果。 ** [MaxItems](#API_ListFunctionEventInvokeConfigs_RequestSyntax) ** 要返回的配置的最大数量。有效范围：最小值为 1。最大值为 50。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "FunctionEventInvokeConfigs": [ { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "FunctionArn": "string", "LastModified": number, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number } ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [FunctionEventInvokeConfigs](#API_ListFunctionEventInvokeConfigs_ResponseSyntax) ** 配置的列表。类型：[FunctionEventInvokeConfig](API_FunctionEventInvokeConfig.md) 对象数组 ** [NextMarker](#API_ListFunctionEventInvokeConfigs_ResponseSyntax) ** 有更多结果可用时包含的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListFunctionEventInvokeConfigs) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionEventInvokeConfigs) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListFunctionEventInvokeConfigs) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionEventInvokeConfigs) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) # ListFunctions 返回 Lambda 函数列表，以及每个函数的版本特定配置。Lambda 每次调用最多返回 50 个函数。将 `FunctionVersion` 设置为 `ALL`，以包括每个函数的所有已发布版本以及未发布的版本。 **注意** `ListFunctions` 操作将返回 [FunctionConfiguration](API_FunctionConfiguration.md) 字段的子集。要获取函数或版本的附加字段（State、StateReasonCode、StateReason、LastUpdateStatus、LastUpdateStatusReason、LastUpdateStatusReasonCode、RuntimeVersionConfig），请使用 [GetFunction](API_GetFunction.md)。 ## 请求语法 ``` GET /2015-03-31/functions/?FunctionVersion=FunctionVersion&Marker=Marker&MasterRegion=MasterRegion&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionVersion](#API_ListFunctions_RequestSyntax) ** 设置为 `ALL`，以包含每个函数的所有已发布版本的条目。有效值：`ALL` ** [Marker](#API_ListFunctions_RequestSyntax) ** 指定上次请求返回的分页令牌以检索下一页结果。 ** [MasterRegion](#API_ListFunctions_RequestSyntax) ** 对于 Lambda@Edge 函数，为主函数的 AWS 区域。例如，`us-east-1` 筛选函数列表，以仅包括从美国东部（弗吉尼亚州北部）的主函数复制的 Lambda@Edge 函数。如果已指定，则必须将 `FunctionVersion` 设置为 `ALL`。模式：`ALL|[a-z]{2}(-gov)?-[a-z]+-\d{1}` ** [MaxItems](#API_ListFunctions_RequestSyntax) ** 要在响应中返回的函数的最大数量。请注意，即使您设置的数字较高，`ListFunctions` 在每个响应中最多返回 50 个项目。有效范围：最小值为 1。最大值为 10000。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Functions": [ { "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" } } ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Functions](#API_ListFunctions_ResponseSyntax) ** Lambda 函数的列表。类型：[FunctionConfiguration](API_FunctionConfiguration.md) 对象数组 ** [NextMarker](#API_ListFunctions_ResponseSyntax) ** 有更多结果可用时包含的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListFunctions) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListFunctions) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctions) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListFunctions) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctions) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctions) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctions) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctions) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctions) # ListFunctionsByCodeSigningConfig 列出使用指定代码签名配置的函数。您可以在删除代码签名配置之前使用此方法，以验证没有函数正在使用该配置。 ## 请求语法 ``` GET /2020-04-22/code-signing-configs/CodeSigningConfigArn/functions?Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [CodeSigningConfigArn](#API_ListFunctionsByCodeSigningConfig_RequestSyntax) ** 代码签名配置的 Amazon Resource Name (ARN)。长度约束：最大长度为 200。模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` 必需：是 ** [Marker](#API_ListFunctionsByCodeSigningConfig_RequestSyntax) ** 指定上次请求返回的分页令牌以检索下一页结果。 ** [MaxItems](#API_ListFunctionsByCodeSigningConfig_RequestSyntax) ** 要返回的最大项目数量。有效范围：最小值为 1。最大值为 10000。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "FunctionArns": [ "string" ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [FunctionArns](#API_ListFunctionsByCodeSigningConfig_ResponseSyntax) ** 函数 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-_]+))?` ** [NextMarker](#API_ListFunctionsByCodeSigningConfig_ResponseSyntax) ** 有更多结果可用时包含的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) # ListFunctionUrlConfigs 返回指定函数的 Lambda 函数 URL 的列表。 ## 请求语法 ``` GET /2021-10-31/functions/FunctionName/urls?Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_ListFunctionUrlConfigs_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Marker](#API_ListFunctionUrlConfigs_RequestSyntax) ** 指定上次请求返回的分页令牌以检索下一页结果。 ** [MaxItems](#API_ListFunctionUrlConfigs_RequestSyntax) ** 要在响应中返回的函数 URL 的最大数量。请注意，即使您设置的数字较高，`ListFunctionUrlConfigs` 在每个响应中最多返回 50 个项目。有效范围：最小值为 1。最大值为 50。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "FunctionUrlConfigs": [ { "AuthType": "string", "Cors": { "AllowCredentials": boolean, "AllowHeaders": [ "string" ], "AllowMethods": [ "string" ], "AllowOrigins": [ "string" ], "ExposeHeaders": [ "string" ], "MaxAge": number }, "CreationTime": "string", "FunctionArn": "string", "FunctionUrl": "string", "InvokeMode": "string", "LastModifiedTime": "string" } ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [FunctionUrlConfigs](#API_ListFunctionUrlConfigs_ResponseSyntax) ** 函数 URL 配置的列表。类型：[FunctionUrlConfig](API_FunctionUrlConfig.md) 对象数组 ** [NextMarker](#API_ListFunctionUrlConfigs_ResponseSyntax) ** 有更多结果可用时包含的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListFunctionUrlConfigs) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListFunctionUrlConfigs) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionUrlConfigs) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListFunctionUrlConfigs) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionUrlConfigs) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionUrlConfigs) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionUrlConfigs) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionUrlConfigs) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionUrlConfigs) # ListLayers 列出 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/invocation-layers.html)并显示有关每个函数层的最新版本的信息。指定[运行时标识符](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)，以仅列出指示它们与该运行时兼容的层。指定兼容架构以仅包含与该[指令集架构](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)兼容的层。 ## 请求语法 ``` GET /2018-10-31/layers?CompatibleArchitecture=CompatibleArchitecture&CompatibleRuntime=CompatibleRuntime&Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [CompatibleArchitecture](#API_ListLayers_RequestSyntax) ** 兼容[指令集架构](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)。有效值：`x86_64 | arm64` ** [CompatibleRuntime](#API_ListLayers_RequestSyntax) ** 运行时标识符。例如，`java21`。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [Marker](#API_ListLayers_RequestSyntax) ** 由上一次调用返回的分页令牌。 ** [MaxItems](#API_ListLayers_RequestSyntax) ** 要返回的层最大数量。有效范围：最小值为 1。最大值为 50。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Layers": [ { "LatestMatchingVersion": { "CompatibleArchitectures": [ "string" ], "CompatibleRuntimes": [ "string" ], "CreatedDate": "string", "Description": "string", "LayerVersionArn": "string", "LicenseInfo": "string", "Version": number }, "LayerArn": "string", "LayerName": "string" } ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Layers](#API_ListLayers_ResponseSyntax) ** 函数层的列表。类型：[LayersListItem](API_LayersListItem.md) 对象数组 ** [NextMarker](#API_ListLayers_ResponseSyntax) ** 当响应不包含所有层时返回的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListLayers) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListLayers) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListLayers) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListLayers) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListLayers) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListLayers) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListLayers) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListLayers) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListLayers) # ListLayerVersions 列出某个 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的版本。未列出已删除的版本。指定[运行时标识符](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)，以仅列出指示它们与该运行时兼容的版本。指定兼容架构以仅包含与该架构兼容的层版本。 ## 请求语法 ``` GET /2018-10-31/layers/LayerName/versions?CompatibleArchitecture=CompatibleArchitecture&CompatibleRuntime=CompatibleRuntime&Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [CompatibleArchitecture](#API_ListLayerVersions_RequestSyntax) ** 兼容[指令集架构](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)。有效值：`x86_64 | arm64` ** [CompatibleRuntime](#API_ListLayerVersions_RequestSyntax) ** 运行时标识符。例如，`java21`。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [LayerName](#API_ListLayerVersions_RequestSyntax) ** 层的名称或 Amazon Resource Name (ARN)。长度限制：最小长度为 1。长度上限为 140。模式：`(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+` 必需：是 ** [Marker](#API_ListLayerVersions_RequestSyntax) ** 由上一次调用返回的分页令牌。 ** [MaxItems](#API_ListLayerVersions_RequestSyntax) ** 要返回的版本最大数量。有效范围：最小值为 1。最大值为 50。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "LayerVersions": [ { "CompatibleArchitectures": [ "string" ], "CompatibleRuntimes": [ "string" ], "CreatedDate": "string", "Description": "string", "LayerVersionArn": "string", "LicenseInfo": "string", "Version": number } ], "NextMarker": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [LayerVersions](#API_ListLayerVersions_ResponseSyntax) ** 版本列表。类型：[LayerVersionsListItem](API_LayerVersionsListItem.md) 对象数组 ** [NextMarker](#API_ListLayerVersions_ResponseSyntax) ** 当响应不包含所有版本时返回的分页令牌。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListLayerVersions) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListLayerVersions) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListLayerVersions) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListLayerVersions) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListLayerVersions) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListLayerVersions) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListLayerVersions) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListLayerVersions) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListLayerVersions) # ListProvisionedConcurrencyConfigs 检索函数的预置并发配置列表。 ## 请求语法 ``` GET /2019-09-30/functions/FunctionName/provisioned-concurrency?List=ALL&Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_ListProvisionedConcurrencyConfigs_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Marker](#API_ListProvisionedConcurrencyConfigs_RequestSyntax) ** 指定上次请求返回的分页令牌以检索下一页结果。 ** [MaxItems](#API_ListProvisionedConcurrencyConfigs_RequestSyntax) ** 指定一个数字以限制返回的配置数。有效范围：最小值为 1。最大值为 50。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "NextMarker": "string", "ProvisionedConcurrencyConfigs": [ { "AllocatedProvisionedConcurrentExecutions": number, "AvailableProvisionedConcurrentExecutions": number, "FunctionArn": "string", "LastModified": "string", "RequestedProvisionedConcurrentExecutions": number, "Status": "string", "StatusReason": "string" } ] } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [NextMarker](#API_ListProvisionedConcurrencyConfigs_ResponseSyntax) ** 有更多结果可用时包含的分页令牌。类型：字符串 ** [ProvisionedConcurrencyConfigs](#API_ListProvisionedConcurrencyConfigs_ResponseSyntax) ** 预置的并发配置列表。类型：[ProvisionedConcurrencyConfigListItem](API_ProvisionedConcurrencyConfigListItem.md) 对象数组 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) # ListTags 返回函数的[标签](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)。您也可以将标签与 [GetFunction](API_GetFunction.md) 一起使用。 ## 请求语法 ``` GET /2017-03-31/tags/ARN HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [ARN](#API_ListTags_RequestSyntax) ** 函数的 Amazon Resource Name (ARN)。注意：Lambda 不支持向别名或版本添加标签。模式：`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-_]+))?` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Tags": { "string" : "string" } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Tags](#API_ListTags_ResponseSyntax) ** 函数的标签。类型：字符串到字符串映射 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListTags) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListTags) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListTags) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListTags) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListTags) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListTags) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListTags) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListTags) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListTags) # ListVersionsByFunction 返回[版本](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html)列表，以及每个版本的版本特定配置。Lambda 每次调用最多返回 50 个版本。 ## 请求语法 ``` GET /2015-03-31/functions/FunctionName/versions?Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_ListVersionsByFunction_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 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-_]+))?` 必需：是 ** [Marker](#API_ListVersionsByFunction_RequestSyntax) ** 指定上次请求返回的分页令牌以检索下一页结果。 ** [MaxItems](#API_ListVersionsByFunction_RequestSyntax) ** 要返回的版本最大数量。请注意，即使您设置的数字较高，`ListVersionsByFunction` 在每个响应中最多返回 50 个项目。有效范围：最小值为 1。最大值为 10000。 ## 请求正文该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "NextMarker": "string", "Versions": [ { "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 格式返回以下数据。 ** [NextMarker](#API_ListVersionsByFunction_ResponseSyntax) ** 有更多结果可用时包含的分页令牌。类型：字符串 ** [Versions](#API_ListVersionsByFunction_ResponseSyntax) ** Lambda 函数版本的列表。类型：[FunctionConfiguration](API_FunctionConfiguration.md) 对象数组 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListVersionsByFunction) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListVersionsByFunction) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListVersionsByFunction) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListVersionsByFunction) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListVersionsByFunction) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListVersionsByFunction) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListVersionsByFunction) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListVersionsByFunction) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListVersionsByFunction) # PublishLayerVersion 从 ZIP 归档中创建某个 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。每次使用相同的层名称调用 `PublishLayerVersion` 时，将会创建新的版本。使用 [CreateFunction](API_CreateFunction.md) 或 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) 将层添加到您的函数。 ## 请求语法 ``` POST /2018-10-31/layers/LayerName/versions HTTP/1.1 Content-type: application/json { "CompatibleArchitectures": [ "string" ], "CompatibleRuntimes": [ "string" ], "Content": { "S3Bucket": "string", "S3Key": "string", "S3ObjectVersion": "string", "ZipFile": blob }, "Description": "string", "LicenseInfo": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [LayerName](#API_PublishLayerVersion_RequestSyntax) ** 层的名称或 Amazon Resource Name (ARN)。长度限制：最小长度为 1。长度上限为 140。模式：`(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+` 必需：是 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [CompatibleArchitectures](#API_PublishLayerVersion_RequestSyntax) ** 兼容[指令集架构](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)列表。类型：字符串数组数组成员：最多 15 项。有效值：`x86_64 | arm64` 必需：否 ** [CompatibleRuntimes](#API_PublishLayerVersion_RequestSyntax) ** 兼容的[函数运行时](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)列表。用于使用 [ListLayers](API_ListLayers.md) 和 [ListLayerVersions](API_ListLayerVersions.md) 进行筛选。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串数组数组成员：最多 15 项。有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` 必需：否 ** [Content](#API_PublishLayerVersion_RequestSyntax) ** 函数层存档。类型：[LayerVersionContentInput](API_LayerVersionContentInput.md) 对象必需：是 ** [Description](#API_PublishLayerVersion_RequestSyntax) ** 关于版本的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ** [LicenseInfo](#API_PublishLayerVersion_RequestSyntax) ** 层的软件许可证。它可以是以下任一种： + [SPDX 许可证标识符](https://spdx.org/licenses/)。例如，`MIT`。 + 在 Internet 上托管的许可证的 URL。例如，`https://opensource.org/licenses/MIT`。 + 许可证全文。类型：字符串长度约束：最大长度为 512。必需：否 ## 响应语法 ``` HTTP/1.1 201 Content-type: application/json { "CompatibleArchitectures": [ "string" ], "CompatibleRuntimes": [ "string" ], "Content": { "CodeSha256": "string", "CodeSize": number, "Location": "string", "SigningJobArn": "string", "SigningProfileVersionArn": "string" }, "CreatedDate": "string", "Description": "string", "LayerArn": "string", "LayerVersionArn": "string", "LicenseInfo": "string", "Version": number } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 201 响应。服务以 JSON 格式返回的以下数据。 ** [CompatibleArchitectures](#API_PublishLayerVersion_ResponseSyntax) ** 兼容[指令集架构](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)列表。类型：字符串数组数组成员：最多 15 项。有效值：`x86_64 | arm64` ** [CompatibleRuntimes](#API_PublishLayerVersion_ResponseSyntax) ** 层的兼容运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串数组数组成员：最多 15 项。有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [Content](#API_PublishLayerVersion_ResponseSyntax) ** 有关层版本的详细信息。类型：[LayerVersionContentOutput](API_LayerVersionContentOutput.md) 对象 ** [CreatedDate](#API_PublishLayerVersion_ResponseSyntax) ** 层版本的创建日期，为 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [Description](#API_PublishLayerVersion_ResponseSyntax) ** 关于版本的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [LayerArn](#API_PublishLayerVersion_ResponseSyntax) ** 层的 ARN。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+` ** [LayerVersionArn](#API_PublishLayerVersion_ResponseSyntax) ** 层版本的 ARN。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` ** [LicenseInfo](#API_PublishLayerVersion_ResponseSyntax) ** 层的软件许可证。类型：字符串长度约束：最大长度为 512。 ** [Version](#API_PublishLayerVersion_ResponseSyntax) ** 版本号。类型：长整型 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** CodeStorageExceededException ** 您的 AWS 账户已超出最大总代码大小。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 状态代码：400 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PublishLayerVersion) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PublishLayerVersion) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PublishLayerVersion) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PublishLayerVersion) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PublishLayerVersion) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PublishLayerVersion) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PublishLayerVersion) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PublishLayerVersion) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PublishLayerVersion) # PublishVersion 从一个函数的当前代码和配置创建一个[版本](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html)。使用版本创建不会更改的函数代码和配置的快照。如果该函数的配置和代码自上一个版本以来没有更改，则 AWS Lambda 不会发布版本。使用 [UpdateFunctionCode](API_UpdateFunctionCode.md) 或 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) 在发布版本之前更新函数。客户端可以直接调用版本或使用别名调用版本。要创建别名，请使用 [CreateAlias](API_CreateAlias.md)。 ## 请求语法 ``` POST /2015-03-31/functions/FunctionName/versions HTTP/1.1 Content-type: application/json { "CodeSha256": "string", "Description": "string", "RevisionId": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_PublishVersion_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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 格式的以下数据。 ** [CodeSha256](#API_PublishVersion_RequestSyntax) ** 仅当哈希值与指定的值匹配时才发布版本。如果自上次更新后函数代码发生更改，请使用此选项以避免发布版本。您可以从 [UpdateFunctionCode](API_UpdateFunctionCode.md) 的输出获得您上载的版本的哈希值。类型：字符串必需：否 ** [Description](#API_PublishVersion_RequestSyntax) ** 用于覆盖函数配置中的描述的版本描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ** [RevisionId](#API_PublishVersion_RequestSyntax) ** 仅当修订版 ID 与指定的 ID 匹配时才更新函数。如果自上次更新后函数配置发生了更改，请使用此选项以避免发布版本。类型：字符串必需：否 ## 响应语法 ``` HTTP/1.1 201 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 201 响应。服务以 JSON 格式返回的以下数据。 ** [Architectures](#API_PublishVersion_ResponseSyntax) ** 该函数支持的指令集架构。架构是具有有效值之一的字符串数组。默认架构值是 `x86_64`。类型：字符串数组数组成员：固定数量为 1 项。有效值：`x86_64 | arm64` ** [CodeSha256](#API_PublishVersion_ResponseSyntax) ** 函数部署包的 SHA256 哈希。类型：字符串 ** [CodeSize](#API_PublishVersion_ResponseSyntax) ** 函数部署包的大小（以字节为单位）。类型：长整型 ** [DeadLetterConfig](#API_PublishVersion_ResponseSyntax) ** 函数的死信队列。类型：[DeadLetterConfig](API_DeadLetterConfig.md) 对象 ** [Description](#API_PublishVersion_ResponseSyntax) ** 函数说明。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [Environment](#API_PublishVersion_ResponseSyntax) ** 函数[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。在 AWS CloudTrail 日志中被忽略。类型：[EnvironmentResponse](API_EnvironmentResponse.md) 对象 ** [EphemeralStorage](#API_PublishVersion_ResponseSyntax) ** 函数的 `/tmp` 目录大小（以 MB 为单位）。默认值为 512，但可以是介于 512 到 10240 MB 之间的任意整数。有关更多信息，请参阅[配置短暂存储（控制台）](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。类型：[EphemeralStorage](API_EphemeralStorage.md) 对象 ** [FileSystemConfigs](#API_PublishVersion_ResponseSyntax) ** [Amazon EFS 文件系统](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的连接设置。类型：[FileSystemConfig](API_FileSystemConfig.md) 对象数组数组成员：最多 1 个物品。 ** [FunctionArn](#API_PublishVersion_ResponseSyntax) ** 函数的 Amazon Resource Name (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](#API_PublishVersion_ResponseSyntax) ** 函数的名称。类型：字符串长度限制：最小长度为 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](#API_PublishVersion_ResponseSyntax) ** Lambda 为开始运行您的函数而调用的函数。类型：字符串长度限制：最大长度为 128。模式：`[^\s]+` ** [ImageConfigResponse](#API_PublishVersion_ResponseSyntax) ** 函数的镜像配置值。类型：[ImageConfigResponse](API_ImageConfigResponse.md) 对象 ** [KMSKeyArn](#API_PublishVersion_ResponseSyntax) ** 用于加密函数的[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)的 AWS KMS key。激活 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 时，此密钥还用于加密您的函数的快照。仅当您配置了客户托管密钥时，才会返回此密钥。类型：字符串模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` ** [LastModified](#API_PublishVersion_ResponseSyntax) ** 该函数上次更新的日期和时间，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [LastUpdateStatus](#API_PublishVersion_ResponseSyntax) ** 上次对函数执行的更新的状态。函数创建完成后，首先设置为 `Successful`。类型：字符串有效值：`Successful | Failed | InProgress` ** [LastUpdateStatusReason](#API_PublishVersion_ResponseSyntax) ** 上次对函数执行更新的原因。类型：字符串 ** [LastUpdateStatusReasonCode](#API_PublishVersion_ResponseSyntax) ** 函数上次更新的原因代码。类型：字符串有效值：`EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Layers](#API_PublishVersion_ResponseSyntax) ** 函数的[层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。类型：[Layer](API_Layer.md) 对象数组 ** [LoggingConfig](#API_PublishVersion_ResponseSyntax) ** 该函数的 Amazon CloudWatch Logs 配置设置。类型：[LoggingConfig](API_LoggingConfig.md) 对象 ** [MasterArn](#API_PublishVersion_ResponseSyntax) ** 对于 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](#API_PublishVersion_ResponseSyntax) ** 在运行时可用于函数的内存量。类型：整数有效范围：最小值为 128。最大值为 10240。 ** [PackageType](#API_PublishVersion_ResponseSyntax) ** 部署程序包的类型。将容器映像设置为 `Image`，然后将 .zip 文件存档设置为 `Zip`。类型：字符串有效值：`Zip | Image` ** [RevisionId](#API_PublishVersion_ResponseSyntax) ** 函数或别名的最新更新版本。类型：字符串 ** [Role](#API_PublishVersion_ResponseSyntax) ** 函数的执行角色。类型：字符串模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` ** [Runtime](#API_PublishVersion_ResponseSyntax) ** 函数的[运行时](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)的标识符。如果部署包是 .zip 文件归档，则需要使用运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [RuntimeVersionConfig](#API_PublishVersion_ResponseSyntax) ** 运行时的 ARN 和发生的任何错误。类型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 对象 ** [SigningJobArn](#API_PublishVersion_ResponseSyntax) ** 签名任务的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SigningProfileVersionArn](#API_PublishVersion_ResponseSyntax) ** 签名配置文件版本的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SnapStart](#API_PublishVersion_ResponseSyntax) ** 发布函数版本时，将 `ApplyOn` 设置为 `PublishedVersions` 以创建初始化执行环境的快照。有关更多信息，请参阅 [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)（使用 Lambda SnapStart 提高启动性能）。类型：[SnapStartResponse](API_SnapStartResponse.md) 对象 ** [State](#API_PublishVersion_ResponseSyntax) ** 函数的当前状态。当状态为 `Inactive`，您可以通过调用函数来重新激活该函数。类型：字符串有效值：`Pending | Active | Inactive | Failed` ** [StateReason](#API_PublishVersion_ResponseSyntax) ** 函数当前状态的原因。类型：字符串 ** [StateReasonCode](#API_PublishVersion_ResponseSyntax) ** 函数当前状态的原因代码。当代码为 `Creating` 时，无法调用或修改该函数。类型：字符串有效值：`Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Timeout](#API_PublishVersion_ResponseSyntax) ** Lambda 在停止函数前允许其运行的时长（以秒为单位）。类型：整数有效范围：最小值为 1。 ** [TracingConfig](#API_PublishVersion_ResponseSyntax) ** 函数的 AWS X-Ray 跟踪配置。类型：[TracingConfigResponse](API_TracingConfigResponse.md) 对象 ** [Version](#API_PublishVersion_ResponseSyntax) ** Lambda 函数的版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [VpcConfig](#API_PublishVersion_ResponseSyntax) ** 函数的网络配置。类型：[VpcConfigResponse](API_VpcConfigResponse.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** CodeStorageExceededException ** 您的 AWS 账户已超出最大总代码大小。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 状态代码：400 ** InvalidParameterValueException ** 请求中的参数之一无效。 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 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PublishVersion) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PublishVersion) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PublishVersion) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PublishVersion) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PublishVersion) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PublishVersion) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PublishVersion) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PublishVersion) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PublishVersion) # PutFunctionCodeSigningConfig 更新函数的代码签名配置。对代码签名配置的更改将在用户下次尝试将代码包部署到函数时生效。 ## 请求语法 ``` PUT /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1 Content-type: application/json { "CodeSigningConfigArn": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_PutFunctionCodeSigningConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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 格式的以下数据。 ** [CodeSigningConfigArn](#API_PutFunctionCodeSigningConfig_RequestSyntax) ** 代码签名配置的 Amazon Resource Name (ARN)。类型：字符串长度约束：最大长度为 200。模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` 必需：是 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "CodeSigningConfigArn": "string", "FunctionName": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [CodeSigningConfigArn](#API_PutFunctionCodeSigningConfig_ResponseSyntax) ** 代码签名配置的 Amazon Resource Name (ARN)。类型：字符串长度约束：最大长度为 200。模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` ** [FunctionName](#API_PutFunctionCodeSigningConfig_ResponseSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** CodeSigningConfigNotFoundException ** 指定的代码签名配置不存在。 HTTP 状态代码：404 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionCodeSigningConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionCodeSigningConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionCodeSigningConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionCodeSigningConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionCodeSigningConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) # PutFunctionConcurrency 设置函数的最大同时执行数，并为该并发级别预留容量。并发设置适用于整个函数，包括所有已发布版本和未发布版本。预留并发可确保您的函数具有同时处理指定数量事件的容量，并防止其扩展到超出该级别。使用 [GetFunction](API_GetFunction.md) 查看函数的当前设置。使用 [GetAccountSettings](API_GetAccountSettings.md) 以查看您的区域并发限制。您可以根据需要为任意数量的函数预留并发，只需为未配置每函数限制的函数预留至少 100 个并发执行。有关更多信息，请参阅 [Lambda 函数扩展](https://docs.aws.amazon.com/lambda/latest/dg/invocation-scaling.html)。 ## 请求语法 ``` PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1 Content-type: application/json { "ReservedConcurrentExecutions": number } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_PutFunctionConcurrency_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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 格式的以下数据。 ** [ReservedConcurrentExecutions](#API_PutFunctionConcurrency_RequestSyntax) ** 为函数保留的同时执行次数。类型：整数有效范围：最小值为 0。必需：是 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "ReservedConcurrentExecutions": number } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [ReservedConcurrentExecutions](#API_PutFunctionConcurrency_ResponseSyntax) ** 为此函数预留的并发执行数。有关更多信息，请参阅[管理 Lambda 预留并发](https://docs.aws.amazon.com/lambda/latest/dg/configuration-concurrency.html)。类型：整数有效范围：最小值为 0。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionConcurrency) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionConcurrency) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionConcurrency) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionConcurrency) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionConcurrency) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionConcurrency) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionConcurrency) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionConcurrency) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionConcurrency) # PutFunctionEventInvokeConfig 配置对函数、版本或别名的[异步调用](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html)选项。如果函数、版本或别名的配置已存在，则此操作会覆盖该配置。如果排除任何设置，则会删除这些设置。要设置一个选项而不影响其他选项的现有设置，请使用 [UpdateFunctionEventInvokeConfig](API_UpdateFunctionEventInvokeConfig.md)。默认情况下，如果函数返回错误，Lambda 将重试两次异步调用。它将事件在队列中保留最多 6 个小时。如果事件未完成所有处理尝试，或者在异步调用队列中保留太长的时间，Lambda 将丢弃该事件。要保留已丢弃的事件，请使用 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) 配置死信队列。要将调用记录发送到队列、主题、函数或事件总线，请指定[目的地](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations)。您可以为成功调用（成功时）和所有处理尝试均失败（失败时）的事件配置单独的目的地。除死信队列之外，或者作为替代死信队列的方式，您还可以配置目的地。 ## 请求语法 ``` PUT /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_PutFunctionEventInvokeConfig_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** - `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_PutFunctionEventInvokeConfig_RequestSyntax) ** 版本号或别名。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_RequestSyntax) ** 在事件发送到函数以进行处理后的目标。 **目标** + **Function** - Lambda 函数的 Amazon 资源名称（ARN）。 + **Queue** - 标准 SQS 队列的 ARN。 + **Topic** - 标准 SNS 主题的 ARN。 + **Event Bus** - Amazon EventBridge 事件总线的 ARN。类型：[DestinationConfig](API_DestinationConfig.md) 对象必需：否 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_RequestSyntax) ** Lambda 发送到函数以进行处理的请求的最长期限。类型：整数有效范围：最小值为 60。最大值为 21600。必需：否 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_RequestSyntax) ** 在函数返回错误时重试的最大次数。类型：整数有效范围：最小值为 0。最大值为 2。必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "FunctionArn": "string", "LastModified": number, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_ResponseSyntax) ** 在事件发送到函数以进行处理后的目标。 **目标** + **Function** - Lambda 函数的 Amazon 资源名称（ARN）。 + **Queue** - 标准 SQS 队列的 ARN。 + **Topic** - 标准 SNS 主题的 ARN。 + **Event Bus** - Amazon EventBridge 事件总线的 ARN。类型：[DestinationConfig](API_DestinationConfig.md) 对象 ** [FunctionArn](#API_PutFunctionEventInvokeConfig_ResponseSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` ** [LastModified](#API_PutFunctionEventInvokeConfig_ResponseSyntax) ** 上次更新配置的日期和时间（以 Unix 时间秒为单位）。类型：时间戳 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_ResponseSyntax) ** Lambda 发送到函数以进行处理的请求的最长期限。类型：整数有效范围：最小值为 60。最大值为 21600。 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_ResponseSyntax) ** 在函数返回错误时重试的最大次数。类型：整数有效范围：最小值为 0。最大值为 2。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionEventInvokeConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionEventInvokeConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionEventInvokeConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionEventInvokeConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionEventInvokeConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) # PutProvisionedConcurrencyConfig 将预置的并发配置添加到函数的别名或版本。 ## 请求语法 ``` PUT /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "ProvisionedConcurrentExecutions": number } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_PutProvisionedConcurrencyConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_PutProvisionedConcurrencyConfig_RequestSyntax) ** 版本号或别名。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` 必需：是 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [ProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_RequestSyntax) ** 要为版本或别名分配的预置并发数量。类型：整数有效范围：最小值为 1。必需：是 ## 响应语法 ``` HTTP/1.1 202 Content-type: application/json { "AllocatedProvisionedConcurrentExecutions": number, "AvailableProvisionedConcurrentExecutions": number, "LastModified": "string", "RequestedProvisionedConcurrentExecutions": number, "Status": "string", "StatusReason": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 202 响应。服务以 JSON 格式返回以下数据。 ** [AllocatedProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) ** 输入要分配的预置并发数量。在线性部署和金丝雀部署期间使用加权别名时，该值会根据为函数版本预配置的并发量而波动。类型：整数有效范围：最小值为 0。 ** [AvailableProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) ** 可用的预置并发数量。类型：整数有效范围：最小值为 0。 ** [LastModified](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) ** 用户上次更新配置的日期和时间，格式为 [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。类型：字符串 ** [RequestedProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) ** 请求的预置并发数量。类型：整数有效范围：最小值为 1。 ** [Status](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) ** 分配过程的状态。类型：字符串有效值：`IN_PROGRESS | READY | FAILED` ** [StatusReason](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) ** 分配失败的原因，即无法分配预置并发的原因。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutProvisionedConcurrencyConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutProvisionedConcurrencyConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutProvisionedConcurrencyConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutProvisionedConcurrencyConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) # PutRuntimeManagementConfig 设置函数版本的运行时管理配置。有关更多信息，请参阅 [Runtime updates](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html)（运行时更新）。 ## 请求语法 ``` PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "RuntimeVersionArn": "string", "UpdateRuntimeOn": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_PutRuntimeManagementConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_PutRuntimeManagementConfig_RequestSyntax) ** 指定该函数的版本。可以是 `$LATEST` 或已发布的版本号。如果未指定任何值，则将返回 `$LATEST` 版本的配置。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_RequestSyntax) ** 您希望函数使用的运行时版本的 ARN。仅在使用**手动**运行时更新模式时需要。类型：字符串长度限制：最小长度为 26。最大长度为 2048。模式：`^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$` 必需：否 ** [UpdateRuntimeOn](#API_PutRuntimeManagementConfig_RequestSyntax) ** 指定运行时更新模式。 + **自动（默认）**– 通过[两阶段运行时版本推出](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-two-phase)，自动更新到最新的安全运行时版本。对于大多数客户来说，这是确保其始终从运行时更新中受益的最佳选择。 + **函数更新** – 当您更新函数时，Lambda 会将函数的运行时更新为最新的安全运行时版本。这种方法可将运行时更新与函数部署同步，这样，您就可以控制应用运行时更新的时间，并及早检测和缓解少数运行时更新不兼容问题。使用此设置时，您需要定期更新函数以保持最新的函数运行时。 + **手动** – 在函数配置中指定运行时版本。该函数将无限期使用此运行时版本。在极少数情况下，新的运行时版本与现有函数不兼容，这样您就可以将函数回滚到早期运行时版本。有关更多信息，请参阅 [Roll back a runtime version](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-rollback)（回滚运行时版本）。类型：字符串有效值：`Auto | Manual | FunctionUpdate` 必需：是 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "FunctionArn": "string", "RuntimeVersionArn": "string", "UpdateRuntimeOn": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [FunctionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) ** 函数的 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-_]+))?` ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) ** 配置函数所使用的运行时的 ARN。如果运行时更新模式为**手动**，则将返回 ARN，否则将返回 `null`。类型：字符串长度限制：最小长度为 26。最大长度为 2048。模式：`^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$` ** [UpdateRuntimeOn](#API_PutRuntimeManagementConfig_ResponseSyntax) ** 运行时更新模式。类型：字符串有效值：`Auto | Manual | FunctionUpdate` ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutRuntimeManagementConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutRuntimeManagementConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutRuntimeManagementConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutRuntimeManagementConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutRuntimeManagementConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutRuntimeManagementConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutRuntimeManagementConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutRuntimeManagementConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutRuntimeManagementConfig) # RemoveLayerVersionPermission 从某个 [AWS Lambda 层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的某个版本的权限策略中删除语句。有关更多信息，请参阅[AddLayerVersionPermission](API_AddLayerVersionPermission.md)。 ## 请求语法 ``` DELETE /2018-10-31/layers/LayerName/versions/VersionNumber/policy/StatementId?RevisionId=RevisionId HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [LayerName](#API_RemoveLayerVersionPermission_RequestSyntax) ** 层的名称或 Amazon Resource Name (ARN)。长度限制：最小长度为 1。长度上限为 140。模式：`(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+` 必需：是 ** [RevisionId](#API_RemoveLayerVersionPermission_RequestSyntax) ** 仅当修订版 ID 与指定的 ID 匹配时才更新策略。使用此选项以避免修改自上次读取后已发生更改的策略。 ** [StatementId](#API_RemoveLayerVersionPermission_RequestSyntax) ** 添加语句时指定的标识符。长度限制：最小长度为 1。最大长度为 100。模式：`([a-zA-Z0-9-_]+)` 必需：是 ** [VersionNumber](#API_RemoveLayerVersionPermission_RequestSyntax) ** 版本号。必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** PreconditionFailedException ** 提供的 RevisionId 与 Lambda 函数或别名的最新 RevisionId 不匹配。调用 `GetFunction` 或 `GetAlias` API 操作来检索您的资源的最新 RevisionId。 HTTP 状态代码：412 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/RemoveLayerVersionPermission) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/RemoveLayerVersionPermission) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/RemoveLayerVersionPermission) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/RemoveLayerVersionPermission) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/RemoveLayerVersionPermission) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/RemoveLayerVersionPermission) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/RemoveLayerVersionPermission) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/RemoveLayerVersionPermission) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/RemoveLayerVersionPermission) # RemovePermission 从 AWS 服务或其他 AWS 账户中撤销函数使用权限。从 [GetPolicy](API_GetPolicy.md) 的输出中获取语句的 ID。 ## 请求语法 ``` DELETE /2015-03-31/functions/FunctionName/policy/StatementId?Qualifier=Qualifier&RevisionId=RevisionId HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_RemovePermission_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_RemovePermission_RequestSyntax) ** 指定版本或别名以从函数的已发布版本中删除权限。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ** [RevisionId](#API_RemovePermission_RequestSyntax) ** 仅当修订版 ID 与指定的 ID 匹配时才更新策略。使用此选项以避免修改自上次读取后已发生更改的策略。 ** [StatementId](#API_RemovePermission_RequestSyntax) ** 要删除的权限的语句 ID。长度限制：最小长度为 1。最大长度为 100。模式：`([a-zA-Z0-9-_.]+)` 必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** PreconditionFailedException ** 提供的 RevisionId 与 Lambda 函数或别名的最新 RevisionId 不匹配。调用 `GetFunction` 或 `GetAlias` API 操作来检索您的资源的最新 RevisionId。 HTTP 状态代码：412 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/RemovePermission) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/RemovePermission) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/RemovePermission) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/RemovePermission) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/RemovePermission) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/RemovePermission) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/RemovePermission) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/RemovePermission) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/RemovePermission) # TagResource 将[标签](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)添加到函数。 ## 请求语法 ``` POST /2017-03-31/tags/ARN HTTP/1.1 Content-type: application/json { "Tags": { "string" : "string" } } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [ARN](#API_TagResource_RequestSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` 必需：是 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [Tags](#API_TagResource_RequestSyntax) ** 要应用于函数的标签列表。类型：字符串到字符串映射必需：是 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/TagResource) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/TagResource) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/TagResource) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/TagResource) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/TagResource) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/TagResource) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/TagResource) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/TagResource) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/TagResource) # UntagResource 从函数中删除[标签](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)。 ## 请求语法 ``` DELETE /2017-03-31/tags/ARN?tagKeys=TagKeys HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [ARN](#API_UntagResource_RequestSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` 必需：是 ** [TagKeys](#API_UntagResource_RequestSyntax) ** 要从函数中删除的标签键的列表。必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 204 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UntagResource) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UntagResource) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UntagResource) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UntagResource) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UntagResource) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UntagResource) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UntagResource) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UntagResource) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UntagResource) # UpdateAlias 更新 Lambda 函数[别名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)的配置。 ## 请求语法 ``` PUT /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1 Content-type: application/json { "Description": "string", "FunctionVersion": "string", "RevisionId": "string", "RoutingConfig": { "AdditionalVersionWeights": { "string" : number } } } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_UpdateAlias_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** - `MyFunction`。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **部分 ARN** - `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Name](#API_UpdateAlias_RequestSyntax) ** 别名的名称。长度限制：最小长度为 1。长度上限为 128。模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 必需：是 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [Description](#API_UpdateAlias_RequestSyntax) ** 别名的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ** [FunctionVersion](#API_UpdateAlias_RequestSyntax) ** 别名调用的函数版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` 必需：否 ** [RevisionId](#API_UpdateAlias_RequestSyntax) ** 仅当修订版 ID 与指定的 ID 匹配时才更新别名。使用此选项以避免修改自上次读取后已发生更改的别名。类型：字符串必需：否 ** [RoutingConfig](#API_UpdateAlias_RequestSyntax) ** 别名的[路由配置](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing)。类型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 对象必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AliasArn": "string", "Description": "string", "FunctionVersion": "string", "Name": "string", "RevisionId": "string", "RoutingConfig": { "AdditionalVersionWeights": { "string" : number } } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AliasArn](#API_UpdateAlias_ResponseSyntax) ** 是别名的 Amazon Resource Name (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-_]+))?` ** [Description](#API_UpdateAlias_ResponseSyntax) ** 别名的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [FunctionVersion](#API_UpdateAlias_ResponseSyntax) ** 别名调用的函数版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [Name](#API_UpdateAlias_ResponseSyntax) ** 别名的名称。类型：字符串长度限制：长度下限为 1。长度上限为 128。模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)` ** [RevisionId](#API_UpdateAlias_ResponseSyntax) ** 更新别名时更改的唯一标识符。类型：字符串 ** [RoutingConfig](#API_UpdateAlias_ResponseSyntax) ** 别名的[路由配置](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html)。类型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 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 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateAlias) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateAlias) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateAlias) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateAlias) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateAlias) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateAlias) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateAlias) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateAlias) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateAlias) # UpdateCodeSigningConfig 更新代码签名配置。对代码签名配置的更改将在用户下次尝试将代码包部署到函数时生效。 ## 请求语法 ``` PUT /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1 Content-type: application/json { "AllowedPublishers": { "SigningProfileVersionArns": [ "string" ] }, "CodeSigningPolicies": { "UntrustedArtifactOnDeployment": "string" }, "Description": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [CodeSigningConfigArn](#API_UpdateCodeSigningConfig_RequestSyntax) ** 代码签名配置的 Amazon Resource Name (ARN)。长度约束：最大长度为 200。模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` 必需：是 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [AllowedPublishers](#API_UpdateCodeSigningConfig_RequestSyntax) ** 此代码签名配置的签名配置文件。类型：[AllowedPublishers](API_AllowedPublishers.md) 对象必需：否 ** [CodeSigningPolicies](#API_UpdateCodeSigningConfig_RequestSyntax) ** 代码签名策略。类型：[CodeSigningPolicies](API_CodeSigningPolicies.md) 对象必需：否 ** [Description](#API_UpdateCodeSigningConfig_RequestSyntax) ** 此代码签名配置的描述性名称。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "CodeSigningConfig": { "AllowedPublishers": { "SigningProfileVersionArns": [ "string" ] }, "CodeSigningConfigArn": "string", "CodeSigningConfigId": "string", "CodeSigningPolicies": { "UntrustedArtifactOnDeployment": "string" }, "Description": "string", "LastModified": "string" } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [CodeSigningConfig](#API_UpdateCodeSigningConfig_ResponseSyntax) ** 代码签名配置类型：[CodeSigningConfig](API_CodeSigningConfig.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateCodeSigningConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateCodeSigningConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateCodeSigningConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateCodeSigningConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateCodeSigningConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateCodeSigningConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateCodeSigningConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateCodeSigningConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateCodeSigningConfig) # UpdateEventSourceMapping 更新事件源映射。您可以更改 AWS Lambda 调用的函数，或暂停调用并稍后从同一位置恢复。有关如何配置不同事件源的详细信息，请参阅以下主题。 + [Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-dynamodb-eventsourcemapping) + [Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-eventsourcemapping) + [Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-eventsource) + [Amazon MQ 和 RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-eventsourcemapping) + [Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html) + [Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/kafka-smaa.html) + [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) 以下错误处理选项仅适用于流源（DynamoDB 和 Kinesis）： + `BisectBatchOnFunctionError` – 如果函数返回错误，则将批次拆分为两批并重试。 + `DestinationConfig` – 将丢弃的记录发送到 Amazon SQS 队列或 Amazon SNS 主题。 + `MaximumRecordAgeInSeconds` – 丢弃超过指定期限的记录。默认值为无限 (-1)。如果设置为无限 (-1)，则会一直重试失败的记录，直到记录过期。 + `MaximumRetryAttempts` – 在指定重试次数后丢弃记录。默认值为无限 (-1)。如果设置为无限 (-1)，则会一直重试失败的记录，直到记录过期。 + `ParallelizationFactor` – 同时处理来自每个分片的多个批次。有关适用于每个事件源的配置参数信息，请参阅以下主题。 + [Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-params) + [Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-params) + [Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-params) + [Amazon MQ 和 RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-params) + [Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-parms) + [Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-kafka-parms) + [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html#docdb-configuration) ## 请求语法 ``` PUT /2015-03-31/event-source-mappings/UUID HTTP/1.1 Content-type: application/json { "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "Enabled": boolean, "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionName": "string", "FunctionResponseTypes": [ "string" ], "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "ScalingConfig": { "MaximumConcurrency": number }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "TumblingWindowInSeconds": number } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [UUID](#API_UpdateEventSourceMapping_RequestSyntax) ** 事件源映射的标识符。必需：是 ## 请求体请求接受采用 JSON 格式的以下数据。 ** [BatchSize](#API_UpdateEventSourceMapping_RequestSyntax) ** Lambda 从流或队列中提取并发送到函数的每个批处理中的最大记录数。Lambda 在单次调用中将批处理中的所有记录传递给函数，最高可传递同步调用的负载上限 (6 MB)。 + **Amazon Kinesis** – 默认值为 100。最大值为 10,000。 + **Amazon DynamoDB Streams** – 默认值为 100。最大值为 10,000。 + **Amazon Simple Queue Service** – 默认值为 10。对于标准队列，最大值为 10,000。对于 FIFO 队列，最大值为 10。 + **Amazon Managed Streaming for Apache Kafka** – 默认值为 100。最大值为 10,000。 + **自行管理的 Apache Kafka** – 默认值为 100。最大值为 10,000。 + **Amazon MQ（ActiveMQ 和 RabbitMQ）** – 默认值为 100。最大值为 10,000。 + **DocumentDB** – 默认值 100。最大值为 10,000。类型：整数有效范围：最小值为 1。最大值为 10000。必需：否 ** [BisectBatchOnFunctionError](#API_UpdateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）如果函数返回错误，则将分处理拆分为两个并重试。类型：布尔值必需：否 ** [DestinationConfig](#API_UpdateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis、DynamoDB Streams、Amazon MSK 和自行管理的 Kafka）用于在 Lambda 处理事件后指定事件目标的配置对象。类型：[DestinationConfig](API_DestinationConfig.md) 对象必需：否 ** [DocumentDBEventSourceConfig](#API_UpdateEventSourceMapping_RequestSyntax) ** DocumentB 事件源的特定配置设置。类型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 对象必需：否 ** [Enabled](#API_UpdateEventSourceMapping_RequestSyntax) ** 当为 true 时，事件源映射处于活动状态。当为 false 时，Lambda 暂停轮询和调用。默认值：True 类型：布尔值必需：否 ** [FilterCriteria](#API_UpdateEventSourceMapping_RequestSyntax) ** 定义用于确定 Lambda 是否应处理事件的筛选条件的对象。有关更多信息，请参阅 [Lambda 事件筛选](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。类型：[FilterCriteria](API_FilterCriteria.md) 对象必需：否 ** [FunctionName](#API_UpdateEventSourceMapping_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `MyFunction`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **版本或别名 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD`。 + **部分 ARN** – `123456789012:function:MyFunction`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度将限制为 64 个字符。类型：字符串长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：否 ** [FunctionResponseTypes](#API_UpdateEventSourceMapping_RequestSyntax) ** （Kinesis、DynamoDB Streams 和 Amazon SQS）应用于事件源映射的当前响应类型枚举的列表。类型：字符串数组数组成员：最少 0 项。最多 1 项。有效值：`ReportBatchItemFailures` 必需：否 ** [MaximumBatchingWindowInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) ** Lambda 在调用函数之前收集记录的最长时间，以秒为单位。您可以将 `MaximumBatchingWindowInSeconds` 配置为介于 0 秒到 300 秒之间的任意值，以秒的整数倍调整。对于流和 Amazon SQS 事件源，默认批处理时段为 0 秒。对于 Amazon MSK、自行管理的 Apache Kafka、Amazon MQ 和 DocumentDB 事件源，默认批处理时间窗口为 500 毫秒。请注意，由于您只能以秒为增量更改 `MaximumBatchingWindowInSeconds`，所以在更改后无法恢复到 500 毫秒的默认批处理时段。要恢复原定设置的批处理时段，必须创建新的事件源映射。相关设置：对于流和 Amazon SQS 事件源，当将 `BatchSize` 设置为大于 10 的值时，必须将 `MaximumBatchingWindowInSeconds` 至少设置为 1。类型：整数有效范围：最小值为 0。最大值为 300。必需：否 ** [MaximumRecordAgeInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）丢弃超过指定龄期的记录。默认值为无限 (-1)。类型：整数有效范围：最小值为 -1。最大值为 604800。必需：否 ** [MaximumRetryAttempts](#API_UpdateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）在指定重试次数后丢弃记录。默认值为无限 (-1)。如果设置为无限 (-1)，则会一直重试失败的记录，直到记录过期。类型：整数有效范围：最小值为 -1。最大值为 10000。必需：否 ** [ParallelizationFactor](#API_UpdateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）每个分片中同时处理的批处理数。类型：整数有效范围：最小值为 1。最大值为 10。必需：否 ** [ScalingConfig](#API_UpdateEventSourceMapping_RequestSyntax) ** （仅限 Amazon SQS）事件源的扩缩配置。有关更多信息，请参阅[为 Amazon SQS 事件源配置最大并发](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)。类型：[ScalingConfig](API_ScalingConfig.md) 对象必需：否 ** [SourceAccessConfigurations](#API_UpdateEventSourceMapping_RequestSyntax) ** 用于保护事件源的身份验证协议数组或 VPC 组件。类型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 对象数组数组成员：最少 0 项。最多 22 项。必需：否 ** [TumblingWindowInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）DynamoDB 和 Kinesis Streams 事件源的处理时间窗口（以秒为单位）。值为 0 秒表示无滑动时间窗口。类型：整数有效范围：最小值为 0。最大值为 900。必需：否 ## 响应语法 ``` HTTP/1.1 202 Content-type: application/json { "AmazonManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionArn": "string", "FunctionResponseTypes": [ "string" ], "LastModified": number, "LastProcessingResult": "string", "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "Queues": [ "string" ], "ScalingConfig": { "MaximumConcurrency": number }, "SelfManagedEventSource": { "Endpoints": { "string" : [ "string" ] } }, "SelfManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "StartingPosition": "string", "StartingPositionTimestamp": number, "State": "string", "StateTransitionReason": "string", "Topics": [ "string" ], "TumblingWindowInSeconds": number, "UUID": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 202 响应。服务以 JSON 格式返回以下数据。 ** [AmazonManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) ** Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件源的特定配置设置。类型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 对象 ** [BatchSize](#API_UpdateEventSourceMapping_ResponseSyntax) ** Lambda 从流或队列中提取并发送到函数的每个批处理中的最大记录数。Lambda 在单次调用中将批处理中的所有记录传递给函数，最高可传递同步调用的负载上限 (6 MB)。默认值：因服务而异。对于 Amazon SQS，默认值为 10。对于所有其他服务，默认值为 100。相关设置：当将 `BatchSize` 设置为一个大于 10 的值时，必须至少将 `MaximumBatchingWindowInSeconds` 设置为 1。类型：整数有效范围：最小值为 1。最大值为 10000。 ** [BisectBatchOnFunctionError](#API_UpdateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）如果函数返回错误，则将分处理拆分为两个并重试。默认值为 False。类型：布尔值 ** [DestinationConfig](#API_UpdateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis、DynamoDB Streams、Amazon MSK 和自行管理的 Apache Kafka 事件源）用于在 Lambda 处理事件后指定事件目标的配置对象。类型：[DestinationConfig](API_DestinationConfig.md) 对象 ** [DocumentDBEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) ** DocumentB 事件源的特定配置设置。类型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 对象 ** [EventSourceArn](#API_UpdateEventSourceMapping_ResponseSyntax) ** 事件源的 Amazon Resource Name (ARN)。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [FilterCriteria](#API_UpdateEventSourceMapping_ResponseSyntax) ** 定义用于确定 Lambda 是否应处理事件的筛选条件的对象。有关更多信息，请参阅 [Lambda 事件筛选](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。类型：[FilterCriteria](API_FilterCriteria.md) 对象 ** [FunctionArn](#API_UpdateEventSourceMapping_ResponseSyntax) ** Lambda 函数的 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-_]+))?` ** [FunctionResponseTypes](#API_UpdateEventSourceMapping_ResponseSyntax) ** （Kinesis、DynamoDB Streams 和 Amazon SQS）应用于事件源映射的当前响应类型枚举的列表。类型：字符串数组数组成员：最少 0 项。最多 1 项。有效值：`ReportBatchItemFailures` ** [LastModified](#API_UpdateEventSourceMapping_ResponseSyntax) ** 上次更新事件源映射或其状态更改的日期（以 Unix 时间秒为单位）。类型：时间戳 ** [LastProcessingResult](#API_UpdateEventSourceMapping_ResponseSyntax) ** 函数的最后一次 Lambda 调用结果。类型：字符串 ** [MaximumBatchingWindowInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) ** Lambda 在调用函数之前收集记录的最长时间，以秒为单位。您可以将 `MaximumBatchingWindowInSeconds` 配置为介于 0 秒到 300 秒之间的任意值，以秒的整数倍调整。对于流和 Amazon SQS 事件源，默认批处理时段为 0 秒。对于 Amazon MSK、自行管理的 Apache Kafka、Amazon MQ 和 DocumentDB 事件源，默认批处理时间窗口为 500 毫秒。请注意，由于您只能以秒为增量更改 `MaximumBatchingWindowInSeconds`，所以在更改后无法恢复到 500 毫秒的默认批处理时段。要恢复原定设置的批处理时段，必须创建新的事件源映射。相关设置：对于流和 Amazon SQS 事件源，当将 `BatchSize` 设置为大于 10 的值时，必须将 `MaximumBatchingWindowInSeconds` 至少设置为 1。类型：整数有效范围：最小值为 0。最大值为 300。 ** [MaximumRecordAgeInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）丢弃超过指定龄期的记录。原定设置值为 -1，该值将最大年龄设置为无限。将该值设置为无限后，Lambda 永远不会删除旧记录。最长记录期限的最小有效值为 60 秒。尽管小于 60 和大于 -1 的值都在参数的绝对范围内，但不允许使用它们类型：整数有效范围：最小值为 -1。最大值为 604800。 ** [MaximumRetryAttempts](#API_UpdateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）在指定重试次数后丢弃记录。原定设置值为 -1，该值将最大重试次数设置为无限。将 MaximumRetryAttempts 设置为无限后，Lambda 会重试失败的记录，直到事件源中的记录过期为止。类型：整数有效范围：最小值为 -1。最大值为 10000。 ** [ParallelizationFactor](#API_UpdateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）每个分片中同时处理的批处理数。默认值是 1。类型：整数有效范围：最小值为 1。最大值为 10。 ** [Queues](#API_UpdateEventSourceMapping_ResponseSyntax) ** (Amazon MQ) 要使用的 Amazon MQ 代理目标队列的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。最大长度为 1000。模式：`[\s\S]*` ** [ScalingConfig](#API_UpdateEventSourceMapping_ResponseSyntax) ** （仅限 Amazon SQS）事件源的扩缩配置。有关更多信息，请参阅[为 Amazon SQS 事件源配置最大并发](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)。类型：[ScalingConfig](API_ScalingConfig.md) 对象 ** [SelfManagedEventSource](#API_UpdateEventSourceMapping_ResponseSyntax) ** 适用于事件源的自行管理 Apache Kafka 集群。类型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 对象 ** [SelfManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) ** 自行管理的 Apache Kafka 事件源的特定配置设置。类型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 对象 ** [SourceAccessConfigurations](#API_UpdateEventSourceMapping_ResponseSyntax) ** 用于保护与定义事件源的身份验证协议数组 VPC 组件或虚拟化主机。类型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 对象数组数组成员：最少 0 项。最多 22 项。 ** [StartingPosition](#API_UpdateEventSourceMapping_ResponseSyntax) ** 在流中开始读取数据的位置。对于 Amazon Kinesis 和 Amazon DynamoDB Streams 事件源，为必需项。仅 Amazon Kinesis 流、Amazon DocumentDB、Amazon MSK 和自行管理的 Apache Kafka 支持 `AT_TIMESTAMP`。类型：字符串有效值：`TRIM_HORIZON | LATEST | AT_TIMESTAMP` ** [StartingPositionTimestamp](#API_UpdateEventSourceMapping_ResponseSyntax) ** 将 `StartingPosition` 设置为 `AT_TIMESTAMP` 时，即开始读取的时间（以 Unix 时间秒为单位）。`StartingPositionTimestamp` 不能是未来时间。类型：时间戳 ** [State](#API_UpdateEventSourceMapping_ResponseSyntax) ** 事件源映射的状态。此状态可以是以下值之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。类型：字符串 ** [StateTransitionReason](#API_UpdateEventSourceMapping_ResponseSyntax) ** 表明是用户还是 Lambda 对事件源映射进行了最后一次更改。类型：字符串 ** [Topics](#API_UpdateEventSourceMapping_ResponseSyntax) ** Kafka 主题的名称。类型：字符串数组数组成员：固定数量为 1 项。长度限制：最小长度为 1。长度上限为 249。模式：`^[^.]([a-zA-Z0-9\-_.]+)` ** [TumblingWindowInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) ** （仅限 Kinesis 和 DynamoDB Streams）DynamoDB 和 Kinesis Streams 事件源的处理时间窗口（以秒为单位）。值为 0 秒表示无滑动时间窗口。类型：整数有效范围：最小值为 0。最大值为 900。 ** [UUID](#API_UpdateEventSourceMapping_ResponseSyntax) ** 事件源映射的标识符。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceInUseException ** 该操作与资源的可用性冲突。例如，您试图在 CREATING 状态中更新事件源映射，或尝试删除当前处于 UPDATING 状态的事件源映射。 HTTP 状态代码：400 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateEventSourceMapping) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateEventSourceMapping) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateEventSourceMapping) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateEventSourceMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateEventSourceMapping) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateEventSourceMapping) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateEventSourceMapping) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateEventSourceMapping) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateEventSourceMapping) # UpdateFunctionCode 更新 Lambda 函数代码。如果为函数启用了代码签名，则代码包必须由受信任的发布者签名。有关更多信息，请参阅[为 Lambda 配置代码签名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-codesigning.html)。如果函数的代码包类型为 `Image`，则您必须将 `ImageUri` 中的代码包指定为 Amazon ECR 注册表中[容器映像](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html)的 URI。如果函数的代码包类型为 `Zip`，则您必须将部署包指定为 [.zip 文件归档](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-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](#API_UpdateFunctionCode_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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](#API_UpdateFunctionCode_RequestSyntax) ** 该函数支持的指令集架构。输入具有其中一个有效值（arm64 或 x86\$164）的字符串数组。默认值为 `x86_64`。类型：字符串数组数组成员：固定数量为 1 项。有效值：`x86_64 | arm64` 必需：否 ** [DryRun](#API_UpdateFunctionCode_RequestSyntax) ** 设置为 true，以在不修改函数代码的情况下验证请求参数和访问权限。类型：布尔值必需：否 ** [ImageUri](#API_UpdateFunctionCode_RequestSyntax) ** Amazon ECR 注册表中容器映像的 URI。请勿用于使用 .zip 文件归档定义的函数。类型：字符串必需：否 ** [Publish](#API_UpdateFunctionCode_RequestSyntax) ** 设置为 true，以在更新代码后发布新版本的函数。这与单独调用 [PublishVersion](API_PublishVersion.md) 的效果相同。类型：布尔值必需：否 ** [RevisionId](#API_UpdateFunctionCode_RequestSyntax) ** 仅当修订版 ID 与指定的 ID 匹配时才更新函数。使用此选项以避免修改自上次读取后发生更改的函数。类型：字符串必需：否 ** [S3Bucket](#API_UpdateFunctionCode_RequestSyntax) ** 与您的函数处于同一 AWS 区域的 Amazon S3 桶。存储桶可能位于不同的 AWS 账户中。仅与使用 .zip 文件归档部署包定义的函数搭配使用。类型：字符串长度限制：最小长度为 3。长度上限为 63。模式：`^[0-9A-Za-z\.\-_]*(? 部署程序包的 Amazon S3 密钥。仅与使用 .zip 文件归档部署包定义的函数搭配使用。类型：字符串长度限制：最小长度为 1。最大长度为 1024。必需：否 ** [S3ObjectVersion](#API_UpdateFunctionCode_RequestSyntax) ** 对于版本控制的对象，指要使用的部署程序包对象的版本。类型：字符串长度限制：最小长度为 1。最大长度为 1024。必需：否 ** [ZipFile](#API_UpdateFunctionCode_RequestSyntax) ** 部署程序包的 base64 编码内容。AWS开发工具包和 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](#API_UpdateFunctionCode_ResponseSyntax) ** 该函数支持的指令集架构。架构是具有有效值之一的字符串数组。默认架构值是 `x86_64`。类型：字符串数组数组成员：固定数量为 1 项。有效值：`x86_64 | arm64` ** [CodeSha256](#API_UpdateFunctionCode_ResponseSyntax) ** 函数部署包的 SHA256 哈希。类型：字符串 ** [CodeSize](#API_UpdateFunctionCode_ResponseSyntax) ** 函数部署包的大小（以字节为单位）。类型：长整型 ** [DeadLetterConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的死信队列。类型：[DeadLetterConfig](API_DeadLetterConfig.md) 对象 ** [Description](#API_UpdateFunctionCode_ResponseSyntax) ** 函数说明。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [Environment](#API_UpdateFunctionCode_ResponseSyntax) ** 函数[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。在 AWS CloudTrail 日志中被忽略。类型：[EnvironmentResponse](API_EnvironmentResponse.md) 对象 ** [EphemeralStorage](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的 `/tmp` 目录大小（以 MB 为单位）。默认值为 512，但可以是介于 512 到 10240 MB 之间的任意整数。有关更多信息，请参阅[配置短暂存储（控制台）](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。类型：[EphemeralStorage](API_EphemeralStorage.md) 对象 ** [FileSystemConfigs](#API_UpdateFunctionCode_ResponseSyntax) ** [Amazon EFS 文件系统](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的连接设置。类型：[FileSystemConfig](API_FileSystemConfig.md) 对象数组数组成员：最多 1 个物品。 ** [FunctionArn](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的 Amazon Resource Name (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](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的名称。类型：字符串长度限制：最小长度为 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](#API_UpdateFunctionCode_ResponseSyntax) ** Lambda 为开始运行您的函数而调用的函数。类型：字符串长度限制：最大长度为 128。模式：`[^\s]+` ** [ImageConfigResponse](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的镜像配置值。类型：[ImageConfigResponse](API_ImageConfigResponse.md) 对象 ** [KMSKeyArn](#API_UpdateFunctionCode_ResponseSyntax) ** 用于加密函数的[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)的 AWS KMS key。激活 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 时，此密钥还用于加密您的函数的快照。仅当您配置了客户托管密钥时，才会返回此密钥。类型：字符串模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` ** [LastModified](#API_UpdateFunctionCode_ResponseSyntax) ** 该函数上次更新的日期和时间，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [LastUpdateStatus](#API_UpdateFunctionCode_ResponseSyntax) ** 上次对函数执行的更新的状态。函数创建完成后，首先设置为 `Successful`。类型：字符串有效值：`Successful | Failed | InProgress` ** [LastUpdateStatusReason](#API_UpdateFunctionCode_ResponseSyntax) ** 上次对函数执行更新的原因。类型：字符串 ** [LastUpdateStatusReasonCode](#API_UpdateFunctionCode_ResponseSyntax) ** 函数上次更新的原因代码。类型：字符串有效值：`EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Layers](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的[层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。类型：[Layer](API_Layer.md) 对象数组 ** [LoggingConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 该函数的 Amazon CloudWatch Logs 配置设置。类型：[LoggingConfig](API_LoggingConfig.md) 对象 ** [MasterArn](#API_UpdateFunctionCode_ResponseSyntax) ** 对于 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](#API_UpdateFunctionCode_ResponseSyntax) ** 在运行时可用于函数的内存量。类型：整数有效范围：最小值为 128。最大值为 10240。 ** [PackageType](#API_UpdateFunctionCode_ResponseSyntax) ** 部署程序包的类型。将容器映像设置为 `Image`，然后将 .zip 文件存档设置为 `Zip`。类型：字符串有效值：`Zip | Image` ** [RevisionId](#API_UpdateFunctionCode_ResponseSyntax) ** 函数或别名的最新更新版本。类型：字符串 ** [Role](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的执行角色。类型：字符串模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` ** [Runtime](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的[运行时](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)的标识符。如果部署包是 .zip 文件归档，则需要使用运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [RuntimeVersionConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 运行时的 ARN 和发生的任何错误。类型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 对象 ** [SigningJobArn](#API_UpdateFunctionCode_ResponseSyntax) ** 签名任务的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SigningProfileVersionArn](#API_UpdateFunctionCode_ResponseSyntax) ** 签名配置文件版本的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SnapStart](#API_UpdateFunctionCode_ResponseSyntax) ** 发布函数版本时，将 `ApplyOn` 设置为 `PublishedVersions` 以创建初始化执行环境的快照。有关更多信息，请参阅 [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)（使用 Lambda SnapStart 提高启动性能）。类型：[SnapStartResponse](API_SnapStartResponse.md) 对象 ** [State](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的当前状态。当状态为 `Inactive`，您可以通过调用函数来重新激活该函数。类型：字符串有效值：`Pending | Active | Inactive | Failed` ** [StateReason](#API_UpdateFunctionCode_ResponseSyntax) ** 函数当前状态的原因。类型：字符串 ** [StateReasonCode](#API_UpdateFunctionCode_ResponseSyntax) ** 函数当前状态的原因代码。当代码为 `Creating` 时，无法调用或修改该函数。类型：字符串有效值：`Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Timeout](#API_UpdateFunctionCode_ResponseSyntax) ** Lambda 在停止函数前允许其运行的时长（以秒为单位）。类型：整数有效范围：最小值为 1。 ** [TracingConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的 AWS X-Ray 跟踪配置。类型：[TracingConfigResponse](API_TracingConfigResponse.md) 对象 ** [Version](#API_UpdateFunctionCode_ResponseSyntax) ** Lambda 函数的版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [VpcConfig](#API_UpdateFunctionCode_ResponseSyntax) ** 函数的网络配置。类型：[VpcConfigResponse](API_VpcConfigResponse.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** CodeSigningConfigNotFoundException ** 指定的代码签名配置不存在。 HTTP 状态代码：404 ** CodeStorageExceededException ** 您的 AWS 账户已超出最大总代码大小。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)。 HTTP 状态代码：400 ** CodeVerificationFailedException ** 代码签名失败，一个或多个签名验证检查不匹配或过期，并且代码签名策略设置为“ENFORCE”。Lambda 阻止部署。 HTTP 状态代码：400 ** InvalidCodeSignatureException ** 代码签名未通过完整性检查。如果完整性检查失败，Lambda 会阻止部署，即使代码签名策略设置为 WARN 也是如此。 HTTP 状态代码：400 ** InvalidParameterValueException ** 请求中的参数之一无效。 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 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionCode) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionCode) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionCode) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionCode) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionCode) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionCode) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionCode) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionCode) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionCode) # UpdateFunctionConfiguration 修改 Lambda 函数的版本特定设置。更新函数时，Lambda 会预置该函数及其支持资源的实例。如果您的函数连接到 VPC，则此过程可能需要一分钟时间。在此期间，您无法修改函数，但仍可以调用函数。来自 [GetFunctionConfiguration](API_GetFunctionConfiguration.md) 响应的 `LastUpdateStatus`、`LastUpdateStatusReason` 和 `LastUpdateStatusReasonCode` 字段指示更新何时完成，且函数正在处理具有新配置的事件。有关更多信息，请参阅 [Lambda 函数状态](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html)。这些设置可能因函数的版本而异，并且在发布版本时会被锁定。您无法修改已发布版本的配置，只能修改未发布版本的配置。要配置函数并发，请使用 [PutFunctionConcurrency](API_PutFunctionConcurrency.md)。要向 AWS 账户或 AWS 服务授予调用权限，请使用 [AddPermission](API_AddPermission.md)。 ## 请求语法 ``` PUT /2015-03-31/functions/FunctionName/configuration HTTP/1.1 Content-type: application/json { "DeadLetterConfig": { "TargetArn": "string" }, "Description": "string", "Environment": { "Variables": { "string" : "string" } }, "EphemeralStorage": { "Size": number }, "FileSystemConfigs": [ { "Arn": "string", "LocalMountPath": "string" } ], "Handler": "string", "ImageConfig": { "Command": [ "string" ], "EntryPoint": [ "string" ], "WorkingDirectory": "string" }, "KMSKeyArn": "string", "Layers": [ "string" ], "LoggingConfig": { "ApplicationLogLevel": "string", "LogFormat": "string", "LogGroup": "string", "SystemLogLevel": "string" }, "MemorySize": number, "RevisionId": "string", "Role": "string", "Runtime": "string", "SnapStart": { "ApplyOn": "string" }, "Timeout": number, "TracingConfig": { "Mode": "string" }, "VpcConfig": { "Ipv6AllowedForDualStack": boolean, "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ] } } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_UpdateFunctionConfiguration_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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 格式的以下数据。 ** [DeadLetterConfig](#API_UpdateFunctionConfiguration_RequestSyntax) ** 死信队列配置，用于指定 Lambda 在处理失败时发送异步事件的队列或主题。有关更多信息，请参阅[死信队列](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq)。类型：[DeadLetterConfig](API_DeadLetterConfig.md) 对象必需：否 ** [Description](#API_UpdateFunctionConfiguration_RequestSyntax) ** 该函数的描述。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ** [Environment](#API_UpdateFunctionConfiguration_RequestSyntax) ** 执行期间可从函数代码访问的环境变量。类型：[Environment](API_Environment.md) 对象必需：否 ** [EphemeralStorage](#API_UpdateFunctionConfiguration_RequestSyntax) ** 函数的 `/tmp` 目录大小（以 MB 为单位）。默认值为 512，但可以是介于 512 到 10240 MB 之间的任意整数。有关更多信息，请参阅[配置短暂存储（控制台）](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。类型：[EphemeralStorage](API_EphemeralStorage.md) 对象必需：否 ** [FileSystemConfigs](#API_UpdateFunctionConfiguration_RequestSyntax) ** Amazon EFS 文件系统的连接设置。类型：[FileSystemConfig](API_FileSystemConfig.md) 对象数组数组成员：最多 1 个物品。必需：否 ** [Handler](#API_UpdateFunctionConfiguration_RequestSyntax) ** 代码中方法的名称，Lambda 可调用该方法来运行您的函数。如果部署包是 .zip 文件归档，则需要使用处理程序。该格式包括文件名，也可以包括命名空间和其他限定符，具体取决于运行时。有关更多信息，请参阅 [Lambda 编程模型](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html)。类型：字符串长度限制：最大长度为 128。模式：`[^\s]+` 必需：否 ** [ImageConfig](#API_UpdateFunctionConfiguration_RequestSyntax) ** 覆盖容器镜像 Docker 文件中的值的[容器镜像配置值](https://docs.aws.amazon.com/lambda/latest/dg/images-parms.html)。类型：[ImageConfig](API_ImageConfig.md) 对象必需：否 ** [KMSKeyArn](#API_UpdateFunctionConfiguration_RequestSyntax) ** AWS Key Management Service (AWS KMS) 客户托管密钥的 ARN，用于加密函数的[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)。激活 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 后，Lambda 还使用此密钥对函数的快照进行加密。如果您使用容器映像部署函数，Lambda 还会在部署函数后使用此密钥对其进行加密。请注意，此密钥与在 Amazon Elastic Container Registry（Amazon ECR）中用于保护容器映像的密钥不同。如果您未提供客户托管密钥，Lambda 将使用默认服务密钥。类型：字符串模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 必需：否 ** [Layers](#API_UpdateFunctionConfiguration_RequestSyntax) ** 要添加到函数执行环境中的[函数层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)列表。通过 ARN 指定每一层，包括版本。类型：字符串数组长度限制：最小长度为 1。长度上限为 140。模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` 必需：否 ** [LoggingConfig](#API_UpdateFunctionConfiguration_RequestSyntax) ** 该函数的 Amazon CloudWatch Logs 配置设置。类型：[LoggingConfig](API_LoggingConfig.md) 对象必需：否 ** [MemorySize](#API_UpdateFunctionConfiguration_RequestSyntax) ** 在运行时 [可用于函数的内存](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console) 量。提高该函数的内存也会增加它的 CPU 分配。默认值为 128 MB。该值可以是 1 MB 的任意倍数。类型：整数有效范围：最小值为 128。最大值为 10240。必需：否 ** [RevisionId](#API_UpdateFunctionConfiguration_RequestSyntax) ** 仅当修订版 ID 与指定的 ID 匹配时才更新函数。使用此选项以避免修改自上次读取后发生更改的函数。类型：字符串必需：否 ** [Role](#API_UpdateFunctionConfiguration_RequestSyntax) ** 函数的执行角色的 Amazon Resource Name (ARN)。类型：字符串模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必需：否 ** [Runtime](#API_UpdateFunctionConfiguration_RequestSyntax) ** 函数的[运行时](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)的标识符。如果部署包是 .zip 文件归档，则需要使用运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` 必需：否 ** [SnapStart](#API_UpdateFunctionConfiguration_RequestSyntax) ** 函数的 [SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) 设置。类型：[SnapStart](API_SnapStart.md) 对象必需：否 ** [Timeout](#API_UpdateFunctionConfiguration_RequestSyntax) ** Lambda 在停止函数前允许其运行的时长（以秒为单位）。默认值为 3 秒。允许的最大值为 900 秒。有关更多信息，请参阅 [Lambda 执行环境](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html)。类型：整数有效范围：最小值为 1。必需：否 ** [TracingConfig](#API_UpdateFunctionConfiguration_RequestSyntax) ** 将 `Mode` 设置为 `Active`，以使用 [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) 对传入请求的子集进行采样和跟踪。类型：[TracingConfig](API_TracingConfig.md) 对象必需：否 ** [VpcConfig](#API_UpdateFunctionConfiguration_RequestSyntax) ** 对于与 VPC 中的AWS资源的网络连接，指定 VPC 中的安全组和子网列表。当您将函数连接到 VPC 时，它只能通过该 VPC 访问资源和互联网。有关更多信息，请参阅[配置 Lambda 函数以访问 VPC 中的资源](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html)。类型：[VpcConfig](API_VpcConfig.md) 对象必需：否 ## 响应语法 ``` 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](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 该函数支持的指令集架构。架构是具有有效值之一的字符串数组。默认架构值是 `x86_64`。类型：字符串数组数组成员：固定数量为 1 项。有效值：`x86_64 | arm64` ** [CodeSha256](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数部署包的 SHA256 哈希。类型：字符串 ** [CodeSize](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数部署包的大小（以字节为单位）。类型：长整型 ** [DeadLetterConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的死信队列。类型：[DeadLetterConfig](API_DeadLetterConfig.md) 对象 ** [Description](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数说明。类型：字符串长度约束：最小长度为 0。长度上限为 256。 ** [Environment](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。在 AWS CloudTrail 日志中被忽略。类型：[EnvironmentResponse](API_EnvironmentResponse.md) 对象 ** [EphemeralStorage](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的 `/tmp` 目录大小（以 MB 为单位）。默认值为 512，但可以是介于 512 到 10240 MB 之间的任意整数。有关更多信息，请参阅[配置短暂存储（控制台）](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。类型：[EphemeralStorage](API_EphemeralStorage.md) 对象 ** [FileSystemConfigs](#API_UpdateFunctionConfiguration_ResponseSyntax) ** [Amazon EFS 文件系统](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的连接设置。类型：[FileSystemConfig](API_FileSystemConfig.md) 对象数组数组成员：最多 1 个物品。 ** [FunctionArn](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的 Amazon Resource Name (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](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的名称。类型：字符串长度限制：最小长度为 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](#API_UpdateFunctionConfiguration_ResponseSyntax) ** Lambda 为开始运行您的函数而调用的函数。类型：字符串长度限制：最大长度为 128。模式：`[^\s]+` ** [ImageConfigResponse](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的镜像配置值。类型：[ImageConfigResponse](API_ImageConfigResponse.md) 对象 ** [KMSKeyArn](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 用于加密函数的[环境变量](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption)的 AWS KMS key。激活 [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) 时，此密钥还用于加密您的函数的快照。仅当您配置了客户托管密钥时，才会返回此密钥。类型：字符串模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` ** [LastModified](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 该函数上次更新的日期和时间，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [LastUpdateStatus](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 上次对函数执行的更新的状态。函数创建完成后，首先设置为 `Successful`。类型：字符串有效值：`Successful | Failed | InProgress` ** [LastUpdateStatusReason](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 上次对函数执行更新的原因。类型：字符串 ** [LastUpdateStatusReasonCode](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数上次更新的原因代码。类型：字符串有效值：`EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Layers](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的[层](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。类型：[Layer](API_Layer.md) 对象数组 ** [LoggingConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 该函数的 Amazon CloudWatch Logs 配置设置。类型：[LoggingConfig](API_LoggingConfig.md) 对象 ** [MasterArn](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 对于 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](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 在运行时可用于函数的内存量。类型：整数有效范围：最小值为 128。最大值为 10240。 ** [PackageType](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 部署程序包的类型。将容器映像设置为 `Image`，然后将 .zip 文件存档设置为 `Zip`。类型：字符串有效值：`Zip | Image` ** [RevisionId](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数或别名的最新更新版本。类型：字符串 ** [Role](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的执行角色。类型：字符串模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` ** [Runtime](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的[运行时](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)的标识符。如果部署包是 .zip 文件归档，则需要使用运行时。以下列表包括已弃用的运行时。有关更多信息，请参阅[运行时弃用策略](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy)。类型：字符串有效值：`nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` ** [RuntimeVersionConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 运行时的 ARN 和发生的任何错误。类型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 对象 ** [SigningJobArn](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 签名任务的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SigningProfileVersionArn](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 签名配置文件版本的 ARN。类型：字符串模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [SnapStart](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 发布函数版本时，将 `ApplyOn` 设置为 `PublishedVersions` 以创建初始化执行环境的快照。有关更多信息，请参阅 [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)（使用 Lambda SnapStart 提高启动性能）。类型：[SnapStartResponse](API_SnapStartResponse.md) 对象 ** [State](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的当前状态。当状态为 `Inactive`，您可以通过调用函数来重新激活该函数。类型：字符串有效值：`Pending | Active | Inactive | Failed` ** [StateReason](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数当前状态的原因。类型：字符串 ** [StateReasonCode](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数当前状态的原因代码。当代码为 `Creating` 时，无法调用或修改该函数。类型：字符串有效值：`Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` ** [Timeout](#API_UpdateFunctionConfiguration_ResponseSyntax) ** Lambda 在停止函数前允许其运行的时长（以秒为单位）。类型：整数有效范围：最小值为 1。 ** [TracingConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的 AWS X-Ray 跟踪配置。类型：[TracingConfigResponse](API_TracingConfigResponse.md) 对象 ** [Version](#API_UpdateFunctionConfiguration_ResponseSyntax) ** Lambda 函数的版本。类型：字符串长度限制：最小长度为 1。长度上限为 1024。模式：`(\$LATEST|[0-9]+)` ** [VpcConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) ** 函数的网络配置。类型：[VpcConfigResponse](API_VpcConfigResponse.md) 对象 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** CodeSigningConfigNotFoundException ** 指定的代码签名配置不存在。 HTTP 状态代码：404 ** CodeVerificationFailedException ** 代码签名失败，一个或多个签名验证检查不匹配或过期，并且代码签名策略设置为“ENFORCE”。Lambda 阻止部署。 HTTP 状态代码：400 ** InvalidCodeSignatureException ** 代码签名未通过完整性检查。如果完整性检查失败，Lambda 会阻止部署，即使代码签名策略设置为 WARN 也是如此。 HTTP 状态代码：400 ** InvalidParameterValueException ** 请求中的参数之一无效。 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 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionConfiguration) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionConfiguration) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionConfiguration) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionConfiguration) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionConfiguration) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionConfiguration) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionConfiguration) # UpdateFunctionEventInvokeConfig 更新函数、版本或别名的异步调用配置。要配置异步调用的选项，请使用 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)。 ## 请求语法 ``` POST /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) ** Lambda 函数的名称、版本或别名。 **名称格式** + **函数名称** – `my-function`（仅限名称）、`my-function:v1`（具有别名）。 + **函数 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** - `123456789012:function:my-function`。您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) ** 版本号或别名。长度限制：最小长度为 1。长度上限为 128。模式：`(|[a-zA-Z0-9$_-]+)` ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [DestinationConfig](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) ** 在事件发送到函数以进行处理后的目标。 **目标** + **Function** - Lambda 函数的 Amazon 资源名称（ARN）。 + **Queue** - 标准 SQS 队列的 ARN。 + **Topic** - 标准 SNS 主题的 ARN。 + **Event Bus** - Amazon EventBridge 事件总线的 ARN。类型：[DestinationConfig](API_DestinationConfig.md) 对象必需：否 ** [MaximumEventAgeInSeconds](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) ** Lambda 发送到函数以进行处理的请求的最长期限。类型：整数有效范围：最小值为 60。最大值为 21600。必需：否 ** [MaximumRetryAttempts](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) ** 在函数返回错误时重试的最大次数。类型：整数有效范围：最小值为 0。最大值为 2。必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "FunctionArn": "string", "LastModified": number, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [DestinationConfig](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) ** 在事件发送到函数以进行处理后的目标。 **目标** + **Function** - Lambda 函数的 Amazon 资源名称（ARN）。 + **Queue** - 标准 SQS 队列的 ARN。 + **Topic** - 标准 SNS 主题的 ARN。 + **Event Bus** - Amazon EventBridge 事件总线的 ARN。类型：[DestinationConfig](API_DestinationConfig.md) 对象 ** [FunctionArn](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` ** [LastModified](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) ** 上次更新配置的日期和时间（以 Unix 时间秒为单位）。类型：时间戳 ** [MaximumEventAgeInSeconds](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) ** Lambda 发送到函数以进行处理的请求的最长期限。类型：整数有效范围：最小值为 60。最大值为 21600。 ** [MaximumRetryAttempts](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) ** 在函数返回错误时重试的最大次数。类型：整数有效范围：最小值为 0。最大值为 2。 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) # UpdateFunctionUrlConfig 更新 Lambda 函数 URL 的配置。 ## 请求语法 ``` PUT /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "AuthType": "string", "Cors": { "AllowCredentials": boolean, "AllowHeaders": [ "string" ], "AllowMethods": [ "string" ], "AllowOrigins": [ "string" ], "ExposeHeaders": [ "string" ], "MaxAge": number }, "InvokeMode": "string" } ``` ## URI 请求参数请求使用以下 URI 参数。 ** [FunctionName](#API_UpdateFunctionUrlConfig_RequestSyntax) ** Lambda 函数的名称。 **名称格式** + **函数名称** – `my-function`。 + **函数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`。 + **部分 ARN** – `123456789012:function:my-function`。长度约束仅适用于完整 ARN。如果您仅指定函数名称，它的长度限制为 64 个字符。长度限制：最小长度为 1。长度上限为 140。模式：`(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-_]+))?` 必需：是 ** [Qualifier](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 别名。长度限制：最小长度为 1。长度上限为 128。模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))` ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AuthType](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 `AWS_IAM`。如果想绕过 IAM 身份验证以创建公有端点，请设置为 `NONE`。有关更多信息，请参阅 [Lambda 函数 URL 的安全性和身份验证模型](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html)。类型：字符串有效值：`NONE | AWS_IAM` 必需：否 ** [Cors](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 适用于函数 URL 的 [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)（跨源资源共享）设置。类型：[Cors](API_Cors.md) 对象必需：否 ** [InvokeMode](#API_UpdateFunctionUrlConfig_RequestSyntax) ** 使用以下选项之一： + `BUFFERED` – 这是默认选项。Lambda 通过 `Invoke` API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。 + `RESPONSE_STREAM` – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 `InvokeWithResponseStream` API 操作调用函数。最大响应负载大小为 20MB，但是，您可以[请求提高限额](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。类型：字符串有效值：`BUFFERED | RESPONSE_STREAM` 必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AuthType": "string", "Cors": { "AllowCredentials": boolean, "AllowHeaders": [ "string" ], "AllowMethods": [ "string" ], "AllowOrigins": [ "string" ], "ExposeHeaders": [ "string" ], "MaxAge": number }, "CreationTime": "string", "FunctionArn": "string", "FunctionUrl": "string", "InvokeMode": "string", "LastModifiedTime": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AuthType](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 函数 URL 使用的身份验证类型。如果想将访问权限限制为仅经过身份验证的用户，请设置为 `AWS_IAM`。如果想绕过 IAM 身份验证以创建公有端点，请设置为 `NONE`。有关更多信息，请参阅 [Lambda 函数 URL 的安全性和身份验证模型](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html)。类型：字符串有效值：`NONE | AWS_IAM` ** [Cors](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 适用于函数 URL 的 [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)（跨源资源共享）设置。类型：[Cors](API_Cors.md) 对象 ** [CreationTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 创建函数 URL 时，使用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ** [FunctionArn](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 函数的 Amazon Resource Name (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-_]+))?` ** [FunctionUrl](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 函数的 HTTP URL 端点。类型：字符串长度限制：最小长度为 40。最大长度为 100。 ** [InvokeMode](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 使用以下选项之一： + `BUFFERED` – 这是默认选项。Lambda 通过 `Invoke` API 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。 + `RESPONSE_STREAM` – 函数能够在负载结果可用时对其进行流式处理。Lambda 通过 `InvokeWithResponseStream` API 操作调用函数。最大响应负载大小为 20MB，但是，您可以[请求提高限额](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。类型：字符串有效值：`BUFFERED | RESPONSE_STREAM` ** [LastModifiedTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) ** 上次更新函数 URL 时，采用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅 [常见错误](CommonErrors.md)。 ** InvalidParameterValueException ** 请求中的参数之一无效。 HTTP 状态代码：400 ** ResourceConflictException ** 资源已存在，或者其他操作正在进行中。 HTTP 状态代码：409 ** ResourceNotFoundException ** 请求中指定的资源不存在。 HTTP 状态代码：404 ** ServiceException ** AWS Lambda 服务遇到了内部错误。 HTTP 状态代码：500 ** TooManyRequestsException ** 超出了请求吞吐量限制。有关更多信息，请参阅 [Lambda 限额](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 状态代码：429 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionUrlConfig) + [AWS 适用于 JavaScript 的开发工具包 V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionUrlConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionUrlConfig)