次の方法で共有


Azure Storage のバージョン管理

Azure Storage では、複数のバージョンがサポートされています。 ストレージ サービスに対して要求を行うには、要求が匿名でない限り、その操作に使用するバージョンを指定する必要があります。

2025 年 6 月 5 日の時点で、Azure Storage サービスの最新の完全デプロイ バージョンが 2025-11-05されています。 2025-07-05 また、次の表に示すように、 2025-05-05 も広く展開されています。 すべてのバージョンはGA品質です。

表にリージョンで x-ms-version が有効になっていることが示されている場合は、以前のすべての x-ms-versions も有効になります。 ストレージ アカウントのリージョンに完全にデプロイされていないサービス バージョンを使用しようとすると、 x-ms-version の不一致エラーが生成される場合があります。

x-ms-version 利用可能なリージョン SDK のサポート
2025-05-05 アジア東部
アジア南東
オーストラリア
オーストラリアC2
オーストラリアイースト
オーストラリアサウスイースト
オーストリア
ベルギー
ブラジル
ブラジルサウス
canadacentral
カナダ東部
チリ
デンマーク
ヨーロッパ北部
ヨーロッパ西部
フランセック
フランシス
ドイツ
ドイツWC
インド中部
インド南部
インド西部
インドネシア
イスラエル
イスラエル西
イタリン
japaneast
ジャパンウェスト
ジオインク
ジオインウ
コリアセントラル
韓国南部
マレーシア
マレーシア
メキシコ
ニュージーランド
ノルウェー
ノルウェーW
ポーランド
カタールク
南アフリカ
南アフリカW
スパインC
スウェーデン
スウェーデン
スイス
スイス
台湾
台湾北西
UAECの
アラブ首長国連邦
ウクサウス
イギリス西部
USCセントラル
米国中部EU
useastさん
useast2の
useast2euap
USNORTHの
米国南
米国南2
米国南東部
us南東3
us南東5
米国南西部
米国西部
USWEST2
米国西部3
USWestセントラル
最新のGA
2025-07-05 オーストラリア
オーストラリアC2
オーストラリアイースト
オーストリア
ベルギー
ブラジル
ブラジルサウス
canadacentral
カナダ東部
チリ
デンマーク
ヨーロッパ北部
ヨーロッパ西部
フランセック
フランシス
ドイツ
ドイツWC
インド中部
インド南部
インド西部
インドネシア
イスラエル
イスラエル西
イタリン
japaneast
ジャパンウェスト
ジオインク
ジオインウ
韓国南部
マレーシア
マレーシア
メキシコ
ニュージーランド
ノルウェー
ノルウェーW
ポーランド
カタールク
南アフリカ
スパインC
スウェーデン
スウェーデン
スイス
スイス
台湾
台湾北西
UAECの
アラブ首長国連邦
ウクサウス
イギリス西部
米国中部EU
米国南2
米国南東部
us南東3
us南東5
米国南西部
USWestセントラル
ベータ
2025-11-05 オーストラリア
オーストラリアC2
オーストラリアイースト
ベルギー
ブラジル
ブラジルサウス
チリ
デンマーク
フランセック
フランシス
ドイツWC
インド中部
インド南部
インド西部
インドネシア
イスラエル西
イタリン
japaneast
ジオインク
ジオインウ
韓国南部
マレーシア
マレーシア
メキシコ
ニュージーランド
ノルウェーW
ポーランド
カタールク
スパインC
スウェーデン
スウェーデン
スイス
スイス
台湾
台湾北西
UAECの
アラブ首長国連邦
イギリス西部
米国南2
米国南東部
us南東3
us南東5
米国南西部
USWestセントラル
ベータ

Azure Storage データ プレーン SDK によって使用されている既定の x-ms-version は、次の表の変更ログで確認できます。

Blob service ADLS第2世代 ファイルサービス キューサービス
。網 Azure.Storage.ブロブ Azure.Storage.Files.DataLake Azure.Storage.Files.Shares (英語) Azure.Storage.Queues
ジャワ azure-storage-blob azure-storage-file-datalake Azure ストレージ ファイル シェア azure-storage-queue
Python(プログラミング言語) azure-storage-blob azure-storage-file-datalake Azure ストレージ ファイル シェア azure-storage-queue
JavaScript ストレージ BLOB ストレージファイルデータレイク storage-file-share ストレージキュー
C++ の azure-storage-blobs azure-storage-files-データレイク azure-storage-files-share azure-storage-queues
ゴーラン azblob アズデータレイク azfile アズキュー

データ プレーン Storage SDK は、問題のリリースの既定の x-ms-version がすべてのリージョンで完全にロールアウトされるまで、他の公式パッケージ フィードへの GA リリースを実行しません。 したがって、公式パッケージマネージャーからの最新のGASDKリリースは、どの地域でも安全に使用できます。

Azure ストレージ サービスの最新バージョンは 2025-11-05 であり、可能な限り使用することをお勧めします。 サポートされているその他のすべてのバージョンの一覧と、各バージョンの使用については、「以前の Azure Storage サービスバージョンを参照してください。

2025-11-05 サービスバージョンには、次の機能が含まれています。

要求でサービスのバージョンを指定する

要求に使用するストレージ サービスのバージョンを指定する方法は、その要求の承認方法に関連します。 次のセクションでは、承認オプションと、それぞれのサービス バージョンを指定する方法について説明します。

  • Microsoft Entraからの OAuth 2.0 トークンを使用する要求: Microsoft Entra ID を使用して要求を承認するには、2017-11-09 以降のサービス バージョンで要求に x-ms-version ヘッダーを渡します。 詳細については、「Authorize with Microsoft Entra IDOAuth トークンを使用してストレージ操作を呼び出す」を参照してください。

  • 共有キーまたは共有キー ライトを使用する要求: 共有キーまたは共有キー ライトを使用して要求を承認するには、要求に対して x-ms-version ヘッダーを渡します。 Azure Blob Storage を使用する場合は、 Set Blob Service Properties を呼び出すことで、すべての要求の既定のバージョンを指定できます。

  • Shared Access Signature (SAS)を使用する要求: 共有アクセス署名に 2 つのバージョン管理オプションを指定できます。 省略可能な api-version ヘッダーは、API 操作の実行に使用するサービス バージョンを示します。 必須の SignedVersion (sv) パラメーターは、SAS で行われた要求の承認に使用するサービス のバージョンを指定します。 api-version ヘッダーが指定されていない場合、SignedVersion (sv) パラメーターの値は、API 操作の実行に使用するバージョンも示します。

  • 匿名アクセスを使用する要求: Blob Storage に対して匿名アクセスを使用する場合、バージョンは渡されません。 要求に使用するバージョンを決定するためのヒューリスティックについては、次のセクションで説明します。

Microsoft Entra ID、共有キー、または共有キー Lite を使用して要求を承認する

Microsoft Entra ID、共有キー、または共有キー ライトを使用して要求を承認するには、要求の x-ms-version ヘッダーを指定します。 x-ms-version 要求ヘッダー値は、YYYY-MM-DD 形式で指定する必要があります。 例えば:

Request Headers:  
x-ms-version: 2020-04-08

次の規則では、これらの要求を評価して、要求の処理に使用するバージョンを決定する方法について説明します。

  • 要求に有効な x-ms-version ヘッダーがある場合、ストレージ サービスは指定されたバージョンを使用します。 共有アクセス署名を使用しない Azure Table Storage と Azure Queue Storage に対するすべての要求では、x-ms-version ヘッダーを指定する必要があります。 Shared Access Signature を使用しない Blob Storage へのすべての要求では、次の段落で説明するように、既定のバージョンが設定されていない限り、 x-ms-version ヘッダーを指定する必要があります。

  • Blob Storage への要求に x-ms-version ヘッダーが含まれていないが、アカウント所有者が操作を使用して既定のバージョンを Set Blob Service Properties 設定した場合、指定された既定のバージョンが要求のバージョンとして使用されます。

Shared Access Signature を使用して要求を承認する

バージョン 2014-02-14 以降を使用して生成される Shared Access Signature (SAS) では、2 つのバージョン管理オプションがサポートされています。

  • api-version クエリ パラメーターは、SAS を使用して行われた要求の処理に使用する REST プロトコルのバージョンを定義します。

  • SignedVersion (sv) クエリ パラメーターは、承認に使用する SAS バージョンを定義します。

SignedVersion クエリ パラメーターは、クライアントが SAS を使用して要求を行うときに承認に使用されます。 sisrspsigstsetnspksrkepkerk などの承認パラメーターはすべて、指定されたバージョンを使用して解釈されます。

rsccrscdrscersclrsct などの REST プロトコル パラメーターは、api-version パラメーター ヘッダーで指定されたバージョンを使用して適用されます。 api-version ヘッダーが指定されていない場合は、SignedVersion に指定されたサービス バージョンが使用されます。

api-version パラメーターは、サービス SAS の作成に関するページで説明されているように、承認ヘッダーの文字列からサインイン一部ではありません。

次の表では、SignedVersion パラメーターがバージョン 2014-02-14 以降に設定されている場合に、承認と REST プロトコルの呼び出しにサービスによって使用されるバージョン管理スキームについて説明します。

api-version パラメーター 承認に使用されるバージョン プロトコルの動作に使用されるバージョン
指定されていません sv パラメーターで指定されたバージョン sv パラメーターで指定されたバージョン
XXXX-XX-XX 形式の有効なストレージ サービスのバージョン sv パラメーターで指定されたバージョン 有効なストレージ サービスバージョン XXXX-XX-XX

例 1

次の要求のサンプル呼び出しでは、 パラメーターを指定せずに、sv=2015-04-05を使用して BLOB api-version します。

https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2015-04-05&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d

この場合、サービスは、バージョン 2015-04-05 を使用して要求を認証および承認し、バージョン 2015-04-05 を使用して操作を実行します。

例 2

次の要求の例では、sv=2015-04-05 パラメーターを使用して api-version 呼び出します。

https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2015-04-05&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d&api-version=2012-02-12

ここでは、サービスはバージョン 2015-04-05 を使用して要求を承認し、バージョン 2012-02-12 を使用して操作を実行します。

手記

.NET Storage クライアント ライブラリは、常に REST プロトコル バージョン ( api-version パラメーター内) を基本バージョンに設定します。

匿名アクセスによる要求

匿名アクセスを介して行われた要求の処理方法は、対象となるストレージ アカウントの種類によって異なります。

汎用ストレージ アカウント

汎用ストレージ アカウントへの匿名要求で x-ms-version ヘッダーが指定されておらず、サービスの既定のバージョンが Set Blob Service Properties を使用して設定されていない場合、サービスは可能な限り早いバージョンを使用して要求を処理します。 バージョン 2009-09-19 以降を使用して Set Container ACL 操作を使用してコンテナーが公開された場合、要求はバージョン 2009-09-19 を使用して処理されます。

Blob Storage アカウントの場合

Blob Storage アカウントへの匿名要求で x-ms-version ヘッダーが指定されておらず、サービスの既定のバージョンが Set Blob Service Properties を使用して設定されていない場合、サービスは可能な限り早いバージョンを使用して要求を処理します。 Blob Storage アカウントの場合、可能な限り早いバージョンは 2014-02-14 です。

既知の問題

このセクションでは、Azure Storage REST API の既知の問題について詳しく説明します。

InvalidHeaderValue エラー メッセージ

まれなシナリオでは、REST API を直接呼び出すアプリケーションが InvalidHeaderValue エラー メッセージを受け取る可能性があります。 エラーは次の例のようになります。

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error> 

以前の REST API バージョンを使用して、問題の解決を試みることをお勧めします。 問題が解決しない場合、または推奨事項が実行できない場合は、 サポート チケットを開いて 、その他のオプションについて話し合ってください。

関連項目