Restorable Tables - List

Referenz

Service:: Cosmos DB Resource Provider

API Version:: 2024-05-15

Zeigen Sie den Ereignisfeed aller Mutationen an, die für alle Azure Cosmos DB-Tabellen ausgeführt wurden. Dies ist in Einem Szenario hilfreich, in dem die Tabelle versehentlich gelöscht wurde. 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}/restorableTables?api-version=2024-05-15

With optional parameters:

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

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 großgeschriebenen Wörtern.
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.
endTime	query		string	Wiederherstellbare Tabellen-Ereignisfeed-Endzeit.
startTime	query		string	Startzeit des wiederherstellbaren Tabellen-Ereignisfeeds.

Antworten

Name	Typ	Beschreibung
200 OK	RestorableTablesListResult	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

CosmosDBRestorableTableList

Sample Request

HTTP

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableTables?api-version=2024-05-15

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/subid/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableTables/79609a98-3394-41f8-911f-cfab0c075c86",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableTables",
      "name": "79609a98-3394-41f8-911f-cfab0c075c86",
      "properties": {
        "resource": {
          "_rid": "zAyAPQAAAA==",
          "eventTimestamp": "2020-10-13T04:56:42Z",
          "ownerId": "Table1",
          "ownerResourceId": "V18LoLrv-qA=",
          "operationType": "Create",
          "canUndelete": "invalid"
        }
      }
    },
    {
      "id": "/subscriptions/subid/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableTables/79609a98-3394-41f8-911f-cfab0c075c86",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableTables",
      "name": "79609a98-3394-41f8-911f-cfab0c075c86",
      "properties": {
        "resource": {
          "_rid": "zAyAPQAAAA==",
          "eventTimestamp": "2020-10-13T04:56:42Z",
          "ownerId": "Table1",
          "ownerResourceId": "V18LoLrv-qA=",
          "operationType": "Delete",
          "canUndelete": "notRestorable",
          "canUndeleteReason": "Collection with same name already exist as live collection."
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort vom Dienst.
ErrorResponse	Fehlerantwort.
OperationType	Enumeration, die den Vorgangstyp des Ereignisses angibt.
Resource	Die Ressource eines Azure Cosmos DB-Tabellenereignisses
RestorableTableGetResult	Ein Azure Cosmos DB-Tabellenereignis
RestorableTablesListResult	Die List-Vorgangsantwort, die die Table-Ereignisse und deren Eigenschaften 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.

OperationType

Enumeration, die den Vorgangstyp des Ereignisses angibt.

Name	Typ	Beschreibung
Create	string
Delete	string
Recreate	string
Replace	string
SystemOperation	string

Resource

Die Ressource eines Azure Cosmos DB-Tabellenereignisses

Name	Typ	Beschreibung
_rid	string	Eine vom System generierte Eigenschaft. Einen eindeutigen Bezeichner.
canUndelete	string	Ein Status dieser Tabelle, um zu ermitteln, ob diese Tabelle in demselben Konto wiederhergestellt werden kann.
canUndeleteReason	string	Der Grund, warum diese Tabelle nicht im selben Konto wiederhergestellt werden kann.
eventTimestamp	string	Der Zeitpunkt, zu dem dieses Tabellenereignis aufgetreten ist.
operationType	OperationType	Der Vorgangstyp dieses Tabellenereignisses.
ownerId	string	Der Name dieser Tabelle.
ownerResourceId	string	Die Ressourcen-ID dieser Tabelle.

RestorableTableGetResult

Ein Azure Cosmos DB-Tabellenereignis

Name	Typ	Beschreibung
id	string	Der eindeutige Ressourcenbezeichner der ARM-Ressource.
name	string	Der Name der ARM-Ressource.
properties.resource	Resource	Die Ressource eines Azure Cosmos DB-Tabellenereignisses
type	string	Der Typ der Azure-Ressource.