기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 온프레미스 인스턴스 등록 자동 취소
<a name="on-premises-instances-operations-deregister-automatically"></a>

일반적으로 온프레미스 인스턴스에 더 이상 배포할 계획이 없는 경우 등록을 취소합니다. 온프레미스 인스턴스의 등록을 취소하면 온프레미스 인스턴스가 배포 그룹의 온프레미스 인스턴스 태그의 일부일 수 있지만 온프레미스 인스턴스는 배포에 포함되지 않습니다. 를 사용하여 온프레미스 인스턴스의 등록 AWS CLI 을 취소할 수 있습니다.

**참고**  
CodeDeploy 콘솔을 사용하여 온프레미스 인스턴스를 등록 취소할 수 없습니다. 또한 온프레미스 인스턴스를 등록 취소하면 온프레미스 인스턴스와 연결된 모든 온프레미스 인스턴스 태그가 제거됩니다. 온프레미스 인스턴스에서 CodeDeploy 에이전트를 제거하지 않습니다. 온프레미스 인스턴스에서 온프레미스 인스턴스 구성 파일은 제거하지 않습니다.  
CodeDeploy 콘솔을 사용하여 이 섹션의 일부 (전부는 아님) 작업을 수행하려면 [온프레미스 인스턴스 등록을 수동으로 취소합니다.](on-premises-instances-operations-deregister-manually.md)의 CodeDeploy 콘솔 섹션을 참조하세요.  
연결된 온프레미스 인스턴스 태그의 연결을 수동으로 해제하려면 [온프레미스 인스턴스에서 온프레미스 인스턴스 태그 수동 제거](on-premises-instances-operations-remove-tags.md) 단원을 참조하세요.  
CodeDeploy 에이전트를 자동으로 제거하고 온프레미스 인스턴스에서 구성 파일을 제거하려면 [CodeDeploy 에이전트를 자동으로 제거하고 온프레미스 인스턴스에서 구성 파일 제거](on-premises-instances-operations-uninstall-agent.md) 단원을 참조하세요.  
온프레미스 인스턴스에서 CodeDeploy 에이전트만 수동으로 제거하려면 [CodeDeploy 에이전트 작업 관리](codedeploy-agent-operations.md) 단원을 참조하세요.

를 사용하여 [등록 취소](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister.html) 명령을 호출 AWS CLI 하고 다음을 지정합니다.
+ CodeDeploy에 대한 온프레미스 인스턴스를 고유하게 식별하는 이름(`--instance-name` 옵션 사용).
+  (선택 사항) 온프레미스 인스턴스와 연결된 IAM 사용자를 삭제할지 여부. 기본 동작은 IAM 사용자를 삭제하는 것입니다. 온프레미스 인스턴스와 연결된 IAM 사용자를 삭제하지 않으려는 경우, 명령에서 `--no-delete-iam-user` 옵션을 지정하세요.
+ 선택적으로 온프레미스 인스턴스가 CodeDeploy에 등록된 AWS 리전입니다( `--region` 옵션 사용). *AWS 일반 참조*의 [리전 및 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region)에서 나열된 지원되는 리전 중 하나여야 합니다(예: `us-west-2`). 이 옵션을 지정하지 않으면 호출하는 IAM 사용자와 연결된 기본 AWS 리전이 사용됩니다.

인스턴스를 등록 취소하고 사용자를 삭제하는 예는 다음과 같습니다.

```
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** 명령을 호출하는 방법을 설명하는 성공 메시지가 나타납니다.