You need to enable JavaScript to run this app.
文档中心
私有网络

私有网络

复制全文
下载 pdf
流量镜像
CreateTrafficMirrorTarget - 创建流量镜像目的
复制全文
下载 pdf
CreateTrafficMirrorTarget - 创建流量镜像目的
调用 CreateTrafficMirrorTarget 接口,创建镜像目的。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:CreateTrafficMirrorTarget​
接口名称。当前 API 的名称为CreateTrafficMirrorTarget。​
​
Version String 必选 示例值:2020-04-01​
接口版本。当前 API 的版本为 2020-04-01。​
​
InstanceType String 必选 示例值:NetworkInterface​
镜像目的的资源类型。取值如下:​
  • NetworkInterface:弹性网卡。​
  • ClbInstance:传统型负载均衡。​
​
InstanceId String 必选 示例值:eni-171l3vhbti9ds4d1w34rq****​
镜像目的的资源ID。​
您可以调用 DescribeNetworkInterfaces 或DescribeLoadBalancers 接口,查询网卡或CLB的ID​
​
TrafficMirrorTargetName String 可选 示例值:TM_Target_1​
镜像目的的名称。​
  • 长度限制为1 ~ 128个字符。​
  • 需要以字母、中文或数字开头,可包含点号(.)、下划线(_)和短横线(-)。​
  • 不填默认为镜像目的的ID。​
​
Description String 可选 示例值:TM_Target_1_descirption​
镜像目的的描述。​
  • 长度限制为0 ~ 255个字符。​
  • 不填默认为空字符串。​
  • 需要以字母、中文或数字开头。可包含英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。)。​
​
ProjectName String 可选 示例值:default​
镜像目的所属项目的名称。不填默认加入default项目。​
​
Tags.N.Key String 可选 示例值:key1​
用户标签的标签键。​
  • 参数 - N:表示标签键的序号,取值范围:1~50。​
  • 多个标签键之间用&分隔。​
  • 不能以 volc:或sys:开头,包括任意大小写形式。​
  • 长度取值范围为1~128字符,允许输入各国语言文字、数字、空格( )、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、中划线(-)和@(@)。​
  • 若标签键开头或结尾存在空格,系统会自动为其去除。​
说明​
同一资源的标签键不允许重复。​
​
Tags.N.Value String 可选 示例值:value1​
用户标签的标签值。​
  • 参数 - N:表示标签值的序号,取值范围:1~50。​
  • 多个标签值之间用&分隔。​
  • 长度取值范围为0~256字符,不填默认为空。​
  • 允许输入各国语言文字、数字、空格( )、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、中划线(-)和@(@)。​
  • 大小写敏感。​
  • 若标签值开头或结尾存在空格,系统会自动为其去除。​
说明​
若传入该参数,则必须先传入Tags.N.Key。​
​
ClientToken String 可选 示例值:123e4567-e89b-12d3-a456-42665544****​
客户端Token,用于保证请求幂等性。​
  • 由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。​
  • 仅支持ASCII字符,且不能超过64个字符。​
  • 若不传入ClientToken,则此次API调用不进行幂等校验。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
RequestId String 示例值:2021062415303301022514515207C4****​
请求ID。​
​
TrafficMirrorTargetId String 示例值:tmt-35bvae1r7rv283dy2w2ll****​
镜像目的ID。​
​
​
​
请求示例​
​
GET /?Action=CreateTrafficMirrorTarget&Version=2020-04-01&InstanceType=NetworkInterface&InstanceId=eni-171l3vhbti9ds4d1w34rq****&TrafficMirrorTargetName=TM_Target_1 HTTP/1.1​
Host: vpc.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/vpc/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "CreateTrafficMirrorTarget",​
"Version": "2020-04-01",​
"Service": "vpc",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "2021062415303301022514515207C4****",​
"TrafficMirrorTargetId": "tmt-35bvae1r7rv283dy2w2ll****"​
}​
}​
​
错误码​
​
状态码​
错误码​
错误信息​
说明​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
该请求设置为DryRun操作,操作授权已获得许可,但未被实际执行。​
400​
IdempotentParameterMismatch​
Arguments on this idempotent request are inconsistent with arguments used in previous request(s).​
此幂等请求的参数与前一个请求中使用的参数不一致。​
400​
InvalidClb.InvalidStatus​
The specified CLB is not in the correct status for the request. Current CLB has been frozen.​
指定的CLB所处状态无法响应该请求。当前CLB被冻结。​
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​
InvalidEni.InstanceMismatch​
The specified elastic network interface is not attached to the specified instance.​
指定的弹性网卡没有绑定到ECS实例。​
400​
InvalidEni.InvalidStatus​
The specified elastic network interface is not in the correct status for the request.​
指定的弹性网卡所处的状态无法响应该请求。​
400​
InvalidInstance.IPv4Disabled​
IPv4 has been disabled for the specified instance.​
指定实例已经禁用IPv4。​
400​
InvalidInstanceType.Malformed​
The specified InstanceType is malformed.​
指定的实例类型参数不合法。​
400​
InvalidName.Malformed​
The specified name is malformed.​
指定的名称格式不合法。请修复名称格式后重试。​
400​
InvalidName.Malformed​
The specified name is malformed. Ensure the maximum length of name is 128.​
指定的名称格式不合法。名称长度不能超过128个字符。​
400​
InvalidNetworkInterface.InvalidType​
The type of specified elastic network interface is illegal for the request.​
指定类型的弹性网卡无法响应该请求。​
400​
InvalidParameter.ClientTokenMalformed​
The specified parameter ClientToken is malformed.​
指定的参数ClientToken格式不合法,长度不能超过64个ASCII字符。​
400​
InvalidParameter.NetworkInterfaceId​
The network interface must not be the source and the target of traffic mirror sessions at the same time.​
网卡不能同时作为流量镜像会话的源和目的。​
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.TrafficMirrorTarget​
You've reached the limit on the number of traffic mirror targets that you can create.​
已达到可创建镜像流量目的的数量上限。​
404​
InvalidInstanceId.NotFound​
The specified instance does not exist.​
指定的实例不存在。​
404​
InvalidProject.NotFound​
The specified Project does not exist.​
指定的项目不存在。​
409​
InvalidTrafficMirrorTarget.Conflict​
The specified traffic mirror target conflicts with that of another traffic mirror target.​
指定的流量镜像目的与另一个流量镜像目的冲突。​
412​
IdempotentProcessing​
The request uses the same client token as a previous one that is still in process.​
幂等请求处理中。​
​
​
最近更新时间:2026.02.09 16:06:07
这个页面对您有帮助吗?
有用
有用
无用
无用