Partager via


Storage Accounts - Restore Blob Ranges

Restore blobs in the specified blob ranges

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/restoreBlobRanges?api-version=2023-05-01

URI Parameters

Name In Required Type Description
accountName
path True

string

The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.

Regex pattern: ^[a-z0-9]+$

resourceGroupName
path True

string

The name of the resource group within the user's subscription. The name is case insensitive.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

The ID of the target subscription.

api-version
query True

string

The API version to use for this operation.

Request Body

Name Required Type Description
blobRanges True

BlobRestoreRange[]

Blob ranges to restore.

timeToRestore True

string

Restore blob to the specified time.

Responses

Name Type Description
200 OK

BlobRestoreStatus

OK -- returned when blob ranges are restored completely with the same properties specified in the request body.

202 Accepted

BlobRestoreStatus

Accepted -- Blob restore request accepted; operation will complete asynchronously.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

BlobRangesRestore

Sample request

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.Storage/storageAccounts/sto4445/restoreBlobRanges?api-version=2023-05-01

{
  "timeToRestore": "2019-04-20T15:30:00.0000000Z",
  "blobRanges": [
    {
      "startRange": "container/blobpath1",
      "endRange": "container/blobpath2"
    },
    {
      "startRange": "container2/blobpath3",
      "endRange": ""
    }
  ]
}

Sample response

{
  "status": "Succeeded",
  "restoreId": "{restore_id}",
  "parameters": {
    "timeToRestore": "2019-04-20T15:30:00.0000000Z",
    "blobRanges": [
      {
        "startRange": "container/blobpath1",
        "endRange": "container/blobpath2"
      },
      {
        "startRange": "container2/blobpath3",
        "endRange": ""
      }
    ]
  }
}
location: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.Storage/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-09-01
{
  "status": "InProgress",
  "restoreId": "{restore_id}",
  "parameters": {
    "timeToRestore": "2019-04-20T15:30:00.0000000Z",
    "blobRanges": [
      {
        "startRange": "container/blobpath1",
        "endRange": "container/blobpath2"
      },
      {
        "startRange": "container2/blobpath3",
        "endRange": ""
      }
    ]
  }
}

Definitions

Name Description
BlobRestoreParameters

Blob restore parameters

BlobRestoreProgressStatus

The status of blob restore progress. Possible values are: - InProgress: Indicates that blob restore is ongoing. - Complete: Indicates that blob restore has been completed successfully. - Failed: Indicates that blob restore is failed.

BlobRestoreRange

Blob range

BlobRestoreStatus

Blob restore status.

BlobRestoreParameters

Blob restore parameters

Name Type Description
blobRanges

BlobRestoreRange[]

Blob ranges to restore.

timeToRestore

string

Restore blob to the specified time.

BlobRestoreProgressStatus

The status of blob restore progress. Possible values are: - InProgress: Indicates that blob restore is ongoing. - Complete: Indicates that blob restore has been completed successfully. - Failed: Indicates that blob restore is failed.

Name Type Description
Complete

string

Failed

string

InProgress

string

BlobRestoreRange

Blob range

Name Type Description
endRange

string

Blob end range. This is exclusive. Empty means account end.

startRange

string

Blob start range. This is inclusive. Empty means account start.

BlobRestoreStatus

Blob restore status.

Name Type Description
failureReason

string

Failure reason when blob restore is failed.

parameters

BlobRestoreParameters

Blob restore request parameters.

restoreId

string

Id for tracking blob restore request.

status

BlobRestoreProgressStatus

The status of blob restore progress. Possible values are: - InProgress: Indicates that blob restore is ongoing. - Complete: Indicates that blob restore has been completed successfully. - Failed: Indicates that blob restore is failed.