GetAssetDetailByUuid - 查询服务器资产详情和扩展信息 - 云安全中心

根据UUID查询服务器资产详情和扩展信息。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
SourceIp	string	否	请求源 IP。无需填写，系统自动获取。	120.245.XX.XX
Uuid	string	是	要查询的资产的 UUID。说明调用 DescribeCloudCenterInstances 接口获取该参数。	9e6cad93-a379-46fd-a701-9bbf02f4****
Lang	string	否	设置请求和接收消息的语言类型。默认为 zh。取值： zh：中文 en：英文	zh

返回参数

名称	类型	描述	示例值
	object	请求返回数据。
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	4892B68B-47BC-5E56-B327-9C2ACC6C1C09
AssetDetail	object	资产信息详情。
CpuInfo	string	CPU 详细信息。	Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz
InternetIp	string	服务器的公网 IP 地址。	120.47.XX.XX
OsDetail	string	服务器的操作系统版本位数。	Linux 64bit
CreateTime	long	云安全中心记录当前资产信息的时间戳，单位为毫秒。	1603863599000
Kernel	string	操作系统的内核版本。	4.18.0-80.11.2.el8_0.x86_64
Bind	boolean	资产是否已绑定授权。取值： true：已绑定授权 false：未绑定授权	true
OsName	string	服务器的操作系统名称。	CentOS 7.4 64bit
Tag	string	服务器的标签。	InternetIp
ClientStatus	string	Agent 客户端状态。取值： pause：暂停保护 online：保护中 offline：未受保护	online
Mem	integer	内存大小，单位为 GB。	16
Memory	long	内存大小，单位为 MB。	16384
VpcInstanceId	string	服务器所在的 VPC 实例 ID。	vpc-bp1fs3bwonlfq503w****
AuthVersion	integer	资产的授权版本。取值： 1：免费版（未授权） 6：防病毒版 5：高级版 3：企业版 7：旗舰版	7
InstanceName	string	服务器名称。	i-fasdfasdfadfafa****
Region	string	服务器所在地域。	cn-shanghai
GroupTrace	string	服务器所属的分组。未设置分组的服务器默认属于未分组。	default
Ip	string	ECS 分配的 IP 地址。	120.47.XX.XX
HostName	string	主机名称。	qewrqwerqs****
Os	string	服务器的操作系统类型。	linux
AuthModifyTime	long	资产授权绑定的时间戳，单位为毫秒。	1627974044000
InstanceId	string	服务器 ID。	i-uf6h7p2fgk6rkk0g****
IntranetIp	string	服务器的私网 IP 地址。	192.168.XX.XX
AssetType	string	资产类型。取值： 0：云服务器 ECS 1：负载均衡 SLB 2：NAT 网关 3：RDS 数据库 4：MongoDb 数据库 5：REDIS 数据库 6：容器镜像 IMAGE 7：容器 CONTAINER	0
RegionId	string	资产的地域 ID。	cn-hanghzou
SysInfo	string	服务器的操作系统信息。	CentOS Linux 8.0.1905
Uuid	string	服务器 UUID。	9e6cad93-a379-46fd-a701-9bbf02f4****
Cpu	integer	CPU 内核数。	2
RegionName	string	服务器所在地域名称。	China (Hohhot)
Flag	integer	资产是否为阿里云资产。取值： 0：阿里云资产 1：非阿里云资产	0
ClientVersion	string	Agent 客户端的版本。	2.0.0
IpList	array	服务器的 IP 地址列表。
IpListArr	string	服务器的 IP 地址列表。	120.47.XX.XX
MacList	array	MAC 地址。
MacListArr	string	MAC 地址。	00:16:3:1:9*:cf
DiskInfoList	array<object>	磁盘信息列表。
DiskInfo	object	磁盘信息。
DiskName	string	磁盘名称。	/dev/vda1
UseSizeByte	long	磁盘已使用容量。单位为 Byte。	2998996992
TotalSize	long	磁盘总容量，单位为 GB。	40
UseSize	long	磁盘已使用容量，单位为 GB。	2
TotalSizeByte	long	磁盘总容量，单位为 Byte。	42140479488
ClientSubStatus	string	实例的客户端子状态。取值： online：在线，表示资产的 Agent 客户端状态为开启。 offline：离线，表示资产的 Agent 客户端状态为关闭。 pause：暂停，表示资产的 Agent 客户端状态为暂停保护。 uninstalled：未安装，表示资产的 Agent 客户端状态为未安装。 stopped：服务器关机，表示资产的 Agent 客户端状态服务器关机。	online
VendorAuthAlias	string	AK 所属的账号名称。说明仅第三方主机资产可能会返回该参数，该参数值为空时不返回。	test

示例

正常返回示例

JSON格式

{
  "RequestId": "4892B68B-47BC-5E56-B327-9C2ACC6C1C09",
  "AssetDetail": {
    "CpuInfo": "Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz",
    "InternetIp": "120.47.XX.XX",
    "OsDetail": "Linux 64bit",
    "CreateTime": 1603863599000,
    "Kernel": "4.18.0-80.11.2.el8_0.x86_64",
    "Bind": true,
    "OsName": "CentOS  7.4 64bit",
    "Tag": "InternetIp",
    "ClientStatus": "online",
    "Mem": 16,
    "Memory": 16384,
    "VpcInstanceId": "vpc-bp1fs3bwonlfq503w****",
    "AuthVersion": 7,
    "InstanceName": "i-fasdfasdfadfafa****",
    "Region": "cn-shanghai",
    "GroupTrace": "default",
    "Ip": "120.47.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": "China (Hohhot)",
    "Flag": 0,
    "ClientVersion": "2.0.0",
    "IpList": [
      "120.47.XX.XX"
    ],
    "MacList": [
      "00:16:3*:1*:9*:cf"
    ],
    "DiskInfoList": [
      {
        "DiskName": "/dev/vda1",
        "UseSizeByte": 2998996992,
        "TotalSize": 40,
        "UseSize": 2,
        "TotalSizeByte": 42140479488
      }
    ],
    "ClientSubStatus": "online",
    "VendorAuthAlias": "test"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	NoPermission	no permission	无此服务的访问权限。
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史