调用 CreateTrafficMirrorFilter 接口，创建筛选条件。 ## 调用说明 CreateTrafficMirrorFilter为异步接口，即返回请求ID时，系统后台仍在创建。您可调用 [DescribeTrafficMirrorFilters](https://www.volcengine.com/docs/6401/1157315) 查看筛选条件的状态，`Creating`表示创建中，`Available` 表示创建完成。 ## 请求参数 |参数名称 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Action |String |是 |CreateTrafficMirrorFilter |要执行的操作，取值为CreateTrafficMirrorFilter。 | |Version |String |是 |2020\-04\-01 |API版本信息，当前版本为2020\-04\-01。 | |TrafficMirrorFilterName|String|否|TM_Filter_1|筛选条件的名称。|\ | | | | ||\ | | | | |* 长度限制为1 ~ 128个字符。|\ | | | | |* 需要以字母、中文或数字开头，可包含点号（.）、下划线（_）和短横线（\-）。|\ | | | | |* 不填默认为筛选条件的ID。 | |Description|String|否|TM_Filter_1_Description|筛选条件的描述。|\ | | | | ||\ | | | | |* 长度限制为0~ 255个字符。|\ | | | | |* 不填默认为空字符串。|\ | | | | |* 需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（\-）、中文逗号（，）、中文句号（。）。 | |ProjectName |String |否 |default |筛选条件所属项目的名称。不填默认加入default项目。 | |Tags.N.Key|String|否|Tags.1.Key=key1&Tags.2.Key=key2|用户标签的标签键。|\ | | | | ||\ | | | | |* 参数 \- N：表示标签键的序号，取值范围：1～50。|\ | | | | |* 多个标签键之间用&分隔。|\ | | | | |* 不能以 `volc:`或`sys:`开头，包括任意大小写形式。|\ | | | | |* 长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（\-）和@（@）。|\ | | | | |* 若标签键开头或结尾存在空格，系统会自动为其去除。|\ | | | | ||\ | | | | |:::tip|\ | | | | |同一资源的标签键不允许重复。|\ | | | | ||\ | | | | |:::| |Tags.N.Value|String|否|Tags.1.Value=value1&Tags.2.Value=value2|用户标签的标签值。|\ | | | | ||\ | | | | |* 参数 \- N：表示标签值的序号，取值范围：1～50。|\ | | | | |* 多个标签值之间用&分隔。|\ | | | | |* 长度取值范围为0～256字符，不填默认为空。|\ | | | | |* 允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（\-）和@（@）。|\ | | | | |* 大小写敏感。|\ | | | | |* 若标签值开头或结尾存在空格，系统会自动为其去除。|\ | | | | ||\ | | | | |:::tip|\ | | | | |若传入该参数，则必须先传入`Tags.N.Key`。|\ | | | | ||\ | | | | |:::| |ClientToken|String|否|123e4567\-e89b\-12d3\-a456\-42665544\*\*\*\*|客户端Token，用于保证请求幂等性。|\ | | | | ||\ | | | | |* 由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。|\ | | | | |* 仅支持ASCII字符，且不能超过64个字符。|\ | | | | |* 若不传入ClientToken，则此次API调用不进行幂等校验。 | ## 返回数据 |参数名称 |类型 |示例值 |描述 | |---|---|---|---| |RequestId |String |2021062415303301022514515207C4\*\*\*\* |请求ID。 | |TrafficMirrorFilterId |String |tmf\-bp1opxu1zkhn00123\*\*\*\* |筛选条件的ID。 | ## 请求示例 ```Plain Text GET /?Action=CreateTrafficMirrorFilter&Version=2020-04-01&TrafficMirrorFilterName=TM_Filter_1 HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing ``` ## 返回示例 ```Plain Text { "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "CreateTrafficMirrorFilter", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result": { "RequestId": "2021062415303301022514515207C4****", "TrafficMirrorFilterId": "tmf-bp1opxu1zkhn00123****" } } ``` ## 错误码公共错误码，请参见 [公共错误码](https://www.volcengine.com/docs/6404/76490) 。 |HttpCode |错误码 |错误信息 |描述 | |---|---|---|---| |400 |IdempotentParameterMismatch |Arguments on this idempotent request are inconsistent with arguments used in previous request(s). |此幂等请求的参数与前一个请求中使用的参数不一致。 | |400 |InvalidDescription.Malformed |The specified description is malformed. |指定的描述格式不合法。请修复描述格式后重试。 | |400 |InvalidDescription.Malformed |The specified description is malformed. Ensure the maximum length of description is 255. |指定的描述格式不合法。描述长度不能超过255个字符。 | |400 |InvalidName.Malformed |The specified name is malformed. Ensure the maximum length of name is 128. |指定的名称格式不合法。名称长度不能超过128个字符。 | |400 |InvalidName.Malformed |The specified name is malformed. |指定的名称格式不合法。请修复名称格式后重试。 | |400 |InvalidParameter.ClientTokenMalformed |The specified parameter ClientToken is malformed. |指定的参数ClientToken格式不合法，长度不能超过64个ASCII字符。 | |400 |InvalidTag.Disorder |The specified index order of tag is malformed. |指定标签的索引顺序参数格式不合法。 | |400 |InvalidTagKey.Malformed |The specified parameter tag key is invalid. |标签键不合法。 | |400 |InvalidTagValue.Malformed |The specified parameter tag value is invalid. |标签值不合法。 | |400 |LimitExceeded.Tags |You've reached the limit on the number of tags that you can operate at one time. |已达到单次可操作标签数量的上限。 | |400 |QuotaExceeded.TrafficMirrorFilter |You've reached the limit on the number of traffic mirror filters that you can create. |已达到可创建镜像流量筛选条件的数量上限。 | |404 |InvalidProject.NotFound |The specified Project does not exist. |指定的项目不存在。 | |412|IdempotentProcessing|The request uses the same client token as a previous one that is still in process. |幂等请求处理中。|\ | | | | |

私有网络