Skapa och hantera en tilldelning av lagringsaktivitet

Skapa en tilldelning från lagringsaktivitetsmenyn

Du kan skapa en tilldelning i kontexten för en lagringsuppgift. Det här alternativet kan vara praktiskt om du är aktivitetsförfattare och vill rikta in dig på flera lagringskonton. För varje tilldelning, identifiera det lagringskonto du vill rikta in dig på.

Gå till lagringsaktiviteten i Azure-portalen och välj sedan Tilldelningar under Hantering av lagringsaktivitet.

På sidan Tilldelningar , välj + Lägg till tilldelning och panelen Lägg till tilldelning visas.

Skapa en tilldelning från lagringskontomenyn

Du kan också skapa en aktivitetstilldelning från sidan Lagringsåtgärder i lagringskontoportalen. Det här alternativet kan vara praktiskt om du vill använda en befintlig uppgift för att bearbeta objekt i ditt lagringskonto. För varje uppgift, välj den lagringsaktivitet du vill koppla till ditt konto.

Gå till lagringskontot i Azure-portalen. Under Datahantering, välj Lagringsåtgärder.

I Lagringsåtgärder, välj fliken Uppgiftstilldelning, välj + Skapa tilldelning och välj sedan + Lägg till tilldelning.

Fönstret Lägg till tilldelning visas.

Välj ett omfång

I avsnittet Välj omfång väljer du en prenumeration och namnger tilldelningen. Välj sedan det lagringskonto som du vill rikta in dig på.

Om du öppnade panelen Lägg till tilldelning i kontexten för lagringskontot, välj en lagringsuppgift istället för lagringskontot.

En beskrivning av varje egenskap finns i Tilldelningsinställningar.

Lägga till en rolltilldelning

I avsnittet Rolltilldelning väljer du den roll du vill tilldela lagringsuppgiftens hanterade identitet från rullgardinsmenyn Roll . Använd roller som har behörigheten Blob Data Owner för att säkerställa en lyckad uppgiftstilldelning. Mer information finns i Azure-roller som krävs för att tilldela uppgifter.

En beskrivning av varje egenskap finns i Tilldelningsinställningar.

Lägg till ett filter

I avsnittet Filterobjekt väljer du om du vill rikta in dig på en delmängd blobar baserat på ett filter. Filter hjälper dig att begränsa körningsomfånget. Om du vill att uppgiften ska utvärdera alla containrar och blobbar i ett konto väljer du alternativet Ingen filtrering. Följande exempel använder ett filter för att endast rikta in sig på blobs som finns i en behållare som heter mycontainer.

En beskrivning av varje egenskap finns i Tilldelningsinställningar.

Definiera utlösaren

I avsnittet Trigger-detaljer väljer du hur du vill att denna uppgift ska köras. Välj bland följande typer av körningar:

• Kör en gång: Kör uppgiften en gång.
• Återkommande körning: Kör uppgiften enligt ett återkommande schema. Välj en start- och sluttid och ange antalet dagar mellan varje körning.
• Testkörning: Simulera aktivitetens körning utan att utföra några åtgärder på blobar. En simulerad körning söker igenom och utvärderar blobbar utifrån aktivitetens villkor och genererar en detaljerad rapport som visar vilka blobbar som matchade och vilka åtgärder som skulle ha utförts. Inga data ändras. Mer information finns i Skapa och använda en testkörning.

För alla körtyper, ange var du vill lagra exekveringsrapporterna.

En beskrivning av varje egenskap finns i Tilldelningsinställningar.

Spara tilldelningen

Välj knappen Lägg till för att skapa tilldelningen.

Fönstret Lägg till tilldelning stängs. När distributionen är klar visas tilldelningen på sidan Tilldelningar . Om du inte ser uppgiften på den sidan, välj Uppdatera-knappen.

Aktivera en tilldelning

Tilldelningen är inaktiverad som standard. För att aktivera tilldelningen och schemalägga den att köras, markera kryssrutan bredvid tilldelningen och välj sedan Aktivera.

Efter att uppgiften körts genererar den en exekveringsrapport och lagrar den i den container du angav när du skapade aktiviteten. För mer information om rapporten och hur man kan se mätvärden som fångar antalet objekt som har varit mål för åtgärder, antalet försökta operationer och antalet framgångsrika operationer, se Analysera lagringsuppgiftskörningar.

Redigera en tilldelning

En tilldelning blir en delresurs till det avsedda lagringskontot. Därför, efter att du skapat uppgiften, kan du bara ändra dess körfrekvens. De andra fälten i en uppgift blir skrivskyddade. Alternativet Enkel körning (endast en gång) blir också skrivskyddat.

• För att redigera körningsfrekvensen för en tilldelning i kontexten av en lagringsuppgift, navigera till lagringsuppgiften i Azure-portalen. Under Hantering av lagringsaktivitet väljer du Tilldelningar.

• För att redigera körfrekvensen för en tilldelning i kontexten av ett lagringskonto, gå till lagringskontot i Azure-portalen. Under Datahantering, välj Lagringsåtgärder.

1. Installera först nödvändiga PowerShell-moduler. Se Installera PowerShell-modulen.

2. Ange hur ofta du vill att uppgiften ska köras. Du kan välja att köra en uppgift bara en gång, eller köra uppgiften på ett återkommande schema. Om du bestämmer dig för att köra denna uppgift regelbundet, ange start- och sluttid och ange antalet dagar mellan varje körning. Du kan också ange var du vill lagra utföranderapporterna. Följande exempel skapar en variabel för triggervärden.

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

3. Hämta den lagringsuppgift som du vill inkludera i tilldelningen med hjälp av kommandot Get-AzStorageActionTask .

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

4. Skapa en tilldelning av lagringsaktivitet med hjälp av kommandot New-AzStorageTaskAssignment. Följande tilldelning riktar sig mot en mycontainer-container för ett konto som heter mystorageaccount. Denna tilldelning anger att uppgiften bara körs en gång och sparar exekveringsrapporter till en mapp som heter storage-tasks-report. Uppgiften är schemalagd att köra 10 minuter från nu.

   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. Ge lagringsaktiviteten behörighet att utföra åtgärder på mållagringskontot genom att tilldela en roll till den hanterade identiteten. Du kan välja den hanterade identitetstypen (systemtilldelad eller användartilldelad) när du skapar lagringsuppgiften.

   Följande kommandon tilldelar rollen Storage Blob Data Owner till systemets hanterade identitet som är tilldelad för lagringsuppgiften.

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

   Följande kommandon tilldelar rollen Storage Blob Data Owner till en användartilldelad hanterad identitet.

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

Skapa en tilldelning med hjälp av Azure CLI

1. Ange hur ofta du vill att aktiviteten ska köras. Du kan välja att bara köra en aktivitet en gång eller köra uppgiften återkommande. Om du bestämmer dig för att köra den här aktiviteten regelbundet anger du en start- och sluttid och anger antalet dagar mellan varje körning. Du kan också ange var du vill lagra utföranderapporterna. Följande exempel skapar en JSON-formaterad strängvariabel som specificerar containernamn, uppgiftsfrekvens (RunOnce) och tiden för att köra rapporten.

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

   Strängen som används i executioncontextvariable är uttryckt med hjälp av kortfattad syntax. Kortsyntax är en förenklad representation av en JSON-sträng. Mer information finns i Använda kortfattad syntax med Azure CLI.

2. Hämta ID:t för lagringsuppgiften som du vill inkludera i tilldelningen med hjälp av kommandot az storage-actions task show och sedan fråga efter id egenskapen.

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

3. Skapa en tilldelning av lagringsaktivitet med hjälp av kommandot 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. Ge lagringsaktiviteten behörighet att utföra åtgärder på mållagringskontot genom att tilldela en roll till den hanterade identiteten. Du kan välja den hanterade identitetstypen (systemtilldelad eller användartilldelad) när du skapar lagringsuppgiften.

   Följande kommandon tilldelar rollen Storage Blob Data Owner till systemets hanterade identitet som är tilldelad för lagringsuppgiften.

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

   Följande kommandon tilldelar rollen Storage Blob Data Owner till en användartilldelad hanterad identitet.

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

Inkludera ett kodfragment som liknar följande i Bicep-mallen.

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

Inkludera ett JSON-kodfragment som liknar följande i Azure Resource Manager-mallen.

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