接口功能介绍

该接口提供用户一台或多台云主机信息查询功能，用户可以根据此接口的返回值了解自己云主机的详细信息。
准备工作：
  构造请求：在调用前需要了解如何构造请求，详情查看构造请求
  认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权
注意事项：
  单台查询：当前接口只能查询单台云主机信息，查询多台云主机信息请使用接口查询专属云中的云主机列表进行查询

接口约束

  确保当前请求资源池下，该云主机存在（即参数instanceID与regionID对应）

URI

POST /v4/dec/instance/details

路径参数
无

Query参数
无

请求参数

请求头header参数
无

请求体body参数

响应参数

表 returnObj

表 addresses

表 secGroupList

表 networkCardList

表 vipInfoList

表 affinityGroup

表 image

表 flavor

表 addressList

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

示例：查询专属于内一台云主机
{
    "regionID": "a39b0db2989140c79e6de8c21d50f132",
    "instanceID": "2ae75564-c38a-aec3-1191-0b680a9811c1"
}

响应示例

{
	"returnObj": {
		"results": {
			"affinityGroup": {
				"policy": "soft-affinity",
				"affinityGroupName": "group-10274",
				"affinityGroupID": "682c01af-1eaf-400b-570f-05734a00619d"
			},
			"availableDay": 180,
			"azName": "cn-huadong1-jsnj3A-public-ctcloud",
			"addresses": [{
				"vpcName": "vpc-c710",
				"addressList": [{
					"version": 4,
					"type": "fixed",
					"addr": "192.168.0.5"
				}, {
					"version": 6,
					"type": "fixed",
					"addr": "100:1:179:b400:1281:d922:16da:51a9"
				}, {
					"version": 4,
					"type": "floating",
					"addr": "100.124.3.50"
				}]
			}],
			"projectID": "0",
			"image": {
				"imageName": "CentOS7.5.v1-20210303",
				"imageID": "b78812b0-ff50-4816-b58f-5c4fbc230b08"
			},
			"updatedAt": "2022-10-31T04:42:48Z",
			"fixedIP": ["192.168.0.5"],
			"vpcName": "vpc-c710",
			"vipInfoList": [{
				"vipAddress": "192.168.0.8",
				"vipBindNicIPv6": "100:1:179:b400:1281:d922:16da:51a9",
				"nicID": "port-8aujqrn2yv",
				"vipBindNicIP": "192.168.0.5",
				"vipID": "havip-tb5a8zacx6"
			}],
			"zabbixName": "5ae83d07-0389-22fd-def8-995090ee3d5a",
			"osType": 5,
			"displayName": "ecm-details",
			"flavor": {
				"videoMemSize": null,
				"flavorCPU": 1,
				"flavorRAM": 1024,
				"gpuCount": null,
				"flavorName": "s7.small.1",
				"gpuVendor": null,
				"flavorID": "5622ce59-da34-cb43-ca0d-eef2a51475b3",
				"gpuType": null
			},
			"instanceID": "8a8fdc88-b8a8-88bb-888f-8b88888c88f8",
			"createdAt": "2022-10-31T04:38:17Z",
			"instanceStatus": "Stopped",
			"vpcID": "vpc-ollez140q8",
			"attachedVolume": ["7337e167-1f9a-4319-9c0f-3b598b85f494", "2012fece-4fd9-4195-a748-fcefc838967a"],
            "instanceName": "c7-cgio",
			"onDemand": true,
			"floatingIP": "100.124.3.50",
			"resourceID": "30e2c994bf454d2e953eed48e637df6b",
			"secGroupList": [{
				"securityGroupID": "sg-h2tk9njxyv",
				"securityGroupName": "Default-Security-Group"
			}],
			"privateIP": "192.168.0.5",
			"privateIPv6": "100:1:179:b400:1281:d922:16da:51a9",
			"expiredTime": "2023-04-30T04:38:17Z",
			"subnetIDList": ["subnet-a9f581ioqd", "subnet-a9f581ioqd"],
			"vipCount": 1,
			"networkCardList": [{
				"IPv4Address": "192.168.0.5",
				"isMaster": true,
				"networkCardID": "port-8aujqrn2yv",
				"IPv6Address": ["100:1:179:b400:1281:d922:16da:51a9"],
				"subnetCidr": "192.168.0.0/24",
				"subnetID": "subnet-a9f581ioqd",
				"gateway": "192.168.0.1",
				"securityGroup": ["sg-h2tk9njxyv"]
			}, {
				"IPv4Address": "192.168.0.6",
				"isMaster": false,
				"networkCardID": "port-sstlnw0s7i",
				"IPv6Address": ["100:1:179:b400:45a6:63a6:d121:9767"],
				"subnetCidr": "192.168.0.0/24",
				"subnetID": "subnet-a9f581ioqd",
				"gateway": "192.168.0.1",
				"secGroupList": ["sg-h2tk9njxyv"]
			}],
            "keypairName": ""
		}
	},
    "message": "SUCCESS", 
    "description": "成功", 
    "statusCode": 800
}

状态码

请参考 状态码

错误码

请参考 错误码