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

Long Term Retention Managed Instance Backups - List By Resource Group Database

参考

Service:: SQL Database

API Version:: 2021-11-01

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

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

With optional parameters:

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

URI 参数

名称	在	必需	类型	说明
databaseName	path	True	string	托管数据库的名称。
locationName	path	True	string	数据库的位置
managedInstanceName	path	True	string	托管实例的名称。
resourceGroupName	path	True	string	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
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 - 指定的服务器不存在于指定的资源组和订阅中。

名称

类型

说明

200 OK

ManagedInstanceLongTermRetentionBackupListResult

已成功检索备份列表。

Other Status Codes

错误响应：***

404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

示例

Get all long term retention backups under the database.

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


import com.azure.core.util.Context;

/** Samples for LongTermRetentionManagedInstanceBackups ListByResourceGroupDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedManagedInstanceLongTermRetentionBackupListByDatabase.json
     */
    /**
     * Sample code: Get all long term retention backups under the database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionManagedInstanceBackups()
            .listByResourceGroupDatabase("testResourceGroup", "japaneast", "testInstance", "testDatabase", 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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-23T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-23T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": null,
        "backupTime": "2018-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-30T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-30T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": null,
        "backupTime": "2018-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-09-06T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-09-06T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2018-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": "2018-09-07T08:00:00Z",
        "backupTime": "2018-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[]	结果数组。

Long Term Retention Managed Instance Backups - List By Resource Group Database

URI 参数

响应

示例

Get all long term retention backups under the database.

Sample Request

Sample Response

定义

BackupStorageRedundancy

databaseState

ManagedInstanceLongTermRetentionBackup

ManagedInstanceLongTermRetentionBackupListResult

其他资源