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

私有网络

复制全文
下载 pdf
流量镜像
DescribeTrafficMirrorTargets - 查询流量镜像目的
复制全文
下载 pdf
DescribeTrafficMirrorTargets - 查询流量镜像目的
调用 DescribeTrafficMirrorTargets 接口,查询满足指定条件的镜像目的。​
使用说明​
  • 传入多个请求参数,按照传入的参数进行查询,返回符合所有条件的镜像目的,若没有符合条件的镜像目的,则返回空值。​
  • 若请求参数非必选参数均未传入,则按照当前登录账号查询,返回当前账号下的所有镜像目的。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:DescribeTrafficMirrorTargets​
接口名称。当前 API 的名称为DescribeTrafficMirrorTargets。​
​
Version String 必选 示例值:2020-04-01​
接口版本。当前 API 的版本为 2020-04-01。​
​
TrafficMirrorTargetName String 可选 示例值:TM_Target_1​
镜像目的的名称。​
​
TrafficMirrorTargetIds.N String 可选 示例值:tmt-35bvae1r7rv283dy2w2ll****​
镜像目的的ID。​
  • 参数 - N:表示镜像目的ID的序号,单次调用数量上限为100个。​
  • 多个镜像目的ID之间用&分隔。​
​
ProjectName String 可选 示例值:default​
镜像目的所属的项目。​
​
TagFilters.N.Key String 可选 示例值:k1​
标签的标签键。​
  • 参数 - N:表示标签键的序号,取值范围:1~10。​
  • 多个标签键之间用&分隔。多个标签键之间的关系为逻辑“与(AND)”,即查询同时添加多个标签键的镜像目的。​
​
TagFilters.N.Values.N String 可选 示例值:v1​
标签的标签值。​
  • 第一个N:表示标签键的序号。​
  • 第二个N:表示标签值的序号,取值范围:1~3。同一标签键多个标签值之间的关系为逻辑“或(OR)”,即查询同一标签键下添加其中一个标签值的镜像目的。​
  • 多个标签值之间用&分隔。​
说明​
  • 若传入该参数,则必须先传入TagFilters.N.Key。​
  • 传入空字符串时,表示查询标签值为空的镜像目的。​
​
NextToken String 可选 示例值:caeba0bbb2be03f84eb48b699f0a****​
分页查询凭证,用于标记分页的位置。​
  • 不填则从头开始查询。​
  • 传入之前调用本API返回的NextToken,则从该次API调用标记分页的位置往后开始查询。​
​
MaxResults Integer 可选 示例值:50​
查询的数量,默认为 10,最大为100。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
RequestId String 示例值:2021062415303301022514515207C4****​
请求ID。​
​
NextToken String 示例值:caeba0bbb2be03f84eb48b699f0a****​
本次API调用返回的查询凭证,标记分页的位置,用于下一次查询。返回为空表示没有下一页。​
​
TrafficMirrorTargets Object[] 示例值:-​
TrafficMirrorTargets的详细信息。​
InstanceType String 示例值:NetworkInterface​
镜像目的的资源类型。​
  • NetworkInterface:弹性网卡。​
  • ClbInstance:传统型负载均衡。​
​
InstanceId String 示例值:eni-171l3vhbti9ds4d1w34rq****​
镜像目的的资源ID。​
​
TrafficMirrorTargetId String 示例值:tmt-35bvae1r7rv283dy2w2ll****​
镜像目的的ID。​
​
TrafficMirrorTargetName String 示例值:TM_Target_1​
镜像目的名称。​
​
Description String 示例值:TM_Target_1_descirption​
镜像目的描述。​
​
Status String 示例值:Available​
镜像目的状态。​
  • Available:可用。​
  • Creating:创建中。​
​
CreatedAt String 示例值:2021-08-05T21:46:55+08:00​
镜像会话的创建时间。​
​
UpdatedAt String 示例值:2021-08-05T21:46:55+08:00​
镜像会话的更新时间。​
​
ProjectName String 示例值:default​
镜像目的所属项目的名称。​
​
Tags Object[] 示例值:-​
镜像目的的标签信息。​
Key String 示例值:k1​
标签的标签键。​
​
Value String 示例值:v1​
标签的标签值。​
​
​
​
​
​
请求示例​
​
GET /?Action=DescribeTrafficMirrorTargets&Version=2020-04-01&NextToken=caeba0bbb2be03f84eb48b699f0a****&MaxResults=50 HTTP/1.1​
Host: vpc.cn-beijing.volcengineapi.com​
X-Date: 20250804T033538Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250804/cn-beijing/vpc/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribeTrafficMirrorTargets",​
"Version": "2020-04-01",​
"Service": "vpc",​
"Region": "cn-beijing"​
},​
"Result": {​
"NextToken": "caeba0bbb2be03f84eb48b699f0a****",​
"RequestId": "2021062415303301022514515207C4****",​
"TrafficMirrorTargets": [​
{​
"Tags": [​
{​
"Key": "k1",​
"Value": "v1"​
}​
],​
"Status": "Available",​
"CreatedAt": "2021-08-05T21:46:55+08:00",​
"UpdatedAt": "2021-08-05T21:46:55+08:00",​
"InstanceId": "eni-171l3vhbti9ds4d1w34rq****",​
"Description": "TM_Target_1_descirption",​
"ProjectName": "default",​
"InstanceType": "NetworkInterface",​
"TrafficMirrorTargetId": "tmt-35bvae1r7rv283dy2w2ll****",​
"TrafficMirrorTargetName": "TM_Target_1"​
}​
]​
}​
}​
​
错误码​
​
状态码​
错误码​
错误信息​
说明​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
该请求设置为DryRun操作,操作授权已获得许可,但未被实际执行。​
400​
InvalidMaxResults.Malformed​
The specified parameter MaxResults is malformed.​
查询数量不合法。​
400​
InvalidNextToken.Malformed​
The specified parameter NextToken is invalid.​
查询 NextToken 不合法。​
400​
InvalidPage.Malformed​
The specified page is malformed.​
指定的分页参数不合法。​
400​
InvalidTagFilter.Disorder​
The specified index order of tag filter is malformed.​
指定标签过滤项的索引顺序参数格式不合法。​
400​
InvalidTagFilterKey.Malformed​
The specified parameter tag filter key is invalid.​
过滤标签键不合法。​
400​
InvalidTagFilterValue.Malformed​
The specified parameter tag filter value is invalid.​
过滤标签值不合法。​
400​
LimitExceeded.TagFilterKey​
You've reached the limit on the number of tag keys that you can filter.​
已达到单次可指定过滤标签键数量的上限。​
400​
LimitExceeded.TagFilterValue​
You've reached the limit on the number of tag values that you can filter.​
已达到单次可指定过滤标签值数量的上限。​
400​
LimitExceeded.TrafficMirrorTargetIds​
You've reached the limit on the number of traffic mirror target IDs that you can describe.​
已达到可查询的流量镜像目的ID数量上限。​
​
​
最近更新时间:2026.08.12 11:42:46
这个页面对您有帮助吗?
有用
有用
无用
无用