次の方法で共有

ストレージ タスクの操作

ストレージ タスクには、一連の条件と操作が含まれています。 操作は、各条件の要件を満たす各オブジェクトに対してストレージ タスクが実行するアクションです。 この記事では、ストレージ タスク操作の 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 つの操作の位置を示したものです。

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 このパラメーターの名前はタグの名前です。

関連項目