ListInterceptionRulePage - 查询微隔离防御规则

更新时间:
复制 MD 格式

查询微隔离防御规则。

调试

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

调试

授权信息

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

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

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:ListInterceptionRulePage

get

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

ClusterId

string

是

指定要查询的容器集群的 ID。

本参数必须是已接入容器微隔离功能的 ACK 集群 ID。可调用 DescribeClusterInfoList 并设置 Type=interceptionSwitch,或调用 ListClusterInterceptionConfig 查询可用集群。

cc41de13ab5474210bc0ce772a009****

Criteria

string

否

查询条件。

80

CriteriaType

string

否

搜索条件类型。取值:

  • ID

  • RULE_NAME

  • SRC_TARGET

  • DST_TARGET

  • DST_PORT

  • RULE_SWITCH

  • INTERCEPTOR_TYPE

DST_PORT

CurrentPage

integer

是

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

1

PageSize

integer

是

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

50

返回参数

名称

类型

描述

示例值

object

RequestId

string

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

ACF97412-FD09-4D1F-994F-34DF12BR****

PageInfo

object

查询结果页面的信息。

CurrentPage

integer

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

19

PageSize

integer

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

20

TotalCount

integer

查询结果的总记录数。

2

Count

integer

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

20

InterceptionRuleList

array<object>

查询到的规则信息。

array<object>

查询到的规则信息。

RuleType

string

规则类型。

customize

RuleSwitch

integer

调度规则的开关状态。取值:

  • 1:表示开启。

  • 0:表示关闭。

1

RuleId

integer

规则 ID。

30****

RuleName

string

规则名称。

test

SrcTarget

object

源对象。

AppName

string

应用名称。

ack-jenkins-lawr****

RuleType

string

规则类型。取值:

  • suggest: 智能推荐

  • customize: 用户自定义

  • system: 系统

customize

TargetId

integer

网络对象的 ID。

40****

TargetName

string

网络对象的名称。

mhh-te****

Namespace

string

命名空间。

jenkins

TargetType

string

受影响的资产类型。

containerId

ImageList

array

对应镜像列表。

string

对应镜像列表。

nginx:1.****

TagList

array

网络对象源标签列表。

string

网络对象源标签列表。

bpm

DstTarget

object

目标对象。

AppName

string

应用名称。

console

RuleType

string

规则类型。取值:

  • suggest: 智能推荐

  • customize: 用户自定义

  • system: 系统

customize

TargetId

integer

网络对象的 ID。

302001

TargetName

string

网络对象的名称。

demo4****

Namespace

string

命名空间。

test

TargetType

string

网络对象的类型。

IMAGE

Ports

array

目标服务器的端口信息。

string

端口信息。

{"tcp":"1234","udp":"5555"}

ImageList

array

受影响的镜像列表。

string

受影响的镜像列表。

nacos:v2.0****

TagList

array

网络对象目标标签列表。

string

网络对象目标标签列表。

111

OrderIndex

integer

排序。

1

InterceptType

integer

拦截模式。取值:

  • 0: 观察模式

  • 1: 拦截模式

  • 2: 告警模式

  • 3: 放行模式

1

示例

正常返回示例

JSON格式

{
  "RequestId": "ACF97412-FD09-4D1F-994F-34DF12BR****",
  "PageInfo": {
    "CurrentPage": 19,
    "PageSize": 20,
    "TotalCount": 2,
    "Count": 20
  },
  "InterceptionRuleList": [
    {
      "RuleType": "customize",
      "RuleSwitch": 1,
      "RuleId": 0,
      "RuleName": "test",
      "SrcTarget": {
        "AppName": "ack-jenkins-lawr****",
        "RuleType": "customize",
        "TargetId": 0,
        "TargetName": "mhh-te****",
        "Namespace": "jenkins",
        "TargetType": "containerId",
        "ImageList": [
          "nginx:1.****"
        ],
        "TagList": [
          "bpm"
        ]
      },
      "DstTarget": {
        "AppName": "console",
        "RuleType": "customize",
        "TargetId": 302001,
        "TargetName": "demo4****",
        "Namespace": "test",
        "TargetType": "IMAGE",
        "Ports": [
          "{\"tcp\":\"1234\",\"udp\":\"5555\"}"
        ],
        "ImageList": [
          "nacos:v2.0****"
        ],
        "TagList": [
          "111"
        ]
      },
      "OrderIndex": 1,
      "InterceptType": 1
    }
  ]
}

错误码

HTTP status code

错误码

错误信息

描述

500 ServerError ServerError 服务故障,请稍后重试!
403 NoPermission caller has no permission 当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。

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

变更历史

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