Restorable Sql Containers - List
顯示在特定資料庫下所有 Azure Cosmos DB SQL 容器上完成之所有變動的事件摘要。 這有助於意外刪除容器的情況。 此 API 需要 'Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read' 權限
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 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
instance
|
path | True |
string |
可還原資料庫帳戶的 instanceId GUID。 |
|
location
|
path | True |
string |
Cosmos DB 區域,單字之間有空格,每個單字都大寫。 |
|
subscription
|
path | True |
string minLength: 1 |
目標訂用帳戶的標識碼。 |
|
api-version
|
query | True |
string minLength: 1 |
用於此作業的 API 版本。 |
|
end
|
query |
string |
可還原的 Sql 容器事件摘要結束時間。 |
|
|
restorable
|
query |
string |
SQL 資料庫的資源識別碼。 |
|
|
start
|
query |
string |
可還原的 SQL 容器事件摘要開始時間。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
作業已順利完成。 |
|
| Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
| 名稱 | Description |
|---|---|
| user_impersonation | 模擬您的用戶帳戶 |
範例
CosmosDBRestorableSqlContainerList
範例要求
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==
範例回覆
{
"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\""
}
}
}
}
]
}
定義
| 名稱 | Description |
|---|---|
|
Client |
. |
|
Client |
Cosmos DB 用戶端加密原則。 |
|
Cloud |
來自服務的錯誤回應。 |
|
Composite |
|
|
Composite |
複合路徑的排序順序。 |
|
Computed |
計算屬性的定義 |
|
Conflict |
表示衝突解決模式。 |
|
Conflict |
容器的衝突解決原則。 |
| Container |
Cosmos DB SQL 容器資源物件 |
|
Container |
分割區索引鍵的組態,用於將數據分割成多個分割區 |
|
Create |
列舉,表示帳戶建立模式。 |
|
Data |
套用索引行為的數據類型。 |
|
Distance |
用於向量之間距離計算的 distance 函式。 |
|
Error |
錯誤回應。 |
|
Excluded |
|
|
Full |
代表全文檢索索引路徑。 |
|
Full |
代表全文檢索路徑規格。 |
|
Full |
Cosmos DB 全文檢索原則 |
|
Included |
索引中包含的路徑 |
| Indexes |
路徑的索引。 |
|
Indexing |
表示索引模式。 |
|
Indexing |
Cosmos DB 索引原則 |
|
Index |
表示索引的類型。 |
|
Operation |
列舉,以指出事件的作業類型。 |
|
Partition |
表示用於數據分割的演算法類型。 針對 MultiHash,容器建立支援多個分割區索引鍵 (最多三個最大值) |
| Resource |
Azure Cosmos DB SQL 容器事件的資源 |
|
Resource |
用來指出還原相關信息的參數。 |
|
Restorable |
Azure Cosmos DB SQL 容器事件 |
|
Restorable |
列出作業回應,其中包含 SQL 儲存器事件及其內容。 |
|
Spatial |
|
|
Spatial |
指出索引的空間類型。 |
|
Unique |
上的唯一索引鍵會對 Azure Cosmos DB 服務中集合中的檔強制執行唯一性限制。 |
|
Unique |
針對 Azure Cosmos DB 服務集合中檔指定唯一性條件約束的唯一索引鍵原則組態。 |
|
Vector |
表示向量的數據型別。 |
|
Vector |
表示向量內嵌。 向量內嵌可用來定義檔中的向量欄位。 |
|
Vector |
Cosmos DB 向量內嵌原則 |
|
Vector |
|
|
Vector |
向量的索引類型。 目前支援一般、diskANN 和 quantizedFlat。 |
ClientEncryptionIncludedPath
.
| 名稱 | 類型 | Description |
|---|---|---|
| clientEncryptionKeyId |
string |
要用來加密路徑之用戶端加密金鑰的識別碼。 |
| encryptionAlgorithm |
string |
將使用的加密演算法。 例如 - AEAD_AES_256_CBC_HMAC_SHA256。 |
| encryptionType |
string |
要執行的加密類型。 例如 - 決定性、隨機化。 |
| path |
string |
需要加密的路徑。 |
ClientEncryptionPolicy
Cosmos DB 用戶端加密原則。
| 名稱 | 類型 | Description |
|---|---|---|
| includedPaths |
需要加密的項目路徑以及路徑特定設定。 |
|
| policyFormatVersion |
integer (int32) minimum: 1maximum: 2 |
用戶端加密原則定義的版本。 支援的版本為 1 和 2。 第 2 版支援識別碼和資料分割金鑰路徑加密。 |
CloudError
來自服務的錯誤回應。
| 名稱 | 類型 | Description |
|---|---|---|
| error |
錯誤回應。 |
CompositePath
| 名稱 | 類型 | Description |
|---|---|---|
| order |
複合路徑的排序順序。 |
|
| path |
string |
索引行為套用的路徑。 索引路徑通常以根開頭,並以通配符結尾 (/path/*) |
CompositePathSortOrder
複合路徑的排序順序。
| 值 | Description |
|---|---|
| ascending | |
| descending |
ComputedProperty
計算屬性的定義
| 名稱 | 類型 | Description |
|---|---|---|
| name |
string |
計算屬性的名稱,例如 - “cp_lowerName” |
| query |
string |
評估計算屬性值的查詢,例如 - “SELECT VALUE LOWER(c.name) FROM c” |
ConflictResolutionMode
表示衝突解決模式。
| 值 | Description |
|---|---|
| LastWriterWins | |
| Custom |
ConflictResolutionPolicy
容器的衝突解決原則。
| 名稱 | 類型 | 預設值 | Description |
|---|---|---|---|
| conflictResolutionPath |
string |
LastWriterWins 模式的衝突解決路徑。 |
|
| conflictResolutionProcedure |
string |
解決自定義模式衝突的程式。 |
|
| mode | LastWriterWins |
表示衝突解決模式。 |
Container
Cosmos DB SQL 容器資源物件
| 名稱 | 類型 | 預設值 | Description |
|---|---|---|---|
| _etag |
string |
系統產生的屬性,代表樂觀並行控制所需的資源 etag。 |
|
| _rid |
string |
系統產生的屬性。 唯一識別碼。 |
|
| _self |
string |
系統產生的內容,指定容器資源的可定址路徑。 |
|
| _ts |
number |
系統產生的內容,表示資源的上次更新時間戳記。 |
|
| analyticalStorageTtl |
integer (int64) |
分析TTL。 |
|
| clientEncryptionPolicy |
容器的用戶端加密原則。 |
||
| computedProperties |
計算屬性的清單 |
||
| conflictResolutionPolicy |
容器的衝突解決原則。 |
||
| createMode | Default |
列舉,表示資源建立模式。 |
|
| defaultTtl |
integer |
默認存留時間 |
|
| fullTextPolicy |
容器的 FullText 原則。 |
||
| id |
string |
Cosmos DB SQL 容器的名稱 |
|
| indexingPolicy |
編製索引原則的組態。 根據預設,容器內所有文件路徑的索引會自動編製索引 |
||
| partitionKey |
分割區索引鍵的組態,用於將數據分割成多個分割區 |
||
| restoreParameters |
用來指出還原相關信息的參數 |
||
| uniqueKeyPolicy |
針對 Azure Cosmos DB 服務集合中檔指定唯一性條件約束的唯一索引鍵原則組態。 |
||
| vectorEmbeddingPolicy |
容器的向量內嵌原則。 |
ContainerPartitionKey
分割區索引鍵的組態,用於將數據分割成多個分割區
| 名稱 | 類型 | 預設值 | Description |
|---|---|---|---|
| kind | Hash |
表示用於數據分割的演算法類型。 針對 MultiHash,容器建立支援多個分割區索引鍵 (最多三個最大值) |
|
| paths |
string[] |
使用容器內可分割數據的路徑清單 |
|
| systemKey |
boolean |
指出容器是否使用系統產生的分割區索引鍵 |
|
| version |
integer (int32) minimum: 1maximum: 2 |
指出分割區索引鍵定義的版本 |
CreateMode
列舉,表示帳戶建立模式。
| 值 | Description |
|---|---|
| Default | |
| Restore |
DataType
套用索引行為的數據類型。
| 值 | Description |
|---|---|
| String | |
| Number | |
| Point | |
| Polygon | |
| LineString | |
| MultiPolygon |
DistanceFunction
用於向量之間距離計算的 distance 函式。
| 值 | Description |
|---|---|
| euclidean | |
| cosine | |
| dotproduct |
ErrorResponse
錯誤回應。
| 名稱 | 類型 | Description |
|---|---|---|
| code |
string |
錯誤碼。 |
| message |
string |
錯誤訊息,指出作業失敗的原因。 |
ExcludedPath
| 名稱 | 類型 | Description |
|---|---|---|
| path |
string |
索引行為套用的路徑。 索引路徑通常以根開頭,並以通配符結尾 (/path/*) |
FullTextIndexPath
代表全文檢索索引路徑。
| 名稱 | 類型 | Description |
|---|---|---|
| path |
string |
檔中全文檢索欄位的路徑。 |
FullTextPath
代表全文檢索路徑規格。
| 名稱 | 類型 | Description |
|---|---|---|
| language |
string |
檔中全文檢索欄位的語言。 |
| path |
string |
檔中全文檢索欄位的路徑。 |
FullTextPolicy
Cosmos DB 全文檢索原則
| 名稱 | 類型 | Description |
|---|---|---|
| defaultLanguage |
string |
全文檢索路徑的預設語言。 |
| fullTextPaths |
FullText 路徑清單 |
IncludedPath
索引中包含的路徑
| 名稱 | 類型 | Description |
|---|---|---|
| indexes |
Indexes[] |
此路徑的索引清單 |
| path |
string |
索引行為套用的路徑。 索引路徑通常以根開頭,並以通配符結尾 (/path/*) |
Indexes
路徑的索引。
| 名稱 | 類型 | 預設值 | Description |
|---|---|---|---|
| dataType | String |
套用索引行為的數據類型。 |
|
| kind | Hash |
表示索引的類型。 |
|
| precision |
integer |
索引的有效位數。 -1 是最大精確度。 |
IndexingMode
表示索引模式。
| 值 | Description |
|---|---|
| consistent | |
| lazy | |
| none |
IndexingPolicy
Cosmos DB 索引原則
| 名稱 | 類型 | 預設值 | Description |
|---|---|---|---|
| automatic |
boolean |
指出索引編製原則是否為自動 |
|
| compositeIndexes |
複合路徑清單清單 |
||
| excludedPaths |
要從索引編製中排除的路徑清單 |
||
| fullTextIndexes |
要包含在全文索引中的路徑清單 |
||
| includedPaths |
要包含在索引中的路徑清單 |
||
| indexingMode | consistent |
表示索引模式。 |
|
| spatialIndexes |
空間特定項目清單 |
||
| vectorIndexes |
要包含在向量索引中的路徑清單 |
IndexKind
表示索引的類型。
| 值 | Description |
|---|---|
| Hash | |
| Range | |
| Spatial |
OperationType
列舉,以指出事件的作業類型。
| 值 | Description |
|---|---|
| Create | |
| Replace | |
| Delete | |
| Recreate | |
| SystemOperation |
PartitionKind
表示用於數據分割的演算法類型。 針對 MultiHash,容器建立支援多個分割區索引鍵 (最多三個最大值)
| 值 | Description |
|---|---|
| Hash | |
| Range | |
| MultiHash |
Resource
Azure Cosmos DB SQL 容器事件的資源
| 名稱 | 類型 | Description |
|---|---|---|
| _rid |
string |
系統產生的屬性。 唯一識別碼。 |
| canUndelete |
string |
此容器的狀態,以識別此容器是否可在同一帳戶中還原。 |
| canUndeleteReason |
string |
這個容器無法在同一個帳戶中恢復的原因。 |
| container |
Cosmos DB SQL 容器資源物件 |
|
| eventTimestamp |
string |
此容器事件發生的時間。 |
| operationType |
此容器事件的作業類型。 |
|
| ownerId |
string |
此 SQL 容器的名稱。 |
| ownerResourceId |
string |
此 SQL 容器的資源識別碼。 |
ResourceRestoreParameters
用來指出還原相關信息的參數。
| 名稱 | 類型 | Description |
|---|---|---|
| restoreSource |
string |
必須起始還原的可還原資料庫帳戶標識碼。 例如:/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
| restoreTimestampInUtc |
string (date-time) |
帳戶必須還原的時間(ISO-8601 格式)。 |
| restoreWithTtlDisabled |
boolean |
指定還原的帳戶是否會在成功還原時停用時間To-Live。 |
RestorableSqlContainerGetResult
Azure Cosmos DB SQL 容器事件
| 名稱 | 類型 | Description |
|---|---|---|
| id |
string |
ARM 資源的唯一資源識別碼。 |
| name |
string |
ARM 資源的名稱。 |
| properties.resource |
Azure Cosmos DB SQL 容器事件的資源 |
|
| type |
string |
Azure 資源的類型。 |
RestorableSqlContainersListResult
列出作業回應,其中包含 SQL 儲存器事件及其內容。
| 名稱 | 類型 | Description |
|---|---|---|
| value |
SQL 容器事件及其屬性的清單。 |
SpatialSpec
| 名稱 | 類型 | Description |
|---|---|---|
| path |
string |
索引行為套用的路徑。 索引路徑通常以根開頭,並以通配符結尾 (/path/*) |
| types |
路徑的空間類型清單 |
SpatialType
指出索引的空間類型。
| 值 | Description |
|---|---|
| Point | |
| LineString | |
| Polygon | |
| MultiPolygon |
UniqueKey
上的唯一索引鍵會對 Azure Cosmos DB 服務中集合中的檔強制執行唯一性限制。
| 名稱 | 類型 | Description |
|---|---|---|
| paths |
string[] |
Azure Cosmos DB 服務中每個文件的路徑清單必須是唯一的 |
UniqueKeyPolicy
針對 Azure Cosmos DB 服務集合中檔指定唯一性條件約束的唯一索引鍵原則組態。
| 名稱 | 類型 | Description |
|---|---|---|
| uniqueKeys |
上唯一索引鍵的清單,該索引鍵會對 Azure Cosmos DB 服務集合中的文件強制執行唯一性條件約束。 |
VectorDataType
表示向量的數據型別。
| 值 | Description |
|---|---|
| float32 | |
| uint8 | |
| int8 | |
| float16 |
VectorEmbedding
表示向量內嵌。 向量內嵌可用來定義檔中的向量欄位。
| 名稱 | 類型 | Description |
|---|---|---|
| dataType |
表示向量的數據型別。 |
|
| dimensions |
integer (int32) |
向量中的維度數目。 |
| distanceFunction |
用於向量之間距離計算的 distance 函式。 |
|
| path |
string |
檔中向量欄位的路徑。 |
VectorEmbeddingPolicy
Cosmos DB 向量內嵌原則
| 名稱 | 類型 | Description |
|---|---|---|
| vectorEmbeddings |
向量內嵌清單 |
VectorIndex
| 名稱 | 類型 | 預設值 | Description |
|---|---|---|---|
| indexingSearchListSize |
integer (int64) minimum: 25maximum: 500 |
100 |
這是在最佳化程序中建置 DiskANN 索引時儲存的近似鄰居候選清單的大小。 較大的值可能會以延遲為代價來改善召回率。 這僅適用於 diskANN 向量索引類型。 |
| path |
string |
檔中向量欄位的路徑。 |
|
| quantizationByteSize |
integer (int64) minimum: 4 |
向量乘積量化中使用的位元組數。 較大的值可能會導致向量搜尋的更好召回率,但會犧牲延遲。 這僅適用於 quantizedFlat 和 diskANN 向量索引類型。 |
|
| type |
向量的索引類型。 目前支援一般、diskANN 和 quantizedFlat。 |
||
| vectorIndexShardKey |
string[] |
向量索引的碎片索引鍵陣列。 這僅適用於 quantizedFlat 和 diskANN 向量索引類型。 |
VectorIndexType
向量的索引類型。 目前支援一般、diskANN 和 quantizedFlat。
| 值 | Description |
|---|---|
| flat | |
| diskANN | |
| quantizedFlat |