Long Term Retention Managed Instance Backups - List By Database

Ссылка

Служба:: SQL Database

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

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

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

С использованием необязательных параметров:

GET https://management.azure.com/subscriptions/{subscriptionId}/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	Имя управляемого экземпляра.
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 database.

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


/**
 * Samples for LongTermRetentionManagedInstanceBackups ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionBackupListByDatabase.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()
            .listByDatabase("japaneast", "testInstance", "testDatabase", 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/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/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/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": "2017-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
GeoZone
Local
Zone

databaseState

Перечисление

Следует ли запрашивать только динамические базы данных, только что удаленные базы данных или все базы данных.

Значение	Описание
All
Deleted
Live

ManagedInstanceLongTermRetentionBackup

Object

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

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.backupExpirationTime	string (date-time)	Время истечения срока действия долгосрочной резервной копии хранения.
properties.backupStorageRedundancy	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

Object

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

Имя	Тип	Описание
nextLink	string	Ссылка на получение следующей страницы результатов.
value	ManagedInstanceLongTermRetentionBackup[]	Массив результатов.

Поделиться через

Long Term Retention Managed Instance Backups - List By Database

Параметры URI

Ответы

Примеры

Get all long term retention backups under the database.

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

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

Определения

BackupStorageRedundancy

databaseState

ManagedInstanceLongTermRetentionBackup

ManagedInstanceLongTermRetentionBackupListResult

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