STARTPRACTICERUN()`¶

About StartPracticeRun¶

Start an on-demand practice run zonal shift in Amazon Application Recovery Controller. With zonal autoshift enabled, you can start an on-demand practice run to verify preparedness at any time. Amazon Web Services also runs automated practice runs about weekly when you have enabled zonal autoshift.

For more information, see Considerations when you configure zonal autoshift in the Amazon Application Recovery Controller Developer Guide.

Method Signature¶

IMPORTING¶

Required arguments:¶

`iv_resourceidentifier` `TYPE /AWS1/AZSRESOURCEIDENTIFIER` `/AWS1/AZSRESOURCEIDENTIFIER`¶

The identifier for the resource that you want to start a practice run zonal shift for. The identifier is the Amazon Resource Name (ARN) for the resource.

`iv_awayfrom` `TYPE /AWS1/AZSAVAILABILITYZONE` `/AWS1/AZSAVAILABILITYZONE`¶

The Availability Zone (for example, use1-az1) that traffic is shifted away from for the resource that you specify for the practice run.

`iv_comment` `TYPE /AWS1/AZSZONALSHIFTCOMMENT` `/AWS1/AZSZONALSHIFTCOMMENT`¶

The initial comment that you enter about the practice run. Be aware that this comment can be overwritten by Amazon Web Services if the automatic check for balanced capacity fails. For more information, see Capacity checks for practice runs in the Amazon Application Recovery Controller Developer Guide.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_azsstrtpracticerunrsp` `/AWS1/CL_AZSSTRTPRACTICERUNRSP`¶

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->/aws1/if_azs~startpracticerun(
  iv_awayfrom = |string|
  iv_comment = |string|
  iv_resourceidentifier = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_zonalshiftid = lo_result->get_zonalshiftid( ).
  lv_resourceidentifier = lo_result->get_resourceidentifier( ).
  lv_availabilityzone = lo_result->get_awayfrom( ).
  lv_expirytime = lo_result->get_expirytime( ).
  lv_starttime = lo_result->get_starttime( ).
  lv_zonalshiftstatus = lo_result->get_status( ).
  lv_zonalshiftcomment = lo_result->get_comment( ).
ENDIF.

/AWS1/IF_AZS=>STARTPRACTICERUN()¶