Cisco APIC Layer 3 Networking Configuration Guide, Release 6.2(x)

SR-MPLS Handoff

Updated: April 17, 2026

Describes segment routing Multiprotocol Label Switching (SR-MPLS) handoff between Cisco ACI border leaf switches and provider-edge routers, including configuration, migration, QoS, and verification.

Beginning with Release 5.0(1), segment routing (SR) Multiprotocol Label Switching (MPLS) handoff on the Cisco ACI border leaf switches is available as a new feature.

Note

Procedures in this document describe how to configure SR-MPLS handoff using the GUI and REST API. You cannot configure SR-MPLS handoff through the NX-OS style CLI at this time.

ACI handoffs

Describes how ACI handoffs are handled across different Cisco APIC releases.

Understanding ACI implementation of SR-MPLS handoff

Describes how ACI implements SR-MPLS handoff functionality using specific ACI components that were introduced in Cisco APIC Release 5.0(1).

Describes the ACI implementation configuration model for SR-MPLS handoff within infra and user tenants. This model facilitates connectivity between the ACI fabric and external devices while enabling policy enforcement.

Guidelines and limitations for SR-MPLS

Lists the guidelines and limitations for the SR-MPLS handoff feature across supported platforms, configurations, and operational considerations.

Create a SR-MPLS TTL Policy using the GUI

Creates an SR-MPLS TTL Policy using the GUI to allow user-defined TTL values for SR-MPLS header configuration. This enables flexible policy management and association with SR-MPLS L3Out Node Profiles.

Configure an SR-MPLS infra L3Out using the GUI

Configure an SR-MPLS infrastructure L3Out to enable segment routing MPLS connectivity between ACI border leaf switches and external data center provider edge routers.

Associate the Logical Node Profile with a SR-MPLS TTL Policy

Associates the Logical Node Profile with the SR-MPLS TTL Policy so that the MPLS TTL value for SR-MPLS traffic follows the configured policy. This enables flexible TTL configuration instead of using the default hard-coded value.

Configure an SR-MPLS VRF L3Out using the GUI

Configure an SR-MPLS VRF L3Out to forward traffic from the SR-MPLS infra L3Out and enable communication between tenant VRFs and external networks.

Create SR-MPLS custom QoS policy using the GUI

Configure an SR-MPLS Custom QoS policy to define packet priority based on MPLS EXP values and mark CoS and MPLS EXP values for traffic leaving the ACI fabric.

Display MPLS statistics

Lists the MPLS-specific statistics that you can display at the interface and VRF levels in the system.

Configure SR-MPLS global block (GB)

Configure SR-MPLS global block (GB) if you have an SR network between the border leaf switch in the ACI fabric and the DC-PE.

IP to SR handoff configuration migration

Explains the process of transitioning previously-configured L3Outs from IP handoff configurations to SR handoff configurations using SR-MPLS components.

BGP Domain-Path feature for loop prevention

Describes a BGP mechanism that prevents routing loops by tracking routing domains traversed by routes and blocking routes that would create loops.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.