ストレージ タスクを作成する

Azure portal で、"ストレージ タスク" を検索します。 次に、[サービス] で、[ストレージ タスク - Azure Storage Actions] を選びます。

[Azure Storage Actions | ストレージ タスク] ページで、[作成] を選びます。

[基本] タブ

[基本] タブでは、ストレージ タスクに関する必須の情報を入力します。 次の表では [基本] タブのフィールドについて説明します。

次の画像は [基本] タブの例を示しています。

[条件] タブ

[条件] タブでは、オブジェクト (コンテナーまたは BLOB) ごとに満たす必要がある条件と、そのオブジェクトに対して実行する操作を定義します。

少なくとも 1 つの条件と 1 つの操作を定義する必要があります。 条件に句を追加するには、[新しい句の追加] を選択します。 操作を追加するには、[新しい操作の追加] を選択します。

[条件] タブの各フィールドを次の表で説明します。

次の画像は [条件] タブの例を示しています。

[プレビュー条件] を選択すると、定義した条件の影響を受ける BLOB の一覧を表示できます。 詳細については、「 条件の効果をプレビューする」を参照してください。

[割り当て] タブ

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

割り当てを追加するには、[割り当ての追加] を選択します。 このステップはオプションです。 タスクを作成するために割り当てを追加する必要はありません。

[割り当ての追加] ペインに表示される各フィールドを、次の表で説明します。

ストレージ タスクのシステム割り当てマネージド ID に割り当てるロールを選択します。 タスクの割り当てを確実に成功させるには、BLOB データ所有者のアクセス許可を持つロールを使用します。 詳細については、ストレージ タスクの Azure ロールに関するページを参照してください

次の画像は、[割り当ての追加] ペインの例を示しています。

[タグ] タブ

[タグ] タブでは、Azure リソースを整理するための Resource Manager タグを指定できます。 詳細については、「論理的な組織化のためにリソース、リソース グループ、サブスクリプションにタグを付ける」を参照してください。

次の図は、新しいストレージ アカウントのインデックス タグ プロパティの標準構成を示しています。

[確認と作成] タブ

[確認および作成] タブに移動すると、選択したストレージ タスクの設定の検証が Azure によって実行されます。 検証に成功した場合は、ストレージ タスクの作成に進むことができます。

検証が失敗した場合は、変更する必要がある設定がポータルに示されます。

次の画像は、新しいストレージ タスクを作成する前の [確認] タブのデータを示しています。

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

2. JSON を使用して 条件 を定義します。 条件とは、1つ以上の節の集合です。 各句には、"プロパティ"、"値"、および "演算子" が含まれています。 詳細については、「 ストレージ タスクの条件」を参照してください。

   $condition = "<condition-json>"
   

3. New-AzStorageActionTaskOperationObject コマンドを使用して、各操作を定義します。 詳細については、「ストレージ タスクの操作」を参照してください。

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

4. New-AzStorageActionTask コマンドを使用してストレージ タスクを作成し、定義した条件と操作を渡します。 次のコマンドは、ストレージ タスクを作成し、タスクのシステム マネージド ID を有効にします。 ストレージ タスクの割り当てでは、そのシステムマネージド ID に適用されたアクセス許可を使用してアクセスを承認します。

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

   ユーザー割り当てマネージド ID を使用して割り当てを承認する場合は、その ID を パラメーターとして New-AzStorageActionTask コマンドに指定する必要があります。 次のコマンドは、ストレージ タスクを作成し、ユーザー割り当てマネージド ID を指定します。 ストレージ タスクの割り当てでは、ユーザー割り当てマネージド ID に適用されたアクセス許可を使用してアクセスを承認します。

   $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
   

   PowerShell を使用して割り当てを作成する方法については、「 ストレージ タスクの割り当ての作成と管理」を参照してください。

1. JSON を使用して 条件 を定義します。 条件とは、1つ以上の節の集合です。 各句には、"プロパティ"、"値"、および "演算子" が含まれています。 詳細については、「 ストレージ タスクの条件」を参照してください。

   conditionclause="<condition-json>"
   

   ヒント

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

2. az storage-actions task create コマンドを使用してストレージ タスクを作成し、条件と操作の JSON 形式の式を渡します。 この例では、クール層で BLOB を検索し、ホット層に移動します。 他のすべての BLOB が削除されます。 次のコマンドは、ストレージ タスクを作成し、システム割り当てマネージド ID を指定します。 ストレージ タスクの割り当てでは、システム割り当てマネージド ID に適用されたアクセス許可を使用してアクセスを承認します。

   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
   

   ユーザー割り当てマネージド ID を使用して割り当てを承認する場合は、その ID を az storage-actions task create コマンドのパラメーターとして指定する必要があります。 次のコマンドは、ストレージ タスクを作成し、ユーザー割り当てマネージド ID を指定します。 ストレージ タスクの割り当てでは、ユーザー割り当てマネージド ID に適用されたアクセス許可を使用してアクセスを承認します。

   $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
   

   操作の詳細については、「 ストレージ タスクの操作」を参照してください。

   Azure CLI を使用して割り当てを作成する方法については、「 ストレージ タスクの割り当ての作成と管理」を参照してください。

Bicep テンプレートに次のようなスニペットを含めます。 次の使用例は、単語文書に不変ポリシーを設定します。

完全な例については、「 クイック スタート: 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
  }
}

Azure Resource Manager テンプレートに次のような JSON スニペットを含めます。 次の使用例は、単語文書に不変ポリシーを設定します。

完全な例については、「 クイック スタート: 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
      }
    }
  ]