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 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
instance
|
path | True |
string |
복원 가능한 데이터베이스 계정의 instanceId GUID입니다. |
|
location
|
path | True |
string |
Cosmos DB 지역, 단어 사이에 공백이 있고 각 단어가 대문자로 표시됩니다. |
|
subscription
|
path | True |
string minLength: 1 |
대상 구독의 ID입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
|
end
|
query |
string |
복원 가능한 Sql 컨테이너 이벤트 피드 종료 시간입니다. |
|
|
restorable
|
query |
string |
SQL 데이터베이스의 리소스 ID입니다. |
|
|
start
|
query |
string |
복원 가능한 Sql 컨테이너 이벤트 피드 시작 시간입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
작업이 성공적으로 완료되었습니다. |
|
| Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | 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\""
}
}
}
}
]
}
정의
| Name | Description |
|---|---|
|
Client |
. |
|
Client |
Cosmos DB 클라이언트 암호화 정책입니다. |
|
Cloud |
서비스의 오류 응답입니다. |
|
Composite |
|
|
Composite |
복합 경로의 정렬 순서입니다. |
|
Computed |
계산된 속성의 정의 |
|
Conflict |
충돌 해결 모드를 나타냅니다. |
|
Conflict |
컨테이너에 대한 충돌 해결 정책입니다. |
| Container |
Cosmos DB SQL 컨테이너 리소스 개체 |
|
Container |
데이터를 여러 파티션으로 분할하는 데 사용할 파티션 키 구성 |
|
Create |
계정 생성 모드를 나타내는 열거형입니다. |
|
Data |
인덱싱 동작이 적용되는 데이터 형식입니다. |
|
Distance |
벡터 간 거리 계산에 사용할 거리 함수입니다. |
|
Error |
오류 응답. |
|
Excluded |
|
|
Full |
전체 텍스트 인덱스 경로를 나타냅니다. |
|
Full |
전체 텍스트 경로 사양을 나타냅니다. |
|
Full |
Cosmos DB 전체 텍스트 정책 |
|
Included |
인덱싱에 포함된 경로 |
| Indexes |
경로에 대한 인덱스입니다. |
|
Indexing |
인덱싱 모드를 나타냅니다. |
|
Indexing |
Cosmos DB 인덱싱 정책 |
|
Index |
인덱스의 형식을 나타냅니다. |
|
Operation |
이벤트의 작업 유형을 나타내는 열거형입니다. |
|
Partition |
분할에 사용되는 알고리즘의 종류를 나타냅니다. MultiHash의 경우 컨테이너 만들기에 대해 여러 파티션 키(최대 3개까지)가 지원됩니다. |
| Resource |
Azure Cosmos DB SQL 컨테이너 이벤트의 리소스 |
|
Resource |
복원에 대한 정보를 나타내는 매개 변수입니다. |
|
Restorable |
Azure Cosmos DB SQL 컨테이너 이벤트 |
|
Restorable |
SQL 컨테이너 이벤트 및 해당 속성을 포함하는 List 작업 응답입니다. |
|
Spatial |
|
|
Spatial |
인덱스의 공간 유형을 나타냅니다. |
|
Unique |
이 고유 키는 Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 적용합니다. |
|
Unique |
Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 지정하기 위한 고유 키 정책 구성입니다. |
|
Vector |
벡터의 데이터 형식을 나타냅니다. |
|
Vector |
벡터 포함을 나타냅니다. 벡터 포함은 문서에서 벡터 필드를 정의하는 데 사용됩니다. |
|
Vector |
Cosmos DB 벡터 포함 정책 |
|
Vector |
|
|
Vector |
벡터의 인덱스 형식입니다. 현재 flat, diskANN 및 quantizedFlat이 지원됩니다. |
ClientEncryptionIncludedPath
.
| Name | 형식 | Description |
|---|---|---|
| clientEncryptionKeyId |
string |
경로를 암호화하는 데 사용할 클라이언트 암호화 키의 식별자입니다. |
| encryptionAlgorithm |
string |
사용할 암호화 알고리즘입니다. 예 - AEAD_AES_256_CBC_HMAC_SHA256. |
| encryptionType |
string |
수행할 암호화 유형입니다. 예 - 결정적, 임의. |
| path |
string |
암호화해야 하는 경로입니다. |
ClientEncryptionPolicy
Cosmos DB 클라이언트 암호화 정책입니다.
| Name | 형식 | Description |
|---|---|---|
| includedPaths |
경로별 설정과 함께 암호화가 필요한 항목의 경로입니다. |
|
| policyFormatVersion |
integer (int32) minimum: 1maximum: 2 |
클라이언트 암호화 정책 정의의 버전입니다. 지원되는 버전은 1과 2입니다. 버전 2는 ID 및 파티션 키 경로 암호화를 지원합니다. |
CloudError
서비스의 오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| error |
오류 응답. |
CompositePath
| Name | 형식 | Description |
|---|---|---|
| order |
복합 경로의 정렬 순서입니다. |
|
| path |
string |
인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. |
CompositePathSortOrder
복합 경로의 정렬 순서입니다.
| 값 | Description |
|---|---|
| ascending | |
| descending |
ComputedProperty
계산된 속성의 정의
| Name | 형식 | Description |
|---|---|---|
| name |
string |
계산된 속성의 이름(예: "cp_lowerName") |
| query |
string |
계산된 속성의 값을 평가하는 쿼리(예: "SELECT VALUE LOWER(c.name) FROM c" |
ConflictResolutionMode
충돌 해결 모드를 나타냅니다.
| 값 | Description |
|---|---|
| LastWriterWins | |
| Custom |
ConflictResolutionPolicy
컨테이너에 대한 충돌 해결 정책입니다.
| Name | 형식 | Default value | Description |
|---|---|---|---|
| conflictResolutionPath |
string |
LastWriterWins 모드의 경우 충돌 해결 경로입니다. |
|
| conflictResolutionProcedure |
string |
사용자 지정 모드의 경우 충돌을 해결하는 절차입니다. |
|
| mode | LastWriterWins |
충돌 해결 모드를 나타냅니다. |
Container
Cosmos DB SQL 컨테이너 리소스 개체
| Name | 형식 | Default value | Description |
|---|---|---|---|
| _etag |
string |
낙관적 동시성 제어에 필요한 리소스 etag를 나타내는 시스템 생성 속성입니다. |
|
| _rid |
string |
시스템 생성 속성입니다. 고유 식별자입니다. |
|
| _self |
string |
컨테이너 리소스의 주소 지정 가능 경로를 지정하는 시스템 생성 속성입니다. |
|
| _ts |
number |
자원의 마지막으로 업데이트된 시간소인을 나타내는 시스템 생성 특성입니다. |
|
| analyticalStorageTtl |
integer (int64) |
분석 TTL. |
|
| clientEncryptionPolicy |
컨테이너에 대한 클라이언트 암호화 정책입니다. |
||
| computedProperties |
계산된 속성 목록 |
||
| conflictResolutionPolicy |
컨테이너에 대한 충돌 해결 정책입니다. |
||
| createMode | Default |
리소스 생성 모드를 나타내는 열거형입니다. |
|
| defaultTtl |
integer |
기본 TSL(Time to Live) |
|
| fullTextPolicy |
컨테이너에 대한 FullText 정책입니다. |
||
| id |
string |
Cosmos DB SQL 컨테이너의 이름 |
|
| indexingPolicy |
인덱싱 정책의 구성입니다. 기본적으로 인덱싱은 컨테이너 내의 모든 문서 경로에 대해 자동입니다. |
||
| partitionKey |
데이터를 여러 파티션으로 분할하는 데 사용할 파티션 키 구성 |
||
| restoreParameters |
복원에 대한 정보를 나타내는 매개 변수 |
||
| uniqueKeyPolicy |
Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 지정하기 위한 고유 키 정책 구성입니다. |
||
| vectorEmbeddingPolicy |
컨테이너에 대한 벡터 포함 정책입니다. |
ContainerPartitionKey
데이터를 여러 파티션으로 분할하는 데 사용할 파티션 키 구성
| Name | 형식 | Default value | Description |
|---|---|---|---|
| kind | Hash |
분할에 사용되는 알고리즘의 종류를 나타냅니다. MultiHash의 경우 컨테이너 만들기에 대해 여러 파티션 키(최대 3개까지)가 지원됩니다. |
|
| paths |
string[] |
컨테이너 내에서 분할할 수 있는 데이터를 사용하는 경로 목록 |
|
| systemKey |
boolean |
컨테이너가 시스템 생성 파티션 키를 사용하고 있는지 여부를 나타냅니다. |
|
| version |
integer (int32) minimum: 1maximum: 2 |
파티션 키 정의의 버전을 나타냅니다. |
CreateMode
계정 생성 모드를 나타내는 열거형입니다.
| 값 | Description |
|---|---|
| Default | |
| Restore |
DataType
인덱싱 동작이 적용되는 데이터 형식입니다.
| 값 | Description |
|---|---|
| String | |
| Number | |
| Point | |
| Polygon | |
| LineString | |
| MultiPolygon |
DistanceFunction
벡터 간 거리 계산에 사용할 거리 함수입니다.
| 값 | Description |
|---|---|
| euclidean | |
| cosine | |
| dotproduct |
ErrorResponse
오류 응답.
| Name | 형식 | Description |
|---|---|---|
| code |
string |
오류 코드입니다. |
| message |
string |
작업이 실패한 이유를 나타내는 오류 메시지입니다. |
ExcludedPath
| Name | 형식 | Description |
|---|---|---|
| path |
string |
인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. |
FullTextIndexPath
전체 텍스트 인덱스 경로를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| path |
string |
문서의 전체 텍스트 필드 경로입니다. |
FullTextPath
전체 텍스트 경로 사양을 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| language |
string |
문서의 전체 텍스트 필드 언어입니다. |
| path |
string |
문서의 전체 텍스트 필드 경로입니다. |
FullTextPolicy
Cosmos DB 전체 텍스트 정책
| Name | 형식 | Description |
|---|---|---|
| defaultLanguage |
string |
전체 텍스트 경로의 기본 언어입니다. |
| fullTextPaths |
전체 텍스트 경로 목록 |
IncludedPath
인덱싱에 포함된 경로
| Name | 형식 | Description |
|---|---|---|
| indexes |
Indexes[] |
이 경로에 대한 인덱스 목록 |
| path |
string |
인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. |
Indexes
경로에 대한 인덱스입니다.
| Name | 형식 | Default value | Description |
|---|---|---|---|
| dataType | String |
인덱싱 동작이 적용되는 데이터 형식입니다. |
|
| kind | Hash |
인덱스의 형식을 나타냅니다. |
|
| precision |
integer |
인덱스의 전체 자릿수입니다. -1은 최대 정밀도입니다. |
IndexingMode
인덱싱 모드를 나타냅니다.
| 값 | Description |
|---|---|
| consistent | |
| lazy | |
| none |
IndexingPolicy
Cosmos DB 인덱싱 정책
| Name | 형식 | Default value | 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의 경우 컨테이너 만들기에 대해 여러 파티션 키(최대 3개까지)가 지원됩니다.
| 값 | Description |
|---|---|
| Hash | |
| Range | |
| MultiHash |
Resource
Azure Cosmos DB SQL 컨테이너 이벤트의 리소스
| Name | 형식 | Description |
|---|---|---|
| _rid |
string |
시스템 생성 속성입니다. 고유 식별자입니다. |
| canUndelete |
string |
이 컨테이너가 동일한 계정에서 복원 가능한지 식별하는 이 컨테이너의 상태입니다. |
| canUndeleteReason |
string |
이 컨테이너를 동일한 계정으로 복원할 수 없는 이유입니다. |
| container |
Cosmos DB SQL 컨테이너 리소스 개체 |
|
| eventTimestamp |
string |
이 컨테이너 이벤트가 발생한 시기입니다. |
| operationType |
이 컨테이너 이벤트의 작업 유형입니다. |
|
| ownerId |
string |
이 SQL 컨테이너의 이름입니다. |
| ownerResourceId |
string |
이 SQL 컨테이너의 리소스 ID입니다. |
ResourceRestoreParameters
복원에 대한 정보를 나타내는 매개 변수입니다.
| Name | 형식 | Description |
|---|---|---|
| restoreSource |
string |
복원을 시작해야 하는 복원 가능한 데이터베이스 계정의 ID입니다. 예: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
| restoreTimestampInUtc |
string (date-time) |
계정을 복원해야 하는 시간(ISO-8601 형식)입니다. |
| restoreWithTtlDisabled |
boolean |
복원이 성공하면 복원된 계정에 Time-To-Live 사용하지 않도록 설정할지 여부를 지정합니다. |
RestorableSqlContainerGetResult
Azure Cosmos DB SQL 컨테이너 이벤트
| Name | 형식 | Description |
|---|---|---|
| id |
string |
ARM 리소스의 고유 리소스 식별자입니다. |
| name |
string |
ARM 리소스의 이름입니다. |
| properties.resource |
Azure Cosmos DB SQL 컨테이너 이벤트의 리소스 |
|
| type |
string |
Azure 리소스의 유형입니다. |
RestorableSqlContainersListResult
SQL 컨테이너 이벤트 및 해당 속성을 포함하는 List 작업 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| value |
SQL 컨테이너 이벤트 및 해당 속성 목록입니다. |
SpatialSpec
| Name | 형식 | Description |
|---|---|---|
| path |
string |
인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. |
| types |
경로의 공간 유형 목록 |
SpatialType
인덱스의 공간 유형을 나타냅니다.
| 값 | Description |
|---|---|
| Point | |
| LineString | |
| Polygon | |
| MultiPolygon |
UniqueKey
이 고유 키는 Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 적용합니다.
| Name | 형식 | Description |
|---|---|---|
| paths |
string[] |
경로 목록은 Azure Cosmos DB 서비스의 각 문서에 대해 고유해야 합니다. |
UniqueKeyPolicy
Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 지정하기 위한 고유 키 정책 구성입니다.
| Name | 형식 | Description |
|---|---|---|
| uniqueKeys |
Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 적용하는 고유 키 목록입니다. |
VectorDataType
벡터의 데이터 형식을 나타냅니다.
| 값 | Description |
|---|---|
| float32 | |
| uint8 | |
| int8 | |
| float16 |
VectorEmbedding
벡터 포함을 나타냅니다. 벡터 포함은 문서에서 벡터 필드를 정의하는 데 사용됩니다.
| Name | 형식 | Description |
|---|---|---|
| dataType |
벡터의 데이터 형식을 나타냅니다. |
|
| dimensions |
integer (int32) |
벡터의 차원 수입니다. |
| distanceFunction |
벡터 간 거리 계산에 사용할 거리 함수입니다. |
|
| path |
string |
문서의 벡터 필드 경로입니다. |
VectorEmbeddingPolicy
Cosmos DB 벡터 포함 정책
| Name | 형식 | Description |
|---|---|---|
| vectorEmbeddings |
벡터 포함 목록 |
VectorIndex
| Name | 형식 | Default value | Description |
|---|---|---|---|
| indexingSearchListSize |
integer (int64) minimum: 25maximum: 500 |
100 |
이는 최적화 프로세스의 일부로 DiskANN 인덱스를 빌드하는 동안 저장된 대략적인 이웃의 후보 목록의 크기입니다. 값이 크면 대기 시간이 줄어들면서 재현율이 향상될 수 있습니다. 이는 diskANN 벡터 인덱스 유형에만 적용됩니다. |
| path |
string |
문서의 벡터 필드 경로입니다. |
|
| quantizationByteSize |
integer (int64) minimum: 4 |
벡터의 곱 양자화에 사용되는 바이트 수입니다. 값이 클수록 대기 시간을 희생하면서 벡터 검색에 대한 재현율이 향상될 수 있습니다. 이는 quantizedFlat 및 diskANN 벡터 인덱스 유형에만 적용됩니다. |
|
| type |
벡터의 인덱스 형식입니다. 현재 flat, diskANN 및 quantizedFlat이 지원됩니다. |
||
| vectorIndexShardKey |
string[] |
벡터 인덱스에 대한 샤드 키 배열입니다. 이는 quantizedFlat 및 diskANN 벡터 인덱스 유형에만 적용됩니다. |
VectorIndexType
벡터의 인덱스 형식입니다. 현재 flat, diskANN 및 quantizedFlat이 지원됩니다.
| 값 | Description |
|---|---|
| flat | |
| diskANN | |
| quantizedFlat |