本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 自动注销本地实例
<a name="on-premises-instances-operations-deregister-automatically"></a>

通常，当您不再计划部署到某个本地实例之后，您可以注销该实例。在您注销本地实例时，即使本地实例可能属于某个部署组的本地实例标签，该本地实例也不会包括在任何部署中。您可以使用取消注册本地实例。 Amazon CLI 

**注意**  
您不能使用 CodeDeploy 控制台注销本地实例。此外，注销本地实例还会删除与本地实例关联的任何本地实例标签。它不会从本地实例中卸载 CodeDeploy 代理。此操作不会从本地实例中删除本地实例配置文件。  
要使用 CodeDeploy 控制台执行本节中的某些（但不是全部）活动，请参阅的 CodeDeploy 控制台部分[手动取消注册本地实例](on-premises-instances-operations-deregister-manually.md)。  
要手动取消任何已关联本地实例标签的关联，请参阅[从本地实例中手动删除本地实例标签](on-premises-instances-operations-remove-tags.md)。  
要自动卸载 CodeDeploy 代理并从本地实例中删除配置文件，请参阅[自动卸载 CodeDeploy 代理并从本地实例中删除配置文件](on-premises-instances-operations-uninstall-agent.md)。  
要仅从本地实例手动卸载 CodeDeploy 代理，请参阅[管理 CodeDeploy 代理操作](codedeploy-agent-operations.md)。

使用调 Amazon CLI 用[取消注册](https://docs.amazonaws.cn/cli/latest/reference/deploy/deregister.html)命令，指定：
+ 唯一标识本地实例的名称 CodeDeploy （带`--instance-name`选项）。
+  （可选）是否删除与本地实例关联的 IAM 用户。默认行为是删除 IAM 用户。如果您不希望删除与本地实例关联的 IAM 用户，请在命令中指定 `--no-delete-iam-user` 选项。
+ （可选）注册本地实例的 Amazon 区域 CodeDeploy（带`--region`选项）。这必须是《Amazon Web Services 一般参考》**的[区域和终端节点](https://docs.amazonaws.cn/general/latest/gr/rande.html#codedeploy_region)中列出的受支持区域之一（例如 `us-west-2`）。如果未指定此选项，则将使用与调用 IAM 用户关联的默认 Amazon 区域。

注销实例并删除用户的示例：

```
aws deploy deregister --instance-name AssetTag12010298EX --region us-west-2
```

注销实例但不删除用户的示例：

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

**deregister** 命令执行以下操作：

1. 向注销本地实例。 CodeDeploy

1. 如果指定，则删除与本地实例关联的 IAM 用户。

如果此命令遇到错误，则将显示错误消息，说明您可以如何手动完成剩余步骤。否则，将显示成功消息，说明如何调用 **uninstall** 命令。