delete-tags.md

copyright	lastupdated	keywords	subcollection
years 2021	2021-09-28	tags, delete tags, unused tags, delete tags in the console, delete tags cli, delete tags api	account

{:shortdesc: .shortdesc} {:codeblock: .codeblock} {:tip: .tip} {:note: .note} {:external: target="_blank" .external} {:ui: .ph data-hd-interface='ui'} {:cli: .ph data-hd-interface='cli'} {:api: .ph data-hd-interface='api'} {:java: .ph data-hd-programlang='java'} {:python: .ph data-hd-programlang='python'} {:javascript: .ph data-hd-programlang='javascript'} {:curl: .ph data-hd-programlang='curl'} {:go: .ph data-hd-programlang='go'}

Deleting unused tags from the account

{: #delete}

Before you can delete a tag, you must remove it from all resources. If you still can't delete it, the tag might be attached to a resource that you don't have permission to view or was reclaimed. The same tag can be attached to several resources by different users in the same billing account.

If a reclaimed resource is blocking tag deletion, you can either completely delete that reclaimed resource or restore it within 7 days after you delete it. Not all resources can be restored. You can use the {{site.data.keyword.Bluemix}} CLI to manage the reclamation process of specific resources. For more information, see Using resource reclamations.

When you delete an access management tag from the account, any associated IAM policies are also deleted with it. {: note}

Deleting unused tags in the console

{: #delete-tag-console} {: ui}

1. To see the full list of tags in your account, go to Manage > Account in the {{site.data.keyword.cloud}} console, and select Tags.
2. Click the Actions icon > Delete next to the unused tag.

Deleting unused tags by using the CLI

{: #delete-tag-cli} {: cli}

Log in to {{site.data.keyword.cloud}} CLI and select your account to run the ibmcloud resource tag-delete command for deleting only one or all of the unused tags. The following example deletes the MyTag user tag:

ibmcloud resource tag-delete --tag-names MyTag

{: codeblock}

Deleting unused tags by using the API

{: #delete-tag-api} {: api}

You can delete tags by calling the Global Search and Tagging - Tagging API{: external} as shown in the following sample requests. The allowed values for the tag_type query parameter are: user for user tags and access for access management tags.

Deleting a tag

{: #delete-a-tag-api}

Deleting an access management tag called project:myproject from the account:

curl -X DELETE -H "Authorization: {iam_token}" \
-H "Accept: application/json" \
"https://tags.global-search-tagging.cloud.ibm.com/v3/tags/project:myproject?tag_type=access"

{: codeblock} {: curl}

DeleteTagOptions deleteTagOptions = new DeleteTagOptions.Builder()
    .tagName("env:example-access-tag")
    .tagType("access")
    .build();

Response<DeleteTagResults> response = service.deleteTag(deleteTagOptions).execute();
DeleteTagResults deleteTagResults = response.getResult();
System.out.println(deleteTagResults.toString());

{: codeblock} {: java}

const params = {
  tagName: 'env:example-access-tag',
  tagType: 'access',
};

globalTaggingService.deleteTag(params)
  .then(res => {
    console.log(JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

{: codeblock} {: javascript}

delete_tag_results = global_tagging_service.delete_tag(
  tag_name='env:example-access-tag',
  tag_type='access').get_result()

print(json.dumps(delete_tag_results, indent=2))

{: codeblock} {: python}

deleteTagOptions := globalTaggingService.NewDeleteTagOptions("env:example-access-tag")
deleteTagOptions.SetTagType("access")

deleteTagResults, response, err := globalTaggingService.DeleteTag(deleteTagOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(deleteTagResults, "", "  ")
fmt.Println(string(b))

{: codeblock} {: go}

Deleting all unused tags

{: #delete-all-tags-api}

Deleting all unused access management tags from the account:

curl -X DELETE -H "Authorization: {iam_token}" \
-H "Accept: application/json" \
"https://tags.global-search-tagging.cloud.ibm.com//v3/tags?tag_type=access"

{: codeblock} {: curl}

DeleteTagAllOptions deleteTagAllOptions = new DeleteTagAllOptions.Builder()
    .tagType("user")
    .build();

Response<DeleteTagsResult> response = service.deleteTagAll(deleteTagAllOptions).execute();
DeleteTagsResult deleteTagsResult = response.getResult();

System.out.println(deleteTagsResult.toString());

{: codeblock} {: java}

const params = {
  tagType: 'access',
};

globalTaggingService.deleteTagAll(params)
  .then(res => {
    console.log(JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

{: codeblock} {: javascript}

delete_tags_result = global_tagging_service.delete_tag_all(
  tag_type='user').get_result()

print(json.dumps(delete_tags_result, indent=2))

{: codeblock} {: python}

deleteTagAllOptions := globalTaggingService.NewDeleteTagAllOptions()
deleteTagAllOptions.SetTagType("user")

deleteTagsResult, response, err := globalTaggingService.DeleteTagAll(deleteTagAllOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(deleteTagsResult, "", "  ")
fmt.Println(string(b))

{: codeblock} {: go}

Deleting tags by using Terraform

{: #delete-terraform} {: terraform}

You can delete tags by using Terraform.

1. To install the Terraform CLI and configure the {{site.data.keyword.cloud_notm}} Provider plug-in for Terraform, follow the tutorial for Getting started witTerraform on {{site.data.keyword.cloud}}. The plug-in abstracts the{site.data.keyword.cloud_notm}} APIs that are used to complete this task.

2. Create a Terraform configuration file that is named main.tf. In this file, you add the configuration to delete tags by by using HashiCorp Configuration LanguageFor more information, see the Terraform documentation{: external}. The following example deletes the ibm_tag from the resource ibm, which is attached to resource ID ibm_satellite_location.location.crn.

   resource "ibm_resource" "ibm" {
   resource_id = ibm_satellite_location.location.crn
   tags        = [ "ibm_tag" ]
   }

   {: codeblock}

3. Initialize the Terraform CLI.

   terraform init

   {: pre}

4. Create a Terraform execution plan. The Terraform execution plan summarizes all the actions that need to be run to delete tags.

   terraform plan

   {: pre}

5. Delete the tags.

   terraform destroy

   {: pre}