---
title: "virtual-connection"
slug: "cli-sc-virtual-connection"
updated: 2025-07-03T08:41:01Z
published: 2025-09-03T14:11:33Z
canonical: "docs.crossworkassurance.cisco.com/cli-sc-virtual-connection"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossworkassurance.cisco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# virtual-connection

## virtual-connection add vca

virtual-connection add vca - Add a VCA instance to a remote device.

**Description:** Used to add a new virtual connection association by specifying a list of two or more VCEs or VCAs.

**Syntax:**

```
  virtual-connection add vca <vca-name> {
          {device <device-name>} |
          {vc-list <vc-name>+} }+

  <vca-name>       = <string>
  <vc-name>        = <string>
  <device-name>    = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device | Specify the remote device on which the traffic is to be generated. |
| vc-list | A comma-separated list of VCE instances or VCA containing a VCE tunnel referenced by name. |

## virtual-connection add/edit vca-vlan

virtual-connection add vca-vlan - Add a VCA instance using VLAN stack. virtual-connection edit vca-vlan - Edit a VCA instance using VLAN stack.

**Description:** Used to add or edit a virtual connection association by specifying the VLAN stack on each tp.

**Syntax:**

```
  virtual-connection <add|edit> vca-vlan <vca-name> {
            {name <vca-name>} |
            {device <device-name>} |
            {contain-tunnel {yes|no}} |
            {tp-a-port {UNI|NNI}} |
            {tp-z-port {UNI|NNI}} |
            {tp-a-vlan-stack-size {untag|all-to-one|1|2|3}} |
            {tp-z-vlan-stack-size {untag|all-to-one|1|2|3}} |
            {vlan-tp-a-1-tpid {0x8100|0x88a8|0x9100|none}} |
            {vlan-tp-a-1-id {<vlan-ids>|none}} |
            {vlan-tp-a-2-tpid {0x8100|0x88a8|0x9100|none}} |
            {vlan-tp-a-2-id {<vlan-id>|none}} |
            {vlan-tp-a-3-tpid {0x8100|0x88a8|0x9100|none}} |
            {vlan-tp-a-3-id {<vlan-id>|none}} |
            {vlan-tp-z-1-tpid {0x8100|0x88a8|0x9100|none}} |
            {vlan-tp-z-1-id {<vlan-ids>|none}} |
            {vlan-tp-z-2-tpid {0x8100|0x88a8|0x9100|none}} |
            {vlan-tp-z-2-id {<vlan-id>|none}} |
            {vlan-tp-z-3-tpid {0x8100|0x88a8|0x9100|none}} |
            {vlan-tp-z-3-id {<vlan-id>|none}} |
            {tp-a1z1-pcp-mapping {<pcp-mapping-name>|none}} |
            {tp-z1a1-pcp-mapping {<pcp-mapping-name>|none}} |
            {tp-a12-pcp-mapping {<pcp-mapping-name>|none}} |
            {tp-z12-pcp-mapping {<pcp-mapping-name>|none}} |
            {tp-a23-pcp-mapping {<pcp-mapping-name>|none}} |
            {tp-z23-pcp-mapping {<pcp-mapping-name>|none}} }+

  <vca-name>         = <string>
  <device-name>      = <string>
  <vlan-id>          = <decimal> range 1-4094
  <vlan-ids>         = {<decimal>|<decimal>-<decimal>} range 0-4095
  <pcp-mapping-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| name | New name of the VCA-VLAN. |
| device | Specify the remote device on which the traffic is to be generated. |
| contain-tunnel | Determine if a VCE tunnel is required in the VCE chain. |
| tp-a-port | Defines the TP A external port. |
| tp-z-port | Defines the TP Z external port. |
| tp-a-vlan-stack-size | Defines the TP A VLAN stack size. |
| tp-z-vlan-stack-size | Defines the TP Z VLAN stack size. |
| vlan-tp-a-1-tpid | EtherType used in the TP A 1 VLAN tag (0x8100, 0x88a8 or 0x9100). |
| vlan-tp-a-1-id | Single VLAN ID or VLAN ID range in the TP A 1 VLAN tag. |
| vlan-tp-a-2-tpid | EtherType used in the TP A 2 VLAN tag (0x8100, 0x88a8 or 0x9100). |
| vlan-tp-a-2-id | Single VLAN ID in the TP A 2 VLAN tag. |
| vlan-tp-a-3-tpid | EtherType used in the TP A 3 VLAN tag (0x8100, 0x88a8 or 0x9100). |
| vlan-tp-a-3-id | Single VLAN ID in the TP A 3 VLAN tag. |
| vlan-tp-z-1-tpid | EtherType used in the TP Z 1 VLAN tag (0x8100, 0x88a8 or 0x9100). |
| vlan-tp-z-1-id | Single VLAN ID or VLAN ID range in the TP Z 1 VLAN tag. |
| vlan-tp-z-2-tpid | EtherType used in the TP Z 2 VLAN tag (0x8100, 0x88a8 or 0x9100). |
| vlan-tp-z-2-id | Single VLAN ID in the TP Z 2 VLAN tag. |
| vlan-tp-z-3-tpid | EtherType used in the TP Z 3 VLAN tag (0x8100, 0x88a8 or 0x9100). |
| vlan-tp-z-3-id | Single VLAN ID in the TP Z 3 VLAN tag. |
| tp-a1z1-pcp-mapping | PCP CoS profile name for mapping from TP A vid 1 to TP Z vid 1. |
| tp-z1a1-pcp-mapping | PCP CoS profile name for mapping from TP Z vid 1 to TP A vid 1. |
| tp-a12-pcp-mapping | PCP CoS profile name for mapping from TP A vid 1 to TP A vid 2. |
| tp-z12-pcp-mapping | PCP CoS profile name for mapping from TP A vid 2 to TP A vid 3. |
| tp-a23-pcp-mapping | PCP CoS profile name for mapping from TP Z vid 1 to TP Z vid 2. |
| tp-z23-pcp-mapping | PCP CoS profile name for mapping from TP Z vid 2 to TP Z vid 3. |

## virtual-connection add/edit vce

virtual-connection add vce - Add a new VCE on remote device virtual-connection edit vce - Edit existing VCE attributes on remote device

**Description:** Configure a VCE for network purposes. VCEs may be configured to query their configuration via a DHCP server or can be manually configured. The network mask can be configured with the IP address using the address prefix length notation or separately using the netmask keyword.

**Syntax:**

```
virtual-connection <add|edit> vce <vce-name> {
            {type {Customer|Operator|Tunnel}} |
            {name <vce-name>} |
            {device <device-name>} |
            {frame-type {all-to-one|untagged|vlan-tagged}} |
            {vid-relay-action {none|preserve|tag|translate|untag}} |
            {tpid {0x8100|0x88a8|0x9100}} |
            {component-id <decimal>} |
            {tp-a {internal|disabled|external}} |
            {tp-a-port {UNI|NNI}} |
            {tp-a-vid <vlan-ids>} |
            {tp-a-pcp-mapping <pcp-mapping-name>} |
            {tp-z {internal|disabled|external}} |
            {tp-z-port {UNI|NNI}} |
            {tp-z-vid <vlan-id>} |
            {tp-z-pcp-mapping <pcp-mapping-name>} |
            {l3-domain-state {enable|disable}} |
            {tp-a-l3-state {enable|disable}} |
            {tp-z-l3-state {enable|disable}} |
            {dhcp {enable|disable}} |
            {dhcp-rt-info {enable|disable}} |
            {address {<ip-addr>|<ip-addr-prefix>}} |
            {netmask {<subnet-mask>}} |
            {gateway {<ip-addr>}} }+

  <vce-name>          <string>
  <ip-addr-prefix>    <ip-addr>/{1-32}
  <vlan-id>           <decimal>
  <vlan-ids>          {<decimal>|<decimal>-<decimal>}
  <device-name>       <string>
  <pcp-mapping-name>  <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| name | Name of a Assurance Sensor Control VCE defined by system user. |
| type | Choose the type of VCE component: Customer, Operator or Tunnel. |
| device | Specify the remote device on which the traffic is to be generated. |
| frame-type | Determine the frame type assigned to the TP A port. |
| vid-relay-action | Determine the frame type assigned to the TP Z port. |
| tpid | EtherType used in the VLAN tag (0x8100, 0x88a8 or 0x9100). |
| component-id | The ID of the Component into which the VCE will be attached. Specifying 0 indicates that the system shall automatically assign a component ID. |
| tp-a | Defines the type of interface TP A is connected to. The TP can be connected to another VCE (internal) or an external port (external). |
| tp-a-port | Specify the port used by the TP A. |
| tp-a-vid | Single VLAN ID or VLAN ID range on the TP A port when the vid-relay-action is preserve, untag or translate. VLAN ID on the TP Z port when the vid-relay-action is preserve. |
| tp-a-pcp-mapping | CoS profile name with the type PCP. |
| tp-z | Defines the type of interface TP Z is connected to. The TP can be connected to another VCE (internal) or an external port (external). |
| tp-z-port | Specify the port used by the TP Z. |
| tp-z-vid | A single VLAN ID on the TP Z port when the vid-relay-action is tag or translate. |
| tp-z-pcp-mapping | CoS profile name with the type PCP. |
| l3-domain-state | Enable or disable IP domain on the VCE. |
| tp-a-l3-state | Enable or disable IP domain on the TP A port. |
| tp-z-l3-state | Enable or disable IP domain on the TP Z port. |
| dhcp | Enable or disable DHCP. |
| dhcp-rt-info | Use routing information learned via DHCP. |
| address | Static VCE IPv4 address. |
| netmask | VCE network mask for static IPv4 address. |
| gateway | A default gateway address provides a shortcut to creating a default gateway through the route configuration. Only one default gateway can be set per VCE. |
| ipv6_enable | Enable or disable IPv6 on the VCE. |
| ipv6_address | Static VCE IPv6 address, with prefix. |
| ipv6_gateway | IPv6 default gateway address. Only one IPv6 default gateway can be set per VCE. Note: Can be reset by setting the value to ::/0. |

## virtual-connection clear vca/vca-vlan bandwidth-regulator statistics

virtual-connection clear vca bandwidth-regulator statistics - Reset VCA bandwidth-regulator statistics virtual-connection clear vca-vlan bandwidth-regulator statistics - Reset VCA-VLAN bandwidth-regulator statistics

**Description:** Clear the bandwidth regulator statistics. If <regulator-name> is not specified, statistics of all bandwidth-regulators of the VCA will be cleared.

**Syntax:**

```
  virtual-connection clear <vca|vca-vlan> bandwidth-regulator statistics
    <vca-name> [<regulator-name>]
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <vca-name> | <string> Name of the VCA instance. |
| <regulator-name> | <string> Name of the regulator instance. |

## virtual-connection clear vce statistics

virtual-connection clear vce statistics - Reset vce statistics

**Description:** Clear the statistics of all the VCEs or of a single VCE.

**Syntax:**

```
  virtual-connection clear vce statistics [<vce-name>]
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <vce-name> | <string> |

## virtual-connection delete vca

virtual-connection delete vca - Delete a VCA instance

**Description:** Used to delete a VCA object.

**Syntax:**

```
  virtual-connection delete vca <vca-name>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <vca-name> | <string> Unique name associated to the VCA instance. |

## virtual-connection delete vca-vlan

virtual-connection delete vca-vlan - Delete a VCA-VLAN instance

**Description:** Used to delete a VCA-VLAN object.

**Syntax:**

```
  virtual-connection delete vca-vlan <vca-vlan-name>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <vca-vlan-name> | <string> Unique name associated to the VCA-VLAN instance. |

## virtual-connection delete vce

virtual-connection delete vce - Delete an existing VCE

**Description:** Delete an existing VCE.

**Syntax:**

```
  virtual-connection delete vce <vce-name>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <vce-name> | <string> |

## virtual-connection edit vca

virtual-connection edit vca - Edit a VCA instance

**Description:** Used to edit an existing VCA object. The name and the vc-list of an implicit VCA cannot be modified.

Used to add, edit or delete a VCA classification object.

**Syntax:**

```
  virtual-connection edit vca <vca-name> {
          {name <vca-name>} |
          {vc-list <vc-name>+} }+

  <vca-name>       = <string>
  <vc-name>        = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| name | Unique name associated to the VCA instance. |
| vc-list | A comma-separated list of VCE instances or VCA containing a VCE tunnel referenced by name. |

## virtual-connection edit vca/vca-vlan <name> bandwidth-regulator add/edit

virtual-connection edit vca bandwidth-regulator add - Add a bandwidth regulator configuration virtual-connection edit vca bandwidth-regulator edit - Change a bandwidth regulator configuration virtual-connection edit vca-vlan bandwidth-regulator add - Add a bandwidth regulator configuration virtual-connection edit vca-vlan bandwidth-regulator edit - Change a bandwidth regulator configuration

**Description:** You can create a new bandwidth regulator instance or you can change the parameters of an existing bandwidth regulator instance.

The burst size must be greater than the port Maximum Transfer Unit (MTU).

**Syntax:**

```
  virtual-connection edit <vca|vca-vlan> <vca-name> bandwidth-regulator add
          <regulator-name> {
                  {name <regulator-name>} |
                  {cir <0 to max-port-speed>} |
                  {cbs <0-2047>} |
                  {eir <0 to max-port-speed>} |
                  {ebs <0-2047>} |
                  {color-mode {aware | blind}} |
                  {coupling-flag {true | false}} |
                  {cir-max <0 to max-port-speed>} |
                  {eir-max <0 to max-port-speed>} }+

  <vca-name>       = <string>
  <regulator-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| name | Specify a new name for the bandwidth regulator instance. |
| cir | Committed Information Rate in kbps. |
| cbs | Committed Burst Size in KiB. |
| eir | Excess Information Rate in kbps. |
| ebs | Excess Burst Size in KiB. |
| color-mode | Determine whether the regulator is color-aware or color-blind. |
| coupling-flag | Determine whether the coupling flag will be used or not for this regulator. |
| cir-max | Maximum Committed Information Rate in kbps. |
| eir-max | Maximum Excess Information Rate in kbps. |

## virtual-connection edit vca/vca-vlan <name> bandwidth-regulator delete

virtual-connection edit vca bandwidth-regulator delete - Delete the specified bandwidth regulator virtual-connection edit vca-vlan bandwidth-regulator delete - Delete the specified bandwidth regulator

**Description:** delete the specified bandwidth regulator instance in a VCA object.

**Syntax:**

```
  virtual-connection edit <vca|vca-vlan> <vca-name> bandwidth-regulator delete
          <regulator-name>

  <vca-name>       = <string>
  <regulator-name> = <string>
```

## virtual-connection edit vca bandwidth regulator envelope edit

virtual-connection edit vca bandwidth-regulator-envelope edit - Edit the bandwidth regulator envelope in a VCA instance virtual-connection edit vca-vlan bandwidth-regulator-envelope edit - Edit the bandwidth regulator envelope in a VCA instance

**Description:** Edit a bandwidth regulator envelope entry in a VCA object.

**Syntax:**

```
  virtual-connection edit <vca|vca-vlan> <vca-name> bandwidth-regulator-envelope
          edit {
                  {direction <AtoZ | ZtoA >} |
                  {envelope <enable | disable>} |
                  {rank <regulator-name list>} |
                  {coupling-flag <true | false>} }+

  <vca-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| direction | Edit the policing attributes for the selected direction. |
| envelope | Enable or disable the MEF 10.3 token sharing between bandwidth regulators. |
| rank | A comma-separated list of regulator names that are part of the envelope in order of priority (highest to lowest). |
| coupling-flag | Determine whether the coupling flag will be used or not for this regulator envelope. |

## virtual-connection edit vca/vca-vlan <name> bandwidth-regulator-envelope edit

virtual-connection edit vca bandwidth-regulator-envelope edit - Edit the bandwidth regulator envelope in a VCA instance virtual-connection edit vca-vlan bandwidth-regulator-envelope edit - Edit the bandwidth regulator envelope in a VCA instance

**Description:** Edit a bandwidth regulator envelope entry in a VCA object.

**Syntax:**

```
  virtual-connection edit <vca|vca-vlan> <vca-name> bandwidth-regulator-envelope
          edit {
                  {direction <AtoZ | ZtoA >} |
                  {envelope <enable | disable>} |
                  {rank <regulator-name list>} |
                  {coupling-flag <true | false>} }+

  <vca-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| direction | Edit the policing attributes for the selected direction. |
| envelope | Enable or disable the MEF 10.3 token sharing between bandwidth regulators. |
| rank | A comma-separated list of regulator names that are part of the envelope in order of priority (highest to lowest). |
| coupling-flag | Determine whether the coupling flag will be used or not for this regulator envelope. |

## virtual-connection edit vca/vca-vlan <name> bandwidth-regulator-set edit

virtual-connection edit vca bandwidth-regulator-set edit - Edit the bandwidth regulator-set per direction in a VCA instance virtual-connection edit vca-vlan bandwidth-regulator-set edit - Edit the bandwidth regulator-set per direction in a VCA instance

**Description:** Edit a bandwidth regulator-set entry in a VCA object.

**Syntax:**

```
  virtual-connection edit <vca|vca-vlan> <vca-name> bandwidth-regulator-set
          edit {
                  {direction <AtoZ | ZtoA >} |
                  {input-list {<0-7> [,|- <0-7>]}+ } |
                  {regulator {<regulator-name> | None} } |
                  {state {disable | enable}} }+

  <vca-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| direction | Edit the policing attributes for the selected direction. |
| input-list | A comma-separated list of PCP values and PCP range (x-y) values. |
| regulator-name | Bandwidth regulator to be used for all packets that have a PCP in input-list. Use None value to remove the bandwidth regulator reference. |
| state | Enable or disable the bandwidth regulator for a PCP input-list. |

## virtual-connection edit vca <name> classification add/edit

virtual-connection edit vca classification add - Add a classification instance to a VCA. virtual-connection edit vca classification edit - Edit a classification instance.

**Description:** Used to add or edit a VCA classification object.

**Syntax:**

```
  virtual-connection edit <vca> <vca-name> classification <add|edit>
      <classification-name> {
          {name <classification-name>} |
          {direction <AtoZ|ZtoA>} |
          {action <drop|permit>} |
          {filter {none | <l2|ipv4|ipv6> <filter-name>}} |
          {dscp-ip-mapping-state <enable|disable>} |
          {pcp-mapping-state <enable|disable>} |
          {cos-mapping-order <DSCP/PCP/Direct|PCP/DSCP/Direct>} |
          {dscp-ip-mapping-profile <profile-name>} |
          {cfi-dei <0-1>} |
          {direct-pcp <0-7>} |
          {use-vca-vlan-filter <enable|disable>} |
          {priority <0-255>} |
          }+

  <vca-name>            = <string>
  <classification-name> = <string>
  <filter-name>         = <string>
  <profile-name>        = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| classification-name | Specify the classification instance to be added, or edited. |
| name | Specify a new name for the classification instance. |
| direction | When adding a classification, specify the direction. |
| action | Drop or not the traffic based on the filter. |
| filter | Specify an associated filter type and name. |
| dscp-ip-mapping-state | Enable or disable DSCP or IP Precedence mapping. |
| pcp-mapping-state | Enable or disable PCP mapping. |
| cos-mapping-order | Determine if the PCP mapping has higher priority than the DSCP/IP Precedence mapping. |
| dscp-ip-mapping-profile | Specify a DSCP or an IP Precedence mapping instance. |
| cfi-dei | Direct or default CFI/DEI bit for outgoing traffic. |
| direct-pcp | Direct or default PCP bits for outgoing traffic. |
| use-vca-vlan-filter | Indicate if the classification should derive the VLAN filter from the VCA definition. |
| priority | Classification priority inside the VCA. The priority is used when creating all the policies of a VCA. Use 0 when the priority is not used. |

## virtual-connection edit vca/vca-vlan <name> classification delete

virtual-connection edit vca classification delete - delete a classification instance. virtual-connection edit vca-vlan classification delete - delete a classification instance.

**Description:** Used to delete a VCA or a VCA-VLAN classification object.

**Syntax:**

```
  virtual-connection edit <vca|vca-vlan> <vca-name> classification delete
      <classification-name>

  <vca-name>            = <string>
  <classification-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vca-name | Name of the VCA instance. |
| classification-name | Specify the classification instance to be deleted. |

## virtual-connection edit vca-vlan <name> classification add/edit

virtual-connection edit vca-vlan classification add - Add a classification instance to a VCA-VLAN. virtual-connection edit vca-vlan classification edit - Edit a classification instance.

**Description:** Used to add or edit a VCA-VLAN classification object.

**Syntax:**

```
  virtual-connection edit <vca-vlan> <vca-vlan-name> classification <add|edit>
      <classification-name> {
          {name <classification-name>} |
          {direction <AtoZ|ZtoA>} |
          {action <drop|permit>} |
          {filter {none | <l2|ipv4|ipv6> <filter-name>}} |
          {dscp-ip-mapping-state <enable|disable>} |
          {pcp-mapping-state <enable|disable>} |
          {cos-mapping-order <DSCP/PCP/Direct|PCP/DSCP/Direct>} |
          {dscp-ip-mapping-profile <profile-name>} |
          {cfi-dei <0-1>} |
          {direct-pcp <0-7>} |
          {use-vca-vlan-filter <enable|disable>} |
          {priority <0-255>} |
          {pre-marking-color <green-yellow>} |
          {green-dei <0-1>} |
          {green-pcp <0-7>} |
          {yellow-dei <0-1>} |
          {yellow-pcp <0-7>} |
          {multi-regulator-state <enable|disable>} |
          {regulator <regulator-name>} |
          }+

  <vca-vlan-name>       = <string>
  <classification-name> = <string>
  <filter-name>         = <string>
  <profile-name>        = <string>
  <regulator-name>      = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| classification-name | Specify the classification instance to be added, or edited. |
| name | Specify a new name for the classification instance. |
| direction | When adding a classification, specify the direction. |
| action | Drop or not the traffic based on the filter. |
| filter | Specify an associated filter type and name. |
| dscp-ip-mapping-state | Enable or disable DSCP or IP Precedence mapping. |
| pcp-mapping-state | Enable or disable PCP mapping. |
| cos-mapping-order | Determine if the PCP mapping has higher priority than the DSCP/IP Precedence mapping. |
| dscp-ip-mapping-profile | Specify a DSCP or an IP Precedence mapping instance. |
| cfi-dei | Direct or default CFI/DEI bit for outgoing traffic. |
| direct-pcp | Direct or default PCP bits for outgoing traffic. |
| use-vca-vlan-filter | Indicate if the classification should derive the VLAN filter from the VCA definition. |
| priority | Classification priority inside the VCA. The priority is used when creating all the policies of a VCA. Use 0 when the priority is not used. |
| pre-marking-color | Direct or default pre-marking color. |
| green-dei | Direct or default CFI/DEI bit for outgoing green traffic. |
| green-pcp | Direct or default PCP bits for outgoing green traffic. |
| yellow-dei | Direct or default CFI/DEI bit for outgoing yellow traffic. |
| yellow-pcp | Direct or default PCP bits for outgoing yellow traffic. |
| multi-regulator-state | Indicate if the classification uses Multi Bandwidth Profile or not. |
| regulator | Bandwidth regulator to be used for all packets that is classified. Use None value to remove the bandwidth regulator reference. |

## virtual-connection show vca/vca-vlan bandwidth-regulator configuration

virtual-connection show vca bandwidth-regulator configuration - Show bandwidth regulator configuration virtual-connection show vca-vlan bandwidth-regulator configuration - Show bandwidth regulator configuration

**Description:** Without arguments this command displays the bandwidth-regulator configuration summary in a table format. When specifying a bandwidth-regulator name, this command displays the detailed configuration for that bandwidth-regulator.

**Syntax:**

```
  virtual-connection show <vca|vca-vlan> bandwidth-regulator configuration
          <vca-name> [<regulator-name>]

  <vca-name>       = <string>
  <regulator-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vca-name | Name of the VCA instance. |
| regulator-name | Name of the regulator instance. |

## virtual-connection show vca/vca-vlan bandwidth-regulator statistics

virtual-connection show vca bandwidth-regulator statistics - Show bandwidth regulator statistics virtual-connection show vca-vlan bandwidth-regulator statistics - Show bandwidth regulator statistics

**Description:** Without arguments, this command displays the bandwidth-regulator statistics summary in a table format. When specifying a bandwidth-regulator name, this command displays the detailed statistics for that bandwidth-regulator.

**Syntax:**

```
  virtual-connection show <vca|vca-vlan> bandwidth-regulator statistics
          <vca-name> [<regulator-name> [ type { continuous |
                      historic { bucket <0-16> } { perioid <period-id > }} ] ]
 
  <vca-name>       = <string>
  <regulator-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vca-name | Name of the VCA instance. |
| regulator-name | Name of the regulator instance. |
| type | Type of statistics to display: - continuous: Current statistics since last clear command. - historic: History buckets statistics. If the number of buckets is not specified, 4 buckets will be displayed, starting from the specified period. - If no period is specified, the last 4 buckets will be displayed. |
| buckets | Number of bandwidth regulator buckets to display. |
| period | Reference period for the bandwidth regulator history buckets. Zero for the most recent period available. |

## virtual-connection show vca/vca-vlan bandwidth-regulator-envelope configuration

virtual-connection show vca bandwidth-regulator-envelope configuration - Show bandwidth regulator envelope configuration virtual-connection show vca-vlan bandwidth-regulator-envelope configuration - Show bandwidth regulator envelope configuration

**Description:** This command displays the bandwidth regulator envelope for a specific VCA or VCA-VLAN.

**Syntax:**

```
  virtual-connection show <vca|vca-vlan> bandwidth-regulator-envelope
          configuration <vca-name> {{direction <AtoZ | ZtoA >}}

  <vca-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vca-name | Name of the VCA instance. |
| direction | Displays the policing attributes for the selected direction. |

## virtual-connection show vca/vca-vlan bandwidth-regulator-set configuration

virtual-connection show vca bandwidth-regulator-set configuration - Show bandwidth regulator set configuration virtual-connection show vca-vlan bandwidth-regulator-set configuration – Show bandwidth regulator set configuration

**Description:** This command displays the list of the bandwidth regulator set for a specific VCA or VCA-VLAN.

**Syntax:**

```
  virtual-connection show <vca|vca-vlan> bandwidth-regulator-set configuration
          <vca-name> {{direction <AtoZ | ZtoA >}}

  <vca-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vca-name | Name of the VCA instance. |
| direction | Displays the policing attributes for the selected direction. |

## virtual-connection show vca/vca-vlan classification configuration

virtual-connection show vca classification configuration - Show vca classification configuration virtual-connection show vca-vlan classification configuration - Show vca-vlan classification configuration

**Description:** Without arguments, this command displays the VCA classification summary in a table format. When specifying a classification name, this command displays the detailed configuration for that classification.

**Syntax:**

```
  virtual-connection show <vca|vca-vlan> classification configuration
          <vca-name> [<classification-name>]

  <vca-name>            = <string>
  <classification-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vca-name | Name of the VCA instance. |
| classification-name | Name of the classification instance. |

## virtual-connection show vca configuration

virtual-connection show vca configuration - Show vca configuration

**Description:** Without arguments, this command displays the VCA configuration summary in a table format. When specifying a VCA name, this command displays the detailed configuration for that VCA.

**Syntax:**

```
  virtual-connection show vca configuration [<vca-name>]
  <vca-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vca-name | Unique name associated to the VCA instance. |

## virtual-connection show vca-vlan configuration

virtual-connection show vca-vlan configuration - Show vca configuration for VCA created with VLAN stack

**Description:** Without arguments, this command displays the VCA configuration summary in a table format. When specifying a VCA name, this command displays the detailed configuration for that VCA.

**Syntax:**

```
  virtual-connection show vca-vlan configuration [<vca-name>]
  <vca-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vca-name | Unique name associated to the VCA instance. |

## virtual-connection show vca-vlan filter

virtual-connection show vca-vlan filter - Show default vlan filter

**Description:** Show default vlan filter for VCA created with VLAN stack

**Syntax:**

```
  virtual-connection show vca-vlan filter
```

## virtual-connection show vce configuration

virtual-connection show vce configuration - Display vce configuration

**Description:** Display the layer 2 or layer 3 vce configuration summary or a vce configuration detail.

**Syntax:**

```
  virtual-connection show vce configuration layer-2
  virtual-connection show vce configuration layer-3
  virtual-connection show vce configuration <vce-name>
  <vce-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vce-name | Name of the VCE instance. |

## virtual-connection show vce statistics

virtual-connection show vce statistics - Display VCE statistics

**Description:** Display the vce statistics summary or a vce statistics detail.

**Syntax:**

```
  virtual-connection show vce statistics [<vce-name>]
  <vce-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| vce-name | Name of the VCE instance. |

**© 2026 Cisco and/or its affiliates. All rights reserved.** For more information about trademarks, please visit: [Cisco trademarks](https://www.cisco.com/c/en/us/about/legal/trademarks.html)[](https://www.cisco.com/c/en/us/about/legal/trademarks.html) For more information about legal terms, please visit: [Cisco legal terms](https://www.cisco.com/c/en/us/about/legal/terms-conditions.html)