Erstellen und Verwalten einer Speicheraufgabenzuweisung

Erstellen einer Aufgabe aus dem Menü "Speicheraufgabe"

Sie können eine Aufgabe im Kontext einer Speicheraufgabe erstellen. Diese Option kann praktisch sein, wenn Sie der Aufgabenautor sind und auf mehrere Speicherkonten abzielen möchten. Für jede Aufgabe identifizieren Sie das Speicherkonto, auf das Sie abzielen möchten.

Navigieren Sie im Azure-Portal zu der Speicheraufgabe, und wählen Sie dann unter " Speicheraufgabenverwaltung" die Option "Aufgaben" aus.

Wählen Sie auf der Seite " Aufgaben"die Option "Aufgabe hinzufügen" aus , und der Aufgabenbereich " Hinzufügen " wird angezeigt.

Erstellen einer Aufgabe aus dem Menü "Speicherkonto"

Sie können auch eine Aufgabe im Kontext eines Speicherkontos erstellen. Diese Option kann praktisch sein, wenn Sie eine vorhandene Aufgabe zum Verarbeiten von Objekten in Ihrem Speicherkonto verwenden möchten. Für jede Aufgabe identifizieren Sie die Speicheraufgabe, die Sie Ihrem Konto zuweisen möchten.

Navigieren Sie zum Speicherkonto im Azure-Portal, und wählen Sie dann unter "Datenverwaltung" die Option "Speicheraufgaben" aus.

Wählen Sie auf der Seite "Speicheraufgaben" die Registerkarte "Aufgabenzuweisung" aus, wählen Sie "+ Aufgabe erstellen" und dann "+ Aufgabe hinzufügen" aus.

Der Bereich "Aufgabe hinzufügen" wird angezeigt.

Auswählen eines Bereichs

Wählen Sie im Abschnitt " Bereich auswählen " ein Abonnement aus, und benennen Sie die Aufgabe. Wählen Sie dann das Speicherkonto aus, auf das Sie abzielen möchten.

Wenn Sie den Aufgabenbereich "Hinzufügen " im Kontext des Speicherkontos geöffnet haben, wählen Sie eine Speicheraufgabe anstelle des Speicherkontos aus.

Eine Beschreibung der einzelnen Eigenschaften finden Sie unter "Zuordnungseinstellungen".

Hinzufügen einer Rollenzuweisung

Wählen Sie im Abschnitt "Rollenzuweisung " in der Dropdownliste " Rolle " die Rolle aus, die Sie der verwalteten Identität der Speicheraufgabe zuweisen möchten. Verwenden Sie Rollen, die über die Berechtigungen "Blob Data Owner" verfügen, um eine erfolgreiche Aufgabenzuweisung sicherzustellen. Weitere Informationen finden Sie unter Azure-Rollen, die zum Zuweisen von Aufgaben erforderlich sind.

Eine Beschreibung der einzelnen Eigenschaften finden Sie unter "Zuordnungseinstellungen".

Hinzufügen eines Filters

Wählen Sie im Abschnitt "Filterobjekte " aus, ob Sie eine Teilmenge von Blobs basierend auf einem Filter als Ziel festlegen möchten. Mithilfe von Filtern können Sie den Umfang der Ausführung einschränken. Wenn die Aufgabe alle Container und Blobs in einem Konto auswerten soll, können Sie die Option " Nicht filtern" auswählen. Im folgenden Beispiel wird ein Filter verwendet, um nur Blobs abzuzielen, die in einem Container mit dem Namen mycontainervorhanden sind.

Eine Beschreibung der einzelnen Eigenschaften finden Sie unter "Zuordnungseinstellungen".

Definieren des Triggers

Wählen Sie im Abschnitt " Triggerdetails " aus, wie oft diese Aufgabe ausgeführt werden soll. Sie können die Aufgabe entweder nur einmal ausführen oder sie wiederholt ausführen. Wenn Sie sich für die Ausführung dieser Aufgabe auf wiederkehrender Basis entscheiden, wählen Sie eine Start- und Endzeit aus, und geben Sie die Anzahl der Tage zwischen den einzelnen Ausführungen an. Sie können auch angeben, wo Sie die Ausführungsberichte speichern möchten.

Eine Beschreibung der einzelnen Eigenschaften finden Sie unter "Zuordnungseinstellungen".

Speichern der Aufgabe

Wählen Sie die Schaltfläche "Hinzufügen " aus, um die Aufgabe zu erstellen.

Der Bereich Zuweisung hinzufügen wird geschlossen. Wenn die Bereitstellung abgeschlossen ist, wird die Zuordnung auf der Seite " Aufgaben" angezeigt. Wenn die Aufgabe auf dieser Seite nicht angezeigt wird, wählen Sie die Schaltfläche " Aktualisieren " aus.

Aktivieren einer Aufgabe

Die Zuweisung ist standardmäßig deaktiviert. Wenn Sie die Aufgabe so aktivieren möchten, dass sie ausgeführt werden soll, aktivieren Sie das Kontrollkästchen, das neben der Aufgabe angezeigt wird, und wählen Sie dann "Aktivieren" aus.

Nachdem die Aufgabe ausgeführt wurde, wird ein Ausführungsbericht generiert und dann im Container gespeichert, den Sie beim Erstellen der Zuordnung angegeben haben. Weitere Informationen zu diesem Bericht sowie zum Anzeigen von Metriken, die die Anzahl der Objekte erfassen, die Anzahl der versuchten Vorgänge und die Anzahl der erfolgreichen Vorgänge finden Sie unter "Analysieren der Speicheraufgabe".

Bearbeiten einer Zuweisung

Eine Zuordnung wird zu einer Unterressource des Zielspeicherkontos. Daher können Sie nach dem Erstellen der Aufgabe nur die Ausführungshäufigkeit bearbeiten. Die anderen Felder einer Zuordnung werden schreibgeschützt. Die Option Einmalige Ausführung (nur einmal) wird ebenfalls schreibgeschützt.

• Um die Ausführungshäufigkeit einer Zuordnung im Kontext einer Speicheraufgabe zu bearbeiten, navigieren Sie im Azure-Portal zu der Speicheraufgabe und wählen Sie dann unter Speicheraufgabenverwaltung die Option Zuordnungen aus.

• Um die Ausführungshäufigkeit einer Zuordnung im Kontext eines Speicherkontos zu bearbeiten, navigieren Sie im Azure-Portal zum Speicherkonto, und wählen Sie dann unter Datenverwaltung die Option Speicheraufgaben aus.

1. Installieren Sie zunächst die erforderlichen PowerShell-Module. Siehe Installieren des PowerShell-Moduls

2. Geben Sie an, wie oft die Aufgabe ausgeführt werden soll. Sie können eine Aufgabe nur einmal ausführen oder die Aufgabe regelmäßig ausführen. Wenn Sie sich entscheiden, diese Aufgabe auf wiederkehrender Basis auszuführen, geben Sie eine Start- und Endzeit an, und geben Sie die Anzahl der Tage zwischen den einzelnen Ausführungen an. Sie können auch angeben, wo Sie die Ausführungsberichte speichern möchten. Im folgenden Beispiel wird eine Variable für Triggerwerte erstellt.

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

3. Rufen Sie die Speicheraufgabe ab, die Sie in Ihre Aufgabe einschließen möchten, indem Sie den Befehl "Get-AzStorageActionTask " verwenden.

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

4. Erstellen Sie eine Speicheraufgabenzuweisung mithilfe des New-AzStorageTaskAssignment Befehls. Die folgende Zuweisung hat den Container mycontainer eines Kontos namens mystorageaccount zum Ziel. Diese Zuordnung gibt an, dass die Aufgabe nur einmal ausgeführt wird, und Ausführungsberichte werden in einem Ordner mit dem Namen storage-tasks-report gespeichert. Die Aufgabe ist für die Ausführung in 10 Minuten (ab jetzt) geplant.

   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. Erteilen Sie der Speicheraufgabe die Berechtigung zum Ausführen von Vorgängen für das Zielspeicherkonto, indem Sie der verwalteten Identität eine Rolle zuweisen. Sie können den verwalteten Identitätstyp (vom System zugewiesen oder vom Benutzer zugewiesen) auswählen, wenn Sie die Speicheraufgabe erstellen.

   Die folgenden Befehle weisen der systemseitig zugewiesenen verwalteten Identität der Speicheraufgabe die Rolle Storage Blob Data Owner zu.

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

   Die folgenden Befehle weisen die Rolle Storage Blob Data Owner einer vom Benutzer zugewiesenen verwalteten Identität zu.

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

Erstellen einer Aufgabe mithilfe von Azure CLI

1. Geben Sie an, wie oft die Aufgabe ausgeführt werden soll. Sie können eine Aufgabe nur einmal ausführen oder die Aufgabe regelmäßig ausführen. Wenn Sie sich entscheiden, diese Aufgabe auf wiederkehrender Basis auszuführen, geben Sie eine Start- und Endzeit an, und geben Sie die Anzahl der Tage zwischen den einzelnen Ausführungen an. Sie können auch angeben, wo Sie die Ausführungsberichte speichern möchten. Im Folgenden wird eine JSON-formatierte Zeichenfolgenvariable erstellt, die den Containernamen, die Ausführungshäufigkeit der Aufgabe (RunOnce) und die Zeit zum Ausführen des Berichts angibt.

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

   Die in executioncontextvariable verwendete Zeichenfolge wird mithilfe von Kurzhandsyntax ausgedrückt. Die Kurzhandsyntax ist eine vereinfachte Darstellung einer JSON-Zeichenfolge. Weitere Informationen finden Sie unter Verwenden der Kurzhandsyntax mit Azure CLI.

2. Rufen Sie die ID der Speicheraufgabe ab, die Sie in Ihre Aufgabe einbeziehen möchten, indem Sie den Befehl "az storage-actions"-Aufgaben anzeigen verwenden und dann die id Eigenschaft abfragen.

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

3. Erstellen Sie eine Speicheraufgabenzuweisung mithilfe des az storage account task-assignment create Befehls.

   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. Erteilen Sie der Speicheraufgabe die Berechtigung zum Ausführen von Vorgängen für das Zielspeicherkonto, indem Sie der verwalteten Identität eine Rolle zuweisen. Sie können den verwalteten Identitätstyp (vom System zugewiesen oder vom Benutzer zugewiesen) auswählen, wenn Sie die Speicheraufgabe erstellen.

   Die folgenden Befehle weisen der systemseitig zugewiesenen verwalteten Identität der Speicheraufgabe die Rolle Storage Blob Data Owner zu.

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

   Die folgenden Befehle weisen die Rolle Storage Blob Data Owner einer vom Benutzer zugewiesenen verwalteten Identität zu.

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

Fügen Sie einen Codeschnipsel ähnlich dem folgenden in Ihre Bicep-Vorlage ein.

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'
  }
}

Fügen Sie einen JSON-Codeausschnitt ähnlich dem folgenden in Ihre Azure Resource Manager-Vorlage ein.

  "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"
      ]
    }
  ]