스토리지 작업 할당 만들기 및 관리

할당은 스토리지 계정과 해당 계정에서 작업이 대상으로 지정하는 개체의 하위 집합을 식별합니다. 또한 할당은 태스크가 실행되는 시기와 실행 보고서가 저장되는 위치를 정의합니다.

이 문서에서는 과제를 만든 다음 해당 할당을 실행하도록 설정하는 데 도움이 됩니다. 스토리지 작업 할당에 대한 자세한 내용은 Storage 작업 할당을 참조하세요.

중요합니다

스토리지 작업 할당을 사용하도록 설정하기 전에 각 대상 스토리지 계정의 네트워크 설정에서 신뢰할 수 있는 Azure 서비스에 대한 액세스 권한을 부여해야 합니다. 더 자세히 알아보려면 신뢰할 수 있는 Azure 서비스에 액세스 권한 부여를 참조하세요.

할당 만들기 및 관리

대상으로 지정할 각 스토리지 계정에 대한 할당을 만듭니다. 스토리지 작업에는 최대 50개의 할당이 포함될 수 있습니다.

비고

현재 릴리스에서는 스토리지 작업과 동일한 지역에 있는 스토리지 계정만 대상으로 지정할 수 있습니다.

포털

스토리지 작업 메뉴에서 할당 만들기

스토리지 작업의 컨텍스트에서 할당을 만들 수 있습니다. 이 옵션은 작업 작성자이며 여러 스토리지 계정을 대상으로 지정하려는 경우에 편리할 수 있습니다. 각 할당에 대해 대상으로 지정할 스토리지 계정을 식별합니다.

Azure Portal에서 스토리지 작업으로 이동한 다음 , 스토리지 작업 관리에서 할당을 선택합니다.

할당 페이지에서 + 할당 추가를 선택하면 할당 추가 창이 나타납니다.

스토리지 계정 메뉴에서 할당 만들기

스토리지 계정의 컨텍스트에서 할당을 만들 수도 있습니다. 이 옵션은 기존 작업을 사용하여 스토리지 계정의 개체를 처리하려는 경우에 편리할 수 있습니다. 각 할당에 대해 계정에 할당하려는 스토리지 작업을 식별합니다.

Azure Portal에서 스토리지 계정으로 이동한 다음 , 데이터 관리에서 스토리지 작업을 선택합니다.

스토리지 작업 페이지에서 작업 할당 탭을 선택하고 + 할당 만들기를 선택한 다음 + 할당 추가를 선택합니다.

할당 추가 창이 나타납니다.

범위 선택

범위 선택 섹션에서 구독을 선택하고 할당 이름을 지정합니다. 그런 다음 대상으로 지정할 스토리지 계정을 선택합니다.

스토리지 계정의 컨텍스트에서 할당 추가 창을 연 경우 스토리지 계정 대신 스토리지 작업을 선택합니다.

각 속성에 대한 설명은 할당 설정을 참조하세요.

역할 할당 추가

역할 할당 섹션의 역할 드롭다운 목록에서 스토리지 작업의 관리 ID에 할당할 역할을 선택합니다. 성공적인 작업 할당을 보장하려면 Blob 데이터 소유자 권한이 있는 역할을 사용합니다. 자세한 내용은 작업을 할당하는 데 필요한 Azure 역할을 참조하세요.

비고

스토리지 작업을 만드는 과정의 일부로 관리 ID 유형(시스템 할당 또는 사용자 할당)을 선택합니다.

각 속성에 대한 설명은 할당 설정을 참조하세요.

필터 추가

필터 개체 섹션에서 필터를 기반으로 Blob의 하위 집합을 대상으로 지정할지 여부를 선택합니다. 필터를 사용하면 실행 범위를 좁힐 수 있습니다. 태스크가 계정의 모든 컨테이너 및 Blob을 평가하도록 하려면 필터링 안 함 옵션을 선택할 수 있습니다. 다음 예제에서는 필터를 사용하여 이름이 지정된 mycontainer컨테이너에 있는 Blob만 대상으로 지정합니다.

각 속성에 대한 설명은 할당 설정을 참조하세요.

트리거 정의

트리거 세부 정보 섹션에서 이 작업을 실행할 빈도를 선택합니다. 이 작업을 한 번만 실행하거나 작업을 반복 실행하도록 선택할 수 있습니다. 이 작업을 반복적으로 실행하려는 경우 시작 및 종료 시간을 선택하고 각 실행 사이의 일 수를 지정합니다. 실행 보고서를 저장할 위치를 지정할 수도 있습니다.

각 속성에 대한 설명은 할당 설정을 참조하세요.

할당 저장

추가 단추를 선택하여 할당을 만듭니다.

할당 추가 창이 닫힙니다. 배포가 완료되면 할당이 할당 페이지에 나타납니다. 해당 페이지에 할당이 표시되지 않으면 새로 고침 단추를 선택합니다.

할당 활성화

할당은 기본적으로 사용하지 않도록 설정됩니다. 할당이 실행되도록 설정하려면 할당 옆에 표시되는 확인란을 선택한 다음 사용을 선택합니다.

작업이 실행되면 실행 보고서가 생성되고 할당을 만들 때 지정한 컨테이너에 저장됩니다. 해당 보고서에 대한 자세한 내용과 대상 개체 수, 시도된 작업 수 및 성공한 작업 수를 캡처하는 메트릭을 보는 방법은 스토리지 작업 실행 분석을 참조하세요.

과제 편집

할당은 대상 스토리지 계정의 하위 리소스가 됩니다. 따라서 할당을 만든 후에는 실행 빈도만 편집할 수 있습니다. 과제의 다른 필드는 읽기 전용이 됩니다. 단일 실행(한 번만) 옵션도 읽기 전용이 됩니다.

• 스토리지 작업의 컨텍스트에서 할당의 실행 빈도를 편집하려면 Azure Portal의 스토리지 작업으로 이동한 다음 Storage 작업 관리에서 할당을 선택합니다.

• 스토리지 계정 컨텍스트에서 할당의 실행 빈도를 편집하려면 Azure Portal의 스토리지 계정으로 이동한 다음 , 데이터 관리에서 스토리지 작업을 선택합니다.

PowerShell을 참조하십시오.

1. 먼저 필요한 PowerShell 모듈을 설치합니다. PowerShell 모듈 설치를 참조하세요.

2. 작업을 실행할 빈도를 지정합니다. 작업을 한 번만 실행하거나 작업을 반복 실행하도록 선택할 수 있습니다. 이 작업을 반복적으로 실행하려는 경우 시작 및 종료 시간을 지정하고 각 실행 사이의 일 수를 지정합니다. 실행 보고서를 저장할 위치를 지정할 수도 있습니다. 다음 예제에서는 트리거 값에 대한 변수를 만듭니다.

   $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 합니다. 이 할당은 태스크가 한 번만 실행되도록 지정하고 실행 보고서를 명명 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. 작업을 실행할 빈도를 지정합니다. 작업을 한 번만 실행하거나 작업을 반복 실행하도록 선택할 수 있습니다. 이 작업을 반복적으로 실행하려는 경우 시작 및 종료 시간을 지정하고 각 실행 사이의 일 수를 지정합니다. 실행 보고서를 저장할 위치를 지정할 수도 있습니다. 다음은 컨테이너 이름, 작업 실행 빈도(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

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 작업 개요
• 스토리지 태스크 실행 분석