エクスポート (0) 印刷
すべて展開

Azure ストレージ サービスのバージョン設定

更新日: 2014年5月

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

Azure ストレージ サービスの最新バージョンは 2014-02-14 です。可能な限り、このバージョンを使用することをお勧めします。他のサポートされるバージョンの一覧と各バージョンの使用に関する情報は、「Azure Storage Services Versions 2013-08-15 and Earlier」を参照してください。

バージョン 2014/02/14 では次の点が変更されています。

  • 新しい Microsoft Azure ファイル サービスでは、Microsoft Azure データセンターで実行される仮想マシン (VM) で SMB プロトコルを使用して共有ファイル システムをマウントし、標準の Windows ファイル API を使用してファイル システムにアクセスすることができます。複数の VM (またはクラウド サービスで実行される役割) はそれらのファイル システムに同時に接続できるので、さまざまな役割やインスタンス間で永続的なデータを簡単に共有できます。ファイル サービスの REST API は BLOB サービスの API と似ており、Windows ファイル API に加え、ファイルにアクセスするもう 1 つの手段として利用できます。詳細については、「File Service REST API」を参照してください。

  • 共有アクセス署名は、SignedVersion (sv) パラメーターに加え、api-version パラメーターもサポートするようになりました。これらのパラメーターを使用すると、要求の認証と承認に使用するストレージ サービスのバージョンや、API 操作の実行に使用するバージョンを制御できます。以下の「共有アクセス署名を使用して認証する要求」というセクションを参照してください。

要求に使用するストレージ サービスのバージョンを指定する方法は、要求の認証方法と関係があります。ここでは、認証オプションと、各オプションでサービス バージョンを指定する方法について説明します。

  1. 共有キーまたは共有キー Lite を使用する要求。共有キー/共有キー Lite を使用して要求を認証するには、要求で x-ms-version ヘッダーを渡す必要があります。BLOB サービスの場合、Set Blob Service Properties を呼び出してすべての要求の既定のバージョンを指定できます。

  2. 共有アクセス署名 (SAS) を使用する要求。共有アクセス署名では、2 つのバージョン設定オプションを使用できます。指定する場合、オプションの api-version ヘッダーは、API 操作の実行に使用するサービスのバージョンを示します。SignedVersion (sv) パラメーターでは、SAS で実行される要求の承認と認証に使用するサービスのバージョンを指定します。api-version ヘッダーを指定しない場合、SignedVersion (sv) パラメーターの値は API 操作の実行に使用するバージョンも示します。

  3. 匿名アクセスを使用する要求。BLOB サービスに対する匿名アクセスの場合、バージョンは渡されません。要求に使用するバージョンの経験則については、以下で説明します。

共有キー/共有キー Lite を使用して要求を認証するには、要求で x-ms-version ヘッダーを指定します。x-ms-version 要求ヘッダーの値は YYYY-MM-DD 形式で指定する必要があります。たとえば、次のような記事があります。

Request Headers:
x-ms-version: 2014-02-14

次の規則は、共有キー/共有キー Lite を使用する要求を評価して、要求を処理するときに使用するバージョンを決定する方法を示します。

  • 要求に有効な x-ms-version ヘッダーがある場合、指定されたバージョンがストレージ サービスによって使用されます。テーブル サービスとキュー サービスに対する、共有アクセス署名を使用しない要求については、必ず x-ms-version ヘッダーを指定する必要があります。共有アクセス署名を使用しない BLOB サービスに対するすべての要求では、既定のバージョンが設定されていない場合、以下の説明のように x-ms-version ヘッダーを指定する必要があります。

  • BLOB サービスに対する要求については、x-ms-version ヘッダーがなくても、アカウント所有者が Set Blob Service Properties を使用して既定のバージョンを設定していれば、指定された既定のバージョンが要求のバージョンとして使用されます。

バージョン 2014-02-14 を使用して生成された共有アクセス署名 (SAS) は、次の 2 つのバージョン設定オプションをサポートしています。

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

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

SignedVersion クエリ パラメーターは、クライアントが SAS を使用して要求を実行するときに認証と承認に使用されます。認証と承認のパラメーター (sisrspsigstsetnspksrkepkerk など) はすべてバージョン 2014-02-14 を使用して解釈されます。

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

ただし、api-version パラメーターは、「共有アクセス署名 URI の構築」に説明されている認証の署名対象文字列に含まれません。

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

 

api-version パラメーターの値 認証と承認に使用されるバージョン プロトコル動作に使用されるバージョン

指定しない

sv パラメーターに指定されたバージョン

sv パラメーターに指定されたバージョン

XXXX-XX-XX という形式の有効なストレージ サービスのバージョン

sv パラメーターに指定されたバージョン

有効なストレージ サービスのバージョン XXXX-XX-XX

例 1

次の要求例では、sv=2014-02-14 を指定し、api-version パラメーターを指定せずに List Blobs を呼び出しています。

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

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

例 2

次の要求例では、sv=2014-02-14 を指定し、api-version パラメーターを指定して List Blobs を呼び出しています。

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

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

noteメモ
.NET Storage Client Library は、REST プロトコルのバージョン (api-version パラメーター) を、常に基となるバージョンに設定します。

BLOB サービスへの要求で x-ms-version ヘッダーを指定せず、サービスの既定のバージョンを Set Blob Service Properties を使用して設定しなかった場合、要求の処理に最も古いバージョンの BLOB サービスが使用されます。ただし、バージョン 2009-09-19 以降を使用して実行した Set Container ACL 操作でコンテナーが公開された場合、要求は 2009-09-19 を使用して処理されます。

関連項目

表示:
© 2014 Microsoft