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-08-01-preview

Parámetros de identificador URI

Name In Required Type 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

Name Type Description
identity

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

Intercalación del catálogo de metadatos.

properties.collation
  • string

Intercalación de la base de datos.

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

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 expresado en bytes.

properties.minCapacity
  • number

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

properties.readScale

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

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 (formato ISO8601) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.sampleName

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

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

Nombre y nivel de la SKU.

tags
  • object

Etiquetas del recurso.

Respuestas

Name Type Description
200 OK

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 se permite 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 Storage 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 InvalidCollation: el servidor no reconoce la intercalación.

  • 400 ProvisioningDisabled: muestra el mensaje de error del autorizador de operaciones de recursos tal y como está, sin cambios

  • 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 problemas de conectividad dns o nombre de servidor no válidos.

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

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

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

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

  • 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 GeoReplicaLimitReached: se alcanzó el límite de replicación por réplica.

  • 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 ReplicationSourceAndTargetMustHaveSameName: las bases de datos de origen y destino de replicación deben tener el mismo nombre.

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

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

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

  • 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 TierChangeUnsupportedDueToMemoryOptimizedObject: la base de datos no puede actualizar su SKU porque tiene objetos optimizados para memoria.

  • 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 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 InvalidAddSecondaryPermission: el usuario no tiene permiso suficiente para agregar secundario en el servidor especificado.

  • 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 TokenTooLong: el token proporcionado es demasiado largo.

  • 400 IsLedgerDatabaseIsNotSupportedOnResourceType: no se admite el cambio de la propiedad ledger para este tipo de recurso.

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

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

  • 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 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 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 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 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 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 AzureKeyVaultKeyDisabled: no se pudo completar la operación en el servidor porque la clave de Azure Key Vault está deshabilitada.

  • 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 SecurityAzureKeyVaultUrlNullOrEmpty: no se pudo completar la operación porque el URI de Azure Key Vault es nulo o está vacío.

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

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

  • 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 AzureKeyVaultMissingPermissions: faltan permisos necesarios en azure Key Vault el servidor.

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

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

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

  • 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 CannotChangeToOrFromDataWarehouseTier: el usuario intentó cambiar la SKU de una base de datos del nivel DataWarehouse a niveles que no son dataWarehouse o viceversa.

  • 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 se encontró un error de Azure Active Directory entidad de servicio de biblioteca.

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

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

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

  • 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 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 CannotUseTrailingWhitespacesInDatabaseName: error en la validación del nombre de la base de datos.

  • 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 SecurityAdalPrincipalCertExpiredError: no se pudo completar la operación porque el certificado de entidad de seguridad de Azure Key Vault ha expirado.

  • 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 SourceDatabaseEditionCouldNotBeUpgraded: la base de datos de origen no puede tener una edición superior a la base de datos de destino.

  • 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 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 ElasticPoolOverFileSpace: espacio de archivos insuficiente en el grupo elástico.

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

  • 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 UnsupportedCapacity: el usuario intentó crear o actualizar la base de datos con capacidad que no se admite.

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

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

  • 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 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 CannotMoveOrDropJobAccountDatabase: no se puede quitar la base de datos asociada a la cuenta de trabajo.

  • 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 CannotUpdateToFreeDatabase: no se admite la actualización de una base de datos a la SKU gratuita.

  • 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 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 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 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 DatabaseCreationBlockedForNonActivatedCMKServer: las creaciones del grupo de SQL se bloquean 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 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ó realizar una operación no admitida en una réplica con nombre.

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

  • 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 CannotMoveOrDropSyncMetadatabase: no se puede quitar la base de datos utilizada como base de datos de metadatos de sincronización.

  • 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 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 InvalidMaxSizeTierCombination: el nivel especificado no admite el tamaño máximo de la base de datos especificado.

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

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

  • 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 CannotFindObject: no se encuentra el objeto porque no existe o no tiene permisos

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

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

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

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

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

  • 409 OperationCancelled: el usuario canceló 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 el mismo tiempo de copia de seguridad para la base de datos de destino.

  • 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 RemoteDatabaseExists: el nombre de la base de datos de destino ya existe en el servidor de destino.

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

  • 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 a que se completen otras operaciones.

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

  • 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 ServerDtuQuotaExceeded: no se pudo realizar la operación porque el servidor superaría la cuota de unidad de rendimiento de base de datos permitida.

  • 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 UnableToAlterDatabaseInReplication: edición modificada por el usuario en una base de datos en una relación de replicación.

  • 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 AzureKeyVaultKeyNameNotFound: no se pudo completar la operación porque el nombre de clave de Azure Key Vault no existe.

  • 409 AzureKeyVaultKeyInUse: la clave está siendo utilizada actualmente por el servidor.

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

  • 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 DatabaseCopyLimitPerReplicaReached: el usuario alcanzó el límite de copias simultáneas de la base de datos.

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

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

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

  • 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 500 OperationTimedOut: se agota el tiempo de espera de la operación 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 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 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.

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

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

Sample Request

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-08-01-preview

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

Sample Response

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

Sample Request

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-08-01-preview

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

Sample Response

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

Sample Request

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-08-01-preview

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

Sample Response

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

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

Azure Active Directory configuración de identidad 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

Azure Active Directory configuración de identidad de 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.

Name Type Description
Geo
  • string
GeoZone
  • string
Local
  • string
Zone
  • string

CatalogCollationType

Intercalación del catálogo de metadatos.

Name Type 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.

Name Type 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.

Name Type Description
id
  • string

Identificador del recurso.

identity

Identidad 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

Intercalación del catálogo de metadatos.

properties.collation
  • string

Intercalación de la base de datos.

properties.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 (formato ISO8601).

properties.currentBackupStorageRedundancy

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

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 (formato ISO8601).

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

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 (formato ISO8601). Null si la base de datos está lista.

properties.readScale

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

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 (formato ISO8601) 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 por acción de usuario o inicio de sesión de base de datos (formato ISO8601). Null si la base de datos está en pausa.

properties.sampleName

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

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

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 una base de datos existente o un 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.

Esta propiedad permite restaurar entre suscripciones que solo se admiten para la edición DataWarehouse.

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

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

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

Name Type Description
tenantId
  • string

Identificador de inquilino de Azure Active Directory.

type

Tipo de identidad

userAssignedIdentities

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

DatabaseIdentityType

Tipo de identidad

Name Type 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.

Name Type 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.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

Estado de la base de datos.

Name Type 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.

Name Type Description
identity

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

Intercalación del catálogo de metadatos.

properties.collation
  • string

Intercalación de la base de datos.

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

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

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 (formato ISO8601).

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

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 expresado 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 la que la configuración o acción del usuario pausaron la base de datos (formato ISO8601). Null si la base de datos está lista.

properties.readScale

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

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 (formato ISO8601) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.resumedDate
  • string

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

properties.sampleName

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

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

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

Nombre y nivel de la SKU.

tags
  • object

Etiquetas del recurso.

DatabaseUserIdentity

Azure Active Directory configuración de identidad de un recurso.

Name Type Description
clientId
  • string

Identificador de cliente Azure Active Directory.

principalId
  • string

Identificador de Azure Active Directory entidad de seguridad.

SampleName

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

Name Type 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.

Name Type Description
Geo
  • string
Named
  • string

Sku

Una SKU de recursos de ARM.

Name Type 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.