调用DescribeAssetDetailByUuid接口使用资产的UUID查询资产的详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeAssetDetailByUuid

要执行的操作。取值:DescribeAssetDetailByUuid

SourceIp String 192.0.XX.XX

访问源的IP地址。

Uuid String 9e6cad93-a379-46fd-a701-9bbf02f4****

要查询的资产的UUID。

说明 调用DescribeCloudCenterInstances接口获取该参数。
Lang String zh

设置请求和接收消息的语言类型。默认为zh。取值:

  • zh:中文
  • en:英文

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
RequestId String 39031E31-6BBA-5C99-A870-D807E78918CD

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

AssetDetail Object

资产信息详情。

CpuInfo String Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz

CPU详细信息。

InternetIp String 192.168.XX.XX

服务器的公网IP地址。

OsDetail String Linux 64bit

服务器的操作系统版本位数。

CreateTime Long 1603863599000

云安全中心记录当前资产信息的时间戳,单位为毫秒。

Kernel String 4.18.0-80.11.2.el8_0.x86_64

操作系统的内核版本。

Bind Boolean true

资产是否已绑定授权。取值:

  • true:已绑定授权
  • false:未绑定授权
OsName String CentOS 8.0 64位

服务器的操作系统名称。

Tag String InternetIp

服务器的标签。

ClientStatus String online

Agent客户端状态。取值:

  • pause:暂停保护
  • online:保护中
  • offline:未受保护
Mem Integer 32

内存大小,单位为GB。

Memory Long 512

内存大小,单位为M。

VpcInstanceId String vpc-bp1fs3bwonlfq503w****

服务器所在的VPC实例ID。

AuthVersion Integer 7

资产的授权版本。取值:

  • 1:免费版(未授权)
  • 6:防病毒版
  • 5:高级版
  • 3:企业版
  • 7:旗舰版
  • 10:独立购买版
InstanceName String i-fasdfasdfadfafa****

服务器名称。

Region String cn-hangzhou-dg-a01

服务器所在地域。

GroupTrace String 未分组

服务器所属的分组。未设置分组的服务器默认属于未分组

Ip String 192.168.XX.XX

ECS分配的IP地址。

HostName String qewrqwerqs****

服务器名称。

Os String linux

服务器的操作系统类型。

AuthModifyTime Long 1627974044000

资产授权绑定的时间戳,单位为毫秒。

InstanceId String i-uf6h7p2fgk6rkk0g****

服务器ID。

IntranetIp String 192.168.XX.XX

服务器的私网IP地址。

AssetType String 0

资产类型。取值:

  • 0:云服务器ECS
  • 1:负载均衡SLB
  • 2:NAT网关
  • 3:RDS数据库
  • 4:MongoDb数据库
  • 5:REDIS数据库
  • 6:容器镜像IMAGE
  • 7:容器CONTAINER
RegionId String cn-hanghzou

资产的地域ID。

SysInfo String CentOS Linux 8.0.1905

服务器的操作系统信息。

Uuid String 9e6cad93-a379-46fd-a701-9bbf02f4****

服务器UUID。

Cpu Integer 2

CPU内核数。

RegionName String 华东1(杭州)

服务器所在地域名称。

Flag Integer 0

资产是否为阿里云资产。取值:

  • 0:阿里云资产
  • 1:非阿里云资产
ClientVersion String 2.0.0

Agent客户端的版本。

IpList Array of String ["192.168.XX.XX"]

服务器的IP地址列表。

MacList Array of String ["00:16:3*:1*:9*:cf"]

MAC地址。

DiskInfoList Array of String [ { "diskName": "/dev/vda1", "totalSize": 20, "useSize": 2 } ]

磁盘信息。以下是磁盘相关参数的说明:

  • diskName:磁盘名称。
  • totalSize:磁盘总容量,单位为GB。
  • useSize:已使用磁盘容量,单位为GB。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAssetDetailByUuid
&SourceIp=192.0.XX.XX
&Uuid=9e6cad93-a379-46fd-a701-9bbf02f4****
&Lang=zh
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAssetDetailByUuidResponse>
    <RequestId>39031E31-6BBA-5C99-A870-D807E78918CD</RequestId>
    <AssetDetail>
        <CpuInfo>Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz</CpuInfo>
        <InternetIp>192.168.XX.XX</InternetIp>
        <OsDetail>Linux 64bit</OsDetail>
        <CreateTime>1603863599000</CreateTime>
        <Kernel>4.18.0-80.11.2.el8_0.x86_64</Kernel>
        <Bind>true</Bind>
        <OsName>CentOS  8.0 64位</OsName>
        <Tag>InternetIp</Tag>
        <ClientStatus>online</ClientStatus>
        <Mem>32</Mem>
        <Memory>512</Memory>
        <VpcInstanceId>vpc-bp1fs3bwonlfq503w****</VpcInstanceId>
        <AuthVersion>7</AuthVersion>
        <InstanceName>i-fasdfasdfadfafa****</InstanceName>
        <Region>cn-hangzhou-dg-a01</Region>
        <GroupTrace>未分组</GroupTrace>
        <Ip>192.168.XX.XX</Ip>
        <HostName>qewrqwerqs****</HostName>
        <Os>linux</Os>
        <AuthModifyTime>1627974044000</AuthModifyTime>
        <InstanceId>i-uf6h7p2fgk6rkk0g****</InstanceId>
        <IntranetIp>192.168.XX.XX</IntranetIp>
        <AssetType>0</AssetType>
        <RegionId>cn-hanghzou</RegionId>
        <SysInfo>CentOS Linux 8.0.1905</SysInfo>
        <Uuid>9e6cad93-a379-46fd-a701-9bbf02f4****</Uuid>
        <Cpu>2</Cpu>
        <RegionName>华东1(杭州)</RegionName>
        <Flag>0</Flag>
        <ClientVersion>2.0.0</ClientVersion>
        <IpList>["192.168.XX.XX"]</IpList>
        <MacList>["00:16:3*:1*:9*:cf"]</MacList>
        <DiskInfoList>[ { "diskName": "/dev/vda1", "totalSize": 20, "useSize": 2 } ]</DiskInfoList>
    </AssetDetail>
</DescribeAssetDetailByUuidResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "39031E31-6BBA-5C99-A870-D807E78918CD",
  "AssetDetail" : {
    "CpuInfo" : "Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz",
    "InternetIp" : "192.168.XX.XX",
    "OsDetail" : "Linux 64bit",
    "CreateTime" : 1603863599000,
    "Kernel" : "4.18.0-80.11.2.el8_0.x86_64",
    "Bind" : true,
    "OsName" : "CentOS  8.0 64位",
    "Tag" : "InternetIp",
    "ClientStatus" : "online",
    "Mem" : 32,
    "Memory" : 512,
    "VpcInstanceId" : "vpc-bp1fs3bwonlfq503w****",
    "AuthVersion" : 7,
    "InstanceName" : "i-fasdfasdfadfafa****",
    "Region" : "cn-hangzhou-dg-a01",
    "GroupTrace" : "未分组",
    "Ip" : "192.168.XX.XX",
    "HostName" : "qewrqwerqs****",
    "Os" : "linux",
    "AuthModifyTime" : 1627974044000,
    "InstanceId" : "i-uf6h7p2fgk6rkk0g****",
    "IntranetIp" : "192.168.XX.XX",
    "AssetType" : "0",
    "RegionId" : "cn-hanghzou",
    "SysInfo" : "CentOS Linux 8.0.1905",
    "Uuid" : "9e6cad93-a379-46fd-a701-9bbf02f4****",
    "Cpu" : 2,
    "RegionName" : "华东1(杭州)",
    "Flag" : 0,
    "ClientVersion" : "2.0.0",
    "IpList" : [ "[\"192.168.XX.XX\"]" ],
    "MacList" : [ "[\"00:16:3*:1*:9*:cf\"]" ],
    "DiskInfoList" : [ "[ { \"diskName\": \"/dev/vda1\", \"totalSize\": 20, \"useSize\": 2 } ]" ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission no permission 限制访问
500 ServerError ServerError 服务故障

访问错误中心查看更多错误码。