CmdID / aws / aws deploy
aws deploy deregister
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. AWS CLI reference
1 example 2 options Its page in the AWS CLI reference
Examples
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-userIdentify--instance-nameThe name of the on-premises instance.--no-delete-iam-userDo not delete the IAM user for the registered on-premises instance.Its 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 uninstallFor more information, see Automatically deregister an on-premises instance in the AWS CodeDeploy User Guide.
Options
--instance-nameThe name of the on-premises instance.--no-delete-iam-userDo not delete the IAM user for the registered on-premises instance.