Restorable Sql Databases - List
A visszaállítható fiók alatti összes Azure Cosmos DB SQL-adatbázison végrehajtott összes mutáció eseménycsatornájának megjelenítése. Ez segít abban az esetben, ha az adatbázist véletlenül törölték a törlési idő lekéréséhez. Ehhez az API-hoz "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read" engedély szükséges
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlDatabases?api-version=2024-05-15
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
instance
|
path | True |
string |
Visszaállítható adatbázisfiók instanceId GUID azonosítója. |
location
|
path | True |
string |
Cosmos DB-régió, a szavak és az egyes szavak közötti szóközök nagybetűvel. |
subscription
|
path | True |
string |
A cél-előfizetés azonosítója. |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A művelet sikeresen befejeződött. |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Típus:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | A felhasználói fiók megszemélyesítése |
Példák
CosmosDBRestorableSqlDatabaseList
Sample request
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
Sample response
{
"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"
}
}
}
]
}
Definíciók
Name | Description |
---|---|
Cloud |
Hibaválasz a szolgáltatástól. |
Create |
Szám a fióklétrehozás módjának jelzésére. |
Database |
Cosmos DB SQL-adatbázis erőforrás-objektuma |
Error |
Hibaválasz. |
Operation |
Szám az esemény művelettípusának jelzéséhez. |
Resource |
Egy Azure Cosmos DB SQL-adatbázisesemény erőforrása |
Resource |
A visszaállítással kapcsolatos információkat jelző paraméterek. |
Restorable |
Azure Cosmos DB SQL Database-esemény |
Restorable |
Az SQL-adatbázis eseményeit és tulajdonságait tartalmazó listázási művelet válasza. |
CloudError
Hibaválasz a szolgáltatástól.
Name | Típus | Description |
---|---|---|
error |
Hibaválasz. |
CreateMode
Szám a fióklétrehozás módjának jelzésére.
Name | Típus | Description |
---|---|---|
Default |
string |
|
Restore |
string |
Database
Cosmos DB SQL-adatbázis erőforrás-objektuma
Name | Típus | alapértelmezett érték | Description |
---|---|---|---|
_colls |
string |
Egy rendszer által létrehozott tulajdonság, amely megadta a gyűjtemények erőforrásának címezhető elérési útját. |
|
_etag |
string |
Egy rendszer által létrehozott tulajdonság, amely az optimista egyidejűség-vezérléshez szükséges erőforrás-etagot jelöli. |
|
_rid |
string |
Rendszer által létrehozott tulajdonság. Egyedi azonosító. |
|
_self |
string |
Egy rendszer által létrehozott tulajdonság, amely meghatározza az adatbázis-erőforrás címzhető elérési útját. |
|
_ts |
number |
Egy rendszer által létrehozott tulajdonság, amely az erőforrás utolsó frissített időbélyegét jelöli. |
|
_users |
string |
A rendszer által létrehozott tulajdonság, amely meghatározza a felhasználói erőforrás címzhető elérési útját. |
|
createMode | Default |
Szám az erőforrás-létrehozás módjának jelzéséhez. |
|
id |
string |
A Cosmos DB SQL-adatbázis neve |
|
restoreParameters |
A visszaállítással kapcsolatos információkat jelző paraméterek |
ErrorResponse
Hibaválasz.
Name | Típus | Description |
---|---|---|
code |
string |
Hibakód. |
message |
string |
Hibaüzenet jelzi, hogy a művelet miért nem sikerült. |
OperationType
Szám az esemény művelettípusának jelzéséhez.
Name | Típus | Description |
---|---|---|
Create |
string |
|
Delete |
string |
|
Recreate |
string |
|
Replace |
string |
|
SystemOperation |
string |
Resource
Egy Azure Cosmos DB SQL-adatbázisesemény erőforrása
Name | Típus | Description |
---|---|---|
_rid |
string |
Rendszer által létrehozott tulajdonság. Egyedi azonosító. |
canUndelete |
string |
Az adatbázis állapota annak megállapításához, hogy az adatbázis visszaállítható-e ugyanabban a fiókban. |
canUndeleteReason |
string |
Ez az oka annak, hogy az adatbázis nem állítható vissza ugyanabban a fiókban. |
database |
Cosmos DB SQL-adatbázis erőforrás-objektuma |
|
eventTimestamp |
string |
Az adatbázis-esemény bekövetkezésének időpontja. |
operationType |
Az adatbázisesemény művelettípusa. |
|
ownerId |
string |
Az SQL-adatbázis neve. |
ownerResourceId |
string |
Az SQL-adatbázis erőforrás-azonosítója. |
ResourceRestoreParameters
A visszaállítással kapcsolatos információkat jelző paraméterek.
Name | Típus | Description |
---|---|---|
restoreSource |
string |
Annak a visszaállítható adatbázisfióknak az azonosítója, amelyről a visszaállítást el kell indítani. Például: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
restoreTimestampInUtc |
string |
A fiók visszaállításának időpontja (ISO-8601 formátum). |
RestorableSqlDatabaseGetResult
Azure Cosmos DB SQL Database-esemény
Name | Típus | Description |
---|---|---|
id |
string |
Az ARM-erőforrás egyedi azonosítója. |
name |
string |
Az ARM-erőforrás neve. |
properties.resource |
Egy Azure Cosmos DB SQL-adatbázisesemény erőforrása |
|
type |
string |
Az Azure-erőforrás típusa. |
RestorableSqlDatabasesListResult
Az SQL-adatbázis eseményeit és tulajdonságait tartalmazó listázási művelet válasza.
Name | Típus | Description |
---|---|---|
value |
Az SQL-adatbázis eseményeinek és tulajdonságainak listája. |