Restorable Sql Containers - List
Visualizzare il feed di eventi di tutte le mutazioni eseguite in tutti i contenitori SQL di Azure Cosmos DB in un database specifico. Ciò è utile nello scenario in cui il contenitore è stato eliminato accidentalmente. Questa API richiede l'autorizzazione '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}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
instance
|
path | True |
string |
GUID instanceId di un account di database ripristinabile. |
location
|
path | True |
string |
Area di Cosmos DB, con spazi tra le parole e ogni parola maiuscola. |
subscription
|
path | True |
string |
ID della sottoscrizione di destinazione. |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
end
|
query |
string |
Ora di fine del feed di eventi dei contenitori Sql ripristinabili. |
|
restorable
|
query |
string |
ID risorsa del database SQL. |
|
start
|
query |
string |
Ora di inizio del feed di eventi dei contenitori Sql ripristinabili. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Operazione completata correttamente. |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | Rappresentare l'account utente |
Esempio
CosmosDBRestorableSqlContainerList
Esempio di richiesta
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==
Risposta di esempio
{
"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\""
}
}
}
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Client |
. |
Client |
Criteri di crittografia client di Cosmos DB. |
Cloud |
Risposta di errore dal servizio. |
Composite |
|
Composite |
Ordinamento per i percorsi compositi. |
Computed |
Definizione di una proprietà calcolata |
Conflict |
Indica la modalità di risoluzione dei conflitti. |
Conflict |
Criteri di risoluzione dei conflitti per il contenitore. |
Container |
Oggetto risorsa contenitore SQL di Cosmos DB |
Container |
Configurazione della chiave di partizione da usare per il partizionamento dei dati in più partizioni |
Create |
Enumerazione per indicare la modalità di creazione dell'account. |
Data |
Tipo di dati a cui viene applicato il comportamento di indicizzazione. |
Distance |
Funzione distance da usare per il calcolo della distanza tra vettori. |
Error |
Risposta errore. |
Excluded |
|
Included |
Percorsi inclusi nell'indicizzazione |
Indexes |
Indici per il percorso. |
Indexing |
Indica la modalità di indicizzazione. |
Indexing |
Criteri di indicizzazione di Cosmos DB |
Index |
Indica il tipo di indice. |
Operation |
Enumerazione per indicare il tipo di operazione dell'evento. |
Partition |
Indica il tipo di algoritmo utilizzato per il partizionamento. Per MultiHash sono supportate più chiavi di partizione (fino a tre massime) per la creazione di contenitori |
Resource |
Risorsa di un evento contenitore SQL di Azure Cosmos DB |
Resource |
Parametri per indicare le informazioni sul ripristino. |
Restorable |
Un evento del contenitore SQL di Azure Cosmos DB |
Restorable |
Risposta dell'operazione List, che contiene gli eventi del contenitore SQL e le relative proprietà. |
Spatial |
|
Spatial |
Indica il tipo spaziale di indice. |
Unique |
Chiave univoca su che impone vincoli di univocità sui documenti nella raccolta nel servizio Azure Cosmos DB. |
Unique |
Configurazione dei criteri chiave univoca per specificare vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. |
Vector |
Indica il tipo di dati del vettore. |
Vector |
Rappresenta un incorporamento vettoriale. Per definire un campo vettoriale nei documenti viene usato un incorporamento vettoriale. |
Vector |
Criteri di incorporamento vettoriali di Cosmos DB |
Vector |
|
Vector |
Tipo di indice del vettore. Attualmente sono supportati flat, diskANN e quantiizedFlat. |
ClientEncryptionIncludedPath
.
Nome | Tipo | Descrizione |
---|---|---|
clientEncryptionKeyId |
string |
Identificatore della chiave di crittografia client da usare per crittografare il percorso. |
encryptionAlgorithm |
string |
Algoritmo di crittografia che verrà usato. Ad esempio, AEAD_AES_256_CBC_HMAC_SHA256. |
encryptionType |
string |
Tipo di crittografia da eseguire. Ad esempio: deterministico, casuale. |
path |
string |
Percorso che deve essere crittografato. |
ClientEncryptionPolicy
Criteri di crittografia client di Cosmos DB.
Nome | Tipo | Descrizione |
---|---|---|
includedPaths |
Percorsi dell'elemento che richiedono la crittografia insieme alle impostazioni specifiche del percorso. |
|
policyFormatVersion |
integer |
Versione della definizione dei criteri di crittografia client. Le versioni supportate sono 1 e 2. La versione 2 supporta la crittografia id e percorso della chiave di partizione. |
CloudError
Risposta di errore dal servizio.
Nome | Tipo | Descrizione |
---|---|---|
error |
Risposta errore. |
CompositePath
Nome | Tipo | Descrizione |
---|---|---|
order |
Ordinamento per i percorsi compositi. |
|
path |
string |
Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) |
CompositePathSortOrder
Ordinamento per i percorsi compositi.
Nome | Tipo | Descrizione |
---|---|---|
ascending |
string |
|
descending |
string |
ComputedProperty
Definizione di una proprietà calcolata
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome di una proprietà calcolata, ad esempio " cp_lowerName" |
query |
string |
Query che valuta il valore per la proprietà calcolata, ad esempio "SELECT VALUE LOWER(c.name) FROM c" |
ConflictResolutionMode
Indica la modalità di risoluzione dei conflitti.
Nome | Tipo | Descrizione |
---|---|---|
Custom |
string |
|
LastWriterWins |
string |
ConflictResolutionPolicy
Criteri di risoluzione dei conflitti per il contenitore.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
conflictResolutionPath |
string |
Percorso di risoluzione dei conflitti nel caso della modalità LastWriterWins. |
|
conflictResolutionProcedure |
string |
Procedura per risolvere i conflitti in caso di modalità personalizzata. |
|
mode | LastWriterWins |
Indica la modalità di risoluzione dei conflitti. |
Container
Oggetto risorsa contenitore SQL di Cosmos DB
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
_etag |
string |
Proprietà generata dal sistema che rappresenta l'etag della risorsa necessaria per il controllo della concorrenza ottimistica. |
|
_rid |
string |
Proprietà generata dal sistema. Identificatore univoco. |
|
_self |
string |
Proprietà generata dal sistema che specifica il percorso indirizzabile della risorsa contenitore. |
|
_ts |
number |
Proprietà generata dal sistema che indica il timestamp dell'ultimo aggiornamento della risorsa. |
|
analyticalStorageTtl |
integer |
TTL analitico. |
|
clientEncryptionPolicy |
Criteri di crittografia client per il contenitore. |
||
computedProperties |
Elenco delle proprietà calcolate |
||
conflictResolutionPolicy |
Criteri di risoluzione dei conflitti per il contenitore. |
||
createMode | Default |
Enumerazione per indicare la modalità di creazione della risorsa. |
|
defaultTtl |
integer |
Durata predefinita |
|
id |
string |
Nome del contenitore SQL di Cosmos DB |
|
indexingPolicy |
Configurazione dei criteri di indicizzazione. Per impostazione predefinita, l'indicizzazione è automatica per tutti i percorsi dei documenti all'interno del contenitore |
||
partitionKey |
Configurazione della chiave di partizione da usare per il partizionamento dei dati in più partizioni |
||
restoreParameters |
Parametri per indicare le informazioni sul ripristino |
||
uniqueKeyPolicy |
Configurazione dei criteri chiave univoca per specificare vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. |
||
vectorEmbeddingPolicy |
Criterio di incorporamento vettoriale per il contenitore. |
ContainerPartitionKey
Configurazione della chiave di partizione da usare per il partizionamento dei dati in più partizioni
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
kind | Hash |
Indica il tipo di algoritmo utilizzato per il partizionamento. Per MultiHash sono supportate più chiavi di partizione (fino a tre massime) per la creazione di contenitori |
|
paths |
string[] |
Elenco di percorsi che usano i dati all'interno del contenitore che possono essere partizionati |
|
systemKey |
boolean |
Indica se il contenitore usa una chiave di partizione generata dal sistema |
|
version |
integer |
Indica la versione della definizione della chiave di partizione |
CreateMode
Enumerazione per indicare la modalità di creazione dell'account.
Nome | Tipo | Descrizione |
---|---|---|
Default |
string |
|
Restore |
string |
DataType
Tipo di dati a cui viene applicato il comportamento di indicizzazione.
Nome | Tipo | Descrizione |
---|---|---|
LineString |
string |
|
MultiPolygon |
string |
|
Number |
string |
|
Point |
string |
|
Polygon |
string |
|
String |
string |
DistanceFunction
Funzione distance da usare per il calcolo della distanza tra vettori.
Nome | Tipo | Descrizione |
---|---|---|
cosine |
string |
|
dotproduct |
string |
|
euclidean |
string |
ErrorResponse
Risposta errore.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
message |
string |
Messaggio di errore che indica il motivo per cui l'operazione non è riuscita. |
ExcludedPath
Nome | Tipo | Descrizione |
---|---|---|
path |
string |
Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) |
IncludedPath
Percorsi inclusi nell'indicizzazione
Nome | Tipo | Descrizione |
---|---|---|
indexes |
Indexes[] |
Elenco di indici per questo percorso |
path |
string |
Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) |
Indexes
Indici per il percorso.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
dataType | String |
Tipo di dati a cui viene applicato il comportamento di indicizzazione. |
|
kind | Hash |
Indica il tipo di indice. |
|
precision |
integer |
Precisione dell'indice. -1 è la precisione massima. |
IndexingMode
Indica la modalità di indicizzazione.
Nome | Tipo | Descrizione |
---|---|---|
consistent |
string |
|
lazy |
string |
|
none |
string |
IndexingPolicy
Criteri di indicizzazione di Cosmos DB
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
automatic |
boolean |
Indica se i criteri di indicizzazione sono automatici |
|
compositeIndexes |
Elenco di elenco di percorsi compositi |
||
excludedPaths |
Elenco di percorsi da escludere dall'indicizzazione |
||
includedPaths |
Elenco di percorsi da includere nell'indicizzazione |
||
indexingMode | consistent |
Indica la modalità di indicizzazione. |
|
spatialIndexes |
Elenco di specifiche spaziali |
||
vectorIndexes |
Elenco di percorsi da includere nell'indicizzazione vettoriale |
IndexKind
Indica il tipo di indice.
Nome | Tipo | Descrizione |
---|---|---|
Hash |
string |
|
Range |
string |
|
Spatial |
string |
OperationType
Enumerazione per indicare il tipo di operazione dell'evento.
Nome | Tipo | Descrizione |
---|---|---|
Create |
string |
|
Delete |
string |
|
Recreate |
string |
|
Replace |
string |
|
SystemOperation |
string |
PartitionKind
Indica il tipo di algoritmo utilizzato per il partizionamento. Per MultiHash sono supportate più chiavi di partizione (fino a tre massime) per la creazione di contenitori
Nome | Tipo | Descrizione |
---|---|---|
Hash |
string |
|
MultiHash |
string |
|
Range |
string |
Resource
Risorsa di un evento contenitore SQL di Azure Cosmos DB
Nome | Tipo | Descrizione |
---|---|---|
_rid |
string |
Proprietà generata dal sistema. Identificatore univoco. |
canUndelete |
string |
Stato di questo contenitore per identificare se il contenitore è ripristinabile nello stesso account. |
canUndeleteReason |
string |
Motivo per cui questo contenitore non può essere ripristinato nello stesso account. |
container |
Oggetto risorsa contenitore SQL di Cosmos DB |
|
eventTimestamp |
string |
Oggetto quando si è verificato l'evento del contenitore. |
operationType |
Tipo di operazione di questo evento contenitore. |
|
ownerId |
string |
Nome del contenitore SQL. |
ownerResourceId |
string |
ID risorsa di questo contenitore SQL. |
ResourceRestoreParameters
Parametri per indicare le informazioni sul ripristino.
Nome | Tipo | Descrizione |
---|---|---|
restoreSource |
string |
ID dell'account di database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
restoreTimestampInUtc |
string |
Ora di ripristino dell'account (formato ISO-8601). |
restoreWithTtlDisabled |
boolean |
Specifica se l'account ripristinato avrà time-To-Live disabilitato al termine del ripristino. |
RestorableSqlContainerGetResult
Un evento del contenitore SQL di Azure Cosmos DB
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
Identificatore univoco della risorsa arm. |
name |
string |
Nome della risorsa arm. |
properties.resource |
Risorsa di un evento contenitore SQL di Azure Cosmos DB |
|
type |
string |
Tipo di risorsa di Azure. |
RestorableSqlContainersListResult
Risposta dell'operazione List, che contiene gli eventi del contenitore SQL e le relative proprietà.
Nome | Tipo | Descrizione |
---|---|---|
value |
Elenco degli eventi del contenitore SQL e delle relative proprietà. |
SpatialSpec
Nome | Tipo | Descrizione |
---|---|---|
path |
string |
Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) |
types |
Elenco del tipo spaziale del percorso |
SpatialType
Indica il tipo spaziale di indice.
Nome | Tipo | Descrizione |
---|---|---|
LineString |
string |
|
MultiPolygon |
string |
|
Point |
string |
|
Polygon |
string |
UniqueKey
Chiave univoca su che impone vincoli di univocità sui documenti nella raccolta nel servizio Azure Cosmos DB.
Nome | Tipo | Descrizione |
---|---|---|
paths |
string[] |
L'elenco dei percorsi deve essere univoco per ogni documento nel servizio Azure Cosmos DB |
UniqueKeyPolicy
Configurazione dei criteri chiave univoca per specificare vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB.
Nome | Tipo | Descrizione |
---|---|---|
uniqueKeys |
Elenco di chiavi univoche in che applicano vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. |
VectorDataType
Indica il tipo di dati del vettore.
Nome | Tipo | Descrizione |
---|---|---|
float32 |
string |
|
int8 |
string |
|
uint8 |
string |
VectorEmbedding
Rappresenta un incorporamento vettoriale. Per definire un campo vettoriale nei documenti viene usato un incorporamento vettoriale.
Nome | Tipo | Descrizione |
---|---|---|
dataType |
Indica il tipo di dati del vettore. |
|
dimensions |
integer |
Numero di dimensioni nel vettore. |
distanceFunction |
Funzione distance da usare per il calcolo della distanza tra vettori. |
|
path |
string |
Percorso del campo vettore nel documento. |
VectorEmbeddingPolicy
Criteri di incorporamento vettoriali di Cosmos DB
Nome | Tipo | Descrizione |
---|---|---|
vectorEmbeddings |
Elenco di incorporamenti vettoriali |
VectorIndex
Nome | Tipo | Descrizione |
---|---|---|
path |
string |
Percorso del campo vettore nel documento. |
type |
Tipo di indice del vettore. Attualmente sono supportati flat, diskANN e quantiizedFlat. |
VectorIndexType
Tipo di indice del vettore. Attualmente sono supportati flat, diskANN e quantiizedFlat.
Nome | Tipo | Descrizione |
---|---|---|
diskANN |
string |
|
flat |
string |
|
quantizedFlat |
string |