Een toewijzing voor een opslagtaak aanmaken en beheren

Een toewijzing maken vanuit het menu opslagtaak

U kunt een toewijzing maken in de context van een opslagtaak. Deze optie kan handig zijn als u de auteur van de taak bent en u meerdere opslagaccounts wilt targeten. Voor elke opdracht identificeer je het opslagaccount dat je wilt targeten.

Navigeer naar de opslagtaak in Azure Portal en selecteer vervolgens toewijzingen onder Opslagtaakbeheer.

Selecteer op de pagina Toewijzingen de optie + Toewijzing toevoegen en het venster Toewijzing toevoegen verschijnt.

Een toewijzing maken vanuit het menu van het opslagaccount

Je kunt ook een taaktoewijzing aanmaken vanaf de pagina Opslagacties in het opslagaccountportaal. Deze optie kan handig zijn als u een bestaande taak wilt gebruiken om objecten in uw opslagaccount te verwerken. Selecteer voor elke opdracht de opslagtaak die je aan je account wilt toewijzen.

Ga naar de opslagaccount in Azure Portal. Selecteer onder Gegevensbeheer de Opslagacties.

Selecteer in Opslagacties het tabblad Taaktoewijzing , selecteer + Toewijzing aanmaken en selecteer vervolgens + Toewijzing toevoegen.

Het deelvenster Toewijzing toevoegen wordt weergegeven.

Een bereik selecteren

Selecteer in de sectie Bereik een abonnement en geef de toewijzing een naam. Selecteer vervolgens het opslagaccount waarop u het doel wilt toepassen.

Als je het deelvenster Toewijzing toevoegen opent in de context van het opslagaccount, kies dan een opslagtaak in plaats van het opslagaccount.

Zie Toewijzingsinstellingen voor een beschrijving van elke eigenschap.

Een roltoewijzing toevoegen

Selecteer in de sectie Roltoewijzing de rol die je wilt toewijzen aan de beheerde identiteit van de opslagtaak in de vervolgkeuzelijst Rol. Als u een geslaagde taaktoewijzing wilt garanderen, gebruikt u rollen met de machtigingen van de eigenaar van de blobgegevens. Zie Azure-rollen die vereist zijn voor het toewijzen van taken voor meer informatie.

Zie Toewijzingsinstellingen voor een beschrijving van elke eigenschap.

Een filter toevoegen

Kies in de sectie Filterobjecten of u een subset van blobs wilt instellen op basis van een filter. Met filters kunt u het bereik van de uitvoering beperken. Als je wilt dat de taak alle containers en blobs in een account evalueert, kies je de optie Geen filter. Het volgende voorbeeld gebruikt een filter om alleen blobs te targeten die bestaan in een container genaamd mycontainer.

Zie Toewijzingsinstellingen voor een beschrijving van elke eigenschap.

De trigger definiëren

Selecteer in de sectie Triggerdetails hoe je wilt dat deze taak wordt uitgevoerd. Kies uit de volgende looptypes:

• Eenmaal uitvoeren: Voer de taak één keer uit.
• Terugkerende uitvoering: voer de taak uit volgens een terugkerend schema. Kies een begin- en eindtijd en geef het aantal dagen tussen elke uitvoering op.
• Proefdraaien: Simuleer de uitvoering van de taak zonder bewerkingen uit te voeren op blobs. Een mockrun scant en evalueert blobs op basis van de taakvoorwaarden en produceert een gedetailleerd rapport waarin wordt weergegeven welke blobs overeenkomen en welke bewerkingen zouden zijn uitgevoerd. Er worden geen gegevens gewijzigd. Zie Een mock-uitvoering maken en gebruiken voor meer informatie.

Voor alle uitvoeringstypen, geef aan waar je de uitvoeringsrapporten wilt opslaan.

Zie Toewijzingsinstellingen voor een beschrijving van elke eigenschap.

De opdracht opslaan

Selecteer de knop Toevoegen om de opdracht te maken.

Het deelvenster Toewijzing toevoegen wordt gesloten. Wanneer de implementatie is voltooid, wordt de toewijzing weergegeven op de pagina Toewijzingen . Als je de opdracht niet op die pagina ziet, selecteer dan de knop Vernieuwen.

Een toewijzing inschakelen

De opdracht is standaard uitgeschakeld. Om de opdracht in te schakelen en te plannen om uit te voeren, selecteer je het selectievakje naast de opdracht en selecteer je vervolgens Enable.

Nadat de taak is uitgevoerd, genereert het een uitvoeringsrapport en slaat het op in de container die je hebt gespecificeerd bij het aanmaken van de opdracht. Voor meer informatie over het rapport en hoe je metrics kunt bekijken die het aantal objecten waarop de taak is gericht, het aantal geprobeerde bewerkingen en het aantal succesvolle bewerkingen weergeven, zie Opslagtaakuitvoeringen analyseren.

Een opdracht bewerken

Een toewijzing wordt een subresource van het beoogde opslagaccount. Daarom kun je na het aanmaken van de opdracht alleen de uitvoeringsfrequentie bewerken. De andere velden van een opdracht kunnen niet worden bewerkt. De optie Single run (slechts één keer) wordt ook alleen-lezen.

• Om de uitvoeringsfrequentie van een toewijzing in de context van een opslagtaak te bewerken, navigeer je naar de opslagtaak in het Azure-portaal. Selecteer Toewijzingen onder Opslagtaakbeheer.

• Om de uitvoeringsfrequentie van een toewijzing in de context van een opslagaccount te wijzigen, ga je naar het opslagaccount in het Azure-portaal. Selecteer onder Gegevensbeheer de optie Opslagacties.

1. Installeer eerst de benodigde PowerShell-modules. Zie Installeer de PowerShell-module.

2. Geef aan hoe vaak je wilt dat de taak wordt uitgevoerd. Je kunt ervoor kiezen een taak slechts één keer uit te voeren, of de taak op een terugkerend schema te laten draaien. Als je besluit deze taak op terugkerende basis uit te voeren, specificeer dan een begin- en eindtijd en het aantal dagen tussen elke run. U kunt ook opgeven waar u de uitvoeringsrapporten wilt opslaan. Het volgende voorbeeld creëert een variabele voor triggerwaarden.

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

3. Haal de opslagtaak op die u wilt opnemen in uw toewijzing met behulp van de opdracht Get-AzStorageActionTask .

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

4. Maak een opslagtaaktoewijzing met behulp van de New-AzStorageTaskAssignment opdracht. De volgende toewijzing is gericht op de mycontainer container van een account genaamd mystorageaccount. Deze toewijzing specificeert dat de taak slechts één keer wordt uitgevoerd en uitvoeringsrapporten opslaat in een map genaamd storage-tasks-report. De taak is gepland om over 10 minuten te starten vanaf 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. Geef de opslagtaak toestemming om bewerkingen uit te voeren op het doelopslagaccount door een rol toe te wijzen aan de beheerde identiteit. U kunt het type beheerde identiteit (door het systeem toegewezen of door de gebruiker toegewezen) kiezen wanneer u de opslagtaak maakt.

   Met de volgende commando's wordt de rol van Storage Blob Data Owner toegewezen aan de door het systeem toegewezen beheerde identiteit van de opslagtaak.

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

   Met de volgende opdrachten wordt de rol Storage Blob Data Owner toegewezen aan een door de gebruiker toegewezen beheerde identiteit.

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

Een toewijzing maken met behulp van Azure CLI

1. Geef op hoe vaak u de taak wilt uitvoeren. U kunt ervoor kiezen om een taak slechts één keer uit te voeren of de taak opnieuw uit te voeren. Als u besluit deze taak op terugkerende basis uit te voeren, geeft u een begin- en eindtijd op en geeft u het aantal dagen tussen elke uitvoering op. U kunt ook opgeven waar u de uitvoeringsrapporten wilt opslaan. Het volgende voorbeeld maakt een JSON-geformatteerde stringvariabele aan die de containernaam, de taakuitvoeringsfrequentie (RunOnce), en de tijd om het rapport uit te voeren specificeert.

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

   De tekenreeks die in executioncontextvariable wordt gebruikt, wordt uitgedrukt met de verkorte syntaxis. Verkorte syntaxis is een vereenvoudigde weergave van een JSON-tekenreeks. Voor meer informatie, zie Hoe verkorte syntaxis met Azure CLI te gebruiken.

2. Haal de id op van de opslagtaak die u wilt opnemen in uw toewijzing met behulp van de opdracht az storage-actions task show en voer vervolgens een query uit voor de id eigenschap.

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

3. Maak een opslagtaaktoewijzing met behulp van de az storage account task-assignment create opdracht.

   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. Geef de opslagtaak toestemming om bewerkingen uit te voeren op het doelopslagaccount door een rol toe te wijzen aan de beheerde identiteit. U kunt het type beheerde identiteit (door het systeem toegewezen of door de gebruiker toegewezen) kiezen wanneer u de opslagtaak maakt.

   Met de volgende commando's wordt de rol van Storage Blob Data Owner toegewezen aan de door het systeem toegewezen beheerde identiteit van de opslagtaak.

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

   Met de volgende opdrachten wordt de rol Storage Blob Data Owner toegewezen aan een door de gebruiker toegewezen beheerde identiteit.

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

Neem een fragment op dat vergelijkbaar is met het volgende in uw Bicep-sjabloon.

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

Neem een JSON-fragment op dat lijkt op het volgende in uw Azure Resource Manager-sjabloon.

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