Managed Databases - Update

Служба:
SQL Database
Версия API:
2025-01-01

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

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

Параметры URI

Имя В Обязательно Тип Описание
databaseName
 path True

string

Имя базы данных.
managedInstanceName
 path True

string

Имя управляемого экземпляра.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя регистронезависимо.
subscriptionId
 path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version
 query True

string

minLength: 1

Версия API, используемая для данной операции.

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

Имя Тип Описание
properties.autoCompleteRestore

boolean

Выполняется ли автоматическое восстановление этой управляемой базы данных.
properties.catalogCollation

CatalogCollationType

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

string

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

ManagedDatabaseCreateMode

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

string

Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.crossSubscriptionSourceDatabaseId

string

Идентификатор ресурса базы данных-источника между подписками, связанной с операцией создания этой базы данных.
properties.crossSubscriptionTargetManagedInstanceId

string

Идентификатор целевого управляемого экземпляра, используемый в восстановлении между подписками.
properties.isLedgerOn

boolean

Независимо от того, является ли эта база данных базой данных реестра, то есть все таблицы в базе данных являются таблицами реестра. Примечание. Значение этого свойства невозможно изменить после создания базы данных.
properties.lastBackupName

string

Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId

string

Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId

string

Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId

string

Восстанавливаемый идентификатор ресурса базы данных для восстановления при создании этой базы данных.
properties.restorePointInTime

string (date-time)

Conditional. Если createMode имеет значение PointInTimeRestore, это значение необходимо. Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId

string

Идентификатор ресурса исходной базы данных, связанной с операцией создания этой базы данных.
properties.storageContainerIdentity

string

Conditional. Если createMode — RestoreExternalBackup, это значение используется. Указывает удостоверение, используемое для проверки подлинности контейнера хранилища. Может быть "SharedAccessSignature" или "ManagedIdentity"; Значение , если не указано значение SharedAccessSignature.
properties.storageContainerSasToken

string

Conditional. Если createMode — RestoreExternalBackup и storageContainerIdentity не managedIdentity, это значение необходимо. Указывает маркер sas контейнера хранилища.
properties.storageContainerUri

string

Conditional. Если createMode — RestoreExternalBackup, это значение необходимо. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

ManagedDatabase

Операция Azure успешно завершена.
202 Accepted

Принятый запрос на обновление ресурсов.

Заголовки

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Updates a managed database with maximal properties
Updates a managed database with minimal properties

Updates a managed database with maximal properties

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

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

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

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

Код состояния:
200 
{
  "name": "testdb",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "location": "southeastasia",
  "tags": {
    "tagKey1": "TagValue1"
  }
}
Код состояния:
202 
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01

Updates a managed database with minimal properties

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

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

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

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

Код состояния:
200 
{
  "name": "testdb",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "location": "southeastasia",
  "tags": {
    "tagKey1": "TagValue1"
  }
}
Код состояния:
202 
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01

Определения

Имя Описание
CatalogCollationType

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

Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo

Ошибка управления ресурсами дополнительная информация.
ErrorDetail

Детали ошибки.
ErrorResponse

Ответ на ошибку
InaccessibilityReason

Вид первопричины. Допустимые значения: "TransparentDataEncryption", "DatabaseReplication" и "Unknown".
ManagedDatabase

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

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

Расширенная информация о доступности управляемой базы данных
ManagedDatabaseStatus

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

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

Метаданные, относящиеся к созданию и последнему изменении ресурса.

CatalogCollationType

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

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

Значение Описание
DATABASE_DEFAULT

DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

SQL_Latin1_General_CP1_CI_AS

createdByType

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

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Объект

Ошибка управления ресурсами дополнительная информация.

Имя Тип Описание
info

object

Дополнительная информация.
type

string

Тип дополнительной информации.

ErrorDetail

Объект

Детали ошибки.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Ошибка дополнительная информация.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

InaccessibilityReason

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

Вид первопричины. Допустимые значения: "TransparentDataEncryption", "DatabaseReplication" и "Unknown".

Значение Описание
Unknown

Неизвестно
TransparentDataEncryption

Прозрачное шифрование данных
DatabaseReplication

DatabaseReplication

ManagedDatabase

Объект

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

Имя Тип Описание
id

string (arm-id)

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

Географическое расположение, в котором находится ресурс
name

string

Имя ресурса
properties.autoCompleteRestore

boolean

Выполняется ли автоматическое восстановление этой управляемой базы данных.
properties.catalogCollation

CatalogCollationType

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

string

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

ManagedDatabaseCreateMode

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

string (date-time)

Дата создания базы данных.
properties.crossSubscriptionRestorableDroppedDatabaseId

string

Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.crossSubscriptionSourceDatabaseId

string

Идентификатор ресурса базы данных-источника между подписками, связанной с операцией создания этой базы данных.
properties.crossSubscriptionTargetManagedInstanceId

string

Идентификатор целевого управляемого экземпляра, используемый в восстановлении между подписками.
properties.defaultSecondaryLocation

string

Геопарный регион.
properties.earliestRestorePoint

string (date-time)

Самая ранняя точка восстановления во времени для восстановления на определенный момент времени.
properties.extendedAccessibilityInfo

ManagedDatabaseExtendedAccessibilityInfo

Дополнительная информация о наблюдении и устранении неполадок для баз данных в состоянии «Недоступно».
properties.failoverGroupId

string

Идентификатор ресурса группы отработки отказа экземпляра, к которому принадлежит эта управляемая база данных.
properties.isLedgerOn

boolean

Независимо от того, является ли эта база данных базой данных реестра, то есть все таблицы в базе данных являются таблицами реестра. Примечание. Значение этого свойства невозможно изменить после создания базы данных.
properties.lastBackupName

string

Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId

string

Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId

string

Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId

string

Восстанавливаемый идентификатор ресурса базы данных для восстановления при создании этой базы данных.
properties.restorePointInTime

string (date-time)

Conditional. Если createMode имеет значение PointInTimeRestore, это значение необходимо. Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId

string

Идентификатор ресурса исходной базы данных, связанной с операцией создания этой базы данных.
properties.status

ManagedDatabaseStatus

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

string

Conditional. Если createMode — RestoreExternalBackup, это значение используется. Указывает удостоверение, используемое для проверки подлинности контейнера хранилища. Может быть "SharedAccessSignature" или "ManagedIdentity"; Значение , если не указано значение SharedAccessSignature.
properties.storageContainerSasToken

string

Conditional. Если createMode — RestoreExternalBackup и storageContainerIdentity не managedIdentity, это значение необходимо. Указывает маркер sas контейнера хранилища.
properties.storageContainerUri

string

Conditional. Если createMode — RestoreExternalBackup, это значение необходимо. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
systemData

systemData

Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.
tags

object

Теги ресурсов.
type

string

Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения»

ManagedDatabaseCreateMode

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

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

Значение Описание
Default

По умолчанию
RestoreExternalBackup

RestoreExternalBackup
PointInTimeRestore

PointInTimeRestore
Recovery

Восстановление
RestoreLongTermRetentionBackup

RestoreLongTermRetentionBackup

ManagedDatabaseExtendedAccessibilityInfo

Объект

Расширенная информация о доступности управляемой базы данных

Имя Тип Описание
inaccessibilityReasonDescription

string

Объяснение основной причины и меры по ее устранению.
inaccessibilityReasonErrorCode

string

Код ошибки SQL Server, связанный с коренной причиной недоступности.
inaccessibilityReasonKind

InaccessibilityReason

Вид первопричины. Допустимые значения: "TransparentDataEncryption", "DatabaseReplication" и "Unknown".
inaccessibilityReasonTdeKeyUri

string

Для основной причины типа "TransparentDataEncryption" используется универсальный код ресурса (URI) CMK.

ManagedDatabaseStatus

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

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

Значение Описание
Online

Онлайн
Offline

Не в сети
Shutdown

Завершение работы
Creating

Создавать
Inaccessible

Недосягаемый
Restoring

Восстановление
Updating

Обновление
Stopping

Остановка
Stopped

Остановился
Starting

Запуск
DbMoving

DbMoving
DbCopying

Копирование базы

ManagedDatabaseUpdate

Объект

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

Имя Тип Описание
properties.autoCompleteRestore

boolean

Выполняется ли автоматическое восстановление этой управляемой базы данных.
properties.catalogCollation

CatalogCollationType

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

string

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

ManagedDatabaseCreateMode

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

string (date-time)

Дата создания базы данных.
properties.crossSubscriptionRestorableDroppedDatabaseId

string

Восстанавливаемый идентификатор ресурса базы данных, который можно восстановить при создании этой базы данных.
properties.crossSubscriptionSourceDatabaseId

string

Идентификатор ресурса базы данных-источника между подписками, связанной с операцией создания этой базы данных.
properties.crossSubscriptionTargetManagedInstanceId

string

Идентификатор целевого управляемого экземпляра, используемый в восстановлении между подписками.
properties.defaultSecondaryLocation

string

Геопарный регион.
properties.earliestRestorePoint

string (date-time)

Самая ранняя точка восстановления во времени для восстановления на определенный момент времени.
properties.extendedAccessibilityInfo

ManagedDatabaseExtendedAccessibilityInfo

Дополнительная информация о наблюдении и устранении неполадок для баз данных в состоянии «Недоступно».
properties.failoverGroupId

string

Идентификатор ресурса группы отработки отказа экземпляра, к которому принадлежит эта управляемая база данных.
properties.isLedgerOn

boolean

Независимо от того, является ли эта база данных базой данных реестра, то есть все таблицы в базе данных являются таблицами реестра. Примечание. Значение этого свойства невозможно изменить после создания базы данных.
properties.lastBackupName

string

Последнее имя файла резервной копии для восстановления этой управляемой базы данных.
properties.longTermRetentionBackupResourceId

string

Имя резервной копии долгосрочного хранения, используемой для восстановления этой управляемой базы данных.
properties.recoverableDatabaseId

string

Идентификатор ресурса восстанавливаемой базы данных, связанной с операцией создания этой базы данных.
properties.restorableDroppedDatabaseId

string

Восстанавливаемый идентификатор ресурса базы данных для восстановления при создании этой базы данных.
properties.restorePointInTime

string (date-time)

Conditional. Если createMode имеет значение PointInTimeRestore, это значение необходимо. Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных.
properties.sourceDatabaseId

string

Идентификатор ресурса исходной базы данных, связанной с операцией создания этой базы данных.
properties.status

ManagedDatabaseStatus

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

string

Conditional. Если createMode — RestoreExternalBackup, это значение используется. Указывает удостоверение, используемое для проверки подлинности контейнера хранилища. Может быть "SharedAccessSignature" или "ManagedIdentity"; Значение , если не указано значение SharedAccessSignature.
properties.storageContainerSasToken

string

Conditional. Если createMode — RestoreExternalBackup и storageContainerIdentity не managedIdentity, это значение необходимо. Указывает маркер sas контейнера хранилища.
properties.storageContainerUri

string

Conditional. Если createMode — RestoreExternalBackup, это значение необходимо. Указывает универсальный код ресурса (URI) контейнера хранилища, в котором хранятся резервные копии для этого восстановления.
tags

object

Теги ресурсов.

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).
createdBy

string

Удостоверение, создающее ресурс.
createdByType

createdByType

Тип удостоверения, создавшего ресурс.
lastModifiedAt

string (date-time)

Временная метка последнего изменения ресурса (UTC)
lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.
lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.