Tagging Amazon Managed Blockchain resources - Amazon Managed Blockchain

Tagging Amazon Managed Blockchain resources

A tag is a custom attribute label that you assign or that AWS assigns to an AWS resource. Each tag has two parts:

  • A tag key, such as CostCenter, Environment, or Project. Tag keys are case-sensitive.

  • An optional field known as a tag value, such as 111122223333 or Production. Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.

Tags help you do the following:

  • Identify and organize your AWS resources. Many AWS services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you could assign the same tag to an Amazon Managed Blockchain node and an EC2 instance that you use as a client for the Managed Blockchain framework.

  • Track your AWS costs. You activate these tags on the AWS Billing and Cost Management dashboard. AWS uses the tags to categorize your costs and deliver a monthly cost allocation report to you. For more information, see Using cost allocation tags in the AWS Billing and Cost Management User Guide.

  • Control access to your AWS resources with AWS Identity and Access Management (IAM). For information, see Controlling access using tags in this developer guide and Control access using IAM tags in the IAM User Guide.

For more information about tags, see the Tagging Best Practices guide.

The following sections provide more information about tags for Managed Blockchain.

Create and add tags for Hyperledger Fabric on Managed Blockchain resources

You can tag the following resources:

  • Networks

  • Members

  • Nodes

  • Proposals and invitations

    Members can assign tags to proposals when they create them. If a proposal is approved and an invitation is sent, the invitation inherits the tags added during proposal creation. Members who receive invitations or vote on proposals can subsequently add or remove tags for proposals and invitations. These subsequent tag edits are scoped only to the AWS account that made the edits.

Tags that you create—including those for network-wide resources like networks, proposals, and invitations—are scoped only to the account in which you create them. Tags created during proposal creation are the exception. Other AWS accounts participating on the network cannot access the tags.

Tag naming and usage conventions

The following basic naming and usage conventions apply to tags used with Managed Blockchain resources:

  • Each resource can have a maximum of 50 tags.

  • For each resource, each tag key must be unique, and each tag key can have only one value.

  • The maximum tag key length is 128 Unicode characters in UTF-8.

  • The maximum tag value length is 256 Unicode characters in UTF-8.

  • Allowed characters are letters, numbers, spaces representable in UTF-8, and the following characters: . : + = @ _ / - (hyphen).

  • Tag keys and values are case-sensitive. As a best practice, decide on a strategy for capitalizing tags, and consistently implement that strategy across all resource types. For example, decide whether to use Costcenter, costcenter, or CostCenter, and use the same convention for all tags. Avoid using similar tags with inconsistent case treatment.

  • The aws: prefix is reserved for AWS use. You can't edit or delete a tag's key or value when the tag has a tag key with the aws: prefix. Tags with this prefix do not count against your limit of tags per resource.

Working with tags

You can use the Managed Blockchain console, the AWS CLI, or the Managed Blockchain API to add, edit, or delete tag keys and tag values. You can assign tags when you create a resource, or you can apply tags after the resource is created.

For more information about Managed Blockchain API actions for tagging, see the following topics in the Amazon Managed Blockchain API Reference:

Add or remove tags

You can add a tag to Hyperledger Fabric on Managed Blockchain resources when you create or work with them.

Add or remove tags for networks

For information about adding a tag when you create a network, see Create a Hyperledger Fabric Blockchain Network on Amazon Managed Blockchain.

To add or remove a tag for a Hyperledger Fabric network on Managed Blockchain using the AWS Management Console

  1. Open the Managed Blockchain console at https://console.aws.amazon.com/managedblockchain/.

  2. Choose Networks and then choose a Hyperledger Fabric network from the list.

  3. Under Tags, choose Edit tags, and then do one of the following:

    • To add a tag, choose Add new tag, enter a Key and optional Value, and then choose Save.

    • To remove a tag, choose Remove next to the Tag you want to remove, and then choose Save.

Add or remove tags for members

For information about adding a tag when you create a member, see Create a Member and Join a Network.

To add or remove a tag for a member

  1. Open the Managed Blockchain console at https://console.aws.amazon.com/managedblockchain/.

  2. Choose Networks and then choose a Hyperledger Fabric network from the list.

  3. Choose Members.

  4. Under Members owned by you, choose a member from the list.

  5. Under Tags, choose Edit tags, and then do one of the following:

    • To add a tag, choose Add new tag, enter a Key and optional Value, and then choose Save.

    • To remove a tag, choose Remove next to the Tag you want to remove, and then choose Save.

Add or remove tags for nodes

For information about adding a tag when you create a node, see Create a Hyperledger Fabric Peer Node on Amazon Managed Blockchain.

To add or remove a tag for a node

  1. Open the Managed Blockchain console at https://console.aws.amazon.com/managedblockchain/.

  2. Choose Networks and then choose a Hyperledger Fabric network from the list.

  3. Choose Members.

  4. Under Members owned by you, choose a member from the list.

  5. Under peer nodes, choose a Node ID from the list.

  6. Choose Tags, choose Edit tags, and then do one of the following:

    • To add a tag, choose Add new tag, enter a Key and optional Value, and then choose Save.

    • To remove a tag, choose Remove next to the Tag you want to remove, and then choose Save.

Add or remove tags for proposals

For information about adding a tag when you create a proposal, see Create an Invitation Proposal and Create a Proposal to Remove a Network Member.

You can add and remove tags from active and completed proposals.

To add or remove a tag for a proposal

  1. Open the Managed Blockchain console at https://console.aws.amazon.com/managedblockchain/.

  2. Choose Networks and then choose a network from the list.

  3. Choose Proposals.

  4. Under Active or Completed, choose a Proposal ID from the list.

  5. Under Tags, choose Edit tags, and then do one of the following:

    • To add a tag, choose Add new tag, enter a Key and optional Value, and then choose Save.

    • To remove a tag, choose Remove next to the Tag you want to remove, and then choose Save.

Add or remove tags for invitations

If the member who created a proposal for an invitation tagged the proposal, the invitation inherits the tag key and value from the proposal.

To add or remove a tag for an invitation

  1. Open the Managed Blockchain console at https://console.aws.amazon.com/managedblockchain/.

  2. Choose Invitations and then choose a Network name from the list.

  3. Under Tags, choose Edit tags, and then do one of the following:

    • To add a tag, choose Add new tag, enter a Key and optional Value, and then choose Save.

    • To remove a tag, choose Remove next to the Tag you want to remove, and then choose Save.