Restorable Sql Resources - List

Referenz

Service:: Cosmos DB Resource Provider

API Version:: 2024-05-15

Hier erfahren Sie, wie Sie eine Liste der Datenbank- und Containerkombinationen zurückgeben, die zum angegebenen Zeitstempel und am angegebenen Speicherort im Konto vorhanden sind. Dies ist in Szenarios hilfreich, in denen überprüft werden soll, welche Ressourcen zu einer bestimmten Zeit (Zeitstempel) und an einem bestimmten Speicherort vorhanden sind. Für diese API ist die Berechtigung "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read" erforderlich.

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

With optional parameters:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
instanceId	path	True	string	Hierbei handelt es sich um die instanceId-GUID eines wiederherstellbaren Datenbankkontos.
location	path	True	string	Cosmos DB-Region mit Leerzeichen zwischen Wörtern und jedem Wort in Großbuchstaben.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.
restoreLocation	query		string	Hierbei handelt es sich um den Speicherort, an dem sich die wiederherstellbaren Ressourcen befinden.
restoreTimestampInUtc	query		string	Hierbei handelt es sich um den Zeitstempel, zu dem die wiederherstellbaren Ressourcen vorhanden waren.

Antworten

Name	Typ	Beschreibung
200 OK	RestorableSqlResourcesListResult	Der Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

CosmosDBRestorableSqlResourceList

Sample Request

HTTP

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-05-15&restoreLocation=WestUS&restoreTimestampInUtc=06/01/2022 4:56

Sample Response

Status code:: 200

{
  "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 vom Dienst.
ErrorResponse	Fehlerantwort.
RestorableSqlResourcesGetResult	Bestimmte wiederherzustellende Datenbanken.
RestorableSqlResourcesListResult	Die Antwort des Auflistungsvorgangs, die die wiederherstellbaren SQL-Ressourcen enthält.

CloudError

Eine Fehlerantwort vom Dienst.

Name	Typ	Beschreibung
error	ErrorResponse	Fehlerantwort.

ErrorResponse

Fehlerantwort.

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

RestorableSqlResourcesGetResult

Bestimmte wiederherzustellende Datenbanken.

Name	Typ	Beschreibung
collectionNames	string[]	Die Namen der zur Wiederherstellung verfügbaren Sammlungen.
databaseName	string	Der Name der für die Wiederherstellung verfügbaren Datenbank.
id	string	Der eindeutige Ressourcenbezeichner der ARM-Ressource.
name	string	Der Name der ARM-Ressource.
type	string	Der Typ der Azure-Ressource.