文档

DescribeWhiteListEffectiveAssets - 查询策略生效服务器

更新时间:

查询应用白名单策略生效的服务器。

接口说明

应用白名单为公测功能,目前已不再支持申请该功能。已申请或正在使用中的用户可以正常调用该接口。

调试

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

授权信息

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

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

请求参数

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

请求源 IP。无需填写,系统自动获取。

27.212.XX.XX
Langstring

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

  • zh:中文
  • en:英文
zh
Remarkstring

资产检索项。可填写资产的 IP、公网 IP、内网 IP、资产名称进行模糊匹配。

222.185.XX.XX
StrategyIdlong

策略编号。

说明 调用 DescribeWhiteListStrategyList 接口可以获取该参数。
8437592
NeedStatisticsinteger

是否需要返回资产不可信程序异常启动的异常行为数量。取值:

  • 0:否
  • 1:是
0
PageSizeinteger

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

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

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

1

返回参数

名称类型描述示例值
object

请求返回数据。

CurrentPageinteger

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

1
PageSizeinteger

分页查询时,每页显示的数据的最大条数。

20
RequestIdstring

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

A4EB8B1C-1DEC-5E18-BCD0-D1BBB39****
TotalCountinteger

生效的服务器总数。

100
Countinteger

分页查询时,显示的当前页的数据条数。

10
Assetsarray<object>

生效的服务器信息列表。

Assetobject

生效的服务器信息。

Uuidstring

服务器 UUID。

544900ff-1be7-4655-9719-6311cecb3****
StrategyIdlong

策略 ID。

35815387
StrategyNamestring

策略名称。

test
InternetIpstring

服务器的公网 IP。

60.205.XX.XX
SuspiciousEventCountinteger

服务器存在的不可信程序异常启动的异常行为数量。

5
ProcessMethodinteger

异常处理模式。取值:

  • 0:不处理
  • 1:告警
  • 2:阻断
1
MachineNamestring

服务器名称。

test
IntranetIpstring

私网 IP 地址。

192.168.XX.XX

示例

正常返回示例

JSON格式

{
  "CurrentPage": 1,
  "PageSize": 20,
  "RequestId": "A4EB8B1C-1DEC-5E18-BCD0-D1BBB39****",
  "TotalCount": 100,
  "Count": 10,
  "Assets": [
    {
      "Uuid": "544900ff-1be7-4655-9719-6311cecb3****",
      "StrategyId": 35815387,
      "StrategyName": "test",
      "InternetIp": "60.205.XX.XX",
      "SuspiciousEventCount": 5,
      "ProcessMethod": 1,
      "MachineName": "test",
      "IntranetIp": "192.168.XX.XX"
    }
  ]
}

错误码

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

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