Compartir a través de


Databases - Update

Actualiza una base de datos existente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/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.

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.

serverName
path True

string

El nombre del servidor.

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
identity

DatabaseIdentity

Identidad de la base de datos

properties.autoPauseDelay

integer

Tiempo en minutos después del cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada.

properties.catalogCollation

CatalogCollationType

Intercalación del catálogo de metadatos.

properties.collation

string

Intercalación de la base de datos.

properties.createMode

CreateMode

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación normal de la base de datos.

Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen.

Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente.

PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime.

Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como identificador de recurso de base de datos recuperable que se va a restaurar.

Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos eliminado que se puede restaurar y se omite sourceDatabaseDeletionDate. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior.

RestoreLongTermRetentionBackup: crea una base de datos mediante la restauración desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso del punto de recuperación.

Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.

properties.elasticPoolId

string

Identificador de recursos del grupo elástico que contiene esta base de datos.

properties.federatedClientId

string

Identificador de cliente usado para el escenario de CMK entre inquilinos por base de datos

properties.highAvailabilityReplicaCount

integer

Número de réplicas secundarias asociadas a la base de datos que se usan para proporcionar alta disponibilidad. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.

properties.isLedgerOn

boolean

Si esta base de datos es o no una base de datos de libro de contabilidad, lo que significa que todas las tablas de la base de datos son tablas de libro de contabilidad. Nota: El valor de esta propiedad no se puede cambiar una vez creada la base de datos.

properties.licenseType

DatabaseLicenseType

Tipo de licencia que se va a aplicar a esta base de datos. LicenseIncludedsi necesita una licencia o BasePrice si tiene una licencia y es apta para la Ventaja híbrida de Azure.

properties.longTermRetentionBackupResourceId

string

Identificador de recursos de la copia de seguridad de retención a largo plazo asociada al funcionamiento de creación de esta base de datos.

properties.maintenanceConfigurationId

string

Identificador de configuración de mantenimiento asignado a la base de datos. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento.

properties.maxSizeBytes

integer

Tamaño máximo de la base de datos expresada en bytes.

properties.minCapacity

number

Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa

properties.readScale

DatabaseReadScale

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en sus cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.

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.recoveryServicesRecoveryPointId

string

Identificador de recurso del punto de recuperación asociado a la operación de creación de esta base de datos.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta base de datos.

properties.restorableDroppedDatabaseId

string

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

properties.restorePointInTime

string

Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.sampleName

SampleName

Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.

properties.secondaryType

SecondaryType

El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo y Named.

properties.sourceDatabaseDeletionDate

string

Especifica la hora en que se eliminó la 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.zoneRedundant

boolean

Si esta base de datos tiene redundancia de zona o no, lo que significa que las réplicas de esta base de datos se distribuirán entre varias zonas de disponibilidad.

sku

Sku

Nombre y nivel de la SKU.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

Database

Se actualizó correctamente la base de datos.

202 Accepted

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

Other Status Codes

Respuestas de error: ***

  • 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 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 No coincidentesSubscriptionWithUrl: la suscripción proporcionada no coincide con la suscripción en la dirección URL.

  • 400 MissingCollation: se requiere intercalación.

  • 400 MissingMaxSizeBytes: se requiere MaxSizeBytes.

  • 400 MissingSkuName: se requiere el nombre de Sku.

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

  • 400 InvalidLicenseType: el tipo de licencia especificado no es válido.

  • 400 InvalidSkuName: nombre de SKU no válido.

  • 400 No coincidenteSkuNameAndCapacity: error de coincidencia entre el nombre y la capacidad de la SKU.

  • 400 No coincidentesSkuNameAndTier: error de coincidencia entre el nombre y el nivel de SKU.

  • 400 No coincidentesSkuNameAndFamily: error de coincidencia entre el nombre de la SKU y la familia.

  • 400 LedgerNotAllowedWithSpecifiedCreateMode: IsLedgerOn no está permitido con el modo de creación especificado.

  • 400 LedgerNotAllowedOnSampleDatabase: no se permite la creación de bases de datos con IsLedgerOn para una base de datos de ejemplo.

  • 400 DatabaseNameDoesNotMatchSourceDatabaseId: el nombre de la base de datos especificado no coincide con el nombre de la base de datos en sourceDatabaseId.

  • 400 ElasticPoolNotSupportedForExternalBackupRestore: el grupo elástico no se admite para la restauración de copias de seguridad externas

  • 400 InvalidRecoverableDatabaseId: identificador de base de datos recuperable no válido.

  • 400 InvalidRecoveryServicesRecoveryPointId: identificador de punto de recuperación de servicios de recuperación no válidos.

  • 400 InvalidRestorableDroppedDatabaseDeletionDate: la fecha de eliminación de la base de datos eliminada restaurable especificada no es válida

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

  • 400 MissingRecoverableDatabaseId: falta el identificador de base de datos recuperable.

  • 400 MissingRecoveryServicesRecoveryPointId: falta el identificador del punto de recuperación de los servicios de recuperación.

  • 400 MissingRestorableDroppedDatabaseId: falta restorableDroppedDatabaseId

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

  • 400 MissingSourceDatabaseDeletionDate: falta la fecha de eliminación de la base de datos de origen

  • 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á especificado en modo de creación de restauración

  • 400 MultipleIdentitiesOnDatabase: solo se admite una identidad administrada asignada por el usuario en el nivel de base de datos.

  • 400 MultipleIdentityDelegationsOnDatabase: solo se admite una delegación de identidad en el nivel de base de datos.

  • 400 MissingPrimaryDelegatedIdentityClientId: para usar identidades delegadas, proporcione un identificador de cliente de identidad delegada principal.

  • 400 LongTermRetentionMigrationRequestNotSupported: no se permite la característica de migración de copia de seguridad LTR.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported: las suscripciones de origen y de destino no pueden comunicarse con la característica de copia de seguridad ltr.

  • 400 LongTermRetentionMigrationParameterMissing: falta el parámetro requerido para la operación.

  • 400 LongTermRetentionMigrationSameServerNotSupported: no se admite la característica de copia de LTR para copiar copias de seguridad de LTR en el mismo servidor.

  • 400 LongTermRetentionMigrationTargetServerNotFound: el servidor de destino no existe o no está listo para la operación de copia de seguridad ltr.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound: la base de datos de destino no existe en el servidor.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported: la redundancia de almacenamiento de copia de seguridad especificada no se admite en la región de destino.

  • 400 LongTermRetentionMigrationStorageMismatch: la redundancia de copia de seguridad activa de la base de datos no coincide con la redundancia de copia de seguridad solicitada por el cliente.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported: la migración de LTR solo se admite para las copias de seguridad de DB LTR y de instancia administrada Azure SQL.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed: no se permite cambiar la redundancia del almacenamiento de copia de seguridad para las operaciones de copia ltr.

  • 400 LongTermRetentionMigrationSubscriptionNotFound: no se encontró la suscripción.

  • 400 InvalidStandbyGeoReadScale: el usuario intentó habilitar la escala de lectura en una base de datos geográfica en espera que no lo admita.

  • 400 PerDatabaseCMKKeyRotationAttemptedWhileOldThumbprintInUse: rotación de claves para el protector de TDE en el nivel de base de datos se bloquea cuando las transacciones activas mantienen el registro cifrado con claves antiguas. Consulte aka.ms/azuresqldbkeyrotation para ver posibles estrategias para solucionar este problema.

  • 400 TierChangeUnsupportedDueToMemoryOptimizedObject: la base de datos no puede actualizar su SKU porque tiene objetos optimizados para memoria.

  • 400 PerDBCMKNotSupportedWithLTR: CMK de nivel de base de datos no se admite cuando la retención de copia de seguridad a largo plazo está habilitada en la base de datos.

  • 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 ElasticPoolOverStorageUsage: se intenta escribir datos en una base de datos cuando se alcanza el límite de almacenamiento del grupo elástico.

  • 400 InvalidDatabaseCreateMode: solicitud no válida para crear una base de datos.

  • 400 MissingAsymmetricKeyOnTargetServer: el servidor de destino no tiene acceso a una clave asimétrica.

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

  • 400 MultipleDroppedDatabasesWithTheSameName: se encontraron varias bases de datos quitadas con el mismo nombre en el servidor.

  • 400 InvalidAddSecondaryPermission: el usuario no tiene permiso suficiente para agregar secundario en el servidor especificado.

  • 400 AzureKeyVaultClientError: el cliente de Azure Key Vault encontró un error.

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

  • 400 AzureKeyVaultClientInfoError: error al obtener información para el cliente de Azure Key Vault.

  • 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 IsLedgerDatabaseIsNotSupportedOnResourceType: no se admite el cambio de la propiedad ledger para este tipo de recurso.

  • 400 InvalidBackupStorageAccountType: el usuario pasó zrs/lrs durante la creación o actualización de una base de datos, pero no se pudo realizar porque el cliente no está en la lista blanca o porque zrs no está disponible en la región especificada.

  • 400 CannotUpdateToFreeDatabase: no se admite la actualización de una base de datos a la SKU gratuita.

  • 400 DatabaseInvalidSkuPropertyCombination: las propiedades de la SKU solicitada son incoherentes. Compruebe que se especifica una combinación válida. Para obtener más información, consulte https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.

  • 400 DatabaseNamedReplicaPerDatabaseLimitExceeded: el usuario intentó crear una réplica con nombre que superaría el número permitido por base de datos principal.

  • 400 No supportededBackupStorageRedundancyForEdition: no se admite la redundancia de almacenamiento de copia de seguridad solicitada para la edición.

  • 400 DatabaseIsCurrentlyPinned: Microsoft ha anclado la versión del motor de SQL Server base de datos. Para asegurarse de que la base de datos no alcanza los problemas de producción, las operaciones de escalado futuras de la base de datos se bloquearán hasta que no se haya anclado. Póngase en contacto con el soporte técnico de Microsoft para obtener ayuda con el escalado.

  • 400 RestoreTargetEditionSizeInsufficient: el usuario intentó restaurar una base de datos en una edición con un tamaño menor que el tamaño asignado actual del origen.

  • 400 InvalidSku: el usuario especificó una SKU no válida.

  • 400 InvalidTierSkuCombination: el nivel especificado no admite la SKU especificada.

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

  • 400 No supportededBackupStorageRedundancy: la redundancia de almacenamiento de copia de seguridad especificada no se admite en la región de destino.

  • 400 InvalidIdentityId: uno o varios identificadores de identidad proporcionados no son identificadores de recursos de ARM válidos. Escriba los identificadores válidos e inténtelo de nuevo.

  • 400 LTRSterlingToVldbMigrationNotSupported: no se puede cambiar el objetivo de servicio de la base de datos a Hiperescala, ya que aún no se admite la retención a largo plazo en Hiperescala. Deshabilite la retención a largo plazo en la base de datos y vuelva a intentarlo.

  • 400 TokenTooLong: el token proporcionado es demasiado largo.

  • 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos.

  • 400 OfferDisabledOnSubscription: el tipo de oferta de suscripción está restringido al aprovisionamiento del recurso solicitado.

  • 400 UnableToCreateGeoChain: el usuario intentó crear una base de datos secundaria (encadenamiento) aunque se haya configurado la carga automática de resúmenes de libro de contabilidad.

  • 400 InvalidNumberOfIdentities: solo se admite una identidad administrada asignada por el usuario en el nivel de base de datos.

  • 400 DatabaseNamedReplicaChainingNotAllowed: el usuario intentó crear una réplica con nombre de una réplica con nombre que no está permitida.

  • 400 DatabaseNamedReplicaInvalidOperation: el usuario intentó una operación no admitida en una réplica con nombre.

  • 400 DatabaseNamedReplicaInvalidSourceDatabase: el usuario intentó crear una réplica con nombre en una suscripción o región diferente a la base de datos de origen.

  • 400 InvalidTargetSubregion: el servidor de destino de una base de datos secundaria no legible no está en una región de Azure emparejada con recuperación ante desastres.

  • 400 CannotAssignIdentityToMaster: no se puede asignar una identidad a una base de datos del sistema. La identidad de base de datos no se puede asignar a las bases de datos "master", "model", "tempdb", "msdb" o "resource".

  • 400 PerDatabaseCMKDWNotSupported: CMK de nivel de base de datos en versión preliminar no se admite para la edición Datawarehouse.

  • 400 DatabaseCreationBlockedForNonActivatedCMKServer: las creaciones de grupos de SQL están bloqueadas para las áreas de trabajo habilitadas para CMK hasta que se active el área de trabajo. En primer lugar, habilite la protección de purga y conceda a la identidad administrada del área de trabajo los permisos necesarios (Get, Wrap Key, Unwrap Key) en azure Key Vault de la clave del área de trabajo. A continuación, active el área de trabajo después de haber concedido acceso.

  • 400 PartnerServerNotCompatible: el usuario está intentando copiar una base de datos de un servidor SAWA V1 en un servidor Sterling o viceversa.

  • 400 IncorrectReplicationLinkState: la operación espera que la base de datos esté en un estado esperado en el vínculo de replicación.

  • 400 TargetElasticPoolDoesNotExist: el grupo elástico no existe en un servidor.

  • 400 ElasticPoolSkuCombinationInvalid: el grupo elástico y la SKU solo se pueden especificar juntos si se especifica sku como "ElasticPool".

  • 400 ElasticPoolTierCombinationInvalid: el nivel de base de datos es diferente del nivel de servicio del grupo elástico.

  • 400 ElasticPoolNameRequired: el usuario intentó crear o actualizar la base de datos al objetivo de servicio del grupo elástico sin especificar el nombre del grupo elástico.

  • 400 MissingThumbprintCrm: error en la operación de restauración de una base de datos CRM porque faltaba un certificado TDE necesario. Vuelva a intentar la operación de restauración en un grupo elástico existente.

  • 400 ElasticPoolOverStorage: se intenta escribir datos en una base de datos cuando se alcanza el límite de almacenamiento del grupo elástico.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings: intento de proporcionar DTU min para las bases de datos del grupo elástico que superen las DTU solicitadas del grupo elástico.

  • 400 RestoreTargetEditionSizeInsufficientV2: el usuario intentó restaurar una base de datos en una edición con un tamaño menor que el tamaño asignado de la base de datos restaurada.

  • 400 TierChangeUnsupportedDueToCDCEnabledDatabase: la base de datos no puede actualizar su SKU porque está habilitada para CDC.

  • 400 ElasticPoolDatabaseCountOverLimit: se intenta crear o agregar una base de datos al grupo elástico cuando se alcanza el límite de recuento de bases de datos del grupo elástico.

  • 400 ResourcePoolStorageLimitHitDuringRestore: la base de datos restaurada no se puede restaurar en el grupo de recursos debido a la capacidad de almacenamiento restante del grupo.

  • 400 CannotChangeToOrFromDataWarehouseTier: el usuario intentó cambiar la SKU de una base de datos del nivel DataWarehouse a niveles que no son dataWarehouse o viceversa.

  • 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 PerDatabaseCMKRestoreNotSupported: la restauración de base de datos no se admite cuando cmK de nivel de base de datos está configurado en versión preliminar.

  • 400 PerDatabaseCMKHSNotSupported: CMK de nivel de base de datos en versión preliminar no se admite para la edición Hyperscale.

  • 400 AzureKeyVaultKeyDisabled: no se pudo completar la operación en el servidor porque la clave de Azure Key Vault está deshabilitada.

  • 400 PerDatabaseCMKGeoReplicationNotSupported: la replicación geográfica y la copia de base de datos no se admiten cuando cmK de nivel de base de datos está configurado en versión preliminar.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage: intenta reducir el límite de almacenamiento del grupo elástico por debajo de su uso de almacenamiento.

  • 400 AzureKeyVaultInvalidExpirationDate: no se pudo completar la operación porque la fecha de expiración de la clave de Azure Key Vault no es válida.

  • 400 InvalidStandbyGeoEdition: el usuario intentó crear una geolocalización en espera basada en DTU.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty: no se pudo completar la operación porque el URI de Azure Key Vault es nulo o está vacío.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings: el número de bases de datos y núcleo virtual mínimo por base de datos no puede superar los núcleos virtuales solicitados del grupo elástico.

  • 400 UpdateNotAllowedOnPausedDatabase: el usuario intentó realizar una actualización en una base de datos en pausa.

  • 400 GeoRestoreBackupStorageTypeNotSupported: las solicitudes de recuperación de base de datos no son válidas cuando se emiten en una base de datos que no está configurada para usar el almacenamiento de copia de seguridad con redundancia geográfica.

  • 400 RestoreHyperscaleToNonHyperscale: no se admite la restauración de una copia de seguridad de base de datos de Hiperescala en un nivel de servicio que no sea hiperescala o viceversa.

  • 400 SubscriptionDoesNotHaveAccessToServer: la suscripción no tiene acceso a los servidores especificados.

  • 400 RecoveryPointDoesNotExist: el punto de recuperación especificado no existe o no es válido.

  • 400 AzureKeyVaultNoServerIdentity: la identidad del servidor no está configurada correctamente.

  • 400 InvalidMaxSizeTierCombination: el nivel especificado no admite el tamaño máximo de la base de datos especificada.

  • 400 LtrBackupNotFound: la copia de seguridad de retención a largo plazo especificada no existe.

  • 400 AzureKeyVaultInvalidUri: una respuesta no válida de Azure Key Vault. Use un URI de Azure Key Vault válido.

  • 400 InvalidPointInTime: el momento especificado no es válido para la base de datos.

  • 400 AzureKeyVaultMissingPermissions: faltan permisos necesarios en azure Key Vault el servidor.

  • 400 GeoRestoreCannotResolveTargetCluster: no se puede resolver el clúster de destino para el servidor

  • 400 InvalidReadScaleEdition: el usuario intentó habilitar la escala de lectura en un tipo de base de datos que no lo admite.

  • 400 CannotSpecifyEditionOrSloWhenRe storageToPool: no se admite la especificación del objetivo o edición de nivel de servicio de destino al restaurar en un grupo elástico.

  • 400 InvalidReadScaleUnits: el usuario intentó proporcionar un valor de escala de lectura que no se admite.

  • 400 RestoreNotSupportedForGeoDrSecondary: las operaciones de restauración a un momento dado y de recuperación de bases de datos no se admiten en las bases de datos que están configuradas actualmente como secundarias geográficas.

  • 400 SecurityAzureKeyVaultInvalidKeyName: no se pudo completar la operación debido a un nombre de clave de servidor no válido.

  • 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 GeoSecondaryMaxSizeUpdateFailed: la base de datos secundaria geográfica es de un SLO que no admite el valor maxsize solicitado o la base de datos secundaria geográfica está en una región no admitida o una operación de actualización ya está en curso en la base de datos secundaria geográfica.

  • 400 AdalGenericError: no se pudo completar la operación porque se encontró un error de Azure Active Directory.

  • 400 AdalServicePrincipalNotFound: no se pudo completar la operación porque no se encontró un error en la entidad de servicio de la biblioteca de Azure Active Directory.

  • 400 InvalidTier: el usuario especificó un nivel no válido.

  • 400 AzureKeyVaultMalformedVaultUri: el URI de Key Vault proporcionado no es válido.

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

  • 400 RequestedDatabaseSizeRequiresShrink: el usuario intentó modificar ALTER DATABASE MODIFY MAXSIZE para modificar MAXSIZE para una base de datos a un tamaño menor y, a continuación, el tamaño actual.

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

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

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

  • 400 SourceDatabaseEditionCouldNotBeUpgraded: la base de datos de origen no puede tener una edición superior a la base de datos de destino.

  • 400 SecurityAdalPrincipalCertExpiredError: no se pudo completar la operación porque el certificado de entidad de seguridad de Azure Key Vault ha expirado.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded: la base de datos de destino no puede tener una edición inferior a la base de datos de origen.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress: la operación no se permite porque la operación de copia o conmutación por error para la base de datos "{0}" en el servidor "{1}" está actualmente en curso.

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

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel: el URI de Key Vault proporcionado no es válido.

  • 400 KeyMaterialNotFoundOnRemoteServer: el servidor remoto no tiene acceso al material de clave utilizado como protector de TDE.

  • 400 AzureKeyVaultRsaKeyNotSupported: el almacén de claves proporcionado usa el tamaño de clave RSA o el tipo de clave no admitidos. El tamaño de clave RSA admitido es 2048 o 3072 y el tipo de clave es RSA o RSA-HSM.

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

  • 400 ElasticPoolOverFileSpace: espacio de archivos insuficiente en el grupo elástico.

  • 400 PartnerDBNotCompatibleForSGXEnclave: solo se admite el intento de establecer el vínculo GeoDR o actualizar SLO para la base de datos habilitada para enclave cuando ambas bases de datos se ejecutan en hardware de la serie DC.

  • 400 UpdateNotAllowedInCurrentReplicationState: la operación no se permite en la base de datos en su estado de replicación actual.

  • 400 InvalidLicenseType: el usuario intentó crear o actualizar una base de datos o un grupo elástico con un tipo de licencia no admitido.

  • 400 GeoReplicaLimitReached: se alcanzó el límite de replicación por réplica.

  • 400 UnsupportedCapacity: el usuario intentó crear o actualizar la base de datos con capacidad que no se admite.

  • 400 ReplicationSourceAndTargetMustHaveSameName: las bases de datos de origen y destino de replicación deben tener el mismo nombre.

  • 400 ProvisioningDisabled: muestra el mensaje de error del autorizador de la operación de recursos tal cual, sin cambios

  • 400 ReplicationSourceAndTargetMustBeInDifferentServers: las bases de datos de origen y destino de replicación deben estar en servidores lógicos diferentes.

  • 400 CannotUpdateIsLedgerDatabase: no se puede actualizar la propiedad ledger de una base de datos existente.

  • 400 UnableToResolveRemoteServer: no se pudo resolver el nombre del servidor asociado remoto debido a un nombre de servidor no válido o problemas de conectividad DNS.

  • 400 RemoteDatabaseCopyPermission: el usuario no tiene permiso suficiente para crear una copia de base de datos en el servidor especificado.

  • 400 CannotMoveOrDropSyncMetadatabase: no se puede quitar la base de datos usada como base de datos de metadatos de sincronización.

  • 400 SecurityAzureKeyVaultGeoChainError: no se admite la creación de una base de datos secundaria (un proceso conocido como encadenamiento) al habilitar el cifrado de datos transparente mediante Azure Key Vault (BYOK).

  • 400 RestoreToFreeEditionNotSupported: el destino Restore y GeoRestore no puede ser una base de datos gratuita.

  • 400 CannotMoveOrDropJobAccountDatabase: no se puede quitar la base de datos asociada a la cuenta de trabajo.

  • 400 RestoreNotSupportedForFreeEdition: la restauración y georestore no se admiten para la base de datos gratuita.

  • 400 JobAgentDatabaseEditionUnsupported: el objetivo de nivel de servicio de la base de datos especificada no se admite para su uso como base de datos del agente de trabajo.

  • 400 InvalidDroppedDatabase: la base de datos de origen eliminada no existe en el servidor dentro del período de recuperación admitido.

  • 400 InvalidLiveDatabase: la base de datos de origen no existe en el servidor dentro del período de recuperación admitido. Si restaura una base de datos quitada, especifique su fecha de eliminación.

  • 400 InvalidVldbRecoverySlo: la recuperación de la edición Hiperescala requiere bases de datos de origen y de destino para usar el objetivo de nivel de servicio de Hiperescala.

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

  • 400 InvalidVldbRestoreSlo: la restauración a un momento dado de edición de Hiperescala requiere bases de datos de origen y de destino para usar el objetivo de nivel de servicio de Hiperescala.

  • 400 CannotSpecifyPoolOrSlo: no se admite la especificación de un grupo elástico ni el cambio del objetivo o edición de nivel de servicio para la edición.

  • 400 InvalidPublicMaintenanceConfiguration: el usuario intentó especificar la configuración de mantenimiento público que no se puede convertir en identificador interno (región incorrecta o incorrecta).

  • 400 MaintenanceWindowNotSupportedForNamedReplica: el usuario intentó crear o actualizar la réplica con nombre con una ventana de mantenimiento no predeterminada que no es compatible.

  • 400 ChangeUnsupportedOnEntity: el usuario intentó una operación de creación, actualización o eliminación no admitida en una entidad determinada.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 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 LongTermRetentionMigrationBackupNotFound: la copia de seguridad de LTR especificada no existe.

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

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

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

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

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

  • 405 UnsupportedReplicationOperation: se inició una operación de replicación no admitida en la base de datos.

  • 409 OperationCancelled: el usuario ha cancelado la operación.

  • 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.

  • 409 LongTermRetentionMigrationRequestConflict: una operación de conflicto en esta copia de seguridad ltR todavía está en curso.

  • 409 LongTermRetentionMigrationBackupConflict: existe otra copia de seguridad LTR con la misma hora de copia de seguridad para la base de datos de destino.

  • 409 FreeDbAlreadyExists: solo puede existir una base de datos gratuita para una suscripción por región.

  • 409 ConflictingServerOperation: una operación está actualmente en curso para el servidor.

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

  • 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.

  • 409 ConflictRequestToUpdateBackupRedundancy: una solicitud de conflicto para cambiar la redundancia del almacenamiento de copia de seguridad sigue en curso.

  • 409 SkuAssignmentInProgress: no se puede procesar la solicitud de asignación actual porque no se ha completado una solicitud anterior.

  • 409 DatabaseElasticPoolMaintenanceConflict: el usuario intentó crear o actualizar una base de datos con una configuración de mantenimiento especificada que entra en conflicto con la del grupo elástico de la base de datos.

  • 409 ServerDtuQuotaExceededed: no se pudo realizar la operación porque el servidor superaría la cuota de unidad de rendimiento de base de datos permitida.

  • 409 UnableToAlterDatabaseInReplication: edición modificada por el usuario en una base de datos en una relación de replicación.

  • 409 SubscriptionVcoreQuotaExceeded: no se pudo realizar la operación porque la suscripción superaría la cuota de núcleo virtual permitida.

  • 409 CurrentMemoryUsageExceedsSkuQuota: el usuario intentó realizar una operación de actualización de SKU que no se puede completar debido al mayor consumo de recursos.

  • 409 ServerKeyNameAlreadyExists: la clave de servidor ya existe en el servidor.

  • 409 ServerKeyUriAlreadyExists: el URI de la clave de servidor ya existe en el servidor.

  • 409 ServerKeyDoesNotExists: la clave del servidor no existe.

  • 409 UpdateSloInProgress: el usuario intentó iniciar una operación incompatible mientras estaba en curso una actualización de SLO.

  • 409 UpdateSloFailedDatabaseTooBusy: no se pudo completar la operación de SLO de actualización porque la base de datos estaba demasiado ocupada.

  • 409 ElasticPoolBusy: se intentó realizar una operación de administración en un grupo elástico que está ocupado.

  • 409 AzureKeyVaultKeyNameNotFound: no se pudo completar la operación porque el nombre de clave de Azure Key Vault no existe.

  • 409 AzureKeyVaultKeyInUse: el servidor usa la clave.

  • 409 ServerDisabled: el servidor está deshabilitado.

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

  • 409 SimultaneousSkuChangeNotAllowed: las operaciones de cambio de objetivo de servicio no se pueden ejecutar en ambas bases de datos de una relación de replicación al mismo tiempo.

  • 409 TargetElasticPoolBeingUpdated: no se puede iniciar la actualización del grupo elástico porque hay una operación de copia en curso para una de las bases de datos de este grupo elástico

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship: se realizó una operación de propagación de replicación en una base de datos que ya está en una relación de replicación.

  • 409 InvalidOperationForDatabaseInReplicationRelationship: se realizó una operación de propagación de replicación en una base de datos que ya está en una relación de replicación.

  • 409 DuplicateGeoDrRelation: las bases de datos ya están en una relación de replicación. Se trata de una solicitud duplicada.

  • 409 DatabaseCopyLimitPerReplicaReached: el usuario alcanzó el límite de copias simultáneas de la base de datos.

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

  • 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.

  • 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 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y,

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget: no se pudo iniciar la solicitud de copia de seguridad ltR en la región de destino.

  • 500 LongTermRetentionMigrationRequestCopyFailed: error en la operación de copia de seguridad para blobs de copia de seguridad LTR.

  • 500 LongTermRetentionMigrationRestoreVerExceeded: error en la comprobación de la restauración después de alcanzar los intentos máximos.

  • 500 LongTermRetentionMigrationRestoreVerFailed: error de comprobación de restauración.

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

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

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

  • 503 AzureKeyVaultConnectionFailed: no se pudo completar la operación en el servidor porque se ha producido un error al intentar conectarse a Azure Key Vault

  • 503 AzureKeyVaultGenericConnectionError: no se pudo completar la operación porque se encontró un error al intentar recuperar Key Vault información .

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

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

Ejemplos

Assigns maintenance window to a database.
Resets maintenance window of a database to default.
Updates a database.

Assigns maintenance window to a database.

Solicitud de ejemplo

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

{
  "sku": {
    "name": "BC_Gen5_4"
  },
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1"
  }
}

Respuesta de muestra

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 4
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 4
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Resets maintenance window of a database to default.

Solicitud de ejemplo

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

{
  "sku": {
    "name": "BC_Gen5_4"
  },
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
  }
}

Respuesta de muestra

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 4
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_4",
    "requestedServiceObjectiveName": "BC_Gen5_4",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 4
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Updates a database.

Solicitud de ejemplo

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

{
  "sku": {
    "name": "BC_Gen4_4"
  },
  "properties": {
    "maxSizeBytes": 1073741824,
    "licenseType": "LicenseIncluded"
  }
}

Respuesta de muestra

{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "capacity": 4
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "requestedServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 4
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Local",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Definiciones

Nombre Description
BackupStorageRedundancy

Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.

CatalogCollationType

Intercalación del catálogo de metadatos.

CreateMode

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación normal de la base de datos.

Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen.

Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente.

PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime.

Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como identificador de recurso de base de datos recuperable que se va a restaurar.

Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos eliminado que se puede restaurar y se omite sourceDatabaseDeletionDate. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior.

RestoreLongTermRetentionBackup: crea una base de datos mediante la restauración desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso del punto de recuperación.

Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.

Database

Un recurso de base de datos.

DatabaseIdentity

Configuración de identidad de Azure Active Directory para un recurso.

DatabaseIdentityType

Tipo de identidad

DatabaseLicenseType

Tipo de licencia que se va a aplicar a esta base de datos. LicenseIncludedsi necesita una licencia o BasePrice si tiene una licencia y es apta para la Ventaja híbrida de Azure.

DatabaseReadScale

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en sus cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.

DatabaseStatus

Estado de la base de datos.

DatabaseUpdate

Un recurso de actualización de base de datos.

DatabaseUserIdentity

Configuración de identidad de Azure Active Directory para un recurso.

SampleName

Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.

SecondaryType

El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo y Named.

Sku

Una SKU de recursos de ARM.

BackupStorageRedundancy

Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.

Nombre Tipo Description
Geo

string

GeoZone

string

Local

string

Zone

string

CatalogCollationType

Intercalación del catálogo de metadatos.

Nombre Tipo Description
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

CreateMode

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación normal de la base de datos.

Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen.

Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente.

PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime.

Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como identificador de recurso de base de datos recuperable que se va a restaurar.

Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos eliminado que se puede restaurar y se omite sourceDatabaseDeletionDate. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior.

RestoreLongTermRetentionBackup: crea una base de datos mediante la restauración desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso del punto de recuperación.

Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.

Nombre Tipo Description
Copy

string

Default

string

OnlineSecondary

string

PointInTimeRestore

string

Recovery

string

Restore

string

RestoreExternalBackup

string

RestoreExternalBackupSecondary

string

RestoreLongTermRetentionBackup

string

Secondary

string

Database

Un recurso de base de datos.

Nombre Tipo Description
id

string

Identificador del recurso.

identity

DatabaseIdentity

Identidad de Azure Active Directory de la base de datos.

kind

string

Tipo de base de datos. Estos son los metadatos que se usan para la experiencia de Azure Portal.

location

string

Ubicación del recurso

managedBy

string

Recurso que administra la base de datos.

name

string

Nombre del recurso.

properties.autoPauseDelay

integer

Tiempo en minutos después del cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada.

properties.catalogCollation

CatalogCollationType

Intercalación del catálogo de metadatos.

properties.collation

string

Intercalación de la base de datos.

properties.createMode

CreateMode

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación normal de la base de datos.

Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen.

Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como el identificador de recurso de la base de datos principal existente.

PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime.

Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como identificador de recurso de base de datos recuperable que se va a restaurar.

Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. se debe especificar sourceDatabaseId. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos quitable restaurable y sourceDatabaseDeletionDate se omite. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior.

RestoreLongTermRetentionBackup: crea una base de datos restaurando desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso de punto de recuperación.

Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.

properties.creationDate

string

Fecha de creación de la base de datos (ISO8601 formato).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.

properties.currentServiceObjectiveName

string

Nombre objetivo de nivel de servicio actual de la base de datos.

properties.currentSku

Sku

Nombre y nivel de la SKU.

properties.databaseId

string

El Id. de la base de datos.

properties.defaultSecondaryLocation

string

Región secundaria predeterminada para esta base de datos.

properties.earliestRestoreDate

string

Esto registra la fecha y hora de inicio más tempranas que la restauración está disponible para esta base de datos (ISO8601 formato).

properties.elasticPoolId

string

Identificador de recurso del grupo elástico que contiene esta base de datos.

properties.failoverGroupId

string

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

properties.federatedClientId

string

Identificador de cliente que se usa para el escenario de CMK entre inquilinos por base de datos

properties.highAvailabilityReplicaCount

integer

Número de réplicas secundarias asociadas a la base de datos que se usan para proporcionar alta disponibilidad. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.

properties.isInfraEncryptionEnabled

boolean

El cifrado de infraestructura está habilitado para esta base de datos.

properties.isLedgerOn

boolean

Si esta base de datos es o no una base de datos de libro de contabilidad, lo que significa que todas las tablas de la base de datos son tablas de libro de contabilidad. Nota: El valor de esta propiedad no se puede cambiar después de crear la base de datos.

properties.licenseType

DatabaseLicenseType

Tipo de licencia que se va a aplicar a esta base de datos. LicenseIncludedsi necesita una licencia o BasePrice si tiene una licencia y es apta para el Ventaja híbrida de Azure.

properties.longTermRetentionBackupResourceId

string

Identificador de recursos de la copia de seguridad de retención a largo plazo asociada al funcionamiento de creación de esta base de datos.

properties.maintenanceConfigurationId

string

Identificador de configuración de mantenimiento asignado a la base de datos. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento.

properties.maxLogSizeBytes

integer

Tamaño máximo del registro de esta base de datos.

properties.maxSizeBytes

integer

Tamaño máximo de la base de datos expresada en bytes.

properties.minCapacity

number

Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa

properties.pausedDate

string

Fecha en que la configuración o acción del usuario pausaron la base de datos (ISO8601 formato). Null si la base de datos está lista.

properties.readScale

DatabaseReadScale

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen la intención de aplicación establecida en readonly en sus cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.

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.recoveryServicesRecoveryPointId

string

Identificador de recurso del punto de recuperación asociado a la operación de creación de esta base de datos.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta base de datos.

properties.requestedServiceObjectiveName

string

Nombre objetivo de nivel de servicio solicitado de la base de datos.

properties.restorableDroppedDatabaseId

string

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

properties.restorePointInTime

string

Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.resumedDate

string

Fecha en la que se reanudó la base de datos mediante la acción del usuario o el inicio de sesión de la base de datos (ISO8601 formato). Null si la base de datos está en pausa.

properties.sampleName

SampleName

Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.

properties.secondaryType

SecondaryType

El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo y Named.

properties.sourceDatabaseDeletionDate

string

Especifica la hora en que se eliminó la 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.sourceResourceId

string

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

Esta propiedad solo se admite para la edición DataWarehouse y permite restaurar entre suscripciones.

Cuando se especifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId y sourceDatabaseDeletionDate no deben especificarse y CreateMode debe ser PointInTimeRestore, Restore o Recover.

Cuando createMode es PointInTimeRestore, sourceResourceId debe ser el identificador de recurso de la base de datos existente o el grupo de sql existente y se debe especificar restorePointInTime.

Cuando createMode es Restore, sourceResourceId debe ser el identificador de recurso de la base de datos eliminada restaurable o el grupo de sql que se puede restaurar.

Cuando createMode es Recover, sourceResourceId debe ser el identificador de recurso de la base de datos recuperable o el grupo de sql recuperable.

Cuando la suscripción de origen pertenece a un inquilino diferente de la suscripción de destino, el encabezado "x-ms-authorization-auxiliary" debe contener el token de autenticación para el inquilino de origen. Para obtener más información sobre el encabezado "x-ms-authorization-auxiliary", consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.status

DatabaseStatus

Estado de la base de datos.

properties.zoneRedundant

boolean

Si esta base de datos tiene redundancia de zona, lo que significa que las réplicas de esta base de datos se distribuirán entre varias zonas de disponibilidad.

sku

Sku

SKU de base de datos.

La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la Capabilities_ListByLocation API REST o uno de los siguientes comandos:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
tags

object

Etiquetas del recurso.

type

string

Tipo de recurso.

DatabaseIdentity

Configuración de identidad de Azure Active Directory para un recurso.

Nombre Tipo Description
tenantId

string

Identificador de inquilino de Azure Active Directory.

type

DatabaseIdentityType

Tipo de identidad

userAssignedIdentities

<string,  DatabaseUserIdentity>

Identificadores de recurso de las identidades asignadas por el usuario que se van a usar

DatabaseIdentityType

Tipo de identidad

Nombre Tipo Description
None

string

UserAssigned

string

DatabaseLicenseType

Tipo de licencia que se va a aplicar a esta base de datos. LicenseIncludedsi necesita una licencia o BasePrice si tiene una licencia y es apta para la Ventaja híbrida de Azure.

Nombre Tipo Description
BasePrice

string

LicenseIncluded

string

DatabaseReadScale

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en sus cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.

Nombre Tipo Description
Disabled

string

Enabled

string

DatabaseStatus

Estado de la base de datos.

Nombre Tipo Description
AutoClosed

string

Copying

string

Creating

string

Disabled

string

EmergencyMode

string

Inaccessible

string

Offline

string

OfflineChangingDwPerformanceTiers

string

OfflineSecondary

string

Online

string

OnlineChangingDwPerformanceTiers

string

Paused

string

Pausing

string

Recovering

string

RecoveryPending

string

Restoring

string

Resuming

string

Scaling

string

Shutdown

string

Standby

string

Starting

string

Stopped

string

Stopping

string

Suspect

string

DatabaseUpdate

Un recurso de actualización de base de datos.

Nombre Tipo Description
identity

DatabaseIdentity

Identidad de la base de datos

properties.autoPauseDelay

integer

Tiempo en minutos después del cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada.

properties.catalogCollation

CatalogCollationType

Intercalación del catálogo de metadatos.

properties.collation

string

Intercalación de la base de datos.

properties.createMode

CreateMode

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación normal de la base de datos.

Copiar: crea una base de datos como una copia de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos de origen.

Secundario: crea una base de datos como una réplica secundaria de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos principal existente.

PointInTimeRestore: crea una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. sourceDatabaseId debe especificarse como identificador de recurso de la base de datos existente y se debe especificar restorePointInTime.

Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. sourceDatabaseId debe especificarse como identificador de recurso de base de datos recuperable que se va a restaurar.

Restaurar: crea una base de datos restaurando una copia de seguridad de una base de datos eliminada. sourceDatabaseId debe especificarse. Si sourceDatabaseId es el identificador de recurso original de la base de datos, se debe especificar sourceDatabaseDeletionDate. De lo contrario, sourceDatabaseId debe ser el identificador de recurso de base de datos eliminado que se puede restaurar y se omite sourceDatabaseDeletionDate. restorePointInTime también se puede especificar para restaurar desde un momento dado anterior.

RestoreLongTermRetentionBackup: crea una base de datos mediante la restauración desde un almacén de retención a largo plazo. recoveryServicesRecoveryPointResourceId debe especificarse como identificador de recurso del punto de recuperación.

Copy, Secondary y RestoreLongTermRetentionBackup no se admiten para la edición DataWarehouse.

properties.creationDate

string

Fecha de creación de la base de datos (formato ISO8601).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.

properties.currentServiceObjectiveName

string

Nombre objetivo de nivel de servicio actual de la base de datos.

properties.currentSku

Sku

Nombre y nivel de la SKU.

properties.databaseId

string

El Id. de la base de datos.

properties.defaultSecondaryLocation

string

Región secundaria predeterminada para esta base de datos.

properties.earliestRestoreDate

string

Esto registra la fecha y hora de inicio más tempranas que la restauración está disponible para esta base de datos (ISO8601 formato).

properties.elasticPoolId

string

Identificador de recursos del grupo elástico que contiene esta base de datos.

properties.failoverGroupId

string

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

properties.federatedClientId

string

Identificador de cliente usado para el escenario de CMK entre inquilinos por base de datos

properties.highAvailabilityReplicaCount

integer

Número de réplicas secundarias asociadas a la base de datos que se usan para proporcionar alta disponibilidad. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.

properties.isInfraEncryptionEnabled

boolean

El cifrado de infraestructura está habilitado para esta base de datos.

properties.isLedgerOn

boolean

Si esta base de datos es o no una base de datos de libro de contabilidad, lo que significa que todas las tablas de la base de datos son tablas de libro de contabilidad. Nota: El valor de esta propiedad no se puede cambiar una vez creada la base de datos.

properties.licenseType

DatabaseLicenseType

Tipo de licencia que se va a aplicar a esta base de datos. LicenseIncludedsi necesita una licencia o BasePrice si tiene una licencia y es apta para la Ventaja híbrida de Azure.

properties.longTermRetentionBackupResourceId

string

Identificador de recursos de la copia de seguridad de retención a largo plazo asociada al funcionamiento de creación de esta base de datos.

properties.maintenanceConfigurationId

string

Identificador de configuración de mantenimiento asignado a la base de datos. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento.

properties.maxLogSizeBytes

integer

Tamaño máximo del registro de esta base de datos.

properties.maxSizeBytes

integer

Tamaño máximo de la base de datos expresada en bytes.

properties.minCapacity

number

Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa

properties.pausedDate

string

La fecha en que la base de datos se ha pausado mediante la configuración del usuario o la acción (ISO8601 formato). Null si la base de datos está lista.

properties.readScale

DatabaseReadScale

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en sus cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región. No es aplicable a una base de datos de Hiperescala dentro de un grupo elástico.

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.recoveryServicesRecoveryPointId

string

Identificador de recurso del punto de recuperación asociado a la operación de creación de esta base de datos.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta base de datos.

properties.requestedServiceObjectiveName

string

Nombre objetivo de nivel de servicio solicitado de la base de datos.

properties.restorableDroppedDatabaseId

string

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

properties.restorePointInTime

string

Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.resumedDate

string

Fecha en la que la acción del usuario reanudó la base de datos o el inicio de sesión de la base de datos (ISO8601 formato). Null si la base de datos está en pausa.

properties.sampleName

SampleName

Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.

properties.secondaryType

SecondaryType

El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo y Named.

properties.sourceDatabaseDeletionDate

string

Especifica la hora en que se eliminó la 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

DatabaseStatus

Estado de la base de datos.

properties.zoneRedundant

boolean

Si esta base de datos tiene redundancia de zona o no, lo que significa que las réplicas de esta base de datos se distribuirán entre varias zonas de disponibilidad.

sku

Sku

Nombre y nivel de la SKU.

tags

object

Etiquetas del recurso.

DatabaseUserIdentity

Configuración de identidad de Azure Active Directory para un recurso.

Nombre Tipo Description
clientId

string

Identificador de cliente de Azure Active Directory.

principalId

string

Identificador de entidad de seguridad de Azure Active Directory.

SampleName

Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.

Nombre Tipo Description
AdventureWorksLT

string

WideWorldImportersFull

string

WideWorldImportersStd

string

SecondaryType

El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo y Named.

Nombre Tipo Description
Geo

string

Named

string

Sku

Una SKU de recursos de ARM.

Nombre Tipo Description
capacity

integer

Capacidad de la SKU determinada.

family

string

Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.

name

string

El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3.

size

string

Tamaño de la SKU determinada

tier

string

Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.