Skip to content

/AWS1/IF_SAG=>CREATEAGENTSPACE()

About CreateAgentSpace

Creates a new agent space. An agent space is a dedicated workspace for securing a specific application.

Method Signature

METHODS /AWS1/IF_SAG~CREATEAGENTSPACE
  IMPORTING
    !IV_NAME TYPE /AWS1/SAGAGENTNAME OPTIONAL
    !IV_DESCRIPTION TYPE /AWS1/SAGSTRING OPTIONAL
    !IO_AWSRESOURCES TYPE REF TO /AWS1/CL_SAGAWSRESOURCES OPTIONAL
    !IT_TARGETDOMAINIDS TYPE /AWS1/CL_SAGTGTDOMAINIDLIST_W=>TT_TARGETDOMAINIDLIST OPTIONAL
    !IO_CODEREVIEWSETTINGS TYPE REF TO /AWS1/CL_SAGCODEREVIEWSETTINGS OPTIONAL
    !IV_KMSKEYID TYPE /AWS1/SAGKMSKEYID OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_SAGTAGMAP_W=>TT_TAGMAP OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_sagcreagentspaceout
  RAISING
    /AWS1/CX_SAGCLIENTEXC
    /AWS1/CX_SAGSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_name TYPE /AWS1/SAGAGENTNAME /AWS1/SAGAGENTNAME

The name of the agent space.

Optional arguments:

iv_description TYPE /AWS1/SAGSTRING /AWS1/SAGSTRING

A description of the agent space.

io_awsresources TYPE REF TO /AWS1/CL_SAGAWSRESOURCES /AWS1/CL_SAGAWSRESOURCES

The AWS resources to associate with the agent space.

it_targetdomainids TYPE /AWS1/CL_SAGTGTDOMAINIDLIST_W=>TT_TARGETDOMAINIDLIST TT_TARGETDOMAINIDLIST

The list of target domain identifiers to associate with the agent space.

io_codereviewsettings TYPE REF TO /AWS1/CL_SAGCODEREVIEWSETTINGS /AWS1/CL_SAGCODEREVIEWSETTINGS

The code review settings for the agent space.

iv_kmskeyid TYPE /AWS1/SAGKMSKEYID /AWS1/SAGKMSKEYID

The identifier of the AWS KMS key to use for encrypting data in the agent space.

it_tags TYPE /AWS1/CL_SAGTAGMAP_W=>TT_TAGMAP TT_TAGMAP

The tags to associate with the agent space.

RETURNING

oo_output TYPE REF TO /aws1/cl_sagcreagentspaceout /AWS1/CL_SAGCREAGENTSPACEOUT

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->createagentspace(
  io_awsresources = new /aws1/cl_sagawsresources(
    it_iamroles = VALUE /aws1/cl_sagiamroles_w=>tt_iamroles(
      ( new /aws1/cl_sagiamroles_w( |string| ) )
    )
    it_lambdafunctionarns = VALUE /aws1/cl_saglambdafuncarns_w=>tt_lambdafunctionarns(
      ( new /aws1/cl_saglambdafuncarns_w( |string| ) )
    )
    it_loggroups = VALUE /aws1/cl_sagloggrouparns_w=>tt_loggrouparns(
      ( new /aws1/cl_sagloggrouparns_w( |string| ) )
    )
    it_s3buckets = VALUE /aws1/cl_sags3bucketarns_w=>tt_s3bucketarns(
      ( new /aws1/cl_sags3bucketarns_w( |string| ) )
    )
    it_secretarns = VALUE /aws1/cl_sagsecretarns_w=>tt_secretarns(
      ( new /aws1/cl_sagsecretarns_w( |string| ) )
    )
    it_vpcs = VALUE /aws1/cl_sagvpcconfig=>tt_vpcconfigs(
      (
        new /aws1/cl_sagvpcconfig(
          it_securitygrouparns = VALUE /aws1/cl_sagsecgrouparns_w=>tt_securitygrouparns(
            ( new /aws1/cl_sagsecgrouparns_w( |string| ) )
          )
          it_subnetarns = VALUE /aws1/cl_sagsubnetarns_w=>tt_subnetarns(
            ( new /aws1/cl_sagsubnetarns_w( |string| ) )
          )
          iv_vpcarn = |string|
        )
      )
    )
  )
  io_codereviewsettings = new /aws1/cl_sagcodereviewsettings(
    iv_controlsscanning = ABAP_TRUE
    iv_generalpurposescanning = ABAP_TRUE
  )
  it_tags = VALUE /aws1/cl_sagtagmap_w=>tt_tagmap(
    (
      VALUE /aws1/cl_sagtagmap_w=>ts_tagmap_maprow(
        key = |string|
        value = new /aws1/cl_sagtagmap_w( |string| )
      )
    )
  )
  it_targetdomainids = VALUE /aws1/cl_sagtgtdomainidlist_w=>tt_targetdomainidlist(
    ( new /aws1/cl_sagtgtdomainidlist_w( |string| ) )
  )
  iv_description = |string|
  iv_kmskeyid = |string|
  iv_name = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_agentspaceid = lo_result->get_agentspaceid( ).
  lv_agentname = lo_result->get_name( ).
  lv_string = lo_result->get_description( ).
  lo_awsresources = lo_result->get_awsresources( ).
  IF lo_awsresources IS NOT INITIAL.
    LOOP AT lo_awsresources->get_vpcs( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_vpcarn = lo_row_1->get_vpcarn( ).
        LOOP AT lo_row_1->get_securitygrouparns( ) into lo_row_2.
          lo_row_3 = lo_row_2.
          IF lo_row_3 IS NOT INITIAL.
            lv_securitygrouparn = lo_row_3->get_value( ).
          ENDIF.
        ENDLOOP.
        LOOP AT lo_row_1->get_subnetarns( ) into lo_row_4.
          lo_row_5 = lo_row_4.
          IF lo_row_5 IS NOT INITIAL.
            lv_subnetarn = lo_row_5->get_value( ).
          ENDIF.
        ENDLOOP.
      ENDIF.
    ENDLOOP.
    LOOP AT lo_awsresources->get_loggroups( ) into lo_row_6.
      lo_row_7 = lo_row_6.
      IF lo_row_7 IS NOT INITIAL.
        lv_loggrouparn = lo_row_7->get_value( ).
      ENDIF.
    ENDLOOP.
    LOOP AT lo_awsresources->get_s3buckets( ) into lo_row_8.
      lo_row_9 = lo_row_8.
      IF lo_row_9 IS NOT INITIAL.
        lv_s3bucketarn = lo_row_9->get_value( ).
      ENDIF.
    ENDLOOP.
    LOOP AT lo_awsresources->get_secretarns( ) into lo_row_10.
      lo_row_11 = lo_row_10.
      IF lo_row_11 IS NOT INITIAL.
        lv_secretarn = lo_row_11->get_value( ).
      ENDIF.
    ENDLOOP.
    LOOP AT lo_awsresources->get_lambdafunctionarns( ) into lo_row_12.
      lo_row_13 = lo_row_12.
      IF lo_row_13 IS NOT INITIAL.
        lv_lambdafunctionarn = lo_row_13->get_value( ).
      ENDIF.
    ENDLOOP.
    LOOP AT lo_awsresources->get_iamroles( ) into lo_row_14.
      lo_row_15 = lo_row_14.
      IF lo_row_15 IS NOT INITIAL.
        lv_servicerole = lo_row_15->get_value( ).
      ENDIF.
    ENDLOOP.
  ENDIF.
  LOOP AT lo_result->get_targetdomainids( ) into lo_row_16.
    lo_row_17 = lo_row_16.
    IF lo_row_17 IS NOT INITIAL.
      lv_string = lo_row_17->get_value( ).
    ENDIF.
  ENDLOOP.
  lo_codereviewsettings = lo_result->get_codereviewsettings( ).
  IF lo_codereviewsettings IS NOT INITIAL.
    lv_boolean = lo_codereviewsettings->get_controlsscanning( ).
    lv_boolean = lo_codereviewsettings->get_generalpurposescanning( ).
  ENDIF.
  lv_kmskeyid = lo_result->get_kmskeyid( ).
  lv_timestamp = lo_result->get_createdat( ).
  lv_timestamp = lo_result->get_updatedat( ).
ENDIF.