Skip to content

/AWS1/IF_MBC=>CREATENETWORK()

About CreateNetwork

Creates a new blockchain network using Amazon Managed Blockchain.

Applies only to Hyperledger Fabric.

Method Signature

METHODS /AWS1/IF_MBC~CREATENETWORK
  IMPORTING
    !IV_CLIENTREQUESTTOKEN TYPE /AWS1/MBCCLIENTREQTOKENSTRING OPTIONAL
    !IV_NAME TYPE /AWS1/MBCNAMESTRING OPTIONAL
    !IV_DESCRIPTION TYPE /AWS1/MBCDESCRIPTIONSTRING OPTIONAL
    !IV_FRAMEWORK TYPE /AWS1/MBCFRAMEWORK OPTIONAL
    !IV_FRAMEWORKVERSION TYPE /AWS1/MBCFRAMEWORKVRSSTRING OPTIONAL
    !IO_FRAMEWORKCONFIGURATION TYPE REF TO /AWS1/CL_MBCNETWORKFRAMEWORK00 OPTIONAL
    !IO_VOTINGPOLICY TYPE REF TO /AWS1/CL_MBCVOTINGPOLICY OPTIONAL
    !IO_MEMBERCONFIGURATION TYPE REF TO /AWS1/CL_MBCMEMBERCONF OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_MBCINPUTTAGMAP_W=>TT_INPUTTAGMAP OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_mbccreatenetworkout
  RAISING
    /AWS1/CX_MBCACCESSDENIEDEX
    /AWS1/CX_MBCINTERNALSVCERROREX
    /AWS1/CX_MBCINVALIDREQUESTEX
    /AWS1/CX_MBCRESRCALRDYEXISTSEX
    /AWS1/CX_MBCRESRCLIMITEXCDEX
    /AWS1/CX_MBCTHROTTLINGEX
    /AWS1/CX_MBCTOOMANYTAGSEX
    /AWS1/CX_MBCCLIENTEXC
    /AWS1/CX_MBCSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_clientrequesttoken TYPE /AWS1/MBCCLIENTREQTOKENSTRING /AWS1/MBCCLIENTREQTOKENSTRING

This is a unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than once. This identifier is required only if you make a service request directly using an HTTP client. It is generated automatically if you use an Amazon Web Services SDK or the Amazon Web Services CLI.

iv_name TYPE /AWS1/MBCNAMESTRING /AWS1/MBCNAMESTRING

The name of the network.

iv_framework TYPE /AWS1/MBCFRAMEWORK /AWS1/MBCFRAMEWORK

The blockchain framework that the network uses.

iv_frameworkversion TYPE /AWS1/MBCFRAMEWORKVRSSTRING /AWS1/MBCFRAMEWORKVRSSTRING

The version of the blockchain framework that the network uses.

io_votingpolicy TYPE REF TO /AWS1/CL_MBCVOTINGPOLICY /AWS1/CL_MBCVOTINGPOLICY

The voting rules used by the network to determine if a proposal is approved.

io_memberconfiguration TYPE REF TO /AWS1/CL_MBCMEMBERCONF /AWS1/CL_MBCMEMBERCONF

Configuration properties for the first member within the network.

Optional arguments:

iv_description TYPE /AWS1/MBCDESCRIPTIONSTRING /AWS1/MBCDESCRIPTIONSTRING

An optional description for the network.

io_frameworkconfiguration TYPE REF TO /AWS1/CL_MBCNETWORKFRAMEWORK00 /AWS1/CL_MBCNETWORKFRAMEWORK00

Configuration properties of the blockchain framework relevant to the network configuration.

it_tags TYPE /AWS1/CL_MBCINPUTTAGMAP_W=>TT_INPUTTAGMAP TT_INPUTTAGMAP

Tags to assign to the network.

Each tag consists of a key and an optional value. You can specify multiple key-value pairs in a single request with an overall maximum of 50 tags allowed per resource.

For more information about tags, see Tagging Resources in the Amazon Managed Blockchain Ethereum Developer Guide, or Tagging Resources in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.

RETURNING

oo_output TYPE REF TO /aws1/cl_mbccreatenetworkout /AWS1/CL_MBCCREATENETWORKOUT

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->createnetwork(
  io_frameworkconfiguration = new /aws1/cl_mbcnetworkframework00( new /aws1/cl_mbcnetworkfabricconf( |string| ) )
  io_memberconfiguration = new /aws1/cl_mbcmemberconf(
    io_frameworkconfiguration = new /aws1/cl_mbcmemberframeworkc00(
      io_fabric = new /aws1/cl_mbcmemberfabricconf(
        iv_adminpassword = |string|
        iv_adminusername = |string|
      )
    )
    io_logpublishingconf = new /aws1/cl_mbcmemberlogpubingc00( new /aws1/cl_mbcmemberfabriclogp00( new /aws1/cl_mbclogconfigurations( new /aws1/cl_mbclogconfiguration( ABAP_TRUE ) ) ) )
    it_tags = VALUE /aws1/cl_mbcinputtagmap_w=>tt_inputtagmap(
      (
        VALUE /aws1/cl_mbcinputtagmap_w=>ts_inputtagmap_maprow(
          key = |string|
          value = new /aws1/cl_mbcinputtagmap_w( |string| )
        )
      )
    )
    iv_description = |string|
    iv_kmskeyarn = |string|
    iv_name = |string|
  )
  io_votingpolicy = new /aws1/cl_mbcvotingpolicy(
    io_approvalthresholdpolicy = new /aws1/cl_mbcapprovalthreshply(
      iv_proposaldurationinhours = 123
      iv_thresholdcomparator = |string|
      iv_thresholdpercentage = 123
    )
  )
  it_tags = VALUE /aws1/cl_mbcinputtagmap_w=>tt_inputtagmap(
    (
      VALUE /aws1/cl_mbcinputtagmap_w=>ts_inputtagmap_maprow(
        key = |string|
        value = new /aws1/cl_mbcinputtagmap_w( |string| )
      )
    )
  )
  iv_clientrequesttoken = |string|
  iv_description = |string|
  iv_framework = |string|
  iv_frameworkversion = |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_resourceidstring = lo_result->get_networkid( ).
  lv_resourceidstring = lo_result->get_memberid( ).
ENDIF.