Managed Databases - Update

Служба:

SQL Database

Версия API:

2021-11-01

Обновляет имеющуюся базу данных.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?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 для использования в запросе.

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

Имя	Тип	Описание
properties.autoCompleteRestore	boolean	Следует ли автоматически завершить восстановление этой управляемой базы данных.
properties.catalogCollation	CatalogCollationType	Параметры сортировки каталога метаданных.
properties.collation	string	Параметры сортировки управляемой базы данных.
properties.createMode	ManagedDatabaseCreateMode	Режим создания управляемой базы данных. PointInTimeRestore. Создайте базу данных, восстановив резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервных копий. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. RecoverableDatabaseId должен быть указан в качестве идентификатора восстанавливаемого ресурса базы данных для восстановления. RestoreLongTermRetentionBackup. Создайте базу данных путем восстановления из резервной копии долгосрочного хранения (требуется longTermRetentionBackupResourceId).
properties.lastBackupName	string	Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId	string	Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId	string	Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId	string	Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.restorePointInTime	string	Условного. Если параметр createMode имеет значение PointInTimeRestore, это значение является обязательным. Указывает точку во времени (ISO8601 формате) базы данных-источника, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId	string	Идентификатор ресурса базы данных-источника, связанной с операцией создания этой базы данных.
properties.storageContainerSasToken	string	Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает маркер SAS контейнера хранилища.
properties.storageContainerUri	string	Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	ManagedDatabase	База данных успешно обновлена.
202 Accepted		Выполняется обновление управляемой базы данных.
Other Status Codes		Ответы на ошибки: *** 400 PitrPointInTimeInvalid — недопустимая точка во времени {0} . Допустимый диапазон времени от {1} ранних дней до настоящего времени, а не до создания исходного сервера. 400 CannotUseTrailingWhitespacesInDatabaseName — сбой проверки имени базы данных. 400 StorageAccountFull — Управляемый экземпляр достигла общей емкости базовой учетной записи хранения Azure. Для учетной записи Azure хранилище класса Premium доступно 35 ТБ выделенного пространства. 400 AkvHostNotResolvingFromNode — узел AKV "{0}" не разрешается из SQL на сервере "{1}". 400 InvalidBackupRetentionPeriod — дни {0} хранения не являются допустимой конфигурацией. Допустимое хранение резервных копий в днях должно находиться между {1} и {2} 400 ManagedDatabaseNameInUse — база данных "{0}" уже существует. Выберите другое имя базы данных. 400 NoMoreSpaceInManagedInstance — управляемый экземпляр достиг предела хранилища. Использование хранилища для управляемого экземпляра не может превышать (%d) МБ. 400 ManagedInstanceUpdateSloInProgress — "Не удалось завершить операцию, так как для управляемого экземпляра выполняется изменение уровня служб ".{0} Дождитесь завершения операции и повторите попытку". 400 SameKeyMaterialNotFoundOnRemoteServer — сервер-получатель не имеет материала ключа предохранителя шифрования основного сервера. 400 SourceDatabaseNotFound — база данных-источник не существует. 400 RegionDoesNotSupportVersion — пользователь пытался создать сервер указанной версии в расположении, где эта версия сервера не поддерживается. 400 PasswordNotComplex — предоставленный пароль недостаточно сложный. 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции. 400 InvalidServerName — указано недопустимое имя сервера. 400 SourceServerNotFound — часть сервера идентификатора базы данных-источника, предоставленного в вызове API CreateDatabaseAsCopy, не сопоставляется с существующим сервером. 400 TokenTooLong — предоставленный маркер слишком длинный. 400 CurrentDatabaseSizeExceedsMaxSize — пользователь попытался уменьшить максимальный размер базы данных до размера, который меньше текущего использования. 400 InvalidCollation — параметры сортировки не распознаны сервером. 400 AkvEndpointNotReachableFromNode — конечная точка AKV "{0}" недоступна из SQL на сервере "{1}". 400 ServerNotFound — запрошенный сервер не найден. 400 UnsupportedServiceName — указанное имя является недопустимым, так как оно содержит один или несколько неподдерживаемых символов Юникода. 400 CurrentDatabaseLogSizeExceedsMaxSize — пользователь попытался изменить базу данных на номер SKU с меньшим максимальным размером журнала, чем текущее использование. 400 DatabaseNumberLimitReached — максимальное количество баз данных для База данных SQL Управляемый экземпляр достигнуто. 400 InvalidDatabaseCreateOrUpdateRequest — недопустимый текст запроса для операции создания или обновления базы данных. 400 InvalidResourceId — недопустимый идентификатор ресурса. 400 InvalidSourceDatabaseId — недопустимый идентификатор базы данных-источника. 400 InvalidRestorableDroppedDatabaseId — недопустимый восстанавливаемый идентификатор базы данных 400 MismatchingResourceGroupNameWithUrl — предоставленное имя группы ресурсов не совпадает с именем в URL-адресе. 400 MismatchingServerNameWithUrl — предоставленное имя сервера не совпадает с именем в URL-адресе. 400 MismatchingSubscriptionWithUrl — указанная подписка не соответствует подписке в URL-адресе. 400 MissingCollation — требуется сортировка. 400 MissingSourceDatabaseId — отсутствует идентификатор базы данных-источника. 400 MissingRestorePointInTime — отсутствует точка восстановления во времени 400 MissingStorageContainerSasToken — отсутствует маркер SAS контейнера хранилища 400 MissingStorageContainerUri — отсутствует универсальный код ресурса (URI) контейнера хранилища 400 RestoreableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId — не удается указать restoreableDroppedDatabaseId, если sourceDatabaseId уже предоставлен в режиме создания восстановления 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ResourceNotFound — запрошенный ресурс не найден. 404 CannotFindServerCertificateWithThumbprint — не удается найти сертификат сервера с отпечатком "{0}". Чтобы создать сертификат, используйте командлет PowerShell Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate. 404 CannotFindObject — не удается найти объект, так как он не существует или у вас нет разрешений 404 SubscriptionNotFound — запрошенная подписка не найдена. 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 404 RestoreSourceDatabaseNotFound — не удалось найти базу данных "{0}" во время "{1}", которую можно восстановить. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 409 RemoteDatabaseExists — имя целевой базы данных уже существует на целевом сервере. 409 ConflictingDatabaseOperation — в базе данных уже есть некоторые операции, и текущая операция должна дождаться ее завершения. 409 SubscriptionDisabled — подписка отключена. 409 ManagementServiceDatabaseBusy — база данных "{0}" занята другой операцией. Попробуйте выполнить операцию позже. 409 ConflictingSystemOperationInProgress — в базе данных выполняется операция обслуживания системы, и для дальнейших операций необходимо подождать, пока она не будет завершена. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 ActivateOrDeactivateWorkflowThrottling — сбой активации или деактивации рабочего процесса из-за слишком большого количества параллельных рабочих процессов 503 DatabaseUnavailable — операция завершилась сбоем, так как база данных недоступна. 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

Updates a managed database with maximal properties

Updates a managed database with minimal properties

Updates a managed database with maximal properties

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

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Java

import com.azure.resourcemanager.sql.models.ManagedDatabaseUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ManagedDatabases Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseUpdateMax.json
     */
    /**
     * Sample code: Updates a managed database with maximal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updatesAManagedDatabaseWithMaximalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().update("Default-SQL-SouthEastAsia",
            "managedInstance", "testdb", new ManagedDatabaseUpdate().withTags(mapOf("tagKey1", "fakeTokenPlaceholder")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

Код состояния:

200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

Код состояния:

202

Updates a managed database with minimal properties

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

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Java

import com.azure.resourcemanager.sql.models.ManagedDatabaseUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ManagedDatabases Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseUpdateMin.json
     */
    /**
     * Sample code: Updates a managed database with minimal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updatesAManagedDatabaseWithMinimalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().update("Default-SQL-SouthEastAsia",
            "managedInstance", "testdb", new ManagedDatabaseUpdate().withTags(mapOf("tagKey1", "fakeTokenPlaceholder")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

Код состояния:

200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

Код состояния:

202

Определения

Имя	Описание
CatalogCollationType	Параметры сортировки каталога метаданных.
ManagedDatabase	Управляемый ресурс базы данных.
ManagedDatabaseCreateMode	Режим создания управляемой базы данных. PointInTimeRestore. Создайте базу данных, восстановив резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервных копий. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. RecoverableDatabaseId должен быть указан в качестве идентификатора восстанавливаемого ресурса базы данных для восстановления. RestoreLongTermRetentionBackup. Создайте базу данных путем восстановления из резервной копии долгосрочного хранения (требуется longTermRetentionBackupResourceId).
ManagedDatabaseStatus	Состояние базы данных.
ManagedDatabaseUpdate	Обновление управляемой базы данных.

CatalogCollationType

Параметры сортировки каталога метаданных.

Имя	Тип	Описание
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

ManagedDatabase

Управляемый ресурс базы данных.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.autoCompleteRestore	boolean	Следует ли автоматически завершить восстановление этой управляемой базы данных.
properties.catalogCollation	CatalogCollationType	Параметры сортировки каталога метаданных.
properties.collation	string	Параметры сортировки управляемой базы данных.
properties.createMode	ManagedDatabaseCreateMode	Режим создания управляемой базы данных. PointInTimeRestore. Создайте базу данных, восстановив резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервных копий. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. RecoverableDatabaseId должен быть указан в качестве идентификатора восстанавливаемого ресурса базы данных для восстановления. RestoreLongTermRetentionBackup. Создайте базу данных путем восстановления из резервной копии долгосрочного хранения (требуется longTermRetentionBackupResourceId).
properties.creationDate	string	Дата создания базы данных.
properties.defaultSecondaryLocation	string	Географически связанный регион.
properties.earliestRestorePoint	string	Самая ранняя точка восстановления во времени для восстановления на определенный момент времени.
properties.failoverGroupId	string	Идентификатор ресурса группы отработки отказа экземпляра, к которой принадлежит эта управляемая база данных.
properties.lastBackupName	string	Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId	string	Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId	string	Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId	string	Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.restorePointInTime	string	Условного. Если параметр createMode имеет значение PointInTimeRestore, это значение является обязательным. Указывает точку во времени (ISO8601 формате) базы данных-источника, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId	string	Идентификатор ресурса базы данных-источника, связанной с операцией создания этой базы данных.
properties.status	ManagedDatabaseStatus	Состояние базы данных.
properties.storageContainerSasToken	string	Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает маркер SAS контейнера хранилища.
properties.storageContainerUri	string	Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

ManagedDatabaseCreateMode

Режим создания управляемой базы данных. PointInTimeRestore. Создайте базу данных, восстановив резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервных копий. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. RecoverableDatabaseId должен быть указан в качестве идентификатора восстанавливаемого ресурса базы данных для восстановления. RestoreLongTermRetentionBackup. Создайте базу данных путем восстановления из резервной копии долгосрочного хранения (требуется longTermRetentionBackupResourceId).

Имя	Тип	Описание
Default	string
PointInTimeRestore	string
Recovery	string
RestoreExternalBackup	string
RestoreLongTermRetentionBackup	string

ManagedDatabaseStatus

Состояние базы данных.

Имя	Тип	Описание
Creating	string
Inaccessible	string
Offline	string
Online	string
Restoring	string
Shutdown	string
Updating	string

ManagedDatabaseUpdate

Обновление управляемой базы данных.

Имя	Тип	Описание
properties.autoCompleteRestore	boolean	Следует ли автоматически завершить восстановление этой управляемой базы данных.
properties.catalogCollation	CatalogCollationType	Параметры сортировки каталога метаданных.
properties.collation	string	Параметры сортировки управляемой базы данных.
properties.createMode	ManagedDatabaseCreateMode	Режим создания управляемой базы данных. PointInTimeRestore. Создайте базу данных, восстановив резервную копию существующей базы данных на определенный момент времени. Необходимо указать SourceDatabaseName, SourceManagedInstanceName и PointInTime. RestoreExternalBackup: создайте базу данных путем восстановления из внешних файлов резервных копий. Необходимо указать параметры сортировки, StorageContainerUri и StorageContainerSasToken. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. RecoverableDatabaseId должен быть указан в качестве идентификатора восстанавливаемого ресурса базы данных для восстановления. RestoreLongTermRetentionBackup. Создайте базу данных путем восстановления из резервной копии долгосрочного хранения (требуется longTermRetentionBackupResourceId).
properties.creationDate	string	Дата создания базы данных.
properties.defaultSecondaryLocation	string	Географически связанный регион.
properties.earliestRestorePoint	string	Самая ранняя точка восстановления во времени для восстановления на определенный момент времени.
properties.failoverGroupId	string	Идентификатор ресурса группы отработки отказа экземпляра, к которой принадлежит эта управляемая база данных.
properties.lastBackupName	string	Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId	string	Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId	string	Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId	string	Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.restorePointInTime	string	Условного. Если параметр createMode имеет значение PointInTimeRestore, это значение является обязательным. Указывает точку во времени (ISO8601 формате) базы данных-источника, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId	string	Идентификатор ресурса базы данных-источника, связанной с операцией создания этой базы данных.
properties.status	ManagedDatabaseStatus	Состояние базы данных.
properties.storageContainerSasToken	string	Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает маркер SAS контейнера хранилища.
properties.storageContainerUri	string	Условного. Если параметр createMode имеет значение RestoreExternalBackup, это значение является обязательным. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
tags	object	Теги ресурсов.