/AWS1/IF_BDO=>CREATEREGISTRYRECORD()

About CreateRegistryRecord

Creates a new registry record within the specified registry. A registry record represents an individual AI resource's metadata in the registry. This could be an MCP server (and associated tools), A2A agent, agent skill, or a custom resource with a custom schema.

The record is processed asynchronously and returns HTTP 202 Accepted.

Method Signature

METHODS /AWS1/IF_BDO~CREATEREGISTRYRECORD
  IMPORTING
    !IV_REGISTRYID TYPE /AWS1/BDOREGISTRYIDENTIFIER OPTIONAL
    !IV_NAME TYPE /AWS1/BDOREGISTRYRECORDNAME OPTIONAL
    !IV_DESCRIPTION TYPE /AWS1/BDODESCRIPTION OPTIONAL
    !IV_DESCRIPTORTYPE TYPE /AWS1/BDODESCRIPTORTYPE OPTIONAL
    !IO_DESCRIPTORS TYPE REF TO /AWS1/CL_BDODESCRIPTORS OPTIONAL
    !IV_RECORDVERSION TYPE /AWS1/BDOREGISTRYRECORDVERSION OPTIONAL
    !IV_SYNCHRONIZATIONTYPE TYPE /AWS1/BDOSYNCHRONIZATIONTYPE OPTIONAL
    !IO_SYNCCONFIGURATION TYPE REF TO /AWS1/CL_BDOSYNCCONFIGURATION OPTIONAL
    !IV_CLIENTTOKEN TYPE /AWS1/BDOCLIENTTOKEN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_bdocreateregrecordrsp
  RAISING
    /AWS1/CX_BDOACCESSDENIEDEX
    /AWS1/CX_BDOCONFLICTEXCEPTION
    /AWS1/CX_BDOINTERNALSERVEREX
    /AWS1/CX_BDORESOURCENOTFOUNDEX
    /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_registryid TYPE /AWS1/BDOREGISTRYIDENTIFIER /AWS1/BDOREGISTRYIDENTIFIER

The identifier of the registry where the record will be created. You can specify either the Amazon Resource Name (ARN) or the ID of the registry.

iv_name TYPE /AWS1/BDOREGISTRYRECORDNAME /AWS1/BDOREGISTRYRECORDNAME

The name of the registry record.

iv_descriptortype TYPE /AWS1/BDODESCRIPTORTYPE /AWS1/BDODESCRIPTORTYPE

The descriptor type of the registry record.

• MCP - Model Context Protocol descriptor for MCP-compatible servers and tools.

• A2A - Agent-to-Agent protocol descriptor.

• CUSTOM - Custom descriptor type for resources such as APIs, Lambda functions, or servers not conforming to a standard protocol.

• AGENT_SKILLS - Agent skills descriptor for defining agent skill definitions.

Optional arguments:

iv_description TYPE /AWS1/BDODESCRIPTION /AWS1/BDODESCRIPTION

A description of the registry record.

io_descriptors TYPE REF TO /AWS1/CL_BDODESCRIPTORS /AWS1/CL_BDODESCRIPTORS

The descriptor-type-specific configuration containing the resource schema and metadata. The structure of this field depends on the descriptorType you specify.

iv_recordversion TYPE /AWS1/BDOREGISTRYRECORDVERSION /AWS1/BDOREGISTRYRECORDVERSION

The version of the registry record. Use this to track different versions of the record's content.

iv_synchronizationtype TYPE /AWS1/BDOSYNCHRONIZATIONTYPE /AWS1/BDOSYNCHRONIZATIONTYPE

The type of synchronization to use for keeping the record metadata up to date from an external source. Possible values include FROM_URL and NONE.

io_syncconfiguration TYPE REF TO /AWS1/CL_BDOSYNCCONFIGURATION /AWS1/CL_BDOSYNCCONFIGURATION

The configuration for synchronizing registry record metadata from an external source, such as a URL-based MCP server.

iv_clienttoken TYPE /AWS1/BDOCLIENTTOKEN /AWS1/BDOCLIENTTOKEN

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see Ensuring idempotency.

RETURNING

oo_output TYPE REF TO /aws1/cl_bdocreateregrecordrsp /AWS1/CL_BDOCREATEREGRECORDRSP

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->createregistryrecord(
  io_descriptors = new /aws1/cl_bdodescriptors(
    io_a2a = new /aws1/cl_bdoa2adescriptor(
      io_agentcard = new /aws1/cl_bdoagentcarddefn(
        iv_inlinecontent = |string|
        iv_schemaversion = |string|
      )
    )
    io_agentskills = new /aws1/cl_bdoagntskillsdescrptr(
      io_skilldefinition = new /aws1/cl_bdoskilldefinition(
        iv_inlinecontent = |string|
        iv_schemaversion = |string|
      )
      io_skillmd = new /aws1/cl_bdoskillmddefinition( |string| )
    )
    io_custom = new /aws1/cl_bdocustomdescriptor( |string| )
    io_mcp = new /aws1/cl_bdomcpdescriptor(
      io_server = new /aws1/cl_bdoserverdefinition(
        iv_inlinecontent = |string|
        iv_schemaversion = |string|
      )
      io_tools = new /aws1/cl_bdotoolsdefinition(
        iv_inlinecontent = |string|
        iv_protocolversion = |string|
      )
    )
  )
  io_syncconfiguration = new /aws1/cl_bdosyncconfiguration(
    io_fromurl = new /aws1/cl_bdofromurlsyncconf(
      it_credentialproviderconfs = VALUE /aws1/cl_bdoregreccredpvdrconf=>tt_regrecordcredpvdrconflist(
        (
          new /aws1/cl_bdoregreccredpvdrconf(
            io_credentialprovider = new /aws1/cl_bdoregrccredpvdrunion(
              io_iamcredentialprovider = new /aws1/cl_bdoregreciamcredpvdr(
                iv_region = |string|
                iv_rolearn = |string|
                iv_service = |string|
              )
              io_oauthcredentialprovider = new /aws1/cl_bdoregrcoauthcredpvdr(
                it_customparameters = VALUE /aws1/cl_bdocustomparammap_w=>tt_customparametermap(
                  (
                    VALUE /aws1/cl_bdocustomparammap_w=>ts_customparametermap_maprow(
                      value = new /aws1/cl_bdocustomparammap_w( |string| )
                      key = |string|
                    )
                  )
                )
                it_scopes = VALUE /aws1/cl_bdoscopelist_w=>tt_scopelist(
                  ( new /aws1/cl_bdoscopelist_w( |string| ) )
                )
                iv_granttype = |string|
                iv_providerarn = |string|
              )
            )
            iv_credentialprovidertype = |string|
          )
        )
      )
      iv_url = |string|
    )
  )
  iv_clienttoken = |string|
  iv_description = |string|
  iv_descriptortype = |string|
  iv_name = |string|
  iv_recordversion = |string|
  iv_registryid = |string|
  iv_synchronizationtype = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_registryrecordarn = lo_result->get_recordarn( ).
  lv_registryrecordstatus = lo_result->get_status( ).
ENDIF.