

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# AWS IoT Fehlerbehebung im Geräteverwaltungs-Softwarepaketkatalog
<a name="software-package-catalog-troubleshooting"></a>

Dies ist der Abschnitt zur Fehlerbehebung für den AWS IoT Geräteverwaltungs-Softwarepaketkatalog.

## Allgemeine Fehlermeldungen zur Fehlerbehebung
<a name="spc-general-troubleshooting"></a>

In diesem Abschnitt werden die häufigsten Fehler aufgeführt, die während des gesamten Lebenszyklus der Softwarepaketversionen auftreten.

**`HeadBucket`-Fehler**

Die folgenden Fehlermeldungen werden angezeigt, wenn Sie den [`HeadBucket`API-Vorgang](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html) oder den [`head-bucket`CLI-Befehl](https://docs.aws.amazon.com/cli/latest/reference/s3api/head-bucket.html) aufrufen, um den Amazon S3 S3-Bucket zu validieren, der für den Datei-Upload während einer Jobbereitstellung verwendet wurde.

Weitere Informationen zur Verwendung eines Amazon S3 S3-Buckets zum Hochladen von Dateien während einer Auftragsbereitstellung finden Sie unter[Vorsignierte URL für den Datei-Upload](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**

Die folgende Fehlermeldung tritt auf, wenn ein ungültiges Argument angegeben wird, was dazu führt, dass der Amazon S3 `GetObject` S3-API-Vorgang fehlschlägt.

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

**Support Amazon S3 S3-Versions-ID**

Wenn Sie mithilfe der Versionskontrolle Zugriff auf einen Amazon S3 S3-Bucket anfordern, stellen Sie sicher, dass Sie Ihren Namen angeben, `versionId` da sonst der folgende Fehler angezeigt werden kann.

Weitere Informationen zu Amazon S3 S3-Buckets, die Versionskontrolle verwenden, finden Sie unter [Verwenden der Versionierung in](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html) Amazon S3 S3-Buckets

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

**Platzhalter innerhalb einer vorsignierten URL für den Datei-Upload**

Die folgenden Fehlermeldungen werden angezeigt, wenn während einer Auftragsbereitstellung Probleme mit einem Platzhalter innerhalb einer vorsignierten URL auftreten, die zum Hochladen von Dateien in einen Amazon S3 S3-Ziel-Bucket verwendet wird. Weitere Informationen zur Verwendung eines Amazon S3 S3-Buckets zum Hochladen von Dateien während einer Auftragsbereitstellung und darüber, was ein lokaler Platzhalter ist, finden Sie unter. [Vorsignierte URL für den Datei-Upload](create-manage-jobs.md#create-manage-jobs-presigned-URLs-upload)

Die folgende Fehlermeldung wird angezeigt, wenn der lokale Platzhalter nicht erkannt wird.

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

Die folgende Fehlermeldung wird angezeigt, wenn versucht wird, den lokalen Platzhalter in einer vorsignierten URL zu verwenden, die nicht für das Hochladen von Dateien vorgesehen ist.

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

**Amazon S3 S3-URL falsch verschachtelt**

Die folgende Fehlermeldung wird angezeigt, wenn die Amazon S3 S3-URL falsch in einem anderen Platzhalter verschachtelt ist.

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

**Paketversion Artifact Nesting**

Die folgende Fehlermeldung wird angezeigt, wenn die vorsignierte URL des Artefakts der Paketversion fälschlicherweise in einem anderen Platzhalter verschachtelt ist.

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

**Artifact der fehlenden Paketversion**

Die folgende Fehlermeldung wird angezeigt, wenn das Artefakt der Paketversion, auf das verwiesen wird, nicht gefunden wird.

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

**Platzhalter für Softwarepakete und Paketversionen**

Die folgende Fehlermeldung wird angezeigt, wenn der Platzhalter für das Jobdokument für das Softwarepaket und die Paketversion nicht in die gewünschten gültigen Werte für die Auftragsbereitstellung aufgelöst werden kann, da auf mehrere Softwarepakete und Paketversionen verwiesen wird, auf die im `destinationPackageVersions` Parameter oder auf der Registerkarte *Versions-ARN* auf der Seite mit den *Paketversionsdetails* verwiesen wird.

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

**Leeres Softwarepaket und Paketversion verwenden**

Die folgende Fehlermeldung wird angezeigt, wenn Sie versuchen, ein leeres Paket oder eine leere Paketversion ohne die andere Version in einem Jobdokument zu verwenden.

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

**Null-Verwendung im Jobdokument**

Die folgende Fehlermeldung wird angezeigt, wenn Sie versuchen, eine Paketversion im Jobdokument anzugeben`$null`. `$null`kann nur innerhalb des `destinationPackageVersions` Parameters verwendet werden, wenn die `CreateJob` API-Operation verwendet wird.

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

**Alle Attribute in einer Paketversion**

Die folgende Fehlermeldung wird angezeigt, wenn Sie versuchen, alle Attribute in einer Paketversion zu verwenden und diese mit zusätzlichem Text oder Platzhaltern zu umgeben.

Weitere Informationen zur Verwendung aller Attribute in einer Softwarepaketversion finden Sie unter [Ersetzungsparameter für Jobs 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."
```

**Lokales Platzhalterlimit in der vorsignierten URL für den Datei-Upload**

Die folgende Fehlermeldung wird angezeigt, wenn Sie das Limit für die Anzahl der lokalen Platzhalter überschreiten, die in einer vorsignierten URL für das Hochladen von Dateien während einer Auftragsbereitstellung verwendet werden.

Weitere Informationen zur Verwendung einer vorsignierten URL für das Hochladen von Dateien während einer Stellenbereitstellung finden Sie unter [Vorsignierte URL für den Datei-Upload](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."
```

**Lokale Platzhalter in einem Amazon S3 S3-Bucket**

Die folgende Fehlermeldung wird angezeigt, wenn Sie versuchen, eine lokale Platzhalter-URL im Amazon S3 S3-Bucket-Namen für einen vorsignierten URL-Platzhalter zu platzieren, der für den Datei-Upload während einer Jobbereitstellung verwendet wird.

Weitere Informationen zur Verwendung einer vorsignierten URL für den Datei-Upload während einer Jobbereitstellung finden Sie unter [Vorsignierte URL für den Datei-Upload](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"
```

**Klammern öffnen und schließen**

Die folgende Fehlermeldung wird angezeigt, wenn Sie einem Jobdokument einen Parameter oder Platzhalter ohne schließende Klammer „\$1“ hinzufügen.

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

**IAM-Rolle mit vorsignierter Amazon S3 S3-URL**

Die folgende Fehlermeldung wird angezeigt, wenn Sie versuchen, eine vorsignierte Amazon S3 S3-URL in einem Jobdokument ohne IAM-Rolle zu verwenden.

Weitere Informationen zu Amazon S3 Presigned URLs finden Sie unter [Working with URLs presigned](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html).

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

**IAM-Rolle mit vorsignierter Amazon S3 S3-URL für Package Version Artifact**

Die folgende Fehlermeldung wird angezeigt, wenn Sie versuchen, eine vorsignierte Amazon S3 S3-URL zu verwenden, die ein Paketversionsartefakt in einem Auftragsdokument ohne IAM-Rolle darstellt.

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

## Fehlermeldungen zur Stückliste der Software
<a name="spc-sbom-validation-troubleshooting"></a>

In diesem Abschnitt werden häufig auftretende Fehler im Zusammenhang mit einer Softwareliste (SBOM) aufgeführt, die mit einer Paketversion verknüpft ist.

**Eingabevalidierung für die SBOM-Zuordnungsanfrage**

Die folgende Fehlermeldung wird angezeigt, wenn der `AssociateSbomWithPackageVersion` API-Vorgang verwendet wird und der `s3Location` Parameter Null ist.

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

Weitere Informationen zum `AssociateSbomWithPackageVersion` API-Vorgang finden Sie unter [AssociateSbomWithPackageVersion](https://amazonaws.com/iot/latest/apireference/API_AssociateSbomWithPackageVersion.html).

**Fehler bei der SBOM-Validierung**

In diesem Abschnitt werden die häufigsten Fehler aufgeführt, die bei der ersten Validierung der Softwareliste (SBOM) aufgetreten sind, wenn sie mit einer Softwarepaketversion verknüpft ist.

Die folgende Fehlermeldung wird angezeigt, wenn der `AssociateSbomWithPackageVersion` API-Vorgang verwendet wird und der Parameter `bucket` Null ist`s3Location`.

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

Die folgende Fehlermeldung wird angezeigt, wenn die Zeichenfolge `bucket` im `s3Location` Parameter für den `AssociateSbomWithPackageVersion` API-Vorgang zu lang ist.

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

Die folgende Fehlermeldung wird angezeigt, wenn der `key` Parameter Null ist.

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

Die folgende Fehlermeldung wird angezeigt, wenn die Zeichenfolge `key` im `s3Location` Parameter für den `AssociateSbomWithPackageVersion` API-Vorgang zu lang ist.

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

Die folgende Fehlermeldung wird angezeigt, wenn die Zeichenfolge `version` im `s3Location` Parameter für den `AssociateSbomWithPackageVersion` API-Vorgang Null ist.

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

Die folgende Fehlermeldung wird angezeigt, wenn die Zeichenfolge `version` im `s3Location` Parameter für den `AssociateSbomWithPackageVersion` API-Vorgang zu lang ist.

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

Die folgende Fehlermeldung wird angezeigt, wenn die Größe der im Amazon S3-Bucket gespeicherten SBOM-Zip-Archivdatei zu groß ist.

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

Die folgende Fehlermeldung wird angezeigt, wenn Sie den `AssociateSbomWithPackageVersion` API-Vorgang verwenden und die aktuelle Anzahl der laufenden SBOM-Validierungen bereits den Höchstwert erreicht hat.

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

**Zugriffsprobleme mit der SBOM-Datei im Amazon S3 S3-Bucket**

Die folgende Fehlermeldung wird angezeigt, wenn eine andere Entität nicht auf den Amazon S3 S3-Bucket zugreifen kann, weil der Amazon S3 S3-Bucket nicht existiert oder die richtigen Berechtigungen für den Zugriff auf den Amazon S3 S3-Bucket nicht erteilt wurden.

Weitere Informationen zu den erforderlichen Berechtigungsrichtlinien für den Zugriff auf den Amazon S3 S3-Bucket finden Sie unter[Aufbewahrung von Softwarelisten](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."
```

Die folgende Fehlermeldung wird angezeigt, wenn eine andere Entität nicht auf die SBOM-Zip-Archivdatei im `key` Parameter zugreifen kann, weil der Amazon S3 S3-Bucket nicht existiert oder die richtigen Berechtigungen für den Zugriff auf im Amazon S3 S3-Bucket gespeicherte Inhalte nicht erteilt wurden.

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

Die folgende Fehlermeldung wird angezeigt, wenn eine andere Entität nicht auf den Amazon S3 S3-Bucket zugreifen kann, weil der Bucket, der Schlüssel und die Versions-ID nicht existieren oder die richtigen Berechtigungen für den Zugriff auf den Amazon S3 S3-Bucket nicht erteilt wurden. Darüber hinaus kann diese Fehlermeldung angezeigt werden, wenn die erteilten Berechtigungen nicht ausreichen, um auf die SBOM-Zip-Archivdatei im Amazon S3-Bucket zuzugreifen.

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

Die folgende Fehlermeldung wird angezeigt, wenn eine andere Entität nicht auf den Amazon S3 S3-Bucket zugreifen kann, weil sich der Bucket in einer anderen Region befindet.

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

Die folgende Fehlermeldung wird angezeigt, wenn eine andere Entität nicht auf den Amazon S3 S3-Bucket zugreifen kann`bucket`, weil die `version` Parameter`key`, oder bei der Verwendung des `AssociateSbomWithPackageVersion` API-Vorgangs falsch geschrieben wurden.

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