일반적인 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 참조