Sdílet prostřednictvím

Restorable Sql Databases - List

  • Reference
Služba:
Cosmos DB Resource Provider
Verze rozhraní API:
2024-11-15

Zobrazení kanálu událostí všech mutací provedených ve všech databázích SQL služby Azure Cosmos DB v rámci obnovitelného účtu To pomáhá ve scénáři, kdy se databáze omylem odstranila a získala čas odstranění. Toto rozhraní API vyžaduje oprávnění Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
instanceId
 path True

string

Identifikátor GUID instanceId obnovitelného databázového účtu.
location
 path True

string

Oblast Cosmos DB s mezerami mezi slovy a jednotlivými slovy velkými písmeny
subscriptionId
 path True

string

ID cílového předplatného.
api-version
 query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name Typ Description
200 OK

RestorableSqlDatabasesListResult

Operace byla úspěšně dokončena.
Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation Zosobnění uživatelského účtu

Příklady

CosmosDBRestorableSqlDatabaseList

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
        }
      }
    }
  ]
}

Definice

Name Description
CloudError

Chybová odpověď ze služby.
CreateMode

Výčet označující režim vytváření účtu.
Database

Objekt prostředku databáze SQL služby Cosmos DB
ErrorResponse

Chybová odpověď.
OperationType

Výčet označující typ operace události.
Resource

Prostředek události databáze SQL služby Azure Cosmos DB
ResourceRestoreParameters

Parametry označující informace o obnovení
RestorableSqlDatabaseGetResult

Událost databáze SQL služby Azure Cosmos DB
RestorableSqlDatabasesListResult

Odpověď operace List, která obsahuje události databáze SQL a jejich vlastnosti.

CloudError

Chybová odpověď ze služby.

Name Typ Description
error

ErrorResponse

Chybová odpověď.

CreateMode

Výčet označující režim vytváření účtu.

Name Typ Description
Default

string

Restore

string

Database

Objekt prostředku databáze SQL služby Cosmos DB

Name Typ Default value Description
_colls

string

Systém vygeneroval vlastnost, která zadala adresovatelnou cestu prostředku kolekce.
_etag

string

Systém vygenerovaná vlastnost představující značku etag prostředku vyžadovanou pro optimistické řízení souběžnosti.
_rid

string

Systém vygeneroval vlastnost. Jedinečný identifikátor.
_self

string

Systém vygenerovaná vlastnost, která určuje adresovatelnou cestu k databázovému prostředku.
_ts

number

Systém vygenerovaná vlastnost, která označuje časové razítko poslední aktualizace prostředku.
_users

string

Systém vygenerovaná vlastnost, která určuje adresovatelnou cestu prostředku uživatele.
createMode

CreateMode

Default

Výčet označující režim vytváření prostředků.
id

string

Název databáze SQL služby Cosmos DB
restoreParameters

ResourceRestoreParameters

Parametry označující informace o obnovení

ErrorResponse

Chybová odpověď.

Name Typ Description
code

string

Kód chyby
message

string

Chybová zpráva označující, proč operace selhala.

OperationType

Výčet označující typ operace události.

Name Typ Description
Create

string

Delete

string

Recreate

string

Replace

string

SystemOperation

string

Resource

Prostředek události databáze SQL služby Azure Cosmos DB

Name Typ Description
_rid

string

Systém vygeneroval vlastnost. Jedinečný identifikátor.
canUndelete

string

Stav této databáze, který identifikuje, jestli je tato databáze obnovitelná ve stejném účtu.
canUndeleteReason

string

Důvod, proč se tato databáze nedá obnovit ve stejném účtu.
database

Database

Objekt prostředku databáze SQL služby Cosmos DB
eventTimestamp

string

Čas, kdy k této události databáze došlo.
operationType

OperationType

Typ operace této databázové události.
ownerId

string

Název databáze SQL.
ownerResourceId

string

ID prostředku databáze SQL.

ResourceRestoreParameters

Parametry označující informace o obnovení

Name Typ Description
restoreSource

string

ID obnovovatelného databázového účtu, ze kterého se má obnovení zahájit. Příklad: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}
restoreTimestampInUtc

string

Čas obnovení účtu (formát ISO-8601)
restoreWithTtlDisabled

boolean

Určuje, jestli obnovený účet bude mít po úspěšném obnovení zakázaný časovýTo-Live.

RestorableSqlDatabaseGetResult

Událost databáze SQL služby Azure Cosmos DB

Name Typ Description
id

string

Jedinečný identifikátor prostředku ARM.
name

string

Název prostředku ARM.
properties.resource

Resource

Prostředek události databáze SQL služby Azure Cosmos DB
type

string

Typ prostředku Azure.

RestorableSqlDatabasesListResult

Odpověď operace List, která obsahuje události databáze SQL a jejich vlastnosti.

Name Typ Description
value

RestorableSqlDatabaseGetResult[]

Seznam událostí databáze SQL a jejich vlastností