Tworzenie zadania magazynu

W witrynie Azure Portal wyszukaj pozycję Zadania magazynu. Następnie w obszarze Usługi wybierz pozycję Zadania magazynu — Azure Storage Actions.

W usłudze Azure Storage Actions | Strona Zadania magazynu, wybierz pozycję Utwórz.

Karta Podstawowe

Na karcie Podstawowe podaj podstawowe informacje dotyczące zadania magazynu. W poniższej tabeli opisano pola na karcie Podstawy .

Na poniższej ilustracji przedstawiono przykład karty Podstawy .

Karta Warunki

Na karcie Warunki zdefiniuj warunki, które muszą zostać spełnione przez każdy obiekt (kontener lub obiekt blob) oraz operacje do wykonania w obiekcie.

Należy zdefiniować co najmniej jeden warunek i jedną operację. Aby dodać klauzulę do warunku, wybierz pozycję Dodaj nową klauzulę. Aby dodać operacje, wybierz pozycję Dodaj nową operację.

W poniższej tabeli opisano pola na karcie Warunki .

Na poniższej ilustracji przedstawiono przykład karty Warunki .

Możesz wybrać pozycję Warunki podglądu , aby wyświetlić listę obiektów blob, które będą miały wpływ na zdefiniowane warunki. Aby dowiedzieć się więcej, zobacz Podgląd wpływu warunków.

Karta Przypisania

Przypisanie identyfikuje konto magazynu i podzbiór obiektów na tym koncie, które będzie przeznaczone dla zadania. Przypisanie określa również, kiedy zadanie jest uruchamiane i gdzie są przechowywane raporty wykonywania.

Aby dodać przypisanie, wybierz pozycję Dodaj przypisanie. To krok jest opcjonalny. Nie musisz dodawać przypisania, aby utworzyć zadanie.

W poniższej tabeli opisano pola wyświetlane w okienku Dodawanie przypisania .

wybierz rolę, którą chcesz przypisać do zarządzanej tożsamości systemowej zadania przechowywania. Aby zapewnić pomyślne przypisanie zadania, użyj ról, które mają uprawnienia właściciela danych Blob. Aby dowiedzieć się więcej, sprawdź Role platformy Azure dla zadań przechowywania

Na poniższej ilustracji przedstawiono przykład okienka Dodawanie przypisania .

Karta Tagi

Na karcie Tagi można określić tagi usługi Resource Manager, aby ułatwić organizowanie zasobów platformy Azure. Aby uzyskać więcej informacji, zobacz Tagowanie zasobów, grup zasobów i subskrypcji dla organizacji logicznej.

Na poniższej ilustracji przedstawiono standardową konfigurację właściwości tagu indeksu dla nowego konta magazynu.

Karta Przeglądanie i tworzenie

Po przejściu do karty Przeglądanie i tworzenie platforma Azure uruchamia walidację w wybranych ustawieniach zadania magazynu. Jeśli walidacja zakończy się pomyślnie, możesz przejść do utworzenia zadania magazynu.

Jeśli walidacja nie powiedzie się, portal wskazuje, które ustawienia należy zmodyfikować.

Na poniższej ilustracji przedstawiono dane karty Przegląd przed utworzeniem nowego zadania magazynu.

1. Najpierw zainstaluj niezbędne moduły programu PowerShell. Zobacz Instalowanie modułu programu PowerShell

2. Zdefiniuj warunek przy użyciu formatu JSON. Warunek to zbiór jednego lub więcej zdań warunkowych. Każda klauzula zawiera właściwość, wartość i operator. Aby dowiedzieć się więcej, zobacz Warunki zadań przechowywania.

   $condition = "<condition-json>"
   

3. Zdefiniuj każdą operację za pomocą polecenia New-AzStorageActionTaskOperationObject . Aby dowiedzieć się więcej, zobacz Operacje zadań przechowywania

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

4. Utwórz zadanie zarządzania magazynem, używając polecenia New-AzStorageActionTask, i przekaż wszelkie zdefiniowane warunki oraz operacje. Następujące polecenie tworzy zadanie związane z magazynowaniem i włącza tożsamość zarządzaną przez system. Przypisania zadań magazynu używają uprawnień zastosowanych do tożsamości zarządzanej przez system w celu autoryzowania dostępu.

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

   Jeśli chcesz autoryzować przypisania przy użyciu tożsamości zarządzanej przypisanej przez użytkownika, musisz podać tożsamość jako parametr polecenia New-AzStorageActionTask . Następujące polecenie tworzy zadanie przechowywania i określa tożsamość zarządzaną przypisaną przez użytkownika. Przypisania do zadań związanych z przechowywaniem wykorzystują uprawnienia przypisane do zarządzanej tożsamości utworzonej przez użytkownika w celu autoryzacji dostępu.

   $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
   

   Aby dowiedzieć się, jak utworzyć zadanie związane z magazynowaniem w PowerShell, zobacz także Tworzenie i zarządzanie przypisaniem zadania magazynowania.

1. Zdefiniuj warunek przy użyciu formatu JSON. Warunek to zbiór jednego lub więcej zdań warunkowych. Każda klauzula zawiera właściwość, wartość i operator. Aby dowiedzieć się więcej, zobacz Warunki zadań przechowywania.

   conditionclause="<condition-json>"
   

   Wskazówka

   Interfejs wiersza polecenia platformy Azure używa składni skróconej. Składnia skrócona to uproszczona reprezentacja ciągu JSON. Aby dowiedzieć się więcej, zobacz How to use shorthand syntax with Azure CLI (Jak używać składni skróconej z interfejsem wiersza polecenia platformy Azure).

2. Utwórz zadanie magazynu za pomocą polecenia az storage-actions task create i przekaż wyrażenie w formacie JSON definiującego warunki i operacje. Przykład ten odnajduje obiekty blob w warstwie chłodnej i przenosi je do warstwy gorącej. Wszystkie inne bloby są usuwane. Następujące polecenie tworzy zadanie magazynu i określa systemowo przypisaną tożsamość zarządzaną. Przypisania zadań magazynowania wykorzystują uprawnienia przypisane do tożsamości zarządzanej przez system w celu autoryzacji dostępu.

   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
   

   Jeśli chcesz autoryzować przypisania używając zarządzanej tożsamości przypisanej przez użytkownika, należy podać tę tożsamość jako parametr do polecenia az storage-actions task create. Następujące polecenie tworzy zadanie przechowywania i określa tożsamość zarządzaną przypisaną przez użytkownika. Przypisania do zadań związanych z przechowywaniem wykorzystują uprawnienia przypisane do zarządzanej tożsamości utworzonej przez użytkownika w celu autoryzacji dostępu.

   $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
   

   Aby dowiedzieć się więcej na temat operacji, zobacz Operacje zadań magazynu.

   Aby dowiedzieć się, jak utworzyć przypisanie zadania związanego z magazynem przy użyciu Azure CLI, zobacz Tworzenie przypisania i zarządzanie zadaniem magazynu.

Dołącz fragment kodu podobny do poniższego w szablonie Bicep. W tym przykładzie ustawiono zasady niezmienności w dokumentach programu Word.

Aby zapoznać się z kompletnym przykładem, zobacz Quickstart: Utworzenie zadania magazynowania za pomocą 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
  }
}

Dołącz fragment kodu JSON podobny do poniższego w szablonie usługi Azure Resource Manager. W tym przykładzie ustawiono zasady niezmienności w dokumentach programu Word.

Kompletny przykład można znaleźć w temacie Szybki start: tworzenie zadania przechowywania za pomocą szablonu ARM.

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