• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# Excluir um pacote do Distributor
<a name="distributor-working-with-packages-dpkg"></a>

Esta seção descreve como excluir um pacote. Você não pode excluir uma versão de um pacote, somente o pacote inteiro.

## Excluir um pacote usando o console
<a name="distributor-delete-pkg-console"></a>

Você pode usar o console do AWS Systems Manager para excluir um pacote ou a versão de um pacote do Distributor, uma ferramenta do AWS Systems Manager. Excluir um pacote excluirá todas as versões de um pacote do Distributor.

**Para excluir um pacote usando o console**

1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. No painel de navegação, escolha **Distributor**.

1. Na página inicial do **Distributor**, selecione o pacote que deseja excluir.

1. Na página de detalhes do pacote, escolha **Excluir pacote**.

1. Quando for solicitado a confirmar a exclusão, escolha **Delete package** (Excluir pacote).

## Excluir uma versão de pacote usando o console
<a name="distributor-delete-pkg-version-console"></a>

É possível usar o console do Systems Manager para excluir uma versão pacote do Distributor.

**Para excluir uma versão de pacote usando o console**

1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. No painel de navegação, escolha **Distributor**.

1. Na página inicial do **Distributor**, selecione o pacote a ser excluído.

1. Na página de versões do pacote, escolha a versão a ser excluída e escolha **Delete version (Excluir versão)**.

1. Quando for solicitado a confirmar a exclusão, escolha **Delete package version** (Excluir versão do pacote).

## Excluir um pacote usando a linha de comando
<a name="distributor-delete-pkg-cli"></a>

Você pode usar a ferramenta de linha de comando de sua preferência para excluir um pacote do Distributor.

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

**Para excluir um pacote usando a AWS CLI**

1. Execute o comando a seguir para listar documentos para pacotes específicos. Nos resultados deste comando, procure o pacote que você deseja excluir.

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

1. Execute o seguinte comando para excluir um pacote. Substitua {{package-name}} pelo nome do pacote.

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

1. Execute o comando **list-documents** novamente para verificar se o pacote foi excluído. O pacote que você excluiu não deve ser incluído na lista.

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

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

**Para excluir um pacote usando a AWS CLI**

1. Execute o comando a seguir para listar documentos para pacotes específicos. Nos resultados deste comando, procure o pacote que você deseja excluir.

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

1. Execute o seguinte comando para excluir um pacote. Substitua {{package-name}} pelo nome do pacote.

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

1. Execute o comando **list-documents** novamente para verificar se o pacote foi excluído. O pacote que você excluiu não deve ser incluído na lista.

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

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

**Para excluir um pacote usando as Ferramentas para PowerShell**

1. Execute o comando a seguir para listar documentos para pacotes específicos. Nos resultados deste comando, procure o pacote que você deseja excluir.

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

1. Execute o seguinte comando para excluir um pacote. Substitua {{package-name}} pelo nome do pacote.

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

1. Execute o comando **Get-SSMDocumentList** novamente para verificar se o pacote foi excluído. O pacote que você excluiu não deve ser incluído na lista.

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

------

## Excluir uma versão de pacote usando a linha de comando
<a name="distributor-delete-pkg-version-cli"></a>

Você pode usar a ferramenta de linha de comando de sua preferência para excluir uma versão de pacote do Distributor.

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

**Para excluir uma versão de pacote usando a AWS CLI**

1. Execute o seguinte comando para listar as versões do seu pacote. Nos resultados desse comando, procure a versão do pacote que você deseja excluir.

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

1. Execute o seguinte comando para excluir uma versão do pacote. Substitua {{package-name}} pelo nome do pacote e {{version}} pelo número da versão.

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

1. Execute o comando **list-document-versions** para verificar se a versão do pacote foi excluída. A versão do pacote que você excluiu não deve mais ser encontrada.

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

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

**Para excluir uma versão de pacote usando a AWS CLI**

1. Execute o seguinte comando para listar as versões do seu pacote. Nos resultados desse comando, procure a versão do pacote que você deseja excluir.

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

1. Execute o seguinte comando para excluir uma versão do pacote. Substitua {{package-name}} pelo nome do pacote e {{version}} pelo número da versão.

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

1. Execute o comando **list-document-versions** para verificar se a versão do pacote foi excluída. A versão do pacote que você excluiu não deve mais ser encontrada.

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

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

**Para excluir uma versão do pacote usando as Ferramentas para PowerShell**

1. Execute o seguinte comando para listar as versões do seu pacote. Nos resultados desse comando, procure a versão do pacote que você deseja excluir.

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

1. Execute o seguinte comando para excluir uma versão do pacote. Substitua {{package-name}} pelo nome do pacote e {{version}} pelo número da versão.

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

1. Execute o comando **Get-SSMDocumentVersionList** para verificar se a versão do pacote foi excluída. A versão do pacote que você excluiu não deve mais ser encontrada.

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

------

Para obter informações sobre outras opções que podem ser usadas com o comando **list-documents**, consulte [https://docs.aws.amazon.com/cli/latest/reference/ssm/list-documents.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/list-documents.html) na seção AWS Systems Manager da *Referência de comando da AWS CLI*. Para obter informações sobre outras opções que podem ser usadas com o comando **delete-document**, consulte [https://docs.aws.amazon.com/cli/latest/reference/ssm/delete-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/delete-document.html).