.. _overlay_tunnel: overlay-tunnel ============== Configure a Tunnel end point overlay-tunnel Specification ---------------------------- ===================================== ======================================================= ===================================== ======================================================= **Type** *Intermediate Resource* **Element Name** overlay-tunnel **Element URI** /axapi/v3/overlay-tunnel **Element Attributes** overlay-tunnel_attributes **Schema** :download:`overlay-tunnel schema ` ===================================== ======================================================= **Operations Allowed:** .. raw:: html .. raw:: html .. raw:: html .. raw:: html
OperationMethodURIPayload
Get Object .. raw:: html GET .. raw:: html /axapi/v3/overlay-tunnel .. raw:: html overlay-tunnel_attributes .. raw:: html
.. _1172_overlay-tunnel_attributes: overlay-tunnel attributes ------------------------- **options** **Description:** options is a **JSON Block**. Please see below for :ref:`1172_options` **Type:** Object **Reference Object:** :doc:`/axapi/v3/overlay-tunnel/options ` **vtep-list** **Type:** List **Reference Object:** :doc:`/axapi/v3/overlay-tunnel/vtep/{id} ` .. _1172_options: options ^^^^^^^ =============================== =================================================== **Specification** =============================== =================================================== **Type** *object* =============================== =================================================== **fragmentation-mode-inner** **Description** Enable the inner-fragmentation **Type:** boolean **Supported Values:** true, false, 1, 0 **Default:** 0 **gateway-mac** **Description** MAC to be used with Gateway segment Id (MAC Address for the Gateway segment) **Type:** string **Format:** mac-address **ip-dscp-preserve** **Description** Copy DSCP bits from inner IP to outer IP header **Type:** boolean **Supported Values:** true, false, 1, 0 **Default:** 0 **nvgre-disable-flow-id** **Description** Disable Flow-ID computation for NVGRE **Type:** boolean **Supported Values:** true, false, 1, 0 **Default:** 0 **nvgre-key-mode-lower24** **Description** Use the lower 24-bits of the GRE key as the VSID **Type:** boolean **Supported Values:** true, false, 1, 0 **Default:** 0 **tcp-mss-adjust-disable** **Description** Disable TCP MSS adjustment in SYN packet for tunnels **Type:** boolean **Supported Values:** true, false, 1, 0 **Default:** 0 **uuid** **Description** uuid of the object **Type:** string **Maximum Length:** 64 characters **Maximum Length:** 1 characters **vxlan-dest-port** **Description** VXLAN UDP Destination Port (UDP Port Number (default 4789)) **Type:** number **Range:** 1-65535 .. _1172_vtep-list: vtep-list ^^^^^^^^^ =============================== =================================================== **Specification** =============================== =================================================== **Type** *list* **Block object keys** =============================== =================================================== **destination-ip-address-list** **Type:** List **Reference Object:** :doc:`/axapi/v3/overlay-tunnel/vtep/{id}/destination-ip-address/{ip-address} ` **encap** **Description** 'nvgre': Tunnel Encapsulation Type is NVGRE; 'vxlan': Tunnel Encapsulation Type is VXLAN; **Type:** string **Supported Values:** nvgre, vxlan **Default:** vxlan **host-list** **Type:** List **Reference Object:** :doc:`/axapi/v3/overlay-tunnel/vtep/{id}/host/{ip-addr}+{overlay-mac-addr}+{vni}+{destination-vtep} ` **id** **Description** VTEP Identifier **Type:** number **Range:** 1-64 **sampling-enable** **Type:** List **source-ip-address** **Description:** source-ip-address is a **JSON Block**. Please see below for :ref:`1172_vtep-list_source-ip-address` **Type:** Object **Reference Object:** :doc:`/axapi/v3/overlay-tunnel/vtep/{id}/source-ip-address ` **user-tag** **Description** Customized tag **Type:** string **Format:** string-rlx **Maximum Length:** 127 characters **Maximum Length:** 1 characters **uuid** **Description** uuid of the object **Type:** string **Maximum Length:** 64 characters **Maximum Length:** 1 characters .. _1172_vtep-list_sampling-enable: vtep-list_sampling-enable ^^^^^^^^^^^^^^^^^^^^^^^^^ =============================== =================================================== **Specification** =============================== =================================================== **Type** *list* **Block object keys** =============================== =================================================== **counters1** **Description** 'all': all; 'cfg_err_count': Config errors; 'flooded_pkt_count': Flooded packet count; 'encap_unresolved_count': Encap unresolved failures; 'unknown_encap_rx_pkt': Encap miss rx pkts; 'unknown_encap_tx_pkt': Encap miss tx pkts; 'arp_req_sent': Arp request sent; 'vtep_host_learned': Hosts learned; 'vtep_host_learn_error': Host learn error; 'invalid_lif_rx': Invalid Lif pkts in; 'invalid_lif_tx': Invalid Lif pkts out; 'unknown_vtep_tx': Vtep unknown tx; 'unknown_vtep_rx': Vtep Unkown rx; 'unhandled_pkt_rx': Unhandled packets in; 'unhandled_pkt_tx': Unhandled packets out; 'total_pkts_rx': Total packets out; 'total_bytes_rx': Total packet bytes in; 'unicast_pkt_rx': Total unicast packets in; 'bcast_pkt_rx': Total broadcast packets in; 'mcast_pkt_rx': Total multicast packets in; 'dropped_pkt_rx': Dropped received packets; 'encap_miss_pkts_rx': Encap missed in received packets; 'bad_chksum_pks_rx': Bad checksum in received packets; 'requeue_pkts_in': Requeued packets in; 'pkts_out': Packets out; 'total_bytes_tx': Packet bytes out; 'unicast_pkt_tx': Unicast packets out; 'bcast_pkt_tx': Broadcast packets out; 'mcast_pkt_tx': Multicast packets out; 'dropped_pkts_tx': Dropped packets out; 'large_pkts_rx': Too large packets in; 'dot1q_pkts_rx': Dot1q packets in; 'frag_pkts_tx': Frag packets out; 'reassembled_pkts_rx': Reassembled packets in; 'bad_inner_ipv4_len_rx': bad inner ipv4 packet len; 'bad_inner_ipv6_len_rx': Bad inner ipv6 packet len; 'lif_un_init_rx': Lif uninitialized packets in; **Type:** string **Supported Values:** all, cfg_err_count, flooded_pkt_count, encap_unresolved_count, unknown_encap_rx_pkt, unknown_encap_tx_pkt, arp_req_sent, vtep_host_learned, vtep_host_learn_error, invalid_lif_rx, invalid_lif_tx, unknown_vtep_tx, unknown_vtep_rx, unhandled_pkt_rx, unhandled_pkt_tx, total_pkts_rx, total_bytes_rx, unicast_pkt_rx, bcast_pkt_rx, mcast_pkt_rx, dropped_pkt_rx, encap_miss_pkts_rx, bad_chksum_pks_rx, requeue_pkts_in, pkts_out, total_bytes_tx, unicast_pkt_tx, bcast_pkt_tx, mcast_pkt_tx, dropped_pkts_tx, large_pkts_rx, dot1q_pkts_rx, frag_pkts_tx, reassembled_pkts_rx, bad_inner_ipv4_len_rx, bad_inner_ipv6_len_rx, lif_un_init_rx .. _1172_vtep-list_source-ip-address: vtep-list_source-ip-address ^^^^^^^^^^^^^^^^^^^^^^^^^^^ =============================== =================================================== **Specification** =============================== =================================================== **Type** *object* =============================== =================================================== **ip-address** **Description** Source Tunnel End Point IPv4 address **Type:** string **Format:** ipv4-address **uuid** **Description** uuid of the object **Type:** string **Maximum Length:** 64 characters **Maximum Length:** 1 characters **vni-list** **Type:** List **Reference Object:** :doc:`/axapi/v3/overlay-tunnel/vtep/{id}/source-ip-address/vni/{segment} ` .. _1172_vtep-list_source-ip-address_vni-list: vtep-list_source-ip-address_vni-list ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ =============================== =================================================== **Specification** =============================== =================================================== **Type** *list* **Block object keys** =============================== =================================================== **gateway** **Description** This is a Gateway segment id **Type:** boolean **Supported Values:** true, false, 1, 0 **Default:** 0 **lif** **Description** Logical interface binding the Provider Partition to the User Partition (logical interface number) **Type:** number **Range:** 1-128 **partition** **Description** Name of the Partition with the L2 segment being extended (Name of the User Partition with the L2 segment being extended) **Type:** string **Maximum Length:** 127 characters **Maximum Length:** 1 characters **Reference Object:** :doc:`/axapi/v3/partition ` **segment** **Description** Id of the segment that is being extended **Type:** number **Range:** 1-16777215 **uuid** **Description** uuid of the object **Type:** string **Maximum Length:** 64 characters **Maximum Length:** 1 characters .. _1172_vtep-list_host-list: vtep-list_host-list ^^^^^^^^^^^^^^^^^^^ =============================== =================================================== **Specification** =============================== =================================================== **Type** *list* **Block object keys** =============================== =================================================== **destination-vtep** **Description** Configure the VTEP IP address (IPv4 address of the VTEP for the remote host) **Type:** string **Format:** ipv4-address **ip-addr** **Description** IPv4 address of the overlay host **Type:** string **Format:** ipv4-address **overlay-mac-addr** **Description** MAC Address of the overlay host **Type:** string **Format:** mac-address **uuid** **Description** uuid of the object **Type:** string **Maximum Length:** 64 characters **Maximum Length:** 1 characters **vni** **Description** Configure the segment id ( VNI of the remote host) **Type:** number **Range:** 1-16777215 .. _1172_vtep-list_destination-ip-address-list: vtep-list_destination-ip-address-list ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ =============================== =================================================== **Specification** =============================== =================================================== **Type** *list* **Block object keys** =============================== =================================================== **encap** **Description** 'nvgre': Tunnel Encapsulation Type is NVGRE; 'vxlan': Tunnel Encapsulation Type is VXLAN; **Type:** string **Supported Values:** nvgre, vxlan **ip-address** **Description** IP Address of the remote VTEP **Type:** string **Format:** ipv4-address **user-tag** **Description** Customized tag **Type:** string **Format:** string-rlx **Maximum Length:** 127 characters **Maximum Length:** 1 characters **uuid** **Description** uuid of the object **Type:** string **Maximum Length:** 64 characters **Maximum Length:** 1 characters **vni-list** **Type:** List **Reference Object:** :doc:`/axapi/v3/overlay-tunnel/vtep/{id}/destination-ip-address/{ip-address}/vni/{segment} ` .. _1172_vtep-list_destination-ip-address-list_vni-list: vtep-list_destination-ip-address-list_vni-list ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ =============================== =================================================== **Specification** =============================== =================================================== **Type** *list* **Block object keys** =============================== =================================================== **segment** **Description** VNI configured for the remote VTEP **Type:** number **Range:** 1-16777215 **uuid** **Description** uuid of the object **Type:** string **Maximum Length:** 64 characters **Maximum Length:** 1 characters