기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS IoT 디바이스 관리 소프트웨어 패키지 카탈로그 문제 해결
이 섹션은 AWS IoT 디바이스 관리 소프트웨어 패키지 카탈로그의 문제 해결 섹션입니다.
오류 메시지 일반 문제 해결
이 섹션에서는 소프트웨어 패키지 버전 수명 주기 전반에 걸쳐 나타나는 일반적인 오류를 나열합니다.
HeadBucket 오류
작업 배포 중에 파일 업로드에 사용되는 Amazon S3 버킷을 검증하기 위해 HeadBucket API 작업 또는 head-bucket CLI 명령을 직접적으로 호출할 때 다음 오류 메시지가 나타납니다.
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."
소프트웨어 패키지 및 패키지 버전 자리 표시자
다음 오류 메시지는 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 사용
작업 문서에서 패키지 버전으로 $null을 지정하려고 하면 다음 오류 메시지가 나타납니다. $null은 CreateJob API 작업을 사용할 때 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 미리 서명된 URL 대한 자세한 내용은 미리 서명된 URL 섹션을 참조하세요.
InvalidRequestException "presignedUrlConfig role ARN is required to generate an S3 presigned url in job document."
패키지 버전 아티팩트에 대한 Amazon S3 사전 서명된 URL을 사용하는 IAM 역할
IAM 역할이 없는 작업 문서에서 패키지 버전 아티팩트를 나타내는 Amazon S3 미리 서명된 URL을 사용하려고 하면 다음 오류 메시지가 나타납니다.
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 작업을 사용하고 파라미터가 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 버킷에 액세스하지 못하는 경우 다음 오류 메시지가 나타납니다.
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 아카이브 파일에 액세스하지 못하는 경우 다음 오류 메시지가 나타납니다.
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 작업을 사용할 때 bucket, key 또는 version 파라미터의 철자가 잘못 지정되어 다른 엔터티가 Amazon S3 버킷에 액세스하지 못하면 다음 오류 메시지가 나타납니다.
InvalidRequestException "Please make sure SBOM S3 bucket name/key length/version is valid"
