STARTBGPFAILOVERTEST()`¶

About StartBgpFailoverTest¶

Starts the virtual interface failover test that verifies your configuration meets your resiliency requirements by placing the BGP peering session in the DOWN state. You can then send traffic to verify that there are no outages.

You can run the test on public, private, transit, and hosted virtual interfaces.

You can use ListVirtualInterfaceTestHistory to view the virtual interface test history.

If you need to stop the test before the test interval completes, use StopBgpFailoverTest.

Method Signature¶

METHODS /AWS1/IF_DCO~STARTBGPFAILOVERTEST
  IMPORTING
    !IV_VIRTUALINTERFACEID TYPE /AWS1/DCOVIRTUALINTERFACEID OPTIONAL
    !IT_BGPPEERS TYPE /AWS1/CL_DCOBGPPEERIDLIST_W=>TT_BGPPEERIDLIST OPTIONAL
    !IV_TESTDURATIONINMINUTES TYPE /AWS1/DCOTESTDURATION OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_dcostrtbgpfailovert01
  RAISING
    /AWS1/CX_DCODIRECTCNCTCLIENTEX
    /AWS1/CX_DCODIRECTCNCTSERVEREX
    /AWS1/CX_DCOCLIENTEXC
    /AWS1/CX_DCOSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_virtualinterfaceid` `TYPE /AWS1/DCOVIRTUALINTERFACEID` `/AWS1/DCOVIRTUALINTERFACEID`¶

The ID of the virtual interface you want to test.

Optional arguments:¶

`it_bgppeers` `TYPE /AWS1/CL_DCOBGPPEERIDLIST_W=>TT_BGPPEERIDLIST` `TT_BGPPEERIDLIST`¶

The BGP peers to place in the DOWN state.

`iv_testdurationinminutes` `TYPE /AWS1/DCOTESTDURATION` `/AWS1/DCOTESTDURATION`¶

The time in minutes that the virtual interface failover test will last.

Maximum value: 4,320 minutes (72 hours).

Default: 180 minutes (3 hours).

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_dcostrtbgpfailovert01` `/AWS1/CL_DCOSTRTBGPFAILOVERT01`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->startbgpfailovertest(
  it_bgppeers = VALUE /aws1/cl_dcobgppeeridlist_w=>tt_bgppeeridlist(
    ( new /aws1/cl_dcobgppeeridlist_w( |string| ) )
  )
  iv_testdurationinminutes = 123
  iv_virtualinterfaceid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_virtualinterfacetesthis = lo_result->get_virtualinterfacetest( ).
  IF lo_virtualinterfacetesthis IS NOT INITIAL.
    lv_testid = lo_virtualinterfacetesthis->get_testid( ).
    lv_virtualinterfaceid = lo_virtualinterfacetesthis->get_virtualinterfaceid( ).
    LOOP AT lo_virtualinterfacetesthis->get_bgppeers( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_bgppeerid = lo_row_1->get_value( ).
      ENDIF.
    ENDLOOP.
    lv_failuretesthistorystatu = lo_virtualinterfacetesthis->get_status( ).
    lv_owneraccount = lo_virtualinterfacetesthis->get_owneraccount( ).
    lv_testduration = lo_virtualinterfacetesthis->get_testdurationinminutes( ).
    lv_starttime = lo_virtualinterfacetesthis->get_starttime( ).
    lv_endtime = lo_virtualinterfacetesthis->get_endtime( ).
  ENDIF.
ENDIF.

/AWS1/IF_DCO=>STARTBGPFAILOVERTEST()¶