文档

GetAssetsPropertyDetail - 查询资产指纹详情列表

更新时间:

查询资产指纹启动项、内核模块或者Web站点详情列表。

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
Langstring

请求和接收消息的语言类型。取值:

  • zh:中文
  • en:英文
en
Bizstring

要查询的资产指纹的类型,默认值为 sca。取值:

  • lkm:内核模块
  • autorun:启动项
  • web_server:Web 站点
lkm
ItemNamestring

要查询的资产指纹的聚合项名称。

说明 调用 GetAssetsPropertyItem 接口获取该参数。
virtio
SearchCriteriaListobject []

指定要资产指纹详情查询的条件集合。

Namestring

指定要查询的条件名称。取值如下:

  • remarkItemName:资产指纹聚合项名称,支持模糊匹配
说明
  • Biz 取值为web_server时,remarkItemName 表示搜索条件为域名
  • Biz 取值为 lkm 时,remarkItemName 表示搜索条件为模块名称
  • Biz 取值为 autorun 时,remarkItemName 表示搜索条件为自启动项路径
  • remarkItemName
    Valuestring

    指定要查询的条件值。

    virtio
    Remarkstring

    服务器名称或 IP。

    1.2.XX.XX
    Uuidstring

    要查询的资产的 UUID。

    说明 调用 DescribeCloudCenterInstances 接口获取该参数。
    38f72ea4-4c9f-4df1-bc6c-0f267614****
    CurrentPageinteger

    设置从返回结果的第几页开始显示查询结果。默认值为 1,表示从第 1 页开始显示。

    1
    PageSizeinteger

    指定分页查询时,每页显示的数据最大条数。每页默认显示的数据条数为 20 条,PageSize 参数值为空时,将默认返回 20 条数据。

    说明 建议 PageSize 取值不要为空。
    20

    返回参数

    名称类型描述示例值
    object

    请求返回参数。

    RequestIdstring

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

    4C1AE3F3-18FA-4108-BBB9-AFA1A032****
    PageInfoobject

    分页查询时页面显示的信息。

    CurrentPageinteger

    分页查询时,当前页的页码。

    1
    PageSizeinteger

    分页查询时,每页显示的资产指纹详情信息的数量。

    20
    TotalCountinteger

    查询到的资产指纹详情信息的总数量。

    23
    Countinteger

    当前页面显示的资产指纹详情信息的数量。

    20
    Propertysobject []

    资产指纹详情集合。

    ModuleNamestring

    模块名称。

    说明 Biz 取值为 lkm 时返回。
    alihids
    Sizeinteger

    内核模块大小。

    说明 Biz 取值为 lkm 时返回。
    10
    Filepathstring

    内核模块文件路径。

    说明 Biz 取值为 lkm 时返回。
    /lib/modules/4****
    UsedByCountinteger

    内核模块被依赖数目。

    说明 Biz 取值为 lkm 时返回。
    0
    Pathstring

    根据 Biz 取值不同表示不同含义:

    • Biz 取值为web_server时,表示 web 根路径
    • Biz 取值为 autorun 时,表示启动项路径
    /lib/systemd/system****
    ServerTypestring

    Web 站点类型。

    说明 Biz 取值为web_server时返回。
    nginx
    Portstring

    Web 站点端口。

    说明 Biz 取值为web_server时返回。
    80
    Pidstring

    Web 站点进程 Pid。

    说明 Biz 取值为web_server时返回。
    813
    ListenProtocolstring

    Web 站点进程监听协议。

    说明 Biz 取值为web_server时返回。
    tcp
    ProcessStartedlong

    Web 站点进程启动时间戳,单位为毫秒。

    说明 Biz 取值为web_server时返回。
    1671186801000
    WebPathstring

    Web 站点 web 路径。

    说明 Biz 取值为web_server时返回。
    /usr/share/nginx/html
    Domainstring

    Web 站点域名。

    说明 Biz 取值为web_server时返回。
    localhost
    Userstring

    Web 站点用户。

    说明 Biz 取值为web_server时返回。
    root
    PathModestring

    Web 站点目录权限。

    说明 Biz 取值为web_server时返回。
    755
    InstanceIdstring

    服务器的实例 ID。

    i-hp35tftuh52wbp1g****
    IntranetIpstring

    服务器的私网 IP 地址。

    100.104.XX.XX
    InternetIpstring

    服务器的公网 IP 地址。

    47.42.XX.XX
    Ipstring

    服务器的 IP。

    47.42.XX.XX
    Uuidstring

    服务器的 UUID。

    162eb349-c2d9-4f8b-805c-75b43d4c****
    InstanceNamestring

    服务器实例的名称。

    hc-host-****
    RegionIdstring

    实例所在的地域的 ID。

    cn-hangzhou
    CreateTimestamplong

    资产指纹最新扫描时间戳,单位毫秒。

    1649149566000
    ImageNamestring

    镜像名称。

    registry-vpc.cn-beijing.aliyuncs.com/acs/aliyun-ingress-controller****
    ContainerNamestring

    容器名称。

    5-rce_web_1

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "4C1AE3F3-18FA-4108-BBB9-AFA1A032****",
      "PageInfo": {
        "CurrentPage": 1,
        "PageSize": 20,
        "TotalCount": 23,
        "Count": 20
      },
      "Propertys": [
        {
          "ModuleName": "alihids",
          "Size": 10,
          "Filepath": "/lib/modules/4****",
          "UsedByCount": 0,
          "Path": "/lib/systemd/system****",
          "ServerType": "nginx",
          "Port": "80",
          "Pid": "813",
          "ListenProtocol": "tcp",
          "ProcessStarted": 1671186801000,
          "WebPath": "/usr/share/nginx/html",
          "Domain": "localhost",
          "User": "root",
          "PathMode": "755",
          "InstanceId": "i-hp35tftuh52wbp1g****",
          "IntranetIp": "100.104.XX.XX",
          "InternetIp": "47.42.XX.XX",
          "Ip": "47.42.XX.XX",
          "Uuid": "162eb349-c2d9-4f8b-805c-75b43d4c****",
          "InstanceName": "hc-host-****",
          "RegionId": "cn-hangzhou",
          "CreateTimestamp": 1649149566000,
          "ImageName": "registry-vpc.cn-beijing.aliyuncs.com/acs/aliyun-ingress-controller****",
          "ContainerName": "5-rce_web_1"
        }
      ]
    }

    错误码

    HTTP status code错误码错误信息描述
    400IllegalParamIllegal param无效参数
    403NoPermissioncaller has no permission当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。
    500ServerErrorServerError服务故障,请稍后重试!

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史
    • 本页导读 (1)
    文档反馈