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

Long Term Retention Managed Instance Backups - List By Instance

列出给定托管实例的长期保留备份。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?api-version=2023-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}&api-version=2023-08-01

URI 参数

名称 必需 类型 说明
locationName
path True

string

数据库的位置

managedInstanceName
path True

string

托管实例的名称。

subscriptionId
path True

string

标识 Azure 订阅的订阅 ID。

api-version
query True

string

要用于请求的 API 版本。

databaseState
query

databaseState

是针对实时数据库、仅删除的数据库还是所有数据库进行查询。

onlyLatestPerDatabase
query

boolean

是否仅获取每个数据库的最新备份。

响应

名称 类型 说明
200 OK

ManagedInstanceLongTermRetentionBackupListResult

已成功检索备份列表。

Other Status Codes

ErrorResponse

错误响应: ***

  • 400 ManagedInstanceStoppingOrStopped - 实例处于停止/停止状态时提交的冲突作

  • 400 ManagedInstanceStarting - 实例处于启动状态时提交的冲突作

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

示例

Get all long term retention backups under the managed instance.

示例请求

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2023-08-01

示例响应

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase1/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000;Archive",
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000;Archive",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase1",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo",
        "backupStorageAccessTier": "Archive"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase2/longTermRetentionManagedInstanceBackups/12341234-1234-1234-1234-123123123123;131657960820000000;Hot",
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000;Hot",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase2",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo",
        "backupStorageAccessTier": "Hot"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase3/longTermRetentionManagedInstanceBackups/43214321-4321-4321-4321-321321321321;131677960820000000;Archive",
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo",
        "backupStorageAccessTier": "Archive"
      }
    }
  ]
}

定义

名称 说明
BackupStorageAccessTier

LTR 备份的 BackupStorageAccessTier

BackupStorageRedundancy

备份的存储冗余类型

databaseState

是针对实时数据库、仅删除的数据库还是所有数据库进行查询。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

ManagedInstanceLongTermRetentionBackup

托管数据库的长期保留备份。

ManagedInstanceLongTermRetentionBackupListResult

托管数据库的长期保留备份列表。

BackupStorageAccessTier

LTR 备份的 BackupStorageAccessTier

说明
Hot
Archive

BackupStorageRedundancy

备份的存储冗余类型

说明
Geo
Local
Zone
GeoZone

databaseState

是针对实时数据库、仅删除的数据库还是所有数据库进行查询。

说明
All
Live
Deleted

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

ManagedInstanceLongTermRetentionBackup

托管数据库的长期保留备份。

名称 类型 说明
id

string

资源 ID。

name

string

资源名称。

properties.backupExpirationTime

string (date-time)

长期保留备份过期的时间。

properties.backupStorageAccessTier

BackupStorageAccessTier

LTR 备份的 BackupStorageAccessTier

properties.backupStorageRedundancy

BackupStorageRedundancy

备份的存储冗余类型

properties.backupTime

string (date-time)

备份的时间

properties.databaseDeletionTime

string (date-time)

数据库的删除时间

properties.databaseName

string

备份所属的数据库的名称

properties.managedInstanceCreateTime

string (date-time)

实例的创建时间。

properties.managedInstanceName

string

备份数据库所属的托管实例。

type

string

资源类型。

ManagedInstanceLongTermRetentionBackupListResult

托管数据库的长期保留备份列表。

名称 类型 说明
nextLink

string

用于检索下一页结果的链接。

value

ManagedInstanceLongTermRetentionBackup[]

结果数组。