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 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
location
|
path | True |
string |
数据库的位置 |
|
managed
|
path | True |
string |
托管实例的名称。 |
|
subscription
|
path | True |
string |
标识 Azure 订阅的订阅 ID。 |
|
api-version
|
query | True |
string |
要用于请求的 API 版本。 |
|
database
|
query |
是针对实时数据库、仅删除的数据库还是所有数据库进行查询。 |
||
|
only
|
query |
boolean |
是否仅获取每个数据库的最新备份。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
已成功检索备份列表。 |
|
| Other Status Codes |
错误响应: ***
|
示例
Get all long term retention backups under the managed instance.
示例请求
示例响应
{
"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"
}
}
]
}
定义
| 名称 | 说明 |
|---|---|
|
Backup |
LTR 备份的 BackupStorageAccessTier |
|
Backup |
备份的存储冗余类型 |
|
database |
是针对实时数据库、仅删除的数据库还是所有数据库进行查询。 |
|
Error |
资源管理错误附加信息。 |
|
Error |
错误详细信息。 |
|
Error |
错误响应 |
|
Managed |
托管数据库的长期保留备份。 |
|
Managed |
托管数据库的长期保留备份列表。 |
BackupStorageAccessTier
LTR 备份的 BackupStorageAccessTier
| 值 | 说明 |
|---|---|
| Hot | |
| Archive |
BackupStorageRedundancy
备份的存储冗余类型
| 值 | 说明 |
|---|---|
| Geo | |
| Local | |
| Zone | |
| GeoZone |
databaseState
是针对实时数据库、仅删除的数据库还是所有数据库进行查询。
| 值 | 说明 |
|---|---|
| All | |
| Live | |
| Deleted |
ErrorAdditionalInfo
资源管理错误附加信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| info |
object |
其他信息。 |
| type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| additionalInfo |
错误附加信息。 |
|
| code |
string |
错误代码。 |
| details |
错误详细信息。 |
|
| message |
string |
错误消息。 |
| target |
string |
错误目标。 |
ErrorResponse
错误响应
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误对象。 |
ManagedInstanceLongTermRetentionBackup
托管数据库的长期保留备份。
| 名称 | 类型 | 说明 |
|---|---|---|
| id |
string |
资源 ID。 |
| name |
string |
资源名称。 |
| properties.backupExpirationTime |
string (date-time) |
长期保留备份过期的时间。 |
| properties.backupStorageAccessTier |
LTR 备份的 BackupStorageAccessTier |
|
| properties.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 |
结果数组。 |