You can call this operation to query details and extension information about a server.

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 DescribeAssetDetailByUuid

The operation that you want to perform.

Set the value to DescribeAssetDetailByUuid.
Uuid String Yes 123213-13dwe-2412431-dafadfa

The UUID of the server.
SourceIp String No 1.2.3.4

The source IP address of the request.
Lang String No zh

The language of the request and response. Valid values:

  • zh: Chinese
  • en: English

Response parameters

Parameter Type Example Description
RequestId String F7BA0B6C-4D33-49A7-AB7B-A221B2E40817

The ID of the request.
AssetDetail Struct

The details of the server.
InternetIp String 10.10.10.10

The public IP address of the server.
IntranetIp String 10.0.0.211

The internal IP address of the server.
InstanceName Integer 1312412341

The name of the server.
InstanceId Integer 1234124124

The ID of the server.
Ip String 10.10.10.101

The IP address of the ECS instance.
Uuid String 1234214-ujuj-weqweq-111-vbbbb

The UUID of the server.
AssetType String 0

The type of the asset.
Os String linux

The operating system.
ClientStatus String online

The status of the Security Center agent.
Region String shanghaixxxxxx

The region where the server is deployed.
RegionName String China (Hangzhou)

The name of the region.
Tag String InternetIp

The tag attached to the server.
GroupTrace String Ungrouped

The grouping information.
Cpu Integer 2

The number of CPU cores.
CpuInfo String Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz

The CPU details.
Kernel String 4.18.0-80.11.2.el8_0.x86_64

The kernel version.
OsDetail String Linux 64bit

The operating system version and architecture.
Mem Integer 0

The memory size.
SysInfo String CentOS Linux 8.0.1905

The operating system.
HostName String qewrqwerqsadas

The name of the host.
OsName String CentOS 8.0 64-bit

The name of the operating system.
VpcInstanceId String i-xxxx-xxxx-xxxxx-xxxxx

The ID of the VPC instance.
OsName String CentOS 8.0 64-bit

The name of the operating system.
IpList List [ "10.0.0.123" ]

The IP address of the host.
MacList List [ "00:11:3e:20:38" ]

The MAC address of the host.
DiskInfoList List [ { "diskName": "/dev/vda1", "totalSize": 20, "useSize": 2 } ]

The disk information.

Examples

Sample requests

http(s)://[Endpoint]/? Action=DescribeAssetDetailByUuid
&<Common request parameters>

Sample success responses

XML format 

<DescribeAssetDetailByUuidResponse>
    <AssetDetail>
        <GroupName>Ungrouped</GroupName>
        <ClientStatus>online</ClientStatus>
        <Os>linux</Os>
        <InstanceId>rqreqwrq</InstanceId>
        <IpList>10.0.0.123</IpList>
        <CpuInfo>Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz</CpuInfo>
        <Ip>10.10.10.101</Ip>
        <OsName>CentOS  8.0 64-bit</OsName>
        <Cpu>2</Cpu>
        <SysInfo>CentOS Linux 8.0.1905</SysInfo>
        <OsDetail>Linux 64bit</OsDetail>
        <IntranetIp>10.0.0.211</IntranetIp>
        <DiskInfoList>
            <diskName>/dev/vda1</diskName>
            <totalSize>20</totalSize>
            <useSize>2</useSize>
        </DiskInfoList>
        <MacList>00:11:3e:20:38</MacList>
        <InstanceName>wqreqwerqwer</InstanceName>
        <AssetType>0</AssetType>
        <Uuid>1234214-ujuj-weqweq-111-vbbbb</Uuid>
        <Mem>8</Mem>
        <InternetIp>10.10.10.10</InternetIp>
        <RegionName>China (Hangzhou)</RegionName>
        <Region>shanghaixxxxxx</Region>
        <Tag>InternetIp</Tag>
        <Kernel>4.18.0-80.11.2.el8_0.x86_64</Kernel>
        <HostName>qewrqwerqsadas</HostName>
    </AssetDetail>
    <requestId>F7BA0B6C-4D33-49A7-AB7B-A221B2E40817</requestId>
</DescribeAssetDetailByUuidResponse>

JSON format 

{
    "AssetDetail": {
      "GroupTrace":"Ungrouped",
      "ClientStatus": "online",
      "Os": "linux",
      "InstanceId": "rqreqwrq",
      "IpList": [
        "10.0.0.123"
      ],
      "CpuInfo": "Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz",
      "Ip": "10.10.10.101",
      "OsName": "CentOS  8.0 64-bit",
      "Cpu": 2,
      "SysInfo": "CentOS Linux 8.0.1905",
      "OsDetail": "Linux 64bit",
      "IntranetIp": "10.0.0.211",
      "DiskInfoList": [
        {
          "diskName": "/dev/vda1",
          "totalSize": 20,
          "useSize": 2
        }
      ],
      "MacList": [
        "00:11:3e:20:38"
      ],
      "InstanceName": "wqreqwerqwer",
      "AssetType": "0",
      "Uuid": "1234214-ujuj-weqweq-111-vbbbb",
      "Mem": 8,
      "InternetIp": "10.10.10.10",
      "RegionName": "China (Hangzhou)",
      "Region": "shanghaixxxxxx",
      "Tag": "InternetIp",
      "Kernel": "4.18.0-80.11.2.el8_0.x86_64",
      "HostName": "qewrqwerqsadas"
    },
  "requestId": "F7BA0B6C-4D33-49A7-AB7B-A221B2E40817"
}

Error codes

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