Restorable Sql Databases - List
Geri yüklenebilen hesap altındaki tüm Azure Cosmos DB SQL veritabanlarında yapılan tüm mutasyonların olay akışını gösterin. Bu, silme süresini almak için veritabanının yanlışlıkla silindiği senaryoda yardımcı olur. Bu API için 'Microsoft.DocumentDB/locations/restoreableDatabaseAccounts/.../read' izni gerekiyor
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlDatabases?api-version=2024-05-15
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
instance
|
path | True |
string |
Geri yüklenebilen bir veritabanı hesabının instanceId GUID değeri. |
location
|
path | True |
string |
Cosmos DB bölgesi; sözcükler ve her sözcük arasında boşluklar büyük harfle yazıldı. |
subscription
|
path | True |
string |
Hedef aboneliğin kimliği. |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
İşlem başarıyla tamamlandı. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | Kullanıcı hesabınızın kimliğine bürünme |
Örnekler
CosmosDBRestorableSqlDatabaseList
Örnek isteği
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
Örnek yanıt
{
"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"
}
}
}
]
}
Tanımlar
Name | Description |
---|---|
Cloud |
Hizmetten bir hata yanıtı. |
Create |
Hesap oluşturma modunu belirtmek için sabit listesi. |
Database |
Cosmos DB SQL veritabanı kaynak nesnesi |
Error |
Hata Yanıtı. |
Operation |
Olayın işlem türünü belirtmek için sabit listesi. |
Resource |
Azure Cosmos DB SQL veritabanı olayının kaynağı |
Resource |
Geri yükleme hakkındaki bilgileri gösteren parametreler. |
Restorable |
Azure Cosmos DB SQL veritabanı olayı |
Restorable |
SQL veritabanı olaylarını ve özelliklerini içeren List işlemi yanıtı. |
CloudError
Hizmetten bir hata yanıtı.
Name | Tür | Description |
---|---|---|
error |
Hata Yanıtı. |
CreateMode
Hesap oluşturma modunu belirtmek için sabit listesi.
Name | Tür | Description |
---|---|---|
Default |
string |
|
Restore |
string |
Database
Cosmos DB SQL veritabanı kaynak nesnesi
Name | Tür | Default value | Description |
---|---|---|---|
_colls |
string |
Koleksiyon kaynağının adreslenebilir yolunu belirten sistem tarafından oluşturulan özellik. |
|
_etag |
string |
İyimser eşzamanlılık denetimi için gereken kaynak etiketini temsil eden sistem tarafından oluşturulan özellik. |
|
_rid |
string |
Sistem tarafından oluşturulan özellik. Benzersiz bir tanımlayıcı. |
|
_self |
string |
Veritabanı kaynağının adreslenebilir yolunu belirten sistem tarafından oluşturulan özellik. |
|
_ts |
number |
Kaynağın son güncelleştirilen zaman damgasını belirten sistem tarafından oluşturulan özellik. |
|
_users |
string |
Kullanıcı kaynağının adreslenebilir yolunu belirten sistem tarafından oluşturulan özellik. |
|
createMode | Default |
Kaynak oluşturma modunu belirtmek için sabit listesi. |
|
id |
string |
Cosmos DB SQL veritabanının adı |
|
restoreParameters |
Geri yükleme hakkındaki bilgileri gösteren parametreler |
ErrorResponse
Hata Yanıtı.
Name | Tür | Description |
---|---|---|
code |
string |
Hata kodu. |
message |
string |
İşlemin neden başarısız olduğunu belirten hata iletisi. |
OperationType
Olayın işlem türünü belirtmek için sabit listesi.
Name | Tür | Description |
---|---|---|
Create |
string |
|
Delete |
string |
|
Recreate |
string |
|
Replace |
string |
|
SystemOperation |
string |
Resource
Azure Cosmos DB SQL veritabanı olayının kaynağı
Name | Tür | Description |
---|---|---|
_rid |
string |
Sistem tarafından oluşturulan özellik. Benzersiz bir tanımlayıcı. |
canUndelete |
string |
Bu veritabanının aynı hesapta geri yüklenebilen olup olmadığını belirlemek için bu veritabanının durumu. |
canUndeleteReason |
string |
Bu veritabanının aynı hesapta geri yüklenememe nedeni. |
database |
Cosmos DB SQL veritabanı kaynak nesnesi |
|
eventTimestamp |
string |
Bu veritabanı olayının gerçekleştiği zaman. |
operationType |
Bu veritabanı olayının işlem türü. |
|
ownerId |
string |
SQL veritabanının adı. |
ownerResourceId |
string |
SQL veritabanının kaynak kimliği. |
ResourceRestoreParameters
Geri yükleme hakkındaki bilgileri gösteren parametreler.
Name | Tür | Description |
---|---|---|
restoreSource |
string |
Geri yüklemenin başlatılması gereken geri yüklenebilir veritabanı hesabının kimliği. Örneğin: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restoreableDatabaseAccounts/{restoreableDatabaseAccountName} |
restoreTimestampInUtc |
string |
Hesabın geri yüklenmesi gereken süre (ISO-8601 biçimi). |
RestorableSqlDatabaseGetResult
Azure Cosmos DB SQL veritabanı olayı
Name | Tür | Description |
---|---|---|
id |
string |
ARM kaynağının benzersiz kaynak Tanımlayıcısı. |
name |
string |
ARM kaynağının adı. |
properties.resource |
Azure Cosmos DB SQL veritabanı olayının kaynağı |
|
type |
string |
Azure kaynağının türü. |
RestorableSqlDatabasesListResult
SQL veritabanı olaylarını ve özelliklerini içeren List işlemi yanıtı.
Name | Tür | Description |
---|---|---|
value |
SQL veritabanı olaylarının ve özelliklerinin listesi. |