Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . deploy ]



Removes any tags from the on-premises instance; deregisters the on-premises instance from AWS CodeDeploy; and, unless requested otherwise, deletes the IAM user for the on-premises instance.

See 'aws help' for descriptions of global parameters.


--instance-name <instance-name>


--instance-name (string) Required. The name of the on-premises instance.

--no-delete-iam-user (boolean) Optional. Do not delete the IAM user for the registered on-premises instance.

See 'aws help' for descriptions of global parameters.


To deregister an on-premises instance

The following deregister example deregisters an on-premises instance with AWS CodeDeploy. It does not delete the IAM user that is associated with the instance. It disassociates in AWS CodeDeploy the on-premises tags from the instance. It does not uninstall the AWS CodeDeploy Agent from the instance nor remove the on-premises configuration file from the instance.

aws deploy deregister \
    --instance-name AssetTag12010298EX \
    --no-delete-iam-user \
    --region us-west-2


Retrieving on-premises instance information... DONE
IamUserArn: arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag12010298EX
Tags: Key=Name,Value=CodeDeployDemo-OnPrem
Removing tags from the on-premises instance... DONE
Deregistering the on-premises instance... DONE
Run the following command on the on-premises instance to uninstall the codedeploy-agent:
aws deploy uninstall