Restorable Gremlin Databases - List

Referenz

Service:: Cosmos DB Resource Provider

API Version:: 2024-05-15

Zeigen Sie den Ereignisfeed aller Mutationen an, die in allen Gremlin-Datenbanken von Azure Cosmos DB unter dem wiederherstellbaren Konto ausgeführt wurden. Dies ist in einem Szenario hilfreich, in dem die Datenbank versehentlich gelöscht wurde, um den Löschzeitpunkt zu ermitteln. 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}/restorableGremlinDatabases?api-version=2024-05-15

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.

Antworten

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

CosmosDBRestorableGremlinDatabaseList

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/restorableGremlinDatabases?api-version=2024-05-15

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/36f09704-6be3-4f33-aa05-17b73e504c75/restorableGremlinDatabases/59c21367-b98b-4a8e-abb7-b6f46600decc",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableGremlinDatabases",
      "name": "59c21367-b98b-4a8e-abb7-b6f46600decc",
      "properties": {
        "resource": {
          "_rid": "DLB14gAAAA==",
          "eventTimestamp": "2020-09-02T19:45:03Z",
          "ownerId": "Database1",
          "ownerResourceId": "PD5DALigDgw=",
          "operationType": "Create",
          "canUndelete": "invalid"
        }
      }
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableGremlinDatabases/8456cb17-cdb0-4c6a-8db8-d0ff3f886257",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableGremlinDatabases",
      "name": "8456cb17-cdb0-4c6a-8db8-d0ff3f886257",
      "properties": {
        "resource": {
          "_rid": "ESXNLAAAAA==",
          "eventTimestamp": "2020-09-02T19:53:42Z",
          "ownerId": "Database1",
          "ownerResourceId": "PD5DALigDgw=",
          "operationType": "Delete",
          "canUndelete": "notRestorable",
          "canUndeleteReason": "Database already exists. Only deleted resources can be restored within same account."
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort vom Dienst.
ErrorResponse	Fehlerantwort.
OperationType	Enumeration, die den Vorgangstyp des Ereignisses angibt.
Resource	Die Ressource eines Gremlin-Datenbankereignisses in Azure Cosmos DB
RestorableGremlinDatabaseGetResult	Ein Gremlin-Datenbankereignis in Azure Cosmos DB
RestorableGremlinDatabasesListResult	Die List-Vorgangsantwort, die die Gremlin-Datenbankereignisse 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 Gremlin-Datenbankereignisses in Azure Cosmos DB

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

RestorableGremlinDatabaseGetResult

Ein Gremlin-Datenbankereignis in Azure Cosmos DB

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