Skip to content

/AWS1/CL_DSR=>CREATEHYBRIDAD()

About CreateHybridAD

Creates a hybrid directory that connects your self-managed Active Directory (AD) infrastructure and Amazon Web Services.

You must have a successful directory assessment using StartADAssessment to validate your environment compatibility before you use this operation.

Updates are applied asynchronously. Use DescribeDirectories to monitor the progress of directory creation.

Method Signature

IMPORTING

Required arguments:

iv_secretarn TYPE /AWS1/DSRSECRETARN /AWS1/DSRSECRETARN

The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret that contains the credentials for the service account used to join hybrid domain controllers to your self-managed AD domain. This secret is used once and not stored.

The secret must contain key-value pairs with keys matching customerAdAdminDomainUsername and customerAdAdminDomainPassword. For example: {"customerAdAdminDomainUsername":"carlos_salazar","customerAdAdminDomainPassword":"ExamplePassword123!"}.

iv_assessmentid TYPE /AWS1/DSRASSESSMENTID /AWS1/DSRASSESSMENTID

The unique identifier of the successful directory assessment that validates your self-managed AD environment. You must have a successful directory assessment before you create a hybrid directory.

Optional arguments:

it_tags TYPE /AWS1/CL_DSRTAG=>TT_TAGS TT_TAGS

The tags to be assigned to the directory. Each tag consists of a key and value pair. You can specify multiple tags as a list.

RETURNING

oo_output TYPE REF TO /aws1/cl_dsrcreatehybridadrslt /AWS1/CL_DSRCREATEHYBRIDADRSLT

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~createhybridad(
  it_tags = VALUE /aws1/cl_dsrtag=>tt_tags(
    (
      new /aws1/cl_dsrtag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_assessmentid = |string|
  iv_secretarn = |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( ).
ENDIF.