Skip to content

/AWS1/IF_ORG=>INVITEORGTOXFERRESPONSIBIL00()

About InviteOrganizationToTransferResponsibility

Sends an invitation to another organization's management account to designate your account with the specified responsibilities for their organization. The invitation is implemented as a Handshake whose details are in the response.

You can only call this operation from the management account.

Method Signature

METHODS /AWS1/IF_ORG~INVITEORGTOXFERRESPONSIBIL00
  IMPORTING
    !IV_TYPE TYPE /AWS1/ORGRESPONSIBILITYXFERT00 OPTIONAL
    !IO_TARGET TYPE REF TO /AWS1/CL_ORGHANDSHAKEPARTY OPTIONAL
    !IV_NOTES TYPE /AWS1/ORGHANDSHAKENOTES OPTIONAL
    !IV_STARTTIMESTAMP TYPE /AWS1/ORGTIMESTAMP OPTIONAL
    !IV_SOURCENAME TYPE /AWS1/ORGRESPONSIBILITYXFERN00 OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_ORGTAG=>TT_TAGS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_orginviteorgtoxferr01
  RAISING
    /AWS1/CX_ORGACCESSDENIEDEX
    /AWS1/CX_ORGAWSORGSNOTINUSEEX
    /AWS1/CX_ORGCONCURRENTMODEX
    /AWS1/CX_ORGCNSTRNTVIOLATIONEX
    /AWS1/CX_ORGDUPLICATEHANDSHA00
    /AWS1/CX_ORGHANDSHAKECNSVIOEX
    /AWS1/CX_ORGINVALIDINPUTEX
    /AWS1/CX_ORGSERVICEEXCEPTION
    /AWS1/CX_ORGTOOMANYREQUESTSEX
    /AWS1/CX_ORGUNSUPPEDAPIENDPTEX
    /AWS1/CX_ORGCLIENTEXC
    /AWS1/CX_ORGSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_type TYPE /AWS1/ORGRESPONSIBILITYXFERT00 /AWS1/ORGRESPONSIBILITYXFERT00

The type of responsibility you want to designate to your organization. Currently, only BILLING is supported.

io_target TYPE REF TO /AWS1/CL_ORGHANDSHAKEPARTY /AWS1/CL_ORGHANDSHAKEPARTY

A HandshakeParty object. Contains details for the account you want to invite. Currently, only ACCOUNT and EMAIL are supported.

iv_starttimestamp TYPE /AWS1/ORGTIMESTAMP /AWS1/ORGTIMESTAMP

Timestamp when the recipient will begin managing the specified responsibilities.

iv_sourcename TYPE /AWS1/ORGRESPONSIBILITYXFERN00 /AWS1/ORGRESPONSIBILITYXFERN00

Name you want to assign to the transfer.

Optional arguments:

iv_notes TYPE /AWS1/ORGHANDSHAKENOTES /AWS1/ORGHANDSHAKENOTES

Additional information that you want to include in the invitation.

it_tags TYPE /AWS1/CL_ORGTAG=>TT_TAGS TT_TAGS

A list of tags that you want to attach to the transfer. For each tag in the list, you must specify both a tag key and a value. You can set the value to an empty string, but you can't set it to null. For more information about tagging, see Tagging Organizations resources in the Organizations User Guide.

Any tags in the request are checked for compliance with any applicable tag policies when the request is made. The request is rejected if the tags in the request don't match the requirements of the policy at that time. Tag policy compliance is not checked again when the invitation is accepted and the tags are actually attached to the transfer. That means that if the tag policy changes between the invitation and the acceptance, then that tags could potentially be non-compliant.

If any one of the tags is not valid or if you exceed the allowed number of tags for a transfer, then the entire request fails and invitations are not sent.

RETURNING

oo_output TYPE REF TO /aws1/cl_orginviteorgtoxferr01 /AWS1/CL_ORGINVITEORGTOXFERR01

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->inviteorgtoxferresponsibil00(
  io_target = new /aws1/cl_orghandshakeparty(
    iv_id = |string|
    iv_type = |string|
  )
  it_tags = VALUE /aws1/cl_orgtag=>tt_tags(
    (
      new /aws1/cl_orgtag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_notes = |string|
  iv_sourcename = |string|
  iv_starttimestamp = '20150101000000.0000000'
  iv_type = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_handshake = lo_result->get_handshake( ).
  IF lo_handshake IS NOT INITIAL.
    lv_handshakeid = lo_handshake->get_id( ).
    lv_handshakearn = lo_handshake->get_arn( ).
    LOOP AT lo_handshake->get_parties( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_handshakepartyid = lo_row_1->get_id( ).
        lv_handshakepartytype = lo_row_1->get_type( ).
      ENDIF.
    ENDLOOP.
    lv_handshakestate = lo_handshake->get_state( ).
    lv_timestamp = lo_handshake->get_requestedtimestamp( ).
    lv_timestamp = lo_handshake->get_expirationtimestamp( ).
    lv_actiontype = lo_handshake->get_action( ).
    LOOP AT lo_handshake->get_resources( ) into lo_row_2.
      lo_row_3 = lo_row_2.
      IF lo_row_3 IS NOT INITIAL.
        lv_handshakeresourcevalue = lo_row_3->get_value( ).
        lv_handshakeresourcetype = lo_row_3->get_type( ).
        LOOP AT lo_row_3->get_resources( ) into lo_row_4.
          lo_row_5 = lo_row_4.
          IF lo_row_5 IS NOT INITIAL.
            lv_handshakeresourcevalue = lo_row_5->get_value( ).
            lv_handshakeresourcetype = lo_row_5->get_type( ).
            " Skipping lo_row_4 to avoid recursion
          ENDIF.
        ENDLOOP.
      ENDIF.
    ENDLOOP.
  ENDIF.
ENDIF.