你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Restorable Sql Resources - List

参考

服务:: Cosmos DB Resource Provider

API 版本:: 2024-11-15

返回在给定时间戳和位置的帐户上存在的数据库和容器组合的列表。这有助于在方案中验证给定时间戳和位置存在的资源。此 API 需要“Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read”权限。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlResources?api-version=2024-11-15

具有可选参数:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlResources?api-version=2024-11-15&restoreLocation={restoreLocation}&restoreTimestampInUtc={restoreTimestampInUtc}

URI 参数

名称	在	必需	类型	说明
instanceId	path	True	string	可还原数据库帐户的 instanceId GUID。
location	path	True	string	Cosmos DB 区域，单词和每个单词的大小写之间的空格。
subscriptionId	path	True	string	目标订阅的 ID。
api-version	query	True	string	用于此操作的 API 版本。
restoreLocation	query		string	可还原资源所在的位置。
restoreTimestampInUtc	query		string	可还原资源存在时的时间戳。

响应

名称	类型	说明
200 OK	RestorableSqlResourcesListResult	操作已成功完成。
Other Status Codes	CloudError	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

CosmosDBRestorableSqlResourceList

示例请求

HTTP

GET https://management.azure.com/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlResources?api-version=2024-11-15&restoreLocation=WestUS&restoreTimestampInUtc=06/01/2022 4:56

示例响应

状态代码:: 200

{
  "value": [
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database1",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database1",
      "databaseName": "Database1",
      "collectionNames": [
        "Container1"
      ]
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database2",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database2",
      "databaseName": "Database2",
      "collectionNames": [
        "Container1",
        "Container2"
      ]
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database3",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database3",
      "databaseName": "Database3",
      "collectionNames": []
    }
  ]
}

定义

名称	说明
CloudError	服务的错误响应。
ErrorResponse	错误响应。
RestorableSqlResourcesGetResult	要还原的特定数据库。
RestorableSqlResourcesListResult	包含可还原 SQL 资源的 List 操作响应。

CloudError

服务的错误响应。

名称	类型	说明
error	ErrorResponse	错误响应。

ErrorResponse

错误响应。

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败的原因的错误消息。

RestorableSqlResourcesGetResult

要还原的特定数据库。

名称	类型	说明
collectionNames	string[]	可用于还原的集合的名称。
databaseName	string	可用于还原的数据库的名称。
id	string	ARM 资源的唯一资源标识符。
name	string	ARM 资源的名称。
type	string	Azure 资源的类型。

RestorableSqlResourcesListResult

包含可还原 SQL 资源的 List 操作响应。

名称	类型	说明
value	RestorableSqlResourcesGetResult[]	可还原的 SQL 资源列表，包括数据库和集合名称。

通过