全部产品
Search

搜索本产品

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

    文档中心

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

    更新时间：Jun 18, 2026

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

    调试

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

    调试

    授权信息

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

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    yundun-sas:GetAssetDetailByUuid

    get

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    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

    integer

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

    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

    integer

    内存大小，单位为 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

    integer

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

    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 地址列表。

    string

    服务器的 IP 地址列表。

    120.47.XX.XX
    MacList

    array

    MAC 地址。

    string

    MAC 地址。

    00:16:3*:1*:9*:cf
    DiskInfoList

    array<object>

    磁盘信息列表。

    object

    磁盘信息。

    DiskName

    string

    磁盘名称。

    /dev/vda1
    UseSizeByte

    integer

    磁盘已使用容量。单位为 Byte。

    2998996992
    TotalSize

    integer

    磁盘总容量，单位为 GB。

    40
    UseSize

    integer

    磁盘已使用容量，单位为 GB。

    2
    TotalSizeByte

    integer

    磁盘总容量，单位为 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
    500 ServerError ServerError
    403 NoPermission caller has no permission

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

    变更历史

    更多信息，参考变更详情。