次の方法で共有


状態コードとエラー コード

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 エラー コード文字列も返されます。

応答ヘッダー 説明
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