通过

存储任务操作

存储任务包含一组条件和操作。 操作是存储任务对每个满足各个条件的对象执行的动作。 本文介绍存储任务操作的 JSON 格式。 如果计划使用 Azure 门户以外的工具（例如：Azure PowerShell 或 Azure CLI）创建存储任务，则了解该格式非常重要。 本文还列出了每个参数的操作、操作参数和允许的值。

本文重点介绍操作。 若要了解有关条件的详细信息，请参阅存储任务条件。

操作格式

操作具有一个名称以及零个、一个或多个参数。 下图显示了在存储任务的采用 JSON 模板的操作中，这些元素的显示方式。

显示操作格式的关系图。

下表对每个元素进行了描述。

元素 说明
name 操作的名称。1
parameters 一个或多个参数的集合。 每个参数都有参数名称和参数值。1
onSuccess 当对象操作成功时要采取的操作。
onFailure 当对象操作失败时要采取的操作。

1 有关操作名称、操作参数和参数值的完整列表，请参阅本文的“支持的操作”部分。

以下操作将对对象应用基于时间的不可变性策略。

{
    "operations": [
        {
            "name": "SetBlobImmutabilityPolicy",
            "parameters": {
                "untilDate": "2024-11-15T21:54:22",
                "mode": "locked"
            },
            "onSuccess": "continue",
            "onFailure": "break"
        }
    ]
}

多个操作

使用逗号分隔多个操作。 下图显示了两个操作在操作列表中的位置。

显示两个操作格式的关系图。

以下 JSON 显示用逗号分隔的两个操作。

"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
删除Blob 无 无
UndeleteBlob 无 无
SetBlobTags 标记名称1 标记值
SetBlobImmutabilityPolicy untilDate、mode (untilDate)：策略结束时的日期/时间

(mode)：已锁定 | 未锁定
SetBlobLegalHold legalHold 真 | 假

1此参数的名称是标记的名称。

另请参阅