Delen via

Restorable Sql Databases - List

  • Referentie
Service:
Cosmos DB Resource Provider
API-versie:
2024-11-15

Geef de gebeurtenisfeed weer van alle mutaties die zijn uitgevoerd op alle Azure Cosmos DB SQL-databases onder het restorable account. Dit helpt in het 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-11-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 hoofdletters.
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-11-15

Voorbeeldrespons

Statuscode:
200 
{
  "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 accounts aan te geven.
Database

Cosmos DB SQL Database-resourceobject
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 lijstbewerking, die de SQL-database-gebeurtenissen en de bijbehorende eigenschappen bevat.

CloudError

Een foutreactie van de service.

Name Type Description
error

ErrorResponse

Foutreactie.

CreateMode

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

Name Type Description
Default

string

Restore

string

Database

Cosmos DB SQL Database-resourceobject

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 dat aangeeft 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 overgeslagen in hetzelfde account.
canUndeleteReason

string

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

Database

Cosmos DB SQL Database-resourceobject
eventTimestamp

string

Het tijdstip waarop deze database-gebeurtenis is opgetreden.
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

Tijd waarop het account moet worden hersteld (ISO-8601-indeling).
restoreWithTtlDisabled

boolean

Hiermee geeft u op of het herstelde account tijd-To-Live uitgeschakeld bij het herstellen.

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 lijstbewerking, die de SQL-database-gebeurtenissen en de bijbehorende eigenschappen bevat.

Name Type Description
value

RestorableSqlDatabaseGetResult[]

Lijst met SQL-database-gebeurtenissen en de bijbehorende eigenschappen.