Sdílet prostřednictvím


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
instanceId
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

subscriptionId
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.

endTime
query

string

Doba ukončení kanálu událostí obnovitelného kontejneru Sql

restorableSqlDatabaseRid
query

string

ID prostředku databáze SQL.

startTime
query

string

Čas spuštění kanálu událostí obnovitelného kontejneru Sql

Odpovědi

Name Typ Description
200 OK

RestorableSqlContainersListResult

Operace byla úspěšně dokončena.

Other Status Codes

CloudError

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
ClientEncryptionIncludedPath

.

ClientEncryptionPolicy

Zásady šifrování klienta Cosmos DB

CloudError

Chybová odpověď ze služby.

CompositePath
CompositePathSortOrder

Pořadí řazení složených cest

ComputedProperty

Definice vypočítané vlastnosti

ConflictResolutionMode

Označuje režim řešení konfliktů.

ConflictResolutionPolicy

Zásady řešení konfliktů pro kontejner.

Container

Objekt prostředku kontejneru SQL služby Cosmos DB

ContainerPartitionKey

Konfigurace klíče oddílu, který se má použít k dělení dat do více oddílů

CreateMode

Výčet označující režim vytváření účtu.

DataType

Datový typ, na který se používá chování indexování.

DistanceFunction

Funkce vzdálenosti, která se má použít pro výpočet vzdálenosti mezi vektory.

ErrorResponse

Chybová odpověď.

ExcludedPath
IncludedPath

Cesty, které jsou součástí indexování

Indexes

Indexy pro cestu.

IndexingMode

Označuje režim indexování.

IndexingPolicy

Zásady indexování služby Cosmos DB

IndexKind

Určuje typ indexu.

OperationType

Výčet označující typ operace události.

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).

Resource

Prostředek události kontejneru SQL služby Azure Cosmos DB

ResourceRestoreParameters

Parametry označující informace o obnovení

RestorableSqlContainerGetResult

Událost kontejneru SQL služby Azure Cosmos DB

RestorableSqlContainersListResult

Odpověď operace List, která obsahuje události kontejneru SQL a jejich vlastnosti.

SpatialSpec
SpatialType

Označuje prostorový typ indexu.

UniqueKey

Jedinečný klíč, který vynucuje omezení jedinečnosti u dokumentů v kolekci ve službě Azure Cosmos DB.

UniqueKeyPolicy

Konfigurace zásad jedinečného klíče pro určení omezení jedinečnosti dokumentů v kolekci ve službě Azure Cosmos DB.

VectorDataType

Označuje datový typ vektoru.

VectorEmbedding

Představuje vektorové vkládání. Vektorové vkládání se používá k definování vektorového pole v dokumentech.

VectorEmbeddingPolicy

Zásady vkládání vektorů ve službě Cosmos DB

VectorIndex
VectorIndexType

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

ClientEncryptionIncludedPath[]

Cesty položky, které potřebují šifrování, spolu s nastavením specifickými pro cestu.

policyFormatVersion

integer (int32)

minimum: 1
maximum: 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

ErrorResponse

Chybová odpověď.

CompositePath

Name Typ Description
order

CompositePathSortOrder

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

ConflictResolutionMode

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

ClientEncryptionPolicy

Zásady šifrování klienta pro kontejner.

computedProperties

ComputedProperty[]

Seznam vypočítaných vlastností

conflictResolutionPolicy

ConflictResolutionPolicy

Zásady řešení konfliktů pro kontejner.

createMode

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

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

ContainerPartitionKey

Konfigurace klíče oddílu, který se má použít k dělení dat do více oddílů

restoreParameters

ResourceRestoreParameters

Parametry označující informace o obnovení

uniqueKeyPolicy

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

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

PartitionKind

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: 1
maximum: 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

DataType

String

Datový typ, na který se používá chování indexování.

kind

IndexKind

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

CompositePath[]

Seznam složených cest

excludedPaths

ExcludedPath[]

Seznam cest, které se mají vyloučit z indexování

includedPaths

IncludedPath[]

Seznam cest, které se mají zahrnout do indexování

indexingMode

IndexingMode

consistent

Označuje režim indexování.

spatialIndexes

SpatialSpec[]

Seznam prostorových specifik

vectorIndexes

VectorIndex[]

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

Container

Objekt prostředku kontejneru SQL služby Cosmos DB

eventTimestamp

string

Kdy k této události kontejneru došlo.

operationType

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

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

RestorableSqlContainerGetResult[]

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

SpatialType[]

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

UniqueKey[]

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

VectorDataType

Označuje datový typ vektoru.

dimensions

integer (int32)

Počet dimenzí ve vektoru.

distanceFunction

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

VectorEmbedding[]

Seznam vektorových vkládání

VectorIndex

Name Typ Description
path

string

Cesta k vektorovém poli v dokumentu.

type

VectorIndexType

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