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
は、次の表の変更ログで確認できます。
データ プレーン Storage SDK は、問題のリリースの既定の x-ms-version
がすべてのリージョンで完全にロールアウトされるまで、他の公式パッケージ フィードへの GA リリースを実行しません。 したがって、公式パッケージマネージャーからの最新のGASDKリリースは、どの地域でも安全に使用できます。
Azure ストレージ サービスの最新バージョンは 2025-11-05 であり、可能な限り使用することをお勧めします。 サポートされているその他のすべてのバージョンの一覧と、各バージョンの使用については、「以前の Azure Storage サービスバージョンを参照してください。
2025-11-05 サービスバージョンには、次の機能が含まれています。
- 次の API は、
x-ms-copy-source-status-code
とx-ms-copy-source-error-code
を返すようになりました。 詳細については、「 ステータス コードとエラー コード」を参照してください。
要求でサービスのバージョンを指定する
要求に使用するストレージ サービスのバージョンを指定する方法は、その要求の承認方法に関連します。 次のセクションでは、承認オプションと、それぞれのサービス バージョンを指定する方法について説明します。
Microsoft Entraからの OAuth 2.0 トークンを使用する要求: Microsoft Entra ID を使用して要求を承認するには、2017-11-09 以降のサービス バージョンで要求に
x-ms-version
ヘッダーを渡します。 詳細については、「Authorize with Microsoft Entra IDで OAuth トークンを使用してストレージ操作を呼び出す」を参照してください。共有キーまたは共有キー ライトを使用する要求: 共有キーまたは共有キー ライトを使用して要求を承認するには、要求に対して
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 を使用して要求を行うときに承認に使用されます。
si
、sr
、sp
、sig
、st
、se
、tn
、spk
、srk
、epk
、erk
などの承認パラメーターはすべて、指定されたバージョンを使用して解釈されます。
rscc
、rscd
、rsce
、rscl
、rsct
などの 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 バージョンを使用して、問題の解決を試みることをお勧めします。 問題が解決しない場合、または推奨事項が実行できない場合は、 サポート チケットを開いて 、その他のオプションについて話し合ってください。
関連項目
- ストレージ・サービスREST
- バージョン管理のベスト プラクティス
- .NET クライアント ライブラリバージョンの プロトコル バージョンのサポート