以前の Azure Storage バージョン
Azure Storage では、複数のバージョンがサポートされています。 Storage に対して要求を行うには、要求が匿名でない限り、その操作に使用するバージョンを指定する必要があります。
使用可能なバージョン
Azure Storage の現在のバージョンは 2023-11-03 であり、可能であればそのバージョンを使用することをお勧めします。 最新バージョンの詳細については、「 Azure Storage のバージョン管理」を参照してください。
サポートされるその他のバージョンは次のとおりです。
共有アクセス署名を介して承認された要求
共有アクセス署名を介して行われた要求は、SAS の生成に使用するバージョンに従って処理されます。 バージョン 2013-08-15 および 2012-02-12 には、SAS 要求の承認と実行に使用するバージョンを指定するバージョン管理パラメーター (SignedVersion
または sv
) が含まれています。
バージョン 2012-02-12 以降
バージョン 2012-02-12 以降を使用して生成された共有アクセス署名を持つ要求には、 パラメーターが SignedVersion (sv)
必要です。 SignedVersion
は、承認と API 操作の呼び出しに使用されるサービス バージョンを示します。 要求で x-ms-version
ヘッダーが渡された場合は無視されます。 パラメーターのみが、 SignedVersion (sv)
共有アクセス署名を介して行われた要求の処理に使用するサービスのバージョンを決定します。
注意
バージョン 2013-08-15 以前では、共有アクセス署名 URL (つまり、共有アクセス署名プロバイダーまたはジェネレーター) を準備および配布するサービスで、クライアント ソフトウェア (つまり、共有アクセス署名コンシューマー) によって認識される Azure Storage サービスのバージョンが指定されていることを確認します。
次の表は、共有アクセス署名を介して行われた要求に対して、どのバージョンでサポートされているサービスを示しています。
SignedVersion (sv) パラメーターの値 |
サポートされているサービス |
---|---|
2015-12-11 | すべて (Azure Blob Storage、Azure Queue Storage、Azure Table Storage、Azure Files) |
2015-04-05 | すべて (Blob Storage、Queue Storage、Table Storage、Azure Files) |
2015-02-21 | すべて (Blob Storage、Queue Storage、Table Storage、Azure Files) |
2014-02-14 | Blob Storage、Queue Storage、および Table Storage |
2013-08-15 | Blob Storage、Queue Storage、および Table Storage |
2012-02-12 | Blob Storage、Queue Storage、および Table Storage |
次の例は、 を使用sv=2013-08-15
して List BLOB を呼び出す共有アクセス署名を示しています。
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2013-08-15&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
この例では、サービスは、バージョン 2013-08-15 を使用して要求を承認して実行します。 2013-08-15 バージョンで削除されたため、応答には 要素の下Blob
に 要素は含Url
まれません。
クライアント アプリケーションがバージョン 2012-02-12 に基づくストレージ クライアント ライブラリのバージョンを使用し、この共有アクセス署名を使用する要求を行う場合、クライアントは 要素を Uri
受け取ります。 そのため、要求は で NullReferenceException
失敗します。
2012-02-12 より前のバージョン (Blob Storage のみ)
Blob Storage では、バージョン 2009-07-17 で共有アクセス署名が導入されました。 Table Storage と Queue Storage では、バージョン 2012-02-12 で共有アクセス署名が導入されているため、バージョン 2012-02-12 より前の共有アクセス署名の動作は Blob Storage にのみ適用されます。
バージョン 2012-02-12 では、 パラメーターも導入されました SignedVersion (sv)
。これにより、Shared Access Signature ジェネレーターは、要求の処理に使用するバージョンを指定できます。 2012-02-12 より前のバージョンで生成された共有アクセス署名では、要求の処理に使用するバージョンを指定できないため、承認と API の実行には次の規則に依存しています。
要求に有効な
x-ms-version
ヘッダーがある場合は、共有アクセス署名パラメーターを解釈するために、最も古い有効なバージョン (2009-07-17) が使用されます。 でx-ms-version
指定されたバージョンは、Blob Storage 操作の実行に使用されます。要求にヘッダーがない
x-ms-version
場合、所有者が Blob Storage のプロパティの設定を使用して既定のバージョンを設定した場合、バージョン 2009-07-17 を使用してパラメーターを解釈します。 所有者が指定した既定のバージョンは、Blob Storage 操作の実行に使用されます。要求にヘッダーが含まれず
x-ms-version
、所有者が既定のバージョンを設定していない場合、Blob Storage は最も古い有効なバージョン (2009-07-17) を使用してパラメーターを解釈します。 コンテナーがパブリックで、バージョン 2009-09-19 以降を使用した Set Container ACL 操作でアクセス制限が設定されている場合、バージョン 2009-09-19 は Blob Storage 操作の実行に使用されます。要求にヘッダーが含まれず
x-ms-version
、所有者が既定のバージョンを設定していない場合、Blob Storage は最も古い有効なバージョン (2009-07-17) を使用してパラメーターを解釈します。 バージョン 2009-09-19 以降を使用した Set Container ACL 操作でコンテナー のアクセス制限が設定されていない場合、Blob Storage 操作はサービスの最も古いバージョンを使用して実行されます。
次の表は、これらのルールをさまざまなシナリオに適用し、 パラメーターが SignedVersion
含まれていないことを前提としています。
x-ms-version ヘッダーの値 | Blob Storage の承認と承認のパラメーターを解釈するために使用されるバージョン | Blob Storage 操作の実行に使用されるバージョン |
---|---|---|
なし | 最も古い有効な共有アクセス署名バージョン (2009-07-17) | 2009-09-19 は、バージョン 2009-09-19 以降を使用して コンテナー ACL の設定によってコンテナー が public に設定されている場合に使用されます。 それ以外の場合は、Blob Storage の最も古いバージョンが使用されます。 |
2011-08-18 | 最も古い有効な共有アクセス署名バージョン (2009-07-17) | 2011-08-18. |
任意のバージョン XXXX-XX-XX | 最も古い有効な共有アクセス署名バージョン (2009-07-17) | バージョン XXXX-XX-XX |
注意
Microsoft では、引用符で囲まれた ETag
値または有効な Accept-Ranges
応答ヘッダーを必要とするシナリオでは、バージョン 2011-08-18 以降を使用することをお勧めします。 ブラウザーやその他のストリーミング クライアントでは、効率的なダウンロードと再試行のためにこれらのヘッダーが必要です。