Microsoft.StorageActions (stable:2023-01-01)

2025/06/25 • 8 updated methods

StorageTasks_PreviewActions (updated)
Description Runs the input conditions against input object metadata properties and designates matched objects in response.
Reference Link ¶

⚶ Changes

{
  "#id": "StorageTasks_PreviewActions",
  "$parameters": [
    {
      "#name": "location",
      "Description": {
        "new": "Represents an Azure geography region where supported resource providers live.",
        "old": "The location to perform preview of the actions."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.StorageActions/locations/{location}/previewActions
{
api-version: string ,
subscriptionId: string ,
location: string ,
parameters:
{
properties:
{
container:
{
name: string ,
metadata:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
blobs:
[
{
name: string ,
properties:
[
{
key: string ,
value: string ,
}
,
]
,
metadata:
[
{
key: string ,
value: string ,
}
,
]
,
tags:
[
{
key: string ,
value: string ,
}
,
]
,
matchedBlock: enum ,
}
,
]
,
action:
{
if:
{
condition: string ,
}
,
elseBlockExists: boolean ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
container:
{
name: string ,
metadata:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
blobs:
[
{
name: string ,
properties:
[
{
key: string ,
value: string ,
}
,
]
,
metadata:
[
{
key: string ,
value: string ,
}
,
]
,
tags:
[
{
key: string ,
value: string ,
}
,
]
,
matchedBlock: enum ,
}
,
]
,
action:
{
if:
{
condition: string ,
}
,
elseBlockExists: boolean ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
StorageTasks_ListBySubscription (updated)
Description Lists all the storage tasks available under the subscription.
Reference Link ¶

⚶ Changes

{
  "#id": "StorageTasks_ListBySubscription",
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "value",
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "Request URL that can be used to query next page of storage tasks. Returned when total number of requested storage tasks exceed maximum page size."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.StorageActions/storageTasks
{
api-version: string ,
subscriptionId: string ,
}

⚐ Response (200)

{
value:
[
{
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
properties:
{
taskVersion: integer ,
enabled: boolean ,
description: string ,
action:
{
if:
{
condition: string ,
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
else:
{
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
}
,
provisioningState: enum ,
creationTimeInUtc: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
StorageTasks_ListByResourceGroup (updated)
Description Lists all the storage tasks available under the given resource group.
Reference Link ¶

⚶ Changes

{
  "#id": "StorageTasks_ListByResourceGroup",
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "value",
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "Request URL that can be used to query next page of storage tasks. Returned when total number of requested storage tasks exceed maximum page size."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
}

⚐ Response (200)

{
value:
[
{
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
properties:
{
taskVersion: integer ,
enabled: boolean ,
description: string ,
action:
{
if:
{
condition: string ,
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
else:
{
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
}
,
provisioningState: enum ,
creationTimeInUtc: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
StorageTasks_Create (updated)
Description Asynchronously creates a new storage task resource with the specified parameters. If a storage task is already created and a subsequent create request is issued with different properties, the storage task properties will be updated. If a storage task is already created and a subsequent create or update request is issued with the exact same set of properties, the request will succeed.
Reference Link ¶

⚶ Changes

{
  "#id": "StorageTasks_Create",
  "$responses": {
    "202": [
      {
        "@added_fae92310e681456c8262eb6058b51a73": {
          "#name": "retry-after",
          "Description": "The Retry-After header can indicate how long the client should wait before polling the operation status.",
          "Type": "integer"
        }
      }
    ]
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
storageTaskName: string ,
parameters:
{
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
properties:
{
taskVersion: integer ,
enabled: boolean ,
description: string ,
action:
{
if:
{
condition: string ,
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
else:
{
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
}
,
provisioningState: enum ,
creationTimeInUtc: string ,
}
,
}
,
}

⚐ Response (200)

{
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
properties:
{
taskVersion: integer ,
enabled: boolean ,
description: string ,
action:
{
if:
{
condition: string ,
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
else:
{
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
}
,
provisioningState: enum ,
creationTimeInUtc: string ,
}
,
}

⚐ Response (201)

{
$headers:
{
location: string ,
retry-after: integer ,
}
,
$schema:
{
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
properties:
{
taskVersion: integer ,
enabled: boolean ,
description: string ,
action:
{
if:
{
condition: string ,
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
else:
{
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
}
,
provisioningState: enum ,
creationTimeInUtc: string ,
}
,
}
,
}

⚐ Response (202)

{
location: string ,
retry-after: integer ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
StorageTasks_Update (updated)
Description Update storage task properties
Reference Link ¶

⚶ Changes

{
  "#id": "StorageTasks_Update",
  "$responses": {
    "202": [
      {
        "@added_e63227e126574e339141d51ec0c26ece": {
          "#name": "azure-asyncoperation",
          "Description": "A link to the status monitor",
          "Type": "string"
        }
      },
      {
        "@added_4d82ce65381f449fb24c8f834fb03228": {
          "#name": "retry-after",
          "Description": "The Retry-After header can indicate how long the client should wait before polling the operation status.",
          "Type": "integer"
        }
      }
    ]
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
storageTaskName: string ,
parameters:
{
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
tags: object ,
properties:
{
taskVersion: integer ,
enabled: boolean ,
description: string ,
action:
{
if:
{
condition: string ,
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
else:
{
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
}
,
provisioningState: enum ,
creationTimeInUtc: string ,
}
,
}
,
}

⚐ Response (200)

{
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
properties:
{
taskVersion: integer ,
enabled: boolean ,
description: string ,
action:
{
if:
{
condition: string ,
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
else:
{
operations:
[
{
name: enum ,
parameters: object ,
onSuccess: enum ,
onFailure: enum ,
}
,
]
,
}
,
}
,
provisioningState: enum ,
creationTimeInUtc: string ,
}
,
}

⚐ Response (202)

{
azure-asyncoperation: string ,
location: string ,
retry-after: integer ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
StorageTasks_Delete (updated)
Description Delete the storage task resource.
Reference Link ¶

⚶ Changes

{
  "#id": "StorageTasks_Delete",
  "$responses": {
    "202": [
      {
        "@added_124e87b5c3634690958a4a5001dba2a3": {
          "#name": "azure-asyncoperation",
          "Description": "A link to the status monitor",
          "Type": "string"
        }
      },
      {
        "@added_6f94d994c1fd49479ebc31f8dbb37b23": {
          "#name": "retry-after",
          "Description": "The Retry-After header can indicate how long the client should wait before polling the operation status.",
          "Type": "integer"
        }
      }
    ]
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
storageTaskName: string ,
}

⚐ Response (202)

{
azure-asyncoperation: string ,
location: string ,
retry-after: integer ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
StorageTasksReport_List (updated)
Description Fetch the storage tasks run report summary for each assignment.
Reference Link ¶

⚶ Changes

{
  "#id": "StorageTasksReport_List",
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "value",
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "summaryReportPath",
                  "Description": {
                    "new": "Full path to the verbose report stored in the reporting container as specified in the assignment execution context for the storage account.",
                    "old": "Full path to the verbose report stored in the reporting container as specified in the assignment execution context for the storage account. "
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "Request URL that can be used to query next page of storage task run results summary. Returned when the number of run instances and summary reports exceed maximum page size."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}/reports
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
storageTaskName: string ,
$maxpagesize: integer ,
$filter: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
taskAssignmentId: string ,
storageAccountId: string ,
startTime: string ,
finishTime: string ,
objectsTargetedCount: string ,
objectsOperatedOnCount: string ,
objectFailedCount: string ,
objectsSucceededCount: string ,
runStatusError: string ,
runStatusEnum: enum ,
summaryReportPath: string ,
taskId: string ,
taskVersion: string ,
runResult: enum ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
StorageTaskAssignment_List (updated)
Description Lists Resource IDs of the Storage Task Assignments associated with this Storage Task.
Reference Link ¶

⚶ Changes

{
  "#id": "StorageTaskAssignment_List",
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "value",
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "Request URL that can be used to query next page of Resource IDs. Returned when total number of requested Resource IDs exceed maximum page size."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}/storageTaskAssignments
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
storageTaskName: string ,
$maxpagesize: integer ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}