

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# AWS IoT Solução de problemas do Device Management Software Package Catalog
<a name="software-package-catalog-troubleshooting"></a>

Esta é a seção de solução de problemas do AWS IoT Device Management Software Package Catalog.

## Mensagens de erro de solução de problemas geral
<a name="spc-general-troubleshooting"></a>

Esta seção lista os erros comuns observados em todo o ciclo de vida da versão do pacote de software.

**Erros de `HeadBucket`**

As mensagens de erro a seguir aparecem ao chamar a [operação da API `HeadBucket`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html) ou o [comando da CLI `head-bucket`](https://docs.aws.amazon.com/cli/latest/reference/s3api/head-bucket.html) para validar o bucket do Amazon S3 usado para upload de arquivos durante a implantação de um trabalho.

Para obter mais informações sobre como usar um bucket do Amazon S3 para fazer o upload de arquivos durante uma implantação de trabalho, consulte [URL pré-assinada para upload de arquivo](create-manage-jobs.md#create-manage-jobs-presigned-URLs-upload).

```
InvalidRoleException
    "Permission denied when attempting to use role %s to access bucket %s."
```

```
InvalidRequestException
    "Cross region S3 bucket is not supported for presigned url upload placeholder"
```

```
InvalidRequestException
    "S3 bucket in job document presigned url upload placeholder not found"
```

```
InvalidRequestException
    "Given S3 bucket name is invalid."
```

```
InvalidRequestException
    "Provided S3 bucket is not valid: %s. Error: %s"
```

**Amazon S3 GetObject**

A mensagem de erro a seguir ocorre quando um argumento inválido é fornecido, fazendo com que a operação da API `GetObject` do Amazon S3 falhe.

```
InvalidRequestException
    "Provided argument for presigned url is invalid"
```

**Suporte ao ID de versão do Amazon S3**

Ao solicitar acesso a um bucket do Amazon S3 usando o versionamento, inclua o `versionId` ou o erro abaixo poderá ser preenchido.

Para obter mais informações sobre os buckets do Amazon S3 usando versionamento, consulte [Usar versionamento em buckets do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html)

```
InvalidRequestException
    "VersionId not found when attempting to access s3 url"
```

**Espaços reservados dentro de um URL pré-assinado para upload de arquivo**

As mensagens de erro a seguir aparecem ao encontrar problemas com um espaço reservado dentro de um URL pré-assinado usado para carregar arquivos em um bucket do Amazon S3 de destino durante a implantação de um trabalho. Para obter mais informações sobre como usar um bucket do Amazon S3 para fazer o upload de arquivos durante uma implantação de trabalho e sobre o que é um espaço reservado, consulte [URL pré-assinada para upload de arquivo](create-manage-jobs.md#create-manage-jobs-presigned-URLs-upload).

A mensagem de erro abaixo aparece quando o espaço reservado local não é reconhecido.

```
InvalidJobDocumentException
    "Undefined placeholder, ${...}, inside of presign url upload parameter"
```

A mensagem de erro abaixo aparece ao tentar usar o espaço reservado local em um URL pré-assinado não destinado ao upload de arquivo.

```
InvalidJobDocumentException
    "Local placeholder, ${...}, is only valid inside of presign url upload"
```

**URL do Amazon S3 aninhado incorretamente**

A mensagem de erro a seguir aparece quando a URL do Amazon S3 está incorretamente aninhada em outro espaço reservado.

```
InvalidJobDocumentException
    "${aws:%s[...]} should not be the second layer pattern."
```

**Aninhamento de artefato de versão do pacote**

A mensagem de erro a seguir aparece quando o URL pré-assinado de artefato de versão do pacote está incorretamente aninhada em outro espaço reservado.

```
InvalidJobDocumentException
    "${aws:iot:package:[...]:artifact:s3-presigned-url} cannot be nested inside another placeholder."
```

**Artefato de versão do pacote ausente**

A mensagem de erro a seguir aparece quando o artefato da versão do pacote referenciado não é encontrado.

```
InvalidJobDocumentException
    "Package %s version %s does not have an associated artifact to generate an S3 presigned url."
```

**Espaços reservados para pacote de software e versão do pacote**

A mensagem de erro a seguir aparece quando o espaço reservado do documento de trabalho para o pacote de software e a versão do pacote não consegue resolver os valores válidos desejados para a implantação do trabalho porque vários pacotes de software e versões de pacotes são referenciados no parâmetro `destinationPackageVersions` ou na guia *ARN da versão* na página de detalhes de *Versão do pacote*.

```
InvalidJobDocumentException
    "Cannot resolve empty package name and version name given multiple elements in destination package versions."
```

**Usar o pacote de software vazio e a versão do pacote**

A mensagem de erro a seguir aparece quando você tenta usar um pacote vazio ou uma versão de pacote sem a outra em um documento de trabalho.

```
InvalidJobDocumentException
    "Empty package name and version name have to be used in pair."
```

**Uso de Null no documento de trabalho**

A mensagem de erro a seguir aparece quando você tenta especificar `$null` como uma versão do pacote no documento de trabalho. `$null` só pode ser usado dentro do parâmetro `destinationPackageVersions` ao usar a operação da API `CreateJob`.

```
InvalidJobDocumentException
    "$null is not allowed to be referenced as a package version in job documents."
```

**Todos os atributos em uma versão do pacote**

A mensagem de erro a seguir aparece quando você tenta usar todos os atributos em uma versão do pacote e envolvê-la com espaços reservados ou textos adicionais.

Para obter mais informações sobre o uso de todos os atributos em uma versão de pacote de software, consulte [Parâmetros de substituição para trabalhos AWS IoT](preparing-jobs-for-service-package-catalog.md#substitution-parameters)

```
InvalidJobDocumentException
    "The package version attribute placeholder for all attributes has to be a json value by itself and not appended with other strings or nested with other placeholders."
```

**Limite de espaço reservado local em URL pré-assinado para upload de arquivo**

A mensagem de erro a seguir aparece quando você excede o limite do número de espaços reservados locais usados em um URL pré-assinado para upload de arquivos durante a implantação de uma tarefa.

Para obter mais informações sobre o uso de um URL pré-assinado para upload de arquivos durante a implantação de uma tarefa, consulte [URL pré-assinada para upload de arquivo](create-manage-jobs.md#create-manage-jobs-presigned-URLs-upload)

```
InvalidJobDocumentException
    "The occurrence of local placeholder %s within S3 presigned url upload placeholder exceeds limit of %d."
```

**Espaços reservados locais em um bucket do Amazon S3**

A mensagem de erro a seguir aparece quando você tenta colocar um URL de espaço reservado local no nome do bucket do Amazon S3 para um espaço reservado de URL pré-assinado usado para upload de arquivos durante a implantação de um trabalho.

Para obter mais informações sobre o uso de um URL pré-assinado para upload de arquivos durante a implantação de uma tarefa, consulte [URL pré-assinada para upload de arquivo](create-manage-jobs.md#create-manage-jobs-presigned-URLs-upload)

```
InvalidJobDocumentException
    "S3 bucket name in presigned url upload is not allowed to contain any placeholders"
```

**Suportes de abertura e fechamento**

A mensagem de erro a seguir aparece quando você adiciona um parâmetro ou espaço reservado a um documento de trabalho sem a chave de fechamento “\$1”.

```
InvalidJobDocumentException
    "One or more parameters or placeholders are not terminated."
```

**Perfil do IAM com o URL pré-assinado do Amazon S3**

A mensagem de erro a seguir aparece quando você tenta usar um URL pré-assinado do Amazon S3 em um documento de trabalho sem um perfil do IAM.

Para obter mais informações sobre o Amazon S3 pré-assinado URLs, consulte Como [trabalhar](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html) com pré-assinado. URLs

```
InvalidRequestException
    "presignedUrlConfig role ARN is required to generate an S3 presigned url in job document."
```

**Perfil do IAM com o URL pré-assinado do Amazon S3 para artefato de versão do pacote**

A mensagem de erro a seguir aparece quando você tenta usar um URL pré-assinado do Amazon S3 representando um artefato de versão do pacote em um documento de trabalho sem um perfil do IAM.

```
InvalidRequestException
    "presignedUrlConfig role ARN is required to generate an S3 presigned url in job document for package %s version %s artifact."
```

## Mensagens de erro da lista de materiais de software
<a name="spc-sbom-validation-troubleshooting"></a>

Esta seção lista os erros comuns associados a uma lista de materiais de software (SBOM) vinculada a uma versão do pacote.

**Validação de entrada para solicitação de associação da SBOM**

A mensagem de erro a seguir aparece ao usar a operação `AssociateSbomWithPackageVersion` da API e o parâmetro `s3Location` é nulo.

```
InvalidRequestException "Associate request needs to include SBOM reference"
```

Para obter mais informações sobre a operação `AssociateSbomWithPackageVersion` da API, consulte [AssociateSbomWithPackageVersion](https://amazonaws.com/iot/latest/apireference/API_AssociateSbomWithPackageVersion.html).

**Erros de validação da SBOM**

Esta seção lista os erros comuns observados durante a validação inicial da lista de materiais do software (SBOM) quando associada a uma versão do pacote de software.

A mensagem de erro a seguir aparece ao usar a operação da API `AssociateSbomWithPackageVersion` e `bucket` no parâmetro `s3Location` é nulo.

```
InvalidRequestException "S3 bucket name for SBOM cannot be null"
```

A mensagem de erro a seguir aparece quando a sequência de caracteres `bucket` no parâmetro `s3Location` da operação da API `AssociateSbomWithPackageVersion` é longa demais.

```
InvalidRequestException "S3 bucket name for SBOM is illegal. String length exceeds limit"
```

A mensagem de erro a seguir aparece quando o parâmetro `key` é nulo.

```
InvalidRequestException "S3 key name for SBOM cannot be null"
```

A mensagem de erro a seguir aparece quando a sequência de caracteres `key` no parâmetro `s3Location` da operação da API `AssociateSbomWithPackageVersion` é longa demais.

```
InvalidRequestException "S3 key name for SBOM is illegal. String length exceeds limit"
```

A mensagem de erro a seguir aparece quando a sequência de caracteres `version` no parâmetro `s3Location` da operação da API `AssociateSbomWithPackageVersion` é nula.

```
InvalidRequestException "S3 object version for SBOM cannot be null"
```

A mensagem de erro a seguir aparece quando a sequência de caracteres `version` no parâmetro `s3Location` da operação da API `AssociateSbomWithPackageVersion` é longa demais.

```
InvalidRequestException "S3 object version for SBOM is illegal. String length exceeds limit"
```

A mensagem de erro a seguir aparece quando o tamanho do arquivo zip da SBOM armazenado no bucket do Amazon S3 é grande demais.

```
InvalidRequestException "S3 object file size exceeds limit"
```

A mensagem de erro a seguir aparece quando você usa a operação da API `AssociateSbomWithPackageVersion` e o número atual de validações da SBOM em andamento já está no limite máximo.

```
LimitExceededException "Too many ongoing SBOM validation workflows. Please wait and retry"
```

**Problemas de acesso com o arquivo da SBOM no bucket do Amazon S3**

A mensagem de erro a seguir aparece quando outra entidade não consegue acessar o bucket do Amazon S3 porque o bucket do Amazon S3 não existe ou as permissões adequadas não foram concedidas para acessar o bucket do Amazon S3.

Para obter mais informações sobre a política de permissões necessárias para acessar um bucket do Amazon S3, consulte [Armazenamento da lista de materiais de software](preparing-to-use-software-package-catalog.md#spc-sbom-storage).

```
InvalidRequestException "SBOM not accessible by the service. Please make sure the bucket exists and S3 permission is granted."
```

A mensagem de erro a seguir aparece quando outra entidade não consegue acessar o arquivo zip da SBOM no parâmetro `key` porque o bucket do Amazon S3 não existe ou as permissões adequadas não foram concedidas para acessar o conteúdo armazenado no bucket do Amazon S3.

```
InvalidRequestException "SBOM not accessible by the service. Please make sure the key exists and S3 permission is granted."
```

A mensagem de erro a seguir aparece quando outra entidade não consegue acessar o bucket do Amazon S3 porque o bucket, a chave e o ID da versão não existem ou as permissões adequadas não foram concedidas para acessar o bucket do Amazon S3. Além disso, essa mensagem de erro poderá aparecer se as permissões concedidas forem insuficientes para acessar o arquivo zip da SBOM no bucket do Amazon S3.

```
InvalidRequestException "SBOM not accessible by the service. Please make sure the bucket/key/version exists and S3 permission is granted."
```

A mensagem de erro a seguir aparece quando outra entidade não consegue acessar o bucket do Amazon S3 porque o bucket está localizado em outra região.

```
InvalidRequestException "Cross-region S3 bucket for %s is not supported."
```

A mensagem de erro a seguir aparece quando outra entidade não consegue acessar o bucket do Amazon S3 porque os parâmetros `bucket`, `key` ou `version` foram inseridos incorretamente ao usar a operação da API `AssociateSbomWithPackageVersion`.

```
InvalidRequestException "Please make sure SBOM S3 bucket name/key length/version is valid"
```