Skip to content

/AWS1/CL_DSR=>UPDATEHYBRIDAD()

About UpdateHybridAD

Updates the configuration of an existing hybrid directory. You can recover hybrid directory administrator account or modify self-managed instance settings.

Updates are applied asynchronously. Use DescribeHybridADUpdate to monitor the progress of configuration changes.

The InstanceIds must have a one-to-one correspondence with CustomerDnsIps, meaning that if the IP address for instance i-10243410 is 10.24.34.100 and the IP address for instance i-10243420 is 10.24.34.200, then the input arrays must maintain the same order relationship, either [10.24.34.100, 10.24.34.200] paired with [i-10243410, i-10243420] or [10.24.34.200, 10.24.34.100] paired with [i-10243420, i-10243410].

You must provide at least one update to UpdateHybridADRequest$HybridAdministratorAccountUpdate or UpdateHybridADRequest$SelfManagedInstancesSettings.

Method Signature

IMPORTING

Required arguments:

iv_directoryid TYPE /AWS1/DSRDIRECTORYID /AWS1/DSRDIRECTORYID

The identifier of the hybrid directory to update.

Optional arguments:

io_hybridadministratoracct00 TYPE REF TO /AWS1/CL_DSRHYBRIDADMINISTRA00 /AWS1/CL_DSRHYBRIDADMINISTRA00

We create a hybrid directory administrator account when we create a hybrid directory. Use HybridAdministratorAccountUpdate to recover the hybrid directory administrator account if you have deleted it.

To recover your hybrid directory administrator account, we need temporary access to a user in your self-managed AD with administrator permissions in the form of a secret from Amazon Web Services Secrets Manager. We use these credentials once during recovery and don't store them.

If your hybrid directory administrator account exists, then you don’t need to use HybridAdministratorAccountUpdate, even if you have updated your self-managed AD administrator user.

io_selfmanagedinstssettings TYPE REF TO /AWS1/CL_DSRHYBRIDCUSINSTSSTGS /AWS1/CL_DSRHYBRIDCUSINSTSSTGS

Updates to the self-managed AD configuration, including DNS server IP addresses and Amazon Web Services System Manager managed node identifiers.

RETURNING

oo_output TYPE REF TO /aws1/cl_dsrupdatehybridadrslt /AWS1/CL_DSRUPDATEHYBRIDADRSLT

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_dsr~updatehybridad(
  io_hybridadministratoracct00 = new /aws1/cl_dsrhybridadministra00( |string| )
  io_selfmanagedinstssettings = new /aws1/cl_dsrhybridcusinstsstgs(
    it_customerdnsips = VALUE /aws1/cl_dsrcustomerdnsips_w=>tt_customerdnsips(
      ( new /aws1/cl_dsrcustomerdnsips_w( |string| ) )
    )
    it_instanceids = VALUE /aws1/cl_dsrassessmentinstid00=>tt_assessmentinstanceids(
      ( new /aws1/cl_dsrassessmentinstid00( |string| ) )
    )
  )
  iv_directoryid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_directoryid = lo_result->get_directoryid( ).
  lv_assessmentid = lo_result->get_assessmentid( ).
ENDIF.