다음을 통해 공유


일반적인 REST API 오류 코드

Azure Storage 서비스에 대한 작업은 다음 오류 코드를 반환할 수 있습니다.

오류 코드 HTTP 상태 코드 사용자 메시지
NoAuthenticationInformation 권한 없음(401) 서버에서 요청을 인증하지 못했습니다. www-authenticate 헤더의 정보를 참조하세요.
InvalidAuthenticationInfo 권한 없음(401) 서버에서 요청을 인증하지 못했습니다. www-authenticate 헤더의 정보를 참조하세요.
AccountAlreadyExists 충돌(409) 지정한 계정이 이미 있습니다.
AccountBeingCreated 충돌(409) 지정된 계정은 만드는 중입니다.
AccountIsDisabled 사용할 수 없음(403) 지정된 계정이 비활성화되어 있습니다.
AccountProtectedFromDeletion 충돌(409) 계정 <accountName> 컨테이너에는 가 있습니다 <containerName><have legal hold\locked immutability policy>.
AuthenticationFailed 사용할 수 없음(403) 서버에서 요청을 인증하지 못했습니다. Authorization 헤더 값 형식이 올바르고 서명을 포함하는지 확인하세요.
ConditionHeadersNotSupported BadRequest(400) 조건 헤더는 지원되지 않습니다.
ConditionNotMet 수정 안 됨(304) 조건부 헤더에 지정된 조건이 읽기 작업에 대해 충족되지 않았습니다.
ConditionNotMet 전제 조건 실패(412) 조건부 헤더에 지정된 조건이 쓰기 작업에 대해 충족되지 않았습니다.
EmptyMetadataKey 잘못된 요청(400) 메타데이터 키-값 쌍 중 하나의 키가 비어 있습니다.
InsufficientAccountPermissions 사용할 수 없음(403) 읽기 작업은 현재 사용하지 않도록 설정되어 있습니다.
InsufficientAccountPermissions 사용할 수 없음(403) 쓰기 작업은 허용되지 않습니다.
InsufficientAccountPermissions 사용할 수 없음(403) 액세스하는 계정에는 이 작업을 실행할 수 있는 충분한 권한이 없습니다.
InternalError 내부 서버 오류(500) 서버에 내부 오류가 발생했습니다. 요청을 다시 시도하세요.
InvalidAuthenticationInfo 잘못된 요청(400) 인증 정보가 올바른 형식으로 제공되지 않았습니다. Authorization 헤더의 값을 확인하세요.
InvalidHeaderValue 잘못된 요청(400) HTTP 헤더 중 하나에 제공된 값이 올바른 형식이 아닙니다.
InvalidHttpVerb 잘못된 요청(400) 지정된 HTTP 동사를 서버에서 인식할 수 없습니다.
InvalidInput 잘못된 요청(400) 요청 입력 중 하나가 올바르지 않습니다.
InvalidMd5 잘못된 요청(400) 요청에 지정된 MD5 값이 잘못되었습니다. MD5 값은 128비트이고 Base64로 인코딩되어야 합니다.
InvalidMetadata 잘못된 요청(400) 지정된 메타데이터가 잘못되었습니다. 허용되지 않는 문자가 포함됩니다.
InvalidQueryParameterValue 잘못된 요청(400) 요청 URI에서 쿼리 매개 변수 중 하나에 잘못된 값이 지정되었습니다.
InvalidRange 요청한 범위가 충분하지 않음(416) 지정된 범위가 현재 리소스 크기에 대해 유효하지 않습니다.
InvalidResourceName 잘못된 요청(400) 지정된 리소스 이름에 잘못된 문자가 포함되어 있습니다.
InvalidUri 잘못된 요청(400) 요청된 URI는 서버의 리소스를 나타내지 않습니다.
InvalidXmlDocument 잘못된 요청(400) 지정된 XML이 구문상 잘못되었습니다.
InvalidXmlNodeValue 잘못된 요청(400) 요청 본문의 XML 노드 중 하나에 제공된 값이 올바른 형식이 아닙니다.
KeyVaultAccessTokenCannotBeAcquired 사용할 수 없음(403) 이 리소스의 ID를 사용하여 Microsoft Entra 키 자격 증명 모음에 대한 액세스 토큰을 가져올 수 없습니다.
KeyVaultEncryptionKeyNotFound 사용할 수 없음(403) 암호화 키를 래프 해제할 키 자격 증명 모음 키를 찾을 수 없습니다.
KeyVaultVaultNotFound 사용할 수 없음(403) 키 자격 증명 모음 자격 증명 모음을 찾을 수 없습니다.
Md5Mismatch 잘못된 요청(400) 요청에 지정된 MD5 값이 서버에서 계산된 MD5 값과 일치하지 않습니다.
MetadataTooLarge 잘못된 요청(400) 지정된 메타데이터 크기가 허용되는 최대 크기를 초과합니다.
MissingContentLengthHeader 길이가 필요함(411) Content-Length 헤더가 지정되지 않았습니다.
MissingRequiredQueryParameter 잘못된 요청(400) 필요한 쿼리 매개 변수가 이 요청에 대해 지정되지 않았습니다.
MissingRequiredHeader 잘못된 요청(400) 필수 HTTP 헤더가 지정되지 않았습니다.
MissingRequiredXmlNode 잘못된 요청(400) 필요한 XML 노드가 요청 본문에 지정되지 않았습니다.
MultipleConditionHeadersNotSupported 잘못된 요청(400) 여러 조건 헤더는 지원되지 않습니다.
OperationTimedOut 내부 서버 오류(500) 허용된 시간 내에 작업을 완료할 수 없습니다. 서버 쪽에서 작업이 성공했을 수도 있고 그렇지 않을 수도 있습니다. 작업을 다시 시도하기 전에 서버 상태를 쿼리하세요.
OutOfRangeInput 잘못된 요청(400) 요청 입력 중 하나가 범위를 벗어납니다.
OutOfRangeQueryParameterValue 잘못된 요청(400) 요청 URI에 지정된 쿼리 매개 변수가 허용 가능한 범위를 벗어납니다.
RequestBodyTooLarge 요청 엔터티가 너무 큼(413) 요청 본문 크기가 허용되는 최대 크기를 초과합니다.
ResourceTypeMismatch 충돌(409) 지정된 리소스 종류가 기존 리소스의 형식과 일치하지 않습니다.
RequestUrlFailedToParse 잘못된 요청(400) 요청의 URL을 구문 분석할 수 없습니다.
ResourceAlreadyExists 충돌(409) 지정된 리소스가 이미 있습니다.
ResourceNotFound 찾을 수 없음(404) 지정된 리소스가 없습니다.
ServerBusy 서비스를 사용할 수 없음(503) 서버는 현재 요청을 받을 수 없습니다. 요청을 다시 시도하세요.
ServerBusy 서비스를 사용할 수 없음(503) 수신이 계정 제한을 초과했습니다.
ServerBusy 서비스를 사용할 수 없음(503) 송신이 계정 제한을 초과했습니다.
ServerBusy 서비스를 사용할 수 없음(503) 초당 작업이 계정 제한을 초과합니다.
UnsupportedHeader 잘못된 요청(400) 요청에 지정된 HTTP 헤더 중 하나는 지원되지 않습니다.
UnsupportedXmlNode 잘못된 요청(400) 요청 본문에 지정된 XML 노드 중 하나는 지원되지 않습니다.
UnsupportedQueryParameter 잘못된 요청(400) 요청 URI에 지정된 쿼리 매개 변수 중 하나는 지원되지 않습니다.
UnsupportedHttpVerb 방식 허용 안 함(405) 리소스에서 지정된 HTTP 동사가 지원되지 않습니다.

추가 정보

Blob Storage 오류 코드
Queue Storage 오류 코드
Table Storage 오류 코드
Azure Files 오류 코드
API 작업 문제 해결
HttpStatusCode 열거형
Azure Storage REST API 참조