全部产品
Search

搜索本产品

    云安全中心：QueryAssetDetailByUUID - 通过资产UUID获取资产详情

    文档中心

    云安全中心：QueryAssetDetailByUUID - 通过资产UUID获取资产详情

    更新时间：Nov 25, 2024

    通过UUID获取资产详情，可跨账号查询。

    调试

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

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    yundun-sas:QueryAssetDetailByUUIDlist
    *全部资源
    *
      无
    		无

    请求参数

    名称类型必填描述示例值
    Requestsstring否

    用户 ID 和资产列表的键值对。

    		{ "AliUid": "176618589410****", "UuidList": [ "429fe207-3014-40c6-972b-cdff1d7a****", "429fe207-3014-40c6-972b-cdff1d7b****", "429fe207-3014-40c6-972b-cdff1d7c****" ] }

    返回参数

    名称类型描述示例值
    object

    ListResult

    Dataarray<object>

    本次请求返回的结果数据。

    Dataobject
    AliUidlong

    用户 ID。

    		1766185894104***
    AuthVersioninteger

    资产的授权版本。取值：

    • 1：免费版
    • 6：防病毒版
    • 5：高级版
    • 3：企业版
    • 7：旗舰版
    • 10：仅采购增值服务版
    		3
    Bidstring

    虚拟运营商。

    		26842
    Bindboolean

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

    • true：资产已经绑定授权
    • false：资产尚未绑定授权
    		true
    ClientStatusstring

    Agent 客户端状态。取值：

    • online：在线
    • offline：离线
    		online
    ClusterIdstring

    集群 ID。

    		c8ca91e0907d94efaba7fb0827eb9****
    Eipstring

    弹性网卡 IP。

    		116.162.131.225
    Flaginteger

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

    • 0：阿里云资产
    • 1：非阿里云资产
    		0
    GmtCreatestring

    资产的创建时间。

    		2022-10-16 18:17:16
    GmtModifiedstring

    资产的更新时间。

    		2022-11-21 10:40:01
    GroupIdlong

    服务器所属分组的 ID。

    		12208928
    Idlong

    资产的唯一 ID。

    		443496
    InternetIpstring

    公网 IP。

    		172.16.XX.XX
    IntranetIpstring

    私网 IP。

    		10.42.XX.XX
    MachineInstanceIdstring

    服务器实例 ID。

    		c8ca91e0907d94efaba7fb0827eb9
    MachineIpstring

    服务器 IP 地址。

    		172.16.XX.XX
    MachineIpTypestring

    服务器 IP 类型。取值包括但不限于：

    • ecs : ECS 的 IP
    • slb: SLB 的 IP
    		SLB
    MachineNamestring

    服务器机器名称。

    		security
    MachineRegionstring

    服务器所在的地域。

    		cn-hangzhou
    MachineTypestring

    实例机器类型。取值包括但不限于：

    • ecs：ECS
    • slb：SLB
    		ecs
    Onlineboolean

    客户端是否在线。取值：

    • true：在线
    • false：离线
    		true
    Osstring

    服务器操作系统。

    		linux
    OsNamestring

    服务器的操作系统名称。

    		Debian 10.3 64位
    RegionIdstring

    服务器所在地域 ID。

    		cn-hangzhou
    Statusstring

    服务器当前状态。取值包括但不限于：

    • Running：运行状态
    • Waiting：等待状态
    		Running
    Uuidstring

    资产的唯一标识。

    		6690a46c-0edb-4663-a641-3629d1a9****
    Countinteger

    本次调用返回的结果条数。

    		2
    Successboolean

    本次请求是否成功。取值：

    • true：成功
    • false：失败
    		true
    Codestring

    本次请求返回的结果 Code。取值：

    • 200：表示成功。
    • 其它：表示错误码。错误码详情，请参见错误码。
    		200
    Messagestring

    本次请求提示消息。

    		successful
    RequestIdstring

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

    		7532B7EE-7CE7-5F4D-BF04-B12447DDCAE1
    HttpStatusCodeinteger

    本次请求返回的 HTTP 状态码。

    		200
    TimeCostlong

    本次请求消耗时间。单位：秒。

    		1

    示例

    正常返回示例

    JSON格式

    {
  "Data": [
    {
      "AliUid": 0,
      "AuthVersion": 3,
      "Bid": "26842",
      "Bind": true,
      "ClientStatus": "online",
      "ClusterId": "c8ca91e0907d94efaba7fb0827eb9****",
      "Eip": "116.162.131.225",
      "Flag": 0,
      "GmtCreate": "2022-10-16 18:17:16",
      "GmtModified": "2022-11-21 10:40:01",
      "GroupId": 12208928,
      "Id": 443496,
      "InternetIp": "172.16.XX.XX",
      "IntranetIp": "10.42.XX.XX",
      "MachineInstanceId": "c8ca91e0907d94efaba7fb0827eb9",
      "MachineIp": "172.16.XX.XX\n",
      "MachineIpType": "SLB",
      "MachineName": "security",
      "MachineRegion": "cn-hangzhou",
      "MachineType": "ecs",
      "Online": true,
      "Os": "linux",
      "OsName": "Debian  10.3 64位",
      "RegionId": "cn-hangzhou",
      "Status": "Running",
      "Uuid": "6690a46c-0edb-4663-a641-3629d1a9****"
    }
  ],
  "Count": 2,
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "7532B7EE-7CE7-5F4D-BF04-B12447DDCAE1",
  "HttpStatusCode": 200,
  "TimeCost": 1
}

    错误码

    HTTP status code错误码错误信息描述
    400QueryAssetDetailInfoErrorQuery asset detail error, please try again later.查询资产详情异常， 请稍后重试
    403NoPermissioncaller has no permission当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
    500ServerErrorServerError服务故障，请稍后重试！

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