Freigeben über


Restorable Sql Containers - List

Zeigt den Ereignisfeed aller Mutationen an, die für alle Azure Cosmos DB SQL-Container unter einer bestimmten Datenbank vorgenommen wurden. Dies ist hilfreich 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=2025-10-15
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlContainers?api-version=2025-10-15&restorableSqlDatabaseRid={restorableSqlDatabaseRid}&startTime={startTime}&endTime={endTime}

URI-Parameter

Name In Erforderlich Typ Beschreibung
instanceId
path True

string

Die instanceId-GUID eines wiederherstellbaren Datenbankkontos.

location
path True

string

Cosmos DB-Region, mit Leerzeichen zwischen den Wörtern und jedem Wort in Großbuchstaben.

subscriptionId
path True

string

minLength: 1

Die ID des Zielabonnements.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

endTime
query

string

Endzeit für wiederherstellbare Sql-Container-Ereignisfeeds.

restorableSqlDatabaseRid
query

string

Die Ressourcen-ID der SQL-Datenbank.

startTime
query

string

Startzeit für wiederherstellbare Sql-Container-Ereignisfeeds.

Antworten

Name Typ Beschreibung
200 OK

RestorableSqlContainersListResult

Der Vorgang wurde erfolgreich abgeschlossen.

Other Status Codes

CloudError

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=2025-10-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
ClientEncryptionIncludedPath

.

ClientEncryptionPolicy

Cosmos DB-Clientverschlüsselungsrichtlinie.

CloudError

Eine Fehlerantwort des Diensts.

CompositePath
CompositePathSortOrder

Sortierreihenfolge für zusammengesetzte Pfade.

ComputedProperty

Die Definition einer berechneten Eigenschaft

ConflictResolutionMode

Gibt den Konfliktauflösungsmodus an.

ConflictResolutionPolicy

Die Konfliktlösungsrichtlinie für den Container.

Container

Cosmos DB SQL-Containerressourcenobjekt

ContainerPartitionKey

Die Konfiguration des Partitionsschlüssels, der für die Partitionierung von Daten in mehrere Partitionen verwendet werden soll

CreateMode

Aufzählung, um den Modus der Kontoerstellung anzugeben.

DataType

Der Datentyp, auf den das Indizierungsverhalten angewendet wird.

DistanceFunction

Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll.

ErrorResponse

Fehlerantwort.

ExcludedPath
FullTextIndexPath

Stellt den Volltextindexpfad dar.

FullTextPath

Stellt die Spezifikation des Volltextpfads dar.

FullTextPolicy

Cosmos DB-Volltextrichtlinie

IncludedPath

Die Pfade, die in die Indizierung einbezogen werden

Indexes

Die Indizes für den Pfad.

IndexingMode

Gibt den Indizierungsmodus an.

IndexingPolicy

Cosmos DB-Indizierungsrichtlinie

IndexKind

Gibt den Indextyp an.

OperationType

Enum, um den Vorgangstyp des Ereignisses anzugeben.

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.

Resource

Die Ressource eines Azure Cosmos DB SQL-Containerereignisses

ResourceRestoreParameters

Parameter, die die Informationen zur Wiederherstellung angeben sollen.

RestorableSqlContainerGetResult

Ein Azure Cosmos DB SQL-Containerereignis

RestorableSqlContainersListResult

Die Antwort auf den List-Vorgang, die die SQL-Containerereignisse und deren Eigenschaften enthält.

SpatialSpec
SpatialType

Gibt den räumlichen Typ des Indexes an.

UniqueKey

Der eindeutige Schlüssel, der die Eindeutigkeitseinschränkung für Dokumente in der Sammlung im Azure Cosmos DB-Dienst erzwingt.

UniqueKeyPolicy

Die Konfiguration der eindeutigen Schlüsselrichtlinie zum Angeben von Eindeutigkeitseinschränkungen für Dokumente in der Sammlung im Azure Cosmos DB-Dienst.

VectorDataType

Gibt den Datentyp des Vektors an.

VectorEmbedding

Stellt eine Vektoreinbettung dar. Eine Vektoreinbettung wird verwendet, um ein Vektorfeld in den Dokumenten zu definieren.

VectorEmbeddingPolicy

Richtlinie zum Einbetten von Cosmos DB-Vektoren

VectorIndex
VectorIndexType

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. Z.B. - 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

ClientEncryptionIncludedPath[]

Pfade des Elements, die Verschlüsselung zusammen mit pfadspezifischen Einstellungen benötigen.

policyFormatVersion

integer (int32)

minimum: 1
maximum: 2

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

ErrorResponse

Fehlerantwort.

CompositePath

Name Typ Beschreibung
order

CompositePathSortOrder

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.

Wert Beschreibung
ascending
descending

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.

Wert Beschreibung
LastWriterWins
Custom

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

ConflictResolutionMode

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 die Steuerung der optimistischen Parallelität erforderlich ist.

_rid

string

Eine vom System generierte Eigenschaft. Eine eindeutige Kennung.

_self

string

Eine vom System generierte Eigenschaft, die den adressierbaren Pfad der Containerressource angibt.

_ts

number

Eine vom System generierte Eigenschaft, die den zuletzt aktualisierten Zeitstempel der Ressource angibt.

analyticalStorageTtl

integer (int64)

Analytische tTL.

clientEncryptionPolicy

ClientEncryptionPolicy

Die Clientverschlüsselungsrichtlinie für den Container.

computedProperties

ComputedProperty[]

Liste der berechneten Eigenschaften

conflictResolutionPolicy

ConflictResolutionPolicy

Die Konfliktlösungsrichtlinie für den Container.

createMode

CreateMode

Default

Aufzählung, um den Modus der Ressourcenerstellung anzugeben.

defaultTtl

integer

Standardzeit für Live

fullTextPolicy

FullTextPolicy

Die FullText-Richtlinie für den Container.

id

string

Name des Cosmos DB SQL-Containers

indexingPolicy

IndexingPolicy

Die Konfiguration der Indizierungsrichtlinie. Standardmäßig ist die Indizierung für alle Dokumentpfade innerhalb des Containers automatisch.

partitionKey

ContainerPartitionKey

Die Konfiguration des Partitionsschlüssels, der für die Partitionierung von Daten in mehrere Partitionen verwendet werden soll

restoreParameters

ResourceRestoreParameters

Parameter, die die Informationen zur Wiederherstellung angeben sollen

uniqueKeyPolicy

UniqueKeyPolicy

Die Konfiguration der eindeutigen Schlüsselrichtlinie zum Angeben von Eindeutigkeitseinschränkungen für Dokumente in der Sammlung im Azure Cosmos DB-Dienst.

vectorEmbeddingPolicy

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

PartitionKind

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 (int32)

minimum: 1
maximum: 2

Gibt die Version der Partitionsschlüsseldefinition an.

CreateMode

Aufzählung, um den Modus der Kontoerstellung anzugeben.

Wert Beschreibung
Default
Restore

DataType

Der Datentyp, auf den das Indizierungsverhalten angewendet wird.

Wert Beschreibung
String
Number
Point
Polygon
LineString
MultiPolygon

DistanceFunction

Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll.

Wert Beschreibung
euclidean
cosine
dotproduct

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/*)

FullTextIndexPath

Stellt den Volltextindexpfad dar.

Name Typ Beschreibung
path

string

Der Pfad zum Volltextfeld im Dokument.

FullTextPath

Stellt die Spezifikation des Volltextpfads dar.

Name Typ Beschreibung
language

string

Die Sprache des Volltextfelds im Dokument.

path

string

Der Pfad zum Volltextfeld im Dokument.

FullTextPolicy

Cosmos DB-Volltextrichtlinie

Name Typ Beschreibung
defaultLanguage

string

Die Standardsprache für Volltextpfade.

fullTextPaths

FullTextPath[]

Liste der FullText-Pfade

IncludedPath

Die Pfade, die in die Indizierung einbezogen werden

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

DataType

String

Der Datentyp, auf den das Indizierungsverhalten angewendet wird.

kind

IndexKind

Hash

Gibt den Indextyp an.

precision

integer

Die Genauigkeit des Indexes. -1 ist maximale Genauigkeit.

IndexingMode

Gibt den Indizierungsmodus an.

Wert Beschreibung
consistent
lazy
none

IndexingPolicy

Cosmos DB-Indizierungsrichtlinie

Name Typ Standardwert Beschreibung
automatic

boolean

Gibt an, ob die Indizierungsrichtlinie automatisch ist.

compositeIndexes

CompositePath[]

Liste der zusammengesetzten Pfadliste

excludedPaths

ExcludedPath[]

Liste der Pfade, die von der Indizierung ausgeschlossen werden sollen

fullTextIndexes

FullTextIndexPath[]

Liste der Pfade, die in die Volltextindizierung einbezogen werden sollen

includedPaths

IncludedPath[]

Liste der Pfade, die in die Indizierung aufgenommen werden sollen

indexingMode

IndexingMode

consistent

Gibt den Indizierungsmodus an.

spatialIndexes

SpatialSpec[]

Liste der räumlichen Besonderheiten

vectorIndexes

VectorIndex[]

Liste der Pfade, die in die Vektorindizierung aufgenommen werden sollen

IndexKind

Gibt den Indextyp an.

Wert Beschreibung
Hash
Range
Spatial

OperationType

Enum, um den Vorgangstyp des Ereignisses anzugeben.

Wert Beschreibung
Create
Replace
Delete
Recreate
SystemOperation

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.

Wert Beschreibung
Hash
Range
MultiHash

Resource

Die Ressource eines Azure Cosmos DB SQL-Containerereignisses

Name Typ Beschreibung
_rid

string

Eine vom System generierte Eigenschaft. Eine eindeutige Kennung.

canUndelete

string

Ein Status dieses Containers, um zu identifizieren, ob dieser Container im selben Konto wiederhergestellt werden kann.

canUndeleteReason

string

Der Grund, warum dieser Container im selben Konto nicht wiederhergestellt werden kann.

container

Container

Cosmos DB SQL-Containerressourcenobjekt

eventTimestamp

string

Das, wann dieses Containerereignis aufgetreten ist.

operationType

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 (date-time)

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 SQL-Containerereignis

Name Typ Beschreibung
id

string

Der eindeutige Ressourcenbezeichner der ARM-Ressource.

name

string

Der Name der ARM-Ressource.

properties.resource

Resource

Die Ressource eines Azure Cosmos DB SQL-Containerereignisses

type

string

Der Typ der Azure-Ressource.

RestorableSqlContainersListResult

Die Antwort auf den List-Vorgang, die die SQL-Containerereignisse und deren Eigenschaften enthält.

Name Typ Beschreibung
value

RestorableSqlContainerGetResult[]

Liste der SQL-Containerereignisse und ihrer 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

SpatialType[]

Liste des räumlichen Pfadtyps

SpatialType

Gibt den räumlichen Typ des Indexes an.

Wert Beschreibung
Point
LineString
Polygon
MultiPolygon

UniqueKey

Der eindeutige Schlüssel, der die Eindeutigkeitseinschränkung für Dokumente in der Sammlung im Azure Cosmos DB-Dienst erzwingt.

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

UniqueKey[]

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.

Wert Beschreibung
float32
uint8
int8
float16

VectorEmbedding

Stellt eine Vektoreinbettung dar. Eine Vektoreinbettung wird verwendet, um ein Vektorfeld in den Dokumenten zu definieren.

Name Typ Beschreibung
dataType

VectorDataType

Gibt den Datentyp des Vektors an.

dimensions

integer (int32)

Die Anzahl der Dimensionen im Vektor.

distanceFunction

DistanceFunction

Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll.

path

string

Der Pfad zum Vektorfeld im Dokument.

VectorEmbeddingPolicy

Richtlinie zum Einbetten von Cosmos DB-Vektoren

Name Typ Beschreibung
vectorEmbeddings

VectorEmbedding[]

Liste der Vektoreinbettungen

VectorIndex

Name Typ Standardwert Beschreibung
indexingSearchListSize

integer (int64)

minimum: 25
maximum: 500
100

Dies ist die Größe der Kandidatenliste der ungefähren Nachbarn, die beim Erstellen des DiskANN-Index als Teil der Optimierungsprozesse gespeichert werden. Große Werte können den Abruf auf Kosten der Latenz verbessern. Dies gilt nur für den diskANN-Vektorindextyp.

path

string

Der Pfad zum Vektorfeld im Dokument.

quantizationByteSize

integer (int64)

minimum: 4

Die Anzahl der Bytes, die bei der Produktquantisierung der Vektoren verwendet werden. Ein größerer Wert kann zu einem besseren Abruf bei Vektorsuchen auf Kosten der Latenz führen. Dies gilt nur für die Vektorindextypen quantizedFlat und diskANN.

type

VectorIndexType

Der Indextyp des Vektors. Derzeit werden flat, diskANN und quantizedFlat unterstützt.

vectorIndexShardKey

string[]

Array von Shard-Schlüsseln für den Vektorindex. Dies gilt nur für die Vektorindextypen quantizedFlat und diskANN.

VectorIndexType

Der Indextyp des Vektors. Derzeit werden flat, diskANN und quantizedFlat unterstützt.

Wert Beschreibung
flat
diskANN
quantizedFlat