REST Resource: sites.channels

资源:频道

Channel代表站点的发布流。所有网站都有一个默认live频道,向 Firebase 提供的子域和任何连接的自定义域提供内容。

JSON 表示
{
  "name": string,
  "url": string,
  "release": {
    object (Release)
  },
  "createTime": string,
  "updateTime": string,
  "retainedReleaseCount": integer,
  "labels": {
    string: string,
    ...
  },

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
领域
name

string

通道的完全限定资源名称,格式为:

sites/ SITE_ID /channels/ CHANNEL_ID

url

string

仅输出。可以查看该频道当前版本内容的 URL。此 URL 是 Firebase 提供的web.app子域。

还可以在 Firebase 提供的firebaseapp.com子域中查看此频道当前版本的内容。

如果此频道是托管站点的live频道,则也可以在任何连接的自定义域中查看此频道当前版本的内容。

release

object ( Release )

仅输出。频道的当前版本(如果有)。

createTime

string ( Timestamp format)

仅输出。创建频道的时间。

RFC3339 UTC“Zulu”格式的时间戳,具有纳秒分辨率和最多九个小数位。示例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string ( Timestamp format)

仅输出。频道上次更新的时间。

RFC3339 UTC“Zulu”格式的时间戳,具有纳秒分辨率和最多九个小数位。示例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

retainedReleaseCount

integer

为了回滚或其他目的而保留在通道上的先前版本的数量。

必须是 1-100 之间的数字。新通道默认为 10。

labels

map (key: string, value: string)

用于额外元数据和/或过滤的文本标签。

包含"key": value对。示例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

联盟场expiration

expiration只能是以下其中之一:

expireTime

string ( Timestamp format)

自动删除频道的时间。

如果为空,则不会自动删除频道。无论是直接设置还是通过ttl字段设置,该字段都会出现在输出中。

RFC3339 UTC“Zulu”格式的时间戳,具有纳秒分辨率和最多九个小数位。示例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

ttl

string ( Duration format)

仅输入。该频道的生存时间。将expireTime设置为请求时间之后提供的持续时间。

以秒为单位的持续时间,最多包含九个小数位,以“ s ”结尾。示例: "3.5s"

方法

create

在指定站点中创建新频道。

delete

删除指定站点的指定频道。

get

检索指定站点的指定频道的信息。

list

列出指定站点的频道。

patch

更新指定站点的指定频道的信息。