Aracılığıyla paylaş

Restorable Sql Databases - List

  • Başvuru
Hizmet:
Cosmos DB Resource Provider
API Sürümü:
2024-05-15

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
instanceId
 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ı.
subscriptionId
 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

RestorableSqlDatabasesListResult

İşlem başarıyla tamamlandı.
Other Status Codes

CloudError

İş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

Durum kodu:
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"
        }
      }
    }
  ]
}

Tanımlar

Name Description
CloudError

Hizmetten bir hata yanıtı.
CreateMode

Hesap oluşturma modunu belirtmek için sabit listesi.
Database

Cosmos DB SQL veritabanı kaynak nesnesi
ErrorResponse

Hata Yanıtı.
OperationType

Olayın işlem türünü belirtmek için sabit listesi.
Resource

Azure Cosmos DB SQL veritabanı olayının kaynağı
ResourceRestoreParameters

Geri yükleme hakkındaki bilgileri gösteren parametreler.
RestorableSqlDatabaseGetResult

Azure Cosmos DB SQL veritabanı olayı
RestorableSqlDatabasesListResult

SQL veritabanı olaylarını ve özelliklerini içeren List işlemi yanıtı.

CloudError

Hizmetten bir hata yanıtı.

Name Tür Description
error

ErrorResponse

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

CreateMode

Default

Kaynak oluşturma modunu belirtmek için sabit listesi.
id

string

Cosmos DB SQL veritabanının adı
restoreParameters

ResourceRestoreParameters

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

Database

Cosmos DB SQL veritabanı kaynak nesnesi
eventTimestamp

string

Bu veritabanı olayının gerçekleştiği zaman.
operationType

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

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

RestorableSqlDatabaseGetResult[]

SQL veritabanı olaylarının ve özelliklerinin listesi.