POST

/networks

http://managedblockchain.{region}.amazonaws.com/networks

Creates a new blockchain network using Amazon Managed Blockchain. Applies only to Hyperledger Fabric.

Access Token Required: API Key

Body Params

Namestringrequired

The name of the network.

Tagsobject

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 <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ethereum-dev/tagging-resources.html">Tagging Resources</a> in the Amazon Managed Blockchain Ethereum Developer Guide, or <a href="https://docs.aws.amazon.com/managed-blockchain/latest/hyperledger-fabric-dev/tagging-resources.html">Tagging Resources</a> in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.

Frameworkstringrequired

The blockchain framework that the network uses.

Descriptionstring

An optional description for the network.

VotingPolicyobjectrequired

The voting rules for the network to decide if a proposal is accepted Applies only to Hyperledger Fabric.

FrameworkVersionstringrequired

The version of the blockchain framework that the network uses.

ClientRequestTokenstringrequired

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.

MemberConfigurationobjectrequired

Configuration properties of the member. Applies only to Hyperledger Fabric.

FrameworkConfigurationobject

Configuration properties relevant to the network for the blockchain framework that the network uses.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://managedblockchain.{region}.amazonaws.com/networks' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}