Azure Storage では、複数のバージョンがサポートされています。 ストレージ サービスに対して要求を行うには、要求が匿名でない限り、その操作に使用するバージョンを指定する必要があります。
2025 年 7 月 14 日現在、Azure Storage サービスの最新の完全デプロイ バージョンが 2025-05-05
されています。
2025-07-05
次の表に示すように、広くデプロイされています。 すべてのバージョンはGA品質です。
表にリージョンで x-ms-version
が有効になっていることが示されている場合は、以前のすべての x-ms-versions
も有効になります。 ストレージ アカウントのリージョンに完全にデプロイされていないサービス バージョンを使用しようとすると、 x-ms-version の不一致エラーが生成される場合があります。
x-ms-version |
Region Availability | SDK Support |
---|---|---|
2025-07-05 |
asiaeast asiasoutheast australiac australiac2 australiaeast australiasoutheast austriae belgiumc brazilse brazilsouth canadacentral canadaeast chilec denmarke europenorth europewest francec frances germanyn germanywc indiacentral indiasouth indiawest indonesiac israelc israelnw italyn japaneast japanwest jioinc jioinw koreacentral koreasouth malaysias malaysiaw mexicoc newzealandn norwaye norwayw polandc qatarc southafrican southafricaw spainc swedenc swedens switzerlandn switzerlandw taiwann taiwannw uaec uaen uksouth ukwest uscentral uscentraleuap useast useast2 useast2euap useast3 usnorth ussouth ussouth2 ussoutheast ussoutheast3 ussoutheast5 ussouthwest uswest uswest2 uswest3 uswestcentral |
GA |
2025-11-05 |
asiaeast australiac australiac2 australiaeast australiasoutheast austriae belgiumc brazilse brazilsouth canadacentral canadaeast chilec denmarke europenorth francec frances germanywc indiacentral indiasouth indiawest indonesiac israelc israelnw italyn japaneast japanwest jioinc jioinw koreacentral koreasouth malaysias malaysiaw mexicoc newzealandn norwaye norwayw polandc qatarc southafrican southafricaw spainc swedenc swedens switzerlandn switzerlandw taiwann taiwannw uaec uaen ukwest useast3 usnorth ussouth2 ussoutheast ussoutheast3 ussoutheast5 ussouthwest uswest uswest2 uswest3 uswestcentral |
Beta |
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 形式で指定する必要があります。 For example:
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 プロトコルの呼び出しにサービスによって使用されるバージョン管理スキームについて説明します。
Value of api-version parameter | 承認に使用されるバージョン | プロトコルの動作に使用されるバージョン |
---|---|---|
Not specified |
sv パラメーターで指定されたバージョン |
sv パラメーターで指定されたバージョン |
XXXX-XX-XX 形式の有効なストレージ サービスのバージョン |
sv パラメーターで指定されたバージョン |
有効なストレージ サービスバージョン XXXX-XX-XX |
Example 1
The following sample request calls List Blobs with sv=2015-04-05
, and without the api-version
parameter.
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 を使用して操作を実行します。
Example 2
The following sample request calls List Blobs with sv=2015-04-05
and with the api-version
parameter.
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 を使用して操作を実行します。
Note
.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 です。
Known issues
このセクションでは、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 バージョンを使用して、問題の解決を試みることをお勧めします。 問題が解決しない場合、または推奨事項が実行できない場合は、 サポート チケットを開いて 、その他のオプションについて話し合ってください。
See also
- ストレージ・サービスREST
- バージョン管理のベスト プラクティス
- .NET クライアント ライブラリバージョンの プロトコル バージョンのサポート