Manually deregister an on-premises instance - Amazon CodeDeploy
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Manually deregister an on-premises instance

Typically, you deregister an on-premises instance after you're no longer planning to deploy to it. You use the Amazon CLI to manually deregister on-premises instances.

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

To automatically uninstall the CodeDeploy agent and remove the configuration file from the on-premises instance, see Automatically uninstall the CodeDeploy agent and remove the configuration file from an on-premises instance.

To manually uninstall only the CodeDeploy agent, see Managing CodeDeploy agent operations.

To manually delete the associated IAM user, see Deleting an IAM user from your Amazon account.

To manually remove only the associated on-premises instance tags, see Manually remove on-premises instance tags from an on-premises instance.

  • Call the deregister-on-premises-instance command, specifying the name that uniquely identifies the on-premises instance (with the --instance-name option):

    aws deploy deregister-on-premises-instance --instance-name AssetTag12010298EX