• 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).
# AWS Systems ManagerSolução de problemasDistributor
As informações a seguir podem ajudá-lo a solucionar problemas que podem ocorrer ao usar o Distributor, uma ferramenta do AWS Systems Manager.
**Topics**
+ [Pacote incorreto com o mesmo nome está instalado](#distributor-tshoot-1)
+ [Erro: falha ao recuperar manifesto: não foi possível encontrar a versão mais recente do pacote](#distributor-tshoot-2)
+ [Erro: falha ao recuperar manifesto: exceção de validação](#distributor-tshoot-3)
+ [O pacote não é compatível (a ação de instalação está faltando no pacote)](#distributor-tshoot-4)
+ [Erro: Falha ao baixar o manifesto: Documento com nome não existe](#distributor-tshoot-5)
+ [O upload falhou.](#distributor-tshoot-6)
+ [Erro: falha ao localizar a plataforma: nenhum manifesto encontrado para a plataforma: oracle, versão 8.9, arquitetura x86\_64](#distributor-tshoot-7)
## Pacote incorreto com o mesmo nome está instalado
**Problema:** você instalou um pacote, mas o Distributor instalou um pacote diferente.
**Causa**: durante a instalação, o Systems Manager localiza pacotes publicados pela AWS como resultados, antes dos pacotes externos definidos pelo usuário. Se o nome do pacote definido pelo usuário for o mesmo que um nome de pacote publicado pela AWS, o pacote da AWS será instalado em vez do seu pacote.
**Solução:** para evitar esse problema, dê um nome ao seu pacote que seja diferente do nome de um pacote publicado pela AWS.
## Erro: falha ao recuperar manifesto: não foi possível encontrar a versão mais recente do pacote
**Problema:** você recebeu um erro semelhante ao seguinte:
```
Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package
arn:aws:ssm:::package/{{package-name}} status code: 400, request id: {{guid}}
```
**Causa**: você está usando uma versão do SSM Agent cujo com o Distributor, que é anterior à versão 2.3.274.0.
**Solução:** atualize a versão do SSM Agent para a versão 2.3.274.0 ou posterior. Para ter mais informações, consulte [Atualização do SSM Agent por meio de Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) ou [Walkthrough: Automatically update SSM Agent with the AWS CLI](state-manager-update-ssm-agent-cli.md).
## Erro: falha ao recuperar manifesto: exceção de validação
**Problema:** você recebeu um erro semelhante ao seguinte:
```
Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:{{region-id}}:{{account-id}}:package/{{package-name}}
```
**Causa**: você está usando uma versão do SSM Agent cujo com o Distributor, que é anterior à versão 2.3.274.0.
**Solução:** atualize a versão do SSM Agent para a versão 2.3.274.0 ou posterior. Para ter mais informações, consulte [Atualização do SSM Agent por meio de Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) ou [Walkthrough: Automatically update SSM Agent with the AWS CLI](state-manager-update-ssm-agent-cli.md).
## O pacote não é compatível (a ação de instalação está faltando no pacote)
**Problema:** você recebeu um erro semelhante ao seguinte:
```
Package is not supported (package is missing install action)
```
**Causa:** a estrutura do diretório do pacote está incorreta.
**Solução:** não compacte um diretório pai contendo o software e os scripts necessários. Em vez disso, crie um arquivo `.zip` de todos os conteúdos necessários diretamente no caminho absoluto. Para verificar se o `.zip` foi criado corretamente, descompacte o diretório da plataforma de destino e revise a estrutura do diretório. Por exemplo, o caminho absoluto do script de instalação deve ser `/{{ExamplePackage_targetPlatform}}/install.sh`.
## Erro: Falha ao baixar o manifesto: Documento com nome não existe
**Problema:** você recebeu um erro semelhante ao seguinte:
```
Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name {{filename}} does not exist.
```
**Causa 1**: o Distributor não consegue encontrar o pacote pelo nome ao compartilhar um pacote do Distributor de outra conta.
**Solução 1:** ao compartilhar um pacote de outra conta, use o nome do recurso da Amazon (ARN) completo do pacote, não apenas o nome.
**Causa 2:** ao usar uma VPC, você não forneceu ao seu perfil de instância do IAM acesso ao bucket do S3 gerenciado pela AWS que contém o documento `AWS-ConfigureAWSPackage` para a Região da AWS que você está direcionando.
**Solução 2:** certifique-se de que seu perfil de instância do IAM forneça ao SSM Agent acesso ao bucket do S3 gerenciado pela AWS que contém o documento `AWS-ConfigureAWSPackage` para a Região da AWS que você está direcionando, conforme explicado em [SSM Agent Comunicações do AWS com os buckets do S3 gerenciados pela](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions).
## O upload falhou.
**Problema:** você recebeu um erro semelhante a este.
```
Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.
```
**Causa:** o nome do pacote de software inclui um espaço. Por exemplo, `Hello World.msi` falharia no upload.
## Erro: falha ao localizar a plataforma: nenhum manifesto encontrado para a plataforma: oracle, versão 8.9, arquitetura x86\_64
**Problema:** você recebeu um erro semelhante a este.
```
Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64
```
**Causa:** o erro significa que o manifesto do pacote JSON não tem uma definição para a plataforma, neste caso, o Oracle Linux.
**Solução:** no site do [Trend Micro Deep Security Software](https://help.deepsecurity.trendmicro.com/software.html), baixe o pacote que você deseja distribuir. Crie um pacote de software `.rpm` usando o [Criar um pacote usando o fluxo de trabalho Simples](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple). Defina os valores a seguir para o pacote e finalize o upload do pacote de software utilizando o Distributor:
```
Platform version: _any
Target platform: oracle
Architecture: x86_64
```