接口请求参数

最近更新时间:2020-04-28 09:02:33

一个完整的腾讯云 API 请求需要两类请求参数:公共请求参数和接口请求参数。本文将介绍腾讯云 API 请求需要用到的接口请求参数,有关公共请求参数的详细说明请参见 公共请求参数 章节。
接口请求参数与具体的接口有关,不同的接口支持的接口请求参数也不一样。接口请求参数的首字母均为小写,以此区分于公共请求参数。

注意:

文章中的参数以腾讯云 CVM 为例,各腾讯云产品的实际参数请对应实际产品 API 参数说明。

以下参数列表以腾讯云 CVM 查看实例列表 接口(DescribeInstances)为例,该 API 支持的接口请求参数如下:

参数名称 描述 类型 必选
instanceIds.n 要查询的 CVM 实例 ID 数组,数组下标从0开始。可以使用 instanceId 和 unInstanceId,建议使用统一资源 ID:unInstanceId。 String
lanIps.n 要查询的云服务器的内网 IP 数组。 String
searchWord 用户设定的主机别名。 String
offset 记录开始的偏移,第一条记录为0,以此类推。 Int
limit 一次最多可查询的服务器数量,默认为20,最大为100。 Int
status 待查询的主机状态。 Int
projectId 项目 ID,不传则查询全部项目的 CVM 实例。0表示默认项目,如需指定其他项目,可调用 查询项目列表(DescribeProject)接口查询。 String
simplify 获取非实时数据,当传参添加 simplify=1 时获取非实时数据。 Int
zoneId 可用区 ID,不传则查询所有可用区的 CVM 实例。如需指定可用区,可调用 查询可用区列表(DescribeZones)接口查询。 Int

其中各字段的说明如下:

参数名称:该接口支持的请求参数名,用户可以在使用此接口时将其作为接口请求参数。如果参数名称以“.n”结尾,则表明此参数为一个数组,使用时需要依次传入数组参数。
必选:标志此参数是否是必须的,若为“是”,则表明调用该接口必须传入此参数;若为“否”,表示可以不传入。
类型:此接口参数的数据类型。
描述:简要描述了此接口请求参数的内容。

使用示例

腾讯各云产品 API 请求链接中,接口请求参数的形式如下,以腾讯云 CVM 为例,假设用户想要查询伸缩组列表,则其请求链接的形式为:

https://cvm.api.qcloud.com/v2/index.php?
&<公共请求参数>
&instanceIds.0=ins-0hm4gvho
&instanceIds.1=ins-8oby8q00
&offset=0
&limit=20
&status=2
&zoneId=100003