Создание назначения задач хранилища и управление ими

Назначение определяет учетную запись хранения и подмножество объектов в этой учетной записи, на которую будет нацелена задача. Назначение также определяет, когда выполняется задача и где хранятся отчеты о выполнении.

Эта статья поможет вам создать задание, а затем запустить выполнение этого задания. Дополнительные сведения о назначениях задач хранилища см. в статье "Назначения задач хранилища".

Это важно

Перед включением назначения задачи хранилища убедитесь, что вы предоставляете доступ к доверенным службам Azure в сетевых параметрах каждой целевой учетной записи хранения. Дополнительные сведения см. в статье "Предоставление доступа к доверенным службам Azure".

Создание задачи и управление ей

Создайте назначение для каждой учетной записи хранения, которую вы хотите нацелить. Задача хранилища может содержать до 50 назначений.

Замечание

В текущем выпуске можно использовать только учетные записи хранения, находящиеся в том же регионе, что и задачи хранения.

Портал

Создание назначения из меню задач хранилища

Можно создать назначение в контексте задачи хранения. Этот параметр может быть удобным, если вы являетесь автором задачи и хотите использовать несколько учетных записей хранения. Для каждого задания вы определите учетную запись хранения, на которую хотите ориентироваться.

Перейдите к задаче хранилища на портале Azure, а затем в разделе "Управление задачами хранилища" выберите "Назначения".

На странице "Назначения" выберите +Добавить назначение и откроется область "Добавить назначение ".

Создание задачи из меню хранилища

Можно также создать назначение в контексте учетной записи хранения. Этот параметр может быть удобным, если вы хотите использовать существующую задачу для обработки объектов в учетной записи хранения. Для каждого назначения вы определите задачу хранения, которую вы хотите назначить вашей учетной записи.

Перейдите к учетной записи хранения на портале Azure, а затем в разделе "Управление данными" выберите задачи хранилища.

На странице "Задачи хранилища " выберите вкладку "Назначение задач ", нажмите кнопку "Создать назначение" и нажмите кнопку "Добавить назначение".

Откроется панель добавления задания.

Выбор области

В разделе "Выбор области " выберите подписку и назовите назначение. Затем выберите учетную запись хранения, которую вы хотите использовать.

Если вы открыли область "Добавить задачу" в контексте учетной записи хранения, вы выберете задачу, связанную с хранением, вместо учетной записи хранения.

Описание каждого свойства см. в разделе "Параметры назначения".

Добавить назначение ролей

В разделе Назначение ролей, в раскрывающемся списке Роль, выберите роль, которую вы хотите назначить управляемому удостоверению задачи хранилища. Чтобы обеспечить успешное назначение задач, используйте роли, имеющие разрешения владельца данных Blob. Дополнительные сведения см. в статье о ролях Azure, необходимых для назначения задач.

Замечание

Вы выбираете тип управляемого удостоверения (назначаемый системой или назначаемый пользователем) в рамках создания задачи хранения.

Описание каждого свойства см. в разделе "Параметры назначения".

Добавление фильтра

В разделе Фильтры объектов выберите, следует ли нацелиться на подмножество бинарных больших объектов на основе фильтра. Фильтры помогают сузить область выполнения. Если вы хотите, чтобы задача оценивала все контейнеры и объекты Blob в учетной записи, можно выбрать параметр "Не фильтровать". В следующем примере используется фильтр, чтобы выбрать только те двоичные блобы, которые находятся в контейнере с именем mycontainer.

Описание каждого свойства см. в разделе "Параметры назначения".

Определение триггера

В разделе сведений о триггере выберите частоту выполнения этой задачи. Эту задачу можно запустить только один раз или запустить повторяющуюся задачу. Если вы решили запустить эту задачу на повторяющейся основе, выберите время начала и окончания и укажите количество дней между каждым запуском. Вы также можете указать, где вы хотите хранить отчеты о выполнении.

Описание каждого свойства см. в разделе "Параметры назначения".

Сохранить задание

Нажмите кнопку "Добавить ", чтобы создать назначение.

Панель добавления заданий закрывается. По завершении развертывания назначение появится на странице "Назначения ". Если на этой странице не отображается назначение, нажмите кнопку "Обновить ".

Активировать задание

Задание отключено по умолчанию. Чтобы включить назначение таким образом, чтобы оно было запланировано на выполнение, установите флажок, который отображается рядом с назначением, а затем нажмите кнопку "Включить".

После выполнения задачи создается отчет о выполнении, а затем хранится в контейнере, указанном при создании назначения. Дополнительные сведения об этом отчете, а также о том, как просматривать метрики, которые фиксируют количество целевых объектов, количество попыток операций и количество успешных операций, см. в статье "Анализ выполнения задач хранилища".

Изменение назначения

Назначение становится вложенным ресурсом целевой учетной записи хранения. Поэтому после создания назначения можно изменить только частоту выполнения. Другие поля назначения становятся доступными только для чтения. Параметр "Одиночный запуск" (только один раз) также становится доступным только для чтения.

• Чтобы изменить частоту выполнения назначения в контексте задачи хранения, перейдите к задаче хранения на портале Azure, а затем в разделе "Управление задачами хранилища" выберите "Назначения".

• Чтобы изменить частоту выполнения назначения в контексте учетной записи хранения, перейдите к учетной записи хранения на портале Azure, а затем в разделе "Управление данными" выберите задачи хранилища.

PowerShell

1. Сначала установите необходимые модули PowerShell. См. раздел "Установка модуля PowerShell"

2. Укажите частоту выполнения задачи. Вы можете запустить задачу только один раз или запустить повторяющуюся задачу. Если вы решили запустить эту задачу на повторяющейся основе, укажите время начала и окончания и укажите количество дней между каждым запуском. Вы также можете указать, где вы хотите хранить отчеты о выполнении. В следующем примере создается переменная для значений триггеров.

   $startTime = $startTime = (Get-Date).AddMinutes(10) 
   $reportPrefix = "my-storage-task-report"
   $triggerType = RunOnce
   $targetPrefix = "mycontainer/"
   

3. Получите задачу хранения, которую вы хотите включить в задание, с помощью команды Get-AzStorageActionTask .

   $task = Get-AzStorageActionTask -Name <"storage-task-name"> -ResourceGroupName "<resource-group>"
   

4. Создайте назначение задачи хранилища командой New-AzStorageTaskAssignment. Следующее назначение предназначено для контейнера mycontainer учетной записи с именем mystorageaccount. Это назначение указывает, что задача будет выполняться только один раз и сохранит отчеты о выполнении в папку с именем storage-tasks-report. Задача будет выполнена через 10 минут от текущего момента.

   New-AzStorageTaskAssignment `
   -ResourceGroupName "<resource-group>" `
   -AccountName "<storage-account-name>" `
   -name "<storage-task-assignment-name>" `
   -TaskId $task.ID `
   -ReportPrefix $reportPrefix `
   -TriggerType $triggerType `
   -StartOn $startTime.ToUniversalTime() `
   -Description "<description>" `
   -Enabled:$true `
   -TargetPrefix $targetPrefix `
   -TargetExcludePrefix ""
   

5. Предоставьте задаче хранилища разрешение на выполнение операций с целевой учетной записью хранения, назначив роль управляемому удостоверению. При создании задачи хранения можно выбрать тип управляемого удостоверения (назначаемый системой или назначаемый пользователем).

   Следующие команды назначают роль Storage Blob Data Owner управляемому удостоверению, назначенному системой для задачи хранения.

   New-AzRoleAssignment `
   -ResourceGroupName "<resource-group>" `
   -ResourceName "<storage-account-name>" `
   -ResourceType "Microsoft.Storage/storageAccounts" `
   -ObjectId $task.IdentityPrincipalId  `
   -RoleDefinitionName "Storage Blob Data Owner"
   

   Следующие команды назначают роль Storage Blob Data Owner управляемому удостоверению, созданному пользователем.

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   New-AzRoleAssignment `
   -ResourceGroupName "<resource-group>" `
   -ResourceName "<storage-account-name>" `
   -ResourceType "Microsoft.Storage/storageAccounts" `
   -ObjectId $managedIdentity.Id  `
   -RoleDefinitionName "Storage Blob Data Owner"
   

Azure CLI

Создание назначения с помощью Azure CLI

1. Укажите частоту выполнения задачи. Вы можете запустить задачу только один раз или запустить повторяющуюся задачу. Если вы решили запустить эту задачу на повторяющейся основе, укажите время начала и окончания и укажите количество дней между каждым запуском. Вы также можете указать, где вы хотите хранить отчеты о выполнении. В следующем примере создается переменная строки в формате JSON, указывающая имя контейнера, частоту выполнения задачи (RunOnce) и время выполнения отчета.

      current_datetime=$(date +"%Y-%m-%dT%H:%M:%S")
      executioncontextvariable="{target:{prefix:[mycontainer/],excludePrefix:[]},trigger:{type:'RunOnce',parameters:{startOn:'"${current_datetime}"'}}}"
   

   Строка, используемая в объекте executioncontextvariable , выражается с помощью сокращенного синтаксиса. Сокращенный синтаксис — это упрощенное представление строки JSON. Дополнительные сведения см. в статье "Использование сокращенного синтаксиса с помощью Azure CLI".

2. Получите идентификатор задания хранения, которое вы хотите включить в назначение, с помощью команды az storage-actions task show, а затем выполните запрос для свойства id.

 id=$(az storage-actions task show -g "<resource-group>" -n "<storage-task-name>" --query "id")

3. Создайте назначение задачи хранилища командой az storage account task-assignment create.

   az storage account task-assignment create \
      -g '<resource-group>' \
      -n '<storage-task-assignment-name>' \
      --account-name '<storage-account-name>' \
      --description '<description>' \
      --enabled true \
      --task-id $id \
      --execution-context $executioncontextvariable \
      --report "{prefix:storage-tasks-report}"
   

4. Предоставьте задаче хранилища разрешение на выполнение операций с целевой учетной записью хранения, назначив роль управляемому удостоверению. При создании задачи хранения можно выбрать тип управляемого удостоверения (назначаемый системой или назначаемый пользователем).

   Следующие команды назначают роль Storage Blob Data Owner управляемому удостоверению, назначенному системой для задачи хранения.

   $storageAccountID=az storage account show --name <storage-account-name> --resource-group <resource-group> --query "id"
   $roleDefinitionId="b7e6dc6d-f1e8-4753-8033-0f276bb0955b" \
   
   
   az role assignment create \
      --assignee-object-id $principalID \
      --scope $storageAccountID \
      --role $roleDefinitionId \
      --description "My role assignment" 
   

   Следующие команды назначают роль Storage Blob Data Owner управляемому удостоверению, созданному пользователем.

   $storageAccountID=az storage account show --name <storage-account-name> --resource-group <resource-group> --query "id"
   $roleDefinitionId="b7e6dc6d-f1e8-4753-8033-0f276bb0955b"
   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
    az role assignment create \
    --assignee-object-id $identityId 
      --role $roleDefinitionId \
      --description "My role assignment" 
   

Бицепс

Добавьте фрагмент кода, аналогичный приведенному ниже, в шаблон Bicep.

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-02-01' = {
  name: 'mystorageaccount'
  location: 'westus'
  kind: 'StorageV2'
  sku: {
    name: 'Standard_LRS'
  }
}

resource storageAccountName_storageTaskAssignment 'Microsoft.Storage/storageAccounts/storageTaskAssignments@2023-05-01' = {
  parent: storageAccount
  name: 'mystoragetaskassignment'
  properties: {
    taskId: '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.StorageActions/storageTasks/mystoragetask'
    enabled: true
    executionContext: {
      target: {
        prefix: [
          'mycontainer/'
        ]
        excludePrefix: []
      }
      trigger: {
        type: 'RunOnce'
        parameters: {
          startOn: '2025-04-20T21:34:00'
        }
      }
    }
    report: {
      prefix: 'storage-tasks-report'
    }
    description: 'mystoragetaskassignment'
  }
}

Шаблон

Добавьте фрагмент JSON, аналогичный приведенному ниже, в шаблон Azure Resource Manager.

  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-02-01",
      "name": "mystorageaccount",
      "location": "westus",
      "kind": "StorageV2",
      "sku": {
        "name": "Standard_LRS"
      }
    },
    {
      "type": "Microsoft.Storage/storageAccounts/storageTaskAssignments",
      "apiVersion": "2023-05-01",
      "name": "storagetaskassignmentname",
      "properties": {
        "taskId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.StorageActions/storageTasks/mystoragetask",
        "enabled": true,
        "executionContext": {
          "target": {
            "prefix": [
              "mycontainer/"
            ],
            "excludePrefix": []
          },
          "trigger": {
            "type": "RunOnce",
            "parameters": {
              "startOn": "2025-04-20T21:34:00"
            }
          }
        },
        "report": {
          "prefix": "storage-tasks-report"
        },
        "description": "[parameters('storageTaskAssignmentDescription')]"
      },
      "dependsOn": [
        "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount"
      ]
    }
  ]

См. также

• Назначения задач хранилища
• Обзор действий служба хранилища Azure
• Анализ выполнения задачи хранилища