Freigeben über


Restorable Sql Resources - List

Gibt eine Liste der Datenbank- und Container-Kombinationen zurück, die für das Konto zum angegebenen Zeitstempel und Standort vorhanden sind. Dies hilft in Szenarien, zu überprüfen, welche Ressourcen zu einem bestimmten Zeitstempel und Standort vorhanden sind. Diese API erfordert die Berechtigung "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read".

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
instanceId
path True

string

Die instanceId-GUID eines wiederhergestellten Datenbankkontos.

location
path True

string

Cosmos DB-Region mit Leerzeichen zwischen Wörtern und jedem Wort mit Großbuchstaben.

subscriptionId
path True

string

Die ID des Zielabonnements.

api-version
query True

string

Die API-Version, die für diesen Vorgang verwendet werden soll.

restoreLocation
query

string

Der Speicherort, an dem sich die wiederherstellbaren Ressourcen befinden.

restoreTimestampInUtc
query

string

Der Zeitstempel, wenn die wiederherstellbaren Ressourcen vorhanden sind.

Antworten

Name Typ Beschreibung
200 OK

RestorableSqlResourcesListResult

Der Vorgang wurde erfolgreich abgeschlossen.

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

CosmosDBRestorableSqlResourceList

Beispielanforderung

GET https://management.azure.com/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlResources?api-version=2024-11-15&restoreLocation=WestUS&restoreTimestampInUtc=06/01/2022 4:56

Beispiel für eine Antwort

{
  "value": [
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database1",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database1",
      "databaseName": "Database1",
      "collectionNames": [
        "Container1"
      ]
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database2",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database2",
      "databaseName": "Database2",
      "collectionNames": [
        "Container1",
        "Container2"
      ]
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database3",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database3",
      "databaseName": "Database3",
      "collectionNames": []
    }
  ]
}

Definitionen

Name Beschreibung
CloudError

Eine Fehlerantwort des Diensts.

ErrorResponse

Fehlerantwort.

RestorableSqlResourcesGetResult

Bestimmte Datenbanken, die wiederhergestellt werden sollen.

RestorableSqlResourcesListResult

Die Antwort des Listenvorgangs, die die wiederherstellbaren SQL-Ressourcen enthält.

CloudError

Eine Fehlerantwort des Diensts.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort.

ErrorResponse

Fehlerantwort.

Name Typ Beschreibung
code

string

Fehlercode.

message

string

Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

RestorableSqlResourcesGetResult

Bestimmte Datenbanken, die wiederhergestellt werden sollen.

Name Typ Beschreibung
collectionNames

string[]

Die Namen der für die Wiederherstellung verfügbaren Auflistungen.

databaseName

string

Der Name der Datenbank, die für die Wiederherstellung verfügbar ist.

id

string

Der eindeutige Ressourcenbezeichner der ARM-Ressource.

name

string

Der Name der ARM-Ressource.

type

string

Der Typ der Azure-Ressource.

RestorableSqlResourcesListResult

Die Antwort des Listenvorgangs, die die wiederherstellbaren SQL-Ressourcen enthält.

Name Typ Beschreibung
value

RestorableSqlResourcesGetResult[]

Liste der wiederherstellbaren SQL-Ressourcen, einschließlich der Datenbank- und Sammlungsnamen.