Tworzenie i zarządzanie przypisaniem zadania magazynowego

Tworzenie przypisania z menu zadań magazynu

Możesz utworzyć zadanie w kontekście zadania magazynowego. Ta opcja może być wygodna, jeśli jesteś autorem zadania i chcesz skierować się na wiele kont magazynowych. Dla każdego zadania wybierz konto pamięci, które chcesz wskazać jako docelowe.

Przejdź do zadania przechowywania danych w Azure portal, a następnie w sekcji Zarządzanie zadaniami magazynu wybierz pozycję Przypisania.

Na stronie Przypisania wybierz + Dodaj przypisanie, a pojawi się panel Dodaj przypisanie.

Utworzenie zadania z menu konta magazynowego

Możesz także utworzyć przypisanie zadania ze strony Storage Actions w portalu konta magazynu. Ta opcja może być wygodna, jeśli chcesz użyć istniejącego zadania do przetwarzania obiektów w koncie magazynowym. Dla każdego przypisania wybierz zadanie przechowywania, które chcesz przypisać do swojego konta.

Przejdź do konta magazynu w portalu Azure. W sekcji Zarządzanie danymi wybierz Akcje magazynu.

W Akcjach magazynu wybierz zakładkę Przypisanie Zadania , wybierz + Utwórz przypisanie, a następnie wybierz + Dodaj przypisanie.

Zostanie wyświetlone okienko Dodawanie zadania.

Wybieranie zakresu

W sekcji Wybieranie zakresu wybierz subskrypcję i nadaj jej nazwę. Następnie wybierz konto magazynu, które chcesz wybrać jako docelowe.

Jeśli otworzono panel Dodaj przypisanie w kontekście konta magazynu, wybierz zadanie magazynu zamiast konta magazynu.

Opis każdej właściwości znajduje się w temacie Ustawienia przypisania.

Dodaj przypisanie roli

W sekcji Przypisanie roli wybierz rolę, którą chcesz przypisać do zarządzanej tożsamości zadania magazynowego z listy rozwijanej Role . Aby zapewnić pomyślne przypisanie zadania, użyj ról, które mają uprawnienia właściciela danych Blob. Aby dowiedzieć się więcej, zobacz Role platformy Azure wymagane do przypisywania zadań.

Opis każdej właściwości znajduje się w temacie Ustawienia przypisania.

Dodawanie filtru

W sekcji Filtrowanie obiektów wybierz, czy chcesz skierować działania do podzbioru obiektów blob na podstawie filtru. Filtry pomagają zawęzić zakres realizacji. Jeśli chcesz, aby zadanie oceniło wszystkie kontenery i bloby w koncie, wybierz opcję Nie filtruj . Poniższy przykład wykorzystuje filtr do celowania tylko w bloby istniejące w kontenerze o nazwie mycontainer.

Opis każdej właściwości znajduje się w temacie Ustawienia przypisania.

Definiowanie wyzwalacza

W sekcji Szczegóły wyzwalacza wybierz sposób, w jaki chcesz, aby to zadanie działało. Wybierz spośród następujących typów biegów:

• Uruchom raz: wykonaj zadanie pojedynczo.
• Cykliczne uruchamianie: Uruchom zadanie zgodnie z cyklicznym harmonogramem. Wybierz godzinę rozpoczęcia i zakończenia i określ liczbę dni między każdym uruchomieniem.
• Przebieg pozorny: symuluj wykonywanie zadania bez wykonywania żadnych operacji na obiektach blob. Uruchomienie symulacyjne skanuje i ocenia obiekty blob pod kątem warunków zadania oraz generuje szczegółowy raport pokazujący, które obiekty blob spełniły warunki i jakie operacje zostałyby wykonane. Żadne dane nie są modyfikowane. Aby uzyskać więcej informacji, zobacz Tworzenie i korzystanie z próbnego uruchomienia.

Dla wszystkich typów uruchomieni określ, gdzie chcesz przechowywać raporty wykonania.

Opis każdej właściwości znajduje się w temacie Ustawienia przypisania.

Zapisz zadanie

Wybierz przycisk Dodaj , aby utworzyć przypisanie.

Okienko Dodawanie przypisania zostanie zamknięte. Po zakończeniu wdrażania przypisanie zostanie wyświetlone na stronie Przypisania . Jeśli nie widzisz zadania na tej stronie, wybierz przycisk Odśwież.

Włącz przypisanie

Zadanie jest domyślnie wyłączone. Aby włączyć przypisanie i zaplanować jego uruchomienie, zaznacz pole wyboru obok przypisania, a następnie wybierz Włącz.

Po uruchomieniu zadania generuje raport wykonania i przechowuje go w kontenerze, który określiłeś przy tworzeniu przydziału. Aby uzyskać więcej informacji o raporcie oraz o tym, jak wyświetlać metryki obejmujące liczbę obiektów objętych działaniem, liczbę podjętych operacji oraz liczbę operacji zakończonych powodzeniem, zobacz Analizowanie uruchomień zadań magazynu.

Edytuj zadanie

Przypisanie staje się podzasobem docelowego konta magazynu. Dlatego po utworzeniu zadania możesz edytować tylko jego częstotliwość wykonywania. Pozostałe pola zadania stają się nieedytowalne. Opcja pojedynczego uruchomienia (tylko raz) staje się również tylko do odczytu.

• Aby edytować częstotliwość uruchamiania przypisania zasad w kontekście zadania magazynu, przejdź do zadania magazynu w portalu Azure. W obszarze Zarządzanie zadaniami magazynu wybierz pozycję Przypisania.

• Aby edytować częstotliwość wykonywania przydziału w kontekście konta magazynu, przejdź do konta magazynu w portalu Azure. W sekcji Zarządzanie Danymi wybierz Akcje Przechowywania.

1. Najpierw zainstaluj niezbędne moduły programu PowerShell. Zobacz Instalowanie modułu PowerShell.

2. Określ, jak często chcesz, żeby zadanie się uruchamiało. Możesz wybrać, czy zadanie wykonasz tylko raz, albo według harmonogramu cyklicznego. Jeśli zdecydujesz się uruchamiać to zadanie cyklicznie, określ czas rozpoczęcia i zakończenia oraz liczbę dni między kolejnymi uruchomieniami. Możesz również określić, gdzie chcesz przechowywać raporty wykonania. Poniższy przykład tworzy zmienną dla wartości wyzwalania.

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

3. Aby uzyskać zadanie przechowywania, które chcesz uwzględnić w swoim zadaniu, użyj polecenia Get-AzStorageActionTask.

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

4. Utwórz przypisanie zadania magazynu, używając polecenia New-AzStorageTaskAssignment. Następujące przypisanie jest przeznaczone dla mycontainer kontenera konta o nazwie mystorageaccount. To przypisanie określa, że zadanie uruchamia się tylko raz i zapisuje raporty wykonania do folderu o nazwie storage-tasks-report. Zadanie jest zaplanowane do uruchomienia 10 minut od chwili obecnej.

   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
   

5. Nadaj zadaniu magazynu uprawnienie do wykonywania operacji na docelowym koncie magazynu, przypisując rolę do tożsamości zarządzanej. Można wybrać typ tożsamości zarządzanej (przypisany przez system lub przypisany przez użytkownika) podczas tworzenia zadania związanego z przechowywaniem.

   Następujące polecenia przypisują rolę Storage Blob Data Owner zarządzanej tożsamości przypisanej przez system dla zadania związanego z magazynowaniem.

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

   Następujące polecenia przypisują rolę Storage Blob Data Owner do tożsamości zarządzanej przypisanej przez użytkownika.

   $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"
   

Tworzenie zadania przy użyciu Azure CLI

1. Określ częstotliwość uruchamiania zadania. Możesz uruchomić zadanie tylko raz lub uruchomić zadanie cykliczne. Jeśli zdecydujesz się uruchamiać to zadanie cyklicznie, określ godzinę rozpoczęcia i zakończenia i określ liczbę dni między każdym uruchomieniem. Możesz również określić, gdzie chcesz przechowywać raporty wykonania. Poniższy przykład tworzy zmienną w formie JSON sformatowaną jako łańcuch tekstów, która określa nazwę kontenera, częstotliwość wykonywania zadania (RunOnce), oraz czas wykonania raportu.

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

   Ciąg używany w elemencie executioncontextvariable jest wyrażany przy użyciu składni skróconej. Składnia skrócona to uproszczona reprezentacja ciągu JSON. Aby dowiedzieć się więcej, zobacz How to use shorthand syntax with Azure CLI (Jak używać składni skróconej z interfejsem wiersza polecenia platformy Azure).

2. Pobierz identyfikator zadania magazynu, które chcesz uwzględnić w przypisaniu za pomocą polecenia az storage-actions task show, a następnie wykonaj zapytanie o id właściwość.

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

3. Utwórz przypisanie zadania magazynu, używając polecenia 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. Nadaj zadaniu magazynu uprawnienie do wykonywania operacji na docelowym koncie magazynu, przypisując rolę do tożsamości zarządzanej. Można wybrać typ tożsamości zarządzanej (przypisany przez system lub przypisany przez użytkownika) podczas tworzenia zadania związanego z przechowywaniem.

   Następujące polecenia przypisują rolę Storage Blob Data Owner zarządzanej tożsamości przypisanej przez system dla zadania związanego z magazynowaniem.

   $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" 
   

   Następujące polecenia przypisują rolę Storage Blob Data Owner do tożsamości zarządzanej przypisanej przez użytkownika.

   $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" 
   

Dołącz fragment kodu podobny do poniższego w szablonie 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'
  }
}

Dołącz fragment kodu JSON podobny do poniższego w szablonie usługi 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"
      ]
    }
  ]