Restorable Sql Containers - List
Zeigen Sie den Ereignisfeed aller Mutationen an, die für alle Azure Cosmos DB SQL-Container unter einer bestimmten Datenbank ausgeführt wurden. Dies hilft in Szenarien, in denen der Container versehentlich gelöscht wurde. Für diese API ist die Berechtigung "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read" erforderlich.
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-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
instance
|
path | True |
string |
Die instanceId-GUID eines wiederhergestellten Datenbankkontos. |
location
|
path | True |
string |
Cosmos DB-Region mit Leerzeichen zwischen Wörtern und jedem Wort mit Großbuchstaben. |
subscription
|
path | True |
string |
Die ID des Zielabonnements. |
api-version
|
query | True |
string |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
end
|
query |
string |
Endzeit für wiederherstellbare Sql-Container-Ereignisfeeds. |
|
restorable
|
query |
string |
Die Ressourcen-ID der SQL-Datenbank. |
|
start
|
query |
string |
Startzeit für wiederherstellbare Sql-Container-Ereignisfeeds. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
CosmosDBRestorableSqlContainerList
Beispielanforderung
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==
Beispiel für eine Antwort
{
"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\""
}
}
}
}
]
}
Definitionen
Name | Beschreibung |
---|---|
Client |
. |
Client |
Cosmos DB-Clientverschlüsselungsrichtlinie. |
Cloud |
Eine Fehlerantwort des Diensts. |
Composite |
|
Composite |
Sortierreihenfolge für zusammengesetzte Pfade. |
Computed |
Die Definition einer berechneten Eigenschaft |
Conflict |
Gibt den Konfliktauflösungsmodus an. |
Conflict |
Die Konfliktlösungsrichtlinie für den Container. |
Container |
Cosmos DB SQL-Containerressourcenobjekt |
Container |
Die Konfiguration des Partitionsschlüssels, der für die Partitionierung von Daten in mehrere Partitionen verwendet werden soll |
Create |
Aufzählung, um den Modus der Kontoerstellung anzugeben. |
Data |
Der Datentyp, auf den das Indizierungsverhalten angewendet wird. |
Distance |
Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll. |
Error |
Fehlerantwort. |
Excluded |
|
Included |
Die Pfade, die in der Indizierung enthalten sind |
Indexes |
Die Indizes für den Pfad. |
Indexing |
Gibt den Indizierungsmodus an. |
Indexing |
Cosmos DB-Indizierungsrichtlinie |
Index |
Gibt den Indextyp an. |
Operation |
Aufzählung, um den Vorgangstyp des Ereignisses anzugeben. |
Partition |
Gibt die Art des Algorithmus an, der für die Partitionierung verwendet wird. Bei MultiHash werden mehrere Partitionsschlüssel (maximal drei) für die Containererstellung unterstützt. |
Resource |
Die Ressource eines Azure Cosmos DB SQL-Containerereignisses |
Resource |
Parameter, die die Informationen zur Wiederherstellung angeben sollen. |
Restorable |
Ein Azure Cosmos DB-Containerereignis |
Restorable |
Die Listenvorgangsantwort, die die SQL-Containerereignisse und deren Eigenschaften enthält. |
Spatial |
|
Spatial |
Gibt den räumlichen Indextyp an. |
Unique |
Der eindeutige Schlüssel für die Erzwingung der Eindeutigkeitseinschränkung für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. |
Unique |
Die Konfiguration der eindeutigen Schlüsselrichtlinie zum Angeben von Eindeutigkeitseinschränkungen für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. |
Vector |
Gibt den Datentyp des Vektors an. |
Vector |
Stellt eine Vektoreinbettung dar. Eine Vektoreinbettung wird verwendet, um ein Vektorfeld in den Dokumenten zu definieren. |
Vector |
Cosmos DB Vector Embedding Policy |
Vector |
|
Vector |
Der Indextyp des Vektors. Derzeit werden flat, diskANN und quantizedFlat unterstützt. |
ClientEncryptionIncludedPath
.
Name | Typ | Beschreibung |
---|---|---|
clientEncryptionKeyId |
string |
Der Bezeichner des Clientverschlüsselungsschlüssels, der zum Verschlüsseln des Pfads verwendet werden soll. |
encryptionAlgorithm |
string |
Der Verschlüsselungsalgorithmus, der verwendet wird. Eg - AEAD_AES_256_CBC_HMAC_SHA256. |
encryptionType |
string |
Der Typ der zu verwendenden Verschlüsselung. Eg - Deterministisch, randomisiert. |
path |
string |
Pfad, der verschlüsselt werden muss. |
ClientEncryptionPolicy
Cosmos DB-Clientverschlüsselungsrichtlinie.
Name | Typ | Beschreibung |
---|---|---|
includedPaths |
Pfade des Elements, die Verschlüsselung zusammen mit pfadspezifischen Einstellungen benötigen. |
|
policyFormatVersion |
integer |
Version der Clientverschlüsselungsrichtliniendefinition. Unterstützte Versionen sind 1 und 2. Version 2 unterstützt die ID- und Partitionsschlüsselpfadverschlüsselung. |
CloudError
Eine Fehlerantwort des Diensts.
Name | Typ | Beschreibung |
---|---|---|
error |
Fehlerantwort. |
CompositePath
Name | Typ | Beschreibung |
---|---|---|
order |
Sortierreihenfolge für zusammengesetzte Pfade. |
|
path |
string |
Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) |
CompositePathSortOrder
Sortierreihenfolge für zusammengesetzte Pfade.
Name | Typ | Beschreibung |
---|---|---|
ascending |
string |
|
descending |
string |
ComputedProperty
Die Definition einer berechneten Eigenschaft
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name einer berechneten Eigenschaft, z. B. "cp_lowerName" |
query |
string |
Die Abfrage, die den Wert für berechnete Eigenschaft auswertet, z. B. "SELECT VALUE LOWER(c.name) FROM c" |
ConflictResolutionMode
Gibt den Konfliktauflösungsmodus an.
Name | Typ | Beschreibung |
---|---|---|
Custom |
string |
|
LastWriterWins |
string |
ConflictResolutionPolicy
Die Konfliktlösungsrichtlinie für den Container.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
conflictResolutionPath |
string |
Der Konfliktlösungspfad im Fall des LastWriterWins-Modus. |
|
conflictResolutionProcedure |
string |
Die Prozedur zum Beheben von Konflikten im Fall des benutzerdefinierten Modus. |
|
mode | LastWriterWins |
Gibt den Konfliktauflösungsmodus an. |
Container
Cosmos DB SQL-Containerressourcenobjekt
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
_etag |
string |
Eine vom System generierte Eigenschaft, die das Ressourcen-Etag darstellt, das für ein optimistisches Parallelitätssteuerelement erforderlich ist. |
|
_rid |
string |
Eine vom System generierte Eigenschaft. Ein eindeutiger Bezeichner. |
|
_self |
string |
Eine vom System generierte Eigenschaft, die den adressierbaren Pfad der Containerressource angibt. |
|
_ts |
number |
Eine vom System generierte Eigenschaft, die den letzten aktualisierten Zeitstempel der Ressource angibt. |
|
analyticalStorageTtl |
integer |
Analytische tTL. |
|
clientEncryptionPolicy |
Die Clientverschlüsselungsrichtlinie für den Container. |
||
computedProperties |
Liste der berechneten Eigenschaften |
||
conflictResolutionPolicy |
Die Konfliktlösungsrichtlinie für den Container. |
||
createMode | Default |
Aufzählung, um den Modus der Ressourcenerstellung anzugeben. |
|
defaultTtl |
integer |
Standardzeit für Live |
|
id |
string |
Name des Cosmos DB SQL-Containers |
|
indexingPolicy |
Die Konfiguration der Indizierungsrichtlinie. Standardmäßig ist die Indizierung für alle Dokumentpfade innerhalb des Containers automatisch. |
||
partitionKey |
Die Konfiguration des Partitionsschlüssels, der für die Partitionierung von Daten in mehrere Partitionen verwendet werden soll |
||
restoreParameters |
Parameter, die die Informationen zur Wiederherstellung angeben sollen |
||
uniqueKeyPolicy |
Die Konfiguration der eindeutigen Schlüsselrichtlinie zum Angeben von Eindeutigkeitseinschränkungen für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. |
||
vectorEmbeddingPolicy |
Die Vektoreinbettungsrichtlinie für den Container. |
ContainerPartitionKey
Die Konfiguration des Partitionsschlüssels, der für die Partitionierung von Daten in mehrere Partitionen verwendet werden soll
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
kind | Hash |
Gibt die Art des Algorithmus an, der für die Partitionierung verwendet wird. Bei MultiHash werden mehrere Partitionsschlüssel (maximal drei) für die Containererstellung unterstützt. |
|
paths |
string[] |
Liste der Pfade, die verwenden, welche Daten innerhalb des Containers partitioniert werden können |
|
systemKey |
boolean |
Gibt an, ob der Container einen vom System generierten Partitionsschlüssel verwendet. |
|
version |
integer |
Gibt die Version der Partitionsschlüsseldefinition an. |
CreateMode
Aufzählung, um den Modus der Kontoerstellung anzugeben.
Name | Typ | Beschreibung |
---|---|---|
Default |
string |
|
Restore |
string |
DataType
Der Datentyp, auf den das Indizierungsverhalten angewendet wird.
Name | Typ | Beschreibung |
---|---|---|
LineString |
string |
|
MultiPolygon |
string |
|
Number |
string |
|
Point |
string |
|
Polygon |
string |
|
String |
string |
DistanceFunction
Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll.
Name | Typ | Beschreibung |
---|---|---|
cosine |
string |
|
dotproduct |
string |
|
euclidean |
string |
ErrorResponse
Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Fehlercode. |
message |
string |
Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist. |
ExcludedPath
Name | Typ | Beschreibung |
---|---|---|
path |
string |
Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) |
IncludedPath
Die Pfade, die in der Indizierung enthalten sind
Name | Typ | Beschreibung |
---|---|---|
indexes |
Indexes[] |
Liste der Indizes für diesen Pfad |
path |
string |
Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) |
Indexes
Die Indizes für den Pfad.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
dataType | String |
Der Datentyp, auf den das Indizierungsverhalten angewendet wird. |
|
kind | Hash |
Gibt den Indextyp an. |
|
precision |
integer |
Die Genauigkeit des Indexes. -1 ist maximale Genauigkeit. |
IndexingMode
Gibt den Indizierungsmodus an.
Name | Typ | Beschreibung |
---|---|---|
consistent |
string |
|
lazy |
string |
|
none |
string |
IndexingPolicy
Cosmos DB-Indizierungsrichtlinie
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
automatic |
boolean |
Gibt an, ob die Indizierungsrichtlinie automatisch ist. |
|
compositeIndexes |
Liste der zusammengesetzten Pfadliste |
||
excludedPaths |
Liste der Pfade, die von der Indizierung ausgeschlossen werden sollen |
||
includedPaths |
Liste der Pfade, die in die Indizierung aufgenommen werden sollen |
||
indexingMode | consistent |
Gibt den Indizierungsmodus an. |
|
spatialIndexes |
Liste der räumlichen Besonderheiten |
||
vectorIndexes |
Liste der Pfade, die in die Vektorindizierung aufgenommen werden sollen |
IndexKind
Gibt den Indextyp an.
Name | Typ | Beschreibung |
---|---|---|
Hash |
string |
|
Range |
string |
|
Spatial |
string |
OperationType
Aufzählung, um den Vorgangstyp des Ereignisses anzugeben.
Name | Typ | Beschreibung |
---|---|---|
Create |
string |
|
Delete |
string |
|
Recreate |
string |
|
Replace |
string |
|
SystemOperation |
string |
PartitionKind
Gibt die Art des Algorithmus an, der für die Partitionierung verwendet wird. Bei MultiHash werden mehrere Partitionsschlüssel (maximal drei) für die Containererstellung unterstützt.
Name | Typ | Beschreibung |
---|---|---|
Hash |
string |
|
MultiHash |
string |
|
Range |
string |
Resource
Die Ressource eines Azure Cosmos DB SQL-Containerereignisses
Name | Typ | Beschreibung |
---|---|---|
_rid |
string |
Eine vom System generierte Eigenschaft. Ein eindeutiger Bezeichner. |
canUndelete |
string |
Ein Status dieses Containers, der identifiziert, ob dieser Container in demselben Konto wiederhergestellt werden kann. |
canUndeleteReason |
string |
Der Grund, warum dieser Container nicht in demselben Konto wiederhergestellt werden kann. |
container |
Cosmos DB SQL-Containerressourcenobjekt |
|
eventTimestamp |
string |
Der Zeitpunkt, an dem dieses Containerereignis aufgetreten ist. |
operationType |
Der Vorgangstyp dieses Containerereignisses. |
|
ownerId |
string |
Der Name dieses SQL-Containers. |
ownerResourceId |
string |
Die Ressourcen-ID dieses SQL-Containers. |
ResourceRestoreParameters
Parameter, die die Informationen zur Wiederherstellung angeben sollen.
Name | Typ | Beschreibung |
---|---|---|
restoreSource |
string |
Die ID des wiederherstellbaren Datenbankkontos, von dem die Wiederherstellung initiiert werden muss. Beispiel: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
restoreTimestampInUtc |
string |
Zeit, zu der das Konto wiederhergestellt werden muss (ISO-8601-Format). |
restoreWithTtlDisabled |
boolean |
Gibt an, ob das wiederhergestellte Konto zeit-To-Live bei der erfolgreichen Wiederherstellung deaktiviert ist. |
RestorableSqlContainerGetResult
Ein Azure Cosmos DB-Containerereignis
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Der eindeutige Ressourcenbezeichner der ARM-Ressource. |
name |
string |
Der Name der ARM-Ressource. |
properties.resource |
Die Ressource eines Azure Cosmos DB SQL-Containerereignisses |
|
type |
string |
Der Typ der Azure-Ressource. |
RestorableSqlContainersListResult
Die Listenvorgangsantwort, die die SQL-Containerereignisse und deren Eigenschaften enthält.
Name | Typ | Beschreibung |
---|---|---|
value |
Liste der SQL-Containerereignisse und deren Eigenschaften. |
SpatialSpec
Name | Typ | Beschreibung |
---|---|---|
path |
string |
Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) |
types |
Liste des räumlichen Pfadtyps |
SpatialType
Gibt den räumlichen Indextyp an.
Name | Typ | Beschreibung |
---|---|---|
LineString |
string |
|
MultiPolygon |
string |
|
Point |
string |
|
Polygon |
string |
UniqueKey
Der eindeutige Schlüssel für die Erzwingung der Eindeutigkeitseinschränkung für Dokumente in der Sammlung im Azure Cosmos DB-Dienst.
Name | Typ | Beschreibung |
---|---|---|
paths |
string[] |
Liste der Pfade muss für jedes Dokument im Azure Cosmos DB-Dienst eindeutig sein. |
UniqueKeyPolicy
Die Konfiguration der eindeutigen Schlüsselrichtlinie zum Angeben von Eindeutigkeitseinschränkungen für Dokumente in der Sammlung im Azure Cosmos DB-Dienst.
Name | Typ | Beschreibung |
---|---|---|
uniqueKeys |
Liste der eindeutigen Schlüssel für die Erzwingung der Eindeutigkeitseinschränkung für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. |
VectorDataType
Gibt den Datentyp des Vektors an.
Name | Typ | Beschreibung |
---|---|---|
float32 |
string |
|
int8 |
string |
|
uint8 |
string |
VectorEmbedding
Stellt eine Vektoreinbettung dar. Eine Vektoreinbettung wird verwendet, um ein Vektorfeld in den Dokumenten zu definieren.
Name | Typ | Beschreibung |
---|---|---|
dataType |
Gibt den Datentyp des Vektors an. |
|
dimensions |
integer |
Die Anzahl der Dimensionen im Vektor. |
distanceFunction |
Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll. |
|
path |
string |
Der Pfad zum Vektorfeld im Dokument. |
VectorEmbeddingPolicy
Cosmos DB Vector Embedding Policy
Name | Typ | Beschreibung |
---|---|---|
vectorEmbeddings |
Liste der Vektoreinbettungen |
VectorIndex
Name | Typ | Beschreibung |
---|---|---|
path |
string |
Der Pfad zum Vektorfeld im Dokument. |
type |
Der Indextyp des Vektors. Derzeit werden flat, diskANN und quantizedFlat unterstützt. |
VectorIndexType
Der Indextyp des Vektors. Derzeit werden flat, diskANN und quantizedFlat unterstützt.
Name | Typ | Beschreibung |
---|---|---|
diskANN |
string |
|
flat |
string |
|
quantizedFlat |
string |