Restorable Sql Containers - List
Zobrazení informačního kanálu 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 došlo k náhodnému odstranění kontejneru. 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=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}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
instance
|
path | True |
string |
InstanceId GUID 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 |
ID cílového předplatného. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
end
|
query |
string |
Koncový čas kanálu událostí obnovitelného kontejneru SQL |
|
restorable
|
query |
string |
ID prostředku databáze SQL. |
|
start
|
query |
string |
Čas zahájení 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
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Zosobnění uživatelského účtu |
Příklady
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\""
}
}
}
}
]
}
Definice
Name | Description |
---|---|
Client |
. |
Client |
Zásady šifrování klientů služby Cosmos DB. |
Cloud |
Chybová odpověď ze služby. |
Composite |
|
Composite |
Pořadí řazení složených cest |
Computed |
Definice počí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 rozdělení dat do více oddílů |
Create |
Výčet označující režim vytváření účtu. |
Data |
Datový typ, pro který je chování indexování použito. |
Error |
Odpověď na chybu. |
Excluded |
|
Included |
Cesty zahrnuté v indexování |
Indexes |
Indexy pro cestu. |
Indexing |
Označuje režim indexování. |
Indexing |
Zásady indexování služby Cosmos DB |
Index |
Označuje typ indexu. |
Operation |
Výčtem označující typ operace události. |
Partition |
Označuje typ algoritmu použitého k dělení. Pro 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 u dokumentů v kolekci ve službě Azure Cosmos DB |
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 zašifrovaná. |
ClientEncryptionPolicy
Zásady šifrování klientů služby Cosmos DB.
Name | Typ | Description |
---|---|---|
includedPaths |
Cesty k položce, které vyžadují šifrování spolu s nastavením specifickými pro cestu. |
|
policyFormatVersion |
integer |
Verze definice zásad šifrování klienta. Podporované verze jsou 1 a 2. Verze 2 podporuje šifrování cesty pomocí id a klíče oddílu. |
CloudError
Chybová odpověď ze služby.
Name | Typ | Description |
---|---|---|
error |
Odpověď na chybu. |
CompositePath
Name | Typ | Description |
---|---|---|
order |
Pořadí řazení složených cest |
|
path |
string |
Cesta, pro 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
Name | Typ | Description |
---|---|---|
ascending |
string |
|
descending |
string |
ComputedProperty
Definice počítané vlastnosti
Name | Typ | Description |
---|---|---|
name |
string |
Název počítané vlastnosti, například "cp_lowerName" |
query |
string |
Dotaz, který vyhodnocuje hodnotu vypočítané vlastnosti, například " SELECT VALUE LOWER(c.name) FROM c" |
ConflictResolutionMode
Označuje režim řešení konfliktů.
Name | Typ | Description |
---|---|---|
Custom |
string |
|
LastWriterWins |
string |
ConflictResolutionPolicy
Zásady řešení konfliktů pro kontejner.
Name | Typ | Výchozí hodnota | 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 | Výchozí hodnota | Description |
---|---|---|---|
_etag |
string |
Systémově vygenerovaná vlastnost představující značku prostředku vyžadovanou pro řízení optimistické souběžnosti. |
|
_rid |
string |
Systém vygenerovaná vlastnost. Jedinečný identifikátor. |
|
_self |
string |
Systém generovaná vlastnost, která určuje adresovatelnou cestu k prostředku kontejneru. |
|
_ts |
number |
Systém generovaná vlastnost, která označuje poslední aktualizované časové razítko prostředku. |
|
analyticalStorageTtl |
integer |
Hodnota TTL analýzy. |
|
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í hodnota time to Live |
|
id |
string |
Název kontejneru SQL služby Cosmos DB |
|
indexingPolicy |
Konfigurace zásad indexování. Ve výchozím nastavení je indexování pro všechny cesty k dokumentům v kontejneru automatické. |
||
partitionKey |
Konfigurace klíče oddílu, který se má použít k rozdě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 u dokumentů v kolekci ve službě Azure Cosmos DB |
ContainerPartitionKey
Konfigurace klíče oddílu, který se má použít k rozdělení dat do více oddílů
Name | Typ | Výchozí hodnota | Description |
---|---|---|---|
kind | Hash |
Označuje typ algoritmu použitého k dělení. Pro 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é dělit data v kontejneru |
|
systemKey |
boolean |
Označuje, jestli kontejner používá klíč oddílu vygenerovaný systémem. |
|
version |
integer |
Označuje verzi definice klíče oddílu. |
CreateMode
Výčet označující režim vytváření účtu.
Name | Typ | Description |
---|---|---|
Default |
string |
|
Restore |
string |
DataType
Datový typ, pro který je chování indexování použito.
Name | Typ | Description |
---|---|---|
LineString |
string |
|
MultiPolygon |
string |
|
Number |
string |
|
Point |
string |
|
Polygon |
string |
|
String |
string |
ErrorResponse
Odpověď na chybu.
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, pro kterou se chování indexování vztahuje. Cesty indexu obvykle začínají kořenem a končí zástupným znakem (/path/*). |
IncludedPath
Cesty zahrnuté v indexování
Name | Typ | Description |
---|---|---|
indexes |
Indexes[] |
Seznam indexů pro tuto cestu |
path |
string |
Cesta, pro 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 | Výchozí hodnota | Description |
---|---|---|---|
dataType | String |
Datový typ, pro který je chování indexování použito. |
|
kind | Hash |
Označuje typ indexu. |
|
precision |
integer |
Přesnost indexu. -1 je maximální přesnost. |
IndexingMode
Označuje režim indexování.
Name | Typ | Description |
---|---|---|
consistent |
string |
|
lazy |
string |
|
none |
string |
IndexingPolicy
Zásady indexování služby Cosmos DB
Name | Typ | Výchozí hodnota | 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 |
IndexKind
Označuje typ indexu.
Name | Typ | Description |
---|---|---|
Hash |
string |
|
Range |
string |
|
Spatial |
string |
OperationType
Výčtem označující typ operace události.
Name | Typ | Description |
---|---|---|
Create |
string |
|
Delete |
string |
|
Recreate |
string |
|
Replace |
string |
|
SystemOperation |
string |
PartitionKind
Označuje typ algoritmu použitého k dělení. Pro MultiHash se pro vytvoření kontejneru podporuje více klíčů oddílů (maximálně tři).
Name | Typ | Description |
---|---|---|
Hash |
string |
|
MultiHash |
string |
|
Range |
string |
Resource
Prostředek události kontejneru SQL služby Azure Cosmos DB
Name | Typ | Description |
---|---|---|
_rid |
string |
Systém vygenerovaná vlastnost. Jedinečný identifikátor. |
canUndelete |
string |
Stav tohoto kontejneru k určení, jestli je tento kontejner obnovitelný ve stejném účtu. |
canUndeleteReason |
string |
Důvod, proč tento kontejner nejde obnovit ve stejném účtu. |
container |
Objekt prostředku kontejneru SQL služby Cosmos DB |
|
eventTimestamp |
string |
Kdy došlo k této události kontejneru. |
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 obnovitelného databázového účtu, ze kterého se má zahájit obnovení. Příklad: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
restoreTimestampInUtc |
string |
Čas, do kterého musí být účet obnoven (formát ISO-8601). |
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, pro 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.
Name | Typ | Description |
---|---|---|
LineString |
string |
|
MultiPolygon |
string |
|
Point |
string |
|
Polygon |
string |
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 jedinečný pro každý dokument ve službě Azure Cosmos DB. |
UniqueKeyPolicy
Konfigurace zásad jedinečného klíče pro určení omezení jedinečnosti u 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. |