Sdílet prostřednictvím

Restorable Sql Databases - List

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

Zobrazení kanálu událostí všech mutací provedených ve všech databázích SQL Azure Cosmos DB v rámci obnovitelného účtu To pomáhá ve scénáři, kdy byla databáze omylem odstraněna, aby se získal č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-05-15

Parametry identifikátoru URI

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

string

InstanceId GUID 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

Tok Azure Active Directory OAuth2

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-05-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 Cosmos DB
ErrorResponse

Odpověď na chybu.
OperationType

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

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

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

Událost databáze SQL 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

Odpověď na chybu.

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 Cosmos DB

Name Typ Default value Description
_colls

string

Systém generovaná vlastnost, která určila adresovatelnou cestu k prostředku kolekcí.
_etag

string

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

string

Systémem vygenerovaná vlastnost. Jedinečný identifikátor.
_self

string

Systém generovaná vlastnost, která určuje adresovatelnou cestu k prostředku databáze.
_ts

number

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

string

Systém generovaná 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 Cosmos DB
restoreParameters

ResourceRestoreParameters

Parametry označující informace o obnovení

ErrorResponse

Odpověď na chybu.

Name Typ Description
code

string

Kód chyby
message

string

Chybová zpráva s informacemi o tom, 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 Azure Cosmos DB

Name Typ Description
_rid

string

Systémem vygenerovaná vlastnost. Jedinečný identifikátor.
canUndelete

string

Stav této databáze k určení, jestli je tato databáze obnovitelná ve stejném účtu.
canUndeleteReason

string

Důvod, proč tuto databázi nelze obnovit ve stejném účtu.
database

Database

Objekt prostředku databáze SQL Cosmos DB
eventTimestamp

string

Čas, kdy došlo k této události databáze.
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 obnovitelného databázového účtu, ze kterého se má zahájit obnovení. Příklad: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}
restoreTimestampInUtc

string

Čas, do kterého musí být účet obnoven (formát ISO-8601).

RestorableSqlDatabaseGetResult

Událost databáze SQL 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 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í