调用DescribeAssetDetailByUuids查询资产的详情_云安全中心(Security Center)-阿里云帮助中心

查询资产（ECS服务器）的详细信息。

调试

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

授权信息

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

请求参数

名称	类型	必填	描述	示例值
Uuids	string	是	资产实例的 UUID 列表。多个 UUID 之间使用半角逗号（,）分隔。	0687b17f-2a36-4e5**,0687b17f-2a36-4e**
Lang	string	否	设置请求和接收消息的语言类型，默认为 zh。取值： zh：中文 en：英文	zh
ResourceDirectoryAccountId	long	否	资源目录成员账号主账号 ID。说明调用 DescribeMonitorAccounts 接口可以获取该参数。	127608589417****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	92016EC8-D52D-49D8-9FF7-9EA340A950B9
AssetList	array<object>	返回的资产详情列表。
	object	返回的资产详情。
InternetIp	string	服务器的公网 IP。	10.10.XX.XX
OsName	string	服务器资产的操作系统名称。	CentOS 7.6 64位
Ip	string	服务器的 IP。说明公网 IP 存在则该值为公网 IP，公网 IP 不存在私网 IP 存在则为私网 IP。	10.10.XX.XX
Os	string	服务器的操作系统类型。	Linux
InstanceId	string	资产的实例 ID。	i-rj9gda4wolo0zixi****
ClientStatus	string	Agent 客户端状态。取值： online：在线 offline：离线	online
VpcInstanceId	string	VPC 实例 ID。	13231-331331
IntranetIp	string	服务器的私网 IP。	192.168.XX.XX
AssetType	string	资产的类型。唯一取值为 0，表示 ECS 服务器。	0
RegionId	string	服务器所在地域。说明 Region ID 和区域名称的对应关系，请参见地域和可用区。	cn-shanghai
Uuid	string	资产 UUID。	2a98f149-0256-414c-a29a-a69f8a75****
Flag	integer	资产厂商。取值： 0：阿里云资产 1：云外资产 2：IDC 资产 3、4、5、7：其它云资产 8：轻量级资产	0
RegionName	string	服务器所在地域名称。	cn-shenzhen
InstanceName	string	资产的实例名称。	TestInstanceName
Region	string	服务器所在的地域。	cn-guangzhou

示例

正常返回示例

JSON格式

{
  "RequestId": "92016EC8-D52D-49D8-9FF7-9EA340A950B9",
  "AssetList": [
    {
      "InternetIp": "10.10.XX.XX",
      "OsName": "CentOS  7.6 64位",
      "Ip": "10.10.XX.XX",
      "Os": "Linux",
      "InstanceId": "i-rj9gda4wolo0zixi****",
      "ClientStatus": "online",
      "VpcInstanceId": "13231-331331",
      "IntranetIp": "192.168.XX.XX",
      "AssetType": "0",
      "RegionId": "cn-shanghai",
      "Uuid": "2a98f149-0256-414c-a29a-a69f8a75****",
      "Flag": 0,
      "RegionName": "cn-shenzhen",
      "InstanceName": "TestInstanceName",
      "Region": "cn-guangzhou"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	IllegalParam	Illegal param	无效参数
400	RdCheckNoPermission	Resource directory account verification has no permission.	资源目录账号校验无权限。
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	RdCheckInnerError	Resource directory account service internal error.	资源目录账号服务内部错误。
500	ServerError	ServerError	服务故障，请稍后重试！

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

变更历史

变更时间	变更内容概要	操作
2023-07-20	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2022-12-23	OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 标记、OpenAPI 错误码发生变更	查看变更详情