Delen via


Restorable Sql Databases - List

De gebeurtenisfeed weergeven van alle mutaties die zijn uitgevoerd in alle Azure Cosmos DB SQL-databases onder het restorable-account. Dit helpt in een scenario waarin de database per ongeluk is verwijderd om de verwijderingstijd op te halen. Voor deze API is de machtiging Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read vereist

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

URI-parameters

Name In Vereist Type Description
instanceId
path True

string

De instanceId GUID van een restorable databaseaccount.

location
path True

string

Cosmos DB-regio, met spaties tussen woorden en elk woord met een hoofdletter.

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name Type Description
200 OK

RestorableSqlDatabasesListResult

De bewerking is voltooid.

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

CosmosDBRestorableSqlDatabaseList

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlDatabases?api-version=2024-05-15

Voorbeeldrespons

{
  "value": [
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/36f09704-6be3-4f33-aa05-17b73e504c75/restorableSqlDatabases/59c21367-b98b-4a8e-abb7-b6f46600decc",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableSqlDatabases",
      "name": "59c21367-b98b-4a8e-abb7-b6f46600decc",
      "properties": {
        "resource": {
          "_rid": "DLB14gAAAA==",
          "eventTimestamp": "2020-09-02T19:45:03Z",
          "ownerId": "Database1",
          "ownerResourceId": "3fu-hg==",
          "operationType": "Create",
          "canUndelete": "invalid",
          "database": {
            "id": "Database1",
            "_rid": "3fu-hg==",
            "_self": "dbs/3fu-hg==/",
            "_etag": "\"0000c20a-0000-0700-0000-5f4ff63f0000\"",
            "_colls": "colls/",
            "_users": "users/"
          }
        }
      }
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlDatabases/8456cb17-cdb0-4c6a-8db8-d0ff3f886257",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableSqlDatabases",
      "name": "8456cb17-cdb0-4c6a-8db8-d0ff3f886257",
      "properties": {
        "resource": {
          "_rid": "ESXNLAAAAA==",
          "eventTimestamp": "2020-09-02T19:53:42Z",
          "ownerId": "Database1",
          "ownerResourceId": "3fu-hg==",
          "database": {
            "id": "Database1",
            "_rid": "3fu-hg==",
            "_self": "dbs/3fu-hg==/",
            "_etag": "\"0000c20a-0000-0700-0000-5f4ff63f0000\"",
            "_colls": "colls/",
            "_users": "users/",
            "_ts": 1599075903
          },
          "operationType": "Delete",
          "canUndelete": "notRestorable",
          "canUndeleteReason": "Database already exists. Only deleted resources can be restored within same account."
        }
      }
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlDatabases/2c07991b-9c7c-4e85-be68-b18c1f2ff326",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableSqlDatabases",
      "name": "2c07991b-9c7c-4e85-be68-b18c1f2ff326",
      "properties": {
        "resource": {
          "_rid": "aXFqUQAAAA==",
          "eventTimestamp": "2020-09-02T19:53:15Z",
          "ownerId": "Database2",
          "ownerResourceId": "0SziSg==",
          "database": {
            "id": "Database2",
            "_rid": "0SziSg==",
            "_self": "dbs/0SziSg==/",
            "_etag": "\"0000ca0a-0000-0700-0000-5f4ff82b0000\"",
            "_colls": "colls/",
            "_users": "users/"
          },
          "operationType": "Create",
          "canUndelete": "invalid"
        }
      }
    }
  ]
}

Definities

Name Description
CloudError

Een foutreactie van de service.

CreateMode

Opsomming om de modus voor het maken van een account aan te geven.

Database

Cosmos DB SQL-databaseresourceobject

ErrorResponse

Foutreactie.

OperationType

Opsomming om het bewerkingstype van de gebeurtenis aan te geven.

Resource

De resource van een Azure Cosmos DB SQL-database-gebeurtenis

ResourceRestoreParameters

Parameters om de informatie over de herstelbewerking aan te geven.

RestorableSqlDatabaseGetResult

Een Azure Cosmos DB SQL-database-gebeurtenis

RestorableSqlDatabasesListResult

Het antwoord van de list-bewerking, dat de SQL-database-gebeurtenissen en hun eigenschappen bevat.

CloudError

Een foutreactie van de service.

Name Type Description
error

ErrorResponse

Foutreactie.

CreateMode

Opsomming om de modus voor het maken van een account aan te geven.

Name Type Description
Default

string

Restore

string

Database

Cosmos DB SQL-databaseresourceobject

Name Type Default value Description
_colls

string

Een door het systeem gegenereerde eigenschap die het adresseerbare pad van de verzamelingsresource heeft opgegeven.

_etag

string

Een door het systeem gegenereerde eigenschap die de resource-etag vertegenwoordigt die is vereist voor optimistisch gelijktijdigheidsbeheer.

_rid

string

Een door het systeem gegenereerde eigenschap. Een unieke id.

_self

string

Een door het systeem gegenereerde eigenschap die het adresseerbare pad van de databaseresource aangeeft.

_ts

number

Een door het systeem gegenereerde eigenschap die de laatst bijgewerkte tijdstempel van de resource aangeeft.

_users

string

Een door het systeem gegenereerde eigenschap die het adresseerbare pad van de gebruikersresource aangeeft.

createMode

CreateMode

Default

Opsomming om de modus voor het maken van resources aan te geven.

id

string

Naam van de Cosmos DB SQL-database

restoreParameters

ResourceRestoreParameters

Parameters om de informatie over de herstelbewerking aan te geven

ErrorResponse

Foutreactie.

Name Type Description
code

string

Foutcode.

message

string

Foutbericht waarin wordt aangegeven waarom de bewerking is mislukt.

OperationType

Opsomming om het bewerkingstype van de gebeurtenis aan te geven.

Name Type Description
Create

string

Delete

string

Recreate

string

Replace

string

SystemOperation

string

Resource

De resource van een Azure Cosmos DB SQL-database-gebeurtenis

Name Type Description
_rid

string

Een door het systeem gegenereerde eigenschap. Een unieke id.

canUndelete

string

Een status van deze database om te bepalen of deze database kan worden hersteld in hetzelfde account.

canUndeleteReason

string

De reden waarom deze database niet kan worden hersteld in hetzelfde account.

database

Database

Cosmos DB SQL-databaseresourceobject

eventTimestamp

string

Het tijdstip waarop deze database-gebeurtenis heeft plaatsgevonden.

operationType

OperationType

Het bewerkingstype van deze database-gebeurtenis.

ownerId

string

De naam van de SQL-database.

ownerResourceId

string

De resource-id van de SQL-database.

ResourceRestoreParameters

Parameters om de informatie over de herstelbewerking aan te geven.

Name Type Description
restoreSource

string

De id van het herstelbare databaseaccount van waaruit het herstel moet worden gestart. Bijvoorbeeld: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}

restoreTimestampInUtc

string

Het tijdstip waarop het account moet worden hersteld (ISO-8601-indeling).

RestorableSqlDatabaseGetResult

Een Azure Cosmos DB SQL-database-gebeurtenis

Name Type Description
id

string

De unieke resource-id van de ARM-resource.

name

string

De naam van de ARM-resource.

properties.resource

Resource

De resource van een Azure Cosmos DB SQL-database-gebeurtenis

type

string

Het type Azure-resource.

RestorableSqlDatabasesListResult

Het antwoord van de list-bewerking, dat de SQL-database-gebeurtenissen en hun eigenschappen bevat.

Name Type Description
value

RestorableSqlDatabaseGetResult[]

Lijst met SQL-database-gebeurtenissen en hun eigenschappen.