创建存储任务

在 Azure 门户中，搜索“存储任务”。 然后，在“服务”下选择“存储任务 - Azure 存储操作”。

在“Azure 存储操作 | 存储任务”页，选择“创建”。

“基本信息”选项卡

“基本信息”选项卡上提供了存储任务的基本信息。 下表描述了“基本信息”选项卡上的字段。

下图显示了“基本信息”选项卡的示例。

“条件”选项卡

在“条件”选项卡上，定义每个对象（容器或 Blob）必须满足的条件，以及要对该对象执行的操作。

必须至少定义一个条件和一个操作。 要向条件添加子句，请选择“添加新子句”。 要添加操作，请选择“添加新操作”。

下表描述了“条件”选项卡上的字段。

下图显示了“条件”选项卡的示例。

可以选择 “预览条件 ”以查看受已定义的条件影响的 blob 列表。 若要了解详细信息，请参阅 预览条件的效果。

“分配”选项卡

分配会标识存储帐户和该账户中任务将面向的对象子集。 分配还指定任务何时运行，以及存储执行报告的位置。

要添加分配，请选择“添加分配”。 此步骤是可选的。 无需添加工作分配来创建任务。

下表描述了“添加分配”窗格中显示的字段。

选择要分配给存储任务的系统分配托管标识的角色。 若要确保任务分配成功，请使用具有 Blob 数据所有者权限的角色。 若要了解详细信息，请参阅 存储任务的 Azure 角色

下图显示了“添加分配”窗格的示例。

标记选项卡

在标记选项卡上，可以指定资源管理器标记以帮助整理 Azure 资源。 有关详细信息，请参阅标记资源、资源组和订阅以合理进行整理。

下图显示了新存储帐户的索引标记属性的标准配置。

“查看 + 创建”选项卡

导航到“查看 + 创建”选项卡时，Azure 会对你选择的存储任务设置运行验证。 如果验证通过，则可以继续创建存储任务。

如果验证失败，门户将指示需要修改哪些设置。

下图显示了创建新存储任务之前的“查看”选项卡数据。

1. 首先，安装必要的 PowerShell 模块。 请参阅 安装 PowerShell 模块

2. 使用 JSON 定义 条件 。 一个条件就是一个或多个条款的集合。 每个子句都包含一个属性、一个值和一个运算符。 若要了解详细信息，请参阅 存储任务条件。

   $condition = "<condition-json>"
   

3. 使用 New-AzStorageActionTaskOperationObject 命令定义每个操作。 若要了解详细信息，请参阅 存储任务操作

    $operation = New-AzStorageActionTaskOperationObject `
    -Name "<operation-name>" `
    -Parameter @{"<parameter-name>"= "<parameter-value"} `
    -OnFailure break `
    -OnSuccess continue
   
   

4. 使用 New-AzStorageActionTask 命令创建存储任务，并传入定义的任何条件和操作。 以下命令创建存储任务并启用任务的系统托管标识。 存储任务分配使用应用于该系统托管标识的权限来授权访问。

   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<___location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -EnableSystemAssignedIdentity:$true
   

   如果希望通过用户分配的托管标识进行授权分配，则必须将该标识作为 New-AzStorageActionTask 命令的参数提供。 以下命令创建存储任务并指定用户分配的托管标识。 存储任务分配使用应用于用户分配的托管标识的权限来授权访问。

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<___location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -UserAssignedIdentity $managedIdentity.Id
   

   若要了解如何使用 PowerShell 创建分配，请参阅 创建和管理存储任务分配。

1. 使用 JSON 定义 条件 。 一个或多个子句的条件集合。 每个子句都包含一个属性、一个值和一个运算符。 若要了解详细信息，请参阅 存储任务条件。

   conditionclause="<condition-json>"
   

   小窍门

   Azure CLI 使用速记语法。 简写语法是 JSON 字符串的简化表示形式。 若要了解详细信息，请参阅 如何将速记语法与 Azure CLI 配合使用。

2. 使用 az storage-actions task create 命令创建存储任务，并传入条件和操作的 JSON 格式表达式。 本示例查找冷层中的 Blob 并将其移动到热层。 所有其他数据块都被删除。 以下命令创建存储任务并指定系统分配的托管标识。 存储任务分配使用应用于系统分配的托管标识的权限来授权访问。

   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity "{type:SystemAssigned}" \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   如果您希望通过用户分配的托管身份进行授权任务分配，则必须在az storage-actions task create命令中提供该身份作为参数。 以下命令创建存储任务并指定用户分配的托管标识。 存储任务分配使用应用于用户分配的托管标识的权限来授权访问。

   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity $identityId \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   若要了解更多关于操作的信息，请参阅 存储任务操作。

   若要了解如何使用 Azure CLI 创建分配，请参阅 创建和管理存储任务分配。

在 Bicep 模板中包含类似于以下内容的代码片段。 本示例设置单词文档的不可变性策略。

有关完整示例，请参阅 快速入门：使用 Bicep 创建存储任务。

resource storageTask 'Microsoft.StorageActions/storageTasks@2023-01-01' = {
  name: storageTaskName
  ___location: 'westus'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    action: {
      if: {
        condition: '[[endsWith(Name, \'.docx\')]]'
        operations: [
         {
            name: 'SetBlobImmutabilityPolicy'
            onSuccess: 'continue'
            onFailure: 'break'
            parameters: {
              untilDate: '2025-06-20T20:34:00'
              mode: 'locked'
            }
         }
        ]
      }

    }
    description: 'My storage task'
    enabled: true
  }
}

在 Azure 资源管理器模板中包含类似于以下内容的 JSON 代码片段。 本示例设置单词文档的不可变性策略。

有关完整示例，请参阅 快速入门：使用 ARM 模板创建存储任务。

 "resources": [
    {
      "type": "Microsoft.StorageActions/storageTasks",
      "apiVersion": "2023-01-01",
      "name": "mystoragetask",
      "___location": "westus",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "action": {
          "if": {
            "condition": "[[[endsWith(Name, '.docx')]]",
            "operations": [
              {
                "name": "SetBlobImmutabilityPolicy",
                "onSuccess": "continue",
                "onFailure": "break",
                "parameters": {
                  "untilDate": "2025-06-20T20:34:00",
                  "mode": "locked"
                }
              },
            ]
          }
        },
        "description": "my storage task",
        "enabled": true
      }
    }
  ]