Menu
AWS CodeDeploy
User Guide (API Version 2014-10-06)

Manually Remove On-Premises Instance Tags from an On-Premises Instance

Typically, you remove an on-premises instance tag from an on-premises instance when that tag is no longer being used, or you want to remove the on-premises instance from any deployment groups that rely on that tag. You can use the AWS CLI or the AWS CodeDeploy console to remove on-premises instance tags from on-premises instances.

You do not need to remove the on-premises instance tags from an on-premises instance before you deregister it.

Manually removing on-premises instance tags from an on-premises instance does not deregister the instance. It does not uninstall the AWS CodeDeploy agent from the instance. It does not remove the configuration file from the instance. It does not delete the IAM user associated with the instance.

To automatically deregister the on-premises instance, see Automatically Deregister an On-Premises Instance.

To manually deregister the on-premises instance, see Manually Deregister an On-Premises Instance.

To automatically uninstall the AWS CodeDeploy agent and remove the configuration file from the on-premises instance, see Automatically Uninstall the AWS CodeDeploy Agent and Remove the Configuration File from an On-Premises Instance.

To manually uninstall just the AWS CodeDeploy agent from the on-premises instance, see Managing AWS CodeDeploy Agent Operations.

To manually delete the associated IAM user, see Deleting an IAM User from Your AWS Account.

To remove on-premises instance tags from an on-premises instance (CLI)

  • Call the remove-tags-from-on-premises-instances, specifying:

    • The names that uniquely identify the on-premises instance (with the --instance-names option).

    • The names and values of the tags you want to remove (with the --tags option).

      For example:

      Copy
      aws deploy remove-tags-from-on-premises-instances --instance-names AssetTag12010298EX --tags Key=Name,Value=CodeDeployDemo-OnPrem

To remove on-premises instance tags from an on-premises instance (console)

  1. Sign in to the AWS Management Console and open the AWS CodeDeploy console at https://console.aws.amazon.com/codedeploy.

    Note

    Sign in with the same account or IAM user information you used in Getting Started with AWS CodeDeploy.

  2. In the AWS CodeDeploy menu, choose On-premises instances.

  3. In the list of on-premises instances, choose the arrow next to the on-premises instance from which you want to remove tags.

  4. In the Tags area, choose the delete icon ( ) next to each tag you want to remove.

  5. After you have deleted the tags, choose Update tags.