다음을 통해 공유


상태 및 오류 코드

Azure Storage에 대한 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 작업도 응답 헤더에 Azure Storage 오류 코드 문자열을 반환합니다.

응답 헤더 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>  

버전 2024-08-04 이상에서는 계정 SAS의 서명된 리소스 종류가 액세스 중인 리소스와 일치하지 않는 경우 오류 응답에 추가 오류 정보가 포함됩니다. 예를 들어 다음 오류 응답은 작업을 수행하기 위해 서명된 리소스 종류 'o'가 필요했음을 나타냅니다.

<?xml version="1.0" encoding="utf-8"?>
<Error>
  <Code>AuthorizationResourceTypeMismatch</Code>
  <Message>This request is not authorized to perform this operation using this resource type. RequestId:42a48a49-201e-0092-3770-a7ea70000000 Time:2024-05-16T09:04:16.3226200Z</Message>
  <ExtendedErrorDetail>SignedResourceTypes 'o' is required to perform this operation.</ExtendedErrorDetail>
</Error>

다음 항목에서는 유용할 수 있는 오류 코드 목록을 제공합니다.

Table Storage에 대한 오류 응답

Table Storage에 대한 오류 응답은 OData 사양의 섹션 19에 설명된 오류 형식을 준수합니다. 추가 오류 정보가 포함될 수 있지만 오류 응답은 항상 사양을 OData 준수합니다.

일괄 처리 오류 응답은 표준 Table Storage 오류 응답과 유사합니다. 자세한 내용은 엔터티 그룹 트랜잭션 수행을 참조하세요.

참고

JSON은 Table Storage에 권장되는 페이로드 형식입니다. 버전 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"}}}  
  

다음은 Atom 형식(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