내보내기(0) 인쇄
모두 확장

상태 및 오류 코드

업데이트 날짜: 2014년 7월

Microsoft 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>

특정 오류 응답에는 오류에 대한 추가 정보와 함께 개발자에게 제공하기 위한 추가 오류 정보가 포함될 수도 있습니다. 예를 들어 다음 오류 응답은 요청 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 사양을 따릅니다.

배치 오류 응답은 표준 테이블 서비스 오류 응답과 비슷하며 엔터티 그룹 트랜잭션 수행에 자세히 설명되어 있습니다.

Atom 형식의 기본 오류 본문

<?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>

JSON 형식의 기본 오류 본문

{"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"}}}

참고 항목

표시:
© 2014 Microsoft