REST 资源:admin.projects.locations.topics

资源:主题

有关主题资源的元数据。

JSON 表示

{
  "name": string,
  "partitionConfig": {
    object (PartitionConfig)
  },
  "retentionConfig": {
    object (RetentionConfig)
  }
}
字段
name

string

主题的名称。结构如下:projects/{project_number}/locations/{location}/topics/{topicId}

partitionConfig

object (PartitionConfig)

此主题的分区的设置。

retentionConfig

object (RetentionConfig)

此主题的消息保留设置。

PartitionConfig

主题分区的设置。

JSON 表示

{
  "count": string,
  "scale": integer
}
字段
count

string (int64 format)

主题中的分区数量。不得低于 1。

scale

integer

主题中的每个分区都分配有相当于标准分区吞吐量(4 MiB/s)scale 倍的吞吐量。这也会反映在此主题的费用中;对于 scale 为 2 且计数为 10 的主题,您需要为 20 个分区支付费用。此值必须在范围内 [1,4]。

RetentionConfig

主题的消息保留设置。

JSON 表示

{
  "perPartitionBytes": string,
  "period": string
}
字段
perPartitionBytes

string (int64 format)

为每个分区预配的存储空间(以字节为单位)。如果主题的任何分区中存储的字节数超过此值,则无论 period 的值如何,较旧的消息都将被舍弃以容纳新的消息。

period

string (Duration format)

已发布消息的保留时间。如果未设置,只要每个分区保留的字节数低于 perPartitionBytes,系统就会保留消息。

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

方法

create

创建一个新主题。

delete

删除指定的主题。

get

返回主题配置。

getPartitions

返回所请求主题的分区信息。

list

返回给定项目的主题列表。

patch

更新指定主题的属性。