全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

描述专属宿主机信息

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数
参数名称
类型
必填
描述
Action String
公共参数,本接口取值:DescribeDedicatedHosts。
Version String
公共参数,本接口取值:2016-03-04。
DedicatedHostId String

专属宿主机id

search String

查询条件(宿主机id或者名称)

ProjectId.N Long

项目制id列表

返回参数

参数名称
类型
描述
RequestId String
示例值:b14dec49-39fe-40de-8276-a20a1544874e
DedicatedHostSet Object[]
DedicatedHostId String
示例值:379d0f9b-6b39-430d-92b1-e27f9d0ec31f
DedicatedHostName String
示例值:mytest1
State String
示例值:active
TotalCpu Int
示例值:112
OriCpu Int
示例值:56
AvailableCpu Int
示例值:112
TotalMemory Int
示例值:490
AvailableMemory Int
示例值:490
TotalDatadisk Int
示例值:6648
AvailableDatadisk Int
示例值:6648
Instances String[]
CreateDate String
示例值:2018-08-08 11:50:35
AvailabilityZone String
示例值:cn-beijing-6a
AvailabilityZoneName String
示例值:可用区A
Model String
示例值:DR1
ProjectId Int
示例值:0

请求示例

curl -X GET|POST
'http://kec.api.ksyun.com/?Action=DescribeDedicatedHosts&Version=2016-03-04'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/x-www-form-urlencoded'
-H 'host: kec.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d 'DedicatedHostId=xxx&search=xxx&ProjectId.N=xxx'

返回示例

JSON格式

{
"RequestId":"b14dec49-39fe-40de-8276-a20a1544874e",
"DedicatedHostSet":[
{
"DedicatedHostId":"379d0f9b-6b39-430d-92b1-e27f9d0ec31f",
"DedicatedHostName":"mytest1",
"State":"active",
"TotalCpu":112,
"OriCpu":56,
"AvailableCpu":112,
"TotalMemory":490,
"AvailableMemory":490,
"TotalDatadisk":6648,
"AvailableDatadisk":6648,
"Instances":[
],
"CreateDate":"2018-08-08 11:50:35",
"AvailabilityZone":"cn-beijing-6a",
"AvailabilityZoneName":"可用区A",
"Model":"DR1",
"ProjectId":0
}
]
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
DedicatedHostIdInvalidDedicatedHostId is invalid400专属宿主机ID无效
ProjectMemberNotExistUser is not a member of Project [{0}]400当前用户并不在项目[{0}]中
DedicatedClusterIdInvalidParameterValue暂无400暂无
纯净模式常规模式

纯净模式

点击可全屏预览文档内容