Restorable Database Accounts - List By Location

Reference

Service:: Cosmos DB Resource Provider

API Version:: 2024-11-15

Lists all the restorable Azure Cosmos DB database accounts available under the subscription and in a region. This call requires 'Microsoft.DocumentDB/locations/restorableDatabaseAccounts/read' permission.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts?api-version=2024-11-15

URI Parameters

Name	In	Required	Type	Description
location	path	True	string	Cosmos DB region, with spaces between words and each word capitalized.
subscriptionId	path	True	string	The ID of the target subscription.
api-version	query	True	string	The API version to use for this operation.

Responses

Name	Type	Description
200 OK	RestorableDatabaseAccountsListResult	The operation completed successfully.
Other Status Codes	CloudError	Error response describing why the operation failed.

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

CosmosDBRestorableDatabaseAccountList

Sample request

HTTP

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts?api-version=2024-11-15

Sample response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d",
      "name": "d9b26648-2f53-4541-b3d8-3044f4f9810d",
      "location": "West US",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts",
      "properties": {
        "accountName": "ddb1",
        "creationTime": "2020-04-11T21:56:15Z",
        "deletionTime": "2021-03-12T22:05:09Z",
        "oldestRestorableTime": "2021-03-12T22:05:09Z",
        "apiType": "Sql",
        "restorableLocations": [
          {
            "locationName": "South Central US",
            "regionalDatabaseAccountInstanceId": "d7a01f78-606f-45c6-9dac-0df32f433bb5",
            "creationTime": "2020-10-30T21:13:10Z",
            "deletionTime": "2020-10-30T21:13:35Z"
          },
          {
            "locationName": "West US",
            "regionalDatabaseAccountInstanceId": "fdb43d84-1572-4697-b6e7-2bcda0c51b2c",
            "creationTime": "2020-10-30T21:13:10Z"
          }
        ]
      }
    },
    {
      "id": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/4f9e6ace-ac7a-446c-98bc-194c502a06b4",
      "name": "4f9e6ace-ac7a-446c-98bc-194c502a06b4",
      "location": "West US",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts",
      "properties": {
        "accountName": "ddb2",
        "creationTime": "2020-05-01T08:05:18Z",
        "oldestRestorableTime": "2020-05-01T08:05:18Z",
        "apiType": "Sql",
        "restorableLocations": [
          {
            "locationName": "South Central US",
            "regionalDatabaseAccountInstanceId": "d7a01f78-606f-45c6-9dac-0df32f433bb5",
            "creationTime": "2020-10-30T21:13:10Z",
            "deletionTime": "2020-10-30T21:13:35Z"
          },
          {
            "locationName": "West US",
            "regionalDatabaseAccountInstanceId": "fdb43d84-1572-4697-b6e7-2bcda0c51b2c",
            "creationTime": "2020-10-30T21:13:10Z"
          }
        ]
      }
    }
  ]
}

Definitions

Name	Description
ApiType	Enum to indicate the API type of the restorable database account.
CloudError	An error response from the service.
ErrorResponse	Error Response.
RestorableDatabaseAccountGetResult	A Azure Cosmos DB restorable database account.
RestorableDatabaseAccountsListResult	The List operation response, that contains the restorable database accounts and their properties.
RestorableLocationResource	Properties of the regional restorable account.

ApiType

Enum to indicate the API type of the restorable database account.

Name	Type	Description
Cassandra	string
Gremlin	string
GremlinV2	string
MongoDB	string
Sql	string
Table	string

CloudError

An error response from the service.

Name	Type	Description
error	ErrorResponse	Error Response.

ErrorResponse

Error Response.

Name	Type	Description
code	string	Error code.
message	string	Error message indicating why the operation failed.

RestorableDatabaseAccountGetResult

A Azure Cosmos DB restorable database account.

Name	Type	Description
id	string	The unique resource identifier of the ARM resource.
location	string	The location of the resource group to which the resource belongs.
name	string	The name of the ARM resource.
properties.accountName	string	The name of the global database account
properties.apiType	ApiType	The API type of the restorable database account.
properties.creationTime	string	The creation time of the restorable database account (ISO-8601 format).
properties.deletionTime	string	The time at which the restorable database account has been deleted (ISO-8601 format).
properties.oldestRestorableTime	string	The least recent time at which the database account can be restored to (ISO-8601 format).
properties.restorableLocations	RestorableLocationResource[]	List of regions where the of the database account can be restored from.
type	string	The type of Azure resource.

RestorableDatabaseAccountsListResult

The List operation response, that contains the restorable database accounts and their properties.

Name	Type	Description
value	RestorableDatabaseAccountGetResult[]	List of restorable database accounts and their properties.

RestorableLocationResource

Properties of the regional restorable account.

Name	Type	Description
creationTime	string	The creation time of the regional restorable database account (ISO-8601 format).
deletionTime	string	The time at which the regional restorable database account has been deleted (ISO-8601 format).
locationName	string	The location of the regional restorable account.
regionalDatabaseAccountInstanceId	string	The instance id of the regional restorable account.

Share via