상태 및 오류 코드

Azure 저장소 서비스에 대한 REST API 작업은 HTTP/1.1 상태 코드 정의에정의된 표준 HTTP 상태 코드를 반환합니다.

API 작업은 저장소 서비스에서 정의된 추가 오류 정보도 반환할 수 있습니다. 이 추가 오류 정보는 응답 본문에서 반환됩니다.

오류 응답의 본문은 아래에 나와 있는 기본 형식을 따릅니다. code 요소는 저장소 서비스 오류 코드 문자열을 나타내고, message 요소는 오류 메시지 문자열을 나타냅니다.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>string-value</Code>  
  <Message>string-value</Message>  
</Error>  

버전 2017-07-29 이상에 대 한 실패 한 API 작업 또한 응답 헤더에 저장소 오류 코드 문자열을 반환 합니다.

응답 헤더 Description
x-ms-error-code 저장소 서비스 오류 코드 문자열을 나타내는 값입니다.

특정 오류 응답에는 오류에 대한 추가 정보와 함께 개발자에게 제공하기 위한 추가 오류 정보가 포함될 수도 있습니다. 예를 들어 다음 오류 응답은 요청 URI에 지정된 쿼리 매개 변수가 잘못되었음을 나타내고, 잘못된 매개 변수의 이름 및 값에 대한 추가 정보와 오류 이유를 제공합니다.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>InvalidQueryParameterValue</Code>  
  <Message>Value for one of the query parameters specified in the request URI is invalid.</Message>  
  <QueryParameterName>popreceipt</QueryParameterName>  
  <QueryParameterValue>33537277-6a52-4a2b-b4eb-0f905051827b</QueryParameterValue>  
  <Reason>invalid receipt format</Reason>  
</Error>  

다음 항목은 Blob, 큐, 테이블 및 파일 서비스에 대한 오류 코드 목록을 제공합니다.

테이블 서비스에 대한 오류 응답

테이블 서비스에 대한 오류 응답에는 위에 표시된 대로 저장소 서비스 오류 코드 및 메시지 요소가 포함되지만 OData 사양의섹션 19에 설명된 오류 형식을 준수합니다. 추가 오류 정보가 저장소 서비스 오류 코드 및 메시지와 함께 응답에 포함될 수도 있지만 오류 응답은 항상 OData 사양을 따릅니다.

일괄 처리 오류 응답은 표준 Table 서비스 오류 응답과 유사하며 엔터티 그룹 트랜잭션 수행에자세히 설명되어 있습니다.

참고

JSON은 테이블 서비스 작업에 권장되는 페이로드 형식이며 2015-12-11 버전 에서 만 지원되는 형식입니다.

JSON 형식의 기본 오류 본문(버전 2013-08-15 이상)

{"odata.error":{"code":"ResourceNotFound","message":{"lang":"en-US","value":"The specified resource does not exist.\nRequestId:102a2b55-eb35-4254-9daf-854db78a47bd\nTime:2014-06-04T16:18:20.4307735Z"}}}  
  

원자 형식의 기본 오류 본문(2015-12-11 이전 버전)

<?xml version="1.0" encoding="utf-8"?>  
<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">  
  <code>ResourceNotFound</code>  
  <message xml:lang="en-US">The specified resource does not exist.  
RequestId:e288ba1e-f5dd-4014-9e09-f1263d223dec  
Time:2014-06-04T16:18:20.7088013Z</message>  
</error>  
  

참고 항목

API 작업 문제 해결
HttpStatusCode 내보독
스토리지 서비스 REST