Partilhar via


Databases - Pause

Coloca uma base de dados em pausa.

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

Parâmetros do URI

Name Em Necessário Tipo Description
databaseName
path True

string

O nome da base de dados a colocar em pausa.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

O ID da subscrição que identifica uma subscrição do Azure.

api-version
query True

string

A versão da API a utilizar para o pedido.

Respostas

Name Tipo Description
200 OK

Database

A base de dados foi colocada em pausa com êxito.

202 Accepted

A colocação em pausa da base de dados está em curso.

Other Status Codes

Respostas de Erro: ***

  • 400 CannotDeactivateWhenDeactivatingInProgress – O fluxo de trabalho de desativação falhou porque já existe um fluxo de trabalho desativado em execução.

  • 400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados.

  • 404 SourceDatabaseNotFound - A base de dados de origem não existe.

  • 500 ActivateOrDeactivateWorkflowThrottling – Falha na ativação ou no fluxo de trabalho de desativação porque existem demasiados fluxos de trabalho simultâneos

Exemplos

Pauses a database.

Pedido de amostra

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=2021-11-01

Resposta da amostra

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

Definições

Name Description
BackupStorageRedundancy

O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta base de dados.

CatalogCollationType

Agrupamento do catálogo de metadados.

CreateMode

Especifica o modo de criação da base de dados.

Predefinição: criação regular de bases de dados.

Copiar: cria uma base de dados como uma cópia de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados de origem.

Secundário: cria uma base de dados como uma réplica secundária de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados primária existente.

PointInTimeRestore: cria uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados existente e o restorePointInTime tem de ser especificado.

Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. sourceDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar.

Restauro: cria uma base de dados ao restaurar uma cópia de segurança de uma base de dados eliminada. sourceDatabaseId tem de ser especificado. Se sourceDatabaseId for o ID de recurso original da base de dados, tem de especificar sourceDatabaseDeletionDate. Caso contrário, sourceDatabaseId tem de ser o ID do recurso de base de dados removido recuperável e sourceDatabaseDeletionDate é ignorado. restorePointInTime também pode ser especificado para restaurar a partir de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria uma base de dados ao restaurar a partir de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId tem de ser especificado como o ID do recurso do ponto de recuperação.

Copy, Secondary e RestoreLongTermRetentionBackup não são suportados para a edição DataWarehouse.

Database

Um recurso de base de dados.

DatabaseIdentity

Configuração de identidade do Azure Active Directory para um recurso.

DatabaseIdentityType

O tipo de identidade

DatabaseLicenseType

O tipo de licença a aplicar a esta base de dados. LicenseIncludedse precisar de uma licença ou BasePrice se tiver uma licença e for elegível para o Benefício Híbrido do Azure.

DatabaseReadScale

O estado do encaminhamento só de leitura. Se estiver ativada, as ligações que tenham a intenção da aplicação definidas de forma só de leitura no respetivo cadeia de ligação podem ser encaminhadas para uma réplica só de leitura secundária na mesma região. Não aplicável a uma base de dados Hyperscale num conjunto elástico.

DatabaseStatus

O estado da base de dados.

DatabaseUserIdentity

Configuração de identidade do Azure Active Directory para um recurso.

SampleName

O nome do esquema de exemplo a aplicar ao criar esta base de dados.

SecondaryType

O tipo secundário da base de dados, se for secundário. Os valores válidos são Geo e Named.

Sku

Um SKU de Recurso do ARM.

BackupStorageRedundancy

O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta base de dados.

Name Tipo Description
Geo

string

GeoZone

string

Local

string

Zone

string

CatalogCollationType

Agrupamento do catálogo de metadados.

Name Tipo Description
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

CreateMode

Especifica o modo de criação da base de dados.

Predefinição: criação regular de bases de dados.

Copiar: cria uma base de dados como uma cópia de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados de origem.

Secundário: cria uma base de dados como uma réplica secundária de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados primária existente.

PointInTimeRestore: cria uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados existente e o restorePointInTime tem de ser especificado.

Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. sourceDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar.

Restauro: cria uma base de dados ao restaurar uma cópia de segurança de uma base de dados eliminada. sourceDatabaseId tem de ser especificado. Se sourceDatabaseId for o ID de recurso original da base de dados, tem de especificar sourceDatabaseDeletionDate. Caso contrário, sourceDatabaseId tem de ser o ID do recurso de base de dados removido recuperável e sourceDatabaseDeletionDate é ignorado. restorePointInTime também pode ser especificado para restaurar a partir de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria uma base de dados ao restaurar a partir de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId tem de ser especificado como o ID do recurso do ponto de recuperação.

Copy, Secondary e RestoreLongTermRetentionBackup não são suportados para a edição DataWarehouse.

Name Tipo Description
Copy

string

Default

string

OnlineSecondary

string

PointInTimeRestore

string

Recovery

string

Restore

string

RestoreExternalBackup

string

RestoreExternalBackupSecondary

string

RestoreLongTermRetentionBackup

string

Secondary

string

Database

Um recurso de base de dados.

Name Tipo Description
id

string

ID do Recurso.

identity

DatabaseIdentity

A identidade do Azure Active Directory da base de dados.

kind

string

Tipo de base de dados. Estes são os metadados utilizados para a experiência de portal do Azure.

location

string

Localização do recurso.

managedBy

string

Recurso que gere a base de dados.

name

string

Nome do recurso.

properties.autoPauseDelay

integer

Tempo em minutos após o qual a base de dados é colocada em pausa automaticamente. Um valor de -1 significa que a pausa automática está desativada

properties.catalogCollation

CatalogCollationType

Agrupamento do catálogo de metadados.

properties.collation

string

O agrupamento da base de dados.

properties.createMode

CreateMode

Especifica o modo de criação da base de dados.

Predefinição: criação regular de bases de dados.

Copiar: cria uma base de dados como uma cópia de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados de origem.

Secundário: cria uma base de dados como uma réplica secundária de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados primária existente.

PointInTimeRestore: cria uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados existente e o restorePointInTime tem de ser especificado.

Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. sourceDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar.

Restauro: cria uma base de dados ao restaurar uma cópia de segurança de uma base de dados eliminada. sourceDatabaseId tem de ser especificado. Se sourceDatabaseId for o ID de recurso original da base de dados, tem de especificar sourceDatabaseDeletionDate. Caso contrário, sourceDatabaseId tem de ser o ID do recurso de base de dados removido restabelecido e sourceDatabaseDeletionDate é ignorado. restorePointInTime também pode ser especificado para restaurar a partir de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria uma base de dados ao restaurar a partir de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId tem de ser especificado como o ID de recurso do ponto de recuperação.

Copy, Secondary e RestoreLongTermRetentionBackup não são suportados para a edição DataWarehouse.

properties.creationDate

string

A data de criação da base de dados (formato ISO8601).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta base de dados.

properties.currentServiceObjectiveName

string

O nome do objetivo de nível de serviço atual da base de dados.

properties.currentSku

Sku

O nome e a camada do SKU.

properties.databaseId

string

O ID da base de dados.

properties.defaultSecondaryLocation

string

A região secundária predefinida para esta base de dados.

properties.earliestRestoreDate

string

Isto regista a data e hora de início mais antigas que o restauro está disponível para esta base de dados (ISO8601 formato).

properties.elasticPoolId

string

O identificador de recurso do conjunto elástico que contém esta base de dados.

properties.failoverGroupId

string

Identificador de recurso do Grupo de Ativação Pós-falha ao qual esta base de dados pertence.

properties.federatedClientId

string

O ID de cliente utilizado para o cenário de CMK entre inquilinos por base de dados

properties.highAvailabilityReplicaCount

integer

O número de réplicas secundárias associadas à base de dados que são utilizadas para fornecer elevada disponibilidade. Não aplicável a uma base de dados Hyperscale num conjunto elástico.

properties.isInfraEncryptionEnabled

boolean

A encriptação de infraestrutura está ativada para esta base de dados.

properties.isLedgerOn

boolean

Se esta base de dados é ou não uma base de dados de livros razão, o que significa que todas as tabelas na base de dados são tabelas de livros razão. Nota: o valor desta propriedade não pode ser alterado após a criação da base de dados.

properties.licenseType

DatabaseLicenseType

O tipo de licença a aplicar a esta base de dados. LicenseIncludedse precisar de uma licença ou BasePrice se tiver uma licença e for elegível para o Benefício Híbrido do Azure.

properties.longTermRetentionBackupResourceId

string

O identificador de recursos da cópia de segurança de retenção de longo prazo associada à operação de criação desta base de dados.

properties.maintenanceConfigurationId

string

ID de configuração de manutenção atribuído à base de dados. Esta configuração define o período em que as atualizações de manutenção irão ocorrer.

properties.maxLogSizeBytes

integer

O tamanho máximo do registo para esta base de dados.

properties.maxSizeBytes

integer

O tamanho máximo da base de dados expresso em bytes.

properties.minCapacity

number

Capacidade mínima que a base de dados terá sempre alocada, se não estiver em pausa

properties.pausedDate

string

A data em que a base de dados foi colocada em pausa pela configuração ou ação do utilizador (formato ISO8601). Nulo se a base de dados estiver pronta.

properties.readScale

DatabaseReadScale

O estado do encaminhamento só de leitura. Se estiver ativada, as ligações que tenham a intenção de aplicação definida como só de leitura nos respetivos cadeia de ligação podem ser encaminhadas para uma réplica só de leitura secundária na mesma região. Não aplicável a uma base de dados Hyperscale num conjunto elástico.

properties.recoverableDatabaseId

string

O identificador de recursos da base de dados recuperável associada à operação de criação desta base de dados.

properties.recoveryServicesRecoveryPointId

string

O identificador do recurso do ponto de recuperação associado à operação de criação desta base de dados.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento a utilizar para armazenar cópias de segurança para esta base de dados.

properties.requestedServiceObjectiveName

string

O nome do objetivo de nível de serviço pedido da base de dados.

properties.restorableDroppedDatabaseId

string

O identificador de recursos da base de dados removida restabelecida associada à operação de criação desta base de dados.

properties.restorePointInTime

string

Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados.

properties.resumedDate

string

A data em que a base de dados foi retomada pela ação do utilizador ou pelo início de sessão da base de dados (ISO8601 formato). Nulo se a base de dados estiver em pausa.

properties.sampleName

SampleName

O nome do esquema de exemplo a aplicar ao criar esta base de dados.

properties.secondaryType

SecondaryType

O tipo secundário da base de dados, se for secundária. Os valores válidos são Geo e Named.

properties.sourceDatabaseDeletionDate

string

Especifica a hora em que a base de dados foi eliminada.

properties.sourceDatabaseId

string

O identificador de recursos da base de dados de origem associada à operação de criação desta base de dados.

properties.sourceResourceId

string

O identificador de recurso da origem associada à operação de criação desta base de dados.

Esta propriedade só é suportada para a edição DataWarehouse e permite restaurar entre subscrições.

Quando sourceResourceId é especificado, sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId e sourceDatabaseDeletionDate não devem ser especificados e CreateMode tem de ser PointInTimeRestore, Restore ou Recover.

Quando createMode é PointInTimeRestore, sourceResourceId tem de ser o ID de recurso da base de dados existente ou do conjunto de sql existente e o restorePointInTime tem de ser especificado.

Quando createMode é Restaurar, sourceResourceId tem de ser o ID de recurso da base de dados removida restabelecida ou do conjunto de sql removido restauráveis.

Quando createMode é Recuperar, sourceResourceId tem de ser o ID de recurso da base de dados recuperável ou do conjunto de sql recuperável.

Quando a subscrição de origem pertence a um inquilino diferente da subscrição de destino, o cabeçalho "x-ms-authorization-auxiliary" tem de conter o token de autenticação para o inquilino de origem. Para obter mais detalhes sobre o cabeçalho "x-ms-authorization-auxiliary", veja https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.status

DatabaseStatus

O estado da base de dados.

properties.zoneRedundant

boolean

Se esta base de dados tem ou não redundância entre zonas, o que significa que as réplicas desta base de dados serão distribuídas por várias zonas de disponibilidade.

sku

Sku

O SKU da base de dados.

A lista de SKUs pode variar consoante a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome do SKU, escalão/edição, família e capacidade) que estão disponíveis para a sua subscrição numa região do Azure, utilize a Capabilities_ListByLocation API REST ou um dos seguintes comandos:

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

object

Etiquetas de recursos.

type

string

Tipo de recurso.

DatabaseIdentity

Configuração de identidade do Azure Active Directory para um recurso.

Name Tipo Description
tenantId

string

O ID de inquilino do Azure Active Directory.

type

DatabaseIdentityType

O tipo de identidade

userAssignedIdentities

<string,  DatabaseUserIdentity>

Os IDs de recursos das identidades atribuídas pelo utilizador a utilizar

DatabaseIdentityType

O tipo de identidade

Name Tipo Description
None

string

UserAssigned

string

DatabaseLicenseType

O tipo de licença a aplicar a esta base de dados. LicenseIncludedse precisar de uma licença ou BasePrice se tiver uma licença e for elegível para o Benefício Híbrido do Azure.

Name Tipo Description
BasePrice

string

LicenseIncluded

string

DatabaseReadScale

O estado do encaminhamento só de leitura. Se estiver ativada, as ligações que tenham a intenção da aplicação definidas de forma só de leitura no respetivo cadeia de ligação podem ser encaminhadas para uma réplica só de leitura secundária na mesma região. Não aplicável a uma base de dados Hyperscale num conjunto elástico.

Name Tipo Description
Disabled

string

Enabled

string

DatabaseStatus

O estado da base de dados.

Name 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

DatabaseUserIdentity

Configuração de identidade do Azure Active Directory para um recurso.

Name Tipo Description
clientId

string

O ID de cliente do Azure Active Directory.

principalId

string

O ID principal do Azure Active Directory.

SampleName

O nome do esquema de exemplo a aplicar ao criar esta base de dados.

Name Tipo Description
AdventureWorksLT

string

WideWorldImportersFull

string

WideWorldImportersStd

string

SecondaryType

O tipo secundário da base de dados, se for secundário. Os valores válidos são Geo e Named.

Name Tipo Description
Geo

string

Named

string

Sku

Um SKU de Recurso do ARM.

Name Tipo Description
capacity

integer

Capacidade do SKU específico.

family

string

Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.

name

string

O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3.

size

string

Tamanho do SKU específico

tier

string

O escalão ou edição do SKU específico, por exemplo, Básico, Premium.