Tworzenie przypisania zadania magazynu i zarządzanie nim

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 przypisania wybierz konto magazynu, które chcesz określić 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 pozycję + Dodaj przypisanie , a zostanie wyświetlone okienko Dodawanie przypisania .

Utworzenie zadania z menu konta magazynowego

Możesz również utworzyć przypisanie w ramach konta magazynowego. 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 zidentyfikujesz zadanie dotyczące przechowywania, które chcesz przypisać do swojego konta.

Przejdź do konta magazynu w witrynie Azure Portal, a następnie w obszarze Zarządzanie danymi wybierz pozycję Zadania magazynu.

Na stronie Zadania magazynu wybierz kartę Przypisanie zadania, wybierz pozycję + Utwórz zadanie, a następnie wybierz pozycję + Dodaj zadanie.

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 okienko Dodawanie przypisania zostanie otwarte w kontekście konta magazynu, wybierzesz 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 na liście rozwijanej Rola wybierz rolę, którą chcesz przypisać do zarządzanej tożsamości zadania przechowywania. 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 przejrzało wszystkie kontenery i obiekty blob na koncie, możesz wybrać opcję Nie filtruj. W poniższym przykładzie użyto filtru do kierowania tylko obiektów blob, które istnieją 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 częstotliwość uruchamiania tego zadania. Możesz uruchomić to zadanie tylko raz lub uruchomić zadanie cykliczne. Jeśli zdecydujesz się uruchamiać to zadanie cyklicznie, wybierz 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.

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 na tej stronie nie widzisz przypisania, wybierz przycisk Odśwież .

Włącz przypisanie

Zadanie jest domyślnie wyłączone. Aby włączyć zadanie tak, aby zostało zaplanowane do uruchomienia, zaznacz pole wyboru obok zadania, a następnie wybierz opcję Włącz.

Po uruchomieniu zadania jest generowany raport wykonywania, a następnie przechowywany w kontenerze określonym podczas tworzenia przypisania. Aby uzyskać więcej informacji na temat tego raportu oraz sposobu wyświetlania metryk, które przechwytują liczbę obiektów docelowych, liczbę prób operacji oraz liczbę operacji zakończonych powodzeniem, zobacz Analizowanie przebiegów zadań magazynu.

Edytuj zadanie

Przypisanie staje się zasobem podrzędnym docelowego konta przechowywania. W związku z tym po utworzeniu przypisania można edytować tylko częstotliwość jego uruchamiania. Pozostałe pola zadania stają się tylko do odczytu. Opcja Pojedyncze uruchomienie (tylko raz) również staje się dostępna tylko do odczytu.

• Aby edytować częstotliwość przypisywania w kontekście zadania magazynowego, przejdź do zadania magazynowego w portalu Azure, a następnie w sekcji Zarządzanie zadaniami magazynu wybierz Przypisania.

• Aby edytować częstotliwość wykonywania zadania w kontekście konta magazynu, przejdź do konta magazynu w portalu Azure, a następnie w obszarze Zarządzanie danymi wybierz pozycję Zadania magazynu.

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

2. 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ą dla wartości wyzwalacza.

   $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 zostanie uruchomione tylko raz i zapisze raporty wykonywania w folderze 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 `
   -TargetExcludePrefix ""
   

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żej przedstawiono sposób tworzenia zmiennej ciągu w formacie JSON, która określa nazwę kontenera, częstotliwość uruchamiania zadania (RunOnce) oraz czas uruchamiania 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"
      ]
    }
  ]