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

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

CreateFunctionUrlConfig

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

請求語法

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

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

URI 請求參數

請求會使用下列 URI 參數。

FunctionName

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 201
Content-type: application/json

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

回應元素

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

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

AuthType

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

錯誤

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

InvalidParameterValueException

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

HTTP 狀態碼：400

ResourceConflictException

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

HTTP 狀態碼：409

ResourceNotFoundException

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

HTTP 狀態碼：404

ServiceException

AWS Lambda 服務發生內部錯誤。

HTTP 狀態碼：500

TooManyRequestsException

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

HTTP 狀態碼：429

另請參閱

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