Compartir a través de


Managed Databases - Update

Actualiza una base de datos existente.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
databaseName
path True

string

El nombre de la base de datos.

managedInstanceName
path True

string

El nombre de la instancia administrada.

resourceGroupName
path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

subscriptionId
path True

string

El id. de suscripción que identifica una suscripción de Azure.

api-version
query True

string

La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre Tipo Description
properties.autoCompleteRestore

boolean

Si se va a completar automáticamente la restauración de esta base de datos administrada.

properties.catalogCollation

CatalogCollationType

Intercalación del catálogo de metadatos.

properties.collation

string

Intercalación de la base de datos administrada.

properties.createMode

ManagedDatabaseCreateMode

Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).

properties.lastBackupName

string

Nombre del archivo de copia de seguridad por última vez para la restauración de esta base de datos administrada.

properties.longTermRetentionBackupResourceId

string

Nombre de la copia de seguridad de retención a largo plazo que se usará para la restauración de esta base de datos administrada.

properties.recoverableDatabaseId

string

Identificador de recurso de la base de datos recuperable asociada con la operación de creación de esta base de datos.

properties.restorableDroppedDatabaseId

string

Identificador de recurso de base de datos eliminado que se puede restaurar al crear esta base de datos.

properties.restorePointInTime

string

Condicional. Si createMode es PointInTimeRestore, se requiere este valor. Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.sourceDatabaseId

string

Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos.

properties.storageContainerSasToken

string

Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el token sas del contenedor de almacenamiento.

properties.storageContainerUri

string

Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el URI del contenedor de almacenamiento donde se almacenan las copias de seguridad de esta restauración.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

ManagedDatabase

Se actualizó correctamente la base de datos.

202 Accepted

La actualización de la base de datos administrada está en curso.

Other Status Codes

Respuestas de error: ***

  • 400 PitrPointInTimeInvalid: el momento {0} dado no es válido. Intervalo de tiempo válido desde {1} días temprano hasta ahora y no antes de la hora de creación del servidor de origen.

  • 400 CannotUseTrailingWhitespacesInDatabaseName: error en la validación del nombre de la base de datos.

  • 400 StorageAccountFull: Instancia administrada ha alcanzado la capacidad total de la cuenta de almacenamiento de Azure subyacente. La cuenta de Azure Premium Storage está limitada a 35 TB de espacio asignado.

  • 400 AkvHostNotResolvingFromNode: el host de AKV "{0}" no se puede resolver desde SQL, en el servidor "{1}".

  • 400 InvalidBackupRetentionPeriod: los días de retención de {0} no son una configuración válida. La retención de copia de seguridad válida en días debe estar entre {1} y {2}

  • 400 ManagedDatabaseNameInUse: la base de datos '{0}' ya existe. Elija un nombre diferente para la base de datos.

  • 400 NoMoreSpaceInManagedInstance: la instancia administrada ha alcanzado su límite de almacenamiento. El uso de almacenamiento de la instancia administrada no puede superar (%d).

  • 400 ManagedInstanceUpdateSloInProgress: "No se pudo completar la operación porque hay un cambio de nivel de servicio en curso para la instancia administrada ".{0} y que hay que esperar a que la operación que está en curso finalice.

  • 400 SameKeyMaterialNotFoundOnRemoteServer: el servidor secundario no tiene el material clave del protector de cifrado del servidor principal.

  • 400 SourceDatabaseNotFound: la base de datos de origen no existe.

  • 400 RegionDoesNotSupportVersion: un usuario intentó crear un servidor de una versión especificada en una ubicación donde no se admite esa versión del servidor.

  • 400 PasswordNotComplex: la contraseña proporcionada no es lo suficientemente compleja.

  • 400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación.

  • 400 InvalidServerName: nombre de servidor no válido especificado.

  • 400 SourceServerNotFound: la parte del servidor de un identificador de base de datos de origen proporcionado en una llamada API createDatabaseAsCopy no se asigna a un servidor existente.

  • 400 TokenTooLong: el token proporcionado es demasiado largo.

  • 400 CurrentDatabaseSizeExceedsMaxSize: el usuario intentó reducir el tamaño máximo de una base de datos a un tamaño menor que el uso actual.

  • 400 InvalidCollation: el servidor no reconoce la intercalación.

  • 400 AkvEndpointNotReachableFromNode: el punto de conexión de AKV "{0}" no es accesible desde SQL, en el servidor "{1}".

  • 400 ServerNotFound: no se encontró el servidor solicitado.

  • 400 UnsupportedServiceName: el nombre especificado es un nombre no válido porque contiene uno o varios caracteres unicode no admitidos.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize: el usuario intentó cambiar la base de datos a una SKU con un tamaño de registro máximo inferior al uso actual.

  • 400 DatabaseNumberLimitReached: número máximo de bases de datos para SQL Database Instancia administrada alcanzado.

  • 400 InvalidDatabaseCreateOrUpdateRequest: el cuerpo de la solicitud para la operación de creación o actualización de la base de datos no es válido.

  • 400 InvalidResourceId: identificador de recurso no válido.

  • 400 InvalidSourceDatabaseId: identificador de base de datos de origen no válido.

  • 400 InvalidRestorableDroppedDatabaseId: identificador de base de datos descartable no válido

  • 400 No coincidentesResourceGroupNameWithUrl: el nombre del grupo de recursos proporcionado no coincide con el nombre de la dirección URL.

  • 400 No coincidentesServerNameWithUrl: el nombre del servidor proporcionado no coincide con el nombre de la dirección URL.

  • 400 Error de coincidenciaSubscriptionWithUrl: la suscripción proporcionada no coincide con la suscripción en la dirección URL.

  • 400 MissingCollation: se requiere intercalación.

  • 400 MissingSourceDatabaseId: falta el identificador de base de datos de origen.

  • 400 MissingRestorePointInTime: falta un momento dado de restauración

  • 400 MissingStorageContainerSasToken: falta el token de SAS del contenedor de almacenamiento

  • 400 MissingStorageContainerUri: falta el URI del contenedor de almacenamiento

  • 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId: no se puede especificar restorableDroppedDatabaseId cuando sourceDatabaseId ya está dado en el modo de creación de restauración

  • 400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 404 CannotFindServerCertificateWithThumbprint: no se encuentra el certificado de servidor con huella digital '{0}'. Use el cmdlet de PowerShell "Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate" para crear el certificado.

  • 404 CannotFindObject: no se encuentra el objeto porque no existe o no tiene permisos

  • 404 SubscriptionNotFound: no se encontró la suscripción solicitada.

  • 404 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor.

  • 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada.

  • 404 RestoreSourceDatabaseNotFound: no se encontró la base de datos '{0}' en el momento '{1}' que se puede restaurar.

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 409 RemoteDatabaseExists: el nombre de la base de datos de destino ya existe en el servidor de destino.

  • 409 ConflictingDatabaseOperation: ya hay alguna operación en la base de datos y la operación actual debe esperar hasta que se realice.

  • 409 SubscriptionDisabled: la suscripción está deshabilitada.

  • 409 ManagementServiceDatabaseBusy: la base de datos '{0}' está ocupada con otra operación. Pruebe la operación más adelante.

  • 409 ConflictingSystemOperationInProgress: una operación de mantenimiento del sistema está en curso en la base de datos y es necesario esperar hasta que se complete.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 500 ActivateOrDeactivateWorkflowThrottling: error en el flujo de trabajo de activación o desactivación porque hay demasiados flujos de trabajo simultáneos

  • 503 DatabaseUnavailable: error en la operación porque la base de datos no está disponible.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

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

Updates a managed database with maximal properties

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

{
  "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"
}

Updates a managed database with minimal properties

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

{
  "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"
}

Definiciones

Nombre Description
CatalogCollationType

Intercalación del catálogo de metadatos.

ManagedDatabase

Un recurso de base de datos administrada.

ManagedDatabaseCreateMode

Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).

ManagedDatabaseStatus

Estado de la base de datos.

ManagedDatabaseUpdate

Una actualización de base de datos administrada.

CatalogCollationType

Intercalación del catálogo de metadatos.

Valor Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ManagedDatabase

Un recurso de base de datos administrada.

Nombre Tipo Description
id

string

Identificador del recurso.

location

string

Ubicación del recurso

name

string

Nombre del recurso.

properties.autoCompleteRestore

boolean

Si se va a completar automáticamente la restauración de esta base de datos administrada.

properties.catalogCollation

CatalogCollationType

Intercalación del catálogo de metadatos.

properties.collation

string

Intercalación de la base de datos administrada.

properties.createMode

ManagedDatabaseCreateMode

Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).

properties.creationDate

string

Fecha de creación de la base de datos.

properties.defaultSecondaryLocation

string

Región emparejada geográfica.

properties.earliestRestorePoint

string

Un momento dado de restauración más antiguo para la restauración a un momento dado.

properties.failoverGroupId

string

Identificador de recursos del grupo de conmutación por error de instancia al que pertenece esta base de datos administrada.

properties.lastBackupName

string

Último nombre de archivo de copia de seguridad para la restauración de esta base de datos administrada.

properties.longTermRetentionBackupResourceId

string

Nombre de la copia de seguridad de retención a largo plazo que se usará para la restauración de esta base de datos administrada.

properties.recoverableDatabaseId

string

Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos.

properties.restorableDroppedDatabaseId

string

Identificador de recurso de base de datos eliminado que se puede restaurar al crear esta base de datos.

properties.restorePointInTime

string

Condicional. Si createMode es PointInTimeRestore, se requiere este valor. Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.sourceDatabaseId

string

Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos.

properties.status

ManagedDatabaseStatus

Estado de la base de datos.

properties.storageContainerSasToken

string

Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el token sas del contenedor de almacenamiento.

properties.storageContainerUri

string

Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el URI del contenedor de almacenamiento donde se almacenan las copias de seguridad de esta restauración.

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso.

ManagedDatabaseCreateMode

Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).

Valor Description
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Estado de la base de datos.

Valor Description
Creating
Inaccessible
Offline
Online
Restoring
Shutdown
Updating

ManagedDatabaseUpdate

Una actualización de base de datos administrada.

Nombre Tipo Description
properties.autoCompleteRestore

boolean

Si se va a completar automáticamente la restauración de esta base de datos administrada.

properties.catalogCollation

CatalogCollationType

Intercalación del catálogo de metadatos.

properties.collation

string

Intercalación de la base de datos administrada.

properties.createMode

ManagedDatabaseCreateMode

Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).

properties.creationDate

string

Fecha de creación de la base de datos.

properties.defaultSecondaryLocation

string

Región emparejada geográfica.

properties.earliestRestorePoint

string

Un momento dado de restauración más antiguo para la restauración a un momento dado.

properties.failoverGroupId

string

Identificador de recursos del grupo de conmutación por error de instancia al que pertenece esta base de datos administrada.

properties.lastBackupName

string

Último nombre de archivo de copia de seguridad para la restauración de esta base de datos administrada.

properties.longTermRetentionBackupResourceId

string

Nombre de la copia de seguridad de retención a largo plazo que se usará para la restauración de esta base de datos administrada.

properties.recoverableDatabaseId

string

Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos.

properties.restorableDroppedDatabaseId

string

Identificador de recurso de base de datos eliminado que se puede restaurar al crear esta base de datos.

properties.restorePointInTime

string

Condicional. Si createMode es PointInTimeRestore, se requiere este valor. Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.sourceDatabaseId

string

Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos.

properties.status

ManagedDatabaseStatus

Estado de la base de datos.

properties.storageContainerSasToken

string

Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el token sas del contenedor de almacenamiento.

properties.storageContainerUri

string

Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el URI del contenedor de almacenamiento donde se almacenan las copias de seguridad de esta restauración.

tags

object

Etiquetas del recurso.