本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 動作
<a name="API_Operations"></a>

支援以下動作：
+  [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
<a name="API_AddLayerVersionPermission"></a>

將許可新增到 [AWS Lambda 層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的其中一個版本的資源型政策。使用此動作來將 layer 使用許可授予其他帳戶。您可以將許可授予單一帳戶、組織中的所有帳戶或所有 AWS 帳戶。

若要撤銷許可，請使用在新增時已指定的陳述式 ID 呼叫 [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md)。

## 請求語法
<a name="API_AddLayerVersionPermission_RequestSyntax"></a>

```
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 請求參數
<a name="API_AddLayerVersionPermission_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [LayerName](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-LayerName"></a>
layer 的名稱或 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) **   <a name="lambda-AddLayerVersionPermission-request-RevisionId"></a>
只有在修訂版本 ID 符合指定的 ID 時才更新政策。使用此選項來避免修改自您最近一次讀取之後產生變更的政策。

 ** [VersionNumber](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-VersionNumber"></a>
版本號碼。  
必要：是

## 請求主體
<a name="API_AddLayerVersionPermission_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [Action](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Action"></a>
將存取授予 layer 的 API 動作。例如 `lambda:GetLayerVersion`。  
類型：字串  
長度限制：長度上限為 22。  
模式：`lambda:GetLayerVersion`  
必要：是

 ** [OrganizationId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-OrganizationId"></a>
透過將主體設為 `*`，即可將許可授予指定組織中的所有帳戶。  
類型：字串  
長度限制：長度上限為 34。  
模式：`o-[a-z0-9]{10,32}`  
必要：否

 ** [Principal](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Principal"></a>
帳戶 ID，或 `*` 將層級使用許可授予給組織中的所有帳戶或所有 AWS 帳戶 (如果未指定 `organizationId`)。對於最後一種情況，請確保您確實想要所有 AWS 帳戶具有此層級的使用許可。  
類型：String  
模式：`\d{12}|\*|arn:(aws[a-zA-Z-]*):iam::\d{12}:root`  
必要：是

 ** [StatementId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-StatementId"></a>
在同一層版本上區分該政策與其他政策的識別符。  
類型：字串  
長度限制：長度下限為 1。長度上限為 100。  
模式：`([a-zA-Z0-9-_]+)`  
必要：是

## 回應語法
<a name="API_AddLayerVersionPermission_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "RevisionId": "string",
   "Statement": "string"
}
```

## 回應元素
<a name="API_AddLayerVersionPermission_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

 ** [RevisionId](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-RevisionId"></a>
目前政策修訂版本的唯一識別符。  
類型：字串

 ** [Statement](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-Statement"></a>
許可陳述式。  
類型：字串

## 錯誤
<a name="API_AddLayerVersionPermission_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_AddLayerVersionPermission_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/AddLayerVersionPermission) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddLayerVersionPermission) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddLayerVersionPermission) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddLayerVersionPermission) 

# AddPermission
<a name="API_AddPermission"></a>

授予 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)。

## 請求語法
<a name="API_AddPermission_RequestSyntax"></a>

```
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 請求參數
<a name="API_AddPermission_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-FunctionName"></a>
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) **   <a name="lambda-AddPermission-request-Qualifier"></a>
指定版本或別名，以將許可新增至函數的已發佈版本。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_AddPermission_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [Action](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-Action"></a>
主體可在函數上使用的動作。例如，`lambda:InvokeFunction` 或 `lambda:GetFunction`。  
類型：String  
模式：`(lambda:[*]|lambda:[a-zA-Z]+|[*])`  
必要：是

 ** [EventSourceToken](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-EventSourceToken"></a>
針對 Alexa Smart Home 函數，調用者必須提供的權杖。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
模式：`[a-zA-Z0-9._\-]+`  
必要：否

 ** [FunctionUrlAuthType](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-FunctionUrlAuthType"></a>
函數 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) **   <a name="lambda-AddPermission-request-Principal"></a>
調用函數的 AWS 服務 或 AWS 帳戶。若您指定服務，請使用 `SourceArn` 或 `SourceAccount` 來限制可透過服務呼叫函數的對象。  
類型：String  
模式：`[^\s]+`  
必要：是

 ** [PrincipalOrgID](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-PrincipalOrgID"></a>
AWS Organizations 中組織的識別符。用這個授予許可給此組織下的所有 AWS 帳戶。  
類型：字串  
長度限制：長度下限為 12。長度上限為 34。  
模式：`^o-[a-z0-9]{10,32}$`  
必要：否

 ** [RevisionId](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-RevisionId"></a>
只有在修訂版本 ID 符合指定的 ID 時才更新政策。使用此選項來避免修改自您最近一次讀取之後產生變更的政策。  
類型：字串  
必要：否

 ** [SourceAccount](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-SourceAccount"></a>
對於 AWS 服務，指擁有資源的 AWS 帳戶 之 ID。搭配 `SourceArn` 一起使用，可確保指定的帳戶擁有資源。Amazon S3 儲存貯體可以由擁有者刪除，並由其他帳戶重新建立。  
類型：字串  
長度限制：長度上限為 12。  
模式：`\d{12}`  
必要：否

 ** [SourceArn](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-SourceArn"></a>
對於 AWS 服務，調用函數的 AWS 資源之 ARN。例如，Amazon S3 儲存貯體或 Amazon SNS 主題。  
請注意，Lambda 會使用 `StringLike` 運算子來設定比較。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`  
必要：否

 ** [StatementId](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-StatementId"></a>
可區分相同政策中該陳述式與其他陳述式的陳述式識別符。  
類型：字串  
長度限制：長度下限為 1。長度上限為 100。  
模式：`([a-zA-Z0-9-_]+)`  
必要：是

## 回應語法
<a name="API_AddPermission_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "Statement": "string"
}
```

## 回應元素
<a name="API_AddPermission_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Statement](#API_AddPermission_ResponseSyntax) **   <a name="lambda-AddPermission-response-Statement"></a>
已新增至函數政策的許可陳述式。  
類型：字串

## 錯誤
<a name="API_AddPermission_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_AddPermission_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/AddPermission) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddPermission) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddPermission) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddPermission) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddPermission) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddPermission) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddPermission) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddPermission) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddPermission) 

# CreateAlias
<a name="API_CreateAlias"></a>

建立 Lambda 函數版本的[別名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)。使用別名來提供用戶端您可以更新，以呼叫不同版本的函數識別符。

您也可以將別名映射到兩個版本間的分割呼叫請求。使用 `RoutingConfig` 參數指定第二個版本，以及其接收的呼叫請求百分比。

## 請求語法
<a name="API_CreateAlias_RequestSyntax"></a>

```
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 請求參數
<a name="API_CreateAlias_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_CreateAlias_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [Description](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Description"></a>
別名的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

 ** [FunctionVersion](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionVersion"></a>
別名呼叫的函數版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`  
必要：是

 ** [Name](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Name"></a>
別名的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)`  
必要：是

 ** [RoutingConfig](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-RoutingConfig"></a>
別名的[路由組態](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing)。  
類型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 物件  
必要：否

## 回應語法
<a name="API_CreateAlias_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## 回應元素
<a name="API_CreateAlias_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AliasArn](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-AliasArn"></a>
別名的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-CreateAlias-response-Description"></a>
別名的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [FunctionVersion](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-FunctionVersion"></a>
別名呼叫的函數版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [Name](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Name"></a>
別名的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)`

 ** [RevisionId](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RevisionId"></a>
當您更新別名時，會變更的唯一識別符。  
類型：字串

 ** [RoutingConfig](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RoutingConfig"></a>
別名的[路由組態](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html)。  
類型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 物件

## 錯誤
<a name="API_CreateAlias_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_CreateAlias_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateAlias) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateAlias) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateAlias) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateAlias) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateAlias) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateAlias) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateAlias) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateAlias) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateAlias) 

# CreateCodeSigningConfig
<a name="API_CreateCodeSigningConfig"></a>

建立程式碼簽署組態。[程式碼簽署組態](https://docs.aws.amazon.com/lambda/latest/dg/configuration-codesigning.html)會定義允許的簽署描述檔的清單，並定義程式碼簽署驗證政策 (如果部署驗證檢查失敗應採取的動作)。

## 請求語法
<a name="API_CreateCodeSigningConfig_RequestSyntax"></a>

```
POST /2020-04-22/code-signing-configs/ HTTP/1.1
Content-type: application/json

{
   "AllowedPublishers": { 
      "SigningProfileVersionArns": [ "string" ]
   },
   "CodeSigningPolicies": { 
      "UntrustedArtifactOnDeployment": "string"
   },
   "Description": "string"
}
```

## URI 請求參數
<a name="API_CreateCodeSigningConfig_RequestParameters"></a>

請求不會使用任何 URI 參數。

## 請求主體
<a name="API_CreateCodeSigningConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [AllowedPublishers](#API_CreateCodeSigningConfig_RequestSyntax) **   <a name="lambda-CreateCodeSigningConfig-request-AllowedPublishers"></a>
此程式碼簽署組態的簽署設定檔。  
類型：[AllowedPublishers](API_AllowedPublishers.md) 物件  
必要：是

 ** [CodeSigningPolicies](#API_CreateCodeSigningConfig_RequestSyntax) **   <a name="lambda-CreateCodeSigningConfig-request-CodeSigningPolicies"></a>
程式碼簽署政策會定義如果驗證檢查失敗應採取的動作。  
類型：[CodeSigningPolicies](API_CodeSigningPolicies.md) 物件  
必要：否

 ** [Description](#API_CreateCodeSigningConfig_RequestSyntax) **   <a name="lambda-CreateCodeSigningConfig-request-Description"></a>
此程式碼簽署組態的描述性名稱。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

## 回應語法
<a name="API_CreateCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CodeSigningConfig": { 
      "AllowedPublishers": { 
         "SigningProfileVersionArns": [ "string" ]
      },
      "CodeSigningConfigArn": "string",
      "CodeSigningConfigId": "string",
      "CodeSigningPolicies": { 
         "UntrustedArtifactOnDeployment": "string"
      },
      "Description": "string",
      "LastModified": "string"
   }
}
```

## 回應元素
<a name="API_CreateCodeSigningConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CodeSigningConfig](#API_CreateCodeSigningConfig_ResponseSyntax) **   <a name="lambda-CreateCodeSigningConfig-response-CodeSigningConfig"></a>
程式碼簽章組態。  
類型：[CodeSigningConfig](API_CodeSigningConfig.md) 物件

## 錯誤
<a name="API_CreateCodeSigningConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** InvalidParameterValueException **   
請求中的其中一個參數無效。  
HTTP 狀態碼：400

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

## 另請參閱
<a name="API_CreateCodeSigningConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateCodeSigningConfig) 

# CreateEventSourceMapping
<a name="API_CreateEventSourceMapping"></a>

建立事件來源和 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)。設定為 infinite (-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) 

## 請求語法
<a name="API_CreateEventSourceMapping_RequestSyntax"></a>

```
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 請求參數
<a name="API_CreateEventSourceMapping_RequestParameters"></a>

請求不會使用任何 URI 參數。

## 請求主體
<a name="API_CreateEventSourceMapping_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [AmazonManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-AmazonManagedKafkaEventSourceConfig"></a>
Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件來源的具體組態設定。  
類型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 物件  
必要：否

 ** [BatchSize](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-BatchSize"></a>
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) **   <a name="lambda-CreateEventSourceMapping-request-BisectBatchOnFunctionError"></a>
(僅限 Kinesis 和 DynamoDB Streams) 如果函數傳回錯誤，將批次分割為兩個並重試。  
類型：布林值  
必要：否

 ** [DestinationConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-DestinationConfig"></a>
(僅限 Kinesis、DynamoDB Streams、Amazon MSK 和自我管理的 Kafka) 指定在 Lambda 處理過後事件目的地的組態物件。  
類型：[DestinationConfig](API_DestinationConfig.md) 物件  
必要：否

 ** [DocumentDBEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-DocumentDBEventSourceConfig"></a>
DocumentDB 事件來源的具體組態設定。  
類型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 物件  
必要：否

 ** [Enabled](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-Enabled"></a>
當為 true 時，則事件來源映射處於作用中狀態。當為 false 時，Lambda 會暫停輪詢與調用。  
預設：True  
類型：布林值  
必要：否

 ** [EventSourceArn](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-EventSourceArn"></a>
事件來源的 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。
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`  
必要：否

 ** [FilterCriteria](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-FilterCriteria"></a>
定義篩選條件標準的物件，用於決定 Lambda 是否應該處理事件。如需詳細資訊，請參閱 [Lambda 事件篩選](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。  
類型：[FilterCriteria](API_FilterCriteria.md) 物件  
必要：否

 ** [FunctionName](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-FunctionName"></a>
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) **   <a name="lambda-CreateEventSourceMapping-request-FunctionResponseTypes"></a>
(Kinesis、DynamoDB Streams 和 Amazon SQS) 套用至事件來源映射的目前回應類型列舉清單。  
類型：字串陣列  
陣列成員：項目數下限為 0。項目數上限為 1。  
有效值:`ReportBatchItemFailures`   
必要：否

 ** [MaximumBatchingWindowInSeconds](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-MaximumBatchingWindowInSeconds"></a>
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) **   <a name="lambda-CreateEventSourceMapping-request-MaximumRecordAgeInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) 捨棄超過指定存留期的記錄。預設值為無限 (-1)。  
類型：整數  
有效範圍：最小值為 -1。最大值為 604800。  
必要：否

 ** [MaximumRetryAttempts](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-MaximumRetryAttempts"></a>
(僅限 Kinesis 和 DynamoDB Streams) 在指定的重試次數之後捨棄記錄。預設值為無限 (-1)。設定為 infinite (-1) 時，系統會重試失敗的記錄，直到記錄到期為止。  
類型：整數  
有效範圍：最小值為 -1。最大值為 10000。  
必要：否

 ** [ParallelizationFactor](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-ParallelizationFactor"></a>
(僅限 Kinesis 和 DynamoDB Streams) 要從各個碎片同時處理的批次數。  
類型：整數  
有效範圍：最小值為 1。最大值為 10。  
必要：否

 ** [Queues](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-Queues"></a>
 (MQ) 要使用的 Amazon MQ 代理程式目的地佇列的名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 1000。  
模式：`[\s\S]*`  
必要：否

 ** [ScalingConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-ScalingConfig"></a>
(僅限 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) **   <a name="lambda-CreateEventSourceMapping-request-SelfManagedEventSource"></a>
用於接收記錄的自我管理 Apache Kafka 叢集。  
類型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 物件  
必要：否

 ** [SelfManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-SelfManagedKafkaEventSourceConfig"></a>
用於自我管理的 Apache Kafka 事件來源的具體組態設定。  
類型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 物件  
必要：否

 ** [SourceAccessConfigurations](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-SourceAccessConfigurations"></a>
保護事件來源所需的身分驗證協定或 VPC 元件。  
類型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 物件陣列  
陣列成員：項目數下限為 0。項目數上限為 22。  
必要：否

 ** [StartingPosition](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-StartingPosition"></a>
要從中開始讀取的串流位置。Amazon Kinesis 和 Amazon DynamoDB Stream 事件來源所必需。Amazon Kinesis 串流、Amazon DocumentDB、Amazon MSK 以及自我管理的 Apache Kafka 僅支援 `AT_TIMESTAMP`。  
類型：字串  
有效值:`TRIM_HORIZON | LATEST | AT_TIMESTAMP`   
必要：否

 ** [StartingPositionTimestamp](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-StartingPositionTimestamp"></a>
將 `StartingPosition` 設定為 `AT_TIMESTAMP`，這是開始讀取的時間 (以 Unix 時間秒為單位)。`StartingPositionTimestamp` 不能為未來的時間。  
類型：Timestamp  
必要：否

 ** [Topics](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-Topics"></a>
Kafka 主題名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 249。  
模式：`^[^.]([a-zA-Z0-9\-_.]+)`  
必要：否

 ** [TumblingWindowInSeconds](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-TumblingWindowInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) DynamoDB 和 Kinesis Streams 事件來源處理時段的持續時間 (以秒為單位)。值為 0 秒代表沒有輪轉時段。  
類型：整數  
有效範圍：最小值為 0。最大值為 900。  
必要：否

## 回應語法
<a name="API_CreateEventSourceMapping_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_CreateEventSourceMapping_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 202 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AmazonManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件來源的具體組態設定。  
類型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 物件

 ** [BatchSize](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-BatchSize"></a>
Lambda 從串流或佇列中提取並傳送至函數的每個批次中的記錄數目上限。Lambda 會將批次中的所有記錄以單一呼叫形式傳送至函數，直到達到同步調用的承載限制 (6 MB)。  
預設值：依服務而異。對於 Amazon SQS，預設值為 10。對於所有其他服務，預設值為 100。  
相關設定：當您將 `BatchSize` 設定為大於 10 的值時，必須將 `MaximumBatchingWindowInSeconds` 至少設定為 1。  
類型：整數  
有效範圍：最小值為 1。最大值為 10000。

 ** [BisectBatchOnFunctionError](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(僅限 Kinesis 和 DynamoDB Streams) 如果函數傳回錯誤，將批次分割為兩個並重試。預設值為 false。  
類型：布林值

 ** [DestinationConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-DestinationConfig"></a>
(僅限 Kinesis、DynamoDB Streams、Amazon MSK 和自我管理的 Apache 卡夫卡事件來源) 一種組態物件，可在 Lambda 處理事件後指定事件的目的地。  
類型：[DestinationConfig](API_DestinationConfig.md) 物件

 ** [DocumentDBEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
DocumentDB 事件來源的具體組態設定。  
類型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 物件

 ** [EventSourceArn](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-EventSourceArn"></a>
事件來源的 Amazon Resource Name (ARN)。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [FilterCriteria](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-FilterCriteria"></a>
定義篩選條件標準的物件，用於決定 Lambda 是否應該處理事件。如需詳細資訊，請參閱 [Lambda 事件篩選](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。  
類型：[FilterCriteria](API_FilterCriteria.md) 物件

 ** [FunctionArn](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-FunctionArn"></a>
Lambda 函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-CreateEventSourceMapping-response-FunctionResponseTypes"></a>
(Kinesis、DynamoDB Streams 和 Amazon SQS) 套用至事件來源映射的目前回應類型列舉清單。  
類型：字串陣列  
陣列成員：項目數下限為 0。項目數上限為 1。  
有效值:`ReportBatchItemFailures` 

 ** [LastModified](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-LastModified"></a>
上次更新事件來源映射或其狀態變更的日期 (以 Unix 時間秒為單位)。  
類型：Timestamp

 ** [LastProcessingResult](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-LastProcessingResult"></a>
函數的最後一次 Lambda 調用的結果。  
類型：字串

 ** [MaximumBatchingWindowInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
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) **   <a name="lambda-CreateEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) 捨棄超過指定存留期的記錄。預設值為 -1，這會將最大存留期設定為無限。當值設定為無限時，Lambda 永遠不會捨棄舊記錄。  
最大記錄保留期的最小有效值為 60 秒。雖然小於 60 且大於 -1 的值在參數的絕對範圍內，但不允許這些值
類型：整數  
有效範圍：最小值為 -1。最大值為 604800。

 ** [MaximumRetryAttempts](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-MaximumRetryAttempts"></a>
(僅限 Kinesis 和 DynamoDB Streams) 在指定的重試次數之後捨棄記錄。預設值為 -1，這會將重試數上限設定為無限。如果 MaximumRetryAttempts 是無限的，Lambda 會重試失敗的記錄，直到事件來源中的記錄到期為止。  
類型：整數  
有效範圍：最小值為 -1。最大值為 10000。

 ** [ParallelizationFactor](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-ParallelizationFactor"></a>
(僅限 Kinesis 和 DynamoDB Streams) 要從每個碎片中同時處理的批次數。預設值為 1。  
類型：整數  
有效範圍：最小值為 1。最大值為 10。

 ** [Queues](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-Queues"></a>
 (Amazon MQ) 要使用的 Amazon MQ 代理程式目的地佇列的名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 1000。  
模式：`[\s\S]*`

 ** [ScalingConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-ScalingConfig"></a>
(僅限 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) **   <a name="lambda-CreateEventSourceMapping-response-SelfManagedEventSource"></a>
用於事件來源的自我管理型 Apache Kafka 叢集。  
類型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 物件

 ** [SelfManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
用於自我管理的 Apache Kafka 事件來源的具體組態設定。  
類型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 物件

 ** [SourceAccessConfigurations](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-SourceAccessConfigurations"></a>
保護和定義事件來源的身分驗證協定、VPC 元件或虛擬主機。  
類型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 物件陣列  
陣列成員：項目數下限為 0。項目數上限為 22。

 ** [StartingPosition](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-StartingPosition"></a>
要從中開始讀取的串流位置。Amazon Kinesis 和 Amazon DynamoDB Stream 事件來源所必需。Amazon Kinesis 串流、Amazon DocumentDB、Amazon MSK 以及自我管理的 Apache Kafka 僅支援 `AT_TIMESTAMP`。  
類型：字串  
有效值:`TRIM_HORIZON | LATEST | AT_TIMESTAMP` 

 ** [StartingPositionTimestamp](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-StartingPositionTimestamp"></a>
將 `StartingPosition` 設定為 `AT_TIMESTAMP`，這是開始讀取的時間 (以 Unix 時間秒為單位)。`StartingPositionTimestamp` 不能為未來的時間。  
類型：Timestamp

 ** [State](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-State"></a>
事件來源映射的狀態。可為下列其中之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。  
類型：字串

 ** [StateTransitionReason](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-StateTransitionReason"></a>
指出使用者或 Lambda 是否對事件來源映射進行最後的變更。  
類型：字串

 ** [Topics](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-Topics"></a>
Kafka 主題名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 249。  
模式：`^[^.]([a-zA-Z0-9\-_.]+)`

 ** [TumblingWindowInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-TumblingWindowInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) DynamoDB 和 Kinesis Streams 事件來源處理時段的持續時間 (以秒為單位)。值為 0 秒代表沒有輪轉時段。  
類型：整數  
有效範圍：最小值為 0。最大值為 900。

 ** [UUID](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-UUID"></a>
事件來源映射的識別符。  
類型：字串

## 錯誤
<a name="API_CreateEventSourceMapping_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_CreateEventSourceMapping_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateEventSourceMapping) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateEventSourceMapping) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateEventSourceMapping) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateEventSourceMapping) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateEventSourceMapping) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateEventSourceMapping) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateEventSourceMapping) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateEventSourceMapping) 

# CreateFunction
<a name="API_CreateFunction"></a>

建立 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 服務，例如用於 CloudWatch 日誌串流和請求追蹤AWS X-Ray的 Amazon Logs。

如果部署套件是[容器映像](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 政策來授予許可。您可以在版本或別名的函數層級授予許可。

若要直接調用函數，請使用 [Invoke](API_Invoke.md)。若要調用函數以回應其他 AWS 服務 中的事件，請建立事件來源映射 ([CreateEventSourceMapping](API_CreateEventSourceMapping.md))，或在其他服務中設定函數觸發條件。如需詳細資訊，請參閱[調用 Lambda 函數](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html)。

## 請求語法
<a name="API_CreateFunction_RequestSyntax"></a>

```
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 請求參數
<a name="API_CreateFunction_RequestParameters"></a>

請求不會使用任何 URI 參數。

## 請求主體
<a name="API_CreateFunction_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [Architectures](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Architectures"></a>
函數支援的指令集架構。輸入具有其中一個有效值 (arm64 或 x86\$164) 的字串陣列。預設值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64`   
必要：否

 ** [Code](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Code"></a>
函數的程式碼。  
類型：[FunctionCode](API_FunctionCode.md) 物件  
必要：是

 ** [CodeSigningConfigArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-CodeSigningConfigArn"></a>
若要啟用此函數的程式碼簽章，請指定程式碼簽署組態的 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) **   <a name="lambda-CreateFunction-request-DeadLetterConfig"></a>
無效字母佇列組態，可指定在處理失敗時，Lambda 傳送的非同步事件的佇列或主題。如需詳細資訊，請參閱[無效字母佇列](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq)。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件  
必要：否

 ** [Description](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Description"></a>
函數的敘述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

 ** [Environment](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Environment"></a>
環境變數，可在執行期間透過函數程式碼取得。  
類型：[Environment](API_Environment.md) 物件  
必要：否

 ** [EphemeralStorage](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-EphemeralStorage"></a>
函數的 `/tmp` 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱[設定暫時性儲存 (主控台)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。  
類型：[EphemeralStorage](API_EphemeralStorage.md) 物件  
必要：否

 ** [FileSystemConfigs](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FileSystemConfigs"></a>
Amazon EFS 檔案系統的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。  
必要：否

 ** [FunctionName](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FunctionName"></a>
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) **   <a name="lambda-CreateFunction-request-Handler"></a>
程式碼中的方法名稱，Lambda 會呼叫此程式碼來執行您的函數。如果部署套件是 .zip 檔案封存，則需要處理常式。格式包含檔案名稱。它也可以包含命名空間和其他限定詞，取決於執行時間。如需詳細資訊，請參閱 [Lambda 程式設計模型](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html)。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`  
必要：否

 ** [ImageConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-ImageConfig"></a>
容器映像[組態值](https://docs.aws.amazon.com/lambda/latest/dg/configuration-images.html#configuration-images-settings)，它們會覆寫容器映像 Dockerfile 中的值。  
類型：[ImageConfig](API_ImageConfig.md) 物件  
必要：否

 ** [KMSKeyArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-KMSKeyArn"></a>
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 會使用預設服務金鑰。  
類型：String  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`  
必要：否

 ** [Layers](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Layers"></a>
要新增到函數執行環境的[函數 Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。依 ARN 指定每個 layer (包括版本)。  
類型：字串陣列  
長度限制：長度下限為 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) **   <a name="lambda-CreateFunction-request-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件  
必要：否

 ** [MemorySize](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-MemorySize"></a>
[可供函數在執行階段使用的記憶體量](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) **   <a name="lambda-CreateFunction-request-PackageType"></a>
部署套件的類型。為容器映像設定為 `Image`，並為 .zip 封存檔設為 `Zip`。  
類型：字串  
有效值:`Zip | Image`   
必要：否

 ** [Publish](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Publish"></a>
設為 true，以在建立期間發佈函數的第一個版本。  
類型：布林值  
必要：否

 ** [Role](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Role"></a>
函數執行角色的 Amazon Resource Name (ARN)。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：是

 ** [Runtime](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Runtime"></a>
函數的[執行時間](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) **   <a name="lambda-CreateFunction-request-SnapStart"></a>
功能的[SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)設定。  
類型：[SnapStart](API_SnapStart.md) 物件  
必要：否

 ** [Tags](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Tags"></a>
要套用到函數的[標籤](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)清單。  
類型：字串到字串映射  
必要：否

 ** [Timeout](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。預設為 3 秒。允許的最大值為 900 秒。如需詳細資訊，請參閱 [Lambda 執行環境](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html)。  
類型：整數  
有效範圍：最小值為 1。  
必要：否

 ** [TracingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-TracingConfig"></a>
將 `Mode` 設為 `Active`，使用 [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) 取樣及追蹤一部分的傳入請求。  
類型：[TracingConfig](API_TracingConfig.md) 物件  
必要：否

 ** [VpcConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-VpcConfig"></a>
對於 VPC 中 AWS 資源的網路連線，指定 VPC 中安全群組和子網路的清單。將函數連接到 VPC 時，只能透過該 VPC 存取資源和網際網路。如需詳細資訊，請參閱[設定 Lambda 函數以存取 VPC 中的資源](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html)。  
類型：[VpcConfig](API_VpcConfig.md) 物件  
必要：否

## 回應語法
<a name="API_CreateFunction_ResponseSyntax"></a>

```
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"
   }
}
```

## 回應元素
<a name="API_CreateFunction_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Architectures](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Architectures"></a>
函數支援的指令集架構。架構是具有其中一個有效值的字串陣列。預設架構值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64` 

 ** [CodeSha256](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSha256"></a>
函數部署套件的 SHA256 雜湊。  
類型：字串

 ** [CodeSize](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSize"></a>
函數部署套件的大小 (以位元組為單位)。  
類型：Long

 ** [DeadLetterConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-DeadLetterConfig"></a>
函數的無效字母佇列。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件

 ** [Description](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Description"></a>
函數的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [Environment](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Environment"></a>
函數的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。從 AWS CloudTrail 日誌中省略。  
類型：[EnvironmentResponse](API_EnvironmentResponse.md) 物件

 ** [EphemeralStorage](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-EphemeralStorage"></a>
函數的 `/tmp` 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱[設定暫時性儲存 (主控台)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。  
類型：[EphemeralStorage](API_EphemeralStorage.md) 物件

 ** [FileSystemConfigs](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FileSystemConfigs"></a>
[Amazon EFS 檔案系統](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。

 ** [FunctionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-CreateFunction-response-FunctionName"></a>
函數的名稱。  
類型：字串  
長度限制：長度下限為 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) **   <a name="lambda-CreateFunction-response-Handler"></a>
Lambda 為了開始執行您的函數所呼叫的函數。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`

 ** [ImageConfigResponse](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-ImageConfigResponse"></a>
函數的映像組態值。  
類型：[ImageConfigResponse](API_ImageConfigResponse.md) 物件

 ** [KMSKeyArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-KMSKeyArn"></a>
用來加密函數[環境變數](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) 時，也會使用此金鑰來加密函數的快照集。只有在您已設定客戶受管金鑰的情況下，才會傳回此金鑰。  
類型：String  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`

 ** [LastModified](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastModified"></a>
上次更新函數的日期和時間，採用 [ISO-8601](https://www.w3.org/TR/NOTE-datetime) 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [LastUpdateStatus](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatus"></a>
對函數執行的上次更新的狀態。這是在函數建立完成後首次設定為 `Successful`。  
類型：字串  
有效值:`Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReason"></a>
對函數執行的上次更新的原因。  
類型：字串

 ** [LastUpdateStatusReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReasonCode"></a>
對函數執行的上次更新的原因代碼。  
類型：字串  
有效值:`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) **   <a name="lambda-CreateFunction-response-Layers"></a>
函數的[層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。  
類型：[Layer](API_Layer.md) 物件陣列

 ** [LoggingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件

 ** [MasterArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MasterArn"></a>
若是 Lambda@Edge 函數，則為主函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-CreateFunction-response-MemorySize"></a>
可供函數在執行階段使用的記憶體量。  
類型：整數  
有效範圍：最小值為 128。最大值為 10240。

 ** [PackageType](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-PackageType"></a>
部署套件的類型。針對容器影像設定為 `Image`，並針對 .zip 檔案封存設定 `Zip`。  
類型：字串  
有效值:`Zip | Image` 

 ** [RevisionId](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RevisionId"></a>
函數或別名的最新更新修訂版。  
類型：字串

 ** [Role](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Role"></a>
函數的執行角色。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`

 ** [Runtime](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Runtime"></a>
函數的[執行時間](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) **   <a name="lambda-CreateFunction-response-RuntimeVersionConfig"></a>
執行階段的 ARN 和任何發生的錯誤。  
類型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 物件

 ** [SigningJobArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningJobArn"></a>
簽署任務的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SigningProfileVersionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningProfileVersionArn"></a>
簽署描述檔版本的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SnapStart](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SnapStart"></a>
將 `ApplyOn` 設為 `PublishedVersions`，即可在您發佈函數版本時建立初始化執行環境的快照。如需詳細資訊，請參閱[使用 Lambda 改善啟動效能 SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)。  
類型：[SnapStartResponse](API_SnapStartResponse.md) 物件

 ** [State](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-State"></a>
函數目前的狀態。當狀態為 `Inactive` 時，您可以透過調用它來重新激活該函數。  
類型：字串  
有效值:`Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReason"></a>
函數目前狀態的原因。  
類型：字串

 ** [StateReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReasonCode"></a>
函數目前狀態的原因代碼。當代碼為 `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) **   <a name="lambda-CreateFunction-response-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。  
類型：整數  
有效範圍：最小值為 1。

 ** [TracingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-TracingConfig"></a>
函數的 AWS X-Ray 追蹤組態。  
類型：[TracingConfigResponse](API_TracingConfigResponse.md) 物件

 ** [Version](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Version"></a>
Lambda 函數的版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [VpcConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-VpcConfig"></a>
函數的聯網設定。  
類型：[VpcConfigResponse](API_VpcConfigResponse.md) 物件

## 錯誤
<a name="API_CreateFunction_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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 **   
程式碼簽章無法進行完整性檢查。如果完整性檢查失敗，即使程式碼簽署政策設定為 WARN，Lambda 仍會阻止部署。  
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

## 另請參閱
<a name="API_CreateFunction_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateFunction) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateFunction) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunction) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunction) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunction) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunction) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunction) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunction) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunction) 

# CreateFunctionUrlConfig
<a name="API_CreateFunctionUrlConfig"></a>

使用指定的設定參數建立 Lambda 函數 URL。函數 URL 是可用來呼叫函數的專用 HTTP(S) 端點。

## 請求語法
<a name="API_CreateFunctionUrlConfig_RequestSyntax"></a>

```
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 請求參數
<a name="API_CreateFunctionUrlConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-FunctionName"></a>
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) **   <a name="lambda-CreateFunctionUrlConfig-request-Qualifier"></a>
別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))`

## 請求主體
<a name="API_CreateFunctionUrlConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [AuthType](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-AuthType"></a>
函數 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) **   <a name="lambda-CreateFunctionUrlConfig-request-Cors"></a>
函數 URL 的[跨來源資源共享 (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 設定。  
類型：[Cors](API_Cors.md) 物件  
必要：否

 ** [InvokeMode](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-InvokeMode"></a>
使用下列其中一個選項：  
+  `BUFFERED` – 此為預設選項。Lambda 會使用 `Invoke` API 操作調用您的函數。承載完成時，即可使用調用結果。承載大小上限為 6 MB。
+  `RESPONSE_STREAM` – 當承載結果變得可用時，函數會串流它們。Lambda 會使用 `InvokeWithResponseStream` API 操作調用您的函數。回應承載大小上限為 20 MB，不過，您可以[請求增加配額](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。
類型：字串  
有效值:`BUFFERED | RESPONSE_STREAM`   
必要：否

## 回應語法
<a name="API_CreateFunctionUrlConfig_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_CreateFunctionUrlConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AuthType](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-AuthType"></a>
函數 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) **   <a name="lambda-CreateFunctionUrlConfig-response-Cors"></a>
函數 URL 的[跨來源資源共享 (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 設定。  
類型：[Cors](API_Cors.md) 物件

 ** [CreationTime](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-CreationTime"></a>
建立函數 URL 時使用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [FunctionArn](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-CreateFunctionUrlConfig-response-FunctionUrl"></a>
函數的 HTTP URL 端點。  
類型：字串  
長度限制：長度下限為 40。長度上限為 100。

 ** [InvokeMode](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-InvokeMode"></a>
使用下列其中一個選項：  
+  `BUFFERED` – 此為預設選項。Lambda 會使用 `Invoke` API 操作調用您的函數。承載完成時，即可使用調用結果。承載大小上限為 6 MB。
+  `RESPONSE_STREAM` – 當承載結果變得可用時，函數會串流它們。Lambda 會使用 `InvokeWithResponseStream` API 操作調用您的函數。回應承載大小上限為 20 MB，不過，您可以[請求增加配額](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。
類型：字串  
有效值:`BUFFERED | RESPONSE_STREAM` 

## 錯誤
<a name="API_CreateFunctionUrlConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_CreateFunctionUrlConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunctionUrlConfig) 

# DeleteAlias
<a name="API_DeleteAlias"></a>

刪除 Lambda 函數[別名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)。

## 請求語法
<a name="API_DeleteAlias_RequestSyntax"></a>

```
DELETE /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteAlias_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_DeleteAlias_RequestSyntax) **   <a name="lambda-DeleteAlias-request-FunctionName"></a>
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) **   <a name="lambda-DeleteAlias-request-Name"></a>
別名的名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)`  
必要：是

## 請求主體
<a name="API_DeleteAlias_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteAlias_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteAlias_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteAlias_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_DeleteAlias_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteAlias) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteAlias) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteAlias) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteAlias) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteAlias) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteAlias) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteAlias) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteAlias) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteAlias) 

# DeleteCodeSigningConfig
<a name="API_DeleteCodeSigningConfig"></a>

刪除程式碼簽署組態。只有在沒有任何函數使用的情況下，才能刪除程式碼簽署組態。

## 請求語法
<a name="API_DeleteCodeSigningConfig_RequestSyntax"></a>

```
DELETE /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteCodeSigningConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [CodeSigningConfigArn](#API_DeleteCodeSigningConfig_RequestSyntax) **   <a name="lambda-DeleteCodeSigningConfig-request-CodeSigningConfigArn"></a>
程式碼簽署組態的 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}`  
必要：是

## 請求主體
<a name="API_DeleteCodeSigningConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteCodeSigningConfig_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteCodeSigningConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** InvalidParameterValueException **   
請求中的其中一個參數無效。  
HTTP 狀態碼：400

 ** ResourceConflictException **   
資源已存在，或另一個操作正在進行中。  
HTTP 狀態碼：409

 ** ResourceNotFoundException **   
請求中指定的資源不存在。  
HTTP 狀態碼：404

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

## 另請參閱
<a name="API_DeleteCodeSigningConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteCodeSigningConfig) 

# DeleteEventSourceMapping
<a name="API_DeleteEventSourceMapping"></a>

刪除[事件來源映射](https://docs.aws.amazon.com/lambda/latest/dg/intro-invocation-modes.html)。您可以從 [ListEventSourceMappings](API_ListEventSourceMappings.md) 的輸出中獲取映射的識別符。

當您刪除事件來源映射時，它會進入 `Deleting` 狀態，並且可能在幾秒鐘內不會完全刪除。

## 請求語法
<a name="API_DeleteEventSourceMapping_RequestSyntax"></a>

```
DELETE /2015-03-31/event-source-mappings/UUID HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteEventSourceMapping_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [UUID](#API_DeleteEventSourceMapping_RequestSyntax) **   <a name="lambda-DeleteEventSourceMapping-request-UUID"></a>
事件來源映射的識別符。  
必要：是

## 請求主體
<a name="API_DeleteEventSourceMapping_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteEventSourceMapping_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_DeleteEventSourceMapping_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 202 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AmazonManagedKafkaEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件來源的具體組態設定。  
類型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 物件

 ** [BatchSize](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-BatchSize"></a>
Lambda 從串流或佇列中提取並傳送至函數的每個批次中的記錄數目上限。Lambda 會將批次中的所有記錄以單一呼叫形式傳送至函數，直到達到同步調用的承載限制 (6 MB)。  
預設值：依服務而異。對於 Amazon SQS，預設值為 10。對於所有其他服務，預設值為 100。  
相關設定：當您將 `BatchSize` 設定為大於 10 的值時，必須將 `MaximumBatchingWindowInSeconds` 至少設定為 1。  
類型：整數  
有效範圍：最小值為 1。最大值為 10000。

 ** [BisectBatchOnFunctionError](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(僅限 Kinesis 和 DynamoDB Streams) 如果函數傳回錯誤，將批次分割為兩個並重試。預設值為 false。  
類型：布林值

 ** [DestinationConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-DestinationConfig"></a>
(僅限 Kinesis、DynamoDB Streams、Amazon MSK 和自我管理的 Apache 卡夫卡事件來源) 一種組態物件，可在 Lambda 處理事件後指定事件的目的地。  
類型：[DestinationConfig](API_DestinationConfig.md) 物件

 ** [DocumentDBEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
DocumentDB 事件來源的具體組態設定。  
類型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 物件

 ** [EventSourceArn](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-EventSourceArn"></a>
事件來源的 Amazon Resource Name (ARN)。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [FilterCriteria](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-FilterCriteria"></a>
定義篩選條件標準的物件，用於決定 Lambda 是否應該處理事件。如需詳細資訊，請參閱 [Lambda 事件篩選](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。  
類型：[FilterCriteria](API_FilterCriteria.md) 物件

 ** [FunctionArn](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-FunctionArn"></a>
Lambda 函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-DeleteEventSourceMapping-response-FunctionResponseTypes"></a>
(Kinesis、DynamoDB Streams 和 Amazon SQS) 套用至事件來源映射的目前回應類型列舉清單。  
類型：字串陣列  
陣列成員：項目數下限為 0。項目數上限為 1。  
有效值:`ReportBatchItemFailures` 

 ** [LastModified](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-LastModified"></a>
上次更新事件來源映射或其狀態變更的日期 (以 Unix 時間秒為單位)。  
類型：Timestamp

 ** [LastProcessingResult](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-LastProcessingResult"></a>
函數的最後一次 Lambda 調用的結果。  
類型：字串

 ** [MaximumBatchingWindowInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
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) **   <a name="lambda-DeleteEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) 捨棄超過指定存留期的記錄。預設值為 -1，這會將最大存留期設定為無限。當值設定為無限時，Lambda 永遠不會捨棄舊記錄。  
最大記錄保留期的最小有效值為 60 秒。雖然小於 60 且大於 -1 的值在參數的絕對範圍內，但不允許這些值
類型：整數  
有效範圍：最小值為 -1。最大值為 604800。

 ** [MaximumRetryAttempts](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-MaximumRetryAttempts"></a>
(僅限 Kinesis 和 DynamoDB Streams) 在指定的重試次數之後捨棄記錄。預設值為 -1，這會將重試數上限設定為無限。如果 MaximumRetryAttempts 是無限的，Lambda 會重試失敗的記錄，直到事件來源中的記錄到期為止。  
類型：整數  
有效範圍：最小值為 -1。最大值為 10000。

 ** [ParallelizationFactor](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-ParallelizationFactor"></a>
(僅限 Kinesis 和 DynamoDB Streams) 要從每個碎片中同時處理的批次數。預設值為 1。  
類型：整數  
有效範圍：最小值為 1。最大值為 10。

 ** [Queues](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-Queues"></a>
 (Amazon MQ) 要使用的 Amazon MQ 代理程式目的地佇列的名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 1000。  
模式：`[\s\S]*`

 ** [ScalingConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-ScalingConfig"></a>
(僅限 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) **   <a name="lambda-DeleteEventSourceMapping-response-SelfManagedEventSource"></a>
用於事件來源的自我管理型 Apache Kafka 叢集。  
類型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 物件

 ** [SelfManagedKafkaEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
用於自我管理的 Apache Kafka 事件來源的具體組態設定。  
類型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 物件

 ** [SourceAccessConfigurations](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-SourceAccessConfigurations"></a>
保護和定義事件來源的身分驗證協定、VPC 元件或虛擬主機。  
類型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 物件陣列  
陣列成員：項目數下限為 0。項目數上限為 22。

 ** [StartingPosition](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-StartingPosition"></a>
要從中開始讀取的串流位置。Amazon Kinesis 和 Amazon DynamoDB Stream 事件來源所必需。Amazon Kinesis 串流、Amazon DocumentDB、Amazon MSK 以及自我管理的 Apache Kafka 僅支援 `AT_TIMESTAMP`。  
類型：字串  
有效值:`TRIM_HORIZON | LATEST | AT_TIMESTAMP` 

 ** [StartingPositionTimestamp](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-StartingPositionTimestamp"></a>
將 `StartingPosition` 設定為 `AT_TIMESTAMP`，這是開始讀取的時間 (以 Unix 時間秒為單位)。`StartingPositionTimestamp` 不能為未來的時間。  
類型：Timestamp

 ** [State](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-State"></a>
事件來源映射的狀態。可為下列其中之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。  
類型：字串

 ** [StateTransitionReason](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-StateTransitionReason"></a>
指出使用者或 Lambda 是否對事件來源映射進行最後的變更。  
類型：字串

 ** [Topics](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-Topics"></a>
Kafka 主題名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 249。  
模式：`^[^.]([a-zA-Z0-9\-_.]+)`

 ** [TumblingWindowInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-TumblingWindowInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) DynamoDB 和 Kinesis Streams 事件來源處理時段的持續時間 (以秒為單位)。值為 0 秒代表沒有輪轉時段。  
類型：整數  
有效範圍：最小值為 0。最大值為 900。

 ** [UUID](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-UUID"></a>
事件來源映射的識別符。  
類型：字串

## 錯誤
<a name="API_DeleteEventSourceMapping_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_DeleteEventSourceMapping_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteEventSourceMapping) 

# DeleteFunction
<a name="API_DeleteFunction"></a>

刪除 Lambda 函數。若要刪除特定函數版本，請使用 `Qualifier` 參數。否則，會刪除所有版本和別名。這不需要使用者擁有明確的 [DeleteAlias](API_DeleteAlias.md) 許可。

若要刪除叫用函數的 Lambda 事件來源映射，請使用 [DeleteEventSourceMapping](API_DeleteEventSourceMapping.md)。對於直接叫用函數的 AWS 服務 和資源，請在您原來設定的服務中刪除觸發條件。

## 請求語法
<a name="API_DeleteFunction_RequestSyntax"></a>

```
DELETE /2015-03-31/functions/FunctionName?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteFunction_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_DeleteFunction_RequestSyntax) **   <a name="lambda-DeleteFunction-request-FunctionName"></a>
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) **   <a name="lambda-DeleteFunction-request-Qualifier"></a>
指定要刪除的版本。您無法刪除別名所參考的版本。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_DeleteFunction_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteFunction_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteFunction_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteFunction_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_DeleteFunction_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunction) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunction) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunction) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunction) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunction) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunction) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunction) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunction) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunction) 

# DeleteFunctionCodeSigningConfig
<a name="API_DeleteFunctionCodeSigningConfig"></a>

從函數中移除程式碼簽署組態。

## 請求語法
<a name="API_DeleteFunctionCodeSigningConfig_RequestSyntax"></a>

```
DELETE /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteFunctionCodeSigningConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_DeleteFunctionCodeSigningConfig_RequestSyntax) **   <a name="lambda-DeleteFunctionCodeSigningConfig-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_DeleteFunctionCodeSigningConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteFunctionCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteFunctionCodeSigningConfig_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteFunctionCodeSigningConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_DeleteFunctionCodeSigningConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 

# DeleteFunctionConcurrency
<a name="API_DeleteFunctionConcurrency"></a>

從函數中移除並行執行限制。

## 請求語法
<a name="API_DeleteFunctionConcurrency_RequestSyntax"></a>

```
DELETE /2017-10-31/functions/FunctionName/concurrency HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteFunctionConcurrency_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_DeleteFunctionConcurrency_RequestSyntax) **   <a name="lambda-DeleteFunctionConcurrency-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_DeleteFunctionConcurrency_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteFunctionConcurrency_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteFunctionConcurrency_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteFunctionConcurrency_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_DeleteFunctionConcurrency_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionConcurrency) 

# DeleteFunctionEventInvokeConfig
<a name="API_DeleteFunctionEventInvokeConfig"></a>

刪除函數、版本或別名的非同步叫用的組態。

若要設定非同步叫用選項，請使用 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)。

## 請求語法
<a name="API_DeleteFunctionEventInvokeConfig_RequestSyntax"></a>

```
DELETE /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteFunctionEventInvokeConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_DeleteFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-DeleteFunctionEventInvokeConfig-request-FunctionName"></a>
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) **   <a name="lambda-DeleteFunctionEventInvokeConfig-request-Qualifier"></a>
版本號或別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_DeleteFunctionEventInvokeConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteFunctionEventInvokeConfig_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteFunctionEventInvokeConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_DeleteFunctionEventInvokeConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 

# DeleteFunctionUrlConfig
<a name="API_DeleteFunctionUrlConfig"></a>

刪除 Lambda 函數 URL。函數 URL 刪除後便無法復原。建立新函數 URL 會產生不同的 URL 地址。

## 請求語法
<a name="API_DeleteFunctionUrlConfig_RequestSyntax"></a>

```
DELETE /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteFunctionUrlConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_DeleteFunctionUrlConfig_RequestSyntax) **   <a name="lambda-DeleteFunctionUrlConfig-request-FunctionName"></a>
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) **   <a name="lambda-DeleteFunctionUrlConfig-request-Qualifier"></a>
別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))`

## 請求主體
<a name="API_DeleteFunctionUrlConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteFunctionUrlConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteFunctionUrlConfig_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteFunctionUrlConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_DeleteFunctionUrlConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionUrlConfig) 

# DeleteLayerVersion
<a name="API_DeleteLayerVersion"></a>

刪除 [AWS Lambda 層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的一個版本。無法再檢視已刪除的版本或新增至函數。為了避免中斷函數，版本的副本會保留在 Lambda 中，直到沒有函數參考它。

## 請求語法
<a name="API_DeleteLayerVersion_RequestSyntax"></a>

```
DELETE /2018-10-31/layers/LayerName/versions/VersionNumber HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteLayerVersion_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [LayerName](#API_DeleteLayerVersion_RequestSyntax) **   <a name="lambda-DeleteLayerVersion-request-LayerName"></a>
layer 的名稱或 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) **   <a name="lambda-DeleteLayerVersion-request-VersionNumber"></a>
版本號碼。  
必要：是

## 請求主體
<a name="API_DeleteLayerVersion_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteLayerVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteLayerVersion_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteLayerVersion_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

 ** TooManyRequestsException **   
超出請求輸送量限制。如需詳細資訊，請參閱 [Lambda 配額](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。  
HTTP 狀態碼：429

## 另請參閱
<a name="API_DeleteLayerVersion_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteLayerVersion) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteLayerVersion) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteLayerVersion) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteLayerVersion) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteLayerVersion) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteLayerVersion) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteLayerVersion) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteLayerVersion) 

# DeleteProvisionedConcurrencyConfig
<a name="API_DeleteProvisionedConcurrencyConfig"></a>

刪除函數的佈建並行組態。

## 請求語法
<a name="API_DeleteProvisionedConcurrencyConfig_RequestSyntax"></a>

```
DELETE /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteProvisionedConcurrencyConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_DeleteProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-DeleteProvisionedConcurrencyConfig-request-FunctionName"></a>
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) **   <a name="lambda-DeleteProvisionedConcurrencyConfig-request-Qualifier"></a>
版本號或別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`  
必要：是

## 請求主體
<a name="API_DeleteProvisionedConcurrencyConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteProvisionedConcurrencyConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteProvisionedConcurrencyConfig_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteProvisionedConcurrencyConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_DeleteProvisionedConcurrencyConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 

# GetAccountSettings
<a name="API_GetAccountSettings"></a>

擷取有關帳戶[限制](https://docs.aws.amazon.com/lambda/latest/dg/limits.html)和 AWS 區域使用情況的詳細資訊。

## 請求語法
<a name="API_GetAccountSettings_RequestSyntax"></a>

```
GET /2016-08-19/account-settings/ HTTP/1.1
```

## URI 請求參數
<a name="API_GetAccountSettings_RequestParameters"></a>

請求不會使用任何 URI 參數。

## 請求主體
<a name="API_GetAccountSettings_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetAccountSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountLimit": { 
      "CodeSizeUnzipped": number,
      "CodeSizeZipped": number,
      "ConcurrentExecutions": number,
      "TotalCodeSize": number,
      "UnreservedConcurrentExecutions": number
   },
   "AccountUsage": { 
      "FunctionCount": number,
      "TotalCodeSize": number
   }
}
```

## 回應元素
<a name="API_GetAccountSettings_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AccountLimit](#API_GetAccountSettings_ResponseSyntax) **   <a name="lambda-GetAccountSettings-response-AccountLimit"></a>
與並行和程式碼儲存相關的限制。  
類型：[AccountLimit](API_AccountLimit.md) 物件

 ** [AccountUsage](#API_GetAccountSettings_ResponseSyntax) **   <a name="lambda-GetAccountSettings-response-AccountUsage"></a>
函數的數量和使用中的儲存量。  
類型：[AccountUsage](API_AccountUsage.md) 物件

## 錯誤
<a name="API_GetAccountSettings_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

 ** TooManyRequestsException **   
超出請求輸送量限制。如需詳細資訊，請參閱 [Lambda 配額](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。  
HTTP 狀態碼：429

## 另請參閱
<a name="API_GetAccountSettings_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetAccountSettings) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetAccountSettings) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetAccountSettings) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetAccountSettings) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetAccountSettings) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetAccountSettings) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetAccountSettings) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetAccountSettings) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetAccountSettings) 

# GetAlias
<a name="API_GetAlias"></a>

傳回有關 Lambda 函數[別名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)的詳細資訊。

## 請求語法
<a name="API_GetAlias_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1
```

## URI 請求參數
<a name="API_GetAlias_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetAlias_RequestSyntax) **   <a name="lambda-GetAlias-request-FunctionName"></a>
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) **   <a name="lambda-GetAlias-request-Name"></a>
別名的名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)`  
必要：是

## 請求主體
<a name="API_GetAlias_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetAlias_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## 回應元素
<a name="API_GetAlias_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AliasArn](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-AliasArn"></a>
別名的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-GetAlias-response-Description"></a>
別名的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [FunctionVersion](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-FunctionVersion"></a>
別名呼叫的函數版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [Name](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-Name"></a>
別名的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)`

 ** [RevisionId](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-RevisionId"></a>
當您更新別名時，會變更的唯一識別符。  
類型：字串

 ** [RoutingConfig](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-RoutingConfig"></a>
別名的[路由組態](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html)。  
類型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 物件

## 錯誤
<a name="API_GetAlias_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetAlias_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetAlias) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetAlias) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetAlias) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetAlias) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetAlias) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetAlias) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetAlias) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetAlias) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetAlias) 

# GetCodeSigningConfig
<a name="API_GetCodeSigningConfig"></a>

傳回指定程式碼簽署組態的相關資訊。

## 請求語法
<a name="API_GetCodeSigningConfig_RequestSyntax"></a>

```
GET /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1
```

## URI 請求參數
<a name="API_GetCodeSigningConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [CodeSigningConfigArn](#API_GetCodeSigningConfig_RequestSyntax) **   <a name="lambda-GetCodeSigningConfig-request-CodeSigningConfigArn"></a>
程式碼簽署組態的 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}`  
必要：是

## 請求主體
<a name="API_GetCodeSigningConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfig": { 
      "AllowedPublishers": { 
         "SigningProfileVersionArns": [ "string" ]
      },
      "CodeSigningConfigArn": "string",
      "CodeSigningConfigId": "string",
      "CodeSigningPolicies": { 
         "UntrustedArtifactOnDeployment": "string"
      },
      "Description": "string",
      "LastModified": "string"
   }
}
```

## 回應元素
<a name="API_GetCodeSigningConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CodeSigningConfig](#API_GetCodeSigningConfig_ResponseSyntax) **   <a name="lambda-GetCodeSigningConfig-response-CodeSigningConfig"></a>
程式碼簽署組態  
類型：[CodeSigningConfig](API_CodeSigningConfig.md) 物件

## 錯誤
<a name="API_GetCodeSigningConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** InvalidParameterValueException **   
請求中的其中一個參數無效。  
HTTP 狀態碼：400

 ** ResourceNotFoundException **   
請求中指定的資源不存在。  
HTTP 狀態碼：404

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

## 另請參閱
<a name="API_GetCodeSigningConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetCodeSigningConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetCodeSigningConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetCodeSigningConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetCodeSigningConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetCodeSigningConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetCodeSigningConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetCodeSigningConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetCodeSigningConfig) 

# GetEventSourceMapping
<a name="API_GetEventSourceMapping"></a>

傳回有關事件來源映射的詳細資訊。您可以從 [ListEventSourceMappings](API_ListEventSourceMappings.md) 的輸出中獲取映射的識別符。

## 請求語法
<a name="API_GetEventSourceMapping_RequestSyntax"></a>

```
GET /2015-03-31/event-source-mappings/UUID HTTP/1.1
```

## URI 請求參數
<a name="API_GetEventSourceMapping_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [UUID](#API_GetEventSourceMapping_RequestSyntax) **   <a name="lambda-GetEventSourceMapping-request-UUID"></a>
事件來源映射的識別符。  
必要：是

## 請求主體
<a name="API_GetEventSourceMapping_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetEventSourceMapping_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_GetEventSourceMapping_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AmazonManagedKafkaEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件來源的具體組態設定。  
類型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 物件

 ** [BatchSize](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-BatchSize"></a>
Lambda 從串流或佇列中提取並傳送至函數的每個批次中的記錄數目上限。Lambda 會將批次中的所有記錄以單一呼叫形式傳送至函數，直到達到同步調用的承載限制 (6 MB)。  
預設值：依服務而異。對於 Amazon SQS，預設值為 10。對於所有其他服務，預設值為 100。  
相關設定：當您將 `BatchSize` 設定為大於 10 的值時，必須將 `MaximumBatchingWindowInSeconds` 至少設定為 1。  
類型：整數  
有效範圍：最小值為 1。最大值為 10000。

 ** [BisectBatchOnFunctionError](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(僅限 Kinesis 和 DynamoDB Streams) 如果函數傳回錯誤，將批次分割為兩個並重試。預設值為 false。  
類型：布林值

 ** [DestinationConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-DestinationConfig"></a>
(僅限 Kinesis、DynamoDB Streams、Amazon MSK 和自我管理的 Apache 卡夫卡事件來源) 一種組態物件，可在 Lambda 處理事件後指定事件的目的地。  
類型：[DestinationConfig](API_DestinationConfig.md) 物件

 ** [DocumentDBEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
DocumentDB 事件來源的具體組態設定。  
類型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 物件

 ** [EventSourceArn](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-EventSourceArn"></a>
事件來源的 Amazon Resource Name (ARN)。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [FilterCriteria](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FilterCriteria"></a>
定義篩選條件標準的物件，用於決定 Lambda 是否應該處理事件。如需詳細資訊，請參閱 [Lambda 事件篩選](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。  
類型：[FilterCriteria](API_FilterCriteria.md) 物件

 ** [FunctionArn](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FunctionArn"></a>
Lambda 函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-GetEventSourceMapping-response-FunctionResponseTypes"></a>
(Kinesis、DynamoDB Streams 和 Amazon SQS) 套用至事件來源映射的目前回應類型列舉清單。  
類型：字串陣列  
陣列成員：項目數下限為 0。項目數上限為 1。  
有效值:`ReportBatchItemFailures` 

 ** [LastModified](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-LastModified"></a>
上次更新事件來源映射或其狀態變更的日期 (以 Unix 時間秒為單位)。  
類型：Timestamp

 ** [LastProcessingResult](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-LastProcessingResult"></a>
函數的最後一次 Lambda 調用的結果。  
類型：字串

 ** [MaximumBatchingWindowInSeconds](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
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) **   <a name="lambda-GetEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) 捨棄超過指定存留期的記錄。預設值為 -1，這會將最大存留期設定為無限。當值設定為無限時，Lambda 永遠不會捨棄舊記錄。  
最大記錄保留期的最小有效值為 60 秒。雖然小於 60 且大於 -1 的值在參數的絕對範圍內，但不允許這些值
類型：整數  
有效範圍：最小值為 -1。最大值為 604800。

 ** [MaximumRetryAttempts](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MaximumRetryAttempts"></a>
(僅限 Kinesis 和 DynamoDB Streams) 在指定的重試次數之後捨棄記錄。預設值為 -1，這會將重試數上限設定為無限。如果 MaximumRetryAttempts 是無限的，Lambda 會重試失敗的記錄，直到事件來源中的記錄到期為止。  
類型：整數  
有效範圍：最小值為 -1。最大值為 10000。

 ** [ParallelizationFactor](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-ParallelizationFactor"></a>
(僅限 Kinesis 和 DynamoDB Streams) 要從每個碎片中同時處理的批次數。預設值為 1。  
類型：整數  
有效範圍：最小值為 1。最大值為 10。

 ** [Queues](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-Queues"></a>
 (Amazon MQ) 要使用的 Amazon MQ 代理程式目的地佇列的名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 1000。  
模式：`[\s\S]*`

 ** [ScalingConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-ScalingConfig"></a>
(僅限 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) **   <a name="lambda-GetEventSourceMapping-response-SelfManagedEventSource"></a>
用於事件來源的自我管理型 Apache Kafka 叢集。  
類型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 物件

 ** [SelfManagedKafkaEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
用於自我管理的 Apache Kafka 事件來源的具體組態設定。  
類型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 物件

 ** [SourceAccessConfigurations](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-SourceAccessConfigurations"></a>
保護和定義事件來源的身分驗證協定、VPC 元件或虛擬主機。  
類型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 物件陣列  
陣列成員：項目數下限為 0。項目數上限為 22。

 ** [StartingPosition](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StartingPosition"></a>
要從中開始讀取的串流位置。Amazon Kinesis 和 Amazon DynamoDB Stream 事件來源所必需。Amazon Kinesis 串流、Amazon DocumentDB、Amazon MSK 以及自我管理的 Apache Kafka 僅支援 `AT_TIMESTAMP`。  
類型：字串  
有效值:`TRIM_HORIZON | LATEST | AT_TIMESTAMP` 

 ** [StartingPositionTimestamp](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StartingPositionTimestamp"></a>
將 `StartingPosition` 設定為 `AT_TIMESTAMP`，這是開始讀取的時間 (以 Unix 時間秒為單位)。`StartingPositionTimestamp` 不能為未來的時間。  
類型：Timestamp

 ** [State](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-State"></a>
事件來源映射的狀態。可為下列其中之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。  
類型：字串

 ** [StateTransitionReason](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StateTransitionReason"></a>
指出使用者或 Lambda 是否對事件來源映射進行最後的變更。  
類型：字串

 ** [Topics](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-Topics"></a>
Kafka 主題名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 249。  
模式：`^[^.]([a-zA-Z0-9\-_.]+)`

 ** [TumblingWindowInSeconds](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-TumblingWindowInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) DynamoDB 和 Kinesis Streams 事件來源處理時段的持續時間 (以秒為單位)。值為 0 秒代表沒有輪轉時段。  
類型：整數  
有效範圍：最小值為 0。最大值為 900。

 ** [UUID](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-UUID"></a>
事件來源映射的識別符。  
類型：字串

## 錯誤
<a name="API_GetEventSourceMapping_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetEventSourceMapping_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetEventSourceMapping) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetEventSourceMapping) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetEventSourceMapping) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetEventSourceMapping) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetEventSourceMapping) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetEventSourceMapping) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetEventSourceMapping) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetEventSourceMapping) 

# GetFunction
<a name="API_GetFunction"></a>

傳回函數或函數版本的相關資訊，並附上連結來下載部署套件 (有效時間為 10 分鐘)。如果您指定函數版本，則只會傳回該版本的特定詳細資訊。

## 請求語法
<a name="API_GetFunction_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_GetFunction_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetFunction_RequestSyntax) **   <a name="lambda-GetFunction-request-FunctionName"></a>
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) **   <a name="lambda-GetFunction-request-Qualifier"></a>
指定版本或別名，以取得函數之已發佈版本的詳細資訊。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_GetFunction_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetFunction_ResponseSyntax"></a>

```
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" 
   }
}
```

## 回應元素
<a name="API_GetFunction_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Code](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-Code"></a>
函數或版本的部署套件。  
類型：[FunctionCodeLocation](API_FunctionCodeLocation.md) 物件

 ** [Concurrency](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-Concurrency"></a>
函數的[預留並行](https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html)。  
類型：[Concurrency](API_Concurrency.md) 物件

 ** [Configuration](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-Configuration"></a>
函數或版本的組態。  
類型：[FunctionConfiguration](API_FunctionConfiguration.md) 物件

 ** [Tags](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-Tags"></a>
函數的[標籤](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)。  
類型：字串到字串映射

## 錯誤
<a name="API_GetFunction_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetFunction_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunction) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunction) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunction) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunction) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunction) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunction) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunction) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunction) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunction) 

# GetFunctionCodeSigningConfig
<a name="API_GetFunctionCodeSigningConfig"></a>

傳回指定函數的程式碼簽署組態。

## 請求語法
<a name="API_GetFunctionCodeSigningConfig_RequestSyntax"></a>

```
GET /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1
```

## URI 請求參數
<a name="API_GetFunctionCodeSigningConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetFunctionCodeSigningConfig_RequestSyntax) **   <a name="lambda-GetFunctionCodeSigningConfig-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_GetFunctionCodeSigningConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetFunctionCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfigArn": "string",
   "FunctionName": "string"
}
```

## 回應元素
<a name="API_GetFunctionCodeSigningConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CodeSigningConfigArn](#API_GetFunctionCodeSigningConfig_ResponseSyntax) **   <a name="lambda-GetFunctionCodeSigningConfig-response-CodeSigningConfigArn"></a>
程式碼簽署組態的 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) **   <a name="lambda-GetFunctionCodeSigningConfig-response-FunctionName"></a>
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-_]+))?`

## 錯誤
<a name="API_GetFunctionCodeSigningConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetFunctionCodeSigningConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 

# GetFunctionConcurrency
<a name="API_GetFunctionConcurrency"></a>

傳回函數的預留並行組態詳細資訊。若要設定函數的並行限制，請使用 [PutFunctionConcurrency](API_PutFunctionConcurrency.md)。

## 請求語法
<a name="API_GetFunctionConcurrency_RequestSyntax"></a>

```
GET /2019-09-30/functions/FunctionName/concurrency HTTP/1.1
```

## URI 請求參數
<a name="API_GetFunctionConcurrency_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetFunctionConcurrency_RequestSyntax) **   <a name="lambda-GetFunctionConcurrency-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_GetFunctionConcurrency_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetFunctionConcurrency_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReservedConcurrentExecutions": number
}
```

## 回應元素
<a name="API_GetFunctionConcurrency_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [ReservedConcurrentExecutions](#API_GetFunctionConcurrency_ResponseSyntax) **   <a name="lambda-GetFunctionConcurrency-response-ReservedConcurrentExecutions"></a>
為函數預留的同時執行數。  
類型：整數  
有效範圍：最小值為 0。

## 錯誤
<a name="API_GetFunctionConcurrency_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetFunctionConcurrency_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionConcurrency) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionConcurrency) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionConcurrency) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionConcurrency) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionConcurrency) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionConcurrency) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionConcurrency) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionConcurrency) 

# GetFunctionConfiguration
<a name="API_GetFunctionConfiguration"></a>

傳回 Lambda 函數或版本的特定設定。輸出僅包含可在函數版本之間變化的選項。若要修改這些設定，請使用 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md)。

若要取得函數的所有詳細資訊，包括函數層級設定，請使用 [GetFunction](API_GetFunction.md)。

## 請求語法
<a name="API_GetFunctionConfiguration_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/configuration?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_GetFunctionConfiguration_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetFunctionConfiguration_RequestSyntax) **   <a name="lambda-GetFunctionConfiguration-request-FunctionName"></a>
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) **   <a name="lambda-GetFunctionConfiguration-request-Qualifier"></a>
指定版本或別名，以取得函數之已發佈版本的詳細資訊。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_GetFunctionConfiguration_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetFunctionConfiguration_ResponseSyntax"></a>

```
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"
   }
}
```

## 回應元素
<a name="API_GetFunctionConfiguration_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Architectures](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Architectures"></a>
函數支援的指令集架構。架構是具有其中一個有效值的字串陣列。預設架構值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64` 

 ** [CodeSha256](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-CodeSha256"></a>
函數部署套件的 SHA256 雜湊。  
類型：字串

 ** [CodeSize](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-CodeSize"></a>
函數部署套件的大小 (以位元組為單位)。  
類型：Long

 ** [DeadLetterConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-DeadLetterConfig"></a>
函數的無效字母佇列。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件

 ** [Description](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Description"></a>
函數的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [Environment](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Environment"></a>
函數的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。從 AWS CloudTrail 日誌中省略。  
類型：[EnvironmentResponse](API_EnvironmentResponse.md) 物件

 ** [EphemeralStorage](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-EphemeralStorage"></a>
函數的 `/tmp` 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱[設定暫時性儲存 (主控台)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。  
類型：[EphemeralStorage](API_EphemeralStorage.md) 物件

 ** [FileSystemConfigs](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-FileSystemConfigs"></a>
[Amazon EFS 檔案系統](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。

 ** [FunctionArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-GetFunctionConfiguration-response-FunctionName"></a>
函數的名稱。  
類型：字串  
長度限制：長度下限為 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) **   <a name="lambda-GetFunctionConfiguration-response-Handler"></a>
Lambda 為了開始執行您的函數所呼叫的函數。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`

 ** [ImageConfigResponse](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-ImageConfigResponse"></a>
函數的映像組態值。  
類型：[ImageConfigResponse](API_ImageConfigResponse.md) 物件

 ** [KMSKeyArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-KMSKeyArn"></a>
用來加密函數[環境變數](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) 時，也會使用此金鑰來加密函數的快照。只有在您已設定客戶受管金鑰的情況下，才會傳回此金鑰。  
類型：String  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`

 ** [LastModified](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastModified"></a>
上次更新函數的日期和時間，採用 [ISO-8601](https://www.w3.org/TR/NOTE-datetime) 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [LastUpdateStatus](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastUpdateStatus"></a>
對函數執行的上次更新的狀態。這是在函數建立完成後首次設定為 `Successful`。  
類型：字串  
有效值:`Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastUpdateStatusReason"></a>
對函數執行的上次更新的原因。  
類型：字串

 ** [LastUpdateStatusReasonCode](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastUpdateStatusReasonCode"></a>
對函數執行的上次更新的原因代碼。  
類型：字串  
有效值:`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) **   <a name="lambda-GetFunctionConfiguration-response-Layers"></a>
函數的[層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。  
類型：[Layer](API_Layer.md) 物件陣列

 ** [LoggingConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件

 ** [MasterArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-MasterArn"></a>
若是 Lambda@Edge 函數，則為主函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-GetFunctionConfiguration-response-MemorySize"></a>
可供函數在執行階段使用的記憶體量。  
類型：整數  
有效範圍：最小值為 128。最大值為 10240。

 ** [PackageType](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-PackageType"></a>
部署套件的類型。針對容器影像設定為 `Image`，並針對 .zip 檔案封存設定 `Zip`。  
類型：字串  
有效值:`Zip | Image` 

 ** [RevisionId](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-RevisionId"></a>
函數或別名的最新更新修訂版。  
類型：字串

 ** [Role](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Role"></a>
函數的執行角色。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`

 ** [Runtime](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Runtime"></a>
函數的[執行時間](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) **   <a name="lambda-GetFunctionConfiguration-response-RuntimeVersionConfig"></a>
執行階段的 ARN 和任何發生的錯誤。  
類型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 物件

 ** [SigningJobArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-SigningJobArn"></a>
簽署任務的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SigningProfileVersionArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-SigningProfileVersionArn"></a>
簽署描述檔版本的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SnapStart](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-SnapStart"></a>
將 `ApplyOn` 設為 `PublishedVersions`，即可在您發佈函數版本時建立初始化執行環境的快照。如需詳細資訊，請參閱[使用 Lambda 改善啟動效能 SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)。  
類型：[SnapStartResponse](API_SnapStartResponse.md) 物件

 ** [State](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-State"></a>
函數目前的狀態。當狀態為 `Inactive` 時，您可以透過調用它來重新激活該函數。  
類型：字串  
有效值:`Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-StateReason"></a>
函數目前狀態的原因。  
類型：字串

 ** [StateReasonCode](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-StateReasonCode"></a>
函數目前狀態的原因代碼。當代碼為 `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) **   <a name="lambda-GetFunctionConfiguration-response-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。  
類型：整數  
有效範圍：最小值為 1。

 ** [TracingConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-TracingConfig"></a>
函數的 AWS X-Ray 追蹤組態。  
類型：[TracingConfigResponse](API_TracingConfigResponse.md) 物件

 ** [Version](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Version"></a>
Lambda 函數的版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [VpcConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-VpcConfig"></a>
函數的聯網設定。  
類型：[VpcConfigResponse](API_VpcConfigResponse.md) 物件

## 錯誤
<a name="API_GetFunctionConfiguration_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetFunctionConfiguration_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionConfiguration) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionConfiguration) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionConfiguration) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionConfiguration) 

# GetFunctionEventInvokeConfig
<a name="API_GetFunctionEventInvokeConfig"></a>

擷取函數、版本或別名的非同步調用組態。

若要設定非同步調用選項，請使用 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)。

## 請求語法
<a name="API_GetFunctionEventInvokeConfig_RequestSyntax"></a>

```
GET /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_GetFunctionEventInvokeConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-request-FunctionName"></a>
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) **   <a name="lambda-GetFunctionEventInvokeConfig-request-Qualifier"></a>
版本號或別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_GetFunctionEventInvokeConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## 回應元素
<a name="API_GetFunctionEventInvokeConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [DestinationConfig](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-DestinationConfig"></a>
事件在傳送至函數以進行處理後的目標。  

**目的地**
+  **函數** - Lambda 函數的 Amazon Resource Name (ARN)。
+  **佇列** - 標準 SQS 佇列的 ARN。
+  **主題** - 標準 SNS 主題的 ARN。
+  **活動總線**-Amazon EventBridge 活動總線的 ARN。
類型：[DestinationConfig](API_DestinationConfig.md) 物件

 ** [FunctionArn](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-GetFunctionEventInvokeConfig-response-LastModified"></a>
上次更新組態的日期和時間 (以 Unix 時間秒為單位)。  
類型：Timestamp

 ** [MaximumEventAgeInSeconds](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
Lambda 傳送至函數以進行處理的請求時間上限。  
類型：整數  
有效範圍：最小值為 60。最大值為 21600。

 ** [MaximumRetryAttempts](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
當函數傳回錯誤時，重試的次數上限。  
類型：整數  
有效範圍：最小值為 0。最大值為 2。

## 錯誤
<a name="API_GetFunctionEventInvokeConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetFunctionEventInvokeConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 

# GetFunctionUrlConfig
<a name="API_GetFunctionUrlConfig"></a>

傳回 Lambda 函數 URL 的詳細資訊。

## 請求語法
<a name="API_GetFunctionUrlConfig_RequestSyntax"></a>

```
GET /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_GetFunctionUrlConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetFunctionUrlConfig_RequestSyntax) **   <a name="lambda-GetFunctionUrlConfig-request-FunctionName"></a>
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) **   <a name="lambda-GetFunctionUrlConfig-request-Qualifier"></a>
別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))`

## 請求主體
<a name="API_GetFunctionUrlConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetFunctionUrlConfig_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_GetFunctionUrlConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AuthType](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-AuthType"></a>
函數 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) **   <a name="lambda-GetFunctionUrlConfig-response-Cors"></a>
函數 URL 的[跨來源資源共享 (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 設定。  
類型：[Cors](API_Cors.md) 物件

 ** [CreationTime](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-CreationTime"></a>
建立函數 URL 時使用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [FunctionArn](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-GetFunctionUrlConfig-response-FunctionUrl"></a>
函數的 HTTP URL 端點。  
類型：字串  
長度限制：長度下限為 40。長度上限為 100。

 ** [InvokeMode](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-InvokeMode"></a>
使用下列其中一個選項：  
+  `BUFFERED` – 此為預設選項。Lambda 會使用 `Invoke` API 操作調用您的函數。承載完成時，即可使用調用結果。承載大小上限為 6 MB。
+  `RESPONSE_STREAM` – 當承載結果變得可用時，函數會串流它們。Lambda 會使用 `InvokeWithResponseStream` API 操作調用您的函數。回應承載大小上限為 20 MB，不過，您可以[請求增加配額](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。
類型：字串  
有效值:`BUFFERED | RESPONSE_STREAM` 

 ** [LastModifiedTime](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-LastModifiedTime"></a>
最近一次更新函數 URL 組態的時間，採用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

## 錯誤
<a name="API_GetFunctionUrlConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetFunctionUrlConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionUrlConfig) 

# GetLayerVersion
<a name="API_GetLayerVersion"></a>

傳回 [AWS Lambda 層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的一個版本的相關資訊，並附上連結來下載層封存 (有效時間 10 分鐘)。

## 請求語法
<a name="API_GetLayerVersion_RequestSyntax"></a>

```
GET /2018-10-31/layers/LayerName/versions/VersionNumber HTTP/1.1
```

## URI 請求參數
<a name="API_GetLayerVersion_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [LayerName](#API_GetLayerVersion_RequestSyntax) **   <a name="lambda-GetLayerVersion-request-LayerName"></a>
layer 的名稱或 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) **   <a name="lambda-GetLayerVersion-request-VersionNumber"></a>
版本號碼。  
必要：是

## 請求主體
<a name="API_GetLayerVersion_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetLayerVersion_ResponseSyntax"></a>

```
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
}
```

## 回應元素
<a name="API_GetLayerVersion_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CompatibleArchitectures](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-CompatibleArchitectures"></a>
相容[指令集架構](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)的清單。  
類型：字串陣列  
陣列成員：最多 2 個項目。  
有效值:`x86_64 | arm64` 

 ** [CompatibleRuntimes](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-CompatibleRuntimes"></a>
層的相容執行時間。  
下列清單包含已淘汰的執行時間。如需詳細資訊，請參閱[執行時間淘汰政策](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) **   <a name="lambda-GetLayerVersion-response-Content"></a>
有關層版本的詳細資訊。  
類型：[LayerVersionContentOutput](API_LayerVersionContentOutput.md) 物件

 ** [CreatedDate](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-CreatedDate"></a>
建立層版本的日期，採用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [Description](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-Description"></a>
版本的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [LayerArn](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-LayerArn"></a>
該層的 ARN。  
類型：字串  
長度限制：長度下限為 1。長度上限為 140。  
模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+`

 ** [LayerVersionArn](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-LayerVersionArn"></a>
layer 版本的 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) **   <a name="lambda-GetLayerVersion-response-LicenseInfo"></a>
layer 的軟體授權。  
類型：字串  
長度限制：長度上限為 512。

 ** [Version](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-Version"></a>
版本號碼。  
類型：Long

## 錯誤
<a name="API_GetLayerVersion_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetLayerVersion_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetLayerVersion) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetLayerVersion) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersion) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetLayerVersion) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersion) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersion) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersion) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersion) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersion) 

# GetLayerVersionByArn
<a name="API_GetLayerVersionByArn"></a>

傳回 [AWS Lambda 層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的一個版本的相關資訊，並附上連結來下載層封存 (有效時間 10 分鐘)。

## 請求語法
<a name="API_GetLayerVersionByArn_RequestSyntax"></a>

```
GET /2018-10-31/layers?find=LayerVersion&Arn=Arn HTTP/1.1
```

## URI 請求參數
<a name="API_GetLayerVersionByArn_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [Arn](#API_GetLayerVersionByArn_RequestSyntax) **   <a name="lambda-GetLayerVersionByArn-request-Arn"></a>
layer 版本的 ARN。  
長度限制：長度下限為 1。長度上限為 140。  
模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+`  
必要：是

## 請求主體
<a name="API_GetLayerVersionByArn_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetLayerVersionByArn_ResponseSyntax"></a>

```
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
}
```

## 回應元素
<a name="API_GetLayerVersionByArn_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CompatibleArchitectures](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-CompatibleArchitectures"></a>
相容[指令集架構](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)的清單。  
類型：字串陣列  
陣列成員：最多 2 個項目。  
有效值:`x86_64 | arm64` 

 ** [CompatibleRuntimes](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-CompatibleRuntimes"></a>
層的相容執行時間。  
下列清單包含已淘汰的執行時間。如需詳細資訊，請參閱[執行時間淘汰政策](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) **   <a name="lambda-GetLayerVersionByArn-response-Content"></a>
有關層版本的詳細資訊。  
類型：[LayerVersionContentOutput](API_LayerVersionContentOutput.md) 物件

 ** [CreatedDate](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-CreatedDate"></a>
建立層版本的日期，採用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [Description](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-Description"></a>
版本的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [LayerArn](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-LayerArn"></a>
該層的 ARN。  
類型：字串  
長度限制：長度下限為 1。長度上限為 140。  
模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+`

 ** [LayerVersionArn](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-LayerVersionArn"></a>
layer 版本的 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) **   <a name="lambda-GetLayerVersionByArn-response-LicenseInfo"></a>
layer 的軟體授權。  
類型：字串  
長度限制：長度上限為 512。

 ** [Version](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-Version"></a>
版本號碼。  
類型：Long

## 錯誤
<a name="API_GetLayerVersionByArn_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetLayerVersionByArn_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetLayerVersionByArn) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetLayerVersionByArn) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersionByArn) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetLayerVersionByArn) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersionByArn) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersionByArn) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersionByArn) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersionByArn) 

# GetLayerVersionPolicy
<a name="API_GetLayerVersionPolicy"></a>

傳回 [AWS Lambda 層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)版本的許可政策。如需詳細資訊，請參閱[AddLayerVersionPermission](API_AddLayerVersionPermission.md)。

## 請求語法
<a name="API_GetLayerVersionPolicy_RequestSyntax"></a>

```
GET /2018-10-31/layers/LayerName/versions/VersionNumber/policy HTTP/1.1
```

## URI 請求參數
<a name="API_GetLayerVersionPolicy_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [LayerName](#API_GetLayerVersionPolicy_RequestSyntax) **   <a name="lambda-GetLayerVersionPolicy-request-LayerName"></a>
layer 的名稱或 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) **   <a name="lambda-GetLayerVersionPolicy-request-VersionNumber"></a>
版本號碼。  
必要：是

## 請求主體
<a name="API_GetLayerVersionPolicy_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetLayerVersionPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Policy": "string",
   "RevisionId": "string"
}
```

## 回應元素
<a name="API_GetLayerVersionPolicy_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Policy](#API_GetLayerVersionPolicy_ResponseSyntax) **   <a name="lambda-GetLayerVersionPolicy-response-Policy"></a>
政策文件。  
類型：字串

 ** [RevisionId](#API_GetLayerVersionPolicy_ResponseSyntax) **   <a name="lambda-GetLayerVersionPolicy-response-RevisionId"></a>
目前政策修訂版本的唯一識別符。  
類型：字串

## 錯誤
<a name="API_GetLayerVersionPolicy_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetLayerVersionPolicy_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersionPolicy) 

# GetPolicy
<a name="API_GetPolicy"></a>

傳回函數、版本或別名的[以資源為基礎的 IAM 政策](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html)。

## 請求語法
<a name="API_GetPolicy_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/policy?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_GetPolicy_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetPolicy_RequestSyntax) **   <a name="lambda-GetPolicy-request-FunctionName"></a>
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) **   <a name="lambda-GetPolicy-request-Qualifier"></a>
指定版本或別名以取得該資源的政策。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_GetPolicy_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Policy": "string",
   "RevisionId": "string"
}
```

## 回應元素
<a name="API_GetPolicy_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Policy](#API_GetPolicy_ResponseSyntax) **   <a name="lambda-GetPolicy-response-Policy"></a>
以資源為基礎的政策。  
類型：字串

 ** [RevisionId](#API_GetPolicy_ResponseSyntax) **   <a name="lambda-GetPolicy-response-RevisionId"></a>
目前政策修訂版本的唯一識別符。  
類型：字串

## 錯誤
<a name="API_GetPolicy_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetPolicy_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetPolicy) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetPolicy) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetPolicy) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetPolicy) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetPolicy) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetPolicy) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetPolicy) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetPolicy) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetPolicy) 

# GetProvisionedConcurrencyConfig
<a name="API_GetProvisionedConcurrencyConfig"></a>

擷取函數別名或版本的佈建並行組態。

## 請求語法
<a name="API_GetProvisionedConcurrencyConfig_RequestSyntax"></a>

```
GET /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_GetProvisionedConcurrencyConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-request-FunctionName"></a>
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) **   <a name="lambda-GetProvisionedConcurrencyConfig-request-Qualifier"></a>
版本號或別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`  
必要：是

## 請求主體
<a name="API_GetProvisionedConcurrencyConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetProvisionedConcurrencyConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AllocatedProvisionedConcurrentExecutions": number,
   "AvailableProvisionedConcurrentExecutions": number,
   "LastModified": "string",
   "RequestedProvisionedConcurrentExecutions": number,
   "Status": "string",
   "StatusReason": "string"
}
```

## 回應元素
<a name="API_GetProvisionedConcurrencyConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AllocatedProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-AllocatedProvisionedConcurrentExecutions"></a>
已配置的佈建並行數量。在線性和金絲雀部署期間使用加權別名時，此值會根據為函數版本佈建的並行數量而變動。  
類型：整數  
有效範圍：最小值為 0。

 ** [AvailableProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-AvailableProvisionedConcurrentExecutions"></a>
可用的佈建並行數量。  
類型：整數  
有效範圍：最小值為 0。

 ** [LastModified](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-LastModified"></a>
使用者上次更新組態的日期和時間，採用 [ISO 8601 格式](https://www.iso.org/iso-8601-date-and-time-format.html)。  
類型：字串

 ** [RequestedProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-RequestedProvisionedConcurrentExecutions"></a>
請求的佈建並行數量。  
類型：整數  
有效範圍：最小值為 1。

 ** [Status](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-Status"></a>
配置程序的狀態。  
類型：字串  
有效值:`IN_PROGRESS | READY | FAILED` 

 ** [StatusReason](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-StatusReason"></a>
對於失敗的配置，則為無法配置佈建並行的原因。  
類型：字串

## 錯誤
<a name="API_GetProvisionedConcurrencyConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetProvisionedConcurrencyConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 

# GetRuntimeManagementConfig
<a name="API_GetRuntimeManagementConfig"></a>

擷取函數版本的執行階段管理組態。如果執行階段更新模式為 **Manual** (手動)，便會包括執行階段版本的 ARN 和執行階段更新模式。如果執行階段更新模式為 **Auto** (自動) 或 **Function update** (函數更新)，則會包含執行階段更新模式，且 ARN 會傳回 `null`。如需詳細資訊，請參閱[執行階段更新](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html)。

## 請求語法
<a name="API_GetRuntimeManagementConfig_RequestSyntax"></a>

```
GET /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1
```

## URI 請求參數
<a name="API_GetRuntimeManagementConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_GetRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-GetRuntimeManagementConfig-request-FunctionName"></a>
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) **   <a name="lambda-GetRuntimeManagementConfig-request-Qualifier"></a>
指定函數的版本。這可以是 `$LATEST` 或已發佈的版本編號。如果未指定任何值，則會傳回 `$LATEST` 版本的組態。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_GetRuntimeManagementConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetRuntimeManagementConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionArn": "string",
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

## 回應元素
<a name="API_GetRuntimeManagementConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [FunctionArn](#API_GetRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-GetRuntimeManagementConfig-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-GetRuntimeManagementConfig-response-RuntimeVersionArn"></a>
設定讓函數使用的執行階段之 ARN。如果執行階段更新模式為 **Manual** (手動)，系統會傳回 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) **   <a name="lambda-GetRuntimeManagementConfig-response-UpdateRuntimeOn"></a>
函數目前的執行階段更新模式。  
類型：字串  
有效值:`Auto | Manual | FunctionUpdate` 

## 錯誤
<a name="API_GetRuntimeManagementConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_GetRuntimeManagementConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetRuntimeManagementConfig) 

# Invoke
<a name="API_Invoke"></a>

調用 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 用戶端、SDK、防火牆、Proxy 或作業系統，以透過逾時或持續作用設定允許長時間連線。

此作業需要 [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)。

## 請求語法
<a name="API_Invoke_RequestSyntax"></a>

```
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 請求參數
<a name="API_Invoke_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [ClientContext](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-ClientContext"></a>
內容物件中最多 3,583 個位元組的 base64 編碼資料，這些資料與調用用戶端以傳遞到函數有關。Lambda 向您函數傳遞的 `ClientContext` 物件僅會用於同步調用。

 ** [FunctionName](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-FunctionName"></a>
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) **   <a name="lambda-Invoke-request-InvocationType"></a>
您可以從以下選項中選擇。  
+  `RequestResponse` (預設) - 同步調用函數。保持連線打開，直到函數傳回回應或逾時。API 回應包括函數回應和其他資料。
+  `Event` - 以非同步方式調用函數。將失敗多次的事件傳送至函數的無效字母佇列 (如果已設定)。API 回應只包含狀態碼。
+  `DryRun` - 驗證參數值並確認使用者或角色擁有調用函數的許可。
有效值:`Event | RequestResponse | DryRun` 

 ** [LogType](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-LogType"></a>
設定為 `Tail`，將執行記錄包含在回應中。僅適用於同步調用的函數。  
有效值:`None | Tail` 

 ** [Qualifier](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-Qualifier"></a>
指定版本或別名，以調用函數的已發佈版本。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_Invoke_RequestBody"></a>

請求接受下列二進位資料。

 ** [Payload](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-Payload"></a>
想要作為輸入提供給您的 Lambda 函數的 JSON。  
您可以直接輸入 JSON。例如 `--payload '{ "key": "value" }'`。您也可以指定檔案路徑。例如 `--payload file://payload.json`。

## 回應語法
<a name="API_Invoke_ResponseSyntax"></a>

```
HTTP/1.1 StatusCode
X-Amz-Function-Error: FunctionError
X-Amz-Log-Result: LogResult
X-Amz-Executed-Version: ExecutedVersion

Payload
```

## 回應元素
<a name="API_Invoke_ResponseElements"></a>

如果動作成功，則服務傳回下列 HTTP 回應。

 ** [StatusCode](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-StatusCode"></a>
對於成功請求，HTTP 狀態碼在 200 範圍內。對於 `RequestResponse` 調用類型，狀態碼為 200。對於 `Event` 調用類型，狀態碼為 202。對於 `DryRun` 調用類型，狀態碼為 204。

回應會傳回下列 HTTP 標頭。

 ** [ExecutedVersion](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-ExecutedVersion"></a>
執行的函數版本。當您調用具有別名的函數時，這表示別名解析到哪個版本。  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [FunctionError](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-FunctionError"></a>
如果存在，則表示函數執行期間發生錯誤。有關錯誤的詳細資訊包含在回應承載中。

 ** [LogResult](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-LogResult"></a>
執行日誌的最後 4 KB，採用 base64 編碼。

回應傳回以下內容作為 HTTP 主體。

 ** [Payload](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-Payload"></a>
來自函數的回應，或錯誤物件。

## 錯誤
<a name="API_Invoke_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** EC2AccessDeniedException **   
需要其他許可才能對 VPC 進行設定。  
HTTP 狀態碼：502

 ** EC2ThrottledException **   
Lambda 函數初始化期間，Amazon EC2 使用為函數提供的執行角色對 AWS Lambda 進行限流。  
HTTP 狀態碼：502

 ** EC2UnexpectedException **   
 設定 Lambda 函數時，AWS 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 **   
AWS KMS 存取遭拒絕，所以 Lambda 無法解密環境變數。請檢查 Lambda 函數的 KMS 許可。  
HTTP 狀態碼：502

 ** KMSDisabledException **   
使用的 AWS KMS key 已停用，所以 Lambda 無法解密環境變數。請檢查 Lambda 函數的 KMS 金鑰設定。  
HTTP 狀態碼：502

 ** KMSInvalidStateException **   
使用的 AWS KMS key 狀態對解密無效，所以 Lambda 無法解密環境變數。請檢查函數的 KMS 金鑰設定。  
HTTP 狀態碼：502

 ** KMSNotFoundException **   
找不到 AWS KMS key，所以 Lambda 無法解密環境變數。請檢查函數的 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

## 另請參閱
<a name="API_Invoke_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/Invoke) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/Invoke) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/Invoke) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/Invoke) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/Invoke) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/Invoke) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/Invoke) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/Invoke) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/Invoke) 

# InvokeAsync
<a name="API_InvokeAsync"></a>

 *此動作已被取代。*

**重要**  
對於非同步函數叫用，請使用 [Invoke](API_Invoke.md)。

以非同步方式叫用函數。

**注意**  
如果您確實使用此 InvokeAsync 動作，請注意，該動作不支援使用 X-Ray 作用中追蹤。即使 X-Ray 作用中追蹤已開啟，追蹤 ID 也不會傳播至函數。

## 請求語法
<a name="API_InvokeAsync_RequestSyntax"></a>

```
POST /2014-11-13/functions/FunctionName/invoke-async/ HTTP/1.1

InvokeArgs
```

## URI 請求參數
<a name="API_InvokeAsync_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_InvokeAsync_RequestSyntax) **   <a name="lambda-InvokeAsync-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_InvokeAsync_RequestBody"></a>

請求接受下列二進位資料。

 ** [InvokeArgs](#API_InvokeAsync_RequestSyntax) **   <a name="lambda-InvokeAsync-request-InvokeArgs"></a>
想要作為輸入提供給您的 Lambda 函數的 JSON。  
必要：是

## 回應語法
<a name="API_InvokeAsync_ResponseSyntax"></a>

```
HTTP/1.1 Status
```

## 回應元素
<a name="API_InvokeAsync_ResponseElements"></a>

如果動作成功，則服務傳回下列 HTTP 回應。

 ** [Status](#API_InvokeAsync_ResponseSyntax) **   <a name="lambda-InvokeAsync-response-Status"></a>
狀態碼。

## 錯誤
<a name="API_InvokeAsync_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** InvalidRequestContentException **   
請求主體無法解析為 JSON。  
HTTP 狀態碼：400

 ** InvalidRuntimeException **   
不支援指定的執行時間或執行時間版本。  
HTTP 狀態碼：502

 ** ResourceConflictException **   
資源已存在，或另一個操作正在進行中。  
HTTP 狀態碼：409

 ** ResourceNotFoundException **   
請求中指定的資源不存在。  
HTTP 狀態碼：404

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

## 另請參閱
<a name="API_InvokeAsync_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/InvokeAsync) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/InvokeAsync) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/InvokeAsync) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/InvokeAsync) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/InvokeAsync) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/InvokeAsync) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/InvokeAsync) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/InvokeAsync) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/InvokeAsync) 

# InvokeWithResponseStream
<a name="API_InvokeWithResponseStream"></a>

設定 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)。

## 請求語法
<a name="API_InvokeWithResponseStream_RequestSyntax"></a>

```
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 請求參數
<a name="API_InvokeWithResponseStream_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [ClientContext](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-ClientContext"></a>
內容物件中最多 3,583 個位元組的 base64 編碼資料，這些資料與調用用戶端以傳遞到函數有關。

 ** [FunctionName](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-FunctionName"></a>
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) **   <a name="lambda-InvokeWithResponseStream-request-InvocationType"></a>
使用下列其中一個選項：  
+  `RequestResponse` (預設) - 同步調用函數。保持連線打開，直到函數傳回回應或逾時。API 操作回應包括函數回應和其他資料。
+  `DryRun` - 驗證參數值並確認 IAM 使用者或角色擁有調用函數的許可。
有效值:`RequestResponse | DryRun` 

 ** [LogType](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-LogType"></a>
設定為 `Tail`，將執行記錄包含在回應中。僅適用於同步調用的函數。  
有效值:`None | Tail` 

 ** [Qualifier](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-Qualifier"></a>
別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_InvokeWithResponseStream_RequestBody"></a>

請求接受下列二進位資料。

 ** [Payload](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-Payload"></a>
想要作為輸入提供給您的 Lambda 函數的 JSON。  
您可以直接輸入 JSON。例如 `--payload '{ "key": "value" }'`。您也可以指定檔案路徑。例如 `--payload file://payload.json`。

## 回應語法
<a name="API_InvokeWithResponseStream_ResponseSyntax"></a>

```
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
   }
}
```

## 回應元素
<a name="API_InvokeWithResponseStream_ResponseElements"></a>

如果動作成功，則服務傳回下列 HTTP 回應。

 ** [StatusCode](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-StatusCode"></a>
對於成功請求，HTTP 狀態碼在 200 範圍內。對於 `RequestResponse` 調用類型，狀態碼為 200。對於 `DryRun` 調用類型，狀態碼為 204。

回應會傳回下列 HTTP 標頭。

 ** [ExecutedVersion](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-ExecutedVersion"></a>
執行的函數版本。當您調用具有別名的函數時，這表示別名解析到哪個版本。  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [ResponseStreamContentType](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-ResponseStreamContentType"></a>
串流傳回的資料類型。

服務會傳回下列 JSON 格式的資料。

 ** [InvokeComplete](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-InvokeComplete"></a>
串流結束並已傳回所有承載區塊時傳回的物件。  
類型：[InvokeWithResponseStreamCompleteEvent](API_InvokeWithResponseStreamCompleteEvent.md) 物件

 ** [PayloadChunk](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-PayloadChunk"></a>
串流回應承載的區塊。  
類型：[InvokeResponseStreamUpdate](API_InvokeResponseStreamUpdate.md) 物件

## 錯誤
<a name="API_InvokeWithResponseStream_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** EC2AccessDeniedException **   
需要其他許可才能對 VPC 進行設定。  
HTTP 狀態碼：502

 ** EC2ThrottledException **   
Lambda 函數初始化期間，Amazon EC2 使用為函數提供的執行角色對 AWS Lambda 進行限流。  
HTTP 狀態碼：502

 ** EC2UnexpectedException **   
 設定 Lambda 函數時，AWS 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 **   
AWS KMS 存取遭拒絕，所以 Lambda 無法解密環境變數。請檢查 Lambda 函數的 KMS 許可。  
HTTP 狀態碼：502

 ** KMSDisabledException **   
使用的 AWS KMS key 已停用，所以 Lambda 無法解密環境變數。請檢查 Lambda 函數的 KMS 金鑰設定。  
HTTP 狀態碼：502

 ** KMSInvalidStateException **   
使用的 AWS KMS key 狀態對解密無效，所以 Lambda 無法解密環境變數。請檢查函數的 KMS 金鑰設定。  
HTTP 狀態碼：502

 ** KMSNotFoundException **   
找不到 AWS KMS key，所以 Lambda 無法解密環境變數。請檢查函數的 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

## 另請參閱
<a name="API_InvokeWithResponseStream_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/InvokeWithResponseStream) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/InvokeWithResponseStream) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/InvokeWithResponseStream) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/InvokeWithResponseStream) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/InvokeWithResponseStream) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/InvokeWithResponseStream) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/InvokeWithResponseStream) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/InvokeWithResponseStream) 

# ListAliases
<a name="API_ListAliases"></a>

傳回 Lambda 函數的[別名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)清單。

## 請求語法
<a name="API_ListAliases_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/aliases?FunctionVersion=FunctionVersion&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListAliases_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_ListAliases_RequestSyntax) **   <a name="lambda-ListAliases-request-FunctionName"></a>
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) **   <a name="lambda-ListAliases-request-FunctionVersion"></a>
指定函數版本，只列出叫用該版本的別名。  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [Marker](#API_ListAliases_RequestSyntax) **   <a name="lambda-ListAliases-request-Marker"></a>
指定上一個請求傳回的分頁字符，擷取下一個結果頁面。

 ** [MaxItems](#API_ListAliases_RequestSyntax) **   <a name="lambda-ListAliases-request-MaxItems"></a>
限制傳回的別名數  
有效範圍：最小值為 1。最大值為 10000。

## 請求主體
<a name="API_ListAliases_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListAliases_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_ListAliases_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Aliases](#API_ListAliases_ResponseSyntax) **   <a name="lambda-ListAliases-response-Aliases"></a>
別名清單。  
類型：[AliasConfiguration](API_AliasConfiguration.md) 物件陣列

 ** [NextMarker](#API_ListAliases_ResponseSyntax) **   <a name="lambda-ListAliases-response-NextMarker"></a>
如果多個結果可用，則分頁字符包含在內。  
類型：字串

## 錯誤
<a name="API_ListAliases_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListAliases_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListAliases) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListAliases) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListAliases) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListAliases) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListAliases) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListAliases) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListAliases) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListAliases) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListAliases) 

# ListCodeSigningConfigs
<a name="API_ListCodeSigningConfigs"></a>

傳回[程式碼簽署組態](https://docs.aws.amazon.com/lambda/latest/dg/configuring-codesigning.html)清單。每次呼叫時，請求最多傳回 10,000 個組態。您可以使用 `MaxItems` 參數，在每次呼叫時傳回較少的組態。

## 請求語法
<a name="API_ListCodeSigningConfigs_RequestSyntax"></a>

```
GET /2020-04-22/code-signing-configs/?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListCodeSigningConfigs_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [Marker](#API_ListCodeSigningConfigs_RequestSyntax) **   <a name="lambda-ListCodeSigningConfigs-request-Marker"></a>
指定上一個請求傳回的分頁字符，擷取下一個結果頁面。

 ** [MaxItems](#API_ListCodeSigningConfigs_RequestSyntax) **   <a name="lambda-ListCodeSigningConfigs-request-MaxItems"></a>
傳回的項目數上限。  
有效範圍：最小值為 1。最大值為 10000。

## 請求主體
<a name="API_ListCodeSigningConfigs_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListCodeSigningConfigs_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_ListCodeSigningConfigs_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CodeSigningConfigs](#API_ListCodeSigningConfigs_ResponseSyntax) **   <a name="lambda-ListCodeSigningConfigs-response-CodeSigningConfigs"></a>
程式碼簽署組態。  
類型：[CodeSigningConfig](API_CodeSigningConfig.md) 物件陣列

 ** [NextMarker](#API_ListCodeSigningConfigs_ResponseSyntax) **   <a name="lambda-ListCodeSigningConfigs-response-NextMarker"></a>
如果多個結果可用，則分頁字符包含在內。  
類型：字串

## 錯誤
<a name="API_ListCodeSigningConfigs_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** InvalidParameterValueException **   
請求中的其中一個參數無效。  
HTTP 狀態碼：400

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

## 另請參閱
<a name="API_ListCodeSigningConfigs_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListCodeSigningConfigs) 

# ListEventSourceMappings
<a name="API_ListEventSourceMappings"></a>

列出事件來源映射。指定 `EventSourceArn` 以便僅顯示單一事件來源的事件來源映射。

## 請求語法
<a name="API_ListEventSourceMappings_RequestSyntax"></a>

```
GET /2015-03-31/event-source-mappings/?EventSourceArn=EventSourceArn&FunctionName=FunctionName&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListEventSourceMappings_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [EventSourceArn](#API_ListEventSourceMappings_RequestSyntax) **   <a name="lambda-ListEventSourceMappings-request-EventSourceArn"></a>
事件來源的 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})?:(.*)`

 ** [FunctionName](#API_ListEventSourceMappings_RequestSyntax) **   <a name="lambda-ListEventSourceMappings-request-FunctionName"></a>
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) **   <a name="lambda-ListEventSourceMappings-request-Marker"></a>
上一個呼叫傳回的分頁字符。

 ** [MaxItems](#API_ListEventSourceMappings_RequestSyntax) **   <a name="lambda-ListEventSourceMappings-request-MaxItems"></a>
要傳回的事件來源映射數目上限。請注意，即使您將數字設置為較高，每個響應中最多 ListEventSourceMappings 返回 100 個項目。  
有效範圍：最小值為 1。最大值為 10000。

## 請求主體
<a name="API_ListEventSourceMappings_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListEventSourceMappings_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_ListEventSourceMappings_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [EventSourceMappings](#API_ListEventSourceMappings_ResponseSyntax) **   <a name="lambda-ListEventSourceMappings-response-EventSourceMappings"></a>
事件來源映射清單。  
類型：[EventSourceMappingConfiguration](API_EventSourceMappingConfiguration.md) 物件陣列

 ** [NextMarker](#API_ListEventSourceMappings_ResponseSyntax) **   <a name="lambda-ListEventSourceMappings-response-NextMarker"></a>
當回應未包含所有事件來源映射時傳回的分頁字符。  
類型：字串

## 錯誤
<a name="API_ListEventSourceMappings_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListEventSourceMappings_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListEventSourceMappings) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListEventSourceMappings) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListEventSourceMappings) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListEventSourceMappings) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListEventSourceMappings) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListEventSourceMappings) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListEventSourceMappings) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListEventSourceMappings) 

# ListFunctionEventInvokeConfigs
<a name="API_ListFunctionEventInvokeConfigs"></a>

擷取函數的非同步叫用之組態清單。

若要設定非同步叫用選項，請使用 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)。

## 請求語法
<a name="API_ListFunctionEventInvokeConfigs_RequestSyntax"></a>

```
GET /2019-09-25/functions/FunctionName/event-invoke-config/list?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListFunctionEventInvokeConfigs_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_ListFunctionEventInvokeConfigs_RequestSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-request-FunctionName"></a>
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) **   <a name="lambda-ListFunctionEventInvokeConfigs-request-Marker"></a>
指定上一個請求傳回的分頁字符，擷取下一個結果頁面。

 ** [MaxItems](#API_ListFunctionEventInvokeConfigs_RequestSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-request-MaxItems"></a>
要傳回的組態數上限。  
有效範圍：最小值為 1。最大值為 50。

## 請求主體
<a name="API_ListFunctionEventInvokeConfigs_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListFunctionEventInvokeConfigs_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_ListFunctionEventInvokeConfigs_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [FunctionEventInvokeConfigs](#API_ListFunctionEventInvokeConfigs_ResponseSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-response-FunctionEventInvokeConfigs"></a>
組態清單。  
類型：[FunctionEventInvokeConfig](API_FunctionEventInvokeConfig.md) 物件陣列

 ** [NextMarker](#API_ListFunctionEventInvokeConfigs_ResponseSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-response-NextMarker"></a>
如果多個結果可用，則分頁字符包含在內。  
類型：字串

## 錯誤
<a name="API_ListFunctionEventInvokeConfigs_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListFunctionEventInvokeConfigs_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 

# ListFunctions
<a name="API_ListFunctions"></a>

傳回 Lambda 函數清單以及各函數的版本特定組態。Lambda 每次呼叫會傳回多達 50 個函數。

將 `FunctionVersion` 設定為 `ALL`，以包含每個函數的所有已發佈版本以及未發佈版本。

**注意**  
`ListFunctions` 操作會傳回 [FunctionConfiguration](API_FunctionConfiguration.md) 欄位的子集。若要取得函數或版本的其他欄位 (狀態 StateReason LastUpdateStatus LastUpdateStatusReason LastUpdateStatusReasonCode、、、、、 RuntimeVersionConfig)，請使用[GetFunction](API_GetFunction.md)。 StateReasonCode

## 請求語法
<a name="API_ListFunctions_RequestSyntax"></a>

```
GET /2015-03-31/functions/?FunctionVersion=FunctionVersion&Marker=Marker&MasterRegion=MasterRegion&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListFunctions_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionVersion](#API_ListFunctions_RequestSyntax) **   <a name="lambda-ListFunctions-request-FunctionVersion"></a>
設定為 `ALL`，以包含每個函數的所有已發佈版本的條目。  
有效值:`ALL` 

 ** [Marker](#API_ListFunctions_RequestSyntax) **   <a name="lambda-ListFunctions-request-Marker"></a>
指定上一個請求傳回的分頁字符，擷取下一個結果頁面。

 ** [MasterRegion](#API_ListFunctions_RequestSyntax) **   <a name="lambda-ListFunctions-request-MasterRegion"></a>
若是 Lambda@Edge 函數，則為主要函數的 AWS 區域。例如 `us-east-1` 會篩選函數清單，只包含從美國東部 (維吉尼亞北部) 主函數中複寫的 Lambda@Edge 函數。如果已指定，則請務必將 `FunctionVersion` 設為 `ALL`。  
模式：`ALL|[a-z]{2}(-gov)?-[a-z]+-\d{1}`

 ** [MaxItems](#API_ListFunctions_RequestSyntax) **   <a name="lambda-ListFunctions-request-MaxItems"></a>
在回應中傳回的函數最大數量。請注意，`ListFunctions` 會在每個回應中傳回最多 50 個項目，即使您將數字設定為更高。  
有效範圍：最小值為 1。最大值為 10000。

## 請求主體
<a name="API_ListFunctions_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListFunctions_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_ListFunctions_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Functions](#API_ListFunctions_ResponseSyntax) **   <a name="lambda-ListFunctions-response-Functions"></a>
Lambda 函數的清單。  
類型：[FunctionConfiguration](API_FunctionConfiguration.md) 物件陣列

 ** [NextMarker](#API_ListFunctions_ResponseSyntax) **   <a name="lambda-ListFunctions-response-NextMarker"></a>
如果多個結果可用，則分頁字符包含在內。  
類型：字串

## 錯誤
<a name="API_ListFunctions_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListFunctions_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListFunctions) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListFunctions) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctions) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListFunctions) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctions) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctions) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctions) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctions) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctions) 

# ListFunctionsByCodeSigningConfig
<a name="API_ListFunctionsByCodeSigningConfig"></a>

列出使用指定程式碼簽署組態的函數。您可以在刪除程式碼簽署組態之前使用此方法，確認沒有函數正在使用它。

## 請求語法
<a name="API_ListFunctionsByCodeSigningConfig_RequestSyntax"></a>

```
GET /2020-04-22/code-signing-configs/CodeSigningConfigArn/functions?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListFunctionsByCodeSigningConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [CodeSigningConfigArn](#API_ListFunctionsByCodeSigningConfig_RequestSyntax) **   <a name="lambda-ListFunctionsByCodeSigningConfig-request-CodeSigningConfigArn"></a>
程式碼簽署組態的 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) **   <a name="lambda-ListFunctionsByCodeSigningConfig-request-Marker"></a>
指定上一個請求傳回的分頁字符，擷取下一個結果頁面。

 ** [MaxItems](#API_ListFunctionsByCodeSigningConfig_RequestSyntax) **   <a name="lambda-ListFunctionsByCodeSigningConfig-request-MaxItems"></a>
傳回的項目數上限。  
有效範圍：最小值為 1。最大值為 10000。

## 請求主體
<a name="API_ListFunctionsByCodeSigningConfig_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListFunctionsByCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionArns": [ "string" ],
   "NextMarker": "string"
}
```

## 回應元素
<a name="API_ListFunctionsByCodeSigningConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [FunctionArns](#API_ListFunctionsByCodeSigningConfig_ResponseSyntax) **   <a name="lambda-ListFunctionsByCodeSigningConfig-response-FunctionArns"></a>
函數 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) **   <a name="lambda-ListFunctionsByCodeSigningConfig-response-NextMarker"></a>
如果多個結果可用，則分頁字符包含在內。  
類型：字串

## 錯誤
<a name="API_ListFunctionsByCodeSigningConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** InvalidParameterValueException **   
請求中的其中一個參數無效。  
HTTP 狀態碼：400

 ** ResourceNotFoundException **   
請求中指定的資源不存在。  
HTTP 狀態碼：404

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

## 另請參閱
<a name="API_ListFunctionsByCodeSigningConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 

# ListFunctionUrlConfigs
<a name="API_ListFunctionUrlConfigs"></a>

傳回指定函數的 Lambda 函數 URL 清單。

## 請求語法
<a name="API_ListFunctionUrlConfigs_RequestSyntax"></a>

```
GET /2021-10-31/functions/FunctionName/urls?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListFunctionUrlConfigs_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_ListFunctionUrlConfigs_RequestSyntax) **   <a name="lambda-ListFunctionUrlConfigs-request-FunctionName"></a>
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) **   <a name="lambda-ListFunctionUrlConfigs-request-Marker"></a>
指定上一個請求傳回的分頁字符，擷取下一個結果頁面。

 ** [MaxItems](#API_ListFunctionUrlConfigs_RequestSyntax) **   <a name="lambda-ListFunctionUrlConfigs-request-MaxItems"></a>
在回應中傳回的函數 URL 數量上限。請注意，`ListFunctionUrlConfigs` 會在每個回應中傳回最多 50 個項目，即使您將數字設定為更高。  
有效範圍：最小值為 1。最大值為 50。

## 請求主體
<a name="API_ListFunctionUrlConfigs_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListFunctionUrlConfigs_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_ListFunctionUrlConfigs_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [FunctionUrlConfigs](#API_ListFunctionUrlConfigs_ResponseSyntax) **   <a name="lambda-ListFunctionUrlConfigs-response-FunctionUrlConfigs"></a>
函數 URL 組態清單。  
類型：[FunctionUrlConfig](API_FunctionUrlConfig.md) 物件陣列

 ** [NextMarker](#API_ListFunctionUrlConfigs_ResponseSyntax) **   <a name="lambda-ListFunctionUrlConfigs-response-NextMarker"></a>
如果多個結果可用，則分頁字符包含在內。  
類型：字串

## 錯誤
<a name="API_ListFunctionUrlConfigs_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListFunctionUrlConfigs_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionUrlConfigs) 

# ListLayers
<a name="API_ListLayers"></a>

列出 [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)相容的層。

## 請求語法
<a name="API_ListLayers_RequestSyntax"></a>

```
GET /2018-10-31/layers?CompatibleArchitecture=CompatibleArchitecture&CompatibleRuntime=CompatibleRuntime&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListLayers_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [CompatibleArchitecture](#API_ListLayers_RequestSyntax) **   <a name="lambda-ListLayers-request-CompatibleArchitecture"></a>
相容[指令集架構](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)的清單。  
有效值:`x86_64 | arm64` 

 ** [CompatibleRuntime](#API_ListLayers_RequestSyntax) **   <a name="lambda-ListLayers-request-CompatibleRuntime"></a>
執行時間識別符。例如 `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) **   <a name="lambda-ListLayers-request-Marker"></a>
上一個呼叫傳回的分頁字符。

 ** [MaxItems](#API_ListLayers_RequestSyntax) **   <a name="lambda-ListLayers-request-MaxItems"></a>
傳回的最大層數。  
有效範圍：最小值為 1。最大值為 50。

## 請求主體
<a name="API_ListLayers_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListLayers_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_ListLayers_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Layers](#API_ListLayers_ResponseSyntax) **   <a name="lambda-ListLayers-response-Layers"></a>
函數層清單。  
類型：[LayersListItem](API_LayersListItem.md) 物件陣列

 ** [NextMarker](#API_ListLayers_ResponseSyntax) **   <a name="lambda-ListLayers-response-NextMarker"></a>
當回應不包含所有層時，傳回分頁字符。  
類型：字串

## 錯誤
<a name="API_ListLayers_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListLayers_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListLayers) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListLayers) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListLayers) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListLayers) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListLayers) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListLayers) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListLayers) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListLayers) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListLayers) 

# ListLayerVersions
<a name="API_ListLayerVersions"></a>

列出 [AWS Lambda 層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)的版本。不會列出已刪除的版本。指定[執行時間識別符](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)以僅列出表示它們與該執行時間相容的版本。指定一個相容的架構，以僅包含與該架構相容的層版本。

## 請求語法
<a name="API_ListLayerVersions_RequestSyntax"></a>

```
GET /2018-10-31/layers/LayerName/versions?CompatibleArchitecture=CompatibleArchitecture&CompatibleRuntime=CompatibleRuntime&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListLayerVersions_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [CompatibleArchitecture](#API_ListLayerVersions_RequestSyntax) **   <a name="lambda-ListLayerVersions-request-CompatibleArchitecture"></a>
相容[指令集架構](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)的清單。  
有效值:`x86_64 | arm64` 

 ** [CompatibleRuntime](#API_ListLayerVersions_RequestSyntax) **   <a name="lambda-ListLayerVersions-request-CompatibleRuntime"></a>
執行時間識別符。例如 `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) **   <a name="lambda-ListLayerVersions-request-LayerName"></a>
layer 的名稱或 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) **   <a name="lambda-ListLayerVersions-request-Marker"></a>
上一個呼叫傳回的分頁字符。

 ** [MaxItems](#API_ListLayerVersions_RequestSyntax) **   <a name="lambda-ListLayerVersions-request-MaxItems"></a>
要傳回的版本數上限。  
有效範圍：最小值為 1。最大值為 50。

## 請求主體
<a name="API_ListLayerVersions_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListLayerVersions_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_ListLayerVersions_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [LayerVersions](#API_ListLayerVersions_ResponseSyntax) **   <a name="lambda-ListLayerVersions-response-LayerVersions"></a>
版本清單。  
類型：[LayerVersionsListItem](API_LayerVersionsListItem.md) 物件陣列

 ** [NextMarker](#API_ListLayerVersions_ResponseSyntax) **   <a name="lambda-ListLayerVersions-response-NextMarker"></a>
當回應不包含所有版本時，傳回分頁字符。  
類型：字串

## 錯誤
<a name="API_ListLayerVersions_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListLayerVersions_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListLayerVersions) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListLayerVersions) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListLayerVersions) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListLayerVersions) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListLayerVersions) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListLayerVersions) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListLayerVersions) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListLayerVersions) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListLayerVersions) 

# ListProvisionedConcurrencyConfigs
<a name="API_ListProvisionedConcurrencyConfigs"></a>

擷取函數的佈建並行組態清單。

## 請求語法
<a name="API_ListProvisionedConcurrencyConfigs_RequestSyntax"></a>

```
GET /2019-09-30/functions/FunctionName/provisioned-concurrency?List=ALL&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListProvisionedConcurrencyConfigs_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_ListProvisionedConcurrencyConfigs_RequestSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-request-FunctionName"></a>
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) **   <a name="lambda-ListProvisionedConcurrencyConfigs-request-Marker"></a>
指定上一個請求傳回的分頁字符，擷取下一個結果頁面。

 ** [MaxItems](#API_ListProvisionedConcurrencyConfigs_RequestSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-request-MaxItems"></a>
指定一個數字，以限制傳回的組態數目。  
有效範圍：最小值為 1。最大值為 50。

## 請求主體
<a name="API_ListProvisionedConcurrencyConfigs_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListProvisionedConcurrencyConfigs_ResponseSyntax"></a>

```
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"
      }
   ]
}
```

## 回應元素
<a name="API_ListProvisionedConcurrencyConfigs_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [NextMarker](#API_ListProvisionedConcurrencyConfigs_ResponseSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-response-NextMarker"></a>
如果多個結果可用，則分頁字符包含在內。  
類型：字串

 ** [ProvisionedConcurrencyConfigs](#API_ListProvisionedConcurrencyConfigs_ResponseSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-response-ProvisionedConcurrencyConfigs"></a>
佈建並行組態清單。  
類型：[ProvisionedConcurrencyConfigListItem](API_ProvisionedConcurrencyConfigListItem.md) 物件陣列

## 錯誤
<a name="API_ListProvisionedConcurrencyConfigs_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListProvisionedConcurrencyConfigs_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 

# ListTags
<a name="API_ListTags"></a>

傳回函數的[標籤](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)。您也可以使用 [GetFunction](API_GetFunction.md) 檢視標籤。

## 請求語法
<a name="API_ListTags_RequestSyntax"></a>

```
GET /2017-03-31/tags/ARN HTTP/1.1
```

## URI 請求參數
<a name="API_ListTags_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [ARN](#API_ListTags_RequestSyntax) **   <a name="lambda-ListTags-request-Resource"></a>
函數的 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-_]+))?`  
必要：是

## 請求主體
<a name="API_ListTags_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListTags_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## 回應元素
<a name="API_ListTags_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Tags](#API_ListTags_ResponseSyntax) **   <a name="lambda-ListTags-response-Tags"></a>
函數的標籤。  
類型：字串到字串映射

## 錯誤
<a name="API_ListTags_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListTags_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListTags) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListTags) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListTags) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListTags) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListTags) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListTags) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListTags) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListTags) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListTags) 

# ListVersionsByFunction
<a name="API_ListVersionsByFunction"></a>

傳回[版本](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html)清單以及各版本的版本特定組態。Lambda 每次呼叫會傳回多達 50 個版本。

## 請求語法
<a name="API_ListVersionsByFunction_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/versions?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI 請求參數
<a name="API_ListVersionsByFunction_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_ListVersionsByFunction_RequestSyntax) **   <a name="lambda-ListVersionsByFunction-request-FunctionName"></a>
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) **   <a name="lambda-ListVersionsByFunction-request-Marker"></a>
指定上一個請求傳回的分頁字符，擷取下一個結果頁面。

 ** [MaxItems](#API_ListVersionsByFunction_RequestSyntax) **   <a name="lambda-ListVersionsByFunction-request-MaxItems"></a>
要傳回的版本數上限。請注意，`ListVersionsByFunction` 會在每個回應中傳回最多 50 個項目，即使您將數字設定為更高。  
有效範圍：最小值為 1。最大值為 10000。

## 請求主體
<a name="API_ListVersionsByFunction_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_ListVersionsByFunction_ResponseSyntax"></a>

```
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"
         }
      }
   ]
}
```

## 回應元素
<a name="API_ListVersionsByFunction_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [NextMarker](#API_ListVersionsByFunction_ResponseSyntax) **   <a name="lambda-ListVersionsByFunction-response-NextMarker"></a>
如果多個結果可用，則分頁字符包含在內。  
類型：字串

 ** [Versions](#API_ListVersionsByFunction_ResponseSyntax) **   <a name="lambda-ListVersionsByFunction-response-Versions"></a>
Lambda 函數版本清單。  
類型：[FunctionConfiguration](API_FunctionConfiguration.md) 物件陣列

## 錯誤
<a name="API_ListVersionsByFunction_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_ListVersionsByFunction_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/ListVersionsByFunction) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/ListVersionsByFunction) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListVersionsByFunction) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/ListVersionsByFunction) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListVersionsByFunction) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListVersionsByFunction) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListVersionsByFunction) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListVersionsByFunction) 

# PublishLayerVersion
<a name="API_PublishLayerVersion"></a>

從 ZIP 封存中建立 [AWS Lambda 層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。每次以相同層名稱呼叫 `PublishLayerVersion` 時，就會建立新的版本。

使用 [CreateFunction](API_CreateFunction.md) 或 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md)，將層新增至函數。

## 請求語法
<a name="API_PublishLayerVersion_RequestSyntax"></a>

```
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 請求參數
<a name="API_PublishLayerVersion_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [LayerName](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-LayerName"></a>
layer 的名稱或 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-_]+`  
必要：是

## 請求主體
<a name="API_PublishLayerVersion_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [CompatibleArchitectures](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-CompatibleArchitectures"></a>
相容[指令集架構](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)的清單。  
類型：字串陣列  
陣列成員：最多 2 個項目。  
有效值:`x86_64 | arm64`   
必要：否

 ** [CompatibleRuntimes](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-CompatibleRuntimes"></a>
相容[函數執行時間](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) **   <a name="lambda-PublishLayerVersion-request-Content"></a>
函數 layer 封存。  
類型：[LayerVersionContentInput](API_LayerVersionContentInput.md) 物件  
必要：是

 ** [Description](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-Description"></a>
版本的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

 ** [LicenseInfo](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-LicenseInfo"></a>
layer 的軟體授權。其可為下列任何一項：  
+ [SPDX 授權識別符](https://spdx.org/licenses/)。例如 `MIT`。
+ 託管在網際網路上授權的 URL。例如 `https://opensource.org/licenses/MIT`。
+ 授權的完整文字。
類型：字串  
長度限制：長度上限為 512。  
必要：否

## 回應語法
<a name="API_PublishLayerVersion_ResponseSyntax"></a>

```
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
}
```

## 回應元素
<a name="API_PublishLayerVersion_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CompatibleArchitectures](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-CompatibleArchitectures"></a>
相容[指令集架構](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html)的清單。  
類型：字串陣列  
陣列成員：最多 2 個項目。  
有效值:`x86_64 | arm64` 

 ** [CompatibleRuntimes](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-CompatibleRuntimes"></a>
層的相容執行時間。  
下列清單包含已淘汰的執行時間。如需詳細資訊，請參閱[執行時間淘汰政策](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) **   <a name="lambda-PublishLayerVersion-response-Content"></a>
有關層版本的詳細資訊。  
類型：[LayerVersionContentOutput](API_LayerVersionContentOutput.md) 物件

 ** [CreatedDate](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-CreatedDate"></a>
建立層版本的日期，採用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [Description](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-Description"></a>
版本的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [LayerArn](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-LayerArn"></a>
該層的 ARN。  
類型：字串  
長度限制：長度下限為 1。長度上限為 140。  
模式：`arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+`

 ** [LayerVersionArn](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-LayerVersionArn"></a>
layer 版本的 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) **   <a name="lambda-PublishLayerVersion-response-LicenseInfo"></a>
layer 的軟體授權。  
類型：字串  
長度限制：長度上限為 512。

 ** [Version](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-Version"></a>
版本號碼。  
類型：Long

## 錯誤
<a name="API_PublishLayerVersion_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_PublishLayerVersion_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PublishLayerVersion) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PublishLayerVersion) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PublishLayerVersion) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PublishLayerVersion) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PublishLayerVersion) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PublishLayerVersion) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PublishLayerVersion) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PublishLayerVersion) 

# PublishVersion
<a name="API_PublishVersion"></a>

從目前的程式碼及函數組態中建立[版本](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)。

## 請求語法
<a name="API_PublishVersion_RequestSyntax"></a>

```
POST /2015-03-31/functions/FunctionName/versions HTTP/1.1
Content-type: application/json

{
   "CodeSha256": "string",
   "Description": "string",
   "RevisionId": "string"
}
```

## URI 請求參數
<a name="API_PublishVersion_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_PublishVersion_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [CodeSha256](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-CodeSha256"></a>
只有在雜湊值符合指定的值時，才發佈版本。使用此選項來避免在您最近一次更新它之後，函數程式碼產生變更時發佈版本。您可以從 [UpdateFunctionCode](API_UpdateFunctionCode.md) 輸出中獲取已上傳版本的雜湊。  
類型：字串  
必要：否

 ** [Description](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-Description"></a>
要複寫函數組態中描述的版本描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

 ** [RevisionId](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-RevisionId"></a>
只有在修訂版本 ID 符合指定的 ID 時才更新函數。如果自從上次更新之後，函數組態發生變更，請使用此選項以避免發佈版本。  
類型：字串  
必要：否

## 回應語法
<a name="API_PublishVersion_ResponseSyntax"></a>

```
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"
   }
}
```

## 回應元素
<a name="API_PublishVersion_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Architectures](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Architectures"></a>
函數支援的指令集架構。架構是具有其中一個有效值的字串陣列。預設架構值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64` 

 ** [CodeSha256](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-CodeSha256"></a>
函數部署套件的 SHA256 雜湊。  
類型：字串

 ** [CodeSize](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-CodeSize"></a>
函數部署套件的大小 (以位元組為單位)。  
類型：Long

 ** [DeadLetterConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-DeadLetterConfig"></a>
函數的無效字母佇列。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件

 ** [Description](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Description"></a>
函數的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [Environment](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Environment"></a>
函數的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。從 AWS CloudTrail 日誌中省略。  
類型：[EnvironmentResponse](API_EnvironmentResponse.md) 物件

 ** [EphemeralStorage](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-EphemeralStorage"></a>
函數的 `/tmp` 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱[設定暫時性儲存 (主控台)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。  
類型：[EphemeralStorage](API_EphemeralStorage.md) 物件

 ** [FileSystemConfigs](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-FileSystemConfigs"></a>
[Amazon EFS 檔案系統](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。

 ** [FunctionArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-PublishVersion-response-FunctionName"></a>
函數的名稱。  
類型：字串  
長度限制：長度下限為 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) **   <a name="lambda-PublishVersion-response-Handler"></a>
Lambda 為了開始執行您的函數所呼叫的函數。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`

 ** [ImageConfigResponse](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-ImageConfigResponse"></a>
函數的映像組態值。  
類型：[ImageConfigResponse](API_ImageConfigResponse.md) 物件

 ** [KMSKeyArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-KMSKeyArn"></a>
用來加密函數[環境變數](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) 時，也會使用此金鑰來加密函數的快照集。只有在您已設定客戶受管金鑰的情況下，才會傳回此金鑰。  
類型：String  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`

 ** [LastModified](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LastModified"></a>
上次更新函數的日期和時間，採用 [ISO-8601](https://www.w3.org/TR/NOTE-datetime) 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [LastUpdateStatus](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LastUpdateStatus"></a>
對函數執行的上次更新的狀態。這是在函數建立完成後首次設定為 `Successful`。  
類型：字串  
有效值:`Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LastUpdateStatusReason"></a>
對函數執行的上次更新的原因。  
類型：字串

 ** [LastUpdateStatusReasonCode](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LastUpdateStatusReasonCode"></a>
對函數執行的上次更新的原因代碼。  
類型：字串  
有效值:`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) **   <a name="lambda-PublishVersion-response-Layers"></a>
函數的[層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。  
類型：[Layer](API_Layer.md) 物件陣列

 ** [LoggingConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件

 ** [MasterArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-MasterArn"></a>
若是 Lambda@Edge 函數，則為主函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-PublishVersion-response-MemorySize"></a>
可供函數在執行階段使用的記憶體量。  
類型：整數  
有效範圍：最小值為 128。最大值為 10240。

 ** [PackageType](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-PackageType"></a>
部署套件的類型。針對容器影像設定為 `Image`，並針對 .zip 檔案封存設定 `Zip`。  
類型：字串  
有效值:`Zip | Image` 

 ** [RevisionId](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-RevisionId"></a>
函數或別名的最新更新修訂版。  
類型：字串

 ** [Role](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Role"></a>
函數的執行角色。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`

 ** [Runtime](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Runtime"></a>
函數的[執行時間](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) **   <a name="lambda-PublishVersion-response-RuntimeVersionConfig"></a>
執行階段的 ARN 和任何發生的錯誤。  
類型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 物件

 ** [SigningJobArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-SigningJobArn"></a>
簽署任務的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SigningProfileVersionArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-SigningProfileVersionArn"></a>
簽署描述檔版本的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SnapStart](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-SnapStart"></a>
將 `ApplyOn` 設為 `PublishedVersions`，即可在您發佈函數版本時建立初始化執行環境的快照。如需詳細資訊，請參閱[使用 Lambda 改善啟動效能 SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)。  
類型：[SnapStartResponse](API_SnapStartResponse.md) 物件

 ** [State](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-State"></a>
函數目前的狀態。當狀態為 `Inactive` 時，您可以透過調用它來重新激活該函數。  
類型：字串  
有效值:`Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-StateReason"></a>
函數目前狀態的原因。  
類型：字串

 ** [StateReasonCode](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-StateReasonCode"></a>
函數目前狀態的原因代碼。當代碼為 `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) **   <a name="lambda-PublishVersion-response-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。  
類型：整數  
有效範圍：最小值為 1。

 ** [TracingConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-TracingConfig"></a>
函數的 AWS X-Ray 追蹤組態。  
類型：[TracingConfigResponse](API_TracingConfigResponse.md) 物件

 ** [Version](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Version"></a>
Lambda 函數的版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [VpcConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-VpcConfig"></a>
函數的聯網設定。  
類型：[VpcConfigResponse](API_VpcConfigResponse.md) 物件

## 錯誤
<a name="API_PublishVersion_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_PublishVersion_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PublishVersion) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PublishVersion) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PublishVersion) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PublishVersion) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PublishVersion) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PublishVersion) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PublishVersion) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PublishVersion) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PublishVersion) 

# PutFunctionCodeSigningConfig
<a name="API_PutFunctionCodeSigningConfig"></a>

更新函數的程式碼簽署組態。下次使用者嘗試將程式碼套件部署至函數時，程式碼簽署組態的變更會生效。

## 請求語法
<a name="API_PutFunctionCodeSigningConfig_RequestSyntax"></a>

```
PUT /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1
Content-type: application/json

{
   "CodeSigningConfigArn": "string"
}
```

## URI 請求參數
<a name="API_PutFunctionCodeSigningConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_PutFunctionCodeSigningConfig_RequestSyntax) **   <a name="lambda-PutFunctionCodeSigningConfig-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_PutFunctionCodeSigningConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [CodeSigningConfigArn](#API_PutFunctionCodeSigningConfig_RequestSyntax) **   <a name="lambda-PutFunctionCodeSigningConfig-request-CodeSigningConfigArn"></a>
程式碼簽署組態的 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}`  
必要：是

## 回應語法
<a name="API_PutFunctionCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfigArn": "string",
   "FunctionName": "string"
}
```

## 回應元素
<a name="API_PutFunctionCodeSigningConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CodeSigningConfigArn](#API_PutFunctionCodeSigningConfig_ResponseSyntax) **   <a name="lambda-PutFunctionCodeSigningConfig-response-CodeSigningConfigArn"></a>
程式碼簽署組態的 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) **   <a name="lambda-PutFunctionCodeSigningConfig-response-FunctionName"></a>
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-_]+))?`

## 錯誤
<a name="API_PutFunctionCodeSigningConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_PutFunctionCodeSigningConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 

# PutFunctionConcurrency
<a name="API_PutFunctionConcurrency"></a>

設定函數的並行執行數上限，並預留該並行層級的容量。

並行設定會套用至整個函數，包括所有已發佈的版本和未發佈的版本。保留並行可確保您的函數有能力同時處理指定數量的事件，並防止它擴展超出該級別。使用 [GetFunction](API_GetFunction.md) 查看函數的目前設定。

使用 [GetAccountSettings](API_GetAccountSettings.md) 查看您的區域並行限制。您可以根據需要為盡可能多的函數保留並行，只要對未設定每個函數限制的函數維持至少 100 個同時執行處於未預留狀態。如需詳細資訊，請參閱 [Lambda 函數擴展](https://docs.aws.amazon.com/lambda/latest/dg/invocation-scaling.html)。

## 請求語法
<a name="API_PutFunctionConcurrency_RequestSyntax"></a>

```
PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1
Content-type: application/json

{
   "ReservedConcurrentExecutions": number
}
```

## URI 請求參數
<a name="API_PutFunctionConcurrency_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_PutFunctionConcurrency_RequestSyntax) **   <a name="lambda-PutFunctionConcurrency-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_PutFunctionConcurrency_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [ReservedConcurrentExecutions](#API_PutFunctionConcurrency_RequestSyntax) **   <a name="lambda-PutFunctionConcurrency-request-ReservedConcurrentExecutions"></a>
要為函數預留的同時執行數。  
類型：整數  
有效範圍：最小值為 0。  
必要：是

## 回應語法
<a name="API_PutFunctionConcurrency_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReservedConcurrentExecutions": number
}
```

## 回應元素
<a name="API_PutFunctionConcurrency_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [ReservedConcurrentExecutions](#API_PutFunctionConcurrency_ResponseSyntax) **   <a name="lambda-PutFunctionConcurrency-response-ReservedConcurrentExecutions"></a>
為此函數保留的並行執行數目。如需詳細資訊，請參閱[管理 Lambda 預留並行](https://docs.aws.amazon.com/lambda/latest/dg/configuration-concurrency.html)。  
類型：整數  
有效範圍：最小值為 0。

## 錯誤
<a name="API_PutFunctionConcurrency_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_PutFunctionConcurrency_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionConcurrency) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionConcurrency) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionConcurrency) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionConcurrency) 

# PutFunctionEventInvokeConfig
<a name="API_PutFunctionEventInvokeConfig"></a>

對函數、版本或別名設定[非同步調用](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html)選項。如果函數、版本或別名的組態已經存在，此操作會覆寫它。如果排除任何設定，則會移除這些設定。若要設定一個選項而不影響其他選項的現有設定，請使用 [UpdateFunctionEventInvokeConfig](API_UpdateFunctionEventInvokeConfig.md)。

根據預設，如果函數傳回錯誤，Lambda 會重試兩次非同步調用。Lambda 會將事件保留在佇列中最多 6 小時。當事件的所有處理嘗試都失敗，或是處於非同步調用佇列中過久，Lambda 就會予以捨棄。若要保留已捨棄的事件，使用 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) 設定無效字母佇列。

若要將調用記錄傳送到佇列、主題、函數或事件匯流排，請指定[目的地](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations)。您可以為成功調用 (on-success) 和所有處理嘗試均失敗 (on-failure) 的事件設定不同的目的地。除了無效字母佇列外，您還可以設定目的地。

## 請求語法
<a name="API_PutFunctionEventInvokeConfig_RequestSyntax"></a>

```
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 請求參數
<a name="API_PutFunctionEventInvokeConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-FunctionName"></a>
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) **   <a name="lambda-PutFunctionEventInvokeConfig-request-Qualifier"></a>
版本號或別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_PutFunctionEventInvokeConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-DestinationConfig"></a>
事件在傳送至函數以進行處理後的目標。  

**目的地**
+  **函數** - Lambda 函數的 Amazon Resource Name (ARN)。
+  **佇列** - 標準 SQS 佇列的 ARN。
+  **主題** - 標準 SNS 主題的 ARN。
+  **活動總線**-Amazon EventBridge 活動總線的 ARN。
類型：[DestinationConfig](API_DestinationConfig.md) 物件  
必要：否

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumEventAgeInSeconds"></a>
Lambda 傳送至函數以進行處理的請求時間上限。  
類型：整數  
有效範圍：最小值為 60。最大值為 21600。  
必要：否

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumRetryAttempts"></a>
當函數傳回錯誤時，重試的次數上限。  
類型：整數  
有效範圍：最小值為 0。最大值為 2。  
必要：否

## 回應語法
<a name="API_PutFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## 回應元素
<a name="API_PutFunctionEventInvokeConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-DestinationConfig"></a>
事件在傳送至函數以進行處理後的目標。  

**目的地**
+  **函數** - Lambda 函數的 Amazon Resource Name (ARN)。
+  **佇列** - 標準 SQS 佇列的 ARN。
+  **主題** - 標準 SNS 主題的 ARN。
+  **活動總線**-Amazon EventBridge 活動總線的 ARN。
類型：[DestinationConfig](API_DestinationConfig.md) 物件

 ** [FunctionArn](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-PutFunctionEventInvokeConfig-response-LastModified"></a>
上次更新組態的日期和時間 (以 Unix 時間秒為單位)。  
類型：Timestamp

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
Lambda 傳送至函數以進行處理的請求時間上限。  
類型：整數  
有效範圍：最小值為 60。最大值為 21600。

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
當函數傳回錯誤時，重試的次數上限。  
類型：整數  
有效範圍：最小值為 0。最大值為 2。

## 錯誤
<a name="API_PutFunctionEventInvokeConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_PutFunctionEventInvokeConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 

# PutProvisionedConcurrencyConfig
<a name="API_PutProvisionedConcurrencyConfig"></a>

新增佈建並行組態至函數別名或版本。

## 請求語法
<a name="API_PutProvisionedConcurrencyConfig_RequestSyntax"></a>

```
PUT /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "ProvisionedConcurrentExecutions": number
}
```

## URI 請求參數
<a name="API_PutProvisionedConcurrencyConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_PutProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-request-FunctionName"></a>
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) **   <a name="lambda-PutProvisionedConcurrencyConfig-request-Qualifier"></a>
版本號或別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`  
必要：是

## 請求主體
<a name="API_PutProvisionedConcurrencyConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [ProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-request-ProvisionedConcurrentExecutions"></a>
要為版本或別名配置的佈建並行量。  
類型：整數  
有效範圍：最小值為 1。  
必要：是

## 回應語法
<a name="API_PutProvisionedConcurrencyConfig_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "AllocatedProvisionedConcurrentExecutions": number,
   "AvailableProvisionedConcurrentExecutions": number,
   "LastModified": "string",
   "RequestedProvisionedConcurrentExecutions": number,
   "Status": "string",
   "StatusReason": "string"
}
```

## 回應元素
<a name="API_PutProvisionedConcurrencyConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 202 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AllocatedProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-AllocatedProvisionedConcurrentExecutions"></a>
已配置的佈建並行數量。在線性和金絲雀部署期間使用加權別名時，此值會根據為函數版本佈建的並行數量而變動。  
類型：整數  
有效範圍：最小值為 0。

 ** [AvailableProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-AvailableProvisionedConcurrentExecutions"></a>
可用的佈建並行數量。  
類型：整數  
有效範圍：最小值為 0。

 ** [LastModified](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-LastModified"></a>
使用者上次更新組態的日期和時間，採用 [ISO 8601 格式](https://www.iso.org/iso-8601-date-and-time-format.html)。  
類型：字串

 ** [RequestedProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-RequestedProvisionedConcurrentExecutions"></a>
請求的佈建並行數量。  
類型：整數  
有效範圍：最小值為 1。

 ** [Status](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-Status"></a>
配置程序的狀態。  
類型：字串  
有效值:`IN_PROGRESS | READY | FAILED` 

 ** [StatusReason](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-StatusReason"></a>
對於失敗的配置，則為無法配置佈建並行的原因。  
類型：字串

## 錯誤
<a name="API_PutProvisionedConcurrencyConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_PutProvisionedConcurrencyConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 

# PutRuntimeManagementConfig
<a name="API_PutRuntimeManagementConfig"></a>

設定函數版本的執行階段管理組態。如需詳細資訊，請參閱[執行階段更新](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html)。

## 請求語法
<a name="API_PutRuntimeManagementConfig_RequestSyntax"></a>

```
PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

## URI 請求參數
<a name="API_PutRuntimeManagementConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-FunctionName"></a>
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) **   <a name="lambda-PutRuntimeManagementConfig-request-Qualifier"></a>
指定函數的版本。這可以是 `$LATEST` 或已發佈的版本編號。如果未指定任何值，則會傳回 `$LATEST` 版本的組態。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_PutRuntimeManagementConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-RuntimeVersionArn"></a>
您希望函數使用的執行階段版本之 ARN。  
只有在使用 **Manual** (手動) 執行階段更新模式時才需要此項。
類型：字串  
長度限制：長度下限為 26。長度上限為 2048。  
模式：`^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$`  
必要：否

 ** [UpdateRuntimeOn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-UpdateRuntimeOn"></a>
指定執行階段更新模式。  
+  **Auto (default)** (自動 (預設)) - 使用[兩階段執行階段版本推展](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-two-phase)，自動更新為最新且安全的執行階段版本。對於大多數客戶來說，這是確保總是能受益於執行階段更新的最佳選擇。
+  **Function update** (函數更新) - 當您更新函數時，Lambda 會將函數的執行階段更新為最新且安全的執行階段版本。這種做法可同步執行階段更新與函數部署，讓您控制何時套用執行階段更新，並及早偵測和減輕罕見的執行階段更新不相容情況。使用此設定時，您需要定期更新函數以保持其執行階段 up-to-date。
+  **Manual** (手動) - 您可以在函數組態中指定執行階段版本。該函數將無限期使用此執行階段版本。在罕見情況下，新的執行階段版本會與現有函數不相容，這可讓您將函數復原至較舊的執行階段版本。如需詳細資訊，請參閱[復原執行階段版本](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-rollback)。
類型：字串  
有效值:`Auto | Manual | FunctionUpdate`   
必要：是

## 回應語法
<a name="API_PutRuntimeManagementConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionArn": "string",
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

## 回應元素
<a name="API_PutRuntimeManagementConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [FunctionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-FunctionArn"></a>
函數的 ARN  
類型：String  
模式：`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) **   <a name="lambda-PutRuntimeManagementConfig-response-RuntimeVersionArn"></a>
設定讓函數使用的執行階段之 ARN。如果執行階段更新模式為 **Manual** (手動)，系統會傳回 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) **   <a name="lambda-PutRuntimeManagementConfig-response-UpdateRuntimeOn"></a>
執行階段更新模式。  
類型：字串  
有效值:`Auto | Manual | FunctionUpdate` 

## 錯誤
<a name="API_PutRuntimeManagementConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_PutRuntimeManagementConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutRuntimeManagementConfig) 

# RemoveLayerVersionPermission
<a name="API_RemoveLayerVersionPermission"></a>

從 [AWS Lambda 層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)版本的許可政策中移除陳述式。如需詳細資訊，請參閱[AddLayerVersionPermission](API_AddLayerVersionPermission.md)。

## 請求語法
<a name="API_RemoveLayerVersionPermission_RequestSyntax"></a>

```
DELETE /2018-10-31/layers/LayerName/versions/VersionNumber/policy/StatementId?RevisionId=RevisionId HTTP/1.1
```

## URI 請求參數
<a name="API_RemoveLayerVersionPermission_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [LayerName](#API_RemoveLayerVersionPermission_RequestSyntax) **   <a name="lambda-RemoveLayerVersionPermission-request-LayerName"></a>
layer 的名稱或 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) **   <a name="lambda-RemoveLayerVersionPermission-request-RevisionId"></a>
只有在修訂版本 ID 符合指定的 ID 時才更新政策。使用此選項來避免修改自您最近一次讀取之後產生變更的政策。

 ** [StatementId](#API_RemoveLayerVersionPermission_RequestSyntax) **   <a name="lambda-RemoveLayerVersionPermission-request-StatementId"></a>
新增陳述式時所指定的識別符。  
長度限制：長度下限為 1。長度上限為 100。  
模式：`([a-zA-Z0-9-_]+)`  
必要：是

 ** [VersionNumber](#API_RemoveLayerVersionPermission_RequestSyntax) **   <a name="lambda-RemoveLayerVersionPermission-request-VersionNumber"></a>
版本號碼。  
必要：是

## 請求主體
<a name="API_RemoveLayerVersionPermission_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_RemoveLayerVersionPermission_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_RemoveLayerVersionPermission_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_RemoveLayerVersionPermission_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_RemoveLayerVersionPermission_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/RemoveLayerVersionPermission) 

# RemovePermission
<a name="API_RemovePermission"></a>

從 AWS 服務或其他 AWS 帳戶中撤銷函數使用許可。可從 [GetPolicy](API_GetPolicy.md) 的輸出中取得陳述式 ID。

## 請求語法
<a name="API_RemovePermission_RequestSyntax"></a>

```
DELETE /2015-03-31/functions/FunctionName/policy/StatementId?Qualifier=Qualifier&RevisionId=RevisionId HTTP/1.1
```

## URI 請求參數
<a name="API_RemovePermission_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_RemovePermission_RequestSyntax) **   <a name="lambda-RemovePermission-request-FunctionName"></a>
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) **   <a name="lambda-RemovePermission-request-Qualifier"></a>
指定版本或別名，以從函數的已發佈版本中移除許可。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

 ** [RevisionId](#API_RemovePermission_RequestSyntax) **   <a name="lambda-RemovePermission-request-RevisionId"></a>
只有在修訂版本 ID 符合指定的 ID 時才更新政策。使用此選項來避免修改自您最近一次讀取之後產生變更的政策。

 ** [StatementId](#API_RemovePermission_RequestSyntax) **   <a name="lambda-RemovePermission-request-StatementId"></a>
要移除的許可的陳述式 ID。  
長度限制：長度下限為 1。長度上限為 100。  
模式：`([a-zA-Z0-9-_.]+)`  
必要：是

## 請求主體
<a name="API_RemovePermission_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_RemovePermission_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_RemovePermission_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_RemovePermission_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_RemovePermission_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/RemovePermission) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/RemovePermission) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/RemovePermission) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/RemovePermission) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/RemovePermission) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/RemovePermission) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/RemovePermission) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/RemovePermission) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/RemovePermission) 

# TagResource
<a name="API_TagResource"></a>

將[標籤](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)新增到函數。

## 請求語法
<a name="API_TagResource_RequestSyntax"></a>

```
POST /2017-03-31/tags/ARN HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI 請求參數
<a name="API_TagResource_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [ARN](#API_TagResource_RequestSyntax) **   <a name="lambda-TagResource-request-Resource"></a>
函數的 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-_]+))?`  
必要：是

## 請求主體
<a name="API_TagResource_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="lambda-TagResource-request-Tags"></a>
要套用到函數的標籤清單。  
類型：字串到字串映射  
必要：是

## 回應語法
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_TagResource_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_TagResource_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_TagResource_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/TagResource) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/TagResource) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/TagResource) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/TagResource) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/TagResource) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/TagResource) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/TagResource) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/TagResource) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

從函數中移除[標籤](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html)。

## 請求語法
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /2017-03-31/tags/ARN?tagKeys=TagKeys HTTP/1.1
```

## URI 請求參數
<a name="API_UntagResource_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [ARN](#API_UntagResource_RequestSyntax) **   <a name="lambda-UntagResource-request-Resource"></a>
函數的 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) **   <a name="lambda-UntagResource-request-TagKeys"></a>
要從函數中移除的標籤金鑰清單。  
必要：是

## 請求主體
<a name="API_UntagResource_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_UntagResource_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_UntagResource_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_UntagResource_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UntagResource) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UntagResource) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UntagResource) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UntagResource) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UntagResource) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UntagResource) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UntagResource) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UntagResource) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UntagResource) 

# UpdateAlias
<a name="API_UpdateAlias"></a>

更新 Lambda 函數[別名](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)的組態。

## 請求語法
<a name="API_UpdateAlias_RequestSyntax"></a>

```
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 請求參數
<a name="API_UpdateAlias_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-FunctionName"></a>
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) **   <a name="lambda-UpdateAlias-request-Name"></a>
別名的名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)`  
必要：是

## 請求主體
<a name="API_UpdateAlias_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [Description](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-Description"></a>
別名的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

 ** [FunctionVersion](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-FunctionVersion"></a>
別名呼叫的函數版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`  
必要：否

 ** [RevisionId](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-RevisionId"></a>
只有在修訂版本 ID 符合指定的 ID 時才更新別名。使用此選項來避免修改自您最近一次讀取之後產生變更的別名。  
類型：字串  
必要：否

 ** [RoutingConfig](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-RoutingConfig"></a>
別名的[路由組態](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing)。  
類型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 物件  
必要：否

## 回應語法
<a name="API_UpdateAlias_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## 回應元素
<a name="API_UpdateAlias_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AliasArn](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-AliasArn"></a>
別名的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-UpdateAlias-response-Description"></a>
別名的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [FunctionVersion](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-FunctionVersion"></a>
別名呼叫的函數版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [Name](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-Name"></a>
別名的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(?!^[0-9]+$)([a-zA-Z0-9-_]+)`

 ** [RevisionId](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-RevisionId"></a>
當您更新別名時，會變更的唯一識別符。  
類型：字串

 ** [RoutingConfig](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-RoutingConfig"></a>
別名的[路由組態](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html)。  
類型：[AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 物件

## 錯誤
<a name="API_UpdateAlias_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_UpdateAlias_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateAlias) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateAlias) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateAlias) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateAlias) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateAlias) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateAlias) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateAlias) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateAlias) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateAlias) 

# UpdateCodeSigningConfig
<a name="API_UpdateCodeSigningConfig"></a>

更新程式碼簽署組態。下次使用者嘗試將程式碼套件部署至函數時，程式碼簽署組態的變更會生效。

## 請求語法
<a name="API_UpdateCodeSigningConfig_RequestSyntax"></a>

```
PUT /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1
Content-type: application/json

{
   "AllowedPublishers": { 
      "SigningProfileVersionArns": [ "string" ]
   },
   "CodeSigningPolicies": { 
      "UntrustedArtifactOnDeployment": "string"
   },
   "Description": "string"
}
```

## URI 請求參數
<a name="API_UpdateCodeSigningConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [CodeSigningConfigArn](#API_UpdateCodeSigningConfig_RequestSyntax) **   <a name="lambda-UpdateCodeSigningConfig-request-CodeSigningConfigArn"></a>
程式碼簽署組態的 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}`  
必要：是

## 請求主體
<a name="API_UpdateCodeSigningConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [AllowedPublishers](#API_UpdateCodeSigningConfig_RequestSyntax) **   <a name="lambda-UpdateCodeSigningConfig-request-AllowedPublishers"></a>
此程式碼簽署組態的簽署設定檔。  
類型：[AllowedPublishers](API_AllowedPublishers.md) 物件  
必要：否

 ** [CodeSigningPolicies](#API_UpdateCodeSigningConfig_RequestSyntax) **   <a name="lambda-UpdateCodeSigningConfig-request-CodeSigningPolicies"></a>
程式碼簽署政策。  
類型：[CodeSigningPolicies](API_CodeSigningPolicies.md) 物件  
必要：否

 ** [Description](#API_UpdateCodeSigningConfig_RequestSyntax) **   <a name="lambda-UpdateCodeSigningConfig-request-Description"></a>
此程式碼簽署組態的描述性名稱。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

## 回應語法
<a name="API_UpdateCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfig": { 
      "AllowedPublishers": { 
         "SigningProfileVersionArns": [ "string" ]
      },
      "CodeSigningConfigArn": "string",
      "CodeSigningConfigId": "string",
      "CodeSigningPolicies": { 
         "UntrustedArtifactOnDeployment": "string"
      },
      "Description": "string",
      "LastModified": "string"
   }
}
```

## 回應元素
<a name="API_UpdateCodeSigningConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [CodeSigningConfig](#API_UpdateCodeSigningConfig_ResponseSyntax) **   <a name="lambda-UpdateCodeSigningConfig-response-CodeSigningConfig"></a>
程式碼簽署組態  
類型：[CodeSigningConfig](API_CodeSigningConfig.md) 物件

## 錯誤
<a name="API_UpdateCodeSigningConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** InvalidParameterValueException **   
請求中的其中一個參數無效。  
HTTP 狀態碼：400

 ** ResourceNotFoundException **   
請求中指定的資源不存在。  
HTTP 狀態碼：404

 ** ServiceException **   
AWS Lambda 服務發生內部錯誤。  
HTTP 狀態碼：500

## 另請參閱
<a name="API_UpdateCodeSigningConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateCodeSigningConfig) 

# UpdateEventSourceMapping
<a name="API_UpdateEventSourceMapping"></a>

更新事件來源映射。您無法變更 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)。設定為 infinite (-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) 

## 請求語法
<a name="API_UpdateEventSourceMapping_RequestSyntax"></a>

```
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 請求參數
<a name="API_UpdateEventSourceMapping_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [UUID](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-UUID"></a>
事件來源映射的識別符。  
必要：是

## 請求主體
<a name="API_UpdateEventSourceMapping_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [BatchSize](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-BatchSize"></a>
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) **   <a name="lambda-UpdateEventSourceMapping-request-BisectBatchOnFunctionError"></a>
(僅限 Kinesis 和 DynamoDB Streams) 如果函數傳回錯誤，將批次分割為兩個並重試。  
類型：布林值  
必要：否

 ** [DestinationConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-DestinationConfig"></a>
(僅限 Kinesis、DynamoDB Streams、Amazon MSK 和自我管理的 Kafka) 指定在 Lambda 處理過後事件目的地的組態物件。  
類型：[DestinationConfig](API_DestinationConfig.md) 物件  
必要：否

 ** [DocumentDBEventSourceConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-DocumentDBEventSourceConfig"></a>
DocumentDB 事件來源的具體組態設定。  
類型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 物件  
必要：否

 ** [Enabled](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-Enabled"></a>
當為 true 時，則事件來源映射處於作用中狀態。當為 false 時，Lambda 會暫停輪詢與調用。  
預設：True  
類型：布林值  
必要：否

 ** [FilterCriteria](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-FilterCriteria"></a>
定義篩選條件標準的物件，用於決定 Lambda 是否應該處理事件。如需詳細資訊，請參閱 [Lambda 事件篩選](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。  
類型：[FilterCriteria](API_FilterCriteria.md) 物件  
必要：否

 ** [FunctionName](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-FunctionName"></a>
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) **   <a name="lambda-UpdateEventSourceMapping-request-FunctionResponseTypes"></a>
(Kinesis、DynamoDB Streams 和 Amazon SQS) 套用至事件來源映射的目前回應類型列舉清單。  
類型：字串陣列  
陣列成員：項目數下限為 0。項目數上限為 1。  
有效值:`ReportBatchItemFailures`   
必要：否

 ** [MaximumBatchingWindowInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumBatchingWindowInSeconds"></a>
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) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumRecordAgeInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) 捨棄超過指定存留期的記錄。預設值為無限 (-1)。  
類型：整數  
有效範圍：最小值為 -1。最大值為 604800。  
必要：否

 ** [MaximumRetryAttempts](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumRetryAttempts"></a>
(僅限 Kinesis 和 DynamoDB Streams) 在指定的重試次數之後捨棄記錄。預設值為無限 (-1)。設定為 infinite (-1) 時，系統會重試失敗的記錄，直到記錄到期為止。  
類型：整數  
有效範圍：最小值為 -1。最大值為 10000。  
必要：否

 ** [ParallelizationFactor](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-ParallelizationFactor"></a>
(僅限 Kinesis 和 DynamoDB Streams) 要從各個碎片同時處理的批次數。  
類型：整數  
有效範圍：最小值為 1。最大值為 10。  
必要：否

 ** [ScalingConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-ScalingConfig"></a>
(僅限 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) **   <a name="lambda-UpdateEventSourceMapping-request-SourceAccessConfigurations"></a>
保護事件來源所需的身分驗證協定或 VPC 元件。  
類型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 物件陣列  
陣列成員：項目數下限為 0。項目數上限為 22。  
必要：否

 ** [TumblingWindowInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-TumblingWindowInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) DynamoDB 和 Kinesis Streams 事件來源處理時段的持續時間 (以秒為單位)。值為 0 秒代表沒有輪轉時段。  
類型：整數  
有效範圍：最小值為 0。最大值為 900。  
必要：否

## 回應語法
<a name="API_UpdateEventSourceMapping_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_UpdateEventSourceMapping_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 202 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AmazonManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件來源的具體組態設定。  
類型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 物件

 ** [BatchSize](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-BatchSize"></a>
Lambda 從串流或佇列中提取並傳送至函數的每個批次中的記錄數目上限。Lambda 會將批次中的所有記錄以單一呼叫形式傳送至函數，直到達到同步調用的承載限制 (6 MB)。  
預設值：依服務而異。對於 Amazon SQS，預設值為 10。對於所有其他服務，預設值為 100。  
相關設定：當您將 `BatchSize` 設定為大於 10 的值時，必須將 `MaximumBatchingWindowInSeconds` 至少設定為 1。  
類型：整數  
有效範圍：最小值為 1。最大值為 10000。

 ** [BisectBatchOnFunctionError](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(僅限 Kinesis 和 DynamoDB Streams) 如果函數傳回錯誤，將批次分割為兩個並重試。預設值為 false。  
類型：布林值

 ** [DestinationConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-DestinationConfig"></a>
(僅限 Kinesis、DynamoDB Streams、Amazon MSK 和自我管理的 Apache 卡夫卡事件來源) 一種組態物件，可在 Lambda 處理事件後指定事件的目的地。  
類型：[DestinationConfig](API_DestinationConfig.md) 物件

 ** [DocumentDBEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
DocumentDB 事件來源的具體組態設定。  
類型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 物件

 ** [EventSourceArn](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-EventSourceArn"></a>
事件來源的 Amazon Resource Name (ARN)。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [FilterCriteria](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FilterCriteria"></a>
定義篩選條件標準的物件，用於決定 Lambda 是否應該處理事件。如需詳細資訊，請參閱 [Lambda 事件篩選](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。  
類型：[FilterCriteria](API_FilterCriteria.md) 物件

 ** [FunctionArn](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FunctionArn"></a>
Lambda 函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-UpdateEventSourceMapping-response-FunctionResponseTypes"></a>
(Kinesis、DynamoDB Streams 和 Amazon SQS) 套用至事件來源映射的目前回應類型列舉清單。  
類型：字串陣列  
陣列成員：項目數下限為 0。項目數上限為 1。  
有效值:`ReportBatchItemFailures` 

 ** [LastModified](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-LastModified"></a>
上次更新事件來源映射或其狀態變更的日期 (以 Unix 時間秒為單位)。  
類型：Timestamp

 ** [LastProcessingResult](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-LastProcessingResult"></a>
函數的最後一次 Lambda 調用的結果。  
類型：字串

 ** [MaximumBatchingWindowInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
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) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) 捨棄超過指定存留期的記錄。預設值為 -1，這會將最大存留期設定為無限。當值設定為無限時，Lambda 永遠不會捨棄舊記錄。  
最大記錄保留期的最小有效值為 60 秒。雖然小於 60 且大於 -1 的值在參數的絕對範圍內，但不允許這些值
類型：整數  
有效範圍：最小值為 -1。最大值為 604800。

 ** [MaximumRetryAttempts](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumRetryAttempts"></a>
(僅限 Kinesis 和 DynamoDB Streams) 在指定的重試次數之後捨棄記錄。預設值為 -1，這會將重試數上限設定為無限。如果 MaximumRetryAttempts 是無限的，Lambda 會重試失敗的記錄，直到事件來源中的記錄到期為止。  
類型：整數  
有效範圍：最小值為 -1。最大值為 10000。

 ** [ParallelizationFactor](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-ParallelizationFactor"></a>
(僅限 Kinesis 和 DynamoDB Streams) 要從每個碎片中同時處理的批次數。預設值為 1。  
類型：整數  
有效範圍：最小值為 1。最大值為 10。

 ** [Queues](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-Queues"></a>
 (Amazon MQ) 要使用的 Amazon MQ 代理程式目的地佇列的名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 1000。  
模式：`[\s\S]*`

 ** [ScalingConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-ScalingConfig"></a>
(僅限 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) **   <a name="lambda-UpdateEventSourceMapping-response-SelfManagedEventSource"></a>
用於事件來源的自我管理型 Apache Kafka 叢集。  
類型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 物件

 ** [SelfManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
用於自我管理的 Apache Kafka 事件來源的具體組態設定。  
類型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 物件

 ** [SourceAccessConfigurations](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-SourceAccessConfigurations"></a>
保護和定義事件來源的身分驗證協定、VPC 元件或虛擬主機。  
類型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 物件陣列  
陣列成員：項目數下限為 0。項目數上限為 22。

 ** [StartingPosition](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StartingPosition"></a>
要從中開始讀取的串流位置。Amazon Kinesis 和 Amazon DynamoDB Stream 事件來源所必需。Amazon Kinesis 串流、Amazon DocumentDB、Amazon MSK 以及自我管理的 Apache Kafka 僅支援 `AT_TIMESTAMP`。  
類型：字串  
有效值:`TRIM_HORIZON | LATEST | AT_TIMESTAMP` 

 ** [StartingPositionTimestamp](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StartingPositionTimestamp"></a>
將 `StartingPosition` 設定為 `AT_TIMESTAMP`，這是開始讀取的時間 (以 Unix 時間秒為單位)。`StartingPositionTimestamp` 不能為未來的時間。  
類型：Timestamp

 ** [State](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-State"></a>
事件來源映射的狀態。可為下列其中之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。  
類型：字串

 ** [StateTransitionReason](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StateTransitionReason"></a>
指出使用者或 Lambda 是否對事件來源映射進行最後的變更。  
類型：字串

 ** [Topics](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-Topics"></a>
Kafka 主題名稱。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
長度限制：長度下限為 1。長度上限為 249。  
模式：`^[^.]([a-zA-Z0-9\-_.]+)`

 ** [TumblingWindowInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-TumblingWindowInSeconds"></a>
(僅限 Kinesis 和 DynamoDB Streams) DynamoDB 和 Kinesis Streams 事件來源處理時段的持續時間 (以秒為單位)。值為 0 秒代表沒有輪轉時段。  
類型：整數  
有效範圍：最小值為 0。最大值為 900。

 ** [UUID](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-UUID"></a>
事件來源映射的識別符。  
類型：字串

## 錯誤
<a name="API_UpdateEventSourceMapping_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_UpdateEventSourceMapping_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateEventSourceMapping) 

# UpdateFunctionCode
<a name="API_UpdateFunctionCode"></a>

更新 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)。

如果函數套件類型是 `Zip`，那麼您必須將部署套件指定為 [.zip 封存檔](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip)。輸入 Amazon S3 儲存貯體和程式碼 .zip 檔案位置的金鑰。您也可以使用 `ZipFile` 欄位來提供內嵌的函數程式碼。

部署套件中的程式碼必須與函數 (`x86-64` 或 `arm64`) 的目標指令集架構相容。

當您發佈版本時，函數的程式碼被鎖定。您無法修改已發佈版本的程式碼，只能修改未發佈版本。

**注意**  
對於定義為容器映像的函數，Lambda 會將映像標籤解析為映像摘要。在 Amazon ECR 中，如果您將映像標籤更新為新映像，則 Lambda 不會自動更新該函數。

## 請求語法
<a name="API_UpdateFunctionCode_RequestSyntax"></a>

```
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 請求參數
<a name="API_UpdateFunctionCode_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_UpdateFunctionCode_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [Architectures](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-Architectures"></a>
函數支援的指令集架構。輸入具有其中一個有效值 (arm64 或 x86\$164) 的字串陣列。預設值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64`   
必要：否

 ** [DryRun](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-DryRun"></a>
設定為 true 可驗證請求參數並存取許可，而無需修改函數程式碼。  
類型：布林值  
必要：否

 ** [ImageUri](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-ImageUri"></a>
Amazon ECR 登錄檔中容器映像的 URI。請勿將此函數用於以 .zip 檔案封存定義的函數。  
類型：字串  
必要：否

 ** [Publish](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-Publish"></a>
設為 true，以在更新程式碼之後發佈新版本的函數。此操作與單獨呼叫 [PublishVersion](API_PublishVersion.md) 效果相同。  
類型：布林值  
必要：否

 ** [RevisionId](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-RevisionId"></a>
只有在修訂版本 ID 符合指定的 ID 時才更新函數。使用此選項來避免修改自您最近一次讀取之後產生變更的函數。  
類型：字串  
必要：否

 ** [S3Bucket](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-S3Bucket"></a>
與您的函數位於同一 AWS 區域的 Amazon S3 儲存貯體。儲存貯體可位於不同的 AWS 帳戶中。只能與 .zip 檔案封存部署套件定義的函數搭配使用。  
類型：字串  
長度限制：長度下限為 3。長度上限為 63。  
模式：`^[0-9A-Za-z\.\-_]*(?<!\.)$`  
必要：否

 ** [S3Key](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-S3Key"></a>
部署套件的 Amazon S3 金鑰。只能與 .zip 檔案封存部署套件定義的函數搭配使用。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
必要：否

 ** [S3ObjectVersion](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-S3ObjectVersion"></a>
對於版本控制的物件，要使用的部署套件物件版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
必要：否

 ** [ZipFile](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-ZipFile"></a>
部署套件的 base64 編碼內容。AWSSDK 和 AWS CLI 用戶端會為您處理編碼。只能與 .zip 檔案封存部署套件定義的函數搭配使用。  
類型：Base64 編碼的二進位資料物件  
必要：否

## 回應語法
<a name="API_UpdateFunctionCode_ResponseSyntax"></a>

```
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"
   }
}
```

## 回應元素
<a name="API_UpdateFunctionCode_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Architectures](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Architectures"></a>
函數支援的指令集架構。架構是具有其中一個有效值的字串陣列。預設架構值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64` 

 ** [CodeSha256](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-CodeSha256"></a>
函數部署套件的 SHA256 雜湊。  
類型：字串

 ** [CodeSize](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-CodeSize"></a>
函數部署套件的大小 (以位元組為單位)。  
類型：Long

 ** [DeadLetterConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-DeadLetterConfig"></a>
函數的無效字母佇列。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件

 ** [Description](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Description"></a>
函數的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [Environment](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Environment"></a>
函數的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。從 AWS CloudTrail 日誌中省略。  
類型：[EnvironmentResponse](API_EnvironmentResponse.md) 物件

 ** [EphemeralStorage](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-EphemeralStorage"></a>
函數的 `/tmp` 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱[設定暫時性儲存 (主控台)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。  
類型：[EphemeralStorage](API_EphemeralStorage.md) 物件

 ** [FileSystemConfigs](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-FileSystemConfigs"></a>
[Amazon EFS 檔案系統](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。

 ** [FunctionArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-UpdateFunctionCode-response-FunctionName"></a>
函數的名稱。  
類型：字串  
長度限制：長度下限為 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) **   <a name="lambda-UpdateFunctionCode-response-Handler"></a>
Lambda 為了開始執行您的函數所呼叫的函數。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`

 ** [ImageConfigResponse](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-ImageConfigResponse"></a>
函數的映像組態值。  
類型：[ImageConfigResponse](API_ImageConfigResponse.md) 物件

 ** [KMSKeyArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-KMSKeyArn"></a>
用來加密函數[環境變數](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) 時，也會使用此金鑰來加密函數的快照集。只有在您已設定客戶受管金鑰的情況下，才會傳回此金鑰。  
類型：String  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`

 ** [LastModified](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LastModified"></a>
上次更新函數的日期和時間，採用 [ISO-8601](https://www.w3.org/TR/NOTE-datetime) 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [LastUpdateStatus](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LastUpdateStatus"></a>
對函數執行的上次更新的狀態。這是在函數建立完成後首次設定為 `Successful`。  
類型：字串  
有效值:`Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LastUpdateStatusReason"></a>
對函數執行的上次更新的原因。  
類型：字串

 ** [LastUpdateStatusReasonCode](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LastUpdateStatusReasonCode"></a>
對函數執行的上次更新的原因代碼。  
類型：字串  
有效值:`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) **   <a name="lambda-UpdateFunctionCode-response-Layers"></a>
函數的[層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。  
類型：[Layer](API_Layer.md) 物件陣列

 ** [LoggingConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件

 ** [MasterArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-MasterArn"></a>
若是 Lambda@Edge 函數，則為主函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-UpdateFunctionCode-response-MemorySize"></a>
可供函數在執行階段使用的記憶體量。  
類型：整數  
有效範圍：最小值為 128。最大值為 10240。

 ** [PackageType](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-PackageType"></a>
部署套件的類型。針對容器影像設定為 `Image`，並針對 .zip 檔案封存設定 `Zip`。  
類型：字串  
有效值:`Zip | Image` 

 ** [RevisionId](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-RevisionId"></a>
函數或別名的最新更新修訂版。  
類型：字串

 ** [Role](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Role"></a>
函數的執行角色。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`

 ** [Runtime](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Runtime"></a>
函數的[執行時間](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) **   <a name="lambda-UpdateFunctionCode-response-RuntimeVersionConfig"></a>
執行階段的 ARN 和任何發生的錯誤。  
類型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 物件

 ** [SigningJobArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-SigningJobArn"></a>
簽署任務的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SigningProfileVersionArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-SigningProfileVersionArn"></a>
簽署描述檔版本的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SnapStart](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-SnapStart"></a>
將 `ApplyOn` 設為 `PublishedVersions`，即可在您發佈函數版本時建立初始化執行環境的快照。如需詳細資訊，請參閱[使用 Lambda 改善啟動效能 SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)。  
類型：[SnapStartResponse](API_SnapStartResponse.md) 物件

 ** [State](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-State"></a>
函數目前的狀態。當狀態為 `Inactive` 時，您可以透過調用它來重新激活該函數。  
類型：字串  
有效值:`Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-StateReason"></a>
函數目前狀態的原因。  
類型：字串

 ** [StateReasonCode](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-StateReasonCode"></a>
函數目前狀態的原因代碼。當代碼為 `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) **   <a name="lambda-UpdateFunctionCode-response-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。  
類型：整數  
有效範圍：最小值為 1。

 ** [TracingConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-TracingConfig"></a>
函數的 AWS X-Ray 追蹤組態。  
類型：[TracingConfigResponse](API_TracingConfigResponse.md) 物件

 ** [Version](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Version"></a>
Lambda 函數的版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [VpcConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-VpcConfig"></a>
函數的聯網設定。  
類型：[VpcConfigResponse](API_VpcConfigResponse.md) 物件

## 錯誤
<a name="API_UpdateFunctionCode_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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 **   
程式碼簽章無法進行完整性檢查。如果完整性檢查失敗，即使程式碼簽署政策設定為 WARN，Lambda 仍會阻止部署。  
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

## 另請參閱
<a name="API_UpdateFunctionCode_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionCode) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionCode) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionCode) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionCode) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionCode) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionCode) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionCode) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionCode) 

# UpdateFunctionConfiguration
<a name="API_UpdateFunctionConfiguration"></a>

修改 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)。

## 請求語法
<a name="API_UpdateFunctionConfiguration_RequestSyntax"></a>

```
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 請求參數
<a name="API_UpdateFunctionConfiguration_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-FunctionName"></a>
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-_]+))?`  
必要：是

## 請求主體
<a name="API_UpdateFunctionConfiguration_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [DeadLetterConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-DeadLetterConfig"></a>
無效字母佇列組態，可指定在處理失敗時，Lambda 傳送的非同步事件的佇列或主題。如需詳細資訊，請參閱[無效字母佇列](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq)。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件  
必要：否

 ** [Description](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Description"></a>
函數的敘述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
必要：否

 ** [Environment](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Environment"></a>
環境變數，可在執行期間透過函數程式碼取得。  
類型：[Environment](API_Environment.md) 物件  
必要：否

 ** [EphemeralStorage](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-EphemeralStorage"></a>
函數的 `/tmp` 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱[設定暫時性儲存 (主控台)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。  
類型：[EphemeralStorage](API_EphemeralStorage.md) 物件  
必要：否

 ** [FileSystemConfigs](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-FileSystemConfigs"></a>
Amazon EFS 檔案系統的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。  
必要：否

 ** [Handler](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Handler"></a>
程式碼中的方法名稱，Lambda 會呼叫此程式碼來執行您的函數。如果部署套件是 .zip 檔案封存，則需要處理常式。格式包含檔案名稱。它也可以包含命名空間和其他限定詞，取決於執行時間。如需詳細資訊，請參閱 [Lambda 程式設計模型](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html)。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`  
必要：否

 ** [ImageConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-ImageConfig"></a>
 [容器映像組態值](https://docs.aws.amazon.com/lambda/latest/dg/images-parms.html)，它們會覆寫容器映像 Docker 檔案中的值。  
類型：[ImageConfig](API_ImageConfig.md) 物件  
必要：否

 ** [KMSKeyArn](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-KMSKeyArn"></a>
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 會使用預設服務金鑰。  
類型：String  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`  
必要：否

 ** [Layers](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Layers"></a>
要新增到函數執行環境的[函數 Layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。依 ARN 指定每個 layer (包括版本)。  
類型：字串陣列  
長度限制：長度下限為 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) **   <a name="lambda-UpdateFunctionConfiguration-request-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件  
必要：否

 ** [MemorySize](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-MemorySize"></a>
[可供函數在執行階段使用的記憶體量](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) **   <a name="lambda-UpdateFunctionConfiguration-request-RevisionId"></a>
只有在修訂版本 ID 符合指定的 ID 時才更新函數。使用此選項來避免修改自您最近一次讀取之後產生變更的函數。  
類型：字串  
必要：否

 ** [Role](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Role"></a>
函數執行角色的 Amazon Resource Name (ARN)。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：否

 ** [Runtime](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Runtime"></a>
函數的[執行時間](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) **   <a name="lambda-UpdateFunctionConfiguration-request-SnapStart"></a>
功能的[SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)設定。  
類型：[SnapStart](API_SnapStart.md) 物件  
必要：否

 ** [Timeout](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。預設為 3 秒。允許的最大值為 900 秒。如需詳細資訊，請參閱 [Lambda 執行環境](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html)。  
類型：整數  
有效範圍：最小值為 1。  
必要：否

 ** [TracingConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-TracingConfig"></a>
將 `Mode` 設為 `Active`，使用 [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) 取樣及追蹤一部分的傳入請求。  
類型：[TracingConfig](API_TracingConfig.md) 物件  
必要：否

 ** [VpcConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-VpcConfig"></a>
對於 VPC 中 AWS 資源的網路連線，指定 VPC 中安全群組和子網路的清單。將函數連接到 VPC 時，只能透過該 VPC 存取資源和網際網路。如需詳細資訊，請參閱[設定 Lambda 函數以存取 VPC 中的資源](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html)。  
類型：[VpcConfig](API_VpcConfig.md) 物件  
必要：否

## 回應語法
<a name="API_UpdateFunctionConfiguration_ResponseSyntax"></a>

```
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"
   }
}
```

## 回應元素
<a name="API_UpdateFunctionConfiguration_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [Architectures](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Architectures"></a>
函數支援的指令集架構。架構是具有其中一個有效值的字串陣列。預設架構值為 `x86_64`。  
類型：字串陣列  
陣列成員：固定項目數為 1。  
有效值:`x86_64 | arm64` 

 ** [CodeSha256](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-CodeSha256"></a>
函數部署套件的 SHA256 雜湊。  
類型：字串

 ** [CodeSize](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-CodeSize"></a>
函數部署套件的大小 (以位元組為單位)。  
類型：Long

 ** [DeadLetterConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-DeadLetterConfig"></a>
函數的無效字母佇列。  
類型：[DeadLetterConfig](API_DeadLetterConfig.md) 物件

 ** [Description](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Description"></a>
函數的描述。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。

 ** [Environment](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Environment"></a>
函數的[環境變數](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html)。從 AWS CloudTrail 日誌中省略。  
類型：[EnvironmentResponse](API_EnvironmentResponse.md) 物件

 ** [EphemeralStorage](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-EphemeralStorage"></a>
函數的 `/tmp` 目錄大小，以 MB 為單位。預設值為 512，但可以是介於 512 和 10,240 MB 之間的任何非負整數。如需詳細資訊，請參閱[設定暫時性儲存 (主控台)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage)。  
類型：[EphemeralStorage](API_EphemeralStorage.md) 物件

 ** [FileSystemConfigs](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-FileSystemConfigs"></a>
[Amazon EFS 檔案系統](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html)的連線設定。  
類型：[FileSystemConfig](API_FileSystemConfig.md) 物件陣列  
陣列成員：最多 1 個項目。

 ** [FunctionArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-UpdateFunctionConfiguration-response-FunctionName"></a>
函數的名稱。  
類型：字串  
長度限制：長度下限為 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) **   <a name="lambda-UpdateFunctionConfiguration-response-Handler"></a>
Lambda 為了開始執行您的函數所呼叫的函數。  
類型：字串  
長度限制：長度上限為 128。  
模式：`[^\s]+`

 ** [ImageConfigResponse](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-ImageConfigResponse"></a>
函數的映像組態值。  
類型：[ImageConfigResponse](API_ImageConfigResponse.md) 物件

 ** [KMSKeyArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-KMSKeyArn"></a>
用來加密函數[環境變數](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) 時，也會使用此金鑰來加密函數的快照集。只有在您已設定客戶受管金鑰的情況下，才會傳回此金鑰。  
類型：String  
模式：`(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`

 ** [LastModified](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LastModified"></a>
上次更新函數的日期和時間，採用 [ISO-8601](https://www.w3.org/TR/NOTE-datetime) 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [LastUpdateStatus](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LastUpdateStatus"></a>
對函數執行的上次更新的狀態。這是在函數建立完成後首次設定為 `Successful`。  
類型：字串  
有效值:`Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LastUpdateStatusReason"></a>
對函數執行的上次更新的原因。  
類型：字串

 ** [LastUpdateStatusReasonCode](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LastUpdateStatusReasonCode"></a>
對函數執行的上次更新的原因代碼。  
類型：字串  
有效值:`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) **   <a name="lambda-UpdateFunctionConfiguration-response-Layers"></a>
函數的[層](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)。  
類型：[Layer](API_Layer.md) 物件陣列

 ** [LoggingConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LoggingConfig"></a>
該功能的 Amazon CloudWatch 日誌配置設置。  
類型：[LoggingConfig](API_LoggingConfig.md) 物件

 ** [MasterArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-MasterArn"></a>
若是 Lambda@Edge 函數，則為主函數的 ARN。  
類型：String  
模式：`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) **   <a name="lambda-UpdateFunctionConfiguration-response-MemorySize"></a>
可供函數在執行階段使用的記憶體量。  
類型：整數  
有效範圍：最小值為 128。最大值為 10240。

 ** [PackageType](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-PackageType"></a>
部署套件的類型。針對容器影像設定為 `Image`，並針對 .zip 檔案封存設定 `Zip`。  
類型：字串  
有效值:`Zip | Image` 

 ** [RevisionId](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-RevisionId"></a>
函數或別名的最新更新修訂版。  
類型：字串

 ** [Role](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Role"></a>
函數的執行角色。  
類型：String  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`

 ** [Runtime](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Runtime"></a>
函數的[執行時間](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) **   <a name="lambda-UpdateFunctionConfiguration-response-RuntimeVersionConfig"></a>
執行階段的 ARN 和任何發生的錯誤。  
類型：[RuntimeVersionConfig](API_RuntimeVersionConfig.md) 物件

 ** [SigningJobArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-SigningJobArn"></a>
簽署任務的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SigningProfileVersionArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-SigningProfileVersionArn"></a>
簽署描述檔版本的 ARN。  
類型：String  
模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`

 ** [SnapStart](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-SnapStart"></a>
將 `ApplyOn` 設為 `PublishedVersions`，即可在您發佈函數版本時建立初始化執行環境的快照。如需詳細資訊，請參閱[使用 Lambda 改善啟動效能 SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)。  
類型：[SnapStartResponse](API_SnapStartResponse.md) 物件

 ** [State](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-State"></a>
函數目前的狀態。當狀態為 `Inactive` 時，您可以透過調用它來重新激活該函數。  
類型：字串  
有效值:`Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-StateReason"></a>
函數目前狀態的原因。  
類型：字串

 ** [StateReasonCode](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-StateReasonCode"></a>
函數目前狀態的原因代碼。當代碼為 `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) **   <a name="lambda-UpdateFunctionConfiguration-response-Timeout"></a>
Lambda 在停止函數前允許函數執行的時間 (以秒為單位)。  
類型：整數  
有效範圍：最小值為 1。

 ** [TracingConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-TracingConfig"></a>
函數的 AWS X-Ray 追蹤組態。  
類型：[TracingConfigResponse](API_TracingConfigResponse.md) 物件

 ** [Version](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Version"></a>
Lambda 函數的版本。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`(\$LATEST|[0-9]+)`

 ** [VpcConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-VpcConfig"></a>
函數的聯網設定。  
類型：[VpcConfigResponse](API_VpcConfigResponse.md) 物件

## 錯誤
<a name="API_UpdateFunctionConfiguration_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** CodeSigningConfigNotFoundException **   
指定的程式碼簽署組態不存在。  
HTTP 狀態碼：404

 ** CodeVerificationFailedException **   
程式碼簽章無法進行一個或多個驗證檢查，因為簽章不符或到期，程式碼簽署政策設定為 ENFORCE。Lambda 會阻止部署。  
HTTP 狀態碼：400

 ** InvalidCodeSignatureException **   
程式碼簽章無法進行完整性檢查。如果完整性檢查失敗，即使程式碼簽署政策設定為 WARN，Lambda 仍會阻止部署。  
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

## 另請參閱
<a name="API_UpdateFunctionConfiguration_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionConfiguration) 

# UpdateFunctionEventInvokeConfig
<a name="API_UpdateFunctionEventInvokeConfig"></a>

更新函數、版本或別名的非同步調用的組態。

若要設定非同步調用選項，請使用 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)。

## 請求語法
<a name="API_UpdateFunctionEventInvokeConfig_RequestSyntax"></a>

```
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 請求參數
<a name="API_UpdateFunctionEventInvokeConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-FunctionName"></a>
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) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-Qualifier"></a>
版本號或別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(|[a-zA-Z0-9$_-]+)`

## 請求主體
<a name="API_UpdateFunctionEventInvokeConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [DestinationConfig](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-DestinationConfig"></a>
事件在傳送至函數以進行處理後的目標。  

**目的地**
+  **函數** - Lambda 函數的 Amazon Resource Name (ARN)。
+  **佇列** - 標準 SQS 佇列的 ARN。
+  **主題** - 標準 SNS 主題的 ARN。
+  **活動總線**-Amazon EventBridge 活動總線的 ARN。
類型：[DestinationConfig](API_DestinationConfig.md) 物件  
必要：否

 ** [MaximumEventAgeInSeconds](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-MaximumEventAgeInSeconds"></a>
Lambda 傳送至函數以進行處理的請求時間上限。  
類型：整數  
有效範圍：最小值為 60。最大值為 21600。  
必要：否

 ** [MaximumRetryAttempts](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-MaximumRetryAttempts"></a>
當函數傳回錯誤時，重試的次數上限。  
類型：整數  
有效範圍：最小值為 0。最大值為 2。  
必要：否

## 回應語法
<a name="API_UpdateFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## 回應元素
<a name="API_UpdateFunctionEventInvokeConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [DestinationConfig](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-DestinationConfig"></a>
事件在傳送至函數以進行處理後的目標。  

**目的地**
+  **函數** - Lambda 函數的 Amazon Resource Name (ARN)。
+  **佇列** - 標準 SQS 佇列的 ARN。
+  **主題** - 標準 SNS 主題的 ARN。
+  **活動總線**-Amazon EventBridge 活動總線的 ARN。
類型：[DestinationConfig](API_DestinationConfig.md) 物件

 ** [FunctionArn](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-LastModified"></a>
上次更新組態的日期和時間 (以 Unix 時間秒為單位)。  
類型：Timestamp

 ** [MaximumEventAgeInSeconds](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
Lambda 傳送至函數以進行處理的請求時間上限。  
類型：整數  
有效範圍：最小值為 60。最大值為 21600。

 ** [MaximumRetryAttempts](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
當函數傳回錯誤時，重試的次數上限。  
類型：整數  
有效範圍：最小值為 0。最大值為 2。

## 錯誤
<a name="API_UpdateFunctionEventInvokeConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_UpdateFunctionEventInvokeConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 

# UpdateFunctionUrlConfig
<a name="API_UpdateFunctionUrlConfig"></a>

更新 Lambda 函數 URL 的組態。

## 請求語法
<a name="API_UpdateFunctionUrlConfig_RequestSyntax"></a>

```
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 請求參數
<a name="API_UpdateFunctionUrlConfig_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [FunctionName](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-FunctionName"></a>
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) **   <a name="lambda-UpdateFunctionUrlConfig-request-Qualifier"></a>
別名名稱。  
長度限制：長度下限為 1。長度上限為 128。  
模式：`(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))`

## 請求主體
<a name="API_UpdateFunctionUrlConfig_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [AuthType](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-AuthType"></a>
函數 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) **   <a name="lambda-UpdateFunctionUrlConfig-request-Cors"></a>
函數 URL 的[跨來源資源共享 (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 設定。  
類型：[Cors](API_Cors.md) 物件  
必要：否

 ** [InvokeMode](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-InvokeMode"></a>
使用下列其中一個選項：  
+  `BUFFERED` – 此為預設選項。Lambda 會使用 `Invoke` API 操作調用您的函數。承載完成時，即可使用調用結果。承載大小上限為 6 MB。
+  `RESPONSE_STREAM` – 當承載結果變得可用時，函數會串流它們。Lambda 會使用 `InvokeWithResponseStream` API 操作調用您的函數。回應承載大小上限為 20 MB，不過，您可以[請求增加配額](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。
類型：字串  
有效值:`BUFFERED | RESPONSE_STREAM`   
必要：否

## 回應語法
<a name="API_UpdateFunctionUrlConfig_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_UpdateFunctionUrlConfig_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [AuthType](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-AuthType"></a>
函數 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) **   <a name="lambda-UpdateFunctionUrlConfig-response-Cors"></a>
函數 URL 的[跨來源資源共享 (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 設定。  
類型：[Cors](API_Cors.md) 物件

 ** [CreationTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-CreationTime"></a>
建立函數 URL 時使用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

 ** [FunctionArn](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-FunctionArn"></a>
函數的 Amazon Resource Name (ARN)。  
類型：String  
模式：`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) **   <a name="lambda-UpdateFunctionUrlConfig-response-FunctionUrl"></a>
函數的 HTTP URL 端點。  
類型：字串  
長度限制：長度下限為 40。長度上限為 100。

 ** [InvokeMode](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-InvokeMode"></a>
使用下列其中一個選項：  
+  `BUFFERED` – 此為預設選項。Lambda 會使用 `Invoke` API 操作調用您的函數。承載完成時，即可使用調用結果。承載大小上限為 6 MB。
+  `RESPONSE_STREAM` – 當承載結果變得可用時，函數會串流它們。Lambda 會使用 `InvokeWithResponseStream` API 操作調用您的函數。回應承載大小上限為 20 MB，不過，您可以[請求增加配額](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)。
類型：字串  
有效值:`BUFFERED | RESPONSE_STREAM` 

 ** [LastModifiedTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-LastModifiedTime"></a>
最近一次更新函數 URL 組態的時間，採用 [ISO-8601 格式](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD)。  
類型：字串

## 錯誤
<a name="API_UpdateFunctionUrlConfig_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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

## 另請參閱
<a name="API_UpdateFunctionUrlConfig_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionUrlConfig)