一个完整的腾讯云 API 请求需要两类请求参数:公共请求参数和接口请求参数。本文将介绍腾讯云 API 请求需要用到的接口请求参数,有关公共请求参数的详细说明请参见 公共请求参数 章节。
接口请求参数与具体的接口有关,不同的接口支持的接口请求参数也不一样。接口请求参数的首字母均为小写,以此区分于公共请求参数。
注意:文章中的参数以腾讯云 Ckafka 为例,各腾讯云产品的实际参数请对应实际产品 API 参数说明。
以下参数列表以腾讯云 Ckafka 查询实例列表 接口(ListInstances)为例,该 API 支持的接口请求参数如下:
参数名称 | 描述 | 类型 | 必选 |
---|---|---|---|
instanceId | (过滤条件)按照实例 ID 过滤。 | String | 否 |
searchWord | (过滤条件)按照实例名称过滤,支持模糊查询。 | String | 否 |
status | (过滤条件)实例的状态。0:创建中,1:运行中,2:删除中,不填默认返回全部。 | Int | 否 |
offset | 记录开始的偏移,第一条记录为0,以此类推。 | Int | 否 |
limit | 一次最多可查询的服务器数量,默认为10,最大为20。 | Int | 否 |
tagKey | 匹配标签key值。 | String | 否 |
其中各字段的说明如下:
参数名称:该接口支持的请求参数名,用户可以在使用此接口时将其作为接口请求参数。如果参数名称以“.n”
结尾,则表明此参数为一个数组,使用时需要依次传入数组参数。
必选:标志此参数是否是必须的,若为“是”,则表明调用该接口必须传入此参数;若为“否”,表示可以不传入。
类型:此接口参数的数据类型。
描述:简要描述了此接口请求参数的内容。
使用示例
腾讯各云产品 API 请求链接中,接口请求参数的形式如下,以腾讯云 Ckafka 为例,假设用户想要查询伸缩组列表,则其请求链接的形式为:
https://ckafka.api.qcloud.com/v2/index.php? &<公共请求参数> &instanceId=ckafka-0hm4gvho &offset=0 &limit=20 &status=1