Vytvoření a správa přiřazení úlohy úložiště

Přiřazení identifikuje účet úložiště a podmnožinu objektů v daném účtu, na které bude úkol cílit. Zadání také určuje, kdy se úloha spustí a kde se ukládají zprávy o spuštění.

Tento článek vám pomůže vytvořit přiřazení a pak toto přiřazení povolit ke spuštění. Další informace o přiřazení úloh úložiště najdete v tématu Přiřazení úkolů úložiště.

Důležité

Než povolíte přiřazení úlohy úložiště, ujistěte se, že v nastavení sítě každého cílového účtu úložiště udělíte přístup důvěryhodným službám Azure. Další informace najdete v tématu Udělení přístupu k důvěryhodným službám Azure.

Vytvoření a správa úkolu

Vytvořte přiřazení pro každý účet úložiště, který chcete cílit. Úloha úložiště může obsahovat až 50 přiřazení.

Poznámka:

V aktuální verzi můžete cílit pouze na účty úložiště, které jsou ve stejné oblasti jako úlohy úložiště.

Portál

Vytvoření zadání z nabídky úloh úložiště

Přiřazení můžete vytvořit v kontextu úlohy v úložišti. Tato možnost může být praktická, pokud jste autorem úkolu a chcete cílit na více účtů úložiště. U každého přiřazení identifikujete účet úložiště, na který chcete cílit.

Na webu Azure Portal přejděte k úloze úložiště a pak v části Správa úloh úložiště vyberte Přiřazení.

Na stránce Zadání vyberte + Přidat zadání a zobrazí se podokno Přidat zadání .

Vytvořte přiřazení z nabídky účtu úložiště

Přiřazení můžete vytvořit také v kontextu účtu úložiště. Tato možnost může být praktická, pokud chcete použít existující úlohu ke zpracování objektů v účtu úložiště. U každého přiřazení identifikujete úlohu úložiště, kterou chcete přiřadit ke svému účtu.

Na webu Azure Portal přejděte k účtu úložiště a pak v části Správa dat vyberte Úlohy úložiště.

Na stránce Úkoly úložiště klikněte na záložku Přiřazení úkolu, klikněte na + Vytvořit přiřazení a pak klikněte na + Přidat přiřazení.

Zobrazí se podokno Přidat přiřazení .

Výběr oboru

V části Vybrat obor vyberte předplatné a pojmenujte přiřazení. Pak vyberte účet úložiště, na který chcete cílit.

Pokud jste otevřeli podokno Přidat přiřazení v kontextu účtu úložiště, vyberete místo účtu úložiště úlohu úložiště.

Popis jednotlivých vlastností naleznete v tématu Nastavení přiřazení.

Přidat přiřazení role

V části Přiřazení role vyberte v rozevíracím seznamu Role roli, kterou chcete přiřadit spravované identitě úlohy úložiště. Pokud chcete zajistit úspěšné přiřazení úkolu, použijte role s oprávněními vlastníka dat objektu blob. Další informace najdete v rolích Azure potřebných k přiřazování úkolů.

Poznámka:

Jako součást vytváření úlohy úložiště zvolíte typ spravované identity (přiřazený systémem nebo přiřazený uživatelem).

Popis jednotlivých vlastností naleznete v tématu Nastavení přiřazení.

Přidání filtru

V části Filtrovat objekty zvolte, jestli chcete cílit na podmnožinu objektů blob na základě filtru. Filtry pomáhají zúžit rozsah provádění. Pokud chcete, aby úloha vyhodnocovala všechny kontejnery a objekty blob v účtu, můžete vybrat možnost Nefiltrovat . Následující příklad používá filtr k cílení pouze objektů blob, které existují v kontejneru s názvem mycontainer.

Popis jednotlivých vlastností naleznete v tématu Nastavení přiřazení.

Definování triggeru

V části Podrobnosti o triggeru vyberte, jak chcete tuto úlohu spustit. Můžete si vybrat z následujících typů spuštění:

• Spustit jednou: Spusťte úlohu jednou.
• Opakované spouštění: Spouštějte úlohu podle opakovaného plánu. Zvolte počáteční a koncový čas a zadejte počet dní mezi každým spuštěním.
• Napodobení spuštění: Simulujte provádění úlohy bez provádění operací s objekty blob. Zkušební spuštění prohledá a vyhodnotí objekty blob podle podmínek úlohy a vytvoří podrobnou sestavu, která ukazuje, které objekty blob splnily podmínky a jaké operace by byly provedeny. Žádná data se nezmění. Další informace najdete v tématu Vytvoření a použití ukázkového spuštění.

Pro všechny typy běhů zadejte, kam chcete ukládat zprávy o spuštění.

Popis jednotlivých vlastností naleznete v tématu Nastavení přiřazení.

Uložit zadání

Výběrem tlačítka Přidat vytvořte zadání.

Podokno Přidat přiřazení se zavře. Po dokončení nasazení se přiřazení zobrazí na stránce Přiřazení . Pokud se zadání na této stránce nezobrazuje, vyberte tlačítko Aktualizovat .

Povolit přiřazení

Přiřazení je ve výchozím nastavení deaktivováno. Pokud chcete přiřazení povolit tak, aby bylo naplánováno jeho spuštění, zaškrtněte políčko, které se zobrazí vedle přiřazení, a pak vyberte Povolit.

Po spuštění úkolu se vygeneruje výkonná zpráva a uloží se do kontejneru, který jste zadali při vytváření přiřazení. Další informace o této sestavě a také informace o tom, jak zobrazit metriky zachycující počet cílových objektů, počet pokusů o operace a počet úspěšných operací, najdete v tématu Analýza spuštění úlohy úložiště.

Úprava zadání

Přiřazení se stane podřazeným prostředkem cílového účtu úložiště. Proto po vytvoření přiřazení můžete upravit pouze četnost spuštění. Ostatní pole přiřazení se stanou pouze pro čtení. Možnost Jednorázové spuštění se stává pouze pro čtení.

• Pokud chcete upravit frekvenci spuštění přiřazení v kontextu úloh úložiště, přejděte v portálu Azure k úloze úložiště a pak v části Správa úloh úložiště vyberte Přiřazení.

• Pokud chcete upravit frekvenci spuštění přiřazení v kontextu účtu úložiště, přejděte na web Azure Portal na účet úložiště a pak v části Správa dat vyberte Úlohy úložiště.

PowerShell

1. Nejprve nainstalujte potřebné moduly PowerShellu. Viz Instalace modulu PowerShellu

2. Určete, jak často se má úloha spouštět. Můžete se rozhodnout spustit úlohu jenom jednou nebo spustit úlohu opakovanou. Pokud se rozhodnete tuto úlohu spouštět opakovaně, zadejte počáteční a koncový čas a zadejte počet dní mezi každým spuštěním. Můžete také určit, kam chcete ukládat výsledky spouštění. Následující příklad vytvoří proměnnou pro hodnoty triggeru.

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

3. Pomocí příkazu Get-AzStorageActionTask získejte úlohu úložiště, kterou chcete zahrnout do přiřazení.

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

4. Vytvořte přiřazení úlohy úložiště pomocí příkazu New-AzStorageTaskAssignment. Následující přiřazení cílí na mycontainer kontejner účtu s názvem mystorageaccount. Tato úloha určuje, že úkol bude spuštěn pouze jednou a uloží zprávy o provedení do složky s názvem storage-tasks-report. Úloha je naplánovaná tak, aby začala za 10 minut od aktuálního času.

   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. Dejte úloze úložiště oprávnění k provádění operací s cílovým účtem úložiště přiřazením role spravované identitě. Při vytváření úlohy úložiště můžete zvolit typ spravované identity (přiřazený systémem nebo přiřazený uživatelem).

   Následující příkazy přiřadí roli Storage Blob Data Owner spravované identitě přidělené systémem pro úlohu úložiště.

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

   Následující příkazy přiřadí roli Storage Blob Data Owner spravované identitě přiřazené uživatelem.

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

Azure CLI

Vytvoření přiřazení pomocí Azure CLI

1. Určete, jak často se má úloha spouštět. Můžete se rozhodnout spustit úlohu jenom jednou nebo spustit úlohu opakovanou. Pokud se rozhodnete tuto úlohu spouštět opakovaně, zadejte počáteční a koncový čas a zadejte počet dní mezi každým spuštěním. Můžete také určit, kam chcete ukládat výsledky spouštění. Následující kód vytvoří proměnnou řetězce ve formátu JSON, která určuje název kontejneru, frekvenci spuštění úlohy (RunOnce) a čas spuštění sestavy.

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

   Řetězec použitý v prvku executioncontextvariable je vyjádřen pomocí zkratkové syntaxe. Zkrácená syntaxe je zjednodušená reprezentace řetězce JSON. Další informace najdete v tématu Použití zkratkové syntaxe pomocí Azure CLI.

2. Získejte ID úlohy úložiště, kterou chcete zahrnout do přiřazení, pomocí příkazu az storage-actions task show a následného dotazování na id vlastnost.

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

3. Vytvořte přiřazení úlohy úložiště pomocí příkazu 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. Dejte úloze úložiště oprávnění k provádění operací s cílovým účtem úložiště přiřazením role spravované identitě. Při vytváření úlohy úložiště můžete zvolit typ spravované identity (přiřazený systémem nebo přiřazený uživatelem).

   Následující příkazy přiřadí roli Storage Blob Data Owner spravované identitě přidělené systémem pro úlohu úložiště.

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

   Následující příkazy přiřadí roli Storage Blob Data Owner spravované identitě přiřazené uživatelem.

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

Biceps

Do šablony Bicep vložte fragment kódu podobný následujícímu.

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

Šablona

Do šablony Azure Resource Manageru vložte fragment kódu JSON podobný následujícímu kódu.

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

Viz také

• Přiřazení úkolů pro úložiště
• Přehled akcí služby Azure Storage
• Analýza běhů úložných úloh