本文介绍 API 请求的组成及示例说明。

请求结构

请求 URL 由如下部分组成：

参数 描述

API 入口

API 调用的 webservice 入口。
统一为 https://api.qingcloud.com/iaas/

公共参数

每个 API 调用都需要包含公共参数。详见公共参数。

指令名称

API action 指令的名称，例如 DescribeInstances 。

指令参数

指令相关配置参数。

请求示例

一个典型的 API 请求如下所示，这是一个 DescribeInstances 的 API 请求：

https://api.qingcloud.com/iaas/?access_key_id=QYACCESSKEYIDEXAMPLE&action=DescribeInstances&expires=2020-08-29T07%3A42%3A25Z&limit=20&signature_method=HmacSHA256&signature_version=1&status.1=running&time_stamp=2020-08-29T06%3A42%3A25Z&version=1&zone=pek3b&signature=ihPnXFgsg5yyqhDN2IejJ2%2Bbo89ABQ1UqFkyOdzRITY%3D

转换为便于查阅的模式，如下：

https://api.qingcloud.com/iaas/?access_key_id=QYACCESSKEYIDEXAMPLE
&action=DescribeInstances
&expires=2020-08-29T07%3A42%3A25Z
&limit=20
&signature_method=HmacSHA256
&signature_version=1
&status.1=running
&time_stamp=2020-08-29T06%3A42%3A25Z
&version=1
&zone=pek3b
&signature=ihPnXFgsg5yyqhDN2IejJ2%2Bbo89ABQ1UqFkyOdzRITY%3D