Restorable Sql Containers - List
Zobrazte kanál událostí všech mutací provedených ve všech kontejnerech SQL služby Azure Cosmos DB v konkrétní databázi. To pomáhá ve scénáři, kdy se kontejner omylem odstranil. 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}/restorableSqlContainers?api-version=2024-11-15
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlContainers?api-version=2024-11-15&restorableSqlDatabaseRid={restorableSqlDatabaseRid}&startTime={startTime}&endTime={endTime}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
instance
|
path | True |
string |
Identifikátor GUID instanceId 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 |
subscription
|
path | True |
string minLength: 1 |
ID cílového předplatného. |
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
end
|
query |
string |
Doba ukončení kanálu událostí obnovitelného kontejneru Sql |
|
restorable
|
query |
string |
ID prostředku databáze SQL. |
|
start
|
query |
string |
Čas spuštění kanálu událostí obnovitelného kontejneru Sql |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Operace byla úspěšně dokončena. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Azure Active Directory OAuth2 Flow
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
CosmosDBRestorableSqlContainerList
Ukázkový požadavek
GET https://management.azure.com/subscriptions/subid/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableSqlContainers?api-version=2024-11-15&restorableSqlDatabaseRid=3fu-hg==
Ukázková odpověď
{
"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\""
}
}
}
}
]
}
Definice
Name | Description |
---|---|
Client |
. |
Client |
Zásady šifrování klienta Cosmos DB |
Cloud |
Chybová odpověď ze služby. |
Composite |
|
Composite |
Pořadí řazení složených cest |
Computed |
Definice vypočítané vlastnosti |
Conflict |
Označuje režim řešení konfliktů. |
Conflict |
Zásady řešení konfliktů pro kontejner. |
Container |
Objekt prostředku kontejneru SQL služby Cosmos DB |
Container |
Konfigurace klíče oddílu, který se má použít k dělení dat do více oddílů |
Create |
Výčet označující režim vytváření účtu. |
Data |
Datový typ, na který se používá chování indexování. |
Distance |
Funkce vzdálenosti, která se má použít pro výpočet vzdálenosti mezi vektory. |
Error |
Chybová odpověď. |
Excluded |
|
Included |
Cesty, které jsou součástí indexování |
Indexes |
Indexy pro cestu. |
Indexing |
Označuje režim indexování. |
Indexing |
Zásady indexování služby Cosmos DB |
Index |
Určuje typ indexu. |
Operation |
Výčet označující typ operace události. |
Partition |
Označuje typ algoritmu, který se používá k dělení. V případě multiHash se pro vytvoření kontejneru podporuje více klíčů oddílů (maximálně tři). |
Resource |
Prostředek události kontejneru SQL služby Azure Cosmos DB |
Resource |
Parametry označující informace o obnovení |
Restorable |
Událost kontejneru SQL služby Azure Cosmos DB |
Restorable |
Odpověď operace List, která obsahuje události kontejneru SQL a jejich vlastnosti. |
Spatial |
|
Spatial |
Označuje prostorový typ indexu. |
Unique |
Jedinečný klíč, který vynucuje omezení jedinečnosti u dokumentů v kolekci ve službě Azure Cosmos DB. |
Unique |
Konfigurace zásad jedinečného klíče pro určení omezení jedinečnosti dokumentů v kolekci ve službě Azure Cosmos DB. |
Vector |
Označuje datový typ vektoru. |
Vector |
Představuje vektorové vkládání. Vektorové vkládání se používá k definování vektorového pole v dokumentech. |
Vector |
Zásady vkládání vektorů ve službě Cosmos DB |
Vector |
|
Vector |
Typ indexu vektoru. V současné době se podporují ploché, diskANN a quantizedFlat. |
ClientEncryptionIncludedPath
.
Name | Typ | Description |
---|---|---|
clientEncryptionKeyId |
string |
Identifikátor šifrovacího klíče klienta, který se má použít k šifrování cesty. |
encryptionAlgorithm |
string |
Šifrovací algoritmus, který se použije. Např - AEAD_AES_256_CBC_HMAC_SHA256. |
encryptionType |
string |
Typ šifrování, který se má provést. Např - deterministický, randomizovaný. |
path |
string |
Cesta, která musí být šifrovaná. |
ClientEncryptionPolicy
Zásady šifrování klienta Cosmos DB
Name | Typ | Description |
---|---|---|
includedPaths |
Cesty položky, které potřebují šifrování, spolu s nastavením specifickými pro cestu. |
|
policyFormatVersion |
integer (int32) minimum: 1maximum: 2 |
Verze definice zásad šifrování klienta Podporované verze jsou 1 a 2. Verze 2 podporuje šifrování cesty id a klíče oddílu. |
CloudError
Chybová odpověď ze služby.
Name | Typ | Description |
---|---|---|
error |
Chybová odpověď. |
CompositePath
Name | Typ | Description |
---|---|---|
order |
Pořadí řazení složených cest |
|
path |
string |
Cesta, na kterou se chování indexování vztahuje. Cesty indexu obvykle začínají kořenem a končí zástupným znakem (/path/*) |
CompositePathSortOrder
Pořadí řazení složených cest
Hodnota | Description |
---|---|
ascending | |
descending |
ComputedProperty
Definice vypočítané vlastnosti
Name | Typ | Description |
---|---|---|
name |
string |
Název počítané vlastnosti, například cp_lowerName |
query |
string |
Dotaz, který vyhodnotí hodnotu pro vypočítanou vlastnost, například – SELECT VALUE LOWER(c.name) FROM c |
ConflictResolutionMode
Označuje režim řešení konfliktů.
Hodnota | Description |
---|---|
Custom | |
LastWriterWins |
ConflictResolutionPolicy
Zásady řešení konfliktů pro kontejner.
Name | Typ | Default value | Description |
---|---|---|---|
conflictResolutionPath |
string |
Cesta řešení konfliktů v případě režimu LastWriterWins. |
|
conflictResolutionProcedure |
string |
Postup řešení konfliktů v případě vlastního režimu. |
|
mode | LastWriterWins |
Označuje režim řešení konfliktů. |
Container
Objekt prostředku kontejneru SQL služby Cosmos DB
Name | Typ | Default value | Description |
---|---|---|---|
_etag |
string |
Systém vygenerovaná vlastnost představující značku etag prostředku vyžadovanou pro optimistické řízení souběžnosti. |
|
_rid |
string |
Systém vygeneroval vlastnost. Jedinečný identifikátor. |
|
_self |
string |
Systém vygenerovaná vlastnost, která určuje adresovatelnou cestu prostředku kontejneru. |
|
_ts |
number |
Systém vygenerovaná vlastnost, která označuje časové razítko poslední aktualizace prostředku. |
|
analyticalStorageTtl |
integer (int64) |
Hodnota TTL analytického úložiště. |
|
clientEncryptionPolicy |
Zásady šifrování klienta pro kontejner. |
||
computedProperties |
Seznam vypočítaných vlastností |
||
conflictResolutionPolicy |
Zásady řešení konfliktů pro kontejner. |
||
createMode | Default |
Výčet označující režim vytváření prostředků. |
|
defaultTtl |
integer |
Výchozí čas k živému provozu |
|
id |
string |
Název kontejneru SQL služby Cosmos DB |
|
indexingPolicy |
Konfigurace zásad indexování Ve výchozím nastavení je indexování automatické pro všechny cesty k dokumentům v rámci kontejneru. |
||
partitionKey |
Konfigurace klíče oddílu, který se má použít k dělení dat do více oddílů |
||
restoreParameters |
Parametry označující informace o obnovení |
||
uniqueKeyPolicy |
Konfigurace zásad jedinečného klíče pro určení omezení jedinečnosti dokumentů v kolekci ve službě Azure Cosmos DB. |
||
vectorEmbeddingPolicy |
Zásada vkládání vektorů pro kontejner. |
ContainerPartitionKey
Konfigurace klíče oddílu, který se má použít k dělení dat do více oddílů
Name | Typ | Default value | Description |
---|---|---|---|
kind | Hash |
Označuje typ algoritmu, který se používá k dělení. V případě multiHash se pro vytvoření kontejneru podporuje více klíčů oddílů (maximálně tři). |
|
paths |
string[] |
Seznam cest, pomocí kterých je možné rozdělit data v rámci kontejneru |
|
systemKey |
boolean |
Označuje, jestli kontejner používá systémový vygenerovaný klíč oddílu. |
|
version |
integer (int32) minimum: 1maximum: 2 |
Označuje verzi definice klíče oddílu. |
CreateMode
Výčet označující režim vytváření účtu.
Hodnota | Description |
---|---|
Default | |
Restore |
DataType
Datový typ, na který se používá chování indexování.
Hodnota | Description |
---|---|
LineString | |
MultiPolygon | |
Number | |
Point | |
Polygon | |
String |
DistanceFunction
Funkce vzdálenosti, která se má použít pro výpočet vzdálenosti mezi vektory.
Hodnota | Description |
---|---|
cosine | |
dotproduct | |
euclidean |
ErrorResponse
Chybová odpověď.
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
message |
string |
Chybová zpráva označující, proč operace selhala. |
ExcludedPath
Name | Typ | Description |
---|---|---|
path |
string |
Cesta, na kterou se chování indexování vztahuje. Cesty indexu obvykle začínají kořenem a končí zástupným znakem (/path/*) |
IncludedPath
Cesty, které jsou součástí indexování
Name | Typ | Description |
---|---|---|
indexes |
Indexes[] |
Seznam indexů pro tuto cestu |
path |
string |
Cesta, na kterou se chování indexování vztahuje. Cesty indexu obvykle začínají kořenem a končí zástupným znakem (/path/*) |
Indexes
Indexy pro cestu.
Name | Typ | Default value | Description |
---|---|---|---|
dataType | String |
Datový typ, na který se používá chování indexování. |
|
kind | Hash |
Určuje typ indexu. |
|
precision |
integer |
Přesnost indexu. -1 je maximální přesnost. |
IndexingMode
Označuje režim indexování.
Hodnota | Description |
---|---|
consistent | |
lazy | |
none |
IndexingPolicy
Zásady indexování služby Cosmos DB
Name | Typ | Default value | Description |
---|---|---|---|
automatic |
boolean |
Označuje, jestli je zásada indexování automatická. |
|
compositeIndexes |
Seznam složených cest |
||
excludedPaths |
Seznam cest, které se mají vyloučit z indexování |
||
includedPaths |
Seznam cest, které se mají zahrnout do indexování |
||
indexingMode | consistent |
Označuje režim indexování. |
|
spatialIndexes |
Seznam prostorových specifik |
||
vectorIndexes |
Seznam cest, které se mají zahrnout do indexování vektorů |
IndexKind
Určuje typ indexu.
Hodnota | Description |
---|---|
Hash | |
Range | |
Spatial |
OperationType
Výčet označující typ operace události.
Hodnota | Description |
---|---|
Create | |
Delete | |
Recreate | |
Replace | |
SystemOperation |
PartitionKind
Označuje typ algoritmu, který se používá k dělení. V případě multiHash se pro vytvoření kontejneru podporuje více klíčů oddílů (maximálně tři).
Hodnota | Description |
---|---|
Hash | |
MultiHash | |
Range |
Resource
Prostředek události kontejneru SQL služby Azure Cosmos DB
Name | Typ | Description |
---|---|---|
_rid |
string |
Systém vygeneroval vlastnost. Jedinečný identifikátor. |
canUndelete |
string |
Stav tohoto kontejneru, který identifikuje, jestli se tento kontejner dá obnovit ve stejném účtu. |
canUndeleteReason |
string |
Důvod, proč se tento kontejner nedá obnovit ve stejném účtu. |
container |
Objekt prostředku kontejneru SQL služby Cosmos DB |
|
eventTimestamp |
string |
Kdy k této události kontejneru došlo. |
operationType |
Typ operace této události kontejneru. |
|
ownerId |
string |
Název tohoto kontejneru SQL. |
ownerResourceId |
string |
ID prostředku tohoto kontejneru SQL. |
ResourceRestoreParameters
Parametry označující informace o obnovení
Name | Typ | Description |
---|---|---|
restoreSource |
string |
ID obnovovatelného databázového účtu, ze kterého se má obnovení zahájit. Příklad: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
restoreTimestampInUtc |
string (date-time) |
Čas obnovení účtu (formát ISO-8601) |
restoreWithTtlDisabled |
boolean |
Určuje, jestli obnovený účet bude mít po úspěšném obnovení zakázaný časovýTo-Live. |
RestorableSqlContainerGetResult
Událost kontejneru SQL služby Azure Cosmos DB
Name | Typ | Description |
---|---|---|
id |
string |
Jedinečný identifikátor prostředku ARM. |
name |
string |
Název prostředku ARM. |
properties.resource |
Prostředek události kontejneru SQL služby Azure Cosmos DB |
|
type |
string |
Typ prostředku Azure. |
RestorableSqlContainersListResult
Odpověď operace List, která obsahuje události kontejneru SQL a jejich vlastnosti.
Name | Typ | Description |
---|---|---|
value |
Seznam událostí kontejneru SQL a jejich vlastností |
SpatialSpec
Name | Typ | Description |
---|---|---|
path |
string |
Cesta, na kterou se chování indexování vztahuje. Cesty indexu obvykle začínají kořenem a končí zástupným znakem (/path/*) |
types |
Seznam prostorového typu cesty |
SpatialType
Označuje prostorový typ indexu.
Hodnota | Description |
---|---|
LineString | |
MultiPolygon | |
Point | |
Polygon |
UniqueKey
Jedinečný klíč, který vynucuje omezení jedinečnosti u dokumentů v kolekci ve službě Azure Cosmos DB.
Name | Typ | Description |
---|---|---|
paths |
string[] |
Seznam cest musí být pro každý dokument ve službě Azure Cosmos DB jedinečný. |
UniqueKeyPolicy
Konfigurace zásad jedinečného klíče pro určení omezení jedinečnosti dokumentů v kolekci ve službě Azure Cosmos DB.
Name | Typ | Description |
---|---|---|
uniqueKeys |
Seznam jedinečných klíčů, které vynucují omezení jedinečnosti u dokumentů v kolekci ve službě Azure Cosmos DB |
VectorDataType
Označuje datový typ vektoru.
Hodnota | Description |
---|---|
float32 | |
int8 | |
uint8 |
VectorEmbedding
Představuje vektorové vkládání. Vektorové vkládání se používá k definování vektorového pole v dokumentech.
Name | Typ | Description |
---|---|---|
dataType |
Označuje datový typ vektoru. |
|
dimensions |
integer (int32) |
Počet dimenzí ve vektoru. |
distanceFunction |
Funkce vzdálenosti, která se má použít pro výpočet vzdálenosti mezi vektory. |
|
path |
string |
Cesta k vektorovém poli v dokumentu. |
VectorEmbeddingPolicy
Zásady vkládání vektorů ve službě Cosmos DB
Name | Typ | Description |
---|---|---|
vectorEmbeddings |
Seznam vektorových vkládání |
VectorIndex
Name | Typ | Description |
---|---|---|
path |
string |
Cesta k vektorovém poli v dokumentu. |
type |
Typ indexu vektoru. V současné době se podporují ploché, diskANN a quantizedFlat. |
VectorIndexType
Typ indexu vektoru. V současné době se podporují ploché, diskANN a quantizedFlat.
Hodnota | Description |
---|---|
diskANN | |
flat | |
quantizedFlat |