全部产品
Search

搜索本产品

    云安全中心：GetCloudAssetCriteria - 获取云资产列表查询条件

    文档中心

    云安全中心：GetCloudAssetCriteria - 获取云资产列表查询条件

    更新时间：Nov 25, 2024

    获取云资产列表查询条件。

    调试

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

    授权信息

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

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

    请求参数

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

    查询云资产时输入的模糊匹配值。

    		testwww
    CloudAssetTypesarray<object>否

    云资产的资产类型信息列表。

    object否

    云资产的资产类型信息。

    AssetTypeinteger否

    资产的类型。取值：

    • 0：云服务器 ECS
    • 1：负载均衡
    • 3：云数据库 RDS
    • 4：云数据库 MongoDB 版
    • 5：云数据库 Tair（兼容 Redis）
    • 6：容器镜像服务
    • 8：容器服务 Kubernetes 版
    • 9：专有网络 VPC
    • 11：操作审计
    • 12：CDN
    • 13：数字证书管理服务（原 SSL 证书）
    • 14：云效
    • 16：DDoS 防护
    • 17：Web 应用防火墙
    • 18：对象存储
    • 19：云原生关系型数据库 PolarDB
    • 20：云数据库 PostgreSQL 版
    • 21：微服务引擎
    • 22：文件存储 NAS
    • 23：数据安全中心
    • 24：弹性公网 IP
    • 25：云身份服务-EIAM
    • 26：PolarDB-X
    • 27：Elasticsearch
    		9
    AssetSubTypeinteger否

    云产品的子类型。 资产的类型-子类型。取值：

    • 0：云服务器 ECS
      • 1：磁盘（存储）
      • 2：安全组
      • 100：实例
    • 1：负载均衡
      • 0：负载均衡
      • 1：应用型负载均衡
    • 3：云数据库 RDS
      • 0：实例
    • 4：云数据库 MongoDB 版
      • 0：实例
    • 5：云数据库 Tair（兼容 Redis）
      • 0：实例
    • 6：容器镜像服务
      • 1：企业版
      • 2：个人版
    • 8：容器服务 Kubernetes 版
      • 0：集群
    • 9：专有网络 VPC
      • 0：NAT 网关
      • 1：EIP
      • 2：VPN
      • 3：FLOW_LOG
    • 11：操作审计
      • 0：跟踪
    • 12：CDN
      • 0：实例
    • 13：数字证书管理服务（原 SSL 证书）
      • 0：证书
    • 14：云效
      • 0：组织
    • 16：DDoS 防护
      • 0：实例
    • 17：Web 应用防火墙
      • 0：域名
    • 18：对象存储
      • 0：Bucket
    • 19：云原生关系型数据库 PolarDB
      • 0：集群
    • 20：云数据库 PostgreSQL 版
      • 0：实例
    • 21：微服务引擎
      • 0：集群
    • 22：文件存储 NAS
      • 0：文件系统
    • 23：数据安全中心
      • 0：实例
    • 24：弹性公网 IP
      • 0：任播弹性公网 IP
    • 25：云身份服务-EIAM
      • 0：实例
    • 26：PolarDB-X
      • 0：实例
    • 27：Elasticsearch
      • 0：实例
    		2

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

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

    		24A20733-10A0-4AF6-BE6B-E3322413BB68
    CriteriaListarray<object>

    云产品资产支持检索项信息列表。

    Criteriaobject

    云产品资产支持检索项信息。

    Typestring

    查询条件的类型。取值：

    • input：需要手动输入查询字段。
    • select：需要从下拉列表中选择查询条件的子类型。
    		select
    Namestring

    查询条件的名称。

    • instanceId：实例 ID。
    • instanceName：实例名称。
    • internetIp：公网 IP。
    • riskStatus：风险状态。
    • vendorRegionId：按厂商分类 RegionId。
    		instanceId
    Valuesstring

    Type（查询条件的类型）为 select（选择型）时，可选项的值。

    说明 Type（查询条件的类型）为 input（输入型）时，该参数返回值为空。
    		fvt*
    MultiValuesstring

    输入的模糊匹配值对应的资产的具体结构化属性值。JSON 格式，包含以下字段：

    • vendor：供应商
    • regionIds：支持地域
    		[{"vendor":0,"regionIds":{"default":["ap-southeast-1","ap-northeast-2","ap-southeast-3","ap-southeast-5","ap-southeast-7","me-central-1"]}},{"vendor":1,"regionIds":{"default":["outside-of-aliyun"]}}]

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "24A20733-10A0-4AF6-BE6B-E3322413BB68",
  "CriteriaList": [
    {
      "Type": "select",
      "Name": "instanceId",
      "Values": "fvt*",
      "MultiValues": "[{\"vendor\":0,\"regionIds\":{\"default\":[\"ap-southeast-1\",\"ap-northeast-2\",\"ap-southeast-3\",\"ap-southeast-5\",\"ap-southeast-7\",\"me-central-1\"]}},{\"vendor\":1,\"regionIds\":{\"default\":[\"outside-of-aliyun\"]}}]"
    }
  ]
}

    错误码

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

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

    变更历史

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