共用方式為


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

string

可還原資料庫帳戶的 instanceId GUID。

location
path True

string

Cosmos DB 區域,單字之間有空格,每個單字都大寫。

subscriptionId
path True

string

minLength: 1

目標訂用帳戶的標識碼。

api-version
query True

string

minLength: 1

用於此作業的 API 版本。

endTime
query

string

可還原的 Sql 容器事件摘要結束時間。

restorableSqlDatabaseRid
query

string

SQL 資料庫的資源識別碼。

startTime
query

string

可還原的 SQL 容器事件摘要開始時間。

回應

名稱 類型 Description
200 OK

RestorableSqlContainersListResult

作業已順利完成。

Other Status Codes

CloudError

描述作業失敗原因的錯誤回應。

安全性

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
ClientEncryptionIncludedPath

.

ClientEncryptionPolicy

Cosmos DB 用戶端加密原則。

CloudError

來自服務的錯誤回應。

CompositePath
CompositePathSortOrder

複合路徑的排序順序。

ComputedProperty

計算屬性的定義

ConflictResolutionMode

表示衝突解決模式。

ConflictResolutionPolicy

容器的衝突解決原則。

Container

Cosmos DB SQL 容器資源物件

ContainerPartitionKey

分割區索引鍵的組態,用於將數據分割成多個分割區

CreateMode

列舉,表示帳戶建立模式。

DataType

套用索引行為的數據類型。

DistanceFunction

用於向量之間距離計算的 distance 函式。

ErrorResponse

錯誤回應。

ExcludedPath
FullTextIndexPath

代表全文檢索索引路徑。

FullTextPath

代表全文檢索路徑規格。

FullTextPolicy

Cosmos DB 全文檢索原則

IncludedPath

索引中包含的路徑

Indexes

路徑的索引。

IndexingMode

表示索引模式。

IndexingPolicy

Cosmos DB 索引原則

IndexKind

表示索引的類型。

OperationType

列舉,以指出事件的作業類型。

PartitionKind

表示用於數據分割的演算法類型。 針對 MultiHash,容器建立支援多個分割區索引鍵 (最多三個最大值)

Resource

Azure Cosmos DB SQL 容器事件的資源

ResourceRestoreParameters

用來指出還原相關信息的參數。

RestorableSqlContainerGetResult

Azure Cosmos DB SQL 容器事件

RestorableSqlContainersListResult

列出作業回應,其中包含 SQL 儲存器事件及其內容。

SpatialSpec
SpatialType

指出索引的空間類型。

UniqueKey

上的唯一索引鍵會對 Azure Cosmos DB 服務中集合中的檔強制執行唯一性限制。

UniqueKeyPolicy

針對 Azure Cosmos DB 服務集合中檔指定唯一性條件約束的唯一索引鍵原則組態。

VectorDataType

表示向量的數據型別。

VectorEmbedding

表示向量內嵌。 向量內嵌可用來定義檔中的向量欄位。

VectorEmbeddingPolicy

Cosmos DB 向量內嵌原則

VectorIndex
VectorIndexType

向量的索引類型。 目前支援一般、diskANN 和 quantizedFlat。

ClientEncryptionIncludedPath

.

名稱 類型 Description
clientEncryptionKeyId

string

要用來加密路徑之用戶端加密金鑰的識別碼。

encryptionAlgorithm

string

將使用的加密演算法。 例如 - AEAD_AES_256_CBC_HMAC_SHA256。

encryptionType

string

要執行的加密類型。 例如 - 決定性、隨機化。

path

string

需要加密的路徑。

ClientEncryptionPolicy

Cosmos DB 用戶端加密原則。

名稱 類型 Description
includedPaths

ClientEncryptionIncludedPath[]

需要加密的項目路徑以及路徑特定設定。

policyFormatVersion

integer (int32)

minimum: 1
maximum: 2

用戶端加密原則定義的版本。 支援的版本為 1 和 2。 第 2 版支援識別碼和資料分割金鑰路徑加密。

CloudError

來自服務的錯誤回應。

名稱 類型 Description
error

ErrorResponse

錯誤回應。

CompositePath

名稱 類型 Description
order

CompositePathSortOrder

複合路徑的排序順序。

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

ConflictResolutionMode

LastWriterWins

表示衝突解決模式。

Container

Cosmos DB SQL 容器資源物件

名稱 類型 預設值 Description
_etag

string

系統產生的屬性,代表樂觀並行控制所需的資源 etag。

_rid

string

系統產生的屬性。 唯一識別碼。

_self

string

系統產生的內容,指定容器資源的可定址路徑。

_ts

number

系統產生的內容,表示資源的上次更新時間戳記。

analyticalStorageTtl

integer (int64)

分析TTL。

clientEncryptionPolicy

ClientEncryptionPolicy

容器的用戶端加密原則。

computedProperties

ComputedProperty[]

計算屬性的清單

conflictResolutionPolicy

ConflictResolutionPolicy

容器的衝突解決原則。

createMode

CreateMode

Default

列舉,表示資源建立模式。

defaultTtl

integer

默認存留時間

fullTextPolicy

FullTextPolicy

容器的 FullText 原則。

id

string

Cosmos DB SQL 容器的名稱

indexingPolicy

IndexingPolicy

編製索引原則的組態。 根據預設,容器內所有文件路徑的索引會自動編製索引

partitionKey

ContainerPartitionKey

分割區索引鍵的組態,用於將數據分割成多個分割區

restoreParameters

ResourceRestoreParameters

用來指出還原相關信息的參數

uniqueKeyPolicy

UniqueKeyPolicy

針對 Azure Cosmos DB 服務集合中檔指定唯一性條件約束的唯一索引鍵原則組態。

vectorEmbeddingPolicy

VectorEmbeddingPolicy

容器的向量內嵌原則。

ContainerPartitionKey

分割區索引鍵的組態,用於將數據分割成多個分割區

名稱 類型 預設值 Description
kind

PartitionKind

Hash

表示用於數據分割的演算法類型。 針對 MultiHash,容器建立支援多個分割區索引鍵 (最多三個最大值)

paths

string[]

使用容器內可分割數據的路徑清單

systemKey

boolean

指出容器是否使用系統產生的分割區索引鍵

version

integer (int32)

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

FullTextPath[]

FullText 路徑清單

IncludedPath

索引中包含的路徑

名稱 類型 Description
indexes

Indexes[]

此路徑的索引清單

path

string

索引行為套用的路徑。 索引路徑通常以根開頭,並以通配符結尾 (/path/*)

Indexes

路徑的索引。

名稱 類型 預設值 Description
dataType

DataType

String

套用索引行為的數據類型。

kind

IndexKind

Hash

表示索引的類型。

precision

integer

索引的有效位數。 -1 是最大精確度。

IndexingMode

表示索引模式。

Description
consistent
lazy
none

IndexingPolicy

Cosmos DB 索引原則

名稱 類型 預設值 Description
automatic

boolean

指出索引編製原則是否為自動

compositeIndexes

CompositePath[]

複合路徑清單清單

excludedPaths

ExcludedPath[]

要從索引編製中排除的路徑清單

fullTextIndexes

FullTextIndexPath[]

要包含在全文索引中的路徑清單

includedPaths

IncludedPath[]

要包含在索引中的路徑清單

indexingMode

IndexingMode

consistent

表示索引模式。

spatialIndexes

SpatialSpec[]

空間特定項目清單

vectorIndexes

VectorIndex[]

要包含在向量索引中的路徑清單

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

Container

Cosmos DB SQL 容器資源物件

eventTimestamp

string

此容器事件發生的時間。

operationType

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

Resource

Azure Cosmos DB SQL 容器事件的資源

type

string

Azure 資源的類型。

RestorableSqlContainersListResult

列出作業回應,其中包含 SQL 儲存器事件及其內容。

名稱 類型 Description
value

RestorableSqlContainerGetResult[]

SQL 容器事件及其屬性的清單。

SpatialSpec

名稱 類型 Description
path

string

索引行為套用的路徑。 索引路徑通常以根開頭,並以通配符結尾 (/path/*)

types

SpatialType[]

路徑的空間類型清單

SpatialType

指出索引的空間類型。

Description
Point
LineString
Polygon
MultiPolygon

UniqueKey

上的唯一索引鍵會對 Azure Cosmos DB 服務中集合中的檔強制執行唯一性限制。

名稱 類型 Description
paths

string[]

Azure Cosmos DB 服務中每個文件的路徑清單必須是唯一的

UniqueKeyPolicy

針對 Azure Cosmos DB 服務集合中檔指定唯一性條件約束的唯一索引鍵原則組態。

名稱 類型 Description
uniqueKeys

UniqueKey[]

上唯一索引鍵的清單,該索引鍵會對 Azure Cosmos DB 服務集合中的文件強制執行唯一性條件約束。

VectorDataType

表示向量的數據型別。

Description
float32
uint8
int8
float16

VectorEmbedding

表示向量內嵌。 向量內嵌可用來定義檔中的向量欄位。

名稱 類型 Description
dataType

VectorDataType

表示向量的數據型別。

dimensions

integer (int32)

向量中的維度數目。

distanceFunction

DistanceFunction

用於向量之間距離計算的 distance 函式。

path

string

檔中向量欄位的路徑。

VectorEmbeddingPolicy

Cosmos DB 向量內嵌原則

名稱 類型 Description
vectorEmbeddings

VectorEmbedding[]

向量內嵌清單

VectorIndex

名稱 類型 預設值 Description
indexingSearchListSize

integer (int64)

minimum: 25
maximum: 500
100

這是在最佳化程序中建置 DiskANN 索引時儲存的近似鄰居候選清單的大小。 較大的值可能會以延遲為代價來改善召回率。 這僅適用於 diskANN 向量索引類型。

path

string

檔中向量欄位的路徑。

quantizationByteSize

integer (int64)

minimum: 4

向量乘積量化中使用的位元組數。 較大的值可能會導致向量搜尋的更好召回率,但會犧牲延遲。 這僅適用於 quantizedFlat 和 diskANN 向量索引類型。

type

VectorIndexType

向量的索引類型。 目前支援一般、diskANN 和 quantizedFlat。

vectorIndexShardKey

string[]

向量索引的碎片索引鍵陣列。 這僅適用於 quantizedFlat 和 diskANN 向量索引類型。

VectorIndexType

向量的索引類型。 目前支援一般、diskANN 和 quantizedFlat。

Description
flat
diskANN
quantizedFlat