AWS IoT Device Management 軟體套件目錄故障診斷 - AWS IoT Core
錯誤訊息的一般故障診斷軟體物料清單錯誤訊息

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS IoT Device Management 軟體套件目錄故障診斷

這是 AWS IoT Device Management Software Package Catalog 的疑難排解區段。

錯誤訊息的一般故障診斷

本節列出在整個軟體套件版本生命週期中常見的錯誤。

HeadBucket 錯誤

呼叫 HeadBucket API 操作或 head-bucket CLI 命令以驗證任務部署期間用於檔案上傳的 Amazon S3 儲存貯體時，會出現下列錯誤訊息。

如需在任務部署期間使用 Amazon S3 儲存貯體上傳檔案的詳細資訊，請參閱 預先簽章URL以上傳檔案。

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

提供無效的引數時，會發生下列錯誤訊息，導致 Amazon S3 GetObject API 操作失敗。

InvalidRequestException
    "Provided argument for presigned url is invalid"

Amazon S3 版本 ID 支援

使用版本控制請求存取 Amazon S3 儲存貯體時，請務必包含您的 versionId或下列錯誤，可能會填入 。

如需使用版本控制控制之 Amazon S3 儲存貯體的詳細資訊，請參閱在 Amazon S3 儲存貯體中使用版本控制

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

檔案上傳之預先簽章 URL 內的預留位置

在任務部署期間，在用於將檔案上傳至目的地 Amazon S3 儲存貯體的預先簽章 URL 內遇到預留位置問題時，會出現下列錯誤訊息。如需在任務部署期間使用 Amazon S3 儲存貯體上傳檔案以及本機預留位置的詳細資訊，請參閱 預先簽章URL以上傳檔案。

無法辨識本機預留位置時，會出現下列錯誤訊息。

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

嘗試在非用於檔案上傳的預先簽章 URL 中使用本機預留位置時，會出現下列錯誤訊息。

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

Amazon S3 URL 巢狀不正確

當 Amazon S3 URL 在另一個預留位置內巢狀不正確時，會出現下列錯誤訊息。

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

套件版本成品巢狀

當套件版本成品預先簽章的 URL 在另一個預留位置內巢狀不正確時，會顯示下列錯誤訊息。

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

缺少套件版本成品

找不到參考的套件版本成品時，會出現下列錯誤訊息。

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

軟體套件和套件 Verion 預留位置

由於 destinationPackageVersions 參數中參考的多個軟體套件和套件版本，或套件版本詳細資訊頁面的版本 ARN 索引標籤，導致軟體套件和套件版本的任務文件預留位置無法解析為任務部署所需的有效值時，會出現下列錯誤訊息。

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

使用空白軟體套件和套件版本

當您嘗試使用空的套件或套件版本，但任務文件中沒有其他套件時，會出現下列錯誤訊息。

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

任務文件中的空值使用

當您嘗試在任務文件中將 指定$null為套件版本時，會出現下列錯誤訊息。 在使用 CreateJob API 操作時，$null只能在 destinationPackageVersions 參數內使用。

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

套件版本中的所有屬性

當您嘗試使用套件版本中的所有屬性，並以額外的文字或預留位置包圍它時，會出現下列錯誤訊息。

如需在軟體套件版本中使用所有屬性的詳細資訊，請參閱 AWS IoT 任務的替代參數

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."

檔案上傳的預先簽章 URL 中的本機預留位置限制

當您超過在任務部署期間用於檔案上傳之預先簽章 URL 的本機預留位置數量限制時，會顯示下列錯誤訊息。

如需在任務部署期間使用預先簽章 URL 進行檔案上傳的詳細資訊，請參閱 預先簽章URL以上傳檔案

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

Amazon S3 儲存貯體中的本機預留位置

當您嘗試將本機預留位置 URL 放置在 Amazon S3 儲存貯體名稱中，以在任務部署期間用於檔案上傳的預先簽章 URL 預留位置時，會出現下列錯誤訊息。

如需在任務部署期間使用預先簽章 URL 進行檔案上傳的詳細資訊，請參閱 預先簽章URL以上傳檔案

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

開啟和關閉括號

當您將參數或預留位置新增至任務文件，而沒有關閉架構 "}" 時，會出現下列錯誤訊息。

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

具有 Amazon S3 預先簽章 URL 的 IAM 角色

當您嘗試在沒有 IAM 角色的任務文件中使用 Amazon S3 預先簽章的 URL 時，會出現下列錯誤訊息。

如需 Amazon S3 預先簽章 URLs的詳細資訊，請參閱使用預先簽章 URLs。

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

套件版本成品具有 Amazon S3 預先簽章 URL 的 IAM 角色

當您嘗試在任務文件中使用代表套件版本成品的 Amazon S3 預先簽章 URL，而沒有 IAM 角色時，會出現下列錯誤訊息。

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

軟體物料清單錯誤訊息

本節列出與與套件版本連結之軟體物料清單 (SBOM) 相關的常見錯誤。

SBOM 關聯請求的輸入驗證

使用 AssociateSbomWithPackageVersion API 操作且 s3Location 參數為 null 時，會出現下列錯誤訊息。

InvalidRequestException "Associate request needs to include SBOM reference"

如需 AssociateSbomWithPackageVersion API 操作的詳細資訊，請參閱 AssociateSbomWithPackageVersion。

SBOM 驗證錯誤

本節列出與軟體套件版本相關聯的軟體物料清單 (SBOM) 初始驗證期間常見的錯誤。

使用 AssociateSbomWithPackageVersion API 操作並在 s3Location 參數bucket中顯示下列錯誤訊息為 null。

InvalidRequestException "S3 bucket name for SBOM cannot be null"

當 AssociateSbomWithPackageVersion API 操作的 s3Location 參數bucket中的字串太長時，會出現下列錯誤訊息。

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

參數key為 null 時，會出現下列錯誤訊息。

InvalidRequestException "S3 key name for SBOM cannot be null"

當 AssociateSbomWithPackageVersion API 操作的 s3Location 參數key中的字串太長時，會出現下列錯誤訊息。

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

當 AssociateSbomWithPackageVersion API 操作之 s3Location 參數version中的字串為 null 時，會出現下列錯誤訊息。

InvalidRequestException "S3 object version for SBOM cannot be null"

當 AssociateSbomWithPackageVersion API 操作的 s3Location 參數version中的字串太長時，會出現下列錯誤訊息。

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

當存放在 Amazon S3 儲存貯體中的 SBOM zip 封存檔案大小過大時，會顯示下列錯誤訊息。

InvalidRequestException "S3 object file size exceeds limit"

當您使用 AssociateSbomWithPackageVersion API 操作，且目前進行中的 SBOM 驗證數量已達上限時，會顯示下列錯誤訊息。

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

存取 Amazon S3 儲存貯體中 SBOM 檔案的問題

當另一個實體因為 Amazon S3 儲存貯體不存在或尚未授予存取 Amazon S3 儲存貯體的適當許可，而無法存取 Amazon S3 儲存貯體時，會出現下列錯誤訊息。

如需存取 Amazon S3 儲存貯體所需許可政策的詳細資訊，請參閱 軟體物料清單儲存。

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

當另一個實體因為 Amazon S3 儲存貯體不存在或尚未授予存取存放在 Amazon S3 儲存貯體中內容的適當許可，而無法存取 key 參數中的 SBOM zip 封存檔案時，會顯示下列錯誤訊息。 Amazon S3 

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

當另一個實體因為儲存貯體、金鑰和版本 ID 不存在而無法存取 Amazon S3 儲存貯體，或未授予存取 Amazon S3 儲存貯體的適當許可時，會出現下列錯誤訊息。此外，如果授予的許可不足以存取 Amazon S3 儲存貯體中的 SBOM zip 封存檔案，則可能會出現此錯誤訊息。

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

當另一個實體因為儲存貯體位於另一個區域而無法存取 Amazon S3 儲存貯體時，會出現下列錯誤訊息。

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

當另一個實體因使用 AssociateSbomWithPackageVersion API 操作時version拼寫錯誤bucket而導致無法存取 Amazon S3 儲存貯體時key，會顯示下列錯誤訊息。

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