UpdateFunctionUrlConfig - AWS Lambda
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

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

UpdateFunctionUrlConfig

更新 Lambda 函數 URL 的組態。

請求語法

PUT /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "InvokeMode": "string"
}

URI 請求參數

請求會使用下列 URI 參數。

FunctionName

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

別名名稱。

長度限制：長度下限為 1。長度上限為 128。

模式：(^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))

請求主體

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

AuthType

函數 URL 使用的身分驗證類型。如果您希望只讓完成驗證的使用者存取，請設為 AWS_IAM。如果您希望繞過 IAM 驗證以建立公有端點，請設為 NONE。如需詳細資訊，請參閱 Lambda 函數 URL 的安全性和身分驗證模型。

類型：字串

有效值:NONE | AWS_IAM

必要：否

Cors

函數 URL 的跨來源資源共享 (CORS) 設定。

類型：Cors 物件

必要：否

InvokeMode

使用下列其中一個選項：

  • BUFFERED – 此為預設選項。Lambda 會使用 Invoke API 操作調用您的函數。承載完成時，即可使用調用結果。承載大小上限為 6 MB。

  • RESPONSE_STREAM – 當承載結果變得可用時，函數會串流它們。Lambda 會使用 InvokeWithResponseStream API 操作調用您的函數。回應承載大小上限為 20 MB，不過，您可以請求增加配額。

類型：字串

有效值:BUFFERED | RESPONSE_STREAM

必要：否

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "CreationTime": "string",
   "FunctionArn": "string",
   "FunctionUrl": "string",
   "InvokeMode": "string",
   "LastModifiedTime": "string"
}

回應元素

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

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

AuthType

函數 URL 使用的身分驗證類型。如果您希望只讓完成驗證的使用者存取，請設為 AWS_IAM。如果您希望繞過 IAM 驗證以建立公有端點，請設為 NONE。如需詳細資訊，請參閱 Lambda 函數 URL 的安全性和身分驗證模型。

類型：字串

有效值:NONE | AWS_IAM

Cors

函數 URL 的跨來源資源共享 (CORS) 設定。

類型：Cors 物件

CreationTime

建立函數 URL 時使用 ISO-8601 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。

類型：字串

FunctionArn

函數的 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

函數的 HTTP URL 端點。

類型：字串

長度限制：長度下限為 40。長度上限為 100。

InvokeMode

使用下列其中一個選項：

  • BUFFERED – 此為預設選項。Lambda 會使用 Invoke API 操作調用您的函數。承載完成時，即可使用調用結果。承載大小上限為 6 MB。

  • RESPONSE_STREAM – 當承載結果變得可用時，函數會串流它們。Lambda 會使用 InvokeWithResponseStream API 操作調用您的函數。回應承載大小上限為 20 MB，不過，您可以請求增加配額。

類型：字串

有效值:BUFFERED | RESPONSE_STREAM

LastModifiedTime

最近一次更新函數 URL 組態的時間，採用 ISO-8601 格式 (YYYY-MM-DDThh:mm:ss.sTZD)。

類型：字串

錯誤

如需所有動作常見錯誤的資訊，請參閱常見錯誤。

InvalidParameterValueException

請求中的其中一個參數無效。

HTTP 狀態碼：400

ResourceConflictException

資源已存在，或另一個操作正在進行中。

HTTP 狀態碼：409

ResourceNotFoundException

請求中指定的資源不存在。

HTTP 狀態碼：404

ServiceException

AWS Lambda 服務發生內部錯誤。

HTTP 狀態碼：500

TooManyRequestsException

超出請求輸送量限制。如需詳細資訊，請參閱 Lambda 配額。

HTTP 狀態碼：429

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：