裸金属服务器详细信息
裸金属服务器详细信息
1. 描述
查询裸金属服务器详细信息。
2. 请求地址
请求地址的格式如下:
https://<区域服务地址>/v1/bm/detail
3. 请求参数
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
projectId | String | 是 | 所属项目ID |
id | String | 是 | 裸金属服务器ID |
4. 请求示例
4.1. 请求地址
POST https://cn-east-1.api.yovole.com/v1/bm/detail HTTP/1.1
x-ycs-timestamp: 2019-06-19T14:26:26Z
x-ycs-requestid: 2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9
x-ycs-security-authorization: Authorization: YCS1-HMAC-SHA1 Credential=08e206fb-7b41-45b7-8076-8d43e8aeea89,SignedHeaders=content-type;x-ycs-requestid;x-ycs-timestamp,Signature=2RFjU7C9gICCrQfpAIfAJHqRRlQ=
4.2. 接口请求参数
{
"projectId":"8a83a0966a681da5016a874df50b10ce",
"id":"f75d31d7-f624-44ab-b334-814f23a624d4"
}
5. 返回结果
5.1. 返回正确结果示例
{
"requestId":"4a0d174a-85a6-47b8-ba66-8b5e1409aa04",
"success":true,
"code":200,
"model":{
"id":"3a52c99b-c6c5-4f2c-af6d-ea1e40a813e6",
"name":"裸机名称",
"sn":"BM-210002P",
"regionSn":"CN-EAST-1",
"azSn":"CN-EAST-1-A",
"created":"2019-12-12 11:33:06",
"updated":"2019-12-13 10:25:47",
"status":"ACTIVE",
"description":"裸机描述信息",
"azName":"可用区A",
"flavorId":"ecs.bm1.xlarge",
"flavorName":"24c16g",
"cpu":8,
"ram":32,
"gpu":0,
"billingType":"PRE_PAID",
"vmProductName":"标准 I型",
"expired":"2020-01-12 11:33:00",
"attachVolumeCount":0,
"sysDiskSize":0,
"portInfos":[
{
"subnetId":"f9b1035e-fbf7-481f-b28b-9b91017ed3fd",
"subnetName":" LP_TEST",
"subnetSn":"SN-21A-3U2H9",
"subnetIp":"10.1.2.12",
"subnetCidr":"10.1.2.0/24",
"masterPortFlag":true
}
],
"vpcVO":{
"id":"b1cc4009-4d4e-4d02-91ee-aa574cc848c4",
"sn":"VPC-213U2CU",
"name":"默认VPC",
"cidr":"10.1.0.0/16"
}
}
}
5.2. 返回错误结果示例
{
"requestId": "2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9",
"success": false,
"code": 400,
"message": "Required attribute 'projectId' not specified",
"errorCode": "Invalid argument"
}
6. 错误码
可以通过错误返回结果中的code、errorCode和message字段了解错误分类和具体的错误原因。
该接口没有特殊错误码,错误码信息和简单的错误分析方法可以参考公共错误码。