Managed Instance Long Term Retention Policies - List By Database

Служба:

SQL Database

Версия API:

2021-11-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/backupLongTermRetentionPolicies?api-version=2021-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя базы данных.
managedInstanceName	path	True	string	Имя управляемого экземпляра.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Ответы

Имя	Тип	Описание
200 OK	ManagedInstanceLongTermRetentionPolicyListResult	Политика LTR для управляемой базы данных успешно завершена.
Other Status Codes		Ответы на ошибки: *** 400 LTRNotSupportedForPerDBCMK — долгосрочное хранение резервных копий не поддерживается, если cmK на уровне базы данных настроен в предварительной версии. 400 LongTermRetentionPolicyNotSupported — долгосрочное хранение в этой базе данных не поддерживается. 400 LongTermRetentionPolicyInvalid — недопустимая политика долгосрочного хранения. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ResourceNotFound — запрошенный ресурс не найден.

Примеры

Get the long term retention policies for the managed database.

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

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies?api-version=2021-11-01

Java

/**
 * Samples for ManagedInstanceLongTermRetentionPolicies ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionPolicyListByDatabase.json
     */
    /**
     * Sample code: Get the long term retention policies for the managed database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheLongTermRetentionPoliciesForTheManagedDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceLongTermRetentionPolicies()
            .listByDatabase("testResourceGroup", "testInstance", "testDatabase", 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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies/default",
      "name": "default",
      "type": "Microsoft.Sql/resourceGroups/managedInstances/databases/backupLongTermRetentionPolicies",
      "properties": {
        "weeklyRetention": "P1M",
        "monthlyRetention": "P1Y",
        "yearlyRetention": "P5Y",
        "weekOfYear": 5
      }
    }
  ]
}

Определения

Имя	Описание
ManagedInstanceLongTermRetentionPolicy	Политика долгосрочного хранения.
ManagedInstanceLongTermRetentionPolicyListResult	Список политик долгосрочного хранения.

ManagedInstanceLongTermRetentionPolicy

Политика долгосрочного хранения.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.monthlyRetention	string	Политика ежемесячного хранения для резервной копии LTR в формате ISO 8601.
properties.weekOfYear	integer	Неделя года для создания ежегодной резервной копии в формате ISO 8601.
properties.weeklyRetention	string	Политика еженедельного хранения для резервной копии LTR в формате ISO 8601.
properties.yearlyRetention	string	Политика ежегодного хранения для резервной копии LTR в формате ISO 8601.
type	string	Тип ресурса.

ManagedInstanceLongTermRetentionPolicyListResult

Список политик долгосрочного хранения.

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