ASSOCIATEACCOUNTS()`¶

About AssociateAccounts¶

Associates one or more member accounts with your organization's management account, enabling centralized implementation of optimization actions across those accounts. Once associated, the management account (or a delegated administrator) can apply recommended actions to the member account. When you associate a member account, its organization rule mode is automatically set to "Any allowed," which permits the management account to create Automation rules that automatically apply actions to that account. If the member account has not previously enabled the Automation feature, the association process automatically enables it.

Only the management account or a delegated administrator can perform this action.

Method Signature¶

METHODS /AWS1/IF_COA~ASSOCIATEACCOUNTS
  IMPORTING
    !IT_ACCOUNTIDS TYPE /AWS1/CL_COAACCOUNTIDLIST_W=>TT_ACCOUNTIDLIST OPTIONAL
    !IV_CLIENTTOKEN TYPE /AWS1/COACLIENTTOKEN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_coaassocacctsresponse
  RAISING
    /AWS1/CX_COAACCESSDENIEDEX
    /AWS1/CX_COAFORBIDDENEXCEPTION
    /AWS1/CX_COAIDEMTOKENINUSEEX
    /AWS1/CX_COAIDEMPARAMMMEX
    /AWS1/CX_COAINTERNALSERVEREX
    /AWS1/CX_COAINVPARAMVALUEEX
    /AWS1/CX_COANOTMNGMTACCOUNTEX
    /AWS1/CX_COAOPTINREQUIREDEX
    /AWS1/CX_COASERVICEUNAVAILEX
    /AWS1/CX_COATHROTTLINGEX
    /AWS1/CX_COACLIENTEXC
    /AWS1/CX_COASERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`it_accountids` `TYPE /AWS1/CL_COAACCOUNTIDLIST_W=>TT_ACCOUNTIDLIST` `TT_ACCOUNTIDLIST`¶

The IDs of the member accounts to associate. You can specify up to 50 account IDs.

Optional arguments:¶

`iv_clienttoken` `TYPE /AWS1/COACLIENTTOKEN` `/AWS1/COACLIENTTOKEN`¶

A unique identifier to ensure idempotency of the request. Valid for 24 hours after creation.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_coaassocacctsresponse` `/AWS1/CL_COAASSOCACCTSRESPONSE`¶

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->associateaccounts(
  it_accountids = VALUE /aws1/cl_coaaccountidlist_w=>tt_accountidlist(
    ( new /aws1/cl_coaaccountidlist_w( |string| ) )
  )
  iv_clienttoken = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_accountids( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_accountid = lo_row_1->get_value( ).
    ENDIF.
  ENDLOOP.
  LOOP AT lo_result->get_errors( ) into lo_row_2.
    lo_row_3 = lo_row_2.
    IF lo_row_3 IS NOT INITIAL.
      lv_string = lo_row_3->get_value( ).
    ENDIF.
  ENDLOOP.
ENDIF.

/AWS1/IF_COA=>ASSOCIATEACCOUNTS()¶