• Amazon Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。
# 删除 Distributor 软件包
本节介绍如何删除软件包。您不能删除某个版本的软件包，只能删除整个软件包。
## 使用控制台删除软件包
您可以使用 Amazon Systems Manager 控制台从 Distributor（Amazon Systems Manager 中的一项工具）中删除软件包或软件包版本。删除软件包将从 Distributor 删除此软件包的所有版本。
**若要使用控制台删除软件包**
1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.amazonaws.cn/systems-manager/)，打开 Amazon Systems Manager 控制台。
1. 在导航窗格中，请选择 **Distributor**。
1. 在 **Distributor** 主页上，选择要删除的软件包。
1. 在软件包的详细信息页面上，选择 **Delete package (删除软件包)**。
1. 当系统提示确认删除时，选择 **Delete package (删除软件包)**。
## 使用控制台删除软件包版本
您可以使用 Systems Manager 控制台从 Distributor 中删除软件包版本。
**若要使用控制台删除软件包版本**
1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.amazonaws.cn/systems-manager/)，打开 Amazon Systems Manager 控制台。
1. 在导航窗格中，请选择 **Distributor**。
1. 在 **Distributor** 主页上，选择要删除其版本的软件包。
1. 在软件包的版本页面上，选择要删除的版本，然后选择 **Delete version (删除版本)**。
1. 当系统提示确认删除时，选择 **Delete package version (删除软件包版本)**。
## 使用命令行删除软件包
您可以使用首选命令行工具从 Distributor 中删除软件包。
------
#### [ Linux & macOS ]
**若要使用 Amazon 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 ]
**若要使用 Amazon 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)
```
------
## 使用命令行删除软件包版本
您可以使用首选命令行工具从 Distributor 中删除软件包版本。
------
#### [ Linux & macOS ]
**若要使用 Amazon 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 ]
**若要使用 Amazon 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** 命令结合使用的其他选项的信息，请参阅 *Amazon CLI 命令参考* Amazon Systems Manager 一节中的 [https://docs.amazonaws.cn/cli/latest/reference/ssm/list-documents.html](https://docs.amazonaws.cn/cli/latest/reference/ssm/list-documents.html)。有关可以与 **delete-document** 命令配合使用的其他选项的信息，请参阅 [https://docs.amazonaws.cn/cli/latest/reference/ssm/delete-document.html](https://docs.amazonaws.cn/cli/latest/reference/ssm/delete-document.html)。