次の方法で共有


Azure Storage のバージョン管理

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 は、次の表の変更ログで確認できます。

Blob Service ADLS第2世代 Files Service Queue Service
.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 ストレージ サービスの最新バージョンは 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 形式で指定する必要があります。 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 を使用して要求を行うときに承認に使用されます。 sisrspsigstsetnspksrkepkerk などの承認パラメーターはすべて、指定されたバージョンを使用して解釈されます。

rsccrscdrscersclrsct などの 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