尚航云_V1 API 是尚航云_V1开放生态的基石。通过云 API,只需执行对应 API 命令行工具即可快速操作云产品;在熟练的情况下,使用一些频繁使用的功能,使用云 API 可以极大的提高效率;通过 API 可以组合功能,实现更高级的功能,易于自动化, 易于远程调用, 兼容性强,对系统要求低。
通过 API,您可以以接口的形式访问尚航云_V1的各类资源,以此构建自己的资源管理系统、自动化运维系统、售卖平台、开发工具等。
首先请点击这里 下载尚航云_V1 API 的最新版本 SDK,并将其放入您的代码中,然后按照特定的形式调用接口。这里以 PHP 语言为例介绍如何使用 SDK:
<?php
require_once '../../../TCloudAutoLoader.php';
use TencentCloud\Cvm\V20170312\CvmClient;
use TencentCloud\Cvm\V20170312\Models\DescribeZonesRequest;
use TencentCloud\Common\Exception\TencentCloudSDKException;
use TencentCloud\Common\Credential;
try {
// 实例化一个认证对象,入参需要传入尚航云_V1账户secretId,secretKey
$cred = new Credential("secretId", "secretKey");
// # 实例化要请求产品(以cvm为例)的client对象
$client = new CvmClient($cred, "ap-guangzhou");
// 实例化一个请求对象
$req = new DescribeZonesRequest();
// 通过client对象调用想要访问的接口,需要传入请求对象
$resp = $client->DescribeZones($req);
// 输出json格式的字符串回包
print_r($resp->toJsonString());
}
catch(TencentCloudSDKException $e) {
echo $e;
}
下面给出一个典型的 API 请求示例:
https://cvm.tencentcloudapi.com/?Action=DescribeInstancesStatus &InstanceIds.0=ins-r8hr2upy &InstanceIds.1=ins-5d8a23rs &Offset=0 &Limit=2 &公共请求参数
返回结果示例
正确返回:
{ "Response": { "InstanceStatusSet": [ { "InstanceId": "ins-r8hr2upy", "InstanceState": "RUNNING" }, { "InstanceId": "ins-5d8a23rs", "InstanceState": "STOPPED" } ], "RequestId": "6ef60bec-0242-43af-bb20-270359fb54a7", "TotalCount": 2 } }
错误返回:
{
"Response": {
"Error": {
"Code": "AuthFailure.SignatureFailure",
"Message": "The provided credentials could not be validated. Please check your signature is correct."
},
"RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"
}
}