Skip to content

/AWS1/IF_BDO=>CREATEAGENTRUNTIME()

About CreateAgentRuntime

Creates an Amazon Bedrock AgentCore Runtime.

Method Signature

METHODS /AWS1/IF_BDO~CREATEAGENTRUNTIME
  IMPORTING
    !IV_AGENTRUNTIMENAME TYPE /AWS1/BDOAGENTRUNTIMENAME OPTIONAL
    !IO_AGENTRUNTIMEARTIFACT TYPE REF TO /AWS1/CL_BDOAGENTRTIMEARTIFACT OPTIONAL
    !IV_ROLEARN TYPE /AWS1/BDOROLEARN OPTIONAL
    !IO_NETWORKCONFIGURATION TYPE REF TO /AWS1/CL_BDONETWORKCONF OPTIONAL
    !IV_CLIENTTOKEN TYPE /AWS1/BDOCLIENTTOKEN OPTIONAL
    !IV_DESCRIPTION TYPE /AWS1/BDODESCRIPTION OPTIONAL
    !IO_AUTHORIZERCONFIGURATION TYPE REF TO /AWS1/CL_BDOAUTHORIZERCONF OPTIONAL
    !IO_REQUESTHEADERCONF TYPE REF TO /AWS1/CL_BDOREQUESTHEADERCONF OPTIONAL
    !IO_PROTOCOLCONFIGURATION TYPE REF TO /AWS1/CL_BDOPROTOCOLCONF OPTIONAL
    !IO_LIFECYCLECONFIGURATION TYPE REF TO /AWS1/CL_BDOLIFECYCLECONF OPTIONAL
    !IT_ENVIRONMENTVARIABLES TYPE /AWS1/CL_BDOENVVARIABLESMAP_W=>TT_ENVIRONMENTVARIABLESMAP OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_BDOTAGSMAP_W=>TT_TAGSMAP OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_bdocreagentrtimersp
  RAISING
    /AWS1/CX_BDOACCESSDENIEDEX
    /AWS1/CX_BDOCONFLICTEXCEPTION
    /AWS1/CX_BDOINTERNALSERVEREX
    /AWS1/CX_BDOSERVICEQUOTAEXCDEX
    /AWS1/CX_BDOTHROTTLINGEX
    /AWS1/CX_BDOVALIDATIONEX
    /AWS1/CX_BDOCLIENTEXC
    /AWS1/CX_BDOSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_agentruntimename TYPE /AWS1/BDOAGENTRUNTIMENAME /AWS1/BDOAGENTRUNTIMENAME

The name of the AgentCore Runtime.

io_agentruntimeartifact TYPE REF TO /AWS1/CL_BDOAGENTRTIMEARTIFACT /AWS1/CL_BDOAGENTRTIMEARTIFACT

The artifact of the AgentCore Runtime.

iv_rolearn TYPE /AWS1/BDOROLEARN /AWS1/BDOROLEARN

The IAM role ARN that provides permissions for the AgentCore Runtime.

io_networkconfiguration TYPE REF TO /AWS1/CL_BDONETWORKCONF /AWS1/CL_BDONETWORKCONF

The network configuration for the AgentCore Runtime.

Optional arguments:

iv_clienttoken TYPE /AWS1/BDOCLIENTTOKEN /AWS1/BDOCLIENTTOKEN

A unique, case-sensitive identifier to ensure idempotency of the request.

iv_description TYPE /AWS1/BDODESCRIPTION /AWS1/BDODESCRIPTION

The description of the AgentCore Runtime.

io_authorizerconfiguration TYPE REF TO /AWS1/CL_BDOAUTHORIZERCONF /AWS1/CL_BDOAUTHORIZERCONF

The authorizer configuration for the AgentCore Runtime.

io_requestheaderconf TYPE REF TO /AWS1/CL_BDOREQUESTHEADERCONF /AWS1/CL_BDOREQUESTHEADERCONF

Configuration for HTTP request headers that will be passed through to the runtime.

io_protocolconfiguration TYPE REF TO /AWS1/CL_BDOPROTOCOLCONF /AWS1/CL_BDOPROTOCOLCONF

protocolConfiguration

io_lifecycleconfiguration TYPE REF TO /AWS1/CL_BDOLIFECYCLECONF /AWS1/CL_BDOLIFECYCLECONF

The life cycle configuration for the AgentCore Runtime.

it_environmentvariables TYPE /AWS1/CL_BDOENVVARIABLESMAP_W=>TT_ENVIRONMENTVARIABLESMAP TT_ENVIRONMENTVARIABLESMAP

Environment variables to set in the AgentCore Runtime environment.

it_tags TYPE /AWS1/CL_BDOTAGSMAP_W=>TT_TAGSMAP TT_TAGSMAP

A map of tag keys and values to assign to the agent runtime. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

RETURNING

oo_output TYPE REF TO /aws1/cl_bdocreagentrtimersp /AWS1/CL_BDOCREAGENTRTIMERSP

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->createagentruntime(
  io_agentruntimeartifact = new /aws1/cl_bdoagentrtimeartifact(
    io_codeconfiguration = new /aws1/cl_bdocodeconfiguration(
      io_code = new /aws1/cl_bdocode(
        io_s3 = new /aws1/cl_bdos3location(
          iv_bucket = |string|
          iv_prefix = |string|
          iv_versionid = |string|
        )
      )
      it_entrypoint = VALUE /aws1/cl_bdoentrypoints_w=>tt_entrypoints(
        ( new /aws1/cl_bdoentrypoints_w( |string| ) )
      )
      iv_runtime = |string|
    )
    io_containerconfiguration = new /aws1/cl_bdocontainerconf( |string| )
  )
  io_authorizerconfiguration = new /aws1/cl_bdoauthorizerconf(
    io_customjwtauthorizer = new /aws1/cl_bdocustomjwtauthrconf(
      it_allowedaudience = VALUE /aws1/cl_bdoalwedaudiencelst_w=>tt_allowedaudiencelist(
        ( new /aws1/cl_bdoalwedaudiencelst_w( |string| ) )
      )
      it_allowedclients = VALUE /aws1/cl_bdoallowedclislist_w=>tt_allowedclientslist(
        ( new /aws1/cl_bdoallowedclislist_w( |string| ) )
      )
      it_allowedscopes = VALUE /aws1/cl_bdoalwdscopestype_w=>tt_allowedscopestype(
        ( new /aws1/cl_bdoalwdscopestype_w( |string| ) )
      )
      it_customclaims = VALUE /aws1/cl_bdocustclaimvldtntype=>tt_customclaimvalidationstype(
        (
          new /aws1/cl_bdocustclaimvldtntype(
            io_authorizingclaimmatchval = new /aws1/cl_bdoauthorizingclaim00(
              io_claimmatchvalue = new /aws1/cl_bdoclaimmatchvaltype(
                it_matchvaluestringlist = VALUE /aws1/cl_bdomatchvalstrlist_w=>tt_matchvaluestringlist(
                  ( new /aws1/cl_bdomatchvalstrlist_w( |string| ) )
                )
                iv_matchvaluestring = |string|
              )
              iv_claimmatchoperator = |string|
            )
            iv_inboundtokenclaimname = |string|
            iv_indbtokenclaimvaluetype = |string|
          )
        )
      )
      iv_discoveryurl = |string|
    )
  )
  io_lifecycleconfiguration = new /aws1/cl_bdolifecycleconf(
    iv_idleruntimesessiontimeout = 123
    iv_maxlifetime = 123
  )
  io_networkconfiguration = new /aws1/cl_bdonetworkconf(
    io_networkmodeconfig = new /aws1/cl_bdovpcconfig(
      it_securitygroups = VALUE /aws1/cl_bdosecuritygroups_w=>tt_securitygroups(
        ( new /aws1/cl_bdosecuritygroups_w( |string| ) )
      )
      it_subnets = VALUE /aws1/cl_bdosubnets_w=>tt_subnets(
        ( new /aws1/cl_bdosubnets_w( |string| ) )
      )
    )
    iv_networkmode = |string|
  )
  io_protocolconfiguration = new /aws1/cl_bdoprotocolconf( |string| )
  io_requestheaderconf = new /aws1/cl_bdorequestheaderconf(
    it_requestheaderallowlist = VALUE /aws1/cl_bdoreqheaderalwlist_w=>tt_requestheaderallowlist(
      ( new /aws1/cl_bdoreqheaderalwlist_w( |string| ) )
    )
  )
  it_environmentvariables = VALUE /aws1/cl_bdoenvvariablesmap_w=>tt_environmentvariablesmap(
    (
      VALUE /aws1/cl_bdoenvvariablesmap_w=>ts_envvariablesmap_maprow(
        key = |string|
        value = new /aws1/cl_bdoenvvariablesmap_w( |string| )
      )
    )
  )
  it_tags = VALUE /aws1/cl_bdotagsmap_w=>tt_tagsmap(
    (
      VALUE /aws1/cl_bdotagsmap_w=>ts_tagsmap_maprow(
        key = |string|
        value = new /aws1/cl_bdotagsmap_w( |string| )
      )
    )
  )
  iv_agentruntimename = |string|
  iv_clienttoken = |string|
  iv_description = |string|
  iv_rolearn = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_agentruntimearn = lo_result->get_agentruntimearn( ).
  lo_workloadidentitydetails = lo_result->get_workloadidentitydetails( ).
  IF lo_workloadidentitydetails IS NOT INITIAL.
    lv_workloadidentityarn = lo_workloadidentitydetails->get_workloadidentityarn( ).
  ENDIF.
  lv_agentruntimeid = lo_result->get_agentruntimeid( ).
  lv_agentruntimeversion = lo_result->get_agentruntimeversion( ).
  lv_datetimestamp = lo_result->get_createdat( ).
  lv_agentruntimestatus = lo_result->get_status( ).
ENDIF.