You can call this operation to query the details of specific ECS instances.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description 
Action String Yes DescribeAssetDetailByUuids

The operation that you want to perform.

Set the value to: DescribeAssetDetailByUuids.

Uuids String Yes 0687b17f-2a36-4e5c-b3d9

The list of ECS instances.

Response parameters

Parameter Type Example Description
AssetList Array

The details of the specified ECS instances.

AssetType String 0

The type of the assets.

Set the value to 0, which indicates that the assets are ECS instances.

ClientStatus String online

The status of the Security Center agent. Valid values:

  • online
  • offline
InstanceId Integer 1312332131

The ID of the ECS instance.

InstanceName Integer 11

The name of the ECS instance.

InternetIp String 10.10.10.10

The public IP address of the ECS instance.

IntranetIp String 10.10.10.10

The internal IP address of the ECS instance.

Ip String 10.10.10.10

The public IP address of the ECS instance, which is the same as the InternetIpparameter.

Os String linux

The type of the operating system run by the ECS instance.

OsName String CentOS 7.6 64bit

The name of the operating system run by the ECS instance.

Region String cn-huhehaote-123-323

The region where the ECS instance is deployed.

RegionName String China (Hohhot)

The name of the region where the ECS instance is deployed.

Uuid String 01111-asdad-assd

The UUID of the ECS instance.

VpcInstanceId String 13231-331331

The ID of the VPC instance.

RequestId String 92016EC8-D52D-49D8-9FF7-9EA340A950B9

The ID of the request.

Samples

Sample requests

http(s)://[Endpoint]/? Action=DescribeAssetDetailByUuids
&Uuids=0687b17f-2a36-4e5c-b3d9
&<Common request parameters>

Sample success responses

XML format

<DescribeAssetDetailByUuidsResponse>
  <AssetDetail>
        <ClientStatus>online</ClientStatus>
        <Os>linux</Os>
        <InstanceId>1312332131</InstanceId>
        <Ip>10.10.10.10</Ip>
        <OsName>CentOS 7.6 64bit</OsName>
        <OsDetail>Linux 64bit</OsDetail>
        <IntranetIp>100.10.10.10</IntranetIp>
        <InstanceName>server 1</InstanceName>
        <AssetType>0</AssetType>
        <Uuid>01111-asdad-assd</Uuid>
        <InternetIp>10.10.10.10</InternetIp>
        <RegionName>China (Hohhot)</RegionName>
        <Region>cn-huhehaote-123-323</Region>
  </AssetDetail>
  <requestId>92016EC8-D52D-49D8-9FF7-9EA340A950B9</requestId>
</DescribeAssetDetailByUuidsResponse>

JSON format

{
	"AssetDetail": {
		"ClientStatus": "online",
		"Os": "linux",
		"InstanceId": "1312332131",
		"Ip": "10.10.10.10",
		"OsName": "CentOS 7.6 64bit",
		"OsDetail": "Linux 64bit",
		"IntranetIp": "100.10.10.10",
		"InstanceName": "Instance 1",
		"AssetType": "0",
		"Uuid": "01111-asdad-assd",
		"InternetIp": "10.10.10.10",
		"RegionName": "China (Hohhot)",
		"Region": "cn-huhehaote-123-323"	
	},
	"requestId": "92016EC8-D52D-49D8-9FF7-9EA340A950B9"
}

Error codes

For a list of error codes, visit the API Error Center.