Restorable Sql Containers - List
Geef de gebeurtenisfeed weer van alle mutaties die zijn uitgevoerd op alle Azure Cosmos DB SQL-containers onder een specifieke database. Dit helpt bij het scenario waarin de container per ongeluk is verwijderd. Voor deze API is de machtiging Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read vereist
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}
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
instance
|
path | True |
string |
De instanceId-GUID van een restorable databaseaccount. |
location
|
path | True |
string |
Cosmos DB-regio, met spaties tussen woorden en elk woord met hoofdletters. |
subscription
|
path | True |
string minLength: 1 |
De id van het doelabonnement. |
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
end
|
query |
string |
Restorable Sql Containers event feed end time. |
|
restorable
|
query |
string |
De resource-id van de SQL-database. |
|
start
|
query |
string |
Begintijd van de gebeurtenisfeed voor restorable Sql-containers. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
De bewerking is voltooid. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
CosmosDBRestorableSqlContainerList
Voorbeeldaanvraag
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==
Voorbeeldrespons
{
"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\""
}
}
}
}
]
}
Definities
Name | Description |
---|---|
Client |
. |
Client |
Cosmos DB-clientversleutelingsbeleid. |
Cloud |
Een foutreactie van de service. |
Composite |
|
Composite |
Sorteervolgorde voor samengestelde paden. |
Computed |
De definitie van een berekende eigenschap |
Conflict |
Geeft de conflictoplossingsmodus aan. |
Conflict |
Het conflictoplossingsbeleid voor de container. |
Container |
Cosmos DB SQL-containerresourceobject |
Container |
De configuratie van de partitiesleutel die moet worden gebruikt voor het partitioneren van gegevens in meerdere partities |
Create |
Opsomming om de modus voor het maken van accounts aan te geven. |
Data |
Het gegevenstype waarop het indexeringsgedrag wordt toegepast. |
Distance |
De afstandsfunctie die moet worden gebruikt voor de berekening van de afstand tussen vectoren. |
Error |
Foutreactie. |
Excluded |
|
Included |
De paden die zijn opgenomen in indexering |
Indexes |
De indexen voor het pad. |
Indexing |
Geeft de indexeringsmodus aan. |
Indexing |
Indexeringsbeleid van Cosmos DB |
Index |
Geeft het type index aan. |
Operation |
Opsomming om het bewerkingstype van de gebeurtenis aan te geven. |
Partition |
Geeft het type algoritme aan dat wordt gebruikt voor partitionering. Voor MultiHash worden meerdere partitiesleutels (maximaal drie maximum) ondersteund voor het maken van containers |
Resource |
De resource van een Azure Cosmos DB SQL-container gebeurtenis |
Resource |
Parameters om de informatie over de herstelbewerking aan te geven. |
Restorable |
Een Azure Cosmos DB SQL-container gebeurtenis |
Restorable |
Het antwoord van de lijstbewerking, die de SQL-container gebeurtenissen en de bijbehorende eigenschappen bevat. |
Spatial |
|
Spatial |
Geeft het ruimtelijke type index aan. |
Unique |
De unieke sleutel voor die beperking voor uniekheid afdwingt voor documenten in de verzameling in de Azure Cosmos DB-service. |
Unique |
De configuratie van het unieke sleutelbeleid voor het opgeven van beperkingen voor uniekheid voor documenten in de verzameling in de Azure Cosmos DB-service. |
Vector |
Geeft het gegevenstype van vector aan. |
Vector |
Vertegenwoordigt een vector insluiten. Een vector insluiten wordt gebruikt om een vectorveld in de documenten te definiëren. |
Vector |
Cosmos DB Vector Embedding-beleid |
Vector |
|
Vector |
Het indextype van de vector. Momenteel worden flat, diskANN en quantizedFlat ondersteund. |
ClientEncryptionIncludedPath
.
Name | Type | Description |
---|---|---|
clientEncryptionKeyId |
string |
De id van de clientversleutelingssleutel die moet worden gebruikt om het pad te versleutelen. |
encryptionAlgorithm |
string |
Het versleutelingsalgoritmen dat wordt gebruikt. Bijvoorbeeld- AEAD_AES_256_CBC_HMAC_SHA256. |
encryptionType |
string |
Het type versleuteling dat moet worden uitgevoerd. Bijvoorbeeld: deterministisch, gerandomiseerd. |
path |
string |
Pad dat moet worden versleuteld. |
ClientEncryptionPolicy
Cosmos DB-clientversleutelingsbeleid.
Name | Type | Description |
---|---|---|
includedPaths |
Paden van het item dat versleuteling nodig heeft, samen met padspecifieke instellingen. |
|
policyFormatVersion |
integer (int32) minimum: 1maximum: 2 |
Versie van de definitie van het clientversleutelingsbeleid. Ondersteunde versies zijn 1 en 2. Versie 2 ondersteunt versleuteling van id- en partitiesleutelpaden. |
CloudError
Een foutreactie van de service.
Name | Type | Description |
---|---|---|
error |
Foutreactie. |
CompositePath
Name | Type | Description |
---|---|---|
order |
Sorteervolgorde voor samengestelde paden. |
|
path |
string |
Het pad waarop het indexeringsgedrag van toepassing is. Indexpaden beginnen meestal met de hoofdmap en eindigen met jokertekens (/pad/*) |
CompositePathSortOrder
Sorteervolgorde voor samengestelde paden.
Waarde | Description |
---|---|
ascending | |
descending |
ComputedProperty
De definitie van een berekende eigenschap
Name | Type | Description |
---|---|---|
name |
string |
De naam van een berekende eigenschap, bijvoorbeeld 'cp_lowerName' |
query |
string |
De query waarmee de waarde voor de berekende eigenschap wordt geëvalueerd, bijvoorbeeld 'SELECT VALUE LOWER(c.name) FROM c' |
ConflictResolutionMode
Geeft de conflictoplossingsmodus aan.
Waarde | Description |
---|---|
Custom | |
LastWriterWins |
ConflictResolutionPolicy
Het conflictoplossingsbeleid voor de container.
Name | Type | Default value | Description |
---|---|---|---|
conflictResolutionPath |
string |
Het pad naar conflictoplossing in het geval van de LastWriterWins-modus. |
|
conflictResolutionProcedure |
string |
De procedure voor het oplossen van conflicten in het geval van aangepaste modus. |
|
mode | LastWriterWins |
Geeft de conflictoplossingsmodus aan. |
Container
Cosmos DB SQL-containerresourceobject
Name | Type | Default value | Description |
---|---|---|---|
_etag |
string |
Een door het systeem gegenereerde eigenschap die de resource-etag vertegenwoordigt die is vereist voor optimistisch gelijktijdigheidsbeheer. |
|
_rid |
string |
Een door het systeem gegenereerde eigenschap. Een unieke id. |
|
_self |
string |
Een door het systeem gegenereerde eigenschap die het adresseerbare pad van de containerresource aangeeft. |
|
_ts |
number |
Een door het systeem gegenereerde eigenschap die de laatst bijgewerkte tijdstempel van de resource aangeeft. |
|
analyticalStorageTtl |
integer (int64) |
Analytische TTL. |
|
clientEncryptionPolicy |
Het clientversleutelingsbeleid voor de container. |
||
computedProperties |
Lijst met berekende eigenschappen |
||
conflictResolutionPolicy |
Het conflictoplossingsbeleid voor de container. |
||
createMode | Default |
Opsomming om de modus voor het maken van resources aan te geven. |
|
defaultTtl |
integer |
Standaardtijd tot leven |
|
id |
string |
Naam van de Cosmos DB SQL-container |
|
indexingPolicy |
De configuratie van het indexeringsbeleid. De indexering is standaard automatisch voor alle documentpaden in de container |
||
partitionKey |
De configuratie van de partitiesleutel die moet worden gebruikt voor het partitioneren van gegevens in meerdere partities |
||
restoreParameters |
Parameters om de informatie over de herstelbewerking aan te geven |
||
uniqueKeyPolicy |
De configuratie van het unieke sleutelbeleid voor het opgeven van beperkingen voor uniekheid voor documenten in de verzameling in de Azure Cosmos DB-service. |
||
vectorEmbeddingPolicy |
Het beleid voor het insluiten van vectoren voor de container. |
ContainerPartitionKey
De configuratie van de partitiesleutel die moet worden gebruikt voor het partitioneren van gegevens in meerdere partities
Name | Type | Default value | Description |
---|---|---|---|
kind | Hash |
Geeft het type algoritme aan dat wordt gebruikt voor partitionering. Voor MultiHash worden meerdere partitiesleutels (maximaal drie maximum) ondersteund voor het maken van containers |
|
paths |
string[] |
Lijst met paden waarmee gegevens in de container kunnen worden gepartitioneerd |
|
systemKey |
boolean |
Geeft aan of de container een door het systeem gegenereerde partitiesleutel gebruikt |
|
version |
integer (int32) minimum: 1maximum: 2 |
Geeft de versie van de definitie van de partitiesleutel aan |
CreateMode
Opsomming om de modus voor het maken van accounts aan te geven.
Waarde | Description |
---|---|
Default | |
Restore |
DataType
Het gegevenstype waarop het indexeringsgedrag wordt toegepast.
Waarde | Description |
---|---|
LineString | |
MultiPolygon | |
Number | |
Point | |
Polygon | |
String |
DistanceFunction
De afstandsfunctie die moet worden gebruikt voor de berekening van de afstand tussen vectoren.
Waarde | Description |
---|---|
cosine | |
dotproduct | |
euclidean |
ErrorResponse
Foutreactie.
Name | Type | Description |
---|---|---|
code |
string |
Foutcode. |
message |
string |
Foutbericht dat aangeeft waarom de bewerking is mislukt. |
ExcludedPath
Name | Type | Description |
---|---|---|
path |
string |
Het pad waarop het indexeringsgedrag van toepassing is. Indexpaden beginnen meestal met de hoofdmap en eindigen met jokertekens (/pad/*) |
IncludedPath
De paden die zijn opgenomen in indexering
Name | Type | Description |
---|---|---|
indexes |
Indexes[] |
Lijst met indexen voor dit pad |
path |
string |
Het pad waarop het indexeringsgedrag van toepassing is. Indexpaden beginnen meestal met de hoofdmap en eindigen met jokertekens (/pad/*) |
Indexes
De indexen voor het pad.
Name | Type | Default value | Description |
---|---|---|---|
dataType | String |
Het gegevenstype waarop het indexeringsgedrag wordt toegepast. |
|
kind | Hash |
Geeft het type index aan. |
|
precision |
integer |
De precisie van de index. -1 is maximale precisie. |
IndexingMode
Geeft de indexeringsmodus aan.
Waarde | Description |
---|---|
consistent | |
lazy | |
none |
IndexingPolicy
Indexeringsbeleid van Cosmos DB
Name | Type | Default value | Description |
---|---|---|---|
automatic |
boolean |
Geeft aan of het indexeringsbeleid automatisch is |
|
compositeIndexes |
Lijst met samengestelde padlijst |
||
excludedPaths |
Lijst met paden die moeten worden uitgesloten van indexering |
||
includedPaths |
Lijst met paden die moeten worden opgenomen in de indexering |
||
indexingMode | consistent |
Geeft de indexeringsmodus aan. |
|
spatialIndexes |
Lijst met ruimtelijke gegevens |
||
vectorIndexes |
Lijst met paden die moeten worden opgenomen in de vectorindexering |
IndexKind
Geeft het type index aan.
Waarde | Description |
---|---|
Hash | |
Range | |
Spatial |
OperationType
Opsomming om het bewerkingstype van de gebeurtenis aan te geven.
Waarde | Description |
---|---|
Create | |
Delete | |
Recreate | |
Replace | |
SystemOperation |
PartitionKind
Geeft het type algoritme aan dat wordt gebruikt voor partitionering. Voor MultiHash worden meerdere partitiesleutels (maximaal drie maximum) ondersteund voor het maken van containers
Waarde | Description |
---|---|
Hash | |
MultiHash | |
Range |
Resource
De resource van een Azure Cosmos DB SQL-container gebeurtenis
Name | Type | Description |
---|---|---|
_rid |
string |
Een door het systeem gegenereerde eigenschap. Een unieke id. |
canUndelete |
string |
Een status van deze container om te bepalen of deze container in hetzelfde account kan worden geplaatst. |
canUndeleteReason |
string |
De reden waarom deze container niet kan worden hersteld in hetzelfde account. |
container |
Cosmos DB SQL-containerresourceobject |
|
eventTimestamp |
string |
De gebeurtenis toen deze container is opgetreden. |
operationType |
Het bewerkingstype van deze container gebeurtenis. |
|
ownerId |
string |
De naam van deze SQL-container. |
ownerResourceId |
string |
De resource-id van deze SQL-container. |
ResourceRestoreParameters
Parameters om de informatie over de herstelbewerking aan te geven.
Name | Type | Description |
---|---|---|
restoreSource |
string |
De id van het herstelbare databaseaccount van waaruit het herstel moet worden gestart. Bijvoorbeeld: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
restoreTimestampInUtc |
string (date-time) |
Tijd waarop het account moet worden hersteld (ISO-8601-indeling). |
restoreWithTtlDisabled |
boolean |
Hiermee geeft u op of het herstelde account tijd-To-Live uitgeschakeld bij het herstellen. |
RestorableSqlContainerGetResult
Een Azure Cosmos DB SQL-container gebeurtenis
Name | Type | Description |
---|---|---|
id |
string |
De unieke resource-id van de ARM-resource. |
name |
string |
De naam van de ARM-resource. |
properties.resource |
De resource van een Azure Cosmos DB SQL-container gebeurtenis |
|
type |
string |
Het type Azure-resource. |
RestorableSqlContainersListResult
Het antwoord van de lijstbewerking, die de SQL-container gebeurtenissen en de bijbehorende eigenschappen bevat.
Name | Type | Description |
---|---|---|
value |
Lijst met SQL-containerevenementen en de bijbehorende eigenschappen. |
SpatialSpec
Name | Type | Description |
---|---|---|
path |
string |
Het pad waarop het indexeringsgedrag van toepassing is. Indexpaden beginnen meestal met de hoofdmap en eindigen met jokertekens (/pad/*) |
types |
Lijst met het ruimtelijke type pad |
SpatialType
Geeft het ruimtelijke type index aan.
Waarde | Description |
---|---|
LineString | |
MultiPolygon | |
Point | |
Polygon |
UniqueKey
De unieke sleutel voor die beperking voor uniekheid afdwingt voor documenten in de verzameling in de Azure Cosmos DB-service.
Name | Type | Description |
---|---|---|
paths |
string[] |
Lijst met paden moet uniek zijn voor elk document in de Azure Cosmos DB-service |
UniqueKeyPolicy
De configuratie van het unieke sleutelbeleid voor het opgeven van beperkingen voor uniekheid voor documenten in de verzameling in de Azure Cosmos DB-service.
Name | Type | Description |
---|---|---|
uniqueKeys |
Lijst met unieke sleutels waarmee een beperking voor uniekheid wordt afgedwongen voor documenten in de verzameling in de Azure Cosmos DB-service. |
VectorDataType
Geeft het gegevenstype van vector aan.
Waarde | Description |
---|---|
float32 | |
int8 | |
uint8 |
VectorEmbedding
Vertegenwoordigt een vector insluiten. Een vector insluiten wordt gebruikt om een vectorveld in de documenten te definiëren.
Name | Type | Description |
---|---|---|
dataType |
Geeft het gegevenstype van vector aan. |
|
dimensions |
integer (int32) |
Het aantal dimensies in de vector. |
distanceFunction |
De afstandsfunctie die moet worden gebruikt voor de berekening van de afstand tussen vectoren. |
|
path |
string |
Het pad naar het vectorveld in het document. |
VectorEmbeddingPolicy
Cosmos DB Vector Embedding-beleid
Name | Type | Description |
---|---|---|
vectorEmbeddings |
Lijst met vector insluitingen |
VectorIndex
Name | Type | Description |
---|---|---|
path |
string |
Het pad naar het vectorveld in het document. |
type |
Het indextype van de vector. Momenteel worden flat, diskANN en quantizedFlat ondersteund. |
VectorIndexType
Het indextype van de vector. Momenteel worden flat, diskANN en quantizedFlat ondersteund.
Waarde | Description |
---|---|
diskANN | |
flat | |
quantizedFlat |