Amazon S3 오류 응답에 대한 청구
일반적으로 S3 버킷 소유자에게는 HTTP 200 OK
성공 응답 및 HTTP 4XX
클라이언트 오류 응답이 반환된 요청에 대해 요금이 청구됩니다. 버킷 소유자에게는 HTTP 503 Slow Down
오류와 같은 HTTP 5XX
서버 오류 응답에 대해서는 요금이 청구되지 않습니다. 버킷이 요청자 지불 버킷으로 구성된 경우 청구 요금에 대한 자세한 내용은 요청자 지불 요금의 방식 섹션을 참조하세요.
다음 테이블에는 요금이 청구되지 않는 HTTP 3XX
및 4XX
상태 코드의 특정 오류 코드가 나열되어 있습니다. 웹 사이트 호스팅으로 구성된 버킷의 경우 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 . |
|
InvalidArgument |
이 오류는 다음과 같은 이유로 발생할 수 있습니다.
|
|
InvalidBucketOwnerAWSAccountID | 예상되는 버킷 소유자 파라미터의 값은 AWS 계정 ID여야 합니다. | |
InvalidDigest | 지정한 Content-MD5 또는 체크섬 값이 유효하지 않습니다. | |
InvalidEncryptionAlgorithmError | 지정한 암호화 요청이 유효하지 않습니다. 유효한 값은 AES256 입니다. |
|
InvalidHostHeader | 요청에 제공된 호스트 헤더가 잘못된 스타일 주소를 사용했습니다. | |
InvalidHttpMethod | 예상치 못한 HTTP 메서드를 사용하여 요청했습니다. | |
InvalidRequest |
이 오류는 다음과 같은 이유로 발생할 수 있습니다.
|
|
InvalidSessionException | 제한 시간이 초과되었거나 만료되어 세션이 더 이상 존재하지 않는 경우 반환됩니다. | |
InvalidSignature | 서버가 계산한 요청 서명이 사용자가 제공한 서명과 일치하지 않습니다. AWS 비밀 액세스 키와 서명 방법을 확인합니다. 자세한 내용은 REST 요청 서명 및 인증을 참조하세요. | |
InvalidSOAPRequest | SOAP 요청 본문이 유효하지 않습니다. | |
InvalidStorageClass | 지정한 스토리지 클래스가 유효하지 않습니다. | |
InvalidTag | 요청에 유효하지 않은 태그 입력이 포함되어 있습니다. 예를 들어 요청에 중복된 키, 너무 긴 키 또는 값, 시스템 태그가 포함되어 있을 수 있습니다. | |
InvalidToken | 입력된 토큰의 형식이 잘못되었거나 다른 이유로 유효하지 않습니다. | |
InvalidURI | 지정된 URI를 구문 분석할 수 없습니다. | |
KeyTooLongError | 키가 너무 깁니다. | |
KMS.DisabledException | 지정한 KMS 키가 활성화되지 않아서 요청이 거부되었습니다. | |
KMS.InvalidKeyUsageException | 다음과 같은 이유 중 하나로 요청이 거부되었습니다.
암호화, 암호 해독, 재암호화 및 데이터 키 생성을 위해서는 KeyUsage가 ENCRYPT_DECRYPT여야 합니다. 메시지 서명 및 검증을 위해서는 KeyUsage가 SIGN_VERIFY여야 합니다. 메시지 인증 코드(MAC)를 생성하고 확인하려면 KeyUsage가 GENERATE_VERIFY_MAC이어야 합니다. 키 일치 비밀을 도출하려면 KeyUsage가 KEY_AGREEMENT여야 합니다. KMS 키의 KeyUsage를 확인하려면 DescribeKey 작업을 사용합니다. 특정 KMS 키에 지원되는 암호화 또는 서명 알고리즘을 찾으려면 DescribeKey 작업을 사용합니다. |
|
KMS.KMSInvalidStateException | 지정한 리소스의 상태가 이 요청에 유효하지 않아서 요청이 거부되었습니다. 이 예외는 다음 중 하나를 의미합니다.
|
|
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 | 요청한 범위가 요청에 유효하지 않습니다. 다른 범위를 사용해 보세요. |