通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

存储任务操作

  • 项目

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

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

重要

Azure 存储操作目前为预览版，已在这些区域中提供。 有关 beta 版本、预览版或尚未正式发布的版本的 Azure 功能所适用的法律条款，请参阅 Microsoft Azure 预览版的补充使用条款。

操作格式

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

显示操作格式的关系图。

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

元素 说明
name 操作的名称。1
parameters 一个或多个参数的集合。 每个参数都有参数名称和参数值。1
onSuccess 当对象操作成功时要采取的操作。 continue 是预览期间唯一允许的值。
onFailure 当对象操作失败时要采取的操作。 break 是预览期间唯一允许的值。

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 tier 热 | 冷 | 存档
SetBlobExpiry expiryTime、expiryOption (expiryTime)：毫秒数
(expiryOption)：Absolute | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob 无 无
UndeleteBlob 无 无
SetBlobTags 标记名称1 标记值
SetBlobImmutabilityPolicy untilDate、mode (untilDate)：策略结束时的日期/时间

(mode)：已锁定 | 未锁定
SetBlobLegalHold legalHold true | false

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

另请参阅