API 文档综览

本文档是UCloud云计算产品API参考手册。在本文档中,您能够获取到对于每一个指令的描述,语法以及使用示例。您可以通过用 HTTP/HTTPS GET的方式对我们的 API进行调用,或选择适合您所使用编程语言的 SDK 来访问我们的 API。在调用API时,除了需要给出相应的API调用地址,公共参数,API指令,以及指令参数之外,您还需要在调用请求中给出 API 密钥进行身份认证,请您务必妥善保管好您的 API 密钥。

API完整示例

部分API调用示例,参见 UCloud SDK项目

API请求结构

Name Description Notes
API调用地址 调用API的webservice入口 http(s)://api.ucloud.cn
公共参数 调用API时需要给出的公共参数 参见 公共参数列表
API指令 即API指令名称,如 DescribeUhostInstance 参见 API指令列表
指令参数 执行每个指令时所需要提供的参数 参见 API指令列表

API请求示例

下面是一个API请求示例,所调用的是DescribeUHostInstance指令。

http(s)://api.ucloud.cn/?Action=DescribeUHostInstance
&Region=cn-bj2
&Zone=cn-bj2-04
&UHostIds.0=uhost-qs20fr
&Offset=0
&Limit=20  
&Signature=2697152c34abbc148a38a33c0dc0d3d7b99ce82f
**note**
请使用您的PublicKey与Signature参数值替换这里的参数值。

API返回结构

Name Description Notes
指令名称 返回所调用的指令名称。 例如 DescribeUHostInstanceResponse API 返回的指令名称为 "API 指令名称"+"Response"来表示。
API返回码 用来表示API请求的返回值 ,当retcode = 0时表示API请求正常, retcode != 0时表示API请求错误。
返回参数 每个API的返回参数 参见 API指令列表

API返回示例

该API的返回值为如下所示的JSON格式内容。

{
     "Action" : "DescribeUHostInstanceResponse",
     "TotalCount" : 1,
     "RetCode" : 0,
     "UHostSet" : [
         {
             "UHostId":"uhost-qs20fr",
             "ImageId": "ee51e7ba-7b48-4332-b6e8-990bd56f81af",
             "BasicImageId": "08d3b48b-ba14-4b1a-a5dd-cbacf8b820f2",
             "BasicImageName": "Ubuntu 10.04 64位",
             "Tag":"tag-test",
             "Name":"name-test",
             "Remark":"remark-test",
             "State":"Running",
             "CreateTime":1234567890,
             "ChargeType":"Dynamic",
             "ExpireTime":1398328902,
             "CPU":2,
             "Memory":2048,
             "AutoRenew":"Yes",
             "NetworkState":"Connected",
             "NetCapability":"Yes",
             "AutoRenew": "Yes",
             "DiskSet":[
                 {
                     "Type": "Boot",
                     "DIskId": "209883a7-aaee-4492-974d-5d9d64ef79c4",
                     "Drive": "/dev/sda",
                     "Size": 20
                 },
                 {
                     "Type": "Data",
                     "DIskId": "5daef46a-63e6-40c2-8d0a-d3d5b3bc4d5b",
                     "Drive": "/dev/sdb",
                     "Size": 40
                 },
                 {
                     "Type": "Udisk",
                     "DIskId": "ce8a9f2a-28c7-4267-8cff-eafb714e3b18",
                     "Drive": "/dev/sdc",
                     "Size": 100
                 }
             ]
             " IpSet ":[
                 {
                     "Type": " Private ",
                     "IP":"10.6.6.1"
                 },
                 {
                     "Type":" Bgp ",
                     "IPId":"cc9732a6-d43a-45ca-b867-fb90052ffe88",
                     "IP":”118.192.72.21”,
                     " Bandwidth": 2
                 }
             ]
         }
     ]
 }
如有疑问请联系 技术支持