ストレージ タスクの割り当てを作成および管理する

割り当てによって、ストレージ アカウントと、タスクが対象とするそのアカウント内のオブジェクトのサブセットが識別されます。 割り当てでは、タスクがいつ実行され、実行レポートが格納されているかも定義されます。

この記事では、割り当てを作成し、その割り当てを実行できるようにします。 ストレージ タスクの割り当ての詳細については、「 ストレージ タスクの割り当て」を参照してください。

重要

ストレージ タスクの割り当てを有効にする前に、各ターゲット ストレージ アカウントのネットワーク設定で、信頼された Azure サービスへのアクセス権を付与してください。 詳細については、「信頼された Azure サービスにアクセスを許可する」を参照してください。

割り当ての作成と管理

ターゲットにするストレージ アカウントごとに割り当てを作成します。 ストレージ タスクには、最大 50 個の割り当てを含めることができます。

注

現在のリリースでは、ストレージ タスクと同じリージョンにあるストレージ アカウントのみを対象にすることができます。

ポータル

ストレージ タスク メニューから割り当てを作成する

ストレージ タスクのコンテキストで割り当てを作成できます。 このオプションは、タスクの作成者であり、複数のストレージ アカウントをターゲットにする場合に便利です。 割り当てごとに、対象とするストレージ アカウントを特定します。

Azure portal でストレージ タスクに移動し、[ ストレージ タスクの管理] で [ 割り当て] を選択します。

[ 割り当て] ページで 、[ + 割り当ての追加 ] を選択すると、[ 割り当ての追加 ] ウィンドウが表示されます。

ストレージ アカウント メニューから割り当てを作成する

ストレージ アカウントのコンテキストで割り当てを作成することもできます。 このオプションは、既存のタスクを使用してストレージ アカウント内のオブジェクトを処理する場合に便利です。 割り当てごとに、アカウントに割り当てるストレージ タスクを特定します。

Azure portal でストレージ アカウントに移動し、[ データ管理] で [ ストレージ タスク] を選択します。

[ ストレージ タスク ] ページで、[ タスクの割り当て ] タブを選択し、[ + 割り当ての作成] を選択し、[ + 割り当ての追加] を選択します。

[ 割り当ての追加] ウィンドウが表示されます。

スコープを選択する

[ スコープの選択 ] セクションで、サブスクリプションを選択し、割り当ての名前を付けます。 次に、ターゲットにするストレージ アカウントを選択します。

ストレージ アカウントのコンテキストで [割り当ての追加 ] ウィンドウを開いた場合は、ストレージ アカウントではなくストレージ タスクを選択します。

各プロパティの説明については、「 割り当ての設定」を参照してください。

ロールの割り当てを追加する

[ ロールの割り当て ] セクションの [ ロール ] ドロップダウン リストで、ストレージ タスクのマネージド ID に割り当てるロールを選択します。 タスクの割り当てを確実に成功させるには、BLOB データ所有者のアクセス許可を持つロールを使用します。 詳細については、 タスクの割り当てに必要な Azure ロールに関するページを参照してください。

注

ストレージ タスクの作成の一環として、マネージド ID の種類 (システム割り当てまたはユーザー割り当て) を選択します。

各プロパティの説明については、「 割り当ての設定」を参照してください。

フィルターを追加する

[ オブジェクトのフィルター] セクションで、フィルターに基づいて BLOB のサブセットを対象にするかどうかを選択します。 フィルターを使用すると、実行範囲を絞り込むのに役立ちます。 タスクでアカウント内のすべてのコンテナーと BLOB を評価する場合は、[ フィルターしない ] オプションを選択できます。 次の例では、フィルターを使用して、 mycontainerという名前のコンテナーに存在する BLOB のみを対象とします。

各プロパティの説明については、「 割り当ての設定」を参照してください。

トリガーを定義する

[ トリガーの詳細 ] セクションで、このタスクを実行する頻度を選択します。 このタスクは 1 回だけ実行することも、タスクを定期的に実行することもできます。 このタスクを定期的に実行する場合は、開始時刻と終了時刻を選択し、各実行の間の日数を指定します。 また、実行レポートを格納する場所を指定することもできます。

各プロパティの説明については、「 割り当ての設定」を参照してください。

割り当てを保存する

[ 追加 ] ボタンを選択して割り当てを作成します。

[ 割り当ての追加] ウィンドウ が閉じます。 デプロイが完了すると、[ 割り当て] ページに割り当てが 表示されます。 そのページに割り当てが表示されない場合は、[ 更新 ] ボタンを選択します。

割り当てを有効にする

割り当ては既定で無効になっています。 実行がスケジュールされるように割り当てを有効にするには、割り当ての横に表示されるチェック ボックスをオンにし、[ 有効] を選択します。

タスクの実行後、実行レポートが生成され、割り当ての作成時に指定したコンテナーに格納されます。 そのレポートの詳細と、対象となるオブジェクトの数、試行された操作の数、成功した操作の数をキャプチャするメトリックを表示する方法については、「 ストレージ タスクの実行の分析」を参照してください。

課題を編集する

割り当ては、対象となるストレージ アカウントのサブ リソースになります。 そのため、割り当てを作成した後は、実行頻度のみを編集できます。 割り当ての他のフィールドは読み取り専用になります。 単一実行 (1 回のみ) オプションも読み取り専用になります。

• ストレージ タスクのコンテキストで割り当ての実行頻度を編集するには、Azure portal でストレージ タスクに移動し、[ ストレージ タスク管理] で [ 割り当て] を選択します。

• ストレージ アカウントのコンテキストで割り当ての実行頻度を編集するには、Azure portal でストレージ アカウントに移動し、[ データ管理] で [ ストレージ タスク] を選択します。

PowerShellの

1. まず、必要な PowerShell モジュールをインストールします。 PowerShell モジュールのインストールを参照してください

2. タスクを実行する頻度を指定します。 タスクを 1 回だけ実行するか、タスクの繰り返し実行を選択できます。 このタスクを定期的に実行する場合は、開始時刻と終了時刻を指定し、各実行の間の日数を指定します。 また、実行レポートを格納する場所を指定することもできます。 次の例では、トリガー値の変数を作成します。

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

3. Get-AzStorageActionTask コマンドを使用して、割り当てに含めるストレージ タスクを取得します。

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

4. New-AzStorageTaskAssignment コマンドを使用して、ストレージ タスクの割り当てを作成します。 次の割り当ては、mycontainer という名前のアカウントのmystorageaccount コンテナーを対象とします。 この割り当てにより、タスクは 1 回だけ実行され、実行レポートは storage-tasks-report という名前のフォルダーに保存されます。 タスクは、現在の時刻から 10 分で実行するようにスケジュールされています。

   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 `
   -TargetExcludePrefix ""
   

5. マネージド ID にロールを割り当てることで、ターゲット ストレージ アカウントに対する操作を実行するアクセス許可をストレージ タスクに付与します。 ストレージ タスクを作成するときに、マネージド ID の種類 (システム割り当てまたはユーザー割り当て) を選択できます。

   次のコマンドは、ストレージ タスクのシステム割り当てマネージド ID に Storage Blob Data Owner のロールを割り当てます。

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

   次のコマンドは、ユーザー割り当てマネージド ID にロール Storage Blob Data Owner を割り当てます。

   $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

Azure CLI を使用して割り当てを作成する

1. タスクを実行する頻度を指定します。 タスクを 1 回だけ実行するか、タスクの繰り返し実行を選択できます。 このタスクを定期的に実行する場合は、開始時刻と終了時刻を指定し、各実行の間の日数を指定します。 また、実行レポートを格納する場所を指定することもできます。 次に、コンテナー名、タスクの実行頻度 (RunOnce)、およびレポートの実行時間を指定する JSON 形式の文字列変数を作成します。

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

   executioncontextvariableで使用される文字列は、短縮構文を使用して表されます。 短縮形構文は、JSON 文字列の簡略化された表現です。 詳細については、 Azure CLI で短縮形構文を使用する方法に関するページを参照してください。

2. az storage-actions task show コマンドを使用し、id プロパティのクエリを実行して、割り当てに含めるストレージ タスクの ID を取得します。

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

3. 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. マネージド ID にロールを割り当てることで、ターゲット ストレージ アカウントに対する操作を実行するアクセス許可をストレージ タスクに付与します。 ストレージ タスクを作成するときに、マネージド ID の種類 (システム割り当てまたはユーザー割り当て) を選択できます。

   次のコマンドは、ストレージ タスクのシステム割り当てマネージド ID に Storage Blob Data Owner のロールを割り当てます。

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

   次のコマンドは、ユーザー割り当てマネージド ID にロール Storage Blob Data Owner を割り当てます。

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

二頭筋

Bicep テンプレートに次のようなスニペットを含めます。

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

テンプレート

Azure Resource Manager テンプレートに次のような JSON スニペットを含めます。

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

こちらも参照ください

• ストレージ タスクの割り当て
• Azure Storage Actions の概要
• ストレージ タスク実行の分析