Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API Version:

2021-11-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/update?api-version=2021-11-01

Параметры URI

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

Текст запроса

Имя	Тип	Описание
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Тип избыточности хранилища скопированной резервной копии

Ответы

Имя	Тип	Описание
200 OK	LongTermRetentionBackupOperationResult	Резервная копия успешно обновлена.
202 Accepted		Выполняется обновление резервной копии.
Other Status Codes		Ответы на ошибки: *** 400 InvalidLongTermRetentionBackupId — недопустимый идентификатор резервной копии долгосрочного хранения для баз данных SQL. 400 InvalidParameterValue — параметру присвоено недопустимое значение. 400 LongTermRetentionMismatchingSubscriptionId — предоставленный идентификатор подписки не совпадает с идентификатором в других входных данных. 400 LongTermRetentionMismatchingResourceGroupName — имя группы ресурсов не совпадает с именем в других входных данных. 400 LongTermRetentionMismatchingServerName — предоставленное имя сервера не совпадает с именем в других входных данных. 400 LongTermRetentionMigrationRequestNotSupported — подписка не поддерживает функцию переноса резервных копий LTR. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported — исходная и целевая подписки не могут обмениваться данными для функции резервного копирования LTR. 400 LongTermRetentionMigrationParameterMissing — обязательный параметр отсутствует для операции. 400 LongTermRetentionMigrationSameServerNotSupported — функция копирования LTR не поддерживается для копирования резервных копий LTR на одном сервере. 400 LongTermRetentionMigrationTargetServerNotFound — целевой сервер не существует или не готов к операции резервного копирования LTR. 400 LongTermRetentionMigrationTargetDatabaseNotFound — целевая база данных не существует на сервере. 400 LongTermRetentionMigrationStorageTypeNotSupported — указанная избыточность хранилища резервных копий не поддерживается в целевом регионе. 400 LongTermRetentionMigrationStorageMismatch — активная избыточность резервного копирования базы данных не соответствует избыточности резервных копий, запрошенной клиентом. 400 LongTermRetentionMigrationDatabaseTypeNotSupported — миграция LTR поддерживается только для управляемых экземпляров и Azure SQL резервных копий базы данных LTR. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed — изменение избыточности хранилища резервных копий не допускается для операций копирования LTR. 400 LongTermRetentionMigrationSubscriptionNotFound — не удалось найти подписку. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ResourceNotFound — запрошенный ресурс не найден. 404 LongTermRetentionMigrationBackupNotFound — указанная резервная копия LTR не существует. 404 OperationIdNotFound — операция с идентификатором не существует. 409 LongTermRetentionMigrationRequestConflict — конфликтная операция для этой резервной копии LTR все еще выполняется. 409 LongTermRetentionMigrationBackupConflict — существует другая резервная копия LTR с тем же временем резервного копирования для целевой базы данных. 409 OperationCancelled — операция отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget — не удалось запустить запрос на резервное копирование LTR в целевом регионе. 500 LongTermRetentionMigrationRequestCopyFailed — сбой операции копирования для резервных BLOB-объектов LTR. 500 LongTermRetentionMigrationRestoreVerExceededed — проверка восстановления завершилась сбоем после достижения максимального количества попыток. 500 LongTermRetentionMigrationRestoreVerFailed — сбой проверки восстановления. 500 OperationTimedOut — истекло время ожидания операции и автоматически выполняется откат. Повторите операцию. 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Update the long term retention backup.

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000/update?api-version=2021-11-01

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.UpdateLongTermRetentionBackupParameters;

/** Samples for LongTermRetentionBackups UpdateByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupUpdate.json
     */
    /**
     * Sample code: Update the long term retention backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().updateByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", new UpdateLongTermRetentionBackupParameters()
                .withRequestedBackupStorageRedundancy(BackupStorageRedundancy.GEO),
            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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "properties": {
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "fromBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Status code:

202

Определения

Имя	Описание
BackupStorageRedundancy	Тип избыточности хранилища скопированной резервной копии
LongTermRetentionBackupOperationResult	Ресурс результата операции LongTermRetentionBackup.
UpdateLongTermRetentionBackupParameters	Содержит сведения, необходимые для выполнения операции долгосрочного обновления резервных копий.

BackupStorageRedundancy

Тип избыточности хранилища скопированной резервной копии

Имя	Тип	Описание
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

Ресурс результата операции LongTermRetentionBackup.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.fromBackupResourceId	string	Идентификатор исходного ресурса резервной копии
properties.message	string	Сообщение о ходе выполнения
properties.operationType	string	Тип операции.
properties.requestId	string	Идентификатор запроса.
properties.status	string	Состояние операции
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Тип избыточности хранилища скопированной резервной копии
properties.toBackupResourceId	string	Идентификатор целевого ресурса резервного копирования
type	string	Тип ресурса.

UpdateLongTermRetentionBackupParameters

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

Имя	Тип	Описание
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Тип избыточности хранилища скопированной резервной копии