GetFunctionUrlConfig - AWS Lambda

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

GetFunctionUrlConfig

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

請求語法

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

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-_]+))

請求主體

請求沒有請求主體。

回應語法

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

ResourceNotFoundException

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

HTTP 狀態碼:404

ServiceException

AWS Lambda 服務發生內部錯誤。

HTTP 狀態碼:500

TooManyRequestsException

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

HTTP 狀態碼:429

另請參閱

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