• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요.

# Distributor 패키지 삭제
<a name="distributor-working-with-packages-dpkg"></a>

이 섹션은 패키지를 삭제하는 방법을 설명합니다. 패키지 버전은 삭제할 수 없으며 전체 패키지만 삭제할 수 있습니다.

## 콘솔을 사용한 패키지 삭제
<a name="distributor-delete-pkg-console"></a>

AWS Systems Manager 콘솔을 사용하여 AWS Systems Manager의 도구인 Distributor에서 패키지 또는 패키지 버전을 삭제할 수 있습니다. 이 패키지를 삭제하면 Distributor에서 모든 패키지 버전이 삭제됩니다.

**콘솔을 사용하여 패키지를 삭제하려면**

1. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)에서 AWS Systems Manager 콘솔을 엽니다.

1. 탐색 창에서 **Distributor**를 선택합니다.

1. **Distributor** 홈 페이지에서 삭제할 패키지를 선택합니다.

1. 패키지 세부 정보 페이지에서 **패키지 삭제**를 선택합니다.

1. 삭제를 확인하라는 메시지가 표시되면 [**패키지 삭제(Delete package)**]를 선택합니다.

## 콘솔을 사용한 패키지 버전 삭제
<a name="distributor-delete-pkg-version-console"></a>

Systems Manager 콘솔을 사용하여 Distributor에서 패키지 버전을 삭제할 수 있습니다.

**콘솔을 사용하여 패키지 버전을 삭제하려면**

1. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)에서 AWS Systems Manager 콘솔을 엽니다.

1. 탐색 창에서 **Distributor**를 선택합니다.

1. **Distributor** 홈 페이지에서 삭제할 패키지 버전을 선택합니다.

1. 패키지의 버전 페이지에서 삭제할 버전을 선택하고 **버전 삭제**를 선택합니다.

1. 삭제를 확인하라는 메시지가 표시되면 [**패키지 버전 삭제(Delete package version)**]를 선택합니다.

## 명령줄을 사용한 패키지 삭제
<a name="distributor-delete-pkg-cli"></a>

선호하는 명령줄 도구를 사용하여 Distributor에서 패키지를 삭제할 수 있습니다.

------
#### [ Linux & macOS ]

**AWS CLI를 사용하여 패키지를 삭제하려면**

1. 다음 명령을 실행하여 특정 패키지에 대한 문서를 나열합니다. 이 명령의 결과에서 삭제하려는 패키지를 찾습니다.

   ```
   aws ssm list-documents \
       --filters Key=Name,Values=package-name
   ```

1. 다음 명령을 실행하여 패키지를 삭제합니다. *package-name*을 패키지 파일 이름으로 바꿉니다.

   ```
   aws ssm delete-document \
       --name "package-name"
   ```

1. **list-documents** 명령을 다시 실행하여 패키지가 삭제되었는지 확인합니다. 삭제한 패키지가 목록에 포함되어서는 안 됩니다.

   ```
   aws ssm list-documents \
       --filters Key=Name,Values=package-name
   ```

------
#### [ Windows ]

**AWS CLI를 사용하여 패키지를 삭제하려면**

1. 다음 명령을 실행하여 특정 패키지에 대한 문서를 나열합니다. 이 명령의 결과에서 삭제하려는 패키지를 찾습니다.

   ```
   aws ssm list-documents ^
       --filters Key=Name,Values=package-name
   ```

1. 다음 명령을 실행하여 패키지를 삭제합니다. *package-name*을 패키지 파일 이름으로 바꿉니다.

   ```
   aws ssm delete-document ^
       --name "package-name"
   ```

1. **list-documents** 명령을 다시 실행하여 패키지가 삭제되었는지 확인합니다. 삭제한 패키지가 목록에 포함되어서는 안 됩니다.

   ```
   aws ssm list-documents ^
       --filters Key=Name,Values=package-name
   ```

------
#### [ PowerShell ]

**Tools for PowerShell을 사용하여 패키지를 삭제하려면**

1. 다음 명령을 실행하여 특정 패키지에 대한 문서를 나열합니다. 이 명령의 결과에서 삭제하려는 패키지를 찾습니다.

   ```
   $filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
   $filter.Key = "Name"
   $filter.Values = "package-name"
   
   Get-SSMDocumentList `
       -Filters @($filter)
   ```

1. 다음 명령을 실행하여 패키지를 삭제합니다. *package-name*을 패키지 파일 이름으로 바꿉니다.

   ```
   Remove-SSMDocument `
       -Name "package-name"
   ```

1. **Get-SSMDocumentList** 명령을 다시 실행하여 패키지가 삭제되었는지 확인합니다. 삭제한 패키지가 목록에 포함되어서는 안 됩니다.

   ```
   $filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
   $filter.Key = "Name"
   $filter.Values = "package-name"
   
   Get-SSMDocumentList `
       -Filters @($filter)
   ```

------

## 명령줄을 사용한 패키지 버전 삭제
<a name="distributor-delete-pkg-version-cli"></a>

선호하는 명령줄 도구를 사용하여 Distributor에서 패키지 버전을 삭제할 수 있습니다.

------
#### [ Linux & macOS ]

**AWS CLI를 사용하여 패키지 버전을 삭제하려면**

1. 다음 명령을 실행하여 패키지 버전을 나열합니다. 이 명령의 결과에서 삭제하려는 패키지 버전을 찾습니다.

   ```
   aws ssm list-document-versions \
       --name "package-name"
   ```

1. 다음 명령을 실행하여 패키지 버전을 삭제합니다. *package-name*을 패키지 이름으로 바꾸고 *version*을 버전 번호로 바꿉니다.

   ```
   aws ssm delete-document \
       --name "package-name" \
       --document-version version
   ```

1. **list-document-versions** 명령을 실행하여 패키지 버전이 삭제되었는지 확인합니다. 삭제한 패키지 버전은 검색되지 않아야 합니다.

   ```
   aws ssm list-document-versions \
       --name "package-name"
   ```

------
#### [ Windows ]

**AWS CLI를 사용하여 패키지 버전을 삭제하려면**

1. 다음 명령을 실행하여 패키지 버전을 나열합니다. 이 명령의 결과에서 삭제하려는 패키지 버전을 찾습니다.

   ```
   aws ssm list-document-versions ^
       --name "package-name"
   ```

1. 다음 명령을 실행하여 패키지 버전을 삭제합니다. *package-name*을 패키지 이름으로 바꾸고 *version*을 버전 번호로 바꿉니다.

   ```
   aws ssm delete-document ^
       --name "package-name" ^
       --document-version version
   ```

1. **list-document-versions** 명령을 실행하여 패키지 버전이 삭제되었는지 확인합니다. 삭제한 패키지 버전은 검색되지 않아야 합니다.

   ```
   aws ssm list-document-versions ^
       --name "package-name"
   ```

------
#### [ PowerShell ]

**Tools for PowerShell을 사용하여 패키지 버전을 삭제하려면**

1. 다음 명령을 실행하여 패키지 버전을 나열합니다. 이 명령의 결과에서 삭제하려는 패키지 버전을 찾습니다.

   ```
   Get-SSMDocumentVersionList `
       -Name "package-name"
   ```

1. 다음 명령을 실행하여 패키지 버전을 삭제합니다. *package-name*을 패키지 이름으로 바꾸고 *version*을 버전 번호로 바꿉니다.

   ```
   Remove-SSMDocument `
       -Name "package-name" `
       -DocumentVersion version
   ```

1. **Get-SSMDocumentVersionList** 명령을 실행하여 패키지 버전이 삭제되었는지 확인합니다. 삭제한 패키지 버전은 검색되지 않아야 합니다.

   ```
   Get-SSMDocumentVersionList `
       -Name "package-name"
   ```

------

**list-documents** 명령과 함께 사용할 수 있는 다른 옵션에 대한 자세한 내용은 *AWS CLI Command Reference*의 AWS Systems Manager 섹션에 있는 [https://docs.aws.amazon.com/cli/latest/reference/ssm/list-documents.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/list-documents.html)를 참조하세요. **delete-document** 명령과 함께 사용할 수 있는 다른 옵션에 대한 자세한 내용은 [https://docs.aws.amazon.com/cli/latest/reference/ssm/delete-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/delete-document.html)를 참조하세요.