Databases - legacy - Pause

Referencia

Servicio:: SQL Database

Versión de la API:: 2020-11-01-preview

Pausa una base de datos.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/pause?api-version=2020-11-01-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
databaseName	path	True	string	Nombre de la base de datos que se va a pausar.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
serverName	path	True	string	Nombre del servidor.
subscriptionId	path	True	string	Identificador de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	Versión de la API que se va a usar para la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	Database	Se ha pausado correctamente la base de datos.
202 Accepted		Pausar la base de datos está en curso.
Other Status Codes		Respuestas de error: *** 400 CannotDeactivateWhenDeactivatingInProgress: error en el flujo de trabajo de desactivación porque ya se está ejecutando un flujo de trabajo de desactivación. 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos. 404 SourceDatabaseNotFound: la base de datos de origen no existe. 500 ActivateOrDeactivateWorkflowThrottling: error en el flujo de trabajo de activación o desactivación porque hay demasiados flujos de trabajo simultáneos

Nombre

Tipo

Description

200 OK

Database

Se ha pausado correctamente la base de datos.

202 Accepted

Pausar la base de datos está en curso.

Other Status Codes

Respuestas de error: ***

400 CannotDeactivateWhenDeactivatingInProgress: error en el flujo de trabajo de desactivación porque ya se está ejecutando un flujo de trabajo de desactivación.
400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos.
404 SourceDatabaseNotFound: la base de datos de origen no existe.
500 ActivateOrDeactivateWorkflowThrottling: error en el flujo de trabajo de activación o desactivación porque hay demasiados flujos de trabajo simultáneos

Ejemplos

Pauses a database.

Solicitud de ejemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdwdb/pause?api-version=2020-11-01-preview

Respuesta de muestra

status code:: 200

{
  "sku": {
    "name": "DataWarehouse"
  },
  "kind": "v12.0,user,datawarehouse",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 10995116277760,
    "status": "Paused",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-07-13T02:04:26.187Z",
    "currentServiceObjectiveName": "D1",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdwdb",
  "name": "testdwdb",
  "type": "Microsoft.Sql/servers/databases"
}

status code:: 202

Definiciones

Nombre	Description
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 descartable 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.
CurrentBackupStorageRedundancy	Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.
Database	Un recurso de base de datos.
DatabaseLicenseType	Tipo de licencia que se va a solicitar para esta base de datos. `LicenseIncluded` si 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 su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región.
DatabaseStatus	Estado de la base de datos.
RequestedBackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta base de datos.
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.

CatalogCollationType

Enumeración

Intercalación del catálogo de metadatos.

Valor	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

CreateMode

Enumeración

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

Valor	Description
Copy
Default
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
Secondary

CurrentBackupStorageRedundancy

Enumeración

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

Valor	Description
Geo
Local
Zone

Database

Object

Un recurso de base de datos.

Nombre	Tipo	Description
id	string	Identificador de recurso.
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 (int32)	Hora en minutos después de la 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 descartable 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 (date-time)	Fecha de creación de la base de datos (formato ISO8601).
properties.currentBackupStorageRedundancy	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	Sku	Nombre y nivel de la SKU.
properties.databaseId	string (uuid)	Identificador de la base de datos.
properties.defaultSecondaryLocation	string	Región secundaria predeterminada para esta base de datos.
properties.earliestRestoreDate	string (date-time)	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.highAvailabilityReplicaCount	integer (int32)	Número de réplicas secundarias asociadas a la base de datos que se usan para proporcionar alta disponibilidad.
properties.licenseType	DatabaseLicenseType	Tipo de licencia que se va a solicitar para esta base de datos. `LicenseIncluded` si 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 (int64)	Tamaño máximo del registro de esta base de datos.
properties.maxSizeBytes	integer (int64)	Tamaño máximo de la base de datos expresada en bytes.
properties.minCapacity	number (double)	Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa
properties.pausedDate	string (date-time)	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 su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región.
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	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 que se puede restaurar asociada a la operación de creación de esta base de datos.
properties.restorePointInTime	string (date-time)	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 (date-time)	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 (date-time)	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 es con 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 API REST de `Capabilities_ListByLocation` o uno de los siguientes comandos: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

DatabaseLicenseType

Enumeración

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

Valor	Description
BasePrice
LicenseIncluded

DatabaseReadScale

Enumeración

Estado del enrutamiento de solo lectura. Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura en la misma región.

Valor	Description
Disabled
Enabled

DatabaseStatus

Enumeración

Estado de la base de datos.

Valor	Description
AutoClosed
Copying
Creating
Disabled
EmergencyMode
Inaccessible
Offline
OfflineChangingDwPerformanceTiers
OfflineSecondary
Online
OnlineChangingDwPerformanceTiers
Paused
Pausing
Recovering
RecoveryPending
Restoring
Resuming
Scaling
Shutdown
Standby
Suspect

RequestedBackupStorageRedundancy

Enumeración

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

Valor	Description
Geo
Local
Zone

SampleName

Enumeración

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

Valor	Description
AdventureWorksLT
WideWorldImportersFull
WideWorldImportersStd

SecondaryType

Enumeración

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

Valor	Description
Geo
Named

Sku

Object

Una SKU de recursos de ARM.

Nombre	Tipo	Description
capacity	integer (int32)	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 de número, 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.

Compartir a través de

Databases - legacy - Pause

Parámetros de identificador URI

Respuestas

Ejemplos

Pauses a database.

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CatalogCollationType

CreateMode

CurrentBackupStorageRedundancy

Database

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

RequestedBackupStorageRedundancy

SampleName

SecondaryType

Sku