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

Long Term Retention Managed Instance Backups - List By Location

服务:

SQL Database

API 版本:

2021-11-01

Lists给定位置中托管数据库的长期保留备份。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstanceBackups?api-version=2021-11-01

具有可选参数:

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

URI 参数

名称	在	必需	类型	说明
locationName	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		错误响应：*** 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

示例

Get all long term retention backups under the location.

示例请求

HTTP

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

Java

/**
 * Samples for LongTermRetentionManagedInstanceBackups ListByLocation.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionBackupListByLocation.json
     */
    /**
     * Sample code: Get all long term retention backups under the location.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheLocation(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionManagedInstanceBackups()
            .listByLocation("japaneast", null, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:

200

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

定义

名称	说明
BackupStorageRedundancy	备份的存储冗余类型
databaseState	是仅针对实时数据库、仅针对已删除的数据库还是针对所有数据库进行查询。
ManagedInstanceLongTermRetentionBackup	托管数据库的长期保留备份。
ManagedInstanceLongTermRetentionBackupListResult	托管数据库 () 的长期保留备份列表。

BackupStorageRedundancy

备份的存储冗余类型

名称	类型	说明
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

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

名称	类型	说明
All	string
Deleted	string
Live	string

ManagedInstanceLongTermRetentionBackup

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

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.backupExpirationTime	string	长期保留备份过期的时间。
properties.backupStorageRedundancy	BackupStorageRedundancy	备份的存储冗余类型
properties.backupTime	string	备份的时间
properties.databaseDeletionTime	string	数据库的删除时间
properties.databaseName	string	备份所属的数据库的名称
properties.managedInstanceCreateTime	string	实例的创建时间。
properties.managedInstanceName	string	备份数据库所属的托管实例。
type	string	资源类型。

ManagedInstanceLongTermRetentionBackupListResult

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

名称	类型	说明
nextLink	string	用于检索下一页结果的链接。
value	ManagedInstanceLongTermRetentionBackup[]	结果数组。