Erstellen einer Speicheraufgabe

Suchen Sie im Azure-Portal nach Speicheraufgaben. Wählen Sie dann unter Dienste die Option Speicheraufgaben – Azure Speichervorgänge aus.

Wählen Sie auf der Seite Azure Speichervorgänge | Speicheraufgaben die Option Erstellen.

Registerkarte Grundlagen

Geben Sie auf der Registerkarte Grundlagen die essentiellen Informationen für Ihr Speicheraufgabe an. In der folgenden Tabelle werden die Felder der Registerkarte Grundlagen beschrieben.

Die folgende Abbildung zeigt ein Beispiel der Registerkarte Grundlagen.

Registerkarte „Bedingungen“

Definieren Sie auf der Registerkarte Bedingungen die Bedingungen, die von jedem Objekt (Container oder Blob) erfüllt werden müssen, und die Vorgänge, die für das Objekt ausgeführt werden sollen.

Sie müssen mindestens eine Bedingung und einen Vorgang definieren. Wenn Sie einer Bedingung eine Klausel hinzufügen möchten, wählen Sie Neue Klausel hinzufügen aus. Um Vorgänge hinzuzufügen, wählen Sie Neuen Vorgang hinzufügen aus.

In der folgenden Tabelle werden die Felder der Registerkarte Bedingungen beschrieben.

Die folgende Abbildung zeigt ein Beispiel der Registerkarte Bedingungen.

Sie können "Vorschaubedingungen" auswählen, um eine Liste von Blobs anzuzeigen, die sich auf die von Ihnen definierten Bedingungen auswirken würden. Weitere Informationen finden Sie unter "Vorschau der Auswirkungen von Bedingungen".

Registerkarte „Zuweisungen“

Eine Zuordnung identifiziert ein Speicherkonto und eine Teilmenge von Objekten in diesem Konto, auf das die Aufgabe ausgerichtet ist. Eine Zuordnung definiert auch, wann die Aufgabe ausgeführt wird und wo Ausführungsberichte gespeichert werden.

Um eine Zuweisung hinzuzufügen, wählen Sie Zuweisung hinzufügen aus. Dieser Schritt ist optional. Sie müssen keine Zuweisung hinzufügen, um die Aufgabe zu erstellen.

In der folgenden Tabelle werden die Felder beschrieben, die im Bereich Zuweisung hinzufügen angezeigt werden.

wählen Sie die Rolle aus, die Sie der vom System zugewiesenen 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 für Speicheraufgaben

Die folgende Abbildung zeigt ein Beispiel für den Bereich Zuweisung hinzufügen.

Registerkarte „Tags“

Auf der Registerkarte Tags können Sie Resource Manager-Tags angeben, um Ihre Azure-Ressourcen zu organisieren. Weitere Informationen finden Sie unter Markieren von Ressourcen, Ressourcengruppen und Abonnements für die logische Organisation.

Die folgende Abbildung zeigt eine Standardkonfiguration der Indextageigenschaften für ein neues Speicherkonto.

Registerkarte „Überprüfen und erstellen“

Wenn Sie zur Registerkarte Überprüfen + erstellen navigieren, führt Azure die Überprüfung der ausgewählten Speicheraufgabeneinstellungen aus. Wenn die Überprüfung erfolgreich ist, können Sie mit dem Erstellen der Speicheraufgabe fortfahren.

Wenn die Überprüfung fehlschlägt, gibt das Portal an, welche Einstellungen geändert werden müssen.

Die folgende Abbildung zeigt die Daten der Registerkarte Überprüfen vor der Erstellung einer neuen Speicheraufgabe.

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

2. Definieren Sie eine Bedingung mithilfe von JSON. Eine Bedingung, die eine Auflistung einer oder mehrerer Klauseln enthält. Jede Klausel enthält eine Eigenschaft, einen Wert und einen Operator. Weitere Informationen finden Sie unter Speicheraufgabenbedingungen.

   $condition = "<condition-json>"
   

3. Definieren Sie jeden Vorgang mithilfe des Befehls "New-AzStorageActionTaskOperationObject ". Weitere Informationen finden Sie unter Speicheraufgabenvorgänge

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

4. Erstellen Sie eine Speicheraufgabe mithilfe des Befehls "New-AzStorageActionTask ", und übergeben Sie alle von Ihnen definierten Bedingungen und Vorgänge. Mit dem folgenden Befehl wird eine Speicheraufgabe erstellt und die vom System verwaltete Identität der Aufgabe aktiviert. Speicheraufgabenzuweisungen verwenden Berechtigungen, die auf diese vom System verwaltete Identität angewendet werden, um den Zugriff zu autorisieren.

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

   Wenn Sie möchten, dass Zuweisungen mithilfe einer vom Benutzer zugewiesenen verwalteten Identität autorisiert werden, müssen Sie diese Identität als Parameter für den Befehl "New-AzStorageActionTask " angeben. Der folgende Befehl erstellt eine Speicheraufgabe und gibt eine vom Benutzer zugewiesene verwaltete Identität an. Speicheraufgabenzuweisungen verwenden Berechtigungen, die auf die vom Benutzer zugewiesene verwaltete Identität angewendet werden, um den Zugriff zu autorisieren.

   $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
   

   Informationen zum Erstellen einer Aufgabe mithilfe von PowerShell finden Sie unter Erstellen und Verwalten einer Speicheraufgabenzuweisung.

1. Definieren Sie eine Bedingung mithilfe von JSON. Eine Bedingung, die eine Auflistung einer oder mehrerer Klauseln enthält. Jede Klausel enthält eine Eigenschaft, einen Wert und einen Operator. Weitere Informationen finden Sie unter Speicheraufgabenbedingungen.

   conditionclause="<condition-json>"
   

   Tipp

   Azure CLI verwendet Kurzhandsyntax. Die Kurzhandsyntax ist eine vereinfachte Darstellung einer JSON-Zeichenfolge. Weitere Informationen finden Sie unter Verwenden der Kurzhandsyntax mit Azure CLI.

2. Erstellen Sie eine Speicheraufgabe mithilfe des Befehls "az storage-actions" , und übergeben Sie einen JSON-formatierten Ausdruck der Bedingungen und Vorgänge. In diesem Beispiel werden Blobs im Cool-Tier identifiziert und in das Hot-Tier verschoben. Alle anderen Blobs werden gelöscht. Der folgende Befehl erstellt eine Speicheraufgabe und gibt eine vom System zugewiesene verwaltete Identität an. Speicheraufgabenzuweisungen verwenden Berechtigungen, die auf die vom System zugewiesene verwaltete Identität angewendet werden, um den Zugriff zu autorisieren.

   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
   

   Wenn Sie möchten, dass Zuweisungen mithilfe einer vom Benutzer zugewiesenen verwalteten Identität autorisiert werden, müssen Sie diese Identität als Parameter für die Aufgabe "az storage-actions create " angeben. Der folgende Befehl erstellt eine Speicheraufgabe und gibt eine vom Benutzer zugewiesene verwaltete Identität an. Speicheraufgabenzuweisungen verwenden Berechtigungen, die auf die vom Benutzer zugewiesene verwaltete Identität angewendet werden, um den Zugriff zu autorisieren.

   $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
   

   Weitere Informationen zu Operationen von Speicheraufgaben finden Sie unter Speicheraufgabenoperationen.

   Informationen zum Erstellen einer Aufgabe mithilfe der Azure CLI finden Sie unter Erstellen und Verwalten einer Speicheraufgabenzuweisung.

Fügen Sie einen Codeschnipsel ähnlich dem folgenden in Ihre Bicep-Vorlage ein. In diesem Beispiel wird eine Unveränderbarkeitsrichtlinie für Word-Dokumente festgelegt.

Ein vollständiges Beispiel finden Sie unter "Schnellstart: Erstellen einer Speicheraufgabe mit 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
  }
}

Fügen Sie einen JSON-Codeausschnitt ähnlich dem folgenden in Ihre Azure Resource Manager-Vorlage ein. In diesem Beispiel wird eine Unveränderbarkeitsrichtlinie für Word-Dokumente festgelegt.

Ein vollständiges Beispiel finden Sie unter "Schnellstart: Erstellen einer Speicheraufgabe mit einer ARM-Vorlage".

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