Tagging Overview Tagging in the Console Tagging With the CLI Tagging With the API

Tagging Amazon Neptune Resources

You can use Neptune tags to add metadata to your Neptune resources. In addition, you can use tags with Amazon Identity and Access Management (IAM) policies to manage access to Neptune resources and control what actions can be applied to those resources. Finally, you can use tags to track costs by grouping expenses for similarly tagged resources.

All Neptune administrative resources can be tagged, including the following:

DB instances
DB clusters
Read Replicas
DB snapshots
DB cluster snapshots
Event subscriptions
DB parameter groups
DB cluster parameter groups
DB subnet groups

Overview of Neptune Resource Tags

An Amazon Neptune tag is a name-value pair that you define and associate with a Neptune resource. The name is referred to as the key. Supplying a value for the key is optional. You can use tags to assign arbitrary information to a Neptune resource. You can use a tag key, for example, to define a category, and the tag value might be an item in that category. For example, you might define a tag key of “project” and a tag value of “Salix,” indicating that the Neptune resource is assigned to the Salix project. You can also use tags to designate Neptune resources as being used for test or production by using a key such as environment=test or environment=production. We recommend that you use a consistent set of tag keys to make it easier to track metadata that is associated with Neptune resources.

Use tags to organize your Amazon bill to reflect your own cost structure. To do this, sign up to get your Amazon Web Services account bill with tag key values included. Then, to see the cost of combined resources, organize your billing information according to resources with the same tag key values. For example, you can tag several resources with a specific application name, and then organize your billing information to see the total cost of that application across several services. For more information, see Using Cost Allocation Tags in the Amazon Billing User Guide.

Each Neptune resource has a tag set, which contains all the tags that are assigned to that Neptune resource. A tag set can contain as many as 10 tags, or it can be empty. If you add a tag to a Neptune resource that has the same key as an existing tag on resource, the new value overwrites the old value.

Amazon does not apply any semantic meaning to your tags; tags are interpreted strictly as character strings. Neptune can set tags on a DB instance or other Neptune resources, depending on the settings that you use when you create the resource. For example, Neptune might add a tag indicating that a DB instance is for production or for testing.

The tag key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:" or "rds:". The string can contain only the set of Unicode letters, digits, white space, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").
The tag value is an optional string value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string can contain only the set of Unicode letters, digits, white space, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

Values do not have to be unique in a tag set and can be null. For example, you can have a key-value pair in a tag set of project/Trinity and cost-center/Trinity.

Note

You can add a tag to a snapshot. However, your bill won't reflect this grouping.

You can use the Amazon Web Services Management Console, the Amazon CLI, or the Neptune API to add, list, and delete tags on Neptune resources. When using the Amazon CLI or the Neptune API, you must provide the Amazon Resource Name (ARN) for the Neptune resource that you want to work with. For more information about constructing an ARN, see Constructing an ARN for Neptune.

Tags are cached for authorization purposes. Because of this, additions and updates to tags on Neptune resources can take several minutes before they are available.

Copying Tags in Neptune

When you create or restore a DB instance, you can specify that the tags from the DB instance are copied to snapshots of the DB instance. Copying tags ensures that the metadata for the DB snapshots matches that of the source DB instance, and that any access policies for the DB snapshot also match those of the source DB instance. Tags are not copied by default.

You can specify that tags are copied to DB snapshots for the following actions:

Creating a DB instance.
Restoring a DB instance.
Creating a Read Replica.
Copying a DB snapshot.

Note

If you include a value for the --tag-key parameter of the create-db-cluster-snapshot Amazon CLI command (or supply at least one tag to the CreateDBClusterSnapshot API action), Neptune doesn't copy tags from the source DB instance to the new DB snapshot. This is true even if the source DB instance has the --copy-tags-to-snapshot (CopyTagsToSnapshot) option enabled.

This means that you can create a copy of a DB instance from a DB snapshot and avoid adding tags that don't apply to the new DB instance. After you create your DB snapshot using the Amazon CLI create-db-cluster-snapshot command (or the CreateDBClusterSnapshot Neptune API action), you can then add tags as described later in this topic.

Tagging in Neptune Using the Amazon Web Services Management Console

The process to tag an Amazon Neptune resource is similar for all resources. The following procedure shows how to tag a Neptune DB instance.

To add a tag to a DB instance

Sign in to the Amazon Management Console, and open the Amazon Neptune console at https://console.aws.amazon.com/neptune/home.
In the navigation pane, choose Instances.

Note
To filter the list of DB instances in the Instances pane, type a text string in the Filter instances box. Only DB instances that contain the string appear.
Choose the DB instance that you want to tag.
Choose Instance actions, and then choose See details.
In the details section, scroll down to the Tags section.
Choose Add. The Add tags window appears.
Type a value for Tag key and Value.
To add another tag, you can choose Add another Tag and type a value for its Tag key and Value.

Repeat this step as many times as necessary.
Choose Add.

To delete a tag from a DB instance

Sign in to the Amazon Management Console, and open the Amazon Neptune console at https://console.aws.amazon.com/neptune/home.
In the navigation pane, choose Instances.

Note
To filter the list of DB instances in the Instances pane, type a text string in the Filter instances box. Only DB instances that contain the string appear.
Choose the DB instance that you want to tag.
Choose Instance actions, and then choose See details.
In the details section, scroll down to the Tags section.
Choose the tag that you want to delete.
Choose Remove, and then choose Remove in the Remove tags window.

Tagging in Neptune Using the Amazon CLI

You can add, list, or remove tags for a DB instance in Neptune using the Amazon CLI.

To add one or more tags to a Neptune resource, use the Amazon CLI command add-tags-to-resource.
To list the tags on a Neptune resource, use the Amazon CLI command list-tags-for-resource.
To remove one or more tags from a Neptune resource, use the Amazon CLI command remove-tags-from-resource.

To learn more about how to construct the required Amazon Resource Name (ARN), see Constructing an ARN for Neptune.

Tagging in Neptune Using the API

You can add, list, or remove tags for a DB instance using the Neptune API.

To add a tag to a Neptune resource, use the AddTagsToResource operation.
To list tags that are assigned to a Neptune resource, use the ListTagsForResource.
To remove tags from a Neptune resource, use the RemoveTagsFromResource operation.

To learn more about how to construct the required ARN, see Constructing an ARN for Neptune.

When working with XML using the Neptune API, tags use the following schema:


<Tagging>
    <TagSet>
        <Tag>
            <Key>Project</Key>
            <Value>Trinity</Value>
        </Tag>
        <Tag>
            <Key>User</Key>
            <Value>Jones</Value>
        </Tag>
    </TagSet>
</Tagging>

The following table provides a list of the allowed XML tags and their characteristics. Values for Key and Value are case-dependent. For example, project=Trinity and PROJECT=Trinity are two distinct tags.

Tagging Element	Description
`TagSet`	A tag set is a container for all tags that are assigned to a Neptune resource. There can be only one tag set per resource. You work with a `TagSet` only through the Neptune API.
`Tag`	A tag is a user-defined key-value pair. There can be from 1 to 50 tags in a tag set.
`Key`	A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "`rds:`" or "`aws:`". The string can contain only the set of Unicode letters, digits, white space, '_', '.', '/', '=', '+', '-' (Java regex: "`^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$`"). Keys must be unique to a tag set. For example, you can't have a key-pair in a tag set with the key the same but with different values, such as `project/Trinity` and `project/Xanadu`.
Value	A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "`rds:`" or "`aws:`". The string can contain only the set of Unicode letters, digits, white space, '_', '.', '/', '=', '+', '-' (Java regex: "`^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$`"). Values don't have to be unique in a tag set and can be null. For example, you can have a key-value pair in a tag set of `project/Trinity` and `cost-center/Trinity`.

Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Manage subscriptions

Working with ARNs