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

Long Term Retention Backups - List By Server

Service:

SQL Database

API Version:

2021-11-01

Lists给定服务器的长期保留备份。

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

With optional parameters:

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

URI 参数

名称	在	必需	类型	说明
locationName	path	True	string	数据库的位置
longTermRetentionServerName	path	True	string	服务器名称
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。
databaseState	query		databaseState	是仅针对实时数据库、仅针对已删除的数据库还是针对所有数据库进行查询。
onlyLatestPerDatabase	query		boolean	是否仅获取每个数据库的最新备份。

响应

名称	类型	说明
200 OK	LongTermRetentionBackupListResult	已成功检索备份列表。
Other Status Codes		错误响应：*** 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

示例

Get all long term retention backups under the server.

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for LongTermRetentionBackups ListByServer. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupListByServer.
     * json
     */
    /**
     * Sample code: Get all long term retention backups under the server.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().listByServer("japaneast",
            "testserver", null, null, 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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase1/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "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/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase2/longTermRetentionBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-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/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase3/longTermRetentionBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

定义

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

BackupStorageRedundancy

复制的备份的存储冗余类型

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

databaseState

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

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

LongTermRetentionBackup

长期保留备份。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.backupExpirationTime	string	长期保留备份过期的时间。
properties.backupStorageRedundancy	BackupStorageRedundancy	备份的存储冗余类型
properties.backupTime	string	备份的时间
properties.databaseDeletionTime	string	数据库的删除时间
properties.databaseName	string	备份所属的数据库的名称
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	备份的存储冗余类型
properties.serverCreateTime	string	服务器的创建时间。
properties.serverName	string	备份数据库所属的服务器名称。
type	string	资源类型。

LongTermRetentionBackupListResult

长期保留备份的列表。

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