Azure Storage のバージョン管理

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

2026年7月20日現在、Azure Storageサービスの最新完全展開版はすでに終了2026-04-06。 2026-06-06 useast2euapとuscentraleuapのごく一部のテナントを除き、グローバルに有効化されています。 2026-10-06 ほとんどの地域で有効であり、最新のベータSDKリリースではデフォルトとなっています。

SDKの最新GAバージョンはデフォルトで 2026-06-06です。

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

Region x-ms-version
asiaeast 2026年10月6日
asiasoutheast 2026年10月6日
australiac 2026年10月6日
australiac2 2026年10月6日
australiaeast 2026-06-06
australiasoutheast 2026年10月6日
austriae 2026年10月6日
belgiumc 2026年10月6日
brazilse 2026年10月6日
brazilsouth 2026年10月6日
canadacentral 2026年10月6日
canadaeast 2026年10月6日
chilec 2026年10月6日
denmarke 2026年10月6日
europenorth 2026年10月6日
europewest 2026-06-06
EUSSLV 2026年10月6日
francec 2026年10月6日
frances 2026年10月6日
germanyn 2026年10月6日
germanywc 2026年10月6日
indiacentral 2026年10月6日
インディアスク 2026年10月6日
indiasouth 2026年10月6日
indiawest 2026年10月6日
indonesiac 2026年10月6日
israelc 2026年10月6日
israelnw 2026年10月6日
italyn 2026年10月6日
japaneast 2026年10月6日
japanwest 2026年10月6日
jioinc 2026年10月6日
jioinw 2026年10月6日
koreacentral 2026年10月6日
koreasouth 2026年10月6日
malaysias 2026年10月6日
malaysiaw 2026年10月6日
mexicoc 2026年10月6日
newzealandn 2026年10月6日
norwaye 2026年10月6日
norwayw 2026年10月6日
polandc 2026年10月6日
qatarc 2026年10月6日
southafrican 2026年10月6日
southafricaw 2026年10月6日
spainc 2026年10月6日
swedenc 2026年10月6日
swedens 2026年10月6日
switzerlandn 2026年10月6日
switzerlandw 2026年10月6日
taiwann 2026年10月6日
taiwannw 2026年10月6日
uaec 2026年10月6日
uaen 2026年10月6日
uksouth 2026年10月6日
ukwest 2026年10月6日
uscentral 2026-06-06
uscentraleuap 2026-04-06
useast 2026年10月6日
useast2 2026-06-06
useast2euap 2026-04-06
useast3 2026年10月6日
usnorth 2026年10月6日
USNortheast5 2026年10月6日
ussouth 2026年10月6日
ussouth2 2026年10月6日
ussoutheast 2026年10月6日
ussoutheast3 2026年10月6日
ussoutheast5 2026年10月6日
ussouthwest 2026年10月6日
uswest 2026年10月6日
uswest2 2026年10月6日
uswest3 2026年10月6日
uswestcentral 2026年10月6日

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

BLOB サービス ADLS第2世代 ファイルサービス キューサービス
.NET Azure.Storage.Blobs Azure.Storage.Files.DataLake Azure.Storage.Files.Shares Azure.Storage.Queues
Java azure-storage-blob azure-storage-file-datalake azure-storage-file-share azure-storage-queue
Python azure-storage-blob azure-storage-file-datalake azure-storage-file-share azure-storage-queue
JavaScript storage-blob storage-file-datalake storage-file-share storage-queue
C++ azure-storage-blobs azure-storage-files-datalake azure-storage-files-shares azure-storage-queues
GoLang azblob azdatalake azfile azqueue

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

サポートされているその他のすべてのバージョンの一覧と、各バージョンの使用については、「以前の Azure Storage サービスバージョンを参照してください。

2026年10月6日のサービスバージョンには以下の機能が含まれています:

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

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

  • 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し、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 を使用して操作を実行します。

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 です。

既知の問題

このセクションでは、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 バージョンを使用して、問題の解決を試みることをお勧めします。 問題が続く場合や推奨が現実的でない場合は 、サポートチケットを開き 、さらなる選択肢について話し合ってください。

こちらも参照ください

  • Last updated on