Na}{

File Content: `deregister.rst`

**To deregister an on-premises instance**

This 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.

Command::

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

Output::

  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

Name	Size	Permission
add-tags-to-on-premises-instances.rst	419 bytes	0644
batch-get-applications.rst	745 bytes	0644
batch-get-deployments.rst	2361 bytes	0644
batch-get-on-premises-instances.rst	1133 bytes	0644
create-application.rst	270 bytes	0644
create-deployment-config.rst	384 bytes	0644
create-deployment-group.rst	585 bytes	0644
create-deployment.rst	481 bytes	0644
delete-application.rst	209 bytes	0644
delete-deployment-config.rst	259 bytes	0644
delete-deployment-group.rst	292 bytes	0644
deregister-on-premises-instance.rst	543 bytes	0644
deregister.rst	904 bytes	0644
get-application-revision.rst	975 bytes	0644
get-application.rst	452 bytes	0644
get-deployment-config.rst	605 bytes	0644
get-deployment-group.rst	911 bytes	0644
get-deployment-instance.rst	2009 bytes	0644
get-deployment.rst	1175 bytes	0644
get-on-premises-instance.rst	651 bytes	0644
install.rst	766 bytes	0644
list-application-revisions.rst	983 bytes	0644
list-applications.rst	293 bytes	0644
list-deployment-configs.rst	442 bytes	0644
list-deployment-groups.rst	389 bytes	0644
list-deployment-instances.rst	372 bytes	0644
list-deployments.rst	507 bytes	0644
list-on-premises-instances.rst	511 bytes	0644
push.rst	928 bytes	0644
register-application-revision.rst	468 bytes	0644
register-on-premises-instance.rst	460 bytes	0644
register.rst	964 bytes	0644
remove-tags-from-on-premises-instances.rst	641 bytes	0644
stop-deployment.rst	360 bytes	0644
uninstall.rst	473 bytes	0644
update-application.rst	279 bytes	0644
update-deployment-group.rst	588 bytes	0644

Name

Size

Permission

Action

add-tags-to-on-premises-instances.rst

419 bytes

0644