Restorable Sql Containers - List
Belirli bir veritabanı altındaki tüm Azure Cosmos DB SQL kapsayıcılarında yapılan tüm mutasyonların olay akışını gösterin. Bu, kapsayıcı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}/restorableSqlContainers?api-version=2023-11-15
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlContainers?api-version=2023-11-15&restorableSqlDatabaseRid={restorableSqlDatabaseRid}&startTime={startTime}&endTime={endTime}
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ü. |
end
|
query |
string |
Geri yüklenebilen Sql kapsayıcıları olay akışı bitiş zamanı. |
|
restorable
|
query |
string |
SQL veritabanının kaynak kimliği. |
|
start
|
query |
string |
Geri yüklenebilen Sql kapsayıcıları olay akışı başlangıç zamanı. |
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
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Kullanıcı hesabınızın kimliğine bürünme |
Örnekler
CosmosDBRestorableSqlContainerList
Sample Request
GET https://management.azure.com/subscriptions/subid/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableSqlContainers?api-version=2023-11-15&restorableSqlDatabaseRid=3fu-hg==
Sample Response
{
"value": [
{
"id": "/subscriptions/subid/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableSqlContainers/79609a98-3394-41f8-911f-cfab0c075c86",
"type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableSqlContainers",
"name": "79609a98-3394-41f8-911f-cfab0c075c86",
"properties": {
"resource": {
"_rid": "zAyAPQAAAA==",
"eventTimestamp": "2020-10-13T04:56:42Z",
"ownerId": "Container1",
"ownerResourceId": "V18LoLrv-qA=",
"operationType": "Create",
"canUndelete": "invalid",
"container": {
"id": "Container1",
"indexingPolicy": {
"indexingMode": "consistent",
"automatic": true,
"includedPaths": [
{
"path": "/*"
},
{
"path": "/\"_ts\"/?"
}
],
"excludedPaths": [
{
"path": "/\"_etag\"/?"
}
]
},
"conflictResolutionPolicy": {
"mode": "LastWriterWins",
"conflictResolutionPath": "/_ts",
"conflictResolutionProcedure": ""
},
"_rid": "V18LoLrv-qA=",
"_self": "dbs/V18LoA==/colls/V18LoLrv-qA=/",
"_etag": "\"00003e00-0000-0700-0000-5f85338a0000\""
}
}
}
},
{
"id": "/subscriptions/subid/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableSqlContainers/e85298a1-c631-4726-825e-a7ca092e9098",
"type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableSqlContainers",
"name": "e85298a1-c631-4726-825e-a7ca092e9098",
"properties": {
"resource": {
"_rid": "PrArcgAAAA==",
"eventTimestamp": "2020-10-13T05:03:27Z",
"ownerId": "Container1",
"ownerResourceId": "V18LoLrv-qA=",
"operationType": "Replace",
"canUndelete": "invalid",
"container": {
"id": "Container1",
"indexingPolicy": {
"indexingMode": "consistent",
"automatic": true,
"includedPaths": [
{
"path": "/*"
},
{
"path": "/\"_ts\"/?"
}
],
"excludedPaths": [
{
"path": "/\"_etag\"/?"
}
]
},
"defaultTtl": 12345,
"conflictResolutionPolicy": {
"mode": "LastWriterWins",
"conflictResolutionPath": "/_ts",
"conflictResolutionProcedure": ""
},
"_rid": "V18LoLrv-qA=",
"_self": "dbs/V18LoA==/colls/V18LoLrv-qA=/",
"_etag": "\"00004400-0000-0700-0000-5f85351f0000\""
}
}
}
}
]
}
Tanımlar
Name | Description |
---|---|
Client |
. |
Client |
Cosmos DB istemci şifreleme ilkesi. |
Cloud |
Hizmetten bir hata yanıtı. |
Composite |
|
Composite |
Bileşik yollar için sıralama düzeni. |
Computed |
Hesaplanan özelliğin tanımı |
Conflict |
Çakışma çözümleme modunu gösterir. |
Conflict |
Kapsayıcı için çakışma çözümleme ilkesi. |
Container |
Cosmos DB SQL kapsayıcı kaynak nesnesi |
Container |
Verileri birden çok bölüme bölmek için kullanılacak bölüm anahtarının yapılandırması |
Create |
Hesap oluşturma modunu belirtmek için sabit listesi. |
Data |
Dizin oluşturma davranışının uygulandığı veri türü. |
Error |
Hata Yanıtı. |
Excluded |
|
Included |
Dizin oluşturmada yer alan yollar |
Indexes |
Yol için dizinler. |
Indexing |
Dizin oluşturma modunu gösterir. |
Indexing |
Cosmos DB dizin oluşturma ilkesi |
Index |
Dizinin türünü gösterir. |
Operation |
Olayın işlem türünü belirtmek için sabit listesi. |
Partition |
Bölümleme için kullanılan algoritma türünü gösterir. MultiHash için kapsayıcı oluşturma için birden çok bölüm anahtarı (en fazla üç bölüm anahtarı) desteklenir |
Resource |
Azure Cosmos DB SQL kapsayıcı olayının kaynağı |
Resource |
Geri yükleme hakkındaki bilgileri gösteren parametreler. |
Restorable |
Azure Cosmos DB SQL kapsayıcı olayı |
Restorable |
SQL kapsayıcı olaylarını ve bunların özelliklerini içeren List işlemi yanıtı. |
Spatial |
|
Spatial |
Dizinin uzamsal türünü gösterir. |
Unique |
Üzerindeki benzersiz anahtar, Azure Cosmos DB hizmetindeki koleksiyondaki belgeler üzerinde benzersizlik kısıtlaması uygular. |
Unique |
Azure Cosmos DB hizmetindeki koleksiyondaki belgelerde benzersizlik kısıtlamalarını belirtmek için benzersiz anahtar ilkesi yapılandırması. |
ClientEncryptionIncludedPath
.
Name | Tür | Description |
---|---|---|
clientEncryptionKeyId |
string |
Yolu şifrelemek için kullanılacak İstemci Şifreleme Anahtarının tanımlayıcısı. |
encryptionAlgorithm |
string |
Kullanılacak şifreleme algoritması. Örneğin- AEAD_AES_256_CBC_HMAC_SHA256. |
encryptionType |
string |
Gerçekleştirilecek şifreleme türü. Örneğin- Deterministik, Rastgele. |
path |
string |
Şifrelenmesi gereken yol. |
ClientEncryptionPolicy
Cosmos DB istemci şifreleme ilkesi.
Name | Tür | Description |
---|---|---|
includedPaths |
Yola özgü ayarlarla birlikte şifreleme gerektiren öğenin yolları. |
|
policyFormatVersion |
integer |
İstemci şifreleme ilkesi tanımının sürümü. Desteklenen sürümler 1 ve 2'dir. Sürüm 2, kimlik ve bölüm anahtarı yolu şifrelemeyi destekler. |
CloudError
Hizmetten bir hata yanıtı.
Name | Tür | Description |
---|---|---|
error |
Hata Yanıtı. |
CompositePath
Name | Tür | Description |
---|---|---|
order |
Bileşik yollar için sıralama düzeni. |
|
path |
string |
Dizin oluşturma davranışının uygulandığı yol. Dizin yolları genellikle kök ile başlar ve joker karakterle biter (/path/*) |
CompositePathSortOrder
Bileşik yollar için sıralama düzeni.
Name | Tür | Description |
---|---|---|
ascending |
string |
|
descending |
string |
ComputedProperty
Hesaplanan özelliğin tanımı
Name | Tür | Description |
---|---|---|
name |
string |
Hesaplanan özelliğin adı, örneğin - "cp_lowerName" |
query |
string |
Hesaplanan özelliğin değerini değerlendiren sorgu, örneğin: "SELECT VALUE LOWER(c.name) FROM c" |
ConflictResolutionMode
Çakışma çözümleme modunu gösterir.
Name | Tür | Description |
---|---|---|
Custom |
string |
|
LastWriterWins |
string |
ConflictResolutionPolicy
Kapsayıcı için çakışma çözümleme ilkesi.
Name | Tür | Varsayılan değer | Description |
---|---|---|---|
conflictResolutionPath |
string |
LastWriterWins modunda çakışma çözümleme yolu. |
|
conflictResolutionProcedure |
string |
Özel mod durumunda çakışmaları çözümleme yordamı. |
|
mode | LastWriterWins |
Çakışma çözümleme modunu gösterir. |
Container
Cosmos DB SQL kapsayıcı kaynak nesnesi
Name | Tür | Varsayılan değer | Description |
---|---|---|---|
_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 |
Kapsayıcı 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. |
|
analyticalStorageTtl |
integer |
Analitik TTL. |
|
clientEncryptionPolicy |
Kapsayıcı için istemci şifreleme ilkesi. |
||
computedProperties |
Hesaplanan özelliklerin listesi |
||
conflictResolutionPolicy |
Kapsayıcı için çakışma çözümleme ilkesi. |
||
createMode | Default |
Kaynak oluşturma modunu belirtmek için sabit listesi. |
|
defaultTtl |
integer |
Varsayılan yaşam süresi |
|
id |
string |
Cosmos DB SQL kapsayıcısının adı |
|
indexingPolicy |
Dizin oluşturma ilkesinin yapılandırması. Varsayılan olarak, dizin oluşturma kapsayıcı içindeki tüm belge yolları için otomatiktir |
||
partitionKey |
Verileri birden çok bölüme bölmek için kullanılacak bölüm anahtarının yapılandırması |
||
restoreParameters |
Geri yükleme hakkındaki bilgileri gösteren parametreler |
||
uniqueKeyPolicy |
Azure Cosmos DB hizmetindeki koleksiyondaki belgelerde benzersizlik kısıtlamalarını belirtmek için benzersiz anahtar ilkesi yapılandırması. |
ContainerPartitionKey
Verileri birden çok bölüme bölmek için kullanılacak bölüm anahtarının yapılandırması
Name | Tür | Varsayılan değer | Description |
---|---|---|---|
kind | Hash |
Bölümleme için kullanılan algoritma türünü gösterir. MultiHash için kapsayıcı oluşturma için birden çok bölüm anahtarı (en fazla üç bölüm anahtarı) desteklenir |
|
paths |
string[] |
Kapsayıcı içindeki hangi verilerin bölümlenebileceğini kullanan yolların listesi |
|
systemKey |
boolean |
Kapsayıcının sistem tarafından oluşturulan bir bölüm anahtarı kullanıp kullanmadiğini gösterir |
|
version |
integer |
Bölüm anahtarı tanımının sürümünü gösterir |
CreateMode
Hesap oluşturma modunu belirtmek için sabit listesi.
Name | Tür | Description |
---|---|---|
Default |
string |
|
Restore |
string |
DataType
Dizin oluşturma davranışının uygulandığı veri türü.
Name | Tür | Description |
---|---|---|
LineString |
string |
|
MultiPolygon |
string |
|
Number |
string |
|
Point |
string |
|
Polygon |
string |
|
String |
string |
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. |
ExcludedPath
Name | Tür | Description |
---|---|---|
path |
string |
Dizin oluşturma davranışının uygulandığı yol. Dizin yolları genellikle kök ile başlar ve joker karakterle biter (/path/*) |
IncludedPath
Dizin oluşturmada yer alan yollar
Name | Tür | Description |
---|---|---|
indexes |
Indexes[] |
Bu yol için dizin listesi |
path |
string |
Dizin oluşturma davranışının uygulandığı yol. Dizin yolları genellikle kök ile başlar ve joker karakterle biter (/path/*) |
Indexes
Yol için dizinler.
Name | Tür | Varsayılan değer | Description |
---|---|---|---|
dataType | String |
Dizin oluşturma davranışının uygulandığı veri türü. |
|
kind | Hash |
Dizinin türünü gösterir. |
|
precision |
integer |
Dizinin duyarlığı. -1 maksimum duyarlıktır. |
IndexingMode
Dizin oluşturma modunu gösterir.
Name | Tür | Description |
---|---|---|
consistent |
string |
|
lazy |
string |
|
none |
string |
IndexingPolicy
Cosmos DB dizin oluşturma ilkesi
Name | Tür | Varsayılan değer | Description |
---|---|---|---|
automatic |
boolean |
Dizin oluşturma ilkesinin otomatik olup olmadığını gösterir |
|
compositeIndexes |
Bileşik yol listesi listesi |
||
excludedPaths |
Dizin oluşturmanın dışında tutulacak yolların listesi |
||
includedPaths |
Dizine eklenecek yolların listesi |
||
indexingMode | consistent |
Dizin oluşturma modunu gösterir. |
|
spatialIndexes |
Uzamsal özelliklerin listesi |
IndexKind
Dizinin türünü gösterir.
Name | Tür | Description |
---|---|---|
Hash |
string |
|
Range |
string |
|
Spatial |
string |
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 |
PartitionKind
Bölümleme için kullanılan algoritma türünü gösterir. MultiHash için kapsayıcı oluşturma için birden çok bölüm anahtarı (en fazla üç bölüm anahtarı) desteklenir
Name | Tür | Description |
---|---|---|
Hash |
string |
|
MultiHash |
string |
|
Range |
string |
Resource
Azure Cosmos DB SQL kapsayıcı olayının kaynağı
Name | Tür | Description |
---|---|---|
_rid |
string |
Sistem tarafından oluşturulan özellik. Benzersiz bir tanımlayıcı. |
canUndelete |
string |
Bu kapsayıcının aynı hesapta geri yüklenebilen olup olmadığını belirlemek için bu kapsayıcının durumu. |
canUndeleteReason |
string |
Bu kapsayıcının aynı hesapta geri yüklenememe nedeni. |
container |
Cosmos DB SQL kapsayıcı kaynak nesnesi |
|
eventTimestamp |
string |
Bu kapsayıcı olayının gerçekleştiği zaman. |
operationType |
Bu kapsayıcı olayının işlem türü. |
|
ownerId |
string |
Bu SQL kapsayıcısının adı. |
ownerResourceId |
string |
Bu SQL kapsayıcısı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). |
RestorableSqlContainerGetResult
Azure Cosmos DB SQL kapsayıcı 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 kapsayıcı olayının kaynağı |
|
type |
string |
Azure kaynağının türü. |
RestorableSqlContainersListResult
SQL kapsayıcı olaylarını ve bunların özelliklerini içeren List işlemi yanıtı.
Name | Tür | Description |
---|---|---|
value |
SQL kapsayıcısı olaylarının ve özelliklerinin listesi. |
SpatialSpec
Name | Tür | Description |
---|---|---|
path |
string |
Dizin oluşturma davranışının uygulandığı yol. Dizin yolları genellikle kök ile başlar ve joker karakterle biter (/path/*) |
types |
Yolun uzamsal türünün listesi |
SpatialType
Dizinin uzamsal türünü gösterir.
Name | Tür | Description |
---|---|---|
LineString |
string |
|
MultiPolygon |
string |
|
Point |
string |
|
Polygon |
string |
UniqueKey
Üzerindeki benzersiz anahtar, Azure Cosmos DB hizmetindeki koleksiyondaki belgeler üzerinde benzersizlik kısıtlaması uygular.
Name | Tür | Description |
---|---|---|
paths |
string[] |
Yolların listesi Azure Cosmos DB hizmetindeki her belge için benzersiz olmalıdır |
UniqueKeyPolicy
Azure Cosmos DB hizmetindeki koleksiyondaki belgelerde benzersizlik kısıtlamalarını belirtmek için benzersiz anahtar ilkesi yapılandırması.
Name | Tür | Description |
---|---|---|
uniqueKeys |
Azure Cosmos DB hizmetindeki koleksiyondaki belgelerde benzersizlik kısıtlaması uygulayan benzersiz anahtarların listesi. |