You need to enable JavaScript to run this app.
导航
DescribeTopics
最近更新时间:2024.05.30 14:44:46首次发布时间:2022.05.11 11:26:47

调用 DescribeTopics 接口获取日志项目的所有日志主题信息。

使用说明

此接口用于查看指定日志项目下的日志主题列表。支持分页查询、按偏移量查询、按日志主题名称和 ID 模糊查询。
此接口的调用频率限制为 20 次/s,超出频率限制会报错 ExceedQPSLimit。

请求说明

  • 请求方式:GET
  • 请求地址:https://tls-{Region}.ivolces.com/DescribeTopics

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数类型是否必选示例值描述
PageNumberInteger1分页查询时的页码。默认为 1,即从第一页数据开始返回。
PageSizeInteger10分页大小。默认为 20,最大为 100。
TopicNameStringtest日志主题名称,支持模糊匹配。
TopicIdString77日志主题 ID,支持模糊匹配。
ProjectIdString6622a14b-770f-4171-a385-3b68486f****日志项目 ID,支持模糊匹配。
ProjectNameStringtest-tls日志项目名称,支持模糊匹配。
TagsString[{\"key\":\"key2\",\"Value\":\"value1\"}]根据日志主题标签进行筛选。支持的筛选方式请参考根据标签筛选资源

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数类型示例值描述
TotalInteger2日志主题数量。
TopicsArray of DescribeResp日志主题列表。

DescribeResp

参数类型示例值描述
TtlInteger3650日志主题的数据保存时间,单位为天。

Tags

Array of Tag

[{"Key":"key1","Value":"value1"}]

日志项目标签信息。

标签用于云资源的标识与分类,您可以将日志项目、日志主题通过标签进行归类,便于资源的搜索和资源聚合。详细说明请参考标签管理

HotTtl

Integer

7

此参数用于在开启低频存储后,设置数据在标准存储的保留时长,超过该时长后,数据会自动沉降至低频存储进行后续保存,直到日志采集到服务端的总时长达到日志存储时长时,被后端服务自动清理。

此参数仅在 EnableHotTtl 为 true 时返回。

TopicIdStringfaf6d529-e75e-457f-a23a-9c4203a6dff3日志主题 ID。

AutoSplit

Boolean

true

是否开启分区的自动分裂功能。

开启后,当写入的数据量连续 5 分钟超过已有分区服务能力时,日志服务会根据数据量自动分裂分区以满足业务需求,但分裂后的分区数量不可超出最大分裂数。最近 15 分钟内分裂出来的新分区不会自动分裂。

  • true:已开启。
  • false:已关闭。
ProjectIdStringf**********日志主题所属的日志项目 ID。
TopicNameStringtest-project日志主题名称。
CreateTimeString2021-08-19 11:41:29日志主题创建时间。
ModifyTimeString2021-08-19 11:41:32日志主题修改时间。
ShardCountInteger2日志主题 Shard 个数。
DescriptionStringThis is a test topic日志主题的描述。

LogPublicIP

Boolean

false

是否开启了记录外网 IP 功能。

  • true:已开启。
  • false:已关闭。
EnableHotTtlBooleantrue是否开启低频存储。开启后,标准存储的数据在标准存储保存一段时间之后自动转化为低频存储类型。未开启则不返回此字段。
MaxSplitShardInteger10分区的最大分裂数,即分区分裂后,所有分区的最大数量。

EnableTracking

Boolean

false

是否开启了 WebTracking 功能,开启后,可以通过 WebTracking 快速采集前端埋点数据。

  • true:已开启
  • false:已关闭

Tag

参数类型示例值描述
KeyStringowner标签 Key 的值。设置规则请参考标签设置规则
ValueStringzhangsan标签 Value 的值。设置规则请参考标签设置规则

请求示例

GET https://tls-{Region}.ivolces.com/DescribeTopics?ProjectId=662***&PageNumber=1&PageSize=10&TopicName=tes&IsFullName=false&Tags=[{"Key":"key1","Value":"value1"}] HTTP/1.1

返回示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
...
{
    "Total": 2,
    "Topics": [
        {
            "TopicName": "test****",
            "ProjectId": "c7e0****",
            "ProjectName": "test****",
            "TopicId": "b80f****",
            "Ttl": 1023,
            "CreateTime": "2023-12-19 11:41:29",
            "ModifyTime": "2023-12-19 11:41:32",
            "ShardCount": 2,
            "Description": "test that this is a test s",
            "AutoSplit":true,
            "MaxSplitShard":10,
            "EnableTracking":false,
            "LogPublicIP": false,
            "Tags":[
                {
                    "Key":"key1",
                    "Value":"value1"
                }
            ]
        },
        {
            "TopicName": "test17-2",
            "ProjectId": "c7e0*********",
            "ProjectName": "test****",
            "TopicId": "bcb2*********",
            "Ttl": 1023,
            "CreateTime": "2021-08-19 10:43:13",
            "ModifyTime": "2021-08-19 10:43:16",
            "ShardCount": 2,
            "Description": "test that this is a test s",
            "AutoSplit":true,
            "MaxSplitShard":10,
            "EnableTracking":false,
            "Tags":[
                {
                    "Key":"key1",
                    "Value":"value1"
                }
            ]
        }
    ]
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HTTP 状态码错误码错误信息说明
400InvalidArgumentInvalid argument key %s, value %s, please check argument.参数不合法。
404TopicNotExisttopic %s does not exist.日志主题不存在。
500InternalServerErrorWe encountered an unexpected server error, please try again later.服务器内部错误。