ストレージ タスクには、一連の条件と操作が含まれています。 操作は、各条件の要件を満たす各オブジェクトに対してストレージ タスクが実行するアクションです。 この記事では、ストレージ タスク操作の JSON 形式について説明します。 Azure portal 以外のツール (Azure PowerShell、Azure CLI など) でストレージ タスクを作成する予定の場合は、その形式を理解することが重要です。 この記事では、操作、操作のパラメーター、各パラメーターの許容される値の一覧も示します。
この記事では、操作について説明します。 条件について詳しくは、「ストレージ タスクの条件」をご覧ください。
操作の形式
操作には、0 個、1 個、または複数個のパラメーターと共に、名前が付けられています。 次の図は、ストレージ タスクの JSON テンプレートの操作で、これらの要素がどのように表されるかを示したものです。
次の表は、それぞれの要素の説明です。
| 要素 | 説明 |
|---|---|
name |
操作の名前。1 |
parameters |
1 つ以上のパラメーターのコレクション。 各パラメーターには、パラメーター名とパラメーター値があります。1 |
onSuccess |
オブジェクトの操作が成功したときに実行するアクション。 |
onFailure |
オブジェクトの操作が失敗したときに実行するアクション。 |
1 操作名、操作パラメーター、パラメーター値の完全な一覧については、この記事の「サポート対象の操作」セクションをご覧ください。
次の操作では、時間に基づく不変性ポリシーがオブジェクトに適用されます。
{
"operations": [
{
"name": "SetBlobImmutabilityPolicy",
"parameters": {
"untilDate": "2024-11-15T21:54:22",
"mode": "locked"
},
"onSuccess": "continue",
"onFailure": "break"
}
]
}
複数の操作
複数の操作はコンマを使って区切ります。 次の図は、操作の一覧での 2 つの操作の位置を示したものです。
次の JSON では、コンマで区切られた 2 つの操作が示されています。
"operations": [
{
"name": "SetBlobImmutabilityPolicy",
"parameters": {
"untilDate": "2024-11-15T21:54:22",
"mode": "locked"
},
"onSuccess": "continue",
"onFailure": "break"
},
{
"name": "SetBlobTags",
"parameters": {
"ImmutabilityUpdatedBy": "contosoStorageTask"
},
"onSuccess": "continue",
"onFailure": "break"
}
]
対応している操作
次の表に、サポートされている操作、パラメーター、パラメーター値を示します。
| 操作 | パラメーター | 値 |
|---|---|---|
| Blob層を設定する | 層 | ホット |クール |コールド |アーカイブ |
| ブロブの賞味期限を設定する | expiryTime、expiryOption | (expiryTime): ミリ秒数 (expiryOption): 絶対 |NeverExpire |RelativeToCreation |RelativeToNow |
| DeleteBlob | なし | なし |
| UndeleteBlob | なし | なし |
| Blobタグの設定 | タグ名1 | タグ値 |
| Blob不変ポリシーを設定する | untilDate、mode | (untilDate): ポリシーが終了する日時 (モード): locked |ロック 解除 |
| SetBlobLegalHold | legalHold | 真 | 偽 |
1 このパラメーターの名前はタグの名前です。