ストレージ タスクの操作

ストレージ タスクには、一連の条件と操作が含まれています。 操作は、各条件の要件を満たす各オブジェクトに対してストレージ タスクが実行するアクションです。 この記事では、ストレージ タスク操作の JSON 形式について説明します。 Azure portal 以外のツール (Azure PowerShell、Azure CLI など) でストレージ タスクを作成する予定の場合は、その形式を理解することが重要です。 この記事では、操作、操作のパラメーター、各パラメーターの許容される値の一覧も示します。

この記事では、操作について説明します。 条件について詳しくは、「ストレージ タスクの条件」をご覧ください。

重要

Azure Storage Actions は現在プレビュー段階であり、こちらのリージョンで使用できます。 ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。

操作の形式

操作には、0 個、1 個、または複数個のパラメーターと共に、名前が付けられています。 次の図は、ストレージ タスクの JSON テンプレートの操作で、これらの要素がどのように表されるかを示したものです。

次の表は、それぞれの要素の説明です。

要素	説明
name	操作の名前。1
parameters	1 つ以上のパラメーターのコレクション。 各パラメーターには、パラメーター名とパラメーター値があります。1
onSuccess	オブジェクトの操作が成功したときに実行するアクション。 プレビュー期間中は、値 continue だけが許されます。
onFailure	オブジェクトの操作が失敗したときに実行するアクション。 プレビュー期間中は、値 break だけが許されます。

¹ 操作名、操作パラメーター、パラメーター値の完全な一覧については、この記事の「サポート対象の操作」セクションをご覧ください。

次の操作では、時間に基づく不変性ポリシーがオブジェクトに適用されます。

{
    "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"
    }
]

対応している操作

次の表に、サポートされている操作、パラメーター、パラメーター値を示します。

操作	パラメーター	値
SetBlobTier	層	ホット |クール |アーカイブ
SetBlobExpiry	expiryTime、expiryOption	(expiryTime): ミリ秒数 (expiryOption): Absolute | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob	なし	なし
UndeleteBlob	なし	なし
SetBlobTags	タグ名1	タグ値
SetBlobImmutabilityPolicy	untilDate、mode	(untilDate): ポリシーが終了する日時 (mode): locked | unlocked
SetBlobLegalHold	legalHold	true | false

¹ このパラメーターの名前はタグの名前です。

関連項目

• ストレージ タスクの条件
• 条件と操作を定義する