BLOB 層の設定

この操作により Set Blob Tier 、BLOB のアクセス層が設定されます。 この操作は、Premium ストレージ アカウントのページ BLOB と、BLOB ストレージまたは汎用 v2 アカウントのブロック BLOB で許可されます。 Premium ページ BLOB の層 (P1P3P4/P2//など) によって、BLOB の許可されるサイズ、IOPS、帯域幅が決まります。 ブロック BLOB の層によってストレージの種類がHot//CoolArchive決まります。 この操作では、BLOB の ETag は更新されません。

ブロック BLOB レベルの階層化の詳細については 、「ホット、クール、アーカイブ ストレージ層」を参照してください。

Request

Set Blob Tier 要求の構成は次のとおりです。 HTTPS が推奨されます。 myaccount をストレージ アカウントの名前に置き換え、myblob を層を変更する BLOB 名に置き換えます。

Method 要求 URI HTTP バージョン
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

URI パラメーター

次の追加パラメーターを要求の URI で指定できます。

パラメーター 説明
snapshot 省略可能。 スナップショット パラメーターは不透明 DateTime な値であり、存在する場合は、階層を設定する BLOB スナップショットを指定します。 BLOB スナップショットの操作の詳細については、「BLOB のスナップショットの作成」を参照してください。
versionid バージョン 2019-12-12 以降では省略可能です。 versionid パラメーターは不透明 DateTime な値であり、存在する場合は、階層を設定する BLOB のバージョンを指定します。
timeout 省略可能。 timeout パラメーターは、秒単位で表されます。 詳細については、「 BLOB サービス操作のタイムアウトの設定」を参照してください

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー 説明
Authorization 必須です。 承認スキーム、ストレージ アカウント名、および署名を指定します。 詳細については、「 Azure Storage への要求の承認」を参照してください。
Date または x-ms-date 必須です。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「 Azure Storage への要求の承認」を参照してください。
x-ms-access-tier 必須です。 BLOB に設定する層を示します。 許可される Premium ページ BLOB 層の一覧については、VM の高パフォーマンスのPremium Storageとマネージド ディスクに関するページを参照してください。 BLOB ストレージまたは汎用 v2 アカウントの場合、有効な値は HotArchive/Cool/. 標準の BLOB アカウント BLOB レベルの階層化の詳細については 、「ホット、クール、アーカイブ ストレージ層」を参照してください。
x-ms-version すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 詳細については、「 Azure Storage Services のバージョン管理」を参照してください。
x-ms-client-request-id 省略可能。 ストレージ分析ログが有効になっているときに分析ログに記録される 1 kB 文字の制限を持つクライアント生成の不透明な値を提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるには、このヘッダーを使用することが強く推奨されます。 詳細については、「Storage AnalyticsログAzure ログ: ログを使用したストレージ要求の追跡」を参照してください。
x-ms-rehydrate-priority 省略可能。 アーカイブされた BLOB のリハイドレートに使用する優先度を示します。 ブロック BLOB のバージョン 2019-02-02 以降でサポートされています。 有効な値は High/Standard. この優先度は、2020-06-12 より前のバージョンの BLOB で 1 回だけ設定できます。このヘッダーは、後続の要求では無視されます。 既定の優先度の設定は .Standard

バージョン 2020-06-12 以降では、リハイドレート優先度は、以前に設定した後に更新できます。 優先度の設定は、このヘッダーを設定して HighSet Blob Tier を呼び出し、前に設定Highした値と同じ値に設定x-ms-access-tierすることで、Standard変更できます。 優先度の設定を下げHighStandardることはできません。

また、この操作では、指定した条件が満たされた場合にのみ、条件付きヘッダーを使用して BLOB を階層化することもできます。 詳細については、「BLOB サービス操作の条件ヘッダーの指定」を参照してください。

要求本文

ありません。

[応答]

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

状態コード

正常に実行されると、新しいレベルがすぐに有効になった場合は状態コード 200 (OK) が返され、新しいレベルへの移行が保留中の場合は状態コード 202 (Accepted) が返されます。 Premium アカウント のページ BLOB 操作では、状態コード 200 (OK) が返されます。 ブロック BLOB の場合、次の表では、BLOB の現在の層と要求された層に基づいて返される http 状態コードについて説明します。

レベル ホット 層に設定する クール層に設定する アーカイブ層に設定する
ホット層の BLOB 200 200 200
クール層の BLOB 200 200 200
アーカイブ層の BLOB 202 202 200
アーカイブ層の BLOB(ホットにリハイドレート) 202 409 409
アーカイブ層の BLOB(クールにリハイドレート) 409 202 409

状態コードの詳細については、「 状態コードとエラー コード」を参照してください

レスポンス ヘッダー

この操作の応答には、以下のヘッダーが含まれます。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています

応答ヘッダー 説明
x-ms-request-id このヘッダーは要求を一意に識別するので、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。
x-ms-version 要求の実行に使用する BLOB サービスのバージョンを示します。 このヘッダーは、バージョン 2009-09-19 以降に対して行われた要求に対して返されます。
x-ms-client-request-id このヘッダーは、要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、値が最大 1024 の ASCII 文字で表示される場合、ヘッダーの値 x-ms-client-request-id と等しくなります。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。

承認

この操作は、ストレージ アカウントの所有者と、この BLOB またはそのコンテナーに書き込むアクセス許可を持つ Shared Access Signature を持つすべてのユーザーのみが呼び出すことができます。

解説

Premium アカウントでページ BLOB の BLOB 層を設定するには、次の制限があります。

ブロック BLOB の層を BLOB ストレージまたは汎用 v2 アカウントに設定する場合、次の制限があります。

  • スナップショットのレベルの設定は、REST バージョン 2019-12-12 以降で許可されます。
  • アーカイブに階層化されたスナップショットは、スナップショットに再ハイドレートすることはできません。 つまり、スナップショットをホット/クールレベルに戻すことはできません。 アーカイブされたスナップショットまたはバージョンからデータを取得する唯一の方法は、新しい BLOB にコピーすることです。
  • バージョンがルート BLOB の場合は、ホットまたはクールにリハイドレートできます。
  • アーカイブされた状態のスナップショットまたはバージョンをルートに昇格することはできません。
  • バージョン管理が有効になっている場合、リハイドレート保留中の場合にルート BLOB を削除すると、リハイドレートが取り消され、バージョンがアーカイブ状態になります。
  • リハイドレートが保留中でソフトデレット状態のときに BLOB が上書きされると、リハイドレートが取り消され、バージョンまたはソフトデレットされたスナップショットがアーカイブ状態になります。

サポートされているレベルの一覧は要求バージョンによって制限されず、今後新しいレベルが追加される可能性があります。

Note

ブロック BLOB レベルの階層化の詳細については 、「ホット、クール、アーカイブ ストレージ層」を参照してください。

参照

Azure Storage への要求を承認する
ステータス コードとエラー コード
BLOB サービスのエラー コード
BLOB サービス操作のタイムアウトの設定