Een opslagtaak maken

Zoek in Azure Portal naar Opslagtaken. Selecteer vervolgens onder Services opslagtaken - Azure Storage-acties.

Op de Azure Storage-acties | Pagina Opslagtaken , selecteer Maken.

Tabblad Basisbeginselen

Geef op het tabblad Basisinformatie de essentiële informatie op voor uw opslagtaak. In de volgende tabel worden de velden op het tabblad Basisbeginselen beschreven.

In de volgende afbeelding ziet u een voorbeeld van het tabblad Basisbeginselen .

Tabblad Voorwaarden

Definieer op het tabblad Voorwaarden de voorwaarden waaraan moet worden voldaan door elk object (container of blob) en de bewerkingen die op het object moeten worden uitgevoerd.

U moet ten minste één voorwaarde en één bewerking definiëren. Als u een component aan een voorwaarde wilt toevoegen, selecteert u Nieuwe component toevoegen. Als u bewerkingen wilt toevoegen, selecteert u Nieuwe bewerking toevoegen.

In de volgende tabel worden de velden op het tabblad Voorwaarden beschreven.

In de volgende afbeelding ziet u een voorbeeld van het tabblad Voorwaarden .

U kunt Preview-voorwaarden selecteren om een lijst met blobs weer te geven die worden beïnvloed door de voorwaarden die u hebt gedefinieerd. Zie Voorbeeld van het effect van voorwaarden voor meer informatie.

Tabblad Opdrachten

Een toewijzing identificeert een opslagaccount en een subset van objecten in dat account waarop de taak is gericht. Een toewijzing bepaalt ook wanneer de taak wordt uitgevoerd en waar uitvoeringsrapporten worden opgeslagen.

Als u een opdracht wilt toevoegen, selecteert u Opdracht toevoegen. Deze stap is optioneel. U hoeft geen toewijzing toe te voegen om de taak te maken.

In de volgende tabel worden de velden beschreven die worden weergegeven in het deelvenster Toewijzing toevoegen.

selecteer de rol die u wilt toewijzen aan de door het systeem toegewezen beheerde identiteit van de opslagtaak. Als u een geslaagde taaktoewijzing wilt garanderen, gebruikt u rollen met de machtigingen van de eigenaar van de blobgegevens. Zie Azure-rollen voor opslag taken voor meer informatie

In de volgende afbeelding ziet u een voorbeeld van het deelvenster Toewijzing toevoegen.

Tabblad Tags

Op het tabblad Tags kunt u Resource Manager-tags opgeven om uw Azure-resources te ordenen. Zie Resources, resourcegroepen en abonnementen voor logische organisatie taggen voor meer informatie.

In de volgende afbeelding ziet u een standaardconfiguratie van de eigenschappen van de indextag voor een nieuw opslagaccount.

Tabblad Beoordelen en maken

Wanneer u naar het tabblad Controleren en maken navigeert, wordt in Azure validatie uitgevoerd voor de instellingen van de opslagtaak die u hebt gekozen. Als de validatie is geslaagd, kunt u doorgaan met het maken van de opslagtaak.

Als de validatie mislukt, geeft de portal aan welke instellingen moeten worden gewijzigd.

In de volgende afbeelding ziet u de tabbladgegevens Controleren voordat u een nieuwe opslagtaak gaat maken.

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

2. Definieer een voorwaarde met behulp van JSON. Een voorwaarde is een verzameling van een of meer clausules. Elke clausule bevat een eigenschap, een waarde en een operator. Zie De voorwaarden voor opslagtaken voor meer informatie.

   $condition = "<condition-json>"
   

3. Definieer elke bewerking met behulp van de opdracht New-AzStorageActionTaskOperationObject . Zie Storage-taakbewerkingen voor meer informatie

    $operation = New-AzStorageActionTaskOperationObject `
    -Name "<operation-name>" `
    -Parameter @{"<parameter-name>"= "<parameter-value"} `
    -OnFailure break `
    -OnSuccess continue
   
   

4. Maak een opslagtaak met behulp van de opdracht New-AzStorageActionTask en geef eventuele voorwaarden en bewerkingen door die u definieert. Met de volgende opdracht maakt u een opslagtaak en schakelt u de door het systeem beheerde identiteit van de taak in. Voor opslagtaaktoewijzingen worden machtigingen gebruikt die zijn toegepast op die door het systeem beheerde identiteit om toegang te autoriseren.

   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -EnableSystemAssignedIdentity:$true
   

   Als u wilt dat toewijzingen worden geautoriseerd met behulp van een door de gebruiker toegewezen beheerde identiteit, moet u die identiteit opgeven als parameter voor de opdracht New-AzStorageActionTask . Met de volgende opdracht maakt u een opslagtaak en geeft u een door de gebruiker toegewezen beheerde identiteit op. Voor opslagtaaktoewijzingen worden machtigingen gebruikt die zijn toegepast op de door de gebruiker toegewezen beheerde identiteit om toegang te autoriseren.

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -UserAssignedIdentity $managedIdentity.Id
   

   Zie Een opslagtaaktoewijzing maken en beheren voor meer informatie over het maken van een toewijzing met behulp van PowerShell.

1. Definieer een voorwaarde met behulp van JSON. Een voorwaarde is een verzameling van een of meer clausules. Elke clausule bevat een eigenschap, een waarde en een operator. Zie De voorwaarden voor opslagtaken voor meer informatie.

   conditionclause="<condition-json>"
   

   Aanbeveling

   Azure CLI maakt gebruik van 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. Maak een opslagtaak met behulp van de opdracht az storage-actions task create en geef een expressie met JSON-indeling door van de voorwaarden en bewerkingen. In dit voorbeeld worden blobs in de koude laag gevonden en naar de hete laag verplaatst. Alle andere blobs worden verwijderd. Met de volgende opdracht maakt u een opslagtaak en geeft u een door het systeem toegewezen beheerde identiteit op. Voor opslagtaaktoewijzingen worden machtigingen gebruikt die zijn toegepast op de door het systeem toegewezen beheerde identiteit om toegang te autoriseren.

   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity "{type:SystemAssigned}" \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   Als u wilt dat toewijzingen worden geautoriseerd met behulp van een door de gebruiker toegewezen beheerde identiteit, moet u die identiteit opgeven als parameter voor de opdracht az storage-actions task create . Met de volgende opdracht maakt u een opslagtaak en geeft u een door de gebruiker toegewezen beheerde identiteit op. Voor opslagtaaktoewijzingen worden machtigingen gebruikt die zijn toegepast op de door de gebruiker toegewezen beheerde identiteit om toegang te autoriseren.

   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity $identityId \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   Zie Storage-taakbewerkingen voor meer informatie over bewerkingen.

   Zie Een toewijzing voor opslagtaken maken en beheren voor meer informatie over het maken van een toewijzing met behulp van Azure CLI.

Neem een fragment op dat vergelijkbaar is met het volgende in uw Bicep-sjabloon. In dit voorbeeld wordt een beleid voor onveranderbaarheid voor Word-documenten ingesteld.

Zie Quickstart voor een volledig voorbeeld: Een opslagtaak maken met Bicep.

resource storageTask 'Microsoft.StorageActions/storageTasks@2023-01-01' = {
  name: storageTaskName
  location: 'westus'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    action: {
      if: {
        condition: '[[endsWith(Name, \'.docx\')]]'
        operations: [
         {
            name: 'SetBlobImmutabilityPolicy'
            onSuccess: 'continue'
            onFailure: 'break'
            parameters: {
              untilDate: '2025-06-20T20:34:00'
              mode: 'locked'
            }
         }
        ]
      }

    }
    description: 'My storage task'
    enabled: true
  }
}

Neem een JSON-fragment op dat lijkt op het volgende in uw Azure Resource Manager-sjabloon. In dit voorbeeld wordt een beleid voor onveranderbaarheid voor Word-documenten ingesteld.

Zie Quickstart voor een volledig voorbeeld: Een opslagtaak maken met een ARM-sjabloon.

 "resources": [
    {
      "type": "Microsoft.StorageActions/storageTasks",
      "apiVersion": "2023-01-01",
      "name": "mystoragetask",
      "location": "westus",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "action": {
          "if": {
            "condition": "[[[endsWith(Name, '.docx')]]",
            "operations": [
              {
                "name": "SetBlobImmutabilityPolicy",
                "onSuccess": "continue",
                "onFailure": "break",
                "parameters": {
                  "untilDate": "2025-06-20T20:34:00",
                  "mode": "locked"
                }
              },
            ]
          }
        },
        "description": "my storage task",
        "enabled": true
      }
    }
  ]