You are viewing the documentation for an older major version of the AWS SDK for JavaScript.

The modular AWS SDK for JavaScript (v3), the latest major version of AWS SDK for JavaScript, is now stable and recommended for general use. For more information, see the Migration Guide and API Reference.

Class: AWS.ManagedBlockchain

Inherits:

AWS.Service

Object
AWS.Service
AWS.ManagedBlockchain

show all

Identifier:: managedblockchain

API Version:: 2018-09-24

Defined in:: (unknown)

Overview

Constructs a service interface object. Each API operation is exposed as a function on service.

Service Description

Amazon Managed Blockchain is a fully managed service for creating and managing blockchain networks using open-source frameworks. Blockchain allows you to build applications where multiple parties can securely and transparently run transactions and share data without the need for a trusted, central authority.

Managed Blockchain supports the Hyperledger Fabric and Ethereum open-source frameworks. Because of fundamental differences between the frameworks, some API actions or data types may only apply in the context of one framework and not the other. For example, actions related to Hyperledger Fabric network members such as CreateMember and DeleteMember do not apply to Ethereum.

The description for each action indicates the framework or frameworks to which it applies. Data types and properties that apply only in the context of a particular framework are similarly indicated.

Sending a Request Using ManagedBlockchain

var managedblockchain = new AWS.ManagedBlockchain();
managedblockchain.createMember(params, function (err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Locking the API Version

In order to ensure that the ManagedBlockchain object uses this specific API, you can construct the object by passing the apiVersion option to the constructor:

var managedblockchain = new AWS.ManagedBlockchain({apiVersion: '2018-09-24'});

You can also set the API version globally in AWS.config.apiVersions using the managedblockchain service identifier:

AWS.config.apiVersions = {
  managedblockchain: '2018-09-24',
  // other service API versions
};

var managedblockchain = new AWS.ManagedBlockchain();

Version:

2018-09-24

Constructor Summary collapse

new AWS.ManagedBlockchain(options = {}) ⇒ Object constructor
Constructs a service object.

Property Summary collapse

endpoint ⇒ AWS.Endpoint readwrite
An Endpoint object representing the endpoint URL for service requests.

Properties inherited from AWS.Service

apiVersions

Method Summary collapse

createMember(params = {}, callback) ⇒ AWS.Request
Creates a member within a Managed Blockchain network.

Applies only to Hyperledger Fabric.
.
createNetwork(params = {}, callback) ⇒ AWS.Request
Creates a new blockchain network using Amazon Managed Blockchain.

Applies only to Hyperledger Fabric.
.
createNode(params = {}, callback) ⇒ AWS.Request
Creates a node on the specified blockchain network.

Applies to Hyperledger Fabric and Ethereum.
.
createProposal(params = {}, callback) ⇒ AWS.Request
Creates a proposal for a change to the network that other members of the network can vote on, for example, a proposal to add a new member to the network.
deleteMember(params = {}, callback) ⇒ AWS.Request
Deletes a member.
deleteNode(params = {}, callback) ⇒ AWS.Request
Deletes a node that your AWS account owns.
getMember(params = {}, callback) ⇒ AWS.Request
Returns detailed information about a member.

Applies only to Hyperledger Fabric.
.
getNetwork(params = {}, callback) ⇒ AWS.Request
Returns detailed information about a network.

Applies to Hyperledger Fabric and Ethereum.
.
getNode(params = {}, callback) ⇒ AWS.Request
Returns detailed information about a node.

Applies to Hyperledger Fabric and Ethereum.
.
getProposal(params = {}, callback) ⇒ AWS.Request
Returns detailed information about a proposal.

Applies only to Hyperledger Fabric.
.
listInvitations(params = {}, callback) ⇒ AWS.Request
Returns a list of all invitations for the current AWS account.

Applies only to Hyperledger Fabric.
.
listMembers(params = {}, callback) ⇒ AWS.Request
Returns a list of the members in a network and properties of their configurations.

Applies only to Hyperledger Fabric.
.
listNetworks(params = {}, callback) ⇒ AWS.Request
Returns information about the networks in which the current AWS account participates.

Applies to Hyperledger Fabric and Ethereum.
.
listNodes(params = {}, callback) ⇒ AWS.Request
Returns information about the nodes within a network.

Applies to Hyperledger Fabric and Ethereum.
.
listProposals(params = {}, callback) ⇒ AWS.Request
Returns a list of proposals for the network.

Applies only to Hyperledger Fabric.
.
listProposalVotes(params = {}, callback) ⇒ AWS.Request
Returns the list of votes for a specified proposal, including the value of each vote and the unique identifier of the member that cast the vote.

Applies only to Hyperledger Fabric.
.
listTagsForResource(params = {}, callback) ⇒ AWS.Request
Returns a list of tags for the specified resource.
rejectInvitation(params = {}, callback) ⇒ AWS.Request
Rejects an invitation to join a network.
tagResource(params = {}, callback) ⇒ AWS.Request
Adds or overwrites the specified tags for the specified Amazon Managed Blockchain resource.
untagResource(params = {}, callback) ⇒ AWS.Request
Removes the specified tags from the Amazon Managed Blockchain 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.
.
updateMember(params = {}, callback) ⇒ AWS.Request
Updates a member configuration with new parameters.

Applies only to Hyperledger Fabric.
.
updateNode(params = {}, callback) ⇒ AWS.Request
Updates a node configuration with new parameters.

Applies only to Hyperledger Fabric.
.
voteOnProposal(params = {}, callback) ⇒ AWS.Request
Casts a vote for a specified ProposalId on behalf of a member.

Methods inherited from AWS.Service

makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService

Constructor Details

new AWS.ManagedBlockchain(options = {}) ⇒ `Object`

Constructs a service object. This object has one method for each API operation.

Examples:

Constructing a ManagedBlockchain object

var managedblockchain = new AWS.ManagedBlockchain({apiVersion: '2018-09-24'});

Options Hash (options):

params (map) —
An optional map of parameters to bind to every request sent by this service object. For more information on bound parameters, see "Working with Services" in the Getting Started Guide.
endpoint (String|AWS.Endpoint) —
The endpoint URI to send requests to. The default endpoint is built from the configured region. The endpoint should be a string like 'https://{service}.{region}.amazonaws.com' or an Endpoint object.
accessKeyId (String) —
your AWS access key ID.
secretAccessKey (String) —
your AWS secret access key.
sessionToken (AWS.Credentials) —
the optional AWS session token to sign requests with.
credentials (AWS.Credentials) —
the AWS credentials to sign requests with. You can either specify this object, or specify the accessKeyId and secretAccessKey options directly.
credentialProvider (AWS.CredentialProviderChain) —
the provider chain used to resolve credentials if no static credentials property is set.
region (String) —
the region to send service requests to. See AWS.ManagedBlockchain.region for more information.
maxRetries (Integer) —
the maximum amount of retries to attempt with a request. See AWS.ManagedBlockchain.maxRetries for more information.
maxRedirects (Integer) —
the maximum amount of redirects to follow with a request. See AWS.ManagedBlockchain.maxRedirects for more information.
sslEnabled (Boolean) —
whether to enable SSL for requests.
paramValidation (Boolean|map) —
whether input parameters should be validated against the operation description before sending the request. Defaults to true. Pass a map to enable any of the following specific validation features:
- min [Boolean] — Validates that a value meets the min constraint. This is enabled by default when paramValidation is set to true.
- max [Boolean] — Validates that a value meets the max constraint.
- pattern [Boolean] — Validates that a string value matches a regular expression.
- enum [Boolean] — Validates that a string value matches one of the allowable enum values.
computeChecksums (Boolean) —
whether to compute checksums for payload bodies when the service accepts it (currently supported in S3 only)
convertResponseTypes (Boolean) —
whether types are converted when parsing response data. Currently only supported for JSON based services. Turning this off may improve performance on large response payloads. Defaults to true.
correctClockSkew (Boolean) —
whether to apply a clock skew correction and retry requests that fail because of an skewed client clock. Defaults to false.
s3ForcePathStyle (Boolean) —
whether to force path style URLs for S3 objects.
s3BucketEndpoint (Boolean) —
whether the provided endpoint addresses an individual bucket (false if it addresses the root API endpoint). Note that setting this configuration option requires an endpoint to be provided explicitly to the service constructor.
s3DisableBodySigning (Boolean) —
whether S3 body signing should be disabled when using signature version v4. Body signing can only be disabled when using https. Defaults to true.
s3UsEast1RegionalEndpoint ('legacy'|'regional') —
when region is set to 'us-east-1', whether to send s3 request to global endpoints or 'us-east-1' regional endpoints. This config is only applicable to S3 client. Defaults to legacy
s3UseArnRegion (Boolean) —
whether to override the request region with the region inferred from requested resource's ARN. Only available for S3 buckets Defaults to true
retryDelayOptions (map) —
A set of options to configure the retry delay on retryable errors. Currently supported options are:
- base [Integer] — The base number of milliseconds to use in the exponential backoff for operation retries. Defaults to 100 ms for all services except DynamoDB, where it defaults to 50ms.
- customBackoff [function] — A custom function that accepts a retry count and error and returns the amount of time to delay in milliseconds. If the result is a non-zero negative value, no further retry attempts will be made. The base option will be ignored if this option is supplied. The function is only called for retryable errors.
httpOptions (map) —
A set of options to pass to the low-level HTTP request. Currently supported options are:
- proxy [String] — the URL to proxy requests through
- agent [http.Agent, https.Agent] — the Agent object to perform HTTP requests with. Used for connection pooling. Defaults to the global agent (http.globalAgent) for non-SSL connections. Note that for SSL connections, a special Agent object is used in order to enable peer certificate verification. This feature is only available in the Node.js environment.
- connectTimeout [Integer] — Sets the socket to timeout after failing to establish a connection with the server after connectTimeout milliseconds. This timeout has no effect once a socket connection has been established.
- timeout [Integer] — Sets the socket to timeout after timeout milliseconds of inactivity on the socket. Defaults to two minutes (120000).
- xhrAsync [Boolean] — Whether the SDK will send asynchronous HTTP requests. Used in the browser environment only. Set to false to send requests synchronously. Defaults to true (async on).
- xhrWithCredentials [Boolean] — Sets the "withCredentials" property of an XMLHttpRequest object. Used in the browser environment only. Defaults to false.
apiVersion (String, Date) —
a String in YYYY-MM-DD format (or a date) that represents the latest possible API version that can be used in all services (unless overridden by apiVersions). Specify 'latest' to use the latest possible version.
apiVersions (map<String, String|Date>) —
a map of service identifiers (the lowercase service class name) with the API version to use when instantiating a service. Specify 'latest' for each individual that can use the latest available version.
logger (#write, #log) —
an object that responds to .write() (like a stream) or .log() (like the console object) in order to log information about requests
systemClockOffset (Number) —
an offset value in milliseconds to apply to all signing times. Use this to compensate for clock skew when your system may be out of sync with the service time. Note that this configuration option can only be applied to the global AWS.config object and cannot be overridden in service-specific configuration. Defaults to 0 milliseconds.
signatureVersion (String) —
the signature version to sign requests with (overriding the API configuration). Possible values are: 'v2', 'v3', 'v4'.
signatureCache (Boolean) —
whether the signature to sign requests with (overriding the API configuration) is cached. Only applies to the signature version 'v4'. Defaults to true.
dynamoDbCrc32 (Boolean) —
whether to validate the CRC32 checksum of HTTP response bodies returned by DynamoDB. Default: true.
useAccelerateEndpoint (Boolean) —
Whether to use the S3 Transfer Acceleration endpoint with the S3 service. Default: false.
clientSideMonitoring (Boolean) —
whether to collect and publish this client's performance metrics of all its API requests.
endpointDiscoveryEnabled (Boolean|undefined) —
whether to call operations with endpoints given by service dynamically. Setting this
endpointCacheSize (Number) —
the size of the global cache storing endpoints from endpoint discovery operations. Once endpoint cache is created, updating this setting cannot change existing cache size. Defaults to 1000
hostPrefixEnabled (Boolean) —
whether to marshal request parameters to the prefix of hostname. Defaults to true.
stsRegionalEndpoints ('legacy'|'regional') —
whether to send sts request to global endpoints or regional endpoints. Defaults to 'legacy'.

Property Details

endpoint ⇒ `AWS.Endpoint` (readwrite)

Returns an Endpoint object representing the endpoint URL for service requests.

Returns:

(AWS.Endpoint) —
an Endpoint object representing the endpoint URL for service requests.

Method Details

createMember(params = {}, callback) ⇒ `AWS.Request`

Creates a member within a Managed Blockchain network.

Applies only to Hyperledger Fabric.

Service Reference:

CreateMember

Examples:

Calling the createMember operation

var params = {
  ClientRequestToken: 'STRING_VALUE', /* required */
  InvitationId: 'STRING_VALUE', /* required */
  MemberConfiguration: { /* required */
    FrameworkConfiguration: { /* required */
      Fabric: {
        AdminPassword: 'STRING_VALUE', /* required */
        AdminUsername: 'STRING_VALUE' /* required */
      }
    },
    Name: 'STRING_VALUE', /* required */
    Description: 'STRING_VALUE',
    KmsKeyArn: 'STRING_VALUE',
    LogPublishingConfiguration: {
      Fabric: {
        CaLogs: {
          Cloudwatch: {
            Enabled: true || false
          }
        }
      }
    },
    Tags: {
      '<TagKey>': 'STRING_VALUE',
      /* '<TagKey>': ... */
    }
  },
  NetworkId: 'STRING_VALUE' /* required */
};
managedblockchain.createMember(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- ClientRequestToken — (String)
  A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than one time. This identifier is required only if you make a service request directly using an HTTP client. It is generated automatically if you use an AWS SDK or the AWS CLI.
  If a token is not provided, the SDK will use a version 4 UUID.
- InvitationId — (String)
  The unique identifier of the invitation that is sent to the member to join the network.
- NetworkId — (String)
  The unique identifier of the network in which the member is created.
- MemberConfiguration — (map)
  Member configuration parameters.
  - Name — required — (String)
    The name of the member.
  - Description — (String)
    An optional description of the member.
  - FrameworkConfiguration — required — (map)
    Configuration properties of the blockchain framework relevant to the member.
    - Fabric — (map)
      Attributes of Hyperledger Fabric for a member on a Managed Blockchain network that uses Hyperledger Fabric.
      
      AdminUsername — required — (String)
      The user name for the member's initial administrative user.
      
      AdminPassword — required — (String)
      The password for the member's initial administrative user. The AdminPassword must be at least eight characters long and no more than 32 characters. It must contain at least one uppercase letter, one lowercase letter, and one digit. It cannot have a single quotation mark (‘), a double quotation marks (“), a forward slash(/), a backward slash(), @, or a space.
  - LogPublishingConfiguration — (map)
    Configuration properties for logging events associated with a member of a Managed Blockchain network.
    - Fabric — (map)
      Configuration properties for logging events associated with a member of a Managed Blockchain network using the Hyperledger Fabric framework.
      
      CaLogs — (map)
      Configuration properties for logging events associated with a member's Certificate Authority (CA). CA logs help you determine when a member in your account joins the network, or when new peers register with a member CA.
      
      Cloudwatch — (map)
      Parameters for publishing logs to Amazon CloudWatch Logs.
      
      Enabled — (Boolean)
      Indicates whether logging is enabled.
  - Tags — (map<String>)
    Tags assigned to the member. Tags consist of a key and optional value. For more information about tags, see Tagging Resources in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.
    
    When specifying tags during creation, you can specify multiple key-value pairs in a single request, with an overall maximum of 50 tags added to each resource.
  - KmsKeyArn — (String)
    The Amazon Resource Name (ARN) of the customer managed key in AWS Key Management Service (AWS KMS) to use for encryption at rest in the member. This parameter is inherited by any nodes that this member creates.
    
    Use one of the following options to specify this parameter:
    - Undefined or empty string - The member uses an AWS owned KMS key for encryption by default.
    - A valid symmetric customer managed KMS key - The member uses the specified key for encryption.
      
      Amazon Managed Blockchain doesn't support asymmetric keys. For more information, see Using symmetric and asymmetric keys in the AWS Key Management Service Developer Guide.
      
      The following is an example of a KMS key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - MemberId — (String)
    The unique identifier of the member.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

createNetwork(params = {}, callback) ⇒ `AWS.Request`

Creates a new blockchain network using Amazon Managed Blockchain.

Applies only to Hyperledger Fabric.

Service Reference:

CreateNetwork

Examples:

Calling the createNetwork operation

var params = {
  ClientRequestToken: 'STRING_VALUE', /* required */
  Framework: HYPERLEDGER_FABRIC | ETHEREUM, /* required */
  FrameworkVersion: 'STRING_VALUE', /* required */
  MemberConfiguration: { /* required */
    FrameworkConfiguration: { /* required */
      Fabric: {
        AdminPassword: 'STRING_VALUE', /* required */
        AdminUsername: 'STRING_VALUE' /* required */
      }
    },
    Name: 'STRING_VALUE', /* required */
    Description: 'STRING_VALUE',
    KmsKeyArn: 'STRING_VALUE',
    LogPublishingConfiguration: {
      Fabric: {
        CaLogs: {
          Cloudwatch: {
            Enabled: true || false
          }
        }
      }
    },
    Tags: {
      '<TagKey>': 'STRING_VALUE',
      /* '<TagKey>': ... */
    }
  },
  Name: 'STRING_VALUE', /* required */
  VotingPolicy: { /* required */
    ApprovalThresholdPolicy: {
      ProposalDurationInHours: 'NUMBER_VALUE',
      ThresholdComparator: GREATER_THAN | GREATER_THAN_OR_EQUAL_TO,
      ThresholdPercentage: 'NUMBER_VALUE'
    }
  },
  Description: 'STRING_VALUE',
  FrameworkConfiguration: {
    Fabric: {
      Edition: STARTER | STANDARD /* required */
    }
  },
  Tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
managedblockchain.createNetwork(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- ClientRequestToken — (String)
  A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than one time. This identifier is required only if you make a service request directly using an HTTP client. It is generated automatically if you use an AWS SDK or the AWS CLI.
  If a token is not provided, the SDK will use a version 4 UUID.
- Name — (String)
  The name of the network.
- Description — (String)
  An optional description for the network.
- Framework — (String)
  The blockchain framework that the network uses.
  Possible values include:
  - "HYPERLEDGER_FABRIC"
  - "ETHEREUM"
- FrameworkVersion — (String)
  The version of the blockchain framework that the network uses.
- FrameworkConfiguration — (map)
  Configuration properties of the blockchain framework relevant to the network configuration.
  - Fabric — (map)
    Hyperledger Fabric configuration properties for a Managed Blockchain network that uses Hyperledger Fabric.
    - Edition — required — (String)
      The edition of Amazon Managed Blockchain that the network uses. For more information, see Amazon Managed Blockchain Pricing.
      Possible values include:
      
      "STARTER"
      
      "STANDARD"
- VotingPolicy — (map)
  The voting rules used by the network to determine if a proposal is approved.
  - ApprovalThresholdPolicy — (map)
    Defines the rules for the network for voting on proposals, such as the percentage of YES votes required for the proposal to be approved and the duration of the proposal. The policy applies to all proposals and is specified when the network is created.
    - ThresholdPercentage — (Integer)
      The percentage of votes among all members that must be YES for a proposal to be approved. For example, a ThresholdPercentage value of 50 indicates 50%. The ThresholdComparator determines the precise comparison. If a ThresholdPercentage value of 50 is specified on a network with 10 members, along with a ThresholdComparator value of GREATER_THAN, this indicates that 6 YES votes are required for the proposal to be approved.
    - ProposalDurationInHours — (Integer)
      The duration from the time that a proposal is created until it expires. If members cast neither the required number of YES votes to approve the proposal nor the number of NO votes required to reject it before the duration expires, the proposal is EXPIRED and ProposalActions are not carried out.
    - ThresholdComparator — (String)
      Determines whether the vote percentage must be greater than the ThresholdPercentage or must be greater than or equal to the ThreholdPercentage to be approved.
      Possible values include:
      
      "GREATER_THAN"
      
      "GREATER_THAN_OR_EQUAL_TO"
- MemberConfiguration — (map)
  Configuration properties for the first member within the network.
  - Name — required — (String)
    The name of the member.
  - Description — (String)
    An optional description of the member.
  - FrameworkConfiguration — required — (map)
    Configuration properties of the blockchain framework relevant to the member.
    - Fabric — (map)
      Attributes of Hyperledger Fabric for a member on a Managed Blockchain network that uses Hyperledger Fabric.
      
      AdminUsername — required — (String)
      The user name for the member's initial administrative user.
      
      AdminPassword — required — (String)
      The password for the member's initial administrative user. The AdminPassword must be at least eight characters long and no more than 32 characters. It must contain at least one uppercase letter, one lowercase letter, and one digit. It cannot have a single quotation mark (‘), a double quotation marks (“), a forward slash(/), a backward slash(), @, or a space.
  - LogPublishingConfiguration — (map)
    Configuration properties for logging events associated with a member of a Managed Blockchain network.
    - Fabric — (map)
      Configuration properties for logging events associated with a member of a Managed Blockchain network using the Hyperledger Fabric framework.
      
      CaLogs — (map)
      Configuration properties for logging events associated with a member's Certificate Authority (CA). CA logs help you determine when a member in your account joins the network, or when new peers register with a member CA.
      
      Cloudwatch — (map)
      Parameters for publishing logs to Amazon CloudWatch Logs.
      
      Enabled — (Boolean)
      Indicates whether logging is enabled.
  - Tags — (map<String>)
    Tags assigned to the member. Tags consist of a key and optional value. For more information about tags, see Tagging Resources in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.
    
    When specifying tags during creation, you can specify multiple key-value pairs in a single request, with an overall maximum of 50 tags added to each resource.
  - KmsKeyArn — (String)
    The Amazon Resource Name (ARN) of the customer managed key in AWS Key Management Service (AWS KMS) to use for encryption at rest in the member. This parameter is inherited by any nodes that this member creates.
    
    Use one of the following options to specify this parameter:
    - Undefined or empty string - The member uses an AWS owned KMS key for encryption by default.
    - A valid symmetric customer managed KMS key - The member uses the specified key for encryption.
      
      Amazon Managed Blockchain doesn't support asymmetric keys. For more information, see Using symmetric and asymmetric keys in the AWS Key Management Service Developer Guide.
      
      The following is an example of a KMS key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
- Tags — (map<String>)
  Tags to assign to the network. Each tag consists of a key and optional value.
  
  When specifying tags during creation, you can specify multiple key-value pairs in a single request, with an overall maximum of 50 tags added to each 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.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - NetworkId — (String)
    The unique identifier for the network.
  - MemberId — (String)
    The unique identifier for the first member within the network.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

createNode(params = {}, callback) ⇒ `AWS.Request`

Creates a node on the specified blockchain network.

Applies to Hyperledger Fabric and Ethereum.

Service Reference:

CreateNode

Examples:

Calling the createNode operation

var params = {
  ClientRequestToken: 'STRING_VALUE', /* required */
  NetworkId: 'STRING_VALUE', /* required */
  NodeConfiguration: { /* required */
    InstanceType: 'STRING_VALUE', /* required */
    AvailabilityZone: 'STRING_VALUE',
    LogPublishingConfiguration: {
      Fabric: {
        ChaincodeLogs: {
          Cloudwatch: {
            Enabled: true || false
          }
        },
        PeerLogs: {
          Cloudwatch: {
            Enabled: true || false
          }
        }
      }
    },
    StateDB: LevelDB | CouchDB
  },
  MemberId: 'STRING_VALUE',
  Tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
managedblockchain.createNode(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- ClientRequestToken — (String)
  A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than one time. This identifier is required only if you make a service request directly using an HTTP client. It is generated automatically if you use an AWS SDK or the AWS CLI.
  If a token is not provided, the SDK will use a version 4 UUID.
- NetworkId — (String)
  The unique identifier of the network for the node.
  
  Ethereum public networks have the following NetworkIds:
  - n-ethereum-mainnet
  - n-ethereum-rinkeby
  - n-ethereum-ropsten
- MemberId — (String)
  The unique identifier of the member that owns this node.
  
  Applies only to Hyperledger Fabric.
- NodeConfiguration — (map)
  The properties of a node configuration.
  - InstanceType — required — (String)
    The Amazon Managed Blockchain instance type for the node.
  - AvailabilityZone — (String)
    The Availability Zone in which the node exists. Required for Ethereum nodes.
  - LogPublishingConfiguration — (map)
    Configuration properties for logging events associated with a peer node on a Hyperledger Fabric network on Managed Blockchain.
    - Fabric — (map)
      Configuration properties for logging events associated with a node that is owned by a member of a Managed Blockchain network using the Hyperledger Fabric framework.
      
      ChaincodeLogs — (map)
      Configuration properties for logging events associated with chaincode execution on a peer node. Chaincode logs contain the results of instantiating, invoking, and querying the chaincode. A peer can run multiple instances of chaincode. When enabled, a log stream is created for all chaincodes, with an individual log stream for each chaincode.
      
      Cloudwatch — (map)
      Parameters for publishing logs to Amazon CloudWatch Logs.
      
      Enabled — (Boolean)
      Indicates whether logging is enabled.
      
      PeerLogs — (map)
      Configuration properties for a peer node log. Peer node logs contain messages generated when your client submits transaction proposals to peer nodes, requests to join channels, enrolls an admin peer, and lists the chaincode instances on a peer node.
      
      Cloudwatch — (map)
      Parameters for publishing logs to Amazon CloudWatch Logs.
      
      Enabled — (Boolean)
      Indicates whether logging is enabled.
  - StateDB — (String)
    The state database that the node uses. Values are LevelDB or CouchDB. When using an Amazon Managed Blockchain network with Hyperledger Fabric version 1.4 or later, the default is CouchDB.
    
    Applies only to Hyperledger Fabric.
    Possible values include:
    - "LevelDB"
    - "CouchDB"
- Tags — (map<String>)
  Tags to assign to the node. Each tag consists of a key and optional value.
  
  When specifying tags during creation, you can specify multiple key-value pairs in a single request, with an overall maximum of 50 tags added to each 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.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - NodeId — (String)
    The unique identifier of the node.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

createProposal(params = {}, callback) ⇒ `AWS.Request`

Creates a proposal for a change to the network that other members of the network can vote on, for example, a proposal to add a new member to the network. Any member can create a proposal.

Applies only to Hyperledger Fabric.

Service Reference:

CreateProposal

Examples:

Calling the createProposal operation

var params = {
  Actions: { /* required */
    Invitations: [
      {
        Principal: 'STRING_VALUE' /* required */
      },
      /* more items */
    ],
    Removals: [
      {
        MemberId: 'STRING_VALUE' /* required */
      },
      /* more items */
    ]
  },
  ClientRequestToken: 'STRING_VALUE', /* required */
  MemberId: 'STRING_VALUE', /* required */
  NetworkId: 'STRING_VALUE', /* required */
  Description: 'STRING_VALUE',
  Tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
managedblockchain.createProposal(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- ClientRequestToken — (String)
  A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than one time. This identifier is required only if you make a service request directly using an HTTP client. It is generated automatically if you use an AWS SDK or the AWS CLI.
  If a token is not provided, the SDK will use a version 4 UUID.
- NetworkId — (String)
  The unique identifier of the network for which the proposal is made.
- MemberId — (String)
  The unique identifier of the member that is creating the proposal. This identifier is especially useful for identifying the member making the proposal when multiple members exist in a single AWS account.
- Actions — (map)
  The type of actions proposed, such as inviting a member or removing a member. The types of Actions in a proposal are mutually exclusive. For example, a proposal with Invitations actions cannot also contain Removals actions.
  - Invitations — (Array<map>)
    The actions to perform for an APPROVED proposal to invite an AWS account to create a member and join the network.
    - Principal — required — (String)
      The AWS account ID to invite.
  - Removals — (Array<map>)
    The actions to perform for an APPROVED proposal to remove a member from the network, which deletes the member and all associated member resources from the network.
    - MemberId — required — (String)
      The unique identifier of the member to remove.
- Description — (String)
  A description for the proposal that is visible to voting members, for example, "Proposal to add Example Corp. as member."
- Tags — (map<String>)
  Tags to assign to the proposal. Each tag consists of a key and optional value.
  
  When specifying tags during creation, you can specify multiple key-value pairs in a single request, with an overall maximum of 50 tags added to each resource. If the proposal is for a network invitation, the invitation inherits the tags added to the proposal.
  
  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.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - ProposalId — (String)
    The unique identifier of the proposal.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

deleteMember(params = {}, callback) ⇒ `AWS.Request`

Deletes a member. Deleting a member removes the member and all associated resources from the network. DeleteMember can only be called for a specified MemberId if the principal performing the action is associated with the AWS account that owns the member. In all other cases, the DeleteMember action is carried out as the result of an approved proposal to remove a member. If MemberId is the last member in a network specified by the last AWS account, the network is deleted also.

Applies only to Hyperledger Fabric.

Service Reference:

DeleteMember

Examples:

Calling the deleteMember operation

var params = {
  MemberId: 'STRING_VALUE', /* required */
  NetworkId: 'STRING_VALUE' /* required */
};
managedblockchain.deleteMember(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network from which the member is removed.
- MemberId — (String)
  The unique identifier of the member to remove.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

deleteNode(params = {}, callback) ⇒ `AWS.Request`

Deletes a node that your AWS account owns. All data on the node is lost and cannot be recovered.

Applies to Hyperledger Fabric and Ethereum.

Service Reference:

DeleteNode

Examples:

Calling the deleteNode operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  NodeId: 'STRING_VALUE', /* required */
  MemberId: 'STRING_VALUE'
};
managedblockchain.deleteNode(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network that the node is on.
  
  Ethereum public networks have the following NetworkIds:
  - n-ethereum-mainnet
  - n-ethereum-rinkeby
  - n-ethereum-ropsten
- MemberId — (String)
  The unique identifier of the member that owns this node.
  
  Applies only to Hyperledger Fabric and is required for Hyperledger Fabric.
- NodeId — (String)
  The unique identifier of the node.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

getMember(params = {}, callback) ⇒ `AWS.Request`

Returns detailed information about a member.

Applies only to Hyperledger Fabric.

Service Reference:

GetMember

Examples:

Calling the getMember operation

var params = {
  MemberId: 'STRING_VALUE', /* required */
  NetworkId: 'STRING_VALUE' /* required */
};
managedblockchain.getMember(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network to which the member belongs.
- MemberId — (String)
  The unique identifier of the member.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Member — (map)
    The properties of a member.
    
    NetworkId — (String)
    The unique identifier of the network to which the member belongs.
    
    Id — (String)
    The unique identifier of the member.
    
    Name — (String)
    The name of the member.
    
    Description — (String)
    An optional description for the member.
    
    FrameworkAttributes — (map)
    Attributes relevant to a member for the blockchain framework that the Managed Blockchain network uses.
    
    Fabric — (map)
    Attributes of Hyperledger Fabric relevant to a member on a Managed Blockchain network that uses Hyperledger Fabric.
    
    AdminUsername — (String)
    The user name for the initial administrator user for the member.
    
    CaEndpoint — (String)
    The endpoint used to access the member's certificate authority.
    
    LogPublishingConfiguration — (map)
    Configuration properties for logging events associated with a member.
    
    Fabric — (map)
    Configuration properties for logging events associated with a member of a Managed Blockchain network using the Hyperledger Fabric framework.
    
    CaLogs — (map)
    Configuration properties for logging events associated with a member's Certificate Authority (CA). CA logs help you determine when a member in your account joins the network, or when new peers register with a member CA.
    
    Cloudwatch — (map)
    Parameters for publishing logs to Amazon CloudWatch Logs.
    
    Enabled — (Boolean)
    Indicates whether logging is enabled.
    
    Status — (String)
    The status of a member.
    
    CREATING - The AWS account is in the process of creating a member.
    
    AVAILABLE - The member has been created and can participate in the network.
    
    CREATE_FAILED - The AWS account attempted to create a member and creation failed.
    
    UPDATING - The member is in the process of being updated.
    
    DELETING - The member and all associated resources are in the process of being deleted. Either the AWS account that owns the member deleted it, or the member is being deleted as the result of an APPROVED PROPOSAL to remove the member.
    
    DELETED - The member can no longer participate on the network and all associated resources are deleted. Either the AWS account that owns the member deleted it, or the member is being deleted as the result of an APPROVED PROPOSAL to remove the member.
    
    INACCESSIBLE_ENCRYPTION_KEY - The member is impaired and might not function as expected because it cannot access the specified customer managed key in AWS KMS for encryption at rest. Either the KMS key was disabled or deleted, or the grants on the key were revoked.
    
    The effect of disabling or deleting a key, or revoking a grant is not immediate. The member resource might take some time to find that the key is inaccessible. When a resource is in this state, we recommend deleting and recreating the resource.
    
    Possible values include:
    
    "CREATING"
    
    "AVAILABLE"
    
    "CREATE_FAILED"
    
    "UPDATING"
    
    "DELETING"
    
    "DELETED"
    
    "INACCESSIBLE_ENCRYPTION_KEY"
    
    CreationDate — (Date)
    The date and time that the member was created.
    
    Tags — (map<String>)
    Tags assigned to the member. Tags consist of a key and optional value. For more information about tags, see Tagging Resources in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the member. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
    
    KmsKeyArn — (String)
    The Amazon Resource Name (ARN) of the customer managed key in AWS Key Management Service (AWS KMS) that the member uses for encryption at rest. If the value of this parameter is "AWS Owned KMS Key", the member uses an AWS owned KMS key for encryption. This parameter is inherited by the nodes that this member owns.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

getNetwork(params = {}, callback) ⇒ `AWS.Request`

Returns detailed information about a network.

Applies to Hyperledger Fabric and Ethereum.

Service Reference:

GetNetwork

Examples:

Calling the getNetwork operation

var params = {
  NetworkId: 'STRING_VALUE' /* required */
};
managedblockchain.getNetwork(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network to get information about.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Network — (map)
    An object containing network configuration parameters.
    
    Id — (String)
    The unique identifier of the network.
    
    Name — (String)
    The name of the network.
    
    Description — (String)
    Attributes of the blockchain framework for the network.
    
    Framework — (String)
    The blockchain framework that the network uses.
    Possible values include:
    
    "HYPERLEDGER_FABRIC"
    
    "ETHEREUM"
    
    FrameworkVersion — (String)
    The version of the blockchain framework that the network uses.
    
    FrameworkAttributes — (map)
    Attributes of the blockchain framework that the network uses.
    
    Fabric — (map)
    Attributes of Hyperledger Fabric for a Managed Blockchain network that uses Hyperledger Fabric.
    
    OrderingServiceEndpoint — (String)
    The endpoint of the ordering service for the network.
    
    Edition — (String)
    The edition of Amazon Managed Blockchain that Hyperledger Fabric uses. For more information, see Amazon Managed Blockchain Pricing.
    Possible values include:
    
    "STARTER"
    
    "STANDARD"
    
    Ethereum — (map)
    Attributes of an Ethereum network for Managed Blockchain resources participating in an Ethereum network.
    
    ChainId — (String)
    The Ethereum CHAIN_ID associated with the Ethereum network. Chain IDs are as follows:
    
    mainnet = 1
    
    rinkeby = 4
    
    ropsten = 3
    
    VpcEndpointServiceName — (String)
    The VPC endpoint service name of the VPC endpoint service of the network. Members use the VPC endpoint service name to create a VPC endpoint to access network resources.
    
    VotingPolicy — (map)
    The voting rules for the network to decide if a proposal is accepted.
    
    ApprovalThresholdPolicy — (map)
    Defines the rules for the network for voting on proposals, such as the percentage of YES votes required for the proposal to be approved and the duration of the proposal. The policy applies to all proposals and is specified when the network is created.
    
    ThresholdPercentage — (Integer)
    The percentage of votes among all members that must be YES for a proposal to be approved. For example, a ThresholdPercentage value of 50 indicates 50%. The ThresholdComparator determines the precise comparison. If a ThresholdPercentage value of 50 is specified on a network with 10 members, along with a ThresholdComparator value of GREATER_THAN, this indicates that 6 YES votes are required for the proposal to be approved.
    
    ProposalDurationInHours — (Integer)
    The duration from the time that a proposal is created until it expires. If members cast neither the required number of YES votes to approve the proposal nor the number of NO votes required to reject it before the duration expires, the proposal is EXPIRED and ProposalActions are not carried out.
    
    ThresholdComparator — (String)
    Determines whether the vote percentage must be greater than the ThresholdPercentage or must be greater than or equal to the ThreholdPercentage to be approved.
    Possible values include:
    
    "GREATER_THAN"
    
    "GREATER_THAN_OR_EQUAL_TO"
    
    Status — (String)
    The current status of the network.
    Possible values include:
    
    "CREATING"
    
    "AVAILABLE"
    
    "CREATE_FAILED"
    
    "DELETING"
    
    "DELETED"
    
    CreationDate — (Date)
    The date and time that the network was created.
    
    Tags — (map<String>)
    Tags assigned to the network. Each tag consists of a key and optional value.
    
    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.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the network. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

getNode(params = {}, callback) ⇒ `AWS.Request`

Returns detailed information about a node.

Applies to Hyperledger Fabric and Ethereum.

Service Reference:

GetNode

Examples:

Calling the getNode operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  NodeId: 'STRING_VALUE', /* required */
  MemberId: 'STRING_VALUE'
};
managedblockchain.getNode(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network that the node is on.
- MemberId — (String)
  The unique identifier of the member that owns the node.
  
  Applies only to Hyperledger Fabric and is required for Hyperledger Fabric.
- NodeId — (String)
  The unique identifier of the node.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Node — (map)
    Properties of the node configuration.
    
    NetworkId — (String)
    The unique identifier of the network that the node is on.
    
    MemberId — (String)
    The unique identifier of the member to which the node belongs.
    
    Applies only to Hyperledger Fabric.
    
    Id — (String)
    The unique identifier of the node.
    
    InstanceType — (String)
    The instance type of the node.
    
    AvailabilityZone — (String)
    The Availability Zone in which the node exists. Required for Ethereum nodes.
    
    FrameworkAttributes — (map)
    Attributes of the blockchain framework being used.
    
    Fabric — (map)
    Attributes of Hyperledger Fabric for a peer node on a Managed Blockchain network that uses Hyperledger Fabric.
    
    PeerEndpoint — (String)
    The endpoint that identifies the peer node for all services except peer channel-based event services.
    
    PeerEventEndpoint — (String)
    The endpoint that identifies the peer node for peer channel-based event services.
    
    Ethereum — (map)
    Attributes of Ethereum for a node on a Managed Blockchain network that uses Ethereum.
    
    HttpEndpoint — (String)
    The endpoint on which the Ethereum node listens to run Ethereum JSON-RPC methods over HTTP connections from a client. Use this endpoint in client code for smart contracts when using an HTTP connection. Connections to this endpoint are authenticated using Signature Version 4.
    
    WebSocketEndpoint — (String)
    The endpoint on which the Ethereum node listens to run Ethereum JSON-RPC methods over WebSockets connections from a client. Use this endpoint in client code for smart contracts when using a WebSockets connection. Connections to this endpoint are authenticated using Signature Version 4.
    
    LogPublishingConfiguration — (map)
    Configuration properties for logging events associated with a peer node on a Hyperledger Fabric network on Managed Blockchain.
    
    Fabric — (map)
    Configuration properties for logging events associated with a node that is owned by a member of a Managed Blockchain network using the Hyperledger Fabric framework.
    
    ChaincodeLogs — (map)
    Configuration properties for logging events associated with chaincode execution on a peer node. Chaincode logs contain the results of instantiating, invoking, and querying the chaincode. A peer can run multiple instances of chaincode. When enabled, a log stream is created for all chaincodes, with an individual log stream for each chaincode.
    
    Cloudwatch — (map)
    Parameters for publishing logs to Amazon CloudWatch Logs.
    
    Enabled — (Boolean)
    Indicates whether logging is enabled.
    
    PeerLogs — (map)
    Configuration properties for a peer node log. Peer node logs contain messages generated when your client submits transaction proposals to peer nodes, requests to join channels, enrolls an admin peer, and lists the chaincode instances on a peer node.
    
    Cloudwatch — (map)
    Parameters for publishing logs to Amazon CloudWatch Logs.
    
    Enabled — (Boolean)
    Indicates whether logging is enabled.
    
    StateDB — (String)
    The state database that the node uses. Values are LevelDB or CouchDB.
    
    Applies only to Hyperledger Fabric.
    Possible values include:
    
    "LevelDB"
    
    "CouchDB"
    
    Status — (String)
    The status of the node.
    
    CREATING - The AWS account is in the process of creating a node.
    
    AVAILABLE - The node has been created and can participate in the network.
    
    UNHEALTHY - The node is impaired and might not function as expected. Amazon Managed Blockchain automatically finds nodes in this state and tries to recover them. If a node is recoverable, it returns to AVAILABLE. Otherwise, it moves to FAILED status.
    
    CREATE_FAILED - The AWS account attempted to create a node and creation failed.
    
    UPDATING - The node is in the process of being updated.
    
    DELETING - The node is in the process of being deleted.
    
    DELETED - The node can no longer participate on the network.
    
    FAILED - The node is no longer functional, cannot be recovered, and must be deleted.
    
    INACCESSIBLE_ENCRYPTION_KEY - The node is impaired and might not function as expected because it cannot access the specified customer managed key in AWS KMS for encryption at rest. Either the KMS key was disabled or deleted, or the grants on the key were revoked.
    
    The effect of disabling or deleting a key, or revoking a grant is not immediate. The node resource might take some time to find that the key is inaccessible. When a resource is in this state, we recommend deleting and recreating the resource.
    
    Possible values include:
    
    "CREATING"
    
    "AVAILABLE"
    
    "UNHEALTHY"
    
    "CREATE_FAILED"
    
    "UPDATING"
    
    "DELETING"
    
    "DELETED"
    
    "FAILED"
    
    "INACCESSIBLE_ENCRYPTION_KEY"
    
    CreationDate — (Date)
    The date and time that the node was created.
    
    Tags — (map<String>)
    Tags assigned to the node. Each tag consists of a key and optional value.
    
    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.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the node. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
    
    KmsKeyArn — (String)
    The Amazon Resource Name (ARN) of the customer managed key in AWS Key Management Service (AWS KMS) that the node uses for encryption at rest. If the value of this parameter is "AWS Owned KMS Key", the node uses an AWS owned KMS key for encryption. The node inherits this parameter from the member that it belongs to.
    
    Applies only to Hyperledger Fabric.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

getProposal(params = {}, callback) ⇒ `AWS.Request`

Returns detailed information about a proposal.

Applies only to Hyperledger Fabric.

Service Reference:

GetProposal

Examples:

Calling the getProposal operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  ProposalId: 'STRING_VALUE' /* required */
};
managedblockchain.getProposal(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network for which the proposal is made.
- ProposalId — (String)
  The unique identifier of the proposal.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Proposal — (map)
    Information about a proposal.
    
    ProposalId — (String)
    The unique identifier of the proposal.
    
    NetworkId — (String)
    The unique identifier of the network for which the proposal is made.
    
    Description — (String)
    The description of the proposal.
    
    Actions — (map)
    The actions to perform on the network if the proposal is APPROVED.
    
    Invitations — (Array<map>)
    The actions to perform for an APPROVED proposal to invite an AWS account to create a member and join the network.
    
    Principal — required — (String)
    The AWS account ID to invite.
    
    Removals — (Array<map>)
    The actions to perform for an APPROVED proposal to remove a member from the network, which deletes the member and all associated member resources from the network.
    
    MemberId — required — (String)
    The unique identifier of the member to remove.
    
    ProposedByMemberId — (String)
    The unique identifier of the member that created the proposal.
    
    ProposedByMemberName — (String)
    The name of the member that created the proposal.
    
    Status — (String)
    The status of the proposal. Values are as follows:
    
    IN_PROGRESS - The proposal is active and open for member voting.
    
    APPROVED - The proposal was approved with sufficient YES votes among members according to the VotingPolicy specified for the Network. The specified proposal actions are carried out.
    
    REJECTED - The proposal was rejected with insufficient YES votes among members according to the VotingPolicy specified for the Network. The specified ProposalActions are not carried out.
    
    EXPIRED - Members did not cast the number of votes required to determine the proposal outcome before the proposal expired. The specified ProposalActions are not carried out.
    
    ACTION_FAILED - One or more of the specified ProposalActions in a proposal that was approved could not be completed because of an error. The ACTION_FAILED status occurs even if only one ProposalAction fails and other actions are successful.
    
    Possible values include:
    
    "IN_PROGRESS"
    
    "APPROVED"
    
    "REJECTED"
    
    "EXPIRED"
    
    "ACTION_FAILED"
    
    CreationDate — (Date)
    The date and time that the proposal was created.
    
    ExpirationDate — (Date)
    The date and time that the proposal expires. This is the CreationDate plus the ProposalDurationInHours that is specified in the ProposalThresholdPolicy. After this date and time, if members have not cast enough votes to determine the outcome according to the voting policy, the proposal is EXPIRED and Actions are not carried out.
    
    YesVoteCount — (Integer)
    The current total of YES votes cast on the proposal by members.
    
    NoVoteCount — (Integer)
    The current total of NO votes cast on the proposal by members.
    
    OutstandingVoteCount — (Integer)
    The number of votes remaining to be cast on the proposal by members. In other words, the number of members minus the sum of YES votes and NO votes.
    
    Tags — (map<String>)
    Tags assigned to the proposal. Each tag consists of a key and optional value.
    
    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.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the proposal. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

listInvitations(params = {}, callback) ⇒ `AWS.Request`

Returns a list of all invitations for the current AWS account.

Applies only to Hyperledger Fabric.

Service Reference:

ListInvitations

Examples:

Calling the listInvitations operation

var params = {
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
managedblockchain.listInvitations(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- MaxResults — (Integer)
  The maximum number of invitations to return.
- NextToken — (String)
  The pagination token that indicates the next set of results to retrieve.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Invitations — (Array<map>)
    The invitations for the network.
    
    InvitationId — (String)
    The unique identifier for the invitation.
    
    CreationDate — (Date)
    The date and time that the invitation was created.
    
    ExpirationDate — (Date)
    The date and time that the invitation expires. This is the CreationDate plus the ProposalDurationInHours that is specified in the ProposalThresholdPolicy. After this date and time, the invitee can no longer create a member and join the network using this InvitationId.
    
    Status — (String)
    The status of the invitation:
    
    PENDING - The invitee has not created a member to join the network, and the invitation has not yet expired.
    
    ACCEPTING - The invitee has begun creating a member, and creation has not yet completed.
    
    ACCEPTED - The invitee created a member and joined the network using the InvitationID.
    
    REJECTED - The invitee rejected the invitation.
    
    EXPIRED - The invitee neither created a member nor rejected the invitation before the ExpirationDate.
    
    Possible values include:
    
    "PENDING"
    
    "ACCEPTED"
    
    "ACCEPTING"
    
    "REJECTED"
    
    "EXPIRED"
    
    NetworkSummary — (map)
    A summary of network configuration properties.
    
    Id — (String)
    The unique identifier of the network.
    
    Name — (String)
    The name of the network.
    
    Description — (String)
    An optional description of the network.
    
    Framework — (String)
    The blockchain framework that the network uses.
    Possible values include:
    
    "HYPERLEDGER_FABRIC"
    
    "ETHEREUM"
    
    FrameworkVersion — (String)
    The version of the blockchain framework that the network uses.
    
    Status — (String)
    The current status of the network.
    Possible values include:
    
    "CREATING"
    
    "AVAILABLE"
    
    "CREATE_FAILED"
    
    "DELETING"
    
    "DELETED"
    
    CreationDate — (Date)
    The date and time that the network was created.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the network. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the invitation. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
  - NextToken — (String)
    The pagination token that indicates the next set of results to retrieve.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

listMembers(params = {}, callback) ⇒ `AWS.Request`

Returns a list of the members in a network and properties of their configurations.

Applies only to Hyperledger Fabric.

Service Reference:

ListMembers

Examples:

Calling the listMembers operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  IsOwned: true || false,
  MaxResults: 'NUMBER_VALUE',
  Name: 'STRING_VALUE',
  NextToken: 'STRING_VALUE',
  Status: CREATING | AVAILABLE | CREATE_FAILED | UPDATING | DELETING | DELETED | INACCESSIBLE_ENCRYPTION_KEY
};
managedblockchain.listMembers(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network for which to list members.
- Name — (String)
  The optional name of the member to list.
- Status — (String)
  An optional status specifier. If provided, only members currently in this status are listed.
  Possible values include:
  - "CREATING"
  - "AVAILABLE"
  - "CREATE_FAILED"
  - "UPDATING"
  - "DELETING"
  - "DELETED"
  - "INACCESSIBLE_ENCRYPTION_KEY"
- IsOwned — (Boolean)
  An optional Boolean value. If provided, the request is limited either to members that the current AWS account owns (true) or that other AWS accounts own (false). If omitted, all members are listed.
- MaxResults — (Integer)
  The maximum number of members to return in the request.
- NextToken — (String)
  The pagination token that indicates the next set of results to retrieve.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Members — (Array<map>)
    An array of MemberSummary objects. Each object contains details about a network member.
    
    Id — (String)
    The unique identifier of the member.
    
    Name — (String)
    The name of the member.
    
    Description — (String)
    An optional description of the member.
    
    Status — (String)
    The status of the member.
    
    CREATING - The AWS account is in the process of creating a member.
    
    AVAILABLE - The member has been created and can participate in the network.
    
    CREATE_FAILED - The AWS account attempted to create a member and creation failed.
    
    UPDATING - The member is in the process of being updated.
    
    DELETING - The member and all associated resources are in the process of being deleted. Either the AWS account that owns the member deleted it, or the member is being deleted as the result of an APPROVED PROPOSAL to remove the member.
    
    DELETED - The member can no longer participate on the network and all associated resources are deleted. Either the AWS account that owns the member deleted it, or the member is being deleted as the result of an APPROVED PROPOSAL to remove the member.
    
    INACCESSIBLE_ENCRYPTION_KEY - The member is impaired and might not function as expected because it cannot access the specified customer managed key in AWS Key Management Service (AWS KMS) for encryption at rest. Either the KMS key was disabled or deleted, or the grants on the key were revoked.
    
    The effect of disabling or deleting a key, or revoking a grant is not immediate. The member resource might take some time to find that the key is inaccessible. When a resource is in this state, we recommend deleting and recreating the resource.
    
    Possible values include:
    
    "CREATING"
    
    "AVAILABLE"
    
    "CREATE_FAILED"
    
    "UPDATING"
    
    "DELETING"
    
    "DELETED"
    
    "INACCESSIBLE_ENCRYPTION_KEY"
    
    CreationDate — (Date)
    The date and time that the member was created.
    
    IsOwned — (Boolean)
    An indicator of whether the member is owned by your AWS account or a different AWS account.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the member. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
  - NextToken — (String)
    The pagination token that indicates the next set of results to retrieve.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

listNetworks(params = {}, callback) ⇒ `AWS.Request`

Returns information about the networks in which the current AWS account participates.

Applies to Hyperledger Fabric and Ethereum.

Service Reference:

ListNetworks

Examples:

Calling the listNetworks operation

var params = {
  Framework: HYPERLEDGER_FABRIC | ETHEREUM,
  MaxResults: 'NUMBER_VALUE',
  Name: 'STRING_VALUE',
  NextToken: 'STRING_VALUE',
  Status: CREATING | AVAILABLE | CREATE_FAILED | DELETING | DELETED
};
managedblockchain.listNetworks(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- Name — (String)
  The name of the network.
- Framework — (String)
  An optional framework specifier. If provided, only networks of this framework type are listed.
  Possible values include:
  - "HYPERLEDGER_FABRIC"
  - "ETHEREUM"
- Status — (String)
  An optional status specifier. If provided, only networks currently in this status are listed.
  
  Applies only to Hyperledger Fabric.
  Possible values include:
  - "CREATING"
  - "AVAILABLE"
  - "CREATE_FAILED"
  - "DELETING"
  - "DELETED"
- MaxResults — (Integer)
  The maximum number of networks to list.
- NextToken — (String)
  The pagination token that indicates the next set of results to retrieve.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Networks — (Array<map>)
    An array of NetworkSummary objects that contain configuration properties for each network.
    
    Id — (String)
    The unique identifier of the network.
    
    Name — (String)
    The name of the network.
    
    Description — (String)
    An optional description of the network.
    
    Framework — (String)
    The blockchain framework that the network uses.
    Possible values include:
    
    "HYPERLEDGER_FABRIC"
    
    "ETHEREUM"
    
    FrameworkVersion — (String)
    The version of the blockchain framework that the network uses.
    
    Status — (String)
    The current status of the network.
    Possible values include:
    
    "CREATING"
    
    "AVAILABLE"
    
    "CREATE_FAILED"
    
    "DELETING"
    
    "DELETED"
    
    CreationDate — (Date)
    The date and time that the network was created.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the network. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
  - NextToken — (String)
    The pagination token that indicates the next set of results to retrieve.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

listNodes(params = {}, callback) ⇒ `AWS.Request`

Returns information about the nodes within a network.

Applies to Hyperledger Fabric and Ethereum.

Service Reference:

ListNodes

Examples:

Calling the listNodes operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  MaxResults: 'NUMBER_VALUE',
  MemberId: 'STRING_VALUE',
  NextToken: 'STRING_VALUE',
  Status: CREATING | AVAILABLE | UNHEALTHY | CREATE_FAILED | UPDATING | DELETING | DELETED | FAILED | INACCESSIBLE_ENCRYPTION_KEY
};
managedblockchain.listNodes(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network for which to list nodes.
- MemberId — (String)
  The unique identifier of the member who owns the nodes to list.
  
  Applies only to Hyperledger Fabric and is required for Hyperledger Fabric.
- Status — (String)
  An optional status specifier. If provided, only nodes currently in this status are listed.
  Possible values include:
  - "CREATING"
  - "AVAILABLE"
  - "UNHEALTHY"
  - "CREATE_FAILED"
  - "UPDATING"
  - "DELETING"
  - "DELETED"
  - "FAILED"
  - "INACCESSIBLE_ENCRYPTION_KEY"
- MaxResults — (Integer)
  The maximum number of nodes to list.
- NextToken — (String)
  The pagination token that indicates the next set of results to retrieve.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Nodes — (Array<map>)
    An array of NodeSummary objects that contain configuration properties for each node.
    
    Id — (String)
    The unique identifier of the node.
    
    Status — (String)
    The status of the node.
    Possible values include:
    
    "CREATING"
    
    "AVAILABLE"
    
    "UNHEALTHY"
    
    "CREATE_FAILED"
    
    "UPDATING"
    
    "DELETING"
    
    "DELETED"
    
    "FAILED"
    
    "INACCESSIBLE_ENCRYPTION_KEY"
    
    CreationDate — (Date)
    The date and time that the node was created.
    
    AvailabilityZone — (String)
    The Availability Zone in which the node exists.
    
    InstanceType — (String)
    The EC2 instance type for the node.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the node. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
  - NextToken — (String)
    The pagination token that indicates the next set of results to retrieve.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

listProposals(params = {}, callback) ⇒ `AWS.Request`

Returns a list of proposals for the network.

Applies only to Hyperledger Fabric.

Service Reference:

ListProposals

Examples:

Calling the listProposals operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
managedblockchain.listProposals(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network.
- MaxResults — (Integer)
  The maximum number of proposals to return.
- NextToken — (String)
  The pagination token that indicates the next set of results to retrieve.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Proposals — (Array<map>)
    The summary of each proposal made on the network.
    
    ProposalId — (String)
    The unique identifier of the proposal.
    
    Description — (String)
    The description of the proposal.
    
    ProposedByMemberId — (String)
    The unique identifier of the member that created the proposal.
    
    ProposedByMemberName — (String)
    The name of the member that created the proposal.
    
    Status — (String)
    The status of the proposal. Values are as follows:
    
    IN_PROGRESS - The proposal is active and open for member voting.
    
    APPROVED - The proposal was approved with sufficient YES votes among members according to the VotingPolicy specified for the Network. The specified proposal actions are carried out.
    
    REJECTED - The proposal was rejected with insufficient YES votes among members according to the VotingPolicy specified for the Network. The specified ProposalActions are not carried out.
    
    EXPIRED - Members did not cast the number of votes required to determine the proposal outcome before the proposal expired. The specified ProposalActions are not carried out.
    
    ACTION_FAILED - One or more of the specified ProposalActions in a proposal that was approved could not be completed because of an error.
    
    Possible values include:
    
    "IN_PROGRESS"
    
    "APPROVED"
    
    "REJECTED"
    
    "EXPIRED"
    
    "ACTION_FAILED"
    
    CreationDate — (Date)
    The date and time that the proposal was created.
    
    ExpirationDate — (Date)
    The date and time that the proposal expires. This is the CreationDate plus the ProposalDurationInHours that is specified in the ProposalThresholdPolicy. After this date and time, if members have not cast enough votes to determine the outcome according to the voting policy, the proposal is EXPIRED and Actions are not carried out.
    
    Arn — (String)
    The Amazon Resource Name (ARN) of the proposal. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
  - NextToken — (String)
    The pagination token that indicates the next set of results to retrieve.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

listProposalVotes(params = {}, callback) ⇒ `AWS.Request`

Returns the list of votes for a specified proposal, including the value of each vote and the unique identifier of the member that cast the vote.

Applies only to Hyperledger Fabric.

Service Reference:

ListProposalVotes

Examples:

Calling the listProposalVotes operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  ProposalId: 'STRING_VALUE', /* required */
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
managedblockchain.listProposalVotes(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network.
- ProposalId — (String)
  The unique identifier of the proposal.
- MaxResults — (Integer)
  The maximum number of votes to return.
- NextToken — (String)
  The pagination token that indicates the next set of results to retrieve.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - ProposalVotes — (Array<map>)
    The list of votes.
    
    Vote — (String)
    The vote value, either YES or NO.
    Possible values include:
    
    "YES"
    
    "NO"
    
    MemberName — (String)
    The name of the member that cast the vote.
    
    MemberId — (String)
    The unique identifier of the member that cast the vote.
  - NextToken — (String)
    The pagination token that indicates the next set of results to retrieve.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

listTagsForResource(params = {}, callback) ⇒ `AWS.Request`

Returns a list of tags for the specified resource. Each tag consists of a key and optional value.

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.

Service Reference:

ListTagsForResource

Examples:

Calling the listTagsForResource operation

var params = {
  ResourceArn: 'STRING_VALUE' /* required */
};
managedblockchain.listTagsForResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- ResourceArn — (String)
  The Amazon Resource Name (ARN) of the resource. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:
  - Tags — (map<String>)
    The tags assigned to the resource.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

rejectInvitation(params = {}, callback) ⇒ `AWS.Request`

Rejects an invitation to join a network. This action can be called by a principal in an AWS account that has received an invitation to create a member and join a network.

Applies only to Hyperledger Fabric.

Service Reference:

RejectInvitation

Examples:

Calling the rejectInvitation operation

var params = {
  InvitationId: 'STRING_VALUE' /* required */
};
managedblockchain.rejectInvitation(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- InvitationId — (String)
  The unique identifier of the invitation to reject.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

tagResource(params = {}, callback) ⇒ `AWS.Request`

Adds or overwrites the specified tags for the specified Amazon Managed Blockchain resource. Each tag consists of a key and optional value.

When you specify a tag key that already exists, the tag value is overwritten with the new value. Use UntagResource to remove tag keys.

A resource can have up to 50 tags. If you try to create more than 50 tags for a resource, your request fails and returns an error.

Service Reference:

TagResource

Examples:

Calling the tagResource operation

var params = {
  ResourceArn: 'STRING_VALUE', /* required */
  Tags: { /* required */
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
managedblockchain.tagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- ResourceArn — (String)
  The Amazon Resource Name (ARN) of the resource. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
- Tags — (map<String>)
  The tags to assign to the specified resource. Tag values can be empty, for example, "MyTagKey" : "". You can specify multiple key-value pairs in a single request, with an overall maximum of 50 tags added to each resource.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

untagResource(params = {}, callback) ⇒ `AWS.Request`

Removes the specified tags from the Amazon Managed Blockchain resource.

Service Reference:

UntagResource

Examples:

Calling the untagResource operation

var params = {
  ResourceArn: 'STRING_VALUE', /* required */
  TagKeys: [ /* required */
    'STRING_VALUE',
    /* more items */
  ]
};
managedblockchain.untagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- ResourceArn — (String)
  The Amazon Resource Name (ARN) of the resource. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the AWS General Reference.
- TagKeys — (Array<String>)
  The tag keys.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

updateMember(params = {}, callback) ⇒ `AWS.Request`

Updates a member configuration with new parameters.

Applies only to Hyperledger Fabric.

Service Reference:

UpdateMember

Examples:

Calling the updateMember operation

var params = {
  MemberId: 'STRING_VALUE', /* required */
  NetworkId: 'STRING_VALUE', /* required */
  LogPublishingConfiguration: {
    Fabric: {
      CaLogs: {
        Cloudwatch: {
          Enabled: true || false
        }
      }
    }
  }
};
managedblockchain.updateMember(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the Managed Blockchain network to which the member belongs.
- MemberId — (String)
  The unique identifier of the member.
- LogPublishingConfiguration — (map)
  Configuration properties for publishing to Amazon CloudWatch Logs.
  - Fabric — (map)
    Configuration properties for logging events associated with a member of a Managed Blockchain network using the Hyperledger Fabric framework.
    - CaLogs — (map)
      Configuration properties for logging events associated with a member's Certificate Authority (CA). CA logs help you determine when a member in your account joins the network, or when new peers register with a member CA.
      
      Cloudwatch — (map)
      Parameters for publishing logs to Amazon CloudWatch Logs.
      
      Enabled — (Boolean)
      Indicates whether logging is enabled.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

updateNode(params = {}, callback) ⇒ `AWS.Request`

Updates a node configuration with new parameters.

Applies only to Hyperledger Fabric.

Service Reference:

UpdateNode

Examples:

Calling the updateNode operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  NodeId: 'STRING_VALUE', /* required */
  LogPublishingConfiguration: {
    Fabric: {
      ChaincodeLogs: {
        Cloudwatch: {
          Enabled: true || false
        }
      },
      PeerLogs: {
        Cloudwatch: {
          Enabled: true || false
        }
      }
    }
  },
  MemberId: 'STRING_VALUE'
};
managedblockchain.updateNode(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network that the node is on.
- MemberId — (String)
  The unique identifier of the member that owns the node.
  
  Applies only to Hyperledger Fabric.
- NodeId — (String)
  The unique identifier of the node.
- LogPublishingConfiguration — (map)
  Configuration properties for publishing to Amazon CloudWatch Logs.
  - Fabric — (map)
    Configuration properties for logging events associated with a node that is owned by a member of a Managed Blockchain network using the Hyperledger Fabric framework.
    - ChaincodeLogs — (map)
      Configuration properties for logging events associated with chaincode execution on a peer node. Chaincode logs contain the results of instantiating, invoking, and querying the chaincode. A peer can run multiple instances of chaincode. When enabled, a log stream is created for all chaincodes, with an individual log stream for each chaincode.
      
      Cloudwatch — (map)
      Parameters for publishing logs to Amazon CloudWatch Logs.
      
      Enabled — (Boolean)
      Indicates whether logging is enabled.
    - PeerLogs — (map)
      Configuration properties for a peer node log. Peer node logs contain messages generated when your client submits transaction proposals to peer nodes, requests to join channels, enrolls an admin peer, and lists the chaincode instances on a peer node.
      
      Cloudwatch — (map)
      Parameters for publishing logs to Amazon CloudWatch Logs.
      
      Enabled — (Boolean)
      Indicates whether logging is enabled.

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

voteOnProposal(params = {}, callback) ⇒ `AWS.Request`

Casts a vote for a specified ProposalId on behalf of a member. The member to vote as, specified by VoterMemberId, must be in the same AWS account as the principal that calls the action.

Applies only to Hyperledger Fabric.

Service Reference:

VoteOnProposal

Examples:

Calling the voteOnProposal operation

var params = {
  NetworkId: 'STRING_VALUE', /* required */
  ProposalId: 'STRING_VALUE', /* required */
  Vote: YES | NO, /* required */
  VoterMemberId: 'STRING_VALUE' /* required */
};
managedblockchain.voteOnProposal(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

params (Object) (defaults to: {}) —
- NetworkId — (String)
  The unique identifier of the network.
- ProposalId — (String)
  The unique identifier of the proposal.
- VoterMemberId — (String)
  The unique identifier of the member casting the vote.
- Vote — (String)
  The value of the vote.
  Possible values include:
  - "YES"
  - "NO"

Callback (callback):

function(err, data) { ... }

Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
- (AWS.Response) —
  the response object containing error, data properties, and the original request object.
Parameters:
- err (Error) —
  the error object returned from the request. Set to null if the request is successful.
- data (Object) —
  the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

(AWS.Request) —
a handle to the operation request for subsequent event callback registration.

Class: AWS.ManagedBlockchain

Overview

Service Description

Sending a Request Using ManagedBlockchain

Locking the API Version

Constructor Summary collapse

Property Summary collapse

Properties inherited from AWS.Service

Method Summary collapse

Methods inherited from AWS.Service

Constructor Details

new AWS.ManagedBlockchain(options = {}) ⇒ Object

Property Details

endpoint ⇒ AWS.Endpoint (readwrite)

Method Details

createMember(params = {}, callback) ⇒ AWS.Request

createNetwork(params = {}, callback) ⇒ AWS.Request

createNode(params = {}, callback) ⇒ AWS.Request

createProposal(params = {}, callback) ⇒ AWS.Request

deleteMember(params = {}, callback) ⇒ AWS.Request

deleteNode(params = {}, callback) ⇒ AWS.Request

getMember(params = {}, callback) ⇒ AWS.Request

getNetwork(params = {}, callback) ⇒ AWS.Request

getNode(params = {}, callback) ⇒ AWS.Request

getProposal(params = {}, callback) ⇒ AWS.Request

listInvitations(params = {}, callback) ⇒ AWS.Request

listMembers(params = {}, callback) ⇒ AWS.Request

listNetworks(params = {}, callback) ⇒ AWS.Request

listNodes(params = {}, callback) ⇒ AWS.Request

listProposals(params = {}, callback) ⇒ AWS.Request

listProposalVotes(params = {}, callback) ⇒ AWS.Request

listTagsForResource(params = {}, callback) ⇒ AWS.Request

rejectInvitation(params = {}, callback) ⇒ AWS.Request

tagResource(params = {}, callback) ⇒ AWS.Request

untagResource(params = {}, callback) ⇒ AWS.Request

updateMember(params = {}, callback) ⇒ AWS.Request

updateNode(params = {}, callback) ⇒ AWS.Request

voteOnProposal(params = {}, callback) ⇒ AWS.Request

new AWS.ManagedBlockchain(options = {}) ⇒ `Object`

endpoint ⇒ `AWS.Endpoint` (readwrite)

createMember(params = {}, callback) ⇒ `AWS.Request`

createNetwork(params = {}, callback) ⇒ `AWS.Request`

createNode(params = {}, callback) ⇒ `AWS.Request`

createProposal(params = {}, callback) ⇒ `AWS.Request`

deleteMember(params = {}, callback) ⇒ `AWS.Request`

deleteNode(params = {}, callback) ⇒ `AWS.Request`

getMember(params = {}, callback) ⇒ `AWS.Request`

getNetwork(params = {}, callback) ⇒ `AWS.Request`

getNode(params = {}, callback) ⇒ `AWS.Request`

getProposal(params = {}, callback) ⇒ `AWS.Request`

listInvitations(params = {}, callback) ⇒ `AWS.Request`

listMembers(params = {}, callback) ⇒ `AWS.Request`

listNetworks(params = {}, callback) ⇒ `AWS.Request`

listNodes(params = {}, callback) ⇒ `AWS.Request`

listProposals(params = {}, callback) ⇒ `AWS.Request`

listProposalVotes(params = {}, callback) ⇒ `AWS.Request`

listTagsForResource(params = {}, callback) ⇒ `AWS.Request`

rejectInvitation(params = {}, callback) ⇒ `AWS.Request`

tagResource(params = {}, callback) ⇒ `AWS.Request`

untagResource(params = {}, callback) ⇒ `AWS.Request`

updateMember(params = {}, callback) ⇒ `AWS.Request`

updateNode(params = {}, callback) ⇒ `AWS.Request`

voteOnProposal(params = {}, callback) ⇒ `AWS.Request`