返回有关 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 的 cross-origin resource sharing (CORS)
（跨源资源共享）设置。 类型：Cors 对象
- CreationTime
-
创建函数 URL 时，使用 ISO-8601 格式
(YYYY-MM-DDThh:mm:ss.sTZD)。 类型：字符串
- FunctionArn
-
函数的 Amazon Resource Name (ARN)。
类型：字符串
模式：
arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))? - FunctionUrl
-
函数的 HTTP URL 端点。
类型：字符串
长度限制：最小长度为 40。最大长度为 100。
- InvokeMode
-
使用以下选项之一：
-
BUFFERED– 这是默认选项。Lambda 通过InvokeAPI 操作调用函数。负载完成后，调用结果可用。最大负载大小为 6MB。 -
RESPONSE_STREAM– 函数能够在负载结果可用时对其进行流式处理。Lambda 通过InvokeWithResponseStreamAPI 操作调用函数。最大响应负载大小为 20MB，但是，您可以请求提高限额。
类型：字符串
有效值：
BUFFERED | RESPONSE_STREAM -
- LastModifiedTime
-
上次更新函数 URL 时，采用 ISO-8601 格式
(YYYY-MM-DDThh:mm:ss.sTZD)。 类型：字符串
错误
有关所有操作返回的常见错误的信息，请参阅 常见错误。
- InvalidParameterValueException
-
请求中的参数之一无效。
HTTP 状态代码：400
- ResourceNotFoundException
-
请求中指定的资源不存在。
HTTP 状态代码：404
- ServiceException
-
Amazon Lambda 服务遇到了内部错误。
HTTP 状态代码：500
- TooManyRequestsException
-
超出了请求吞吐量限制。有关更多信息，请参阅 Lambda 限额。
HTTP 状态代码：429
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：