全部产品
Search

搜索本产品

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

    文档中心

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

    更新时间：Nov 25, 2024
    目前该API接口已标记为弃用，推荐使用替代API：Sas(2018-12-03) - GetAssetDetailByUuid。

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

    接口说明

    该服务即将下线。请采调用 GetAssetDetailByUuid 接口获取资产详情。

    调试

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

    授权信息

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

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

    请求参数

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

    访问源的 IP 地址。

    		192.0.XX.XX
    Uuidstring是

    要查询的资产的 UUID。

    说明 调用 DescribeCloudCenterInstances 接口获取该参数。
    		9e6cad93-a379-46fd-a701-9bbf02f4****
    Langstring否

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

    • zh：中文
    • en：英文
    		zh

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

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

    		39031E31-6BBA-5C99-A870-D807E78918CD
    AssetDetailobject

    资产信息详情。

    CpuInfostring

    CPU 详细信息。

    		Intel(R) Xeon(R) Platinum 8163 CPU @ 2.50GHz
    InternetIpstring

    服务器的公网 IP 地址。

    		192.168.XX.XX
    OsDetailstring

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

    		Linux 64bit
    CreateTimelong

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

    		1603863599000
    Kernelstring

    操作系统的内核版本。

    		4.18.0-80.11.2.el8_0.x86_64
    Bindboolean

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

    • true：已绑定授权
    • false：未绑定授权
    		true
    OsNamestring

    服务器的操作系统名称。

    		-
    Tagstring

    服务器的标签。

    		InternetIp
    ClientStatusstring

    Agent 客户端状态。取值：

    • pause：暂停保护
    • online：保护中
    • offline：未受保护
    		online
    Meminteger

    内存大小，单位为 GB。

    		32
    Memorylong

    内存大小，单位为 MB。

    		512
    VpcInstanceIdstring

    服务器所在的 VPC 实例 ID。

    		vpc-bp1fs3bwonlfq503w****
    AuthVersioninteger

    资产的授权版本。取值：

    • 1：免费版（未授权）
    • 6：防病毒版
    • 5：高级版
    • 3：企业版
    • 7：旗舰版
    		7
    InstanceNamestring

    服务器名称。

    		i-fasdfasdfadfafa****
    Regionstring

    服务器所在地域。

    		cn-hangzhou-dg-a01
    GroupTracestring

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

    		default
    Ipstring

    ECS 分配的 IP 地址。

    		192.168.XX.XX
    HostNamestring

    主机名称。

    		qewrqwerqs****
    Osstring

    服务器的操作系统类型。

    		linux
    AuthModifyTimelong

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

    		1627974044000
    InstanceIdstring

    服务器 ID。

    		i-uf6h7p2fgk6rkk0g****
    IntranetIpstring

    服务器的私网 IP 地址。

    		192.168.XX.XX
    AssetTypestring

    资产类型。取值：

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

    资产的地域 ID。

    		cn-hanghzou
    SysInfostring

    服务器的操作系统信息。

    		CentOS Linux 8.0.1905
    Uuidstring

    服务器 UUID。

    		9e6cad93-a379-46fd-a701-9bbf02f4****
    Cpuinteger

    CPU 内核数。

    		2
    RegionNamestring

    服务器所在地域名称。

    		China (Hohhot)
    Flaginteger

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

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

    Agent 客户端的版本。

    		2.0.0
    IpListarray

    服务器的 IP 地址列表。

    IpListArrstring

    服务器的 IP 地址列表。

    		["192.168.XX.XX"]
    MacListarray

    MAC 地址。

    MacListArrstring

    MAC 地址。

    		[ "00:16:3*:1*:9*:cf" ]
    DiskInfoListarray

    磁盘信息集合。

    DiskInfostring

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

    • diskName：磁盘名称。
    • totalSize：磁盘总容量，单位为 GB。
    • useSize：已使用磁盘容量，单位为 GB。
    • useSizeByte：已使用磁盘容量，单位为 Byte。
    • totalSizeByte：已使用磁盘容量，单位为 Byte。
    		{diskName: "/dev/vda1", useSizeByte: 2998996992, totalSize: 40, useSize: 2, totalSizeByte: 42140479488}

    示例

    正常返回示例

    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": "-",
    "Tag": "InternetIp",
    "ClientStatus": "online",
    "Mem": 32,
    "Memory": 512,
    "VpcInstanceId": "vpc-bp1fs3bwonlfq503w****",
    "AuthVersion": 7,
    "InstanceName": "i-fasdfasdfadfafa****",
    "Region": "cn-hangzhou-dg-a01",
    "GroupTrace": "default",
    "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": "China (Hohhot)",
    "Flag": 0,
    "ClientVersion": "2.0.0",
    "IpList": [
      "[\"192.168.XX.XX\"]"
    ],
    "MacList": [
      "[\n      \"00:16:3*:1*:9*:cf\"\n]"
    ],
    "DiskInfoList": [
      "{diskName: \"/dev/vda1\", useSizeByte: 2998996992, totalSize: 40, useSize: 2, totalSizeByte: 42140479488}"
    ]
  }
}

    错误码

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

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

    变更历史

    变更时间变更内容概要操作
    2024-07-30OpenAPI 变更为 deprecated，即将下线、OpenAPI 错误码发生变更查看变更详情
    2022-12-23OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 标记、OpenAPI 错误码发生变更查看变更详情