资源:版本
Version
是配置和静态文件的集合,用于确定站点的显示方式。
JSON 表示 |
---|
{ "name": string, "status": enum ( |
领域 | |
---|---|
name | 版本的完全限定资源名称,格式为: 当您调用 |
status | 版本的部署状态。 要成功部署,请调用 请注意,如果您将版本保持 您还可以通过调用 |
config | 站点行为的配置。此配置存在于 |
labels | 用于额外元数据和/或过滤的标签。 包含 |
createTime | 仅输出。创建版本的时间。 RFC3339 UTC“Zulu”格式的时间戳,具有纳秒分辨率和最多九个小数位。示例: |
createUser | 仅输出。标识创建版本的用户。 |
finalizeTime | 仅输出。版本 RFC3339 UTC“Zulu”格式的时间戳,具有纳秒分辨率和最多九个小数位。示例: |
finalizeUser | 仅输出。标识 |
deleteTime | 仅输出。 RFC3339 UTC“Zulu”格式的时间戳,具有纳秒分辨率和最多九个小数位。示例: |
deleteUser | 仅输出。标识 |
fileCount | 仅输出。与版本关联的文件总数。 该值是在版本 |
versionBytes | 仅输出。版本的总存储字节大小。 该值是在版本 |
版本状态
部署生命周期中特定版本的当前已知状态。
枚举 | |
---|---|
VERSION_STATUS_UNSPECIFIED | 默认状态;不应有意使用。 |
CREATED | 版本已创建,当前正在向版本添加内容。 |
FINALIZED | 所有内容已添加到版本中,版本无法再更改。 |
DELETED | 该版本已被删除。 |
ABANDONED | 12小时内版本未更新为FINALIZED ,被自动删除。 |
EXPIRED | 该版本超出了站点配置的保留版本数量限制,因此计划删除该版本的内容。 |
CLONING | 该版本是从另一个版本克隆的。所有内容仍在复制中。 |
服务配置
在提供内容之前应如何路由和处理传入站点的请求的配置。 URL 请求路径与配置中指定的 URL 模式进行匹配,然后托管根据特定的优先级顺序应用适用的配置。
JSON 表示 |
---|
{ "headers": [ { object ( |
领域 | |
---|---|
headers[] | 对象数组,其中每个对象指定一个 URL 模式,如果与请求 URL 路径匹配,则触发 Hosting 应用指定的自定义响应标头。 |
redirects[] | 对象数组(称为重定向规则),其中每个规则指定一个 URL 模式,如果与请求 URL 路径匹配,则触发 Hosting 以重定向到指定目标路径进行响应。 |
rewrites[] | 对象数组(称为重写规则),其中每个规则指定一个 URL 模式,如果该模式与请求 URL 路径匹配,则触发 Hosting 进行响应,就像为服务提供了指定的目标 URL 一样。 |
cleanUrls | 定义是否从上传的文件中删除文件扩展名。 |
trailingSlashBehavior | 定义如何处理 URL 路径中的尾部斜杠。 |
i18n | 选修的。定义 i18n 重写行为。 |
标头
Header
指定 URL 模式,如果与请求 URL 路径匹配,则触发 Hosting 应用指定的自定义响应标头。
JSON 表示 |
---|
{ "headers": { string: string, ... }, // Union field |
领域 | |
---|---|
headers | 必需的。要添加到响应中的附加标头。 包含 |
联盟场pattern 。必需的。与请求 URL 路径匹配的字符串 URL 模式,以确定是否应用此自定义响应标头。可以是 Bash 样式的 glob 或 RE2 正则表达式。 pattern 只能是以下之一: | |
glob | 用户提供的用于与请求 URL 路径匹配的glob 。 |
regex | 用户提供的 RE2 正则表达式,用于与请求 URL 路径进行匹配。 |
重定向
Redirect
指定一个 URL 模式,如果与请求 URL 路径匹配,则触发 Hosting 以重定向到指定的目标路径进行响应。
JSON 表示 |
---|
{ "statusCode": integer, "location": string, // Union field |
领域 | |
---|---|
statusCode | 必需的。响应中返回的状态 HTTP 代码。它必须是有效的 3xx 状态代码。 |
location | 必需的。要放入响应的 HTTP 位置标头中的值。 该位置可以包含模式中的捕获组值,使用 |
联盟场pattern 。必需的。与请求 URL 路径相匹配的字符串 URL 模式,以确定是否应用此重定向。可以是 Bash 样式的 glob 或 RE2 正则表达式。 pattern 只能是以下之一: | |
glob | 用户提供的用于与请求 URL 路径匹配的glob 。 |
regex | 用户提供的 RE2 正则表达式,用于与请求 URL 路径进行匹配。 |
改写
Rewrite
指定一个 URL 模式,如果该模式与请求 URL 路径匹配,则会触发托管进行响应,就像为服务提供了指定的目标 URL 一样。
JSON 表示 |
---|
{ "functionRegion": string, // Union field |
领域 | |
---|---|
functionRegion | 选修的。指定用于重写函数调用的云区域。如果未提供,则默认为 us-central1。 |
联盟场pattern 。必需的。与请求 URL 路径相匹配的字符串 URL 模式,以确定是否应用此重写。可以是 Bash 样式的 glob 或 RE2 正则表达式。 pattern 只能是以下之一: | |
glob | 用户提供的用于与请求 URL 路径匹配的glob 。 |
regex | 用户提供的 RE2 正则表达式,用于与请求 URL 路径进行匹配。 |
联盟场behavior 。必需的。重写的行为。 behavior 只能是以下之一: | |
path | 将请求重写到的 URL 路径。 |
function | 代理请求的函数。必须与导出的函数名称完全匹配。 |
run | 该请求将转发到 Cloud Run。 |
云运行重写
将请求定向到 Cloud Run 服务的已配置重写。如果在设置或更新 Firebase 托管配置时 Cloud Run 服务不存在,则请求将失败。 Cloud Run 服务中的任何错误都会传递给最终用户(例如,如果您删除服务,则指向该服务的任何请求都会收到404
错误)。
JSON 表示 |
---|
{ "serviceId": string, "region": string, "tag": string } |
领域 | |
---|---|
serviceId | 必需的。 Cloud Run 服务的用户定义 ID。 |
region | 选修的。用户提供的托管 Cloud Run 服务的区域。 如果未提供,则默认为 |
tag | 选修的。用户提供的用于发送流量的 TrafficConfig 标记。 省略时,流量将发送到服务范围的 URI |
尾随斜杠行为
定义是否应在请求 URL 路径中添加或删除尾部斜杠。
枚举 | |
---|---|
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED | 没有指定行为。 文件仅在其确切位置提供,尾部斜杠仅添加到目录索引中。 |
ADD | 尾部斜杠将添加到目录索引以及任何不以文件扩展名结尾的 URL 路径。 |
REMOVE | 尾部斜杠将从目录索引以及任何不以文件扩展名结尾的 URL 路径中删除。 |
I18n配置
如果提供,则启用 i18n 重写。
JSON 表示 |
---|
{ "root": string } |
领域 | |
---|---|
root | 必需的。用户提供的路径,将在公共目录中查找特定于国家/地区和语言的内容。 |
方法 | |
---|---|
| 使用指定版本的内容在指定目标站点上创建新版本。 |
| 为指定站点创建新版本。 |
| 删除指定版本。 |
| 获取已为指定站点创建的指定版本。 |
| 列出已为指定站点创建的版本。 |
| 更新指定版本的指定元数据。 |
| 将内容文件添加到指定版本。 |