批量创建流量镜像筛选规则 - BatchCreateTrafficMirrorFilterRules
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
vpc:trafficMirrorFilterRules:create
Write
trafficMirrorFilter *
-
-
-
trafficMirrorFilterRule *
-
URI
POST /v3/{project_id}/vpc/traffic-mirror-filters/{traffic_mirror_filter_id}/traffic-mirror-filter-rules/batch-create
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 流量镜像筛选规则所属的项目ID。获取方式请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| traffic_mirror_filter_id | 是 | String | 参数解释: 流量镜像筛选条件的资源ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| traffic_mirror_filter_rules | 是 | Array of BatchCreateTrafficMirrorFilterRuleOption objects | 参数解释: 流量镜像筛选条件规则对象列表。 约束限制: 不涉及。 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| description | 否 | String | 参数解释: 流量镜像筛选规则的描述信息。 约束限制: 0-255个字符,不能包含“<”和“>”。 取值范围: 不涉及。 默认取值: 不涉及。 |
| direction | 是 | String | 参数解释: 流量方向。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| protocol | 是 | String | 参数解释: 镜像流量支持的网络协议类型。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| ethertype | 是 | String | 参数解释: 镜像流量的地址协议版本。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| source_cidr_block | 否 | String | 参数解释: 镜像流量的源地址。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| destination_cidr_block | 否 | String | 参数解释: 镜像流量的目的地址。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| source_port_range | 否 | String | 参数解释: 流量源端口范围。 约束限制: 取值范围: 1~65535 默认取值: 不涉及。 |
| destination_port_range | 否 | String | 参数解释: 流量目的端口范围。 约束限制: 取值范围: 1~65535 默认取值: 不涉及。 |
| action | 是 | String | 参数解释: 符合筛选条件的镜像流量的采集策略。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| priority | 是 | Integer | 参数解释: 镜像规则优先级。数字越小,优先级越高。 约束限制: 不涉及。 取值范围: 1~65535 默认取值: 不涉及。 |
响应参数
状态码:201
| 参数 | 参数类型 | 描述 |
|---|---|---|
| traffic_mirror_filter_rules | Array of TrafficMirrorFilterRule objects | 参数解释: 流量镜像筛选规则列表的响应体。 取值范围: 不涉及。 |
| request_id | String | 参数解释: 请求ID。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 流量镜像筛选规则的资源ID。 取值范围: 不涉及。 |
| project_id | String | 参数解释: 流量镜像筛选规则所属的项目ID。 取值范围: 不涉及。 |
| description | String | 参数解释: 流量镜像筛选规则的描述信息。 取值范围: 不涉及。 |
| traffic_mirror_filter_id | String | 参数解释: 流量镜像筛选规则所在流量镜像筛选条件的ID。 取值范围: 不涉及。 |
| direction | String | 参数解释: 流量镜像筛选规则的流量方向。 取值范围: |
| source_cidr_block | String | 参数解释: 流量镜像筛选规则的源地址。 取值范围: |
| destination_cidr_block | String | 参数解释: 流量镜像筛选规则的目的地址。 取值范围: |
| source_port_range | String | 参数解释: 流量镜像筛选规则的源端口范围。 取值范围: 1~65535 |
| destination_port_range | String | 参数解释: 流量镜像筛选规则的目的端口范围。 取值范围: 1~65535 |
| ethertype | String | 参数解释: 流量支持的IP地址类型。 取值范围: |
| protocol | String | 参数解释: 流量镜像支持的网络协议类型。 取值范围: |
| action | String | 参数解释: 流量镜像筛选规则的流量采集策略。 取值范围: |
| priority | Integer | 参数解释: 流量镜像筛选规则的优先级。 取值范围: 1~65535,数字越小,优先级越高。 |
| created_at | String | 参数解释: 流量镜像筛选规则的创建时间。 取值范围: 不涉及。 |
| updated_at | String | 参数解释: 流量镜像筛选规则的更新时间。 取值范围: 不涉及。 |
请求示例
批量创建2条流量镜像筛选规则,规则为入方向,协议为ICMP。
POST http://{endpoint}/v3/{project_id}/vpc/traffic-mirror-filters/{traffic_mirror_filter_id}/traffic-mirror-filter-rules/batch-create
{
"traffic_mirror_filter_rules" : [ {
"ethertype" : "IPv4",
"direction" : "ingress",
"protocol" : "icmp",
"source_cidr_block" : "192.168.0.0/24",
"action" : "accept",
"priority" : 29
}, {
"ethertype" : "IPv4",
"direction" : "ingress",
"protocol" : "icmp",
"source_cidr_block" : "192.168.21.0/24",
"action" : "reject",
"priority" : 10
} ]
} 响应示例
状态码:201
{
"request_id" : "8dec5453-1690-4378-a976-40ba5e6d62ff",
"traffic_mirror_filter_rules" : [ {
"id" : "1be5f64b-49a1-427d-a49e-9619cfb0492c",
"project_id" : "7365fcd452924e398ec4cc1fe39c0d12",
"description" : "",
"traffic_mirror_filter_id" : "417d7317-6c17-4428-a0f3-997d3e2293a0",
"direction" : "ingress",
"protocol" : "icmp",
"ethertype" : "IPv4",
"source_cidr_block" : "192.168.0.0/24",
"action" : "accept",
"priority" : 29,
"type" : "eni",
"created_at" : "2023-03-22T07:07:55.000+00:00",
"updated_at" : "2023-03-22T07:07:55.000+00:00"
}, {
"id" : "4a97b166-ba05-01a9-b8fe-78af978d334b",
"project_id" : "7365fcd452924e398ec4cc1fe39c0d12",
"description" : "",
"traffic_mirror_filter_id" : "417d7317-6c17-4428-a0f3-997d3e2293a0",
"direction" : "ingress",
"protocol" : "icmp",
"ethertype" : "IPv4",
"source_cidr_block" : "192.168.21.0/24",
"action" : "reject",
"priority" : 10,
"type" : "eni",
"created_at" : "2023-03-22T07:07:55.000+00:00",
"updated_at" : "2023-03-22T07:07:55.000+00:00"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 201 | Created |
错误码
请参见错误码。