Tags are key-value pairs associated with AWS resources. You can apply tags to your repositories in CodeArtifact. For information about CodeArtifact resource tagging, use cases, tag key and value constraints, and supported resource types, see Tagging resources.
You can use the CLI to specify tags when you create a repository. You can use the console or CLI to add or remove tags, and update the values of tags in a repository. You can add up to 50 tags to each repository.
Tag repositories (CLI)
You can use the CLI to manage repository tags.
Topics
Add tags to a repository (CLI)
You can use the console or the AWS CLI to tag repositories.
To add a tag to a repository when you create it, see Create a repository.
In these steps, we assume that you have already installed a recent version of the AWS CLI or updated to the current version. For more information, see Installing the AWS Command Line Interface.
At the terminal or command line, run the tag-resource command, specifying the Amazon Resource Name (ARN) of the repository where you want to add tags and the key and value of the tag you want to add.
Note
To get the ARN of the repository, run the describe-repository
command:
aws codeartifact describe-repository --domain
my_domain
--repositorymy_repo
--query repository.arn
You can add more than one tag to a
repository. For example, to tag a repository named my_repo
in
a domain named my_domain
with two tags, a tag key named key1
with
the tag value of value1
, and a tag key named
key2
with the tag value of
value2
:
aws codeartifact tag-resource --resource-arn arn:aws:codeartifact:
us-west-2
:111122223333
:repository/my_domain
/my_repo
--tags key=key1
,value=value1
key=key2
,value=value2
If successful, this command has no output.
View tags for a repository (CLI)
Follow these steps to use the AWS CLI to view the AWS tags for a repository. If no tags have been added, the returned list is empty.
At the terminal or command line, run the list-tags-for-resource command.
Note
To get the ARN of the repository, run the describe-repository
command:
aws codeartifact describe-repository --domain
my_domain
--repositorymy_repo
--query repository.arn
For example, to view a list of tag keys and tag values for a repository named
my_repo
in a domain named my_domain
with the
arn:aws:codeartifact:
ARN value:us-west-2
:111122223333
:repository/my_domain
/my_repo
aws codeartifact list-tags-for-resource --resource-arn arn:aws:codeartifact:
us-west-2
:111122223333
:repository/my_domain
/my_repo
If successful, this command returns information similar to the following:
{
"tags": {
"key1": "value1",
"key2": "value2"
}
}
Edit tags for a repository (CLI)
Follow these steps to use the AWS CLI to edit a tag for a repository. You can change the value for an existing key or add another key.
At the terminal or command line, run the tag-resource command, specifying the ARN of the repository where you want to update a tag and specify the tag key and tag value.
Note
To get the ARN of the repository, run the describe-repository
command:
aws codeartifact describe-repository --domain
my_domain
--repositorymy_repo
--query repository.arn
aws codeartifact tag-resource --resource-arn arn:aws:codeartifact:
us-west-2
:111122223333
:repository/my_domain
/my_repo
--tags key=key1
,value=newvalue1
If successful, this command has no output.
Remove tags from a repository (CLI)
Follow these steps to use the AWS CLI to remove a tag from a repository.
Note
If you delete a repository, all tag associations are removed from the deleted repository. You do not have to remove tags before you delete a repository.
At the terminal or command line, run the untag-resource command, specifying the ARN of the repository where you want to remove tags and the tag key of the tag you want to remove.
Note
To get the ARN of the repository, run the describe-repository
command:
aws codeartifact describe-repository --domain
my_domain
--repositorymy_repo
--query repository.arn
For example, to remove multiple tags on a
repository named my_repo
in a domain named my_domain
with the tag keys
key1
and
key2
:
aws codeartifact untag-resource --resource-arn arn:aws:codeartifact:
us-west-2
:111122223333
:repository/my_domain
/my_repo
--tag-keyskey1
key2
If successful, this command has no output. After removing tags, you can view the
remaining tags on the repository using the list-tags-for-resource
command.
Tag repositories (console)
You can use the console or the CLI to tag resources.
Topics
Add tags to a repository (console)
You can use the console to add tags to an existing repository.
Open the AWS CodeArtifact console at https://console.aws.amazon.com/codesuite/codeartifact/home
. -
On the Repositories page, choose the repository that you want to add tags to.
-
Expand the Details section.
-
Under Repository tags, if there are no tags on the repository, choose Add repository tags. If there are tags on the repository, choose View and edit repository tags.
-
Choose Add new tag.
-
In the Key and Value fields, enter the text for each tag you want to add. (The Value field is optional.) For example, in Key, enter
Name
. In Value, enterTest
. -
(Optional) Choose Add tag to add more rows and enter more tags.
-
Choose Update repository.
View tags for a repository (console)
You can use the console to list tags for existing repositories.
Open the AWS CodeArtifact console at https://console.aws.amazon.com/codesuite/codeartifact/home
. -
On the Repositories page, choose the repository where you want to view tags.
-
Expand the Details section.
-
Under Repository tags, choose View and edit repository tags.
Note
If there are no tags added to this repository, the console will read Add repository tags.
Edit tags for a repository (console)
You can use the console to edit tags that have been added to repository.
Open the AWS CodeArtifact console at https://console.aws.amazon.com/codesuite/codeartifact/home
. -
On the Repositories page, choose the repository where you want to update tags.
-
Expand the Details section.
-
Under Repository tags, choose View and edit repository tags.
Note
If there are no tags added to this repository, the console will read Add repository tags.
-
In the Key and Value fields, update the values in each field as needed. For example, for the
Name
key, in Value, changeTest
toProd
. -
Choose Update repository.
Remove tags from a repository (console)
You can use the console to delete tags from repositories.
Open the AWS CodeArtifact console at https://console.aws.amazon.com/codesuite/codeartifact/home
. -
On the Repositories page, choose the repository where you want to remove tags.
-
Expand the Details section.
-
Under Repository tags, choose View and edit repository tags.
Note
If there are no tags added to this repository, the console will read Add repository tags.
-
Next to the key and value for each tag you want to delete, choose Remove.
-
Choose Update repository.