全部产品
Search
文档中心

专有网络 VPC:ListTrafficMirrorSessions - 查询镜像会话的详细信息

更新时间:Mar 13, 2024

查询镜像会话的详细信息。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vpc:ListTrafficMirrorSessionsList
  • TrafficMirrorSession
    acs:vpc:{#regionId}:{#accountId}:trafficmirrorsession/*

请求参数

名称类型必填描述示例值
TrafficMirrorSessionNamestring

镜像会话的名称。

名称长度为 1~128 个字符,不能以http://https://开头。

abc
MaxResultsinteger

本次查询的最大记录条数。取值范围:1~100。默认值:10

10
NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次 API 调用返回的 NextToken 值。
FFmyTO70tTpLG6I3FmYAXGKPd****
TrafficMirrorSourceIdstring

镜像源的实例 ID,目前支持弹性网卡作为镜像源。

eni-j6c8znm5l1yt4sox*****
TrafficMirrorTargetIdstring

镜像目的的实例 ID,目前支持弹性网卡和私网负载均衡实例作为镜像目的。

eni-j6c2fp57q8rr47rp****
TrafficMirrorFilterIdstring

流量镜像筛选条件的实例 ID。

tmf-j6cmls82xnc86vtpe****
VirtualNetworkIdinteger

指定 VNI,用来区分不同的镜像流量,取值范围为 0~16777215。您可以通过 VNI 在镜像目的区分不同会话的镜像流量。您可以自定义 VNI 的值,也可以由系统随机分配该值。如果由系统随机分配该值,请不传该参数。

10
Priorityinteger

镜像会话的优先级,取值范围为 1~32766

数字越小,优先级越高。同一账号在同一个地域创建的镜像会话优先级不能重复。

1
Enabledboolean

是否开启流量会话,取值:

  • false(默认值):不开启流量会话。

  • true:开启流量会话。

false
TrafficMirrorSessionIdsarray

镜像会话的实例 ID。其中 N 最大取值为 100,即支持查询最多 100 个镜像会话。

string

镜像会话的实例 ID。其中 N 最大取值为 100,即支持查询最多 100 个镜像会话。

tms-j6cla50buc44ap8tu****
RegionIdstring

镜像会话的所属地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。关于流量镜像支持的地域,请参见流量镜像概述

cn-hongkong
ResourceGroupIdstring

需要查询的流量镜像所属的资源组 ID。

rg-bp67acfmxazb4ph****
Tagsobject []

标签列表。

Keystring

资源的标签键。最多支持输入 20 个标签键。如需传入该值,则不能输入空字符串。

一个标签键最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

FinanceDept
Valuestring

资源的标签值。最多支持输入 20 个标签值。如需传入该值,可以输入空字符串。

最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

FinanceJoshua

返回参数

名称类型描述示例值
object

是否拥有下一次查询的令牌(Token)。取值:

  • 如果 NextToken 为空表示没有下一次查询。
  • 如果 NextToken 有返回值,该取值表示下一次查询开始的令牌。
NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 如果 NextToken 为空表示没有下一次查询。
  • 如果 NextToken 有返回值,该取值表示下一次查询开始的令牌。
FFmyTO70tTpLG6I3FmYAXGKPd****
RequestIdstring

请求 ID。

739CA01C-92EB-4C69-BCC0-280149C6F41E
TotalCountstring

返回结果总数。

1
TrafficMirrorSessionsobject []

镜像会话的详情列表。

TrafficMirrorTargetIdstring

镜像目的的实例 ID。

eni-j6c2fp57q8rr47rp****
TrafficMirrorSessionIdstring

镜像会话的实例 ID。

tms-j6cla50buc44ap8tu****
Priorityinteger

镜像会话的优先级。

数字越小,优先级越高。

1
TrafficMirrorTargetTypestring

镜像目的类型,取值:

  • NetworkInterface:弹性网卡。

  • SLB:私网负载均衡实例。

NetworkInterface
PacketLengthinteger

指定被镜像的原始报文长度(不包含 VXLAN 报文长度),默认值 1500,取值范围:648500,单位:字节。

  • 该参数的大小会影响镜像目的收到的报文长度,详情请参见流量镜像概述中的镜像报文长度和 MTU 限制。

  • 该参数仅在部分地域可用,详情请参见创建和管理流量镜像中的镜像报文长度参数描述。

1500
TrafficMirrorSessionDescriptionstring

镜像会话的描述信息。

This is a session.
TrafficMirrorSessionStatusstring

镜像会话的状态,取值:

  • Creating:创建中。
  • Created:已创建。
  • Modifying:修改中。
  • Deleting:删除中。
Created
Enabledboolean

是否已开启流量会话,取值:

  • false(默认值):不开启流量会话。

  • true:开启流量会话。

false
TrafficMirrorSessionBusinessStatusstring

镜像会话的业务状态,取值:

  • Normal:正常。

  • FinancialLocked:欠费锁定。

Normal
VirtualNetworkIdinteger

指定 VNI,用来区分不同的镜像流量。

10
TrafficMirrorFilterIdstring

流量镜像筛选条件的实例 ID。

tmf-j6cmls82xnc86vtpe****
TrafficMirrorSessionNamestring

镜像会话的名称。

abc
TrafficMirrorSourceIdsarray

镜像源的实例 ID。

string

镜像源的实例 ID。

eni-j6c8znm5l1yt4sox****
ResourceGroupIdstring

流量镜像所属的资源组 ID。

rg-bp67acfmxazb4ph****
Tagsobject []

标签列表。

Keystring

标签键。

FinanceDept
Valuestring

标签值。

FinanceJoshua
CreationTimestring

镜像会话的创建时间。

2023-09-05T15:26Z

示例

正常返回示例

JSON格式

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "739CA01C-92EB-4C69-BCC0-280149C6F41E",
  "TotalCount": "1",
  "TrafficMirrorSessions": [
    {
      "TrafficMirrorTargetId": "eni-j6c2fp57q8rr47rp****",
      "TrafficMirrorSessionId": "tms-j6cla50buc44ap8tu****",
      "Priority": 1,
      "TrafficMirrorTargetType": "NetworkInterface",
      "PacketLength": 1500,
      "TrafficMirrorSessionDescription": "This is a session.",
      "TrafficMirrorSessionStatus": "Created",
      "Enabled": false,
      "TrafficMirrorSessionBusinessStatus": "Normal",
      "VirtualNetworkId": 10,
      "TrafficMirrorFilterId": "tmf-j6cmls82xnc86vtpe****",
      "TrafficMirrorSessionName": "abc",
      "TrafficMirrorSourceIds": [
        "eni-j6c8znm5l1yt4sox****"
      ],
      "ResourceGroupId": "rg-bp67acfmxazb4ph****",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ],
      "CreationTime": "2023-09-05T15:26Z"
    }
  ]
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-12-18OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
2023-08-30OpenAPI 描述信息更新看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新