Amazon S3 오류 응답에 대한 청구 - Amazon Simple Storage Service

Amazon S3 오류 응답에 대한 청구

일반적으로 S3 버킷 소유자에게는 HTTP 200 OK 성공 응답 및 HTTP 4XX 클라이언트 오류 응답이 반환된 요청에 대해 요금이 청구됩니다. 버킷 소유자에게는 HTTP 503 Slow Down 오류와 같은 HTTP 5XX 서버 오류 응답에 대해서는 요금이 청구되지 않습니다. 버킷이 요청자 지불 버킷으로 구성된 경우 청구 요금에 대한 자세한 내용은 요청자 지불 요금의 방식 섹션을 참조하세요.

다음 테이블에는 요금이 청구되지 않는 HTTP 3XX4XX 상태 코드의 특정 오류 코드가 나열되어 있습니다. 웹 사이트 호스팅으로 구성된 버킷의 경우 S3가 사용자 지정 오류 문서를 반환하거나 사용자 지정 리디렉션을 반환할 때 해당 요청 및 기타 요금이 계속 적용됩니다.

참고

AccessDenied(HTTP 403 Forbidden)의 경우 S3는 요청이 버킷 소유자의 개인 AWS 계정이나 버킷 소유자의 AWS 조직 외부에서 시작된 경우 버킷 소유자에게 요금을 청구하지 않습니다.

HTTP 상태 코드 오류 코드 오류 코드에 대한 설명
301 Moved Permanently(301 영구 이동됨) PermanentRedirect 액세스하려는 버킷이 지정된 엔트포인트를 사용하여 처리되어야 합니다. 이 엔드포인트로 모든 향후 요청을 보냅니다.
PermanentRedirectControlError 액세스하려는 API 작업이 지정된 엔트포인트를 사용하여 처리되어야 합니다. 이 엔드포인트로 모든 향후 요청을 보냅니다.
307 임시 리디렉션 TemporaryRedirect 도메인 이름 시스템(DNS) 서버가 업데이트되는 동안 버킷으로 리디렉션됩니다.
400 잘못된 요청 AuthorizationHeaderMalformed 제공한 권한 부여 헤더가 유효하지 않습니다.
AuthorizationQueryParametersError 제공한 권한 부여 쿼리 매개변수가 유효하지 않습니다.
ConnectionClosedByRequester WriteGetObjectResponse 본문을 읽는 동안 오류가 발생하여 원래 호출자에게 반환되었습니다.
DeviceNotActiveError 디바이스가 현재 활성화 상태가 아닙니다.
EndpointNotFound 요청을 올바른 엔드포인트로 전달합니다.
ExpiredToken 제공된 토큰이 만료되었습니다.
IllegalLocationConstraintException 버킷이 있는 리전과 다른 리전의 버킷에 액세스하려고 합니다. 이 오류를 방지하려면 --region 옵션을 사용하세요. 예: aws s3 cp awsexample.txt s3://amzn-s3-demo-bucket/ --region ap-east-1.
InvalidArgument

이 오류는 다음과 같은 이유로 발생할 수 있습니다.

  • 지정된 인수가 유효하지 않습니다.

  • 요청에 필수 헤더가 누락되었습니다.

  • 지정된 인수가 불완전하거나 형식이 잘못되었습니다.

  • 지정된 인수의 길이는 3 이상이어야 합니다.

InvalidBucketOwnerAWSAccountID 예상되는 버킷 소유자 파라미터의 값은 AWS 계정 ID여야 합니다.
InvalidDigest 지정한 Content-MD5 또는 체크섬 값이 유효하지 않습니다.
InvalidEncryptionAlgorithmError 지정한 암호화 요청이 유효하지 않습니다. 유효한 값은 AES256입니다.
InvalidHostHeader 요청에 제공된 호스트 헤더가 잘못된 스타일 주소를 사용했습니다.
InvalidHttpMethod 예상치 못한 HTTP 메서드를 사용하여 요청했습니다.
InvalidRequest

이 오류는 다음과 같은 이유로 발생할 수 있습니다.

  • 요청에서 잘못된 서명 버전을 사용하고 있습니다. AWS4-HMAC-SHA256(서명 버전 4)을 사용합니다.

  • 액세스 포인트는 기존 버킷에 대해서만 생성할 수 있습니다.

  • 액세스 포인트가 삭제할 수 있는 상태가 아닙니다.

  • 액세스 포인트는 기존 버킷에 대해서만 나열할 수 있습니다.

  • 다음 토큰이 유효하지 않습니다.

  • 수명 주기 규칙에 하나 이상의 작업을 지정해야 합니다.

  • 하나 이상의 수명 주기 규칙을 지정해야 합니다.

  • 수명 주기 규칙의 수는 허용된 규칙 수인 1,000개를 초과할 수 없습니다.

  • MaxResults 파라미터의 범위가 유효하지 않습니다.

  • SOAP 요청은 HTTPS 연결을 통해 이루어져야 합니다.

  • Amazon S3 Transfer Acceleration에서는 DNS를 준수하지 않는 이름의 버킷이 지원되지 않습니다.

  • Amazon S3 Transfer Acceleration에서는 이름에 마침표(.)가 포함된 버킷이 지원되지 않습니다.

  • Amazon S3 Transfer Acceleration 엔드포인트는 시각적 스타일 요청만 지원합니다.

  • Amazon S3 Transfer Acceleration이 이 버킷에서 구성되어 있지 않습니다.

  • Amazon S3 Transfer Acceleration이 이 버킷에서 비활성화되어 있습니다.

  • Amazon S3 Transfer Acceleration이 이 버킷에서 지원되지 않습니다. 도움이 필요하면 지원로 문의하십시오.

  • Amazon S3 Transfer Acceleration을 이 버킷에서 활성화할 수 없습니다. 도움이 필요하면 지원로 문의하십시오.

  • HTTP 헤더와 쿼리 파라미터에 제공된 값이 서로 충돌합니다.

  • HTTP 헤더와 POST 양식 필드에 제공된 값이 서로 충돌합니다.

  • 크기가 5GB보다 큰 객체에 대한 CopyObject 요청이 이루어졌습니다.

InvalidSessionException 제한 시간이 초과되었거나 만료되어 세션이 더 이상 존재하지 않는 경우 반환됩니다.
InvalidSignature 서버가 계산한 요청 서명이 사용자가 제공한 서명과 일치하지 않습니다. AWS 비밀 액세스 키와 서명 방법을 확인합니다. 자세한 내용은 REST 요청 서명 및 인증을 참조하세요.
InvalidSOAPRequest SOAP 요청 본문이 유효하지 않습니다.
InvalidStorageClass 지정한 스토리지 클래스가 유효하지 않습니다.
InvalidTag 요청에 유효하지 않은 태그 입력이 포함되어 있습니다. 예를 들어 요청에 중복된 키, 너무 긴 키 또는 값, 시스템 태그가 포함되어 있을 수 있습니다.
InvalidToken 입력된 토큰의 형식이 잘못되었거나 다른 이유로 유효하지 않습니다.
InvalidURI 지정된 URI를 구문 분석할 수 없습니다.
KeyTooLongError 키가 너무 깁니다.
KMS.DisabledException 지정한 KMS 키가 활성화되지 않아서 요청이 거부되었습니다.
KMS.InvalidKeyUsageException 다음과 같은 이유 중 하나로 요청이 거부되었습니다.
  • KMS 키의 KeyUsage 값이 API 작업과 호환되지 않습니다.

  • 작업에 지정된 암호화 알고리즘 또는 서명 알고리즘이 KMS 키(KeySpec)의 키 구성 요소 유형과 호환되지 않습니다.

암호화, 암호 해독, 재암호화 및 데이터 키 생성을 위해서는 KeyUsage가 ENCRYPT_DECRYPT여야 합니다. 메시지 서명 및 검증을 위해서는 KeyUsage가 SIGN_VERIFY여야 합니다. 메시지 인증 코드(MAC)를 생성하고 확인하려면 KeyUsage가 GENERATE_VERIFY_MAC이어야 합니다. 키 일치 비밀을 도출하려면 KeyUsage가 KEY_AGREEMENT여야 합니다. KMS 키의 KeyUsage를 확인하려면 DescribeKey 작업을 사용합니다.

특정 KMS 키에 지원되는 암호화 또는 서명 알고리즘을 찾으려면 DescribeKey 작업을 사용합니다.
KMS.KMSInvalidStateException 지정한 리소스의 상태가 이 요청에 유효하지 않아서 요청이 거부되었습니다. 이 예외는 다음 중 하나를 의미합니다.
  • KMS 키의 키 상태가 작업과 호환되지 않습니다.

    키 상태를 확인하려면 DescribeKey 작업을 사용합니다. 각 KMS 작업과 호환되는 키 상태에 대한 자세한 내용은 AWS Key Management Service 개발자 가이드AWS KMS keys 키 상태를 참조하세요.

  • 사용자 지정 키 저장소의 KMS 키에 대한 암호화 작업 시 이 예외는 여러 가지 원인이 있을 수 있는 일반적인 오류를 나타냅니다. 원인을 식별하려면 예외와 함께 제공되는 오류 메시지를 참조하세요.

KMS.NotFoundException 지정한 엔터티 또는 리소스를 찾을 수 없으므로 요청이 거부되었습니다.
LambdaInvalidResponse WriteGetObjectResponse가 AWS Lambda에 ValidationError로 응답하여 원래 호출자에게 반환되었습니다. 자세한 내용은 ValidationError 메시지를 참조하세요. 모든 ValidationError 오류로 인해 LambdaInvalidResponse 오류가 발생하는 것은 아닙니다.
LambdaInvocationFailed Lambda 함수 간접 호출이 실패했습니다. S3 객체 Lambda가 구성된 Lambda 함수를 간접적으로 호출할 수 없는 경우 호출자에게 다음 오류가 표시될 수 있습니다. 오류 메시지에는 함수를 호출할 때 AWS Lambda 서비스에서 반환한 최종 오류에 대한 세부 정보(예: 상태 코드, 오류 코드, 오류 메시지, 요청 ID)가 포함될 수 있습니다.
MalformedACLError 제공한 ACL이 잘못된 형식으로 되어 있고 게시된 스키마를 기준으로 검증되지 않았습니다.
MalformedPOSTRequest POST 요청 본문이 올바른 형식의 멀티파트/양식 데이터가 아닙니다.
MalformedXML 제공한 XML이 잘못된 형식으로 되어 있고 게시된 스키마를 기준으로 검증되지 않았습니다.
MaxPostPreDataLengthExceededError 업로드 파일 앞에 있는 POST 요청 필드가 너무 컸습니다.
MetadataTooLarge 메타데이터 헤더가 최대 허용 메타데이터 크기를 초과합니다.
MissingAttachment SOAP 첨부 파일이 필요했지만 해당 파일이 없었습니다.
MissingRequestBodyError 빈 XML 문서를 요청으로 보냈습니다.
MissingSecurityHeader 요청에 필수 헤더가 누락되었습니다.
NoLoggingStatusForKey 키에는 로깅 상태 하위 리소스라는 것이 없습니다.
NotDeviceOwnerError 토큰을 생성한 디바이스가 인증된 사용자의 소유가 아닙니다.
ResponseInterrupted WriteGetObjectResponse 본문을 읽는 동안 오류가 발생하여 원래 호출자에게 반환되었습니다.
RequestHeaderSectionTooLarge 요청을 만드는 데 사용된 요청 헤더 및 쿼리 파라미터가 최대 허용 크기를 초과합니다.
TokenCodeInvalidError 제공한 일련 번호 및/또는 토큰 코드가 유효하지 않습니다.
UnexpectedContent 이 요청에는 지원되지 않는 콘텐츠가 포함되어 있습니다.
UnsupportedArgument 요청에 지원되지 않는 인수가 포함되어 있습니다.
UnsupportedSignature 제공된 요청이 지원되지 않는 STS 토큰 버전으로 서명되었거나 해당 서명 버전이 지원되지 않습니다.
UserKeyMustBeSpecified 버킷 POST 요청에는 지정된 필드 이름이 포함되어야 합니다. 필드 이름이 지정되었다면 필드의 순서를 확인합니다.
IncorrectEndpoint 지정된 버킷이 다른 리전에 있습니다. 요청을 올바른 엔드포인트로 전달합니다.
ValidationError WriteGetObjectResponse API 작업에서 검증 오류가 반환될 수 있으며 이는 여러 가지 이유로 발생할 수 있습니다. 자세한 내용은 오류 메시지를 참조하세요.
403 금지됨 RequestTimeTooSkewed 요청 시간과 서버 시간 간의 차이가 너무 큽니다.
SignatureDoesNotMatch 서버가 계산한 요청 서명이 사용자가 제공한 서명과 일치하지 않습니다. AWS 비밀 액세스 키와 서명 방법을 확인합니다. 자세한 내용은 REST 인증SOAP 인증을 확인하세요.
NotSignedUp 계정이 Amazon S3 서비스에 가입되지 않았습니다. Amazon S3를 사용하려면 가입해야 합니다. 다음 URL에서 가입할 수 있습니다. https://aws.amazon.com/s3
InvalidSecurity 입력한 보안 자격 증명이 유효하지 않습니다.
InvalidPayer 이 개체에 대한 모든 액세스가 비활성화되었습니다. 추가 지원이 필요한 경우 문의처를 참조하세요.
InvalidAccessKeyId 입력한 AWS 액세스 키 ID가 AWS의 레코드에 존재하지 않습니다.
AccountProblem AWS 계정에 해당 작업을 성공적으로 완료하지 못하도록 방해하는 문제가 있습니다. 추가 지원이 필요한 경우 문의처를 참조하세요.
UnauthorizedAccessError 중국 지역에만 적용됩니다. ICP 라이선스가 없는 버킷에 요청을 보냈을 때 반환됩니다. 자세한 내용은 ICP 기록을 참조하세요.
UnexpectedIPError 중국 지역에만 적용됩니다. 예기치 않은 IP로 인해 요청이 거부되었습니다.
MissingAuthenticationToken 요청이 서명되지 않았습니다. 
LambdaPermissionError 호출자에게 Lambda 함수를 간접적으로 호출할 권한이 없습니다. 호출자에게 Lambda 함수를 간접적으로 호출할 권한이 있어야 합니다. 호출자에게 연결된 정책을 검토하여 구성된 함수에 lambda:Invoke를 사용할 수 있도록 허용되었는지 확인하세요. 오류 메시지에는 함수를 호출할 때 Lambda 서비스에서 반환한 최종 오류에 대한 세부 정보(예: 상태 코드, 오류 코드, 오류 메시지, 요청 ID)가 포함될 수 있습니다.
404 Not Found(404 찾을 수 없음) LambdaNotFound AWS Lambda 함수를 찾을 수 없습니다. 간접 호출 시도 시 구성된 Lambda 함수, 버전 또는 별칭을 찾을 수 없습니다. S3 객체 Lambda 액세스 포인트 구성이 올바른 Lambda 함수 ARN을 가리키는지 확인하세요. 오류 메시지에는 함수를 호출할 때 AWS Lambda 서비스에서 반환한 최종 오류에 대한 세부 정보(예: 상태 코드, 오류 코드, 오류 메시지, 요청 ID)가 포함될 수 있습니다.
NoSuchAsyncRequest 지정된 리소스를 찾을 수 없습니다.
NoSuchObjectLockConfiguration 지정된 객체에 ObjectLock 구성이 없습니다.
NoSuchUpload 지정된 멀티파트 업로드가 존재하지 않습니다. 업로드 ID가 유효하지 않거나 멀티파트 업로드가 중단 또는 완료되었을 수 있습니다.
NoSuchWebsiteConfiguration 지정된 버킷에 웹 사이트 구성이 없습니다.
NoTransformationDefined 이 객체 Lambda 액세스 포인트에 대한 변환이 없습니다.
ObjectLockConfigurationNotFoundError 이 버킷에 대한 객체 잠금 구성이 존재하지 않습니다.
405 메서드 허용 안 함 MethodNotAllowed 지정된 메서드가 이 리소스에 허용되지 않습니다.
409 충돌 BucketAlreadyExists 요청된 버킷 이름을 사용할 수 없습니다. 버킷 네임스페이스는 시스템의 모든 사용자가 공유합니다. 다른 이름을 지정하고 다시 시도합니다.
InvalidBucketState 요청이 버킷의 현재 상태에 대해 유효하지 않습니다.
OperationAborted 현재 이 리소스에 대해 서로 충돌하는 조건부 작업이 진행 중입니다. 다시 시도하세요.
411 길이 필요 MissingContentLength 콘텐츠 길이 HTTP 헤더를 제공해야 합니다.
412 사전 조건 실패 RequestIsNotMultiPartContent 버킷 POST 요청은 엔클로저 유형의 멀티파트/양식 데이터여야 합니다.
4.16 요청 범위가 만족스럽지 않음 InvalidRange 요청한 범위가 요청에 유효하지 않습니다. 다른 범위를 사용해 보세요.