amazonka-managedblockchain-2.0: Amazon Managed Blockchain SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.ManagedBlockChain.Lens

Description

 
Synopsis

Operations

CreateAccessor

createAccessor_clientRequestToken :: Lens' CreateAccessor Text Source #

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

createAccessor_accessorType :: Lens' CreateAccessor AccessorType Source #

The type of accessor.

Currently accessor type is restricted to BILLING_TOKEN.

createAccessorResponse_billingToken :: Lens' CreateAccessorResponse (Maybe Text) Source #

The billing token is a property of the Accessor. Use this token to make Ethereum API calls to your Ethereum node. The billing token is used to track your accessor object for billing Ethereum API requests made to your Ethereum nodes.

CreateMember

createMember_clientRequestToken :: Lens' CreateMember Text Source #

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 Amazon Web Services SDK or the CLI.

createMember_invitationId :: Lens' CreateMember Text Source #

The unique identifier of the invitation that is sent to the member to join the network.

createMember_networkId :: Lens' CreateMember Text Source #

The unique identifier of the network in which the member is created.

createMemberResponse_memberId :: Lens' CreateMemberResponse (Maybe Text) Source #

The unique identifier of the member.

CreateNetwork

createNetwork_description :: Lens' CreateNetwork (Maybe Text) Source #

An optional description for the network.

createNetwork_frameworkConfiguration :: Lens' CreateNetwork (Maybe NetworkFrameworkConfiguration) Source #

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

createNetwork_tags :: Lens' CreateNetwork (Maybe (HashMap Text Text)) Source #

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.

createNetwork_clientRequestToken :: Lens' CreateNetwork Text Source #

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

createNetwork_name :: Lens' CreateNetwork Text Source #

The name of the network.

createNetwork_framework :: Lens' CreateNetwork Framework Source #

The blockchain framework that the network uses.

createNetwork_frameworkVersion :: Lens' CreateNetwork Text Source #

The version of the blockchain framework that the network uses.

createNetwork_votingPolicy :: Lens' CreateNetwork VotingPolicy Source #

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

createNetwork_memberConfiguration :: Lens' CreateNetwork MemberConfiguration Source #

Configuration properties for the first member within the network.

createNetworkResponse_memberId :: Lens' CreateNetworkResponse (Maybe Text) Source #

The unique identifier for the first member within the network.

createNetworkResponse_networkId :: Lens' CreateNetworkResponse (Maybe Text) Source #

The unique identifier for the network.

CreateNode

createNode_memberId :: Lens' CreateNode (Maybe Text) Source #

The unique identifier of the member that owns this node.

Applies only to Hyperledger Fabric.

createNode_tags :: Lens' CreateNode (Maybe (HashMap Text Text)) Source #

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.

createNode_clientRequestToken :: Lens' CreateNode Text Source #

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 Amazon Web Services SDK or the CLI.

createNode_networkId :: Lens' CreateNode Text Source #

The unique identifier of the network for the node.

Ethereum public networks have the following NetworkIds:

  • n-ethereum-mainnet
  • n-ethereum-goerli
  • n-ethereum-rinkeby
  • n-ethereum-ropsten

createNode_nodeConfiguration :: Lens' CreateNode NodeConfiguration Source #

The properties of a node configuration.

createNodeResponse_nodeId :: Lens' CreateNodeResponse (Maybe Text) Source #

The unique identifier of the node.

CreateProposal

createProposal_description :: Lens' CreateProposal (Maybe Text) Source #

A description for the proposal that is visible to voting members, for example, "Proposal to add Example Corp. as member."

createProposal_tags :: Lens' CreateProposal (Maybe (HashMap Text Text)) Source #

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.

createProposal_clientRequestToken :: Lens' CreateProposal Text Source #

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 Amazon Web Services SDK or the CLI.

createProposal_networkId :: Lens' CreateProposal Text Source #

The unique identifier of the network for which the proposal is made.

createProposal_memberId :: Lens' CreateProposal Text Source #

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 Amazon Web Services account.

createProposal_actions :: Lens' CreateProposal ProposalActions Source #

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.

DeleteAccessor

deleteAccessor_accessorId :: Lens' DeleteAccessor Text Source #

The unique identifier of the accessor.

DeleteMember

deleteMember_networkId :: Lens' DeleteMember Text Source #

The unique identifier of the network from which the member is removed.

deleteMember_memberId :: Lens' DeleteMember Text Source #

The unique identifier of the member to remove.

DeleteNode

deleteNode_memberId :: Lens' DeleteNode (Maybe Text) Source #

The unique identifier of the member that owns this node.

Applies only to Hyperledger Fabric and is required for Hyperledger Fabric.

deleteNode_networkId :: Lens' DeleteNode Text Source #

The unique identifier of the network that the node is on.

Ethereum public networks have the following NetworkIds:

  • n-ethereum-mainnet
  • n-ethereum-goerli
  • n-ethereum-rinkeby
  • n-ethereum-ropsten

deleteNode_nodeId :: Lens' DeleteNode Text Source #

The unique identifier of the node.

GetAccessor

getAccessor_accessorId :: Lens' GetAccessor Text Source #

The unique identifier of the accessor.

GetMember

getMember_networkId :: Lens' GetMember Text Source #

The unique identifier of the network to which the member belongs.

getMember_memberId :: Lens' GetMember Text Source #

The unique identifier of the member.

getMemberResponse_httpStatus :: Lens' GetMemberResponse Int Source #

The response's http status code.

GetNetwork

getNetwork_networkId :: Lens' GetNetwork Text Source #

The unique identifier of the network to get information about.

getNetworkResponse_network :: Lens' GetNetworkResponse (Maybe Network) Source #

An object containing network configuration parameters.

GetNode

getNode_memberId :: Lens' GetNode (Maybe Text) Source #

The unique identifier of the member that owns the node.

Applies only to Hyperledger Fabric and is required for Hyperledger Fabric.

getNode_networkId :: Lens' GetNode Text Source #

The unique identifier of the network that the node is on.

getNode_nodeId :: Lens' GetNode Text Source #

The unique identifier of the node.

getNodeResponse_node :: Lens' GetNodeResponse (Maybe Node) Source #

Properties of the node configuration.

getNodeResponse_httpStatus :: Lens' GetNodeResponse Int Source #

The response's http status code.

GetProposal

getProposal_networkId :: Lens' GetProposal Text Source #

The unique identifier of the network for which the proposal is made.

getProposal_proposalId :: Lens' GetProposal Text Source #

The unique identifier of the proposal.

ListAccessors

listAccessors_maxResults :: Lens' ListAccessors (Maybe Natural) Source #

The maximum number of accessors to list.

listAccessors_nextToken :: Lens' ListAccessors (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listAccessorsResponse_accessors :: Lens' ListAccessorsResponse (Maybe [AccessorSummary]) Source #

An array of AccessorSummary objects that contain configuration properties for each accessor.

listAccessorsResponse_nextToken :: Lens' ListAccessorsResponse (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

ListInvitations

listInvitations_maxResults :: Lens' ListInvitations (Maybe Natural) Source #

The maximum number of invitations to return.

listInvitations_nextToken :: Lens' ListInvitations (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listInvitationsResponse_nextToken :: Lens' ListInvitationsResponse (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

ListMembers

listMembers_isOwned :: Lens' ListMembers (Maybe Bool) Source #

An optional Boolean value. If provided, the request is limited either to members that the current Amazon Web Services account owns (true) or that other Amazon Web Services accountsn own (false). If omitted, all members are listed.

listMembers_maxResults :: Lens' ListMembers (Maybe Natural) Source #

The maximum number of members to return in the request.

listMembers_name :: Lens' ListMembers (Maybe Text) Source #

The optional name of the member to list.

listMembers_nextToken :: Lens' ListMembers (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listMembers_status :: Lens' ListMembers (Maybe MemberStatus) Source #

An optional status specifier. If provided, only members currently in this status are listed.

listMembers_networkId :: Lens' ListMembers Text Source #

The unique identifier of the network for which to list members.

listMembersResponse_members :: Lens' ListMembersResponse (Maybe [MemberSummary]) Source #

An array of MemberSummary objects. Each object contains details about a network member.

listMembersResponse_nextToken :: Lens' ListMembersResponse (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

ListNetworks

listNetworks_framework :: Lens' ListNetworks (Maybe Framework) Source #

An optional framework specifier. If provided, only networks of this framework type are listed.

listNetworks_maxResults :: Lens' ListNetworks (Maybe Natural) Source #

The maximum number of networks to list.

listNetworks_name :: Lens' ListNetworks (Maybe Text) Source #

The name of the network.

listNetworks_nextToken :: Lens' ListNetworks (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listNetworks_status :: Lens' ListNetworks (Maybe NetworkStatus) Source #

An optional status specifier. If provided, only networks currently in this status are listed.

Applies only to Hyperledger Fabric.

listNetworksResponse_networks :: Lens' ListNetworksResponse (Maybe [NetworkSummary]) Source #

An array of NetworkSummary objects that contain configuration properties for each network.

listNetworksResponse_nextToken :: Lens' ListNetworksResponse (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

ListNodes

listNodes_maxResults :: Lens' ListNodes (Maybe Natural) Source #

The maximum number of nodes to list.

listNodes_memberId :: Lens' ListNodes (Maybe Text) Source #

The unique identifier of the member who owns the nodes to list.

Applies only to Hyperledger Fabric and is required for Hyperledger Fabric.

listNodes_nextToken :: Lens' ListNodes (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listNodes_status :: Lens' ListNodes (Maybe NodeStatus) Source #

An optional status specifier. If provided, only nodes currently in this status are listed.

listNodes_networkId :: Lens' ListNodes Text Source #

The unique identifier of the network for which to list nodes.

listNodesResponse_nextToken :: Lens' ListNodesResponse (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listNodesResponse_nodes :: Lens' ListNodesResponse (Maybe [NodeSummary]) Source #

An array of NodeSummary objects that contain configuration properties for each node.

listNodesResponse_httpStatus :: Lens' ListNodesResponse Int Source #

The response's http status code.

ListProposalVotes

listProposalVotes_maxResults :: Lens' ListProposalVotes (Maybe Natural) Source #

The maximum number of votes to return.

listProposalVotes_nextToken :: Lens' ListProposalVotes (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listProposalVotes_networkId :: Lens' ListProposalVotes Text Source #

The unique identifier of the network.

listProposalVotes_proposalId :: Lens' ListProposalVotes Text Source #

The unique identifier of the proposal.

listProposalVotesResponse_nextToken :: Lens' ListProposalVotesResponse (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

ListProposals

listProposals_maxResults :: Lens' ListProposals (Maybe Natural) Source #

The maximum number of proposals to return.

listProposals_nextToken :: Lens' ListProposals (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listProposals_networkId :: Lens' ListProposals Text Source #

The unique identifier of the network.

listProposalsResponse_nextToken :: Lens' ListProposalsResponse (Maybe Text) Source #

The pagination token that indicates the next set of results to retrieve.

listProposalsResponse_proposals :: Lens' ListProposalsResponse (Maybe [ProposalSummary]) Source #

The summary of each proposal made on the network.

ListTagsForResource

listTagsForResource_resourceArn :: Lens' ListTagsForResource Text Source #

The Amazon Resource Name (ARN) of the resource. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

RejectInvitation

rejectInvitation_invitationId :: Lens' RejectInvitation Text Source #

The unique identifier of the invitation to reject.

TagResource

tagResource_resourceArn :: Lens' TagResource Text Source #

The Amazon Resource Name (ARN) of the resource. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

tagResource_tags :: Lens' TagResource (HashMap Text Text) Source #

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.

UntagResource

untagResource_resourceArn :: Lens' UntagResource Text Source #

The Amazon Resource Name (ARN) of the resource. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

UpdateMember

updateMember_logPublishingConfiguration :: Lens' UpdateMember (Maybe MemberLogPublishingConfiguration) Source #

Configuration properties for publishing to Amazon CloudWatch Logs.

updateMember_networkId :: Lens' UpdateMember Text Source #

The unique identifier of the Managed Blockchain network to which the member belongs.

updateMember_memberId :: Lens' UpdateMember Text Source #

The unique identifier of the member.

UpdateNode

updateNode_logPublishingConfiguration :: Lens' UpdateNode (Maybe NodeLogPublishingConfiguration) Source #

Configuration properties for publishing to Amazon CloudWatch Logs.

updateNode_memberId :: Lens' UpdateNode (Maybe Text) Source #

The unique identifier of the member that owns the node.

Applies only to Hyperledger Fabric.

updateNode_networkId :: Lens' UpdateNode Text Source #

The unique identifier of the network that the node is on.

updateNode_nodeId :: Lens' UpdateNode Text Source #

The unique identifier of the node.

VoteOnProposal

voteOnProposal_networkId :: Lens' VoteOnProposal Text Source #

The unique identifier of the network.

voteOnProposal_proposalId :: Lens' VoteOnProposal Text Source #

The unique identifier of the proposal.

voteOnProposal_voterMemberId :: Lens' VoteOnProposal Text Source #

The unique identifier of the member casting the vote.

Types

Accessor

accessor_arn :: Lens' Accessor (Maybe Text) Source #

The Amazon Resource Name (ARN) of the accessor. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

accessor_billingToken :: Lens' Accessor (Maybe Text) Source #

The billing token is a property of the accessor. Use this token to make Ethereum API calls to your Ethereum node. The billing token is used to track your accessor object for billing Ethereum API requests made to your Ethereum nodes.

accessor_creationDate :: Lens' Accessor (Maybe UTCTime) Source #

The creation date and time of the accessor.

accessor_id :: Lens' Accessor (Maybe Text) Source #

The unique identifier of the accessor.

accessor_status :: Lens' Accessor (Maybe AccessorStatus) Source #

The current status of the accessor.

accessor_type :: Lens' Accessor (Maybe AccessorType) Source #

The type of the accessor.

Currently accessor type is restricted to BILLING_TOKEN.

AccessorSummary

accessorSummary_arn :: Lens' AccessorSummary (Maybe Text) Source #

The Amazon Resource Name (ARN) of the accessor. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

accessorSummary_creationDate :: Lens' AccessorSummary (Maybe UTCTime) Source #

The creation date and time of the accessor.

accessorSummary_id :: Lens' AccessorSummary (Maybe Text) Source #

The unique identifier of the accessor.

accessorSummary_status :: Lens' AccessorSummary (Maybe AccessorStatus) Source #

The current status of the accessor.

accessorSummary_type :: Lens' AccessorSummary (Maybe AccessorType) Source #

The type of the accessor.

Currently accessor type is restricted to BILLING_TOKEN.

ApprovalThresholdPolicy

approvalThresholdPolicy_proposalDurationInHours :: Lens' ApprovalThresholdPolicy (Maybe Natural) Source #

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 aren't carried out.

approvalThresholdPolicy_thresholdComparator :: Lens' ApprovalThresholdPolicy (Maybe ThresholdComparator) Source #

Determines whether the vote percentage must be greater than the ThresholdPercentage or must be greater than or equal to the ThreholdPercentage to be approved.

approvalThresholdPolicy_thresholdPercentage :: Lens' ApprovalThresholdPolicy (Maybe Natural) Source #

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.

Invitation

invitation_arn :: Lens' Invitation (Maybe Text) Source #

The Amazon Resource Name (ARN) of the invitation. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

invitation_creationDate :: Lens' Invitation (Maybe UTCTime) Source #

The date and time that the invitation was created.

invitation_expirationDate :: Lens' Invitation (Maybe UTCTime) Source #

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.

invitation_invitationId :: Lens' Invitation (Maybe Text) Source #

The unique identifier for the invitation.

invitation_status :: Lens' Invitation (Maybe InvitationStatus) Source #

The status of the invitation:

  • PENDING - The invitee hasn't created a member to join the network, and the invitation hasn't yet expired.
  • ACCEPTING - The invitee has begun creating a member, and creation hasn't 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.

InviteAction

inviteAction_principal :: Lens' InviteAction Text Source #

The Amazon Web Services account ID to invite.

LogConfiguration

logConfiguration_enabled :: Lens' LogConfiguration (Maybe Bool) Source #

Indicates whether logging is enabled.

LogConfigurations

logConfigurations_cloudwatch :: Lens' LogConfigurations (Maybe LogConfiguration) Source #

Parameters for publishing logs to Amazon CloudWatch Logs.

Member

member_arn :: Lens' Member (Maybe Text) Source #

The Amazon Resource Name (ARN) of the member. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

member_creationDate :: Lens' Member (Maybe UTCTime) Source #

The date and time that the member was created.

member_description :: Lens' Member (Maybe Text) Source #

An optional description for the member.

member_frameworkAttributes :: Lens' Member (Maybe MemberFrameworkAttributes) Source #

Attributes relevant to a member for the blockchain framework that the Managed Blockchain network uses.

member_id :: Lens' Member (Maybe Text) Source #

The unique identifier of the member.

member_kmsKeyArn :: Lens' Member (Maybe Text) Source #

The Amazon Resource Name (ARN) of the customer managed key in Key Management Service (KMS) that the member uses for encryption at rest. If the value of this parameter is "AWS Owned KMS Key", the member uses an Amazon Web Services owned KMS key for encryption. This parameter is inherited by the nodes that this member owns.

For more information, see Encryption at Rest in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.

member_logPublishingConfiguration :: Lens' Member (Maybe MemberLogPublishingConfiguration) Source #

Configuration properties for logging events associated with a member.

member_name :: Lens' Member (Maybe Text) Source #

The name of the member.

member_networkId :: Lens' Member (Maybe Text) Source #

The unique identifier of the network to which the member belongs.

member_status :: Lens' Member (Maybe MemberStatus) Source #

The status of a member.

  • CREATING - The Amazon Web Services account is in the process of creating a member.
  • AVAILABLE - The member has been created and can participate in the network.
  • CREATE_FAILED - The Amazon Web Services 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 Amazon Web Services 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 Amazon Web Services 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 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 of revoking a grant isn't immediate. It might take some time for the member resource to discover that the key is inaccessible. When a resource is in this state, we recommend deleting and recreating the resource.

member_tags :: Lens' Member (Maybe (HashMap Text Text)) Source #

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.

MemberConfiguration

memberConfiguration_description :: Lens' MemberConfiguration (Maybe Text) Source #

An optional description of the member.

memberConfiguration_kmsKeyArn :: Lens' MemberConfiguration (Maybe Text) Source #

The Amazon Resource Name (ARN) of the customer managed key in Key Management Service (KMS) to use for encryption at rest in the member. This parameter is inherited by any nodes that this member creates. For more information, see Encryption at Rest in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.

Use one of the following options to specify this parameter:

  • Undefined or empty string - By default, use an KMS key that is owned and managed by Amazon Web Services on your behalf.
  • A valid symmetric customer managed KMS key - Use the specified KMS key in your account that you create, own, and manage.

    Amazon Managed Blockchain doesn't support asymmetric keys. For more information, see Using symmetric and asymmetric keys in the 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

memberConfiguration_logPublishingConfiguration :: Lens' MemberConfiguration (Maybe MemberLogPublishingConfiguration) Source #

Configuration properties for logging events associated with a member of a Managed Blockchain network.

memberConfiguration_tags :: Lens' MemberConfiguration (Maybe (HashMap Text Text)) Source #

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.

memberConfiguration_frameworkConfiguration :: Lens' MemberConfiguration MemberFrameworkConfiguration Source #

Configuration properties of the blockchain framework relevant to the member.

MemberFabricAttributes

memberFabricAttributes_adminUsername :: Lens' MemberFabricAttributes (Maybe Text) Source #

The user name for the initial administrator user for the member.

memberFabricAttributes_caEndpoint :: Lens' MemberFabricAttributes (Maybe Text) Source #

The endpoint used to access the member's certificate authority.

MemberFabricConfiguration

memberFabricConfiguration_adminUsername :: Lens' MemberFabricConfiguration Text Source #

The user name for the member's initial administrative user.

memberFabricConfiguration_adminPassword :: Lens' MemberFabricConfiguration Text Source #

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.

MemberFabricLogPublishingConfiguration

memberFabricLogPublishingConfiguration_caLogs :: Lens' MemberFabricLogPublishingConfiguration (Maybe LogConfigurations) Source #

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.

MemberFrameworkAttributes

memberFrameworkAttributes_fabric :: Lens' MemberFrameworkAttributes (Maybe MemberFabricAttributes) Source #

Attributes of Hyperledger Fabric relevant to a member on a Managed Blockchain network that uses Hyperledger Fabric.

MemberFrameworkConfiguration

memberFrameworkConfiguration_fabric :: Lens' MemberFrameworkConfiguration (Maybe MemberFabricConfiguration) Source #

Attributes of Hyperledger Fabric for a member on a Managed Blockchain network that uses Hyperledger Fabric.

MemberLogPublishingConfiguration

memberLogPublishingConfiguration_fabric :: Lens' MemberLogPublishingConfiguration (Maybe MemberFabricLogPublishingConfiguration) Source #

Configuration properties for logging events associated with a member of a Managed Blockchain network using the Hyperledger Fabric framework.

MemberSummary

memberSummary_arn :: Lens' MemberSummary (Maybe Text) Source #

The Amazon Resource Name (ARN) of the member. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

memberSummary_creationDate :: Lens' MemberSummary (Maybe UTCTime) Source #

The date and time that the member was created.

memberSummary_description :: Lens' MemberSummary (Maybe Text) Source #

An optional description of the member.

memberSummary_id :: Lens' MemberSummary (Maybe Text) Source #

The unique identifier of the member.

memberSummary_isOwned :: Lens' MemberSummary (Maybe Bool) Source #

An indicator of whether the member is owned by your Amazon Web Services account or a different Amazon Web Services account.

memberSummary_status :: Lens' MemberSummary (Maybe MemberStatus) Source #

The status of the member.

  • CREATING - The Amazon Web Services account is in the process of creating a member.
  • AVAILABLE - The member has been created and can participate in the network.
  • CREATE_FAILED - The Amazon Web Services 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 Amazon Web Services 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 Amazon Web Services 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 Key Management Service (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 of revoking a grant isn't immediate. It might take some time for the member resource to discover that the key is inaccessible. When a resource is in this state, we recommend deleting and recreating the resource.

Network

network_arn :: Lens' Network (Maybe Text) Source #

The Amazon Resource Name (ARN) of the network. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

network_creationDate :: Lens' Network (Maybe UTCTime) Source #

The date and time that the network was created.

network_description :: Lens' Network (Maybe Text) Source #

Attributes of the blockchain framework for the network.

network_framework :: Lens' Network (Maybe Framework) Source #

The blockchain framework that the network uses.

network_frameworkAttributes :: Lens' Network (Maybe NetworkFrameworkAttributes) Source #

Attributes of the blockchain framework that the network uses.

network_frameworkVersion :: Lens' Network (Maybe Text) Source #

The version of the blockchain framework that the network uses.

network_id :: Lens' Network (Maybe Text) Source #

The unique identifier of the network.

network_name :: Lens' Network (Maybe Text) Source #

The name of the network.

network_status :: Lens' Network (Maybe NetworkStatus) Source #

The current status of the network.

network_tags :: Lens' Network (Maybe (HashMap Text Text)) Source #

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.

network_votingPolicy :: Lens' Network (Maybe VotingPolicy) Source #

The voting rules for the network to decide if a proposal is accepted.

network_vpcEndpointServiceName :: Lens' Network (Maybe Text) Source #

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.

NetworkEthereumAttributes

networkEthereumAttributes_chainId :: Lens' NetworkEthereumAttributes (Maybe Text) Source #

The Ethereum CHAIN_ID associated with the Ethereum network. Chain IDs are as follows:

  • mainnet = 1
  • goerli = 5
  • rinkeby = 4
  • ropsten = 3

NetworkFabricAttributes

networkFabricAttributes_edition :: Lens' NetworkFabricAttributes (Maybe Edition) Source #

The edition of Amazon Managed Blockchain that Hyperledger Fabric uses. For more information, see Amazon Managed Blockchain Pricing.

networkFabricAttributes_orderingServiceEndpoint :: Lens' NetworkFabricAttributes (Maybe Text) Source #

The endpoint of the ordering service for the network.

NetworkFabricConfiguration

networkFabricConfiguration_edition :: Lens' NetworkFabricConfiguration Edition Source #

The edition of Amazon Managed Blockchain that the network uses. For more information, see Amazon Managed Blockchain Pricing.

NetworkFrameworkAttributes

networkFrameworkAttributes_ethereum :: Lens' NetworkFrameworkAttributes (Maybe NetworkEthereumAttributes) Source #

Attributes of an Ethereum network for Managed Blockchain resources participating in an Ethereum network.

networkFrameworkAttributes_fabric :: Lens' NetworkFrameworkAttributes (Maybe NetworkFabricAttributes) Source #

Attributes of Hyperledger Fabric for a Managed Blockchain network that uses Hyperledger Fabric.

NetworkFrameworkConfiguration

networkFrameworkConfiguration_fabric :: Lens' NetworkFrameworkConfiguration (Maybe NetworkFabricConfiguration) Source #

Hyperledger Fabric configuration properties for a Managed Blockchain network that uses Hyperledger Fabric.

NetworkSummary

networkSummary_arn :: Lens' NetworkSummary (Maybe Text) Source #

The Amazon Resource Name (ARN) of the network. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

networkSummary_creationDate :: Lens' NetworkSummary (Maybe UTCTime) Source #

The date and time that the network was created.

networkSummary_description :: Lens' NetworkSummary (Maybe Text) Source #

An optional description of the network.

networkSummary_framework :: Lens' NetworkSummary (Maybe Framework) Source #

The blockchain framework that the network uses.

networkSummary_frameworkVersion :: Lens' NetworkSummary (Maybe Text) Source #

The version of the blockchain framework that the network uses.

networkSummary_id :: Lens' NetworkSummary (Maybe Text) Source #

The unique identifier of the network.

networkSummary_status :: Lens' NetworkSummary (Maybe NetworkStatus) Source #

The current status of the network.

Node

node_arn :: Lens' Node (Maybe Text) Source #

The Amazon Resource Name (ARN) of the node. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

node_availabilityZone :: Lens' Node (Maybe Text) Source #

The Availability Zone in which the node exists. Required for Ethereum nodes.

node_creationDate :: Lens' Node (Maybe UTCTime) Source #

The date and time that the node was created.

node_frameworkAttributes :: Lens' Node (Maybe NodeFrameworkAttributes) Source #

Attributes of the blockchain framework being used.

node_id :: Lens' Node (Maybe Text) Source #

The unique identifier of the node.

node_instanceType :: Lens' Node (Maybe Text) Source #

The instance type of the node.

node_kmsKeyArn :: Lens' Node (Maybe Text) Source #

The Amazon Resource Name (ARN) of the customer managed key in Key Management Service (KMS) that the node uses for encryption at rest. If the value of this parameter is "AWS Owned KMS Key", the node uses an Amazon Web Services owned KMS key for encryption. The node inherits this parameter from the member that it belongs to.

For more information, see Encryption at Rest in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.

Applies only to Hyperledger Fabric.

node_logPublishingConfiguration :: Lens' Node (Maybe NodeLogPublishingConfiguration) Source #

Configuration properties for logging events associated with a peer node on a Hyperledger Fabric network on Managed Blockchain.

node_memberId :: Lens' Node (Maybe Text) Source #

The unique identifier of the member to which the node belongs.

Applies only to Hyperledger Fabric.

node_networkId :: Lens' Node (Maybe Text) Source #

The unique identifier of the network that the node is on.

node_stateDB :: Lens' Node (Maybe StateDBType) Source #

The state database that the node uses. Values are LevelDB or CouchDB.

Applies only to Hyperledger Fabric.

node_status :: Lens' Node (Maybe NodeStatus) Source #

The status of the node.

  • CREATING - The Amazon Web Services 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 Amazon Web Services 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 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 of revoking a grant isn't immediate. It might take some time for the node resource to discover that the key is inaccessible. When a resource is in this state, we recommend deleting and recreating the resource.

node_tags :: Lens' Node (Maybe (HashMap Text Text)) Source #

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.

NodeConfiguration

nodeConfiguration_availabilityZone :: Lens' NodeConfiguration (Maybe Text) Source #

The Availability Zone in which the node exists. Required for Ethereum nodes.

nodeConfiguration_logPublishingConfiguration :: Lens' NodeConfiguration (Maybe NodeLogPublishingConfiguration) Source #

Configuration properties for logging events associated with a peer node on a Hyperledger Fabric network on Managed Blockchain.

nodeConfiguration_stateDB :: Lens' NodeConfiguration (Maybe StateDBType) Source #

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.

nodeConfiguration_instanceType :: Lens' NodeConfiguration Text Source #

The Amazon Managed Blockchain instance type for the node.

NodeEthereumAttributes

nodeEthereumAttributes_httpEndpoint :: Lens' NodeEthereumAttributes (Maybe Text) Source #

The endpoint on which the Ethereum node listens to run Ethereum API 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.

nodeEthereumAttributes_webSocketEndpoint :: Lens' NodeEthereumAttributes (Maybe Text) Source #

The endpoint on which the Ethereum node listens to run Ethereum JSON-RPC methods over WebSocket connections from a client. Use this endpoint in client code for smart contracts when using a WebSocket connection. Connections to this endpoint are authenticated using Signature Version 4.

NodeFabricAttributes

nodeFabricAttributes_peerEndpoint :: Lens' NodeFabricAttributes (Maybe Text) Source #

The endpoint that identifies the peer node for all services except peer channel-based event services.

nodeFabricAttributes_peerEventEndpoint :: Lens' NodeFabricAttributes (Maybe Text) Source #

The endpoint that identifies the peer node for peer channel-based event services.

NodeFabricLogPublishingConfiguration

nodeFabricLogPublishingConfiguration_chaincodeLogs :: Lens' NodeFabricLogPublishingConfiguration (Maybe LogConfigurations) Source #

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.

nodeFabricLogPublishingConfiguration_peerLogs :: Lens' NodeFabricLogPublishingConfiguration (Maybe LogConfigurations) Source #

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.

NodeFrameworkAttributes

nodeFrameworkAttributes_ethereum :: Lens' NodeFrameworkAttributes (Maybe NodeEthereumAttributes) Source #

Attributes of Ethereum for a node on a Managed Blockchain network that uses Ethereum.

nodeFrameworkAttributes_fabric :: Lens' NodeFrameworkAttributes (Maybe NodeFabricAttributes) Source #

Attributes of Hyperledger Fabric for a peer node on a Managed Blockchain network that uses Hyperledger Fabric.

NodeLogPublishingConfiguration

nodeLogPublishingConfiguration_fabric :: Lens' NodeLogPublishingConfiguration (Maybe NodeFabricLogPublishingConfiguration) Source #

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.

NodeSummary

nodeSummary_arn :: Lens' NodeSummary (Maybe Text) Source #

The Amazon Resource Name (ARN) of the node. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

nodeSummary_availabilityZone :: Lens' NodeSummary (Maybe Text) Source #

The Availability Zone in which the node exists.

nodeSummary_creationDate :: Lens' NodeSummary (Maybe UTCTime) Source #

The date and time that the node was created.

nodeSummary_id :: Lens' NodeSummary (Maybe Text) Source #

The unique identifier of the node.

nodeSummary_instanceType :: Lens' NodeSummary (Maybe Text) Source #

The EC2 instance type for the node.

Proposal

proposal_actions :: Lens' Proposal (Maybe ProposalActions) Source #

The actions to perform on the network if the proposal is APPROVED.

proposal_arn :: Lens' Proposal (Maybe Text) Source #

The Amazon Resource Name (ARN) of the proposal. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

proposal_creationDate :: Lens' Proposal (Maybe UTCTime) Source #

The date and time that the proposal was created.

proposal_description :: Lens' Proposal (Maybe Text) Source #

The description of the proposal.

proposal_expirationDate :: Lens' Proposal (Maybe UTCTime) Source #

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 haven't cast enough votes to determine the outcome according to the voting policy, the proposal is EXPIRED and Actions aren't carried out.

proposal_networkId :: Lens' Proposal (Maybe Text) Source #

The unique identifier of the network for which the proposal is made.

proposal_noVoteCount :: Lens' Proposal (Maybe Int) Source #

The current total of NO votes cast on the proposal by members.

proposal_outstandingVoteCount :: Lens' Proposal (Maybe Int) Source #

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.

proposal_proposalId :: Lens' Proposal (Maybe Text) Source #

The unique identifier of the proposal.

proposal_proposedByMemberId :: Lens' Proposal (Maybe Text) Source #

The unique identifier of the member that created the proposal.

proposal_proposedByMemberName :: Lens' Proposal (Maybe Text) Source #

The name of the member that created the proposal.

proposal_status :: Lens' Proposal (Maybe ProposalStatus) Source #

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 aren't carried out.
  • EXPIRED - Members didn't cast the number of votes required to determine the proposal outcome before the proposal expired. The specified ProposalActions aren't carried out.
  • ACTION_FAILED - One or more of the specified ProposalActions in a proposal that was approved couldn't be completed because of an error. The ACTION_FAILED status occurs even if only one ProposalAction fails and other actions are successful.

proposal_tags :: Lens' Proposal (Maybe (HashMap Text Text)) Source #

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.

proposal_yesVoteCount :: Lens' Proposal (Maybe Int) Source #

The current total of YES votes cast on the proposal by members.

ProposalActions

proposalActions_invitations :: Lens' ProposalActions (Maybe [InviteAction]) Source #

The actions to perform for an APPROVED proposal to invite an Amazon Web Services account to create a member and join the network.

proposalActions_removals :: Lens' ProposalActions (Maybe [RemoveAction]) Source #

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.

ProposalSummary

proposalSummary_arn :: Lens' ProposalSummary (Maybe Text) Source #

The Amazon Resource Name (ARN) of the proposal. For more information about ARNs and their format, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

proposalSummary_creationDate :: Lens' ProposalSummary (Maybe UTCTime) Source #

The date and time that the proposal was created.

proposalSummary_description :: Lens' ProposalSummary (Maybe Text) Source #

The description of the proposal.

proposalSummary_expirationDate :: Lens' ProposalSummary (Maybe UTCTime) Source #

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 haven't cast enough votes to determine the outcome according to the voting policy, the proposal is EXPIRED and Actions aren't carried out.

proposalSummary_proposalId :: Lens' ProposalSummary (Maybe Text) Source #

The unique identifier of the proposal.

proposalSummary_proposedByMemberId :: Lens' ProposalSummary (Maybe Text) Source #

The unique identifier of the member that created the proposal.

proposalSummary_proposedByMemberName :: Lens' ProposalSummary (Maybe Text) Source #

The name of the member that created the proposal.

proposalSummary_status :: Lens' ProposalSummary (Maybe ProposalStatus) Source #

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 aren't carried out.
  • EXPIRED - Members didn't cast the number of votes required to determine the proposal outcome before the proposal expired. The specified ProposalActions aren't carried out.
  • ACTION_FAILED - One or more of the specified ProposalActions in a proposal that was approved couldn't be completed because of an error.

RemoveAction

removeAction_memberId :: Lens' RemoveAction Text Source #

The unique identifier of the member to remove.

VoteSummary

voteSummary_memberId :: Lens' VoteSummary (Maybe Text) Source #

The unique identifier of the member that cast the vote.

voteSummary_memberName :: Lens' VoteSummary (Maybe Text) Source #

The name of the member that cast the vote.

voteSummary_vote :: Lens' VoteSummary (Maybe VoteValue) Source #

The vote value, either YES or NO.

VotingPolicy

votingPolicy_approvalThresholdPolicy :: Lens' VotingPolicy (Maybe ApprovalThresholdPolicy) Source #

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.