次の方法で共有

以前の Azure Storage バージョン

  • [アーティクル]

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

使用可能なバージョン

Azure Storage の現在のバージョンは 2024-11-04 であり、可能であればそのバージョンを使用することをお勧めします。 最新バージョンの詳細については、「Azure Storageのバージョン管理 」を参照してください。

サポートされるその他のバージョンは次のとおりです。

Shared Access Signature を使用して承認された要求

Shared Access Signature を介して行われた要求は、SAS の生成に使用するバージョンに従って処理されます。 バージョン 2013-08-15 および 2012-02-12 には、SAS 要求の承認と実行に使用するバージョンを指定するバージョン管理パラメーター (SignedVersionまたは sv) が含まれています。

バージョン 2012-02-12 以降

バージョン 2012-02-12 以降を使用して生成された Shared Access Signature を持つ要求には、SignedVersion (sv) パラメーターが必要です。 SignedVersion は、承認と API 操作の呼び出しに使用されるサービスのバージョンを示します。 x-ms-version ヘッダーが要求で渡された場合、無視されます。 共有アクセス署名を介して行われた要求の処理に使用するサービスのバージョンは、SignedVersion (sv) パラメーターによってのみ決定されます。

手記

バージョン 2013-08-15 以前では、共有アクセス署名 URL (つまり、Shared Access Signature プロバイダーまたはジェネレーター) を準備して配布するサービスで、クライアント ソフトウェア (つまり、共有アクセス署名コンシューマー) によって認識される 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を使用して リスト 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 に基づくストレージ クライアント ライブラリのバージョンを使用し、この Shared Access Signature を使用する要求を行う場合、クライアントは Uri 要素を受け取ります。 したがって、要求は NullReferenceExceptionで失敗します。

2012-02-12 より前のバージョン (Blob Storage のみ)

Blob Storage では、バージョン 2009-07-17 で Shared Access Signature が導入されました。 Table Storage と Queue Storage では、バージョン 2012-02-12 で Shared Access Signature が導入されているため、バージョン 2012-02-12 より前の共有アクセス署名の動作は Blob Storage にのみ適用されます。

バージョン 2012-02-12 では、SignedVersion (sv) パラメーターも導入されました。これにより、Shared Access Signature ジェネレーターは、要求の処理に使用するバージョンを指定できます。 2012-02-12 より前のバージョンで生成された Shared Access Signature では、要求の処理に使用するバージョンを指定できないため、承認と API の実行には次の規則に依存します。

  1. 要求に有効な x-ms-version ヘッダーがある場合、最も古い有効なバージョン (2009-07-17) を使用して、Shared Access Signature パラメーターが解釈されます。 x-ms-version で指定されたバージョンは、Blob Storage 操作の実行に使用されます。

  2. 要求に x-ms-version ヘッダーがない場合、所有者が Blob Storage プロパティの設定を使用して既定のバージョンを設定している場合は、バージョン 2009-07-17 を使用してパラメーターを解釈します。 所有者が指定した既定のバージョンは、Blob Storage 操作の実行に使用されます。

  3. 要求に x-ms-version ヘッダーがない場合、所有者が既定のバージョンを設定していない場合、Blob Storage は最も古い有効なバージョン (2009-07-17) を使用してパラメーターを解釈します。 コンテナーがパブリックであり、バージョン 2009-09-19 以降を使用した コンテナー ACL の設定操作でアクセス制限が設定されている場合は、バージョン 2009-09-19 が Blob Storage 操作の実行に使用されます。

  4. 要求に x-ms-version ヘッダーがない場合、所有者が既定のバージョンを設定していない場合、Blob Storage は最も古い有効なバージョン (2009-07-17) を使用してパラメーターを解釈します。 バージョン 2009-09-19 以降を使用した コンテナー ACL の設定 操作でコンテナーアクセス制限が設定されていない場合、Blob Storage 操作はサービスの最も古いバージョンを使用して実行されます。

次の表は、これらの規則をさまざまなシナリオに適用し、SignedVersion パラメーターが含まれていないことを前提としています。

x-ms-version ヘッダーの値 Blob Storage の承認と承認のパラメーターを解釈するために使用されるバージョン Blob Storage 操作を実行するために使用されるバージョン
何一つ 最も古い有効な Shared Access Signature バージョン (2009-07-17) 2009-09-19 は、バージョン 2009-09-19 以降を使用してコンテナー ACL を設定 コンテナーがパブリックに設定されている場合に使用されます。 それ以外の場合は、最も古いバージョンの Blob Storage が使用されます。
2011-08-18 最も古い有効な Shared Access Signature バージョン (2009-07-17) 2011-08-18.
任意のバージョン XXXX-XX-XX 最も古い有効な Shared Access Signature バージョン (2009-07-17) バージョン XXXX-XX-XX

手記

引用符で囲まれた ETag 値または有効な Accept-Ranges 応答ヘッダーが必要なシナリオでは、バージョン 2011-08-18 以降を使用することをお勧めします。 ブラウザーやその他のストリーミング クライアントでは、効率的なダウンロードと再試行のためにこれらのヘッダーが必要です。

関連項目

Azure Storage のバージョン管理の