• 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 控制台从 Distributor（AWS 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. 在软件包的详细信息页面上，选择 **Delete package (删除软件包)**。

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. 在软件包的版本页面上，选择要删除的版本，然后选择 **Delete version (删除版本)**。

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 命令参考* 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)。