Long Term Retention Managed Instance Backups - List By Location

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

Списки резервные копии долгосрочного хранения для управляемых баз данных в заданном расположении.

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.
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 location.

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


/**
 * 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	Идентификатор ресурса.
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 Location

Параметры URI

Ответы

Примеры

Get all long term retention backups under the location.

Образец запроса

Пример ответа

Определения

BackupStorageRedundancy

databaseState

ManagedInstanceLongTermRetentionBackup

ManagedInstanceLongTermRetentionBackupListResult

Дополнительные ресурсы