Compartilhar via


Databases - Update

Atualiza um banco de dados existente.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
databaseName
path True

string

O nome do banco de dados.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome Tipo Description
identity

DatabaseIdentity

Identidade do banco de dados

properties.autoPauseDelay

integer

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

properties.catalogCollation

CatalogCollationType

Ordenação do catálogo de metadados.

properties.collation

string

A ordenação do banco de dados.

properties.createMode

CreateMode

Especifica o modo de criação do banco de dados.

Padrão: criação regular de banco de dados.

Copiar: cria um banco de dados como uma cópia de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados de origem.

Secundário: cria um banco de dados como um réplica secundário de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados primário existente.

PointInTimeRestore: cria um banco de dados restaurando um backup pontual de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados existente e restorePointInTime deve ser especificado.

Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. sourceDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável a ser restaurada.

Restauração: cria um banco de dados restaurando um backup de um banco de dados excluído. sourceDatabaseId deve ser especificado. Se sourceDatabaseId for a ID de recurso original do banco de dados, sourceDatabaseDeletionDate deverá ser especificado. Caso contrário, sourceDatabaseId deve ser a ID do recurso de banco de dados descartado restaurável e sourceDatabaseDeletionDate será ignorado. restorePointInTime também pode ser especificado para restaurar de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria um banco de dados restaurando de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId deve ser especificado como a ID do recurso do ponto de recuperação.

Não há suporte para Copy, Secondary e RestoreLongTermRetentionBackup na edição DataWarehouse.

properties.elasticPoolId

string

O identificador de recurso do pool elástico que contém esse banco de dados.

properties.federatedClientId

string

A ID do cliente usada para o cenário de CMK entre locatários por banco de dados

properties.highAvailabilityReplicaCount

integer

O número de réplicas secundárias associadas ao banco de dados que são usadas para fornecer alta disponibilidade. Não aplicável a um banco de dados de Hiperescala em um pool elástico.

properties.isLedgerOn

boolean

Se esse banco de dados é ou não um banco de dados do razão, o que significa que todas as tabelas no banco de dados são tabelas do razão. Observação: o valor dessa propriedade não pode ser alterado após a criação do banco de dados.

properties.licenseType

DatabaseLicenseType

O tipo de licença a ser aplicado a esse banco de dados. LicenseIncludedse você precisar de uma licença ou BasePrice se tiver uma licença e estiver qualificado para o Benefício Híbrido do Azure.

properties.longTermRetentionBackupResourceId

string

O identificador de recurso do backup de retenção de longo prazo associado à operação de criação desse banco de dados.

properties.maintenanceConfigurationId

string

ID de configuração de manutenção atribuída ao banco de dados. Essa configuração define o período em que as atualizações de manutenção ocorrerão.

properties.maxSizeBytes

integer

O tamanho máximo do banco de dados expresso em bytes.

properties.minCapacity

number

Capacidade mínima que o banco de dados sempre terá alocado, se não estiver em pausa

properties.readScale

DatabaseReadScale

O estado do roteamento somente leitura. Se habilitadas, as conexões que têm a intenção do aplicativo definida como somente leitura em seus cadeia de conexão podem ser roteadas para um réplica secundário somente leitura na mesma região. Não aplicável a um banco de dados de Hiperescala em um pool elástico.

properties.recoverableDatabaseId

string

O identificador de recurso do banco de dados recuperável associado à operação de criação desse banco de dados.

properties.recoveryServicesRecoveryPointId

string

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

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento a ser usado para armazenar backups para esse banco de dados.

properties.restorableDroppedDatabaseId

string

O identificador de recurso do banco de dados descartado restaurável associado à operação de criação desse banco de dados.

properties.restorePointInTime

string

Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados.

properties.sampleName

SampleName

O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados.

properties.secondaryType

SecondaryType

O tipo secundário do banco de dados se ele for um secundário. Os valores válidos são Geo e Named.

properties.sourceDatabaseDeletionDate

string

Especifica a hora em que o banco de dados foi excluído.

properties.sourceDatabaseId

string

O identificador de recurso do banco de dados de origem associado à operação de criação desse banco de dados.

properties.zoneRedundant

boolean

Se esse banco de dados tem ou não redundância de zona, o que significa que as réplicas desse banco de dados serão distribuídas entre várias zonas de disponibilidade.

sku

Sku

O nome e a camada do SKU.

tags

object

Marcas de recurso.

Respostas

Nome Tipo Description
200 OK

Database

O banco de dados foi atualizado com êxito.

202 Accepted

A atualização do banco de dados está em andamento.

Other Status Codes

Respostas de erro: ***

  • 400 InvalidDatabaseCreateOrUpdateRequest – o corpo da solicitação para a operação de criação ou atualização de banco de dados é inválido.

  • 400 InvalidResourceId - Identificador de recurso inválido.

  • 400 InvalidSourceDatabaseId - Identificador de banco de dados de origem inválido.

  • 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondeu ao nome na URL.

  • 400 MismatchingServerNameWithUrl - O nome do servidor fornecido não correspondeu ao nome na URL.

  • 400 MismatchingSubscriptionWithUrl - A assinatura fornecida não correspondeu à assinatura na URL.

  • 400 MissingCollation – Ordenação é necessária.

  • 400 MissingMaxSizeBytes – MaxSizeBytes é necessário.

  • 400 MissingSkuName – O nome da SKU é necessário.

  • 400 MissingSourceDatabaseId - Identificador de banco de dados de origem ausente.

  • 400 InvalidLicenseType - O tipo de licença especificado é inválido.

  • 400 InvalidSkuName - Nome de SKU inválido.

  • 400 MismatchedSkuNameAndCapacity – incompatibilidade entre o nome da SKU e a capacidade.

  • 400 MismatchedSkuNameAndTier - Incompatibilidade entre o nome e a camada do SKU.

  • 400 MismatchedSkuNameAndFamily - Incompatibilidade entre o nome da SKU e a família.

  • 400 LedgerNotAllowedWithSpecifiedCreateMode - IsLedgerOn não é permitido com o modo de criação especificado.

  • 400 LedgerNotAllowedOnSampleDatabase - A criação de banco de dados não é permitida com IsLedgerOn para um banco de dados de exemplo.

  • 400 DatabaseNameDoesNotMatchSourceDatabaseId - O nome do banco de dados especificado não corresponde ao nome do banco de dados em sourceDatabaseId.

  • 400 ElasticPoolNotSupportedForExternalBackupRestore – Não há suporte para o pool elástico para restauração de backup externo

  • 400 InvalidRecoverableDatabaseId - Identificador de banco de dados recuperável inválido.

  • 400 InvalidRecoveryServicesRecoveryPointId - Identificador de ponto de recuperação inválido dos serviços de recuperação.

  • 400 InvalidRestorableDroppedDatabaseDeletionDate - A data de exclusão do banco de dados descartada restaurável fornecida é inválida

  • 400 InvalidRestorableDroppedDatabaseId - Identificador de banco de dados descartado restaurável inválido

  • 400 MissingRecoverableDatabaseId - Identificador de banco de dados recuperável ausente.

  • 400 MissingRecoveryServicesRecoveryPointId – ID do ponto de recuperação dos serviços de recuperação ausente.

  • 400 MissingRestorableDroppedDatabaseId - Missing restorableDroppedDatabaseId

  • 400 MissingRestorePointInTime - Ponto de restauração ausente no tempo

  • 400 MissingSourceDatabaseDeletionDate - Data de exclusão do banco de dados de origem ausente

  • 400 MissingStorageContainerSasToken - Token SAS do contêiner de armazenamento ausente

  • 400 MissingStorageContainerUri – URI do contêiner de armazenamento ausente

  • 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - Não é possível especificar restorableDroppedDatabaseId quando sourceDatabaseId já é dado no modo de criação de restauração

  • 400 MultipleIdentitiesOnDatabase – há suporte apenas para uma identidade gerenciada atribuída pelo usuário no nível do banco de dados.

  • 400 MultipleIdentityDelegationsOnDatabase – há suporte apenas para uma delegação de identidade no nível do banco de dados.

  • 400 MissingPrimaryDelegatedIdentityClientId - Para usar identidades delegadas, forneça uma ID de cliente de identidade delegada primária.

  • 400 LongTermRetentionMigrationRequestNotSupported - A assinatura não tem permissão para recurso de migração de backup ltr.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - As assinaturas de origem e destino não têm permissão para se comunicar para o recurso de cópia de backup LTR.

  • 400 LongTermRetentionMigrationParameterMissing – parâmetro obrigatório ausente para a operação.

  • 400 LongTermRetentionMigrationSameServerNotSupported - Não há suporte para o recurso de cópia LTR para copiar backups LTR no mesmo servidor.

  • 400 LongTermRetentionMigrationTargetServerNotFound - O servidor de destino não existe ou não está pronto para a operação de cópia de backup LTR.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound - O banco de dados de destino não existe no servidor.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported – Não há suporte para redundância de armazenamento de backup especificada na região de destino.

  • 400 LongTermRetentionMigrationStorageMismatch – A redundância de backup ativa do banco de dados não corresponde à redundância de backup solicitada pelo cliente.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported - A migração ltr só tem suporte para instância gerenciada e backups ltr do SQL do Azure DB.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - A alteração da redundância de armazenamento de backup não é permitida para operações de Cópia LTR.

  • 400 LongTermRetentionMigrationSubscriptionNotFound - Não foi possível encontrar a assinatura.

  • 400 InvalidStandbyGeoReadScale - O usuário tentou habilitar a escala de leitura em um banco de dados geográfico em espera que não dá suporte a ele.

  • 400 PerDatabaseCMKKeyRotationAttemptedWhileOldThumbprintInUse - A rotação de chaves para o Protetor de TDE no nível do banco de dados é bloqueada quando transações ativas estão mantendo o log criptografado com chaves antigas. Consulte aka.ms/azuresqldbkeyrotation para obter possíveis estratégias para solucionar esse problema.

  • 400 TierChangeUnsupportedDueToMemoryOptimizedObject – O banco de dados não pode atualizar sua sku porque tem objetos com otimização de memória.

  • 400 PerDBCMKNotSupportedWithLTR – O CMK no nível do banco de dados não tem suporte quando a Retenção de Backup de Longo Prazo está habilitada no banco de dados.

  • 400 SourceServerNotFound - A parte do servidor de uma ID de banco de dados de origem fornecida em uma chamada à API CreateDatabaseAsCopy não é mapeada para um servidor existente.

  • 400 ElasticPoolOverStorageUsage – Tentativa de gravar dados em um banco de dados quando o limite de armazenamento do pool elástico for atingido.

  • 400 InvalidDatabaseCreateMode – solicitação inválida para criar um banco de dados.

  • 400 MissingAsymmetricKeyOnTargetServer – O servidor de destino não tem acesso a uma chave assimétrica.

  • 400 MismatchingSubscriptionWithUrl – A assinatura fornecida não correspondeu à assinatura na URL.

  • 400 MultipleDroppedDatabasesWithTheSameName – foram encontrados vários bancos de dados descartados com o mesmo nome no servidor.

  • 400 InvalidAddSecondaryPermission – O usuário não tem permissão suficiente para adicionar o secundário no servidor especificado.

  • 400 AzureKeyVaultClientError – O cliente Key Vault do Azure encontrou um erro.

  • 400 UnsupportedServiceName - O nome especificado é um nome inválido porque contém um ou mais caracteres unicode sem suporte.

  • 400 AzureKeyVaultClientInfoError – Ocorreu um erro ao obter informações para o cliente Key Vault do Azure.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize – o usuário tentou alterar o banco de dados para um sku com tamanho máximo de log menor do que o uso atual.

  • 400 IsLedgerDatabaseIsNotSupportedOnResourceType – não há suporte para alterar a propriedade do razão para esse tipo de recurso.

  • 400 InvalidBackupStorageAccountType - O usuário passou zrs/lrs durante a criação/atualização de um banco de dados, mas falhou porque o cliente não está na lista de permissões ou porque os zrs não estão disponíveis na região especificada.

  • 400 CannotUpdateToFreeDatabase – Não há suporte para atualizar um banco de dados para a sku gratuita.

  • 400 DatabaseInvalidSkuPropertyCombination – as propriedades do sku solicitado são inconsistentes. Marcar que uma combinação válida seja especificada. Consulte https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability para obter mais detalhes.

  • 400 DatabaseNamedReplicaPerDatabaseLimitExceeded – o usuário tentou criar um réplica nomeado que excederia o número permitido por banco de dados primário

  • 400 UnsupportedBackupStorageRedundancyForEdition – A redundância de armazenamento de backup solicitada não tem suporte para edição

  • 400 DatabaseIsCurrentlyPinned – a Microsoft fixou seu banco de dados SQL Server versão do mecanismo. Para garantir que o banco de dados não atinja problemas de produção, quaisquer operações de escala futuras em seu banco de dados serão bloqueadas até que ele não seja fixado. Entre em contato com o suporte da Microsoft para obter assistência com o dimensionamento.

  • 400 RestoreTargetEditionSizeInsufficient – o usuário tentou restaurar um banco de dados para uma edição que tem um tamanho menor do que o tamanho alocado atual da origem.

  • 400 InvalidSku – o usuário especificou um sku inválido.

  • 400 InvalidTierSkuCombination – a camada especificada não dá suporte ao sku especificado.

  • 400 ServerNotFound – O servidor solicitado não foi encontrado.

  • 400 UnsupportedBackupStorageRedundancy – Não há suporte para redundância de armazenamento de backup especificada na região de destino.

  • 400 InvalidIdentityId – Uma ou mais IDs de identidade fornecidas não são IDs de recurso do ARM válidas. Insira ids válidas e tente novamente.

  • 400 LTRSterlingToVldbMigrationNotSupported – Não é possível alterar o objetivo de serviço do banco de dados para a Hiperescala, pois a retenção de longo prazo ainda não tem suporte na Hiperescala. Desabilite a retenção de longo prazo no banco de dados e tente novamente.

  • 400 TokenTooLong - O token fornecido é muito longo.

  • 400 FeatureDisabledOnSelectedEdition – o usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados.

  • 400 OfferDisabledOnSubscription – O tipo de oferta de assinatura é impedido de provisionar o recurso solicitado.

  • 400 UnableToCreateGeoChain – O usuário tentou criar um banco de dados secundário (encadeamento), embora o carregamento automático de resumos do razão tenha sido configurado

  • 400 InvalidNumberOfIdentities – apenas uma identidade gerenciada atribuída pelo usuário tem suporte no nível do banco de dados.

  • 400 DatabaseNamedReplicaChainingNotAllowed – o usuário tentou criar um réplica nomeado de um réplica nomeado que não é permitido.

  • 400 DatabaseNamedReplicaInvalidOperation - O usuário tentou uma operação sem suporte em um réplica nomeado.

  • 400 DatabaseNamedReplicaInvalidSourceDatabase – o usuário tentou criar um réplica nomeado em uma assinatura ou região diferente do banco de dados de origem.

  • 400 InvalidTargetSubregion – O servidor de destino de um secundário não legível não está em uma região do Azure emparelhada com DR.

  • 400 CannotAssignIdentityToMaster – Não é possível atribuir uma identidade a um banco de dados do sistema. A identidade do banco de dados não pode ser atribuída a bancos de dados 'master', 'model', 'tempdb', 'msdb' ou 'resource'.

  • 400 PerDatabaseCMKDWNotSupported – O CMK no nível do banco de dados na versão prévia não tem suporte para a edição datawarehouse.

  • 400 DatabaseCreationBlockedForNonActivatedCMKServer – as criações do Pool de SQL são bloqueadas para workspaces habilitados para CMK até que o workspace seja ativado. Primeiro, habilite a proteção contra limpeza e conceda à Identidade Gerenciada do workspace as permissões necessárias (Get, Wrap Key, Unwrap Key) no Key Vault do Azure da chave do workspace. Em seguida, ative o workspace depois de conceder acesso.

  • 400 PartnerServerNotCompatible – O usuário está tentando copiar um banco de dados de um servidor SAWA V1 para um servidor Sterling ou vice-versa.

  • 400 IncorrectReplicationLinkState - A operação espera que o banco de dados esteja em um estado esperado no link de replicação.

  • 400 TargetElasticPoolDoesNotExist – o pool elástico não existe em um servidor.

  • 400 ElasticPoolSkuCombinationInvalid – O pool elástico e o sku só poderão ser especificados juntos se o sku for especificado como 'ElasticPool'.

  • 400 ElasticPoolTierCombinationInvalid – a camada de banco de dados é diferente da camada de serviço do pool elástico.

  • 400 ElasticPoolNameRequired – o usuário tentou criar ou atualizar o banco de dados para o objetivo do serviço de pool elástico sem especificar o nome do pool elástico.

  • 400 MissingThumbprintCrm - A operação de restauração de um banco de dados CRM falhou porque um certificado TDE necessário estava ausente. Tente novamente a operação de restauração para um pool elástico existente.

  • 400 ElasticPoolOverStorage – Tentativa de gravar dados em um banco de dados quando o limite de armazenamento do pool elástico for atingido.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings – Tentando fornecer DTU min para bancos de dados no pool elástico que excede as DTUs solicitadas do pool elástico.

  • 400 RestoreTargetEditionSizeInsufficientV2 – o usuário tentou restaurar um banco de dados para uma edição que tem um tamanho menor do que o tamanho alocado do banco de dados restaurado.

  • 400 TierChangeUnsupportedDueToCDCEnabledDatabase - O banco de dados não pode atualizar seu sku porque está habilitado para CDC.

  • 400 ElasticPoolDatabaseCountOverLimit – Tentativa de criar ou adicionar banco de dados ao pool elástico quando o limite de contagem de banco de dados do pool elástico for atingido.

  • 400 ResourcePoolStorageLimitHitDuringRestore – O banco de dados restaurado não pode ser restaurado no pool de recursos devido à capacidade de armazenamento restante no pool.

  • 400 CannotChangeToOrFromDataWarehouseTier - O usuário tentou alterar o sku de um banco de dados da camada DataWarehouse para camadas não DataWarehouse ou vice-versa.

  • 400 CurrentDatabaseSizeExceedsMaxSize – o usuário tentou reduzir o tamanho máximo de um banco de dados para um tamanho menor que o uso atual.

  • 400 PerDatabaseCMKRestoreNotSupported – A restauração do banco de dados não tem suporte quando o CMK no nível do banco de dados é configurado na versão prévia.

  • 400 PerDatabaseCMKHSNotSupported – O CMK no nível do banco de dados na versão prévia não tem suporte para a edição Hiperescala.

  • 400 AzureKeyVaultKeyDisabled - A operação não pôde ser concluída no servidor porque a chave de Key Vault do Azure está desabilitada.

  • 400 PerDatabaseCMKGeoReplicationNotSupported – Não há suporte para Replicação Geográfica e Cópia de Banco de Dados quando o CMK no nível do banco de dados é configurado na versão prévia.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage – tentando diminuir o limite de armazenamento do pool elástico abaixo de seu uso de armazenamento.

  • 400 AzureKeyVaultInvalidExpirationDate - A operação não pôde ser concluída porque a data de validade da chave Key Vault do Azure é inválida.

  • 400 InvalidStandbyGeoEdition – O usuário tentou criar uma área geográfica em espera baseada em DTU.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – A operação não pôde ser concluída porque o Uri de Key Vault do Azure é nulo ou vazio.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings – o número de bancos de dados e VCore min por banco de dados não pode exceder VCores solicitados do pool elástico.

  • 400 UpdateNotAllowedOnPausedDatabase – O usuário tentou executar uma atualização em um banco de dados em pausa.

  • 400 GeoRestoreBackupStorageTypeNotSupported – As solicitações de recuperação de banco de dados são inválidas quando emitidas em um banco de dados que não está configurado para usar o armazenamento de backup com redundância geográfica.

  • 400 RestoreHyperscaleToNonHyperscale – Não há suporte para restaurar um backup de banco de dados de Hiperescala para uma camada de serviço não hiperescala ou vice-versa.

  • 400 SubscriptionDoesNotHaveAccessToServer – A assinatura não tem acesso aos servidores especificados

  • 400 RecoveryPointDoesNotExist – o ponto de recuperação especificado não existe ou não é válido.

  • 400 AzureKeyVaultNoServerIdentity – A identidade do servidor não está configurada corretamente.

  • 400 InvalidMaxSizeTierCombination – a camada especificada não dá suporte ao tamanho máximo do banco de dados especificado.

  • 400 LtrBackupNotFound – O backup de retenção de longo prazo especificado não existe.

  • 400 AzureKeyVaultInvalidUri – uma resposta inválida do Azure Key Vault. Use um URI de Key Vault do Azure válido.

  • 400 InvalidPointInTime - O ponto no tempo especificado não é válido para o banco de dados.

  • 400 AzureKeyVaultMissingPermissions – o servidor não tem as permissões necessárias no Key Vault do Azure.

  • 400 GeoRestoreCannotResolveTargetCluster - Não é possível resolve cluster de destino para o servidor

  • 400 InvalidReadScaleEdition – o usuário tentou habilitar a escala de leitura em um tipo de banco de dados que não dá suporte a ele.

  • 400 CannotSpecifyEditionOrSloWhenRestoringToPool – Não há suporte para especificar o objetivo ou a edição de nível de serviço de destino ao restaurar para um pool elástico.

  • 400 InvalidReadScaleUnits - O usuário tentou fornecer um valor de escala de leitura sem suporte.

  • 400 RestoreNotSupportedForGeoDrSecondary – As operações de restauração pontual e recuperação de banco de dados não têm suporte em bancos de dados atualmente configurados como secundários geográficos.

  • 400 SecurityAzureKeyVaultInvalidKeyName - A operação não pôde ser concluída devido a um nome de chave de servidor inválido.

  • 400 RegionDoesNotSupportVersion – Um usuário tentou criar um servidor de uma versão especificada em um local em que não há suporte para essa versão do servidor.

  • 400 GeoSecondaryMaxSizeUpdateFailed – O banco de dados geográfico secundário é de um SLO que não dá suporte ao valor de maxsize solicitado ou o secundário geográfico está em uma região sem suporte ou uma operação de atualização já está em andamento no banco de dados geo secundário.

  • 400 AdalGenericError - A operação não pôde ser concluída porque um erro do Azure Active Directory foi encontrado.

  • 400 AdalServicePrincipalNotFound - A operação não pôde ser concluída porque uma entidade de serviço não encontrada na biblioteca do Azure Active Directory foi encontrada.

  • 400 InvalidTier - O usuário especificou uma camada inválida.

  • 400 AzureKeyVaultMalformedVaultUri – o uri de Key Vault fornecido não é válido.

  • 400 CannotUseReservedDatabaseName – Não é possível usar o nome do banco de dados reservado nesta operação.

  • 400 RequestedDatabaseSizeRequiresShrink - O usuário tentou ALTERAR O BANCO DE DADOS MODIFIQUE MAXSIZE para modificar o MAXSIZE de um banco de dados para um tamanho menor e, em seguida, o tamanho atual.

  • 400 CurrentDatabaseSizeExceedsDbMaxSize - O usuário tentou reduzir o tamanho máximo de um banco de dados para um tamanho menor que o uso atual.

  • 400 InvalidServerName - Nome do servidor inválido especificado.

  • 400 CannotUseTrailingWhitespacesInDatabaseName - Falha na validação do nome do banco de dados.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - O banco de dados de origem não pode ter uma edição mais alta do que o banco de dados de destino.

  • 400 SecurityAdalPrincipalCertExpiredError - A operação não pôde ser concluída porque o certificado principal do Key Vault do Azure expirou.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - O banco de dados de destino não pode ter uma edição inferior à do banco de dados de origem.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - A operação não é permitida porque a operação de cópia ou failover para o banco de dados '{0}' no servidor '{1}' está em andamento no momento.

  • 400 InvalidCollation – A ordenação não é reconhecida pelo servidor.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - O URI de Key Vault fornecido não é válido.

  • 400 KeyMaterialNotFoundOnRemoteServer – O servidor remoto não tem acesso ao material de chave usado como protetor de TDE.

  • 400 AzureKeyVaultRsaKeyNotSupported – o cofre de chaves fornecido usa o tamanho da chave RSA ou o tipo de chave RSA sem suporte. O tamanho da chave RSA com suporte é 2048 ou 3072 e o Tipo de Chave é RSA ou RSA-HSM.

  • 400 SameKeyMaterialNotFoundOnRemoteServer – O servidor secundário não tem o material de chave do protetor de criptografia do servidor primário.

  • 400 ElasticPoolOverFileSpace - Espaço de arquivo insuficiente no pool elástico.

  • 400 PartnerDBNotCompatibleForSGXEnclave – a tentativa de definir o link geoDR ou atualizar o SLO para o banco de dados habilitado para enclave só tem suporte quando ambos os bancos de dados estão em execução no hardware da série DC.

  • 400 UpdateNotAllowedInCurrentReplicationState - A operação não é permitida no banco de dados em seu estado de replicação atual.

  • 400 InvalidLicenseType - O usuário tentou criar ou atualizar um banco de dados ou pool elástico com tipo de licença sem suporte.

  • 400 GeoReplicaLimitReached - O limite de replicação por réplica foi atingido.

  • 400 UnsupportedCapacity - O usuário tentou criar ou atualizar o banco de dados com capacidade sem suporte.

  • 400 ReplicationSourceAndTargetMustHaveSameName - Os bancos de dados de origem e de destino de replicação devem ter o mesmo nome.

  • 400 ProvisioningDisabled - Exibe a mensagem de erro do autorizador de operação de recursos como está, sem alterações

  • 400 ReplicationSourceAndTargetMustBeInDifferentServers – os bancos de dados de origem e de destino de replicação devem estar em servidores lógicos diferentes.

  • 400 CannotUpdateIsLedgerDatabase - A propriedade do razão de um banco de dados existente não pode ser atualizada.

  • 400 UnableToResolveRemoteServer - O nome do servidor parceiro remoto não pôde ser resolvido devido a um nome de servidor inválido ou problemas de conectividade DNS.

  • 400 RemoteDatabaseCopyPermission - O usuário não tem permissão suficiente para criar uma cópia de banco de dados no servidor especificado.

  • 400 CannotMoveOrDropSyncMetadataDatabase - Não é possível descartar o banco de dados usado como banco de dados de metadados de sincronização.

  • 400 SecurityAzureKeyVaultGeoChainError – Não há suporte para a criação secundária do secundário (um processo conhecido como encadeamento) ao habilitar o Transparent Data Encryption usando o BYOK (Azure Key Vault).

  • 400 RestoreToFreeEditionNotSupported – O destino Restore e GeoRestore não pode ser um banco de dados gratuito.

  • 400 CannotMoveOrDropJobAccountDatabase - Não é possível descartar o banco de dados associado à conta de trabalho.

  • 400 RestoreNotSupportedForFreeEdition – Não há suporte para Restauração e GeoRestore para banco de dados gratuito.

  • 400 JobAgentDatabaseEditionUnsupported - O objetivo de nível de serviço do banco de dados especificado não tem suporte para uso como um banco de dados de agente de trabalho.

  • 400 InvalidDroppedDatabase - O banco de dados de origem descartado não existe no servidor dentro do período de recuperação com suporte.

  • 400 InvalidLiveDatabase - O banco de dados de origem não existe no servidor dentro do período de recuperação com suporte. Se estiver restaurando um banco de dados descartado, especifique a data de exclusão.

  • 400 InvalidVldbRecoverySlo - A recuperação da edição da Hiperescala exige que os bancos de dados de origem e de destino usem o objetivo de nível de serviço da Hiperescala.

  • 400 SourceDatabaseNotFound - O banco de dados de origem não existe.

  • 400 InvalidVldbRestoreSlo - A restauração Pontual da edição hiperescala exige que os bancos de dados de origem e de destino usem o objetivo de nível de serviço da Hiperescala.

  • 400 CannotSpecifyPoolOrSlo – Não há suporte para especificar um pool elástico e/ou alterar o objetivo ou edição do nível de serviço para edição.

  • 400 InvalidPublicMaintenanceConfiguration - O usuário tentou especificar a configuração de manutenção pública que não pode ser convertida em ID interna (região malformada ou incorreta).

  • 400 MaintenanceWindowNotSupportedForNamedReplica – o usuário tentou criar ou atualizar réplica nomeados com uma janela de manutenção não padrão que não tem suporte.

  • 400 ChangeUnsupportedOnEntity - O usuário tentou uma operação de criação/atualização/exclusão sem suporte em uma determinada entidade.

  • 404 OperationIdNotFound - A operação com Id não existe.

  • 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 LongTermRetentionMigrationBackupNotFound - O backup LTR especificado não existe.

  • 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância de servidor.

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada.

  • 404 ServerNotInSubscription – O servidor especificado não existe na assinatura especificada.

  • 404 CannotFindObject - Não é possível localizar o objeto porque ele não existe ou você não tem permissões

  • 405 UnsupportedReplicationOperation - Uma operação de replicação sem suporte foi iniciada no banco de dados.

  • 409 OperationCancelled - A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 409 LongTermRetentionMigrationRequestConflict - Uma operação de conflito neste backup LTR ainda está em andamento.

  • 409 LongTermRetentionMigrationBackupConflict - Existe outro backup LTR com o mesmo tempo de backup para o banco de dados de destino.

  • 409 FreeDbAlreadyExists – somente um banco de dados gratuito pode existir para uma assinatura por região.

  • 409 ConflictingServerOperation - Uma operação está em andamento no momento para o servidor.

  • 409 Assinatura Desabilitada – A assinatura está desabilitada.

  • 409 ConflictingSystemOperationInProgress - Uma operação de manutenção do sistema está em andamento no banco de dados e outras operações precisam aguardar até que ele seja concluído.

  • 409 ConflictRequestToUpdateBackupRedundancy - Uma solicitação de conflito para alterar a redundância de armazenamento de backup ainda está em andamento.

  • 409 SkuAssignmentInProgress - A solicitação de atribuição atual não pode ser processada porque uma solicitação anterior não foi concluída.

  • 409 DatabaseElasticPoolMaintenanceConflict – o usuário tentou criar ou atualizar um banco de dados com uma configuração de manutenção especificada que estava em conflito com a do pool elástico do banco de dados.

  • 409 ServerDtuQuotaExceeded - Não foi possível executar a operação porque o servidor excederia a cota de Unidade de Taxa de Transferência de Banco de Dados permitida.

  • 409 UnableToAlterDatabaseInReplication - Edição alterada pelo usuário em um banco de dados em uma relação de replicação.

  • 409 SubscriptionVcoreQuotaExceeded - Não foi possível executar a operação porque a assinatura excederia a cota de vCore permitida.

  • 409 CurrentMemoryUsageExceedsSkuQuota - O usuário tentou uma operação de atualização de sku que não pode ser concluída devido ao maior consumo de recursos.

  • 409 ServerKeyNameAlreadyExists - A chave do servidor já existe no servidor.

  • 409 ServerKeyUriAlreadyExists - O URI da chave do servidor já existe no servidor.

  • 409 ServerKeyDoesNotExists – a chave do servidor não existe.

  • 409 UpdateSloInProgress - O usuário tentou iniciar uma operação incompatível enquanto uma atualização de SLO estava em andamento.

  • 409 UpdateSloFailedDatabaseTooBusy – Não foi possível concluir a operação de SLO de atualização porque o banco de dados estava muito ocupado.

  • 409 ElasticPoolBusy - Uma operação de gerenciamento foi tentada em um pool elástico que está ocupado.

  • 409 AzureKeyVaultKeyNameNotFound - A operação não pôde ser concluída porque o nome da chave de Key Vault do Azure não existe.

  • 409 AzureKeyVaultKeyInUse - A chave está sendo usada pelo servidor no momento.

  • 409 ServerDisabled – O servidor está desabilitado.

  • 409 ConflictingDatabaseOperation - Já existe alguma operação no banco de dados e a operação atual deve aguardar até que ela seja concluída.

  • 409 SimultaneousSkuChangeNotAllowed – As operações de alteração de objetivo de serviço não podem ser executadas em ambos os bancos de dados de uma relação de replicação ao mesmo tempo.

  • 409 TargetElasticPoolBeingUpdated - A atualização do pool elástico não pode ser iniciada porque há uma operação de cópia em andamento para um dos bancos de dados neste pool elástico

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - Uma operação de propagação de replicação foi executada em um banco de dados que já está em uma relação de replicação.

  • 409 InvalidOperationForDatabaseInReplicationRelationship - Uma operação de propagação de replicação foi executada em um banco de dados que já está em uma relação de replicação.

  • 409 DuplicateGeoDrRelation - Os bancos de dados já estão em uma relação de replicação. Essa é uma solicitação duplicada.

  • 409 DatabaseCopyLimitPerReplicaReached - O usuário atingiu o limite de cópias de banco de dados simultâneas.

  • 409 RemoteDatabaseExists - O nome do banco de dados de destino já existe no servidor de destino.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Falha ao iniciar a solicitação de cópia de backup LTR na região de destino.

  • 500 LongTermRetentionMigrationRequestCopyFailed - Falha na operação de cópia para blobs de backup LTR.

  • 500 LongTermRetentionMigrationRestoreVerExceeded - Falha na verificação de restauração depois que o máximo de tentativas foi atingido.

  • 500 LongTermRetentionMigrationRestoreVerFailed - Falha na verificação de restauração.

  • 500 ActivateOrDeactivateWorkflowThrottling - Falha no fluxo de trabalho de ativação ou desativação porque há muitos fluxos de trabalho simultâneos

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 503 AzureKeyVaultConnectionFailed - A operação não pôde ser concluída no servidor porque as tentativas de conexão com o Azure Key Vault falharam

  • 503 AzureKeyVaultGenericConnectionError - A operação não pôde ser concluída porque um erro foi encontrado ao tentar recuperar Key Vault informações .

  • 503 DatabaseUnavailable - A operação falhou porque o banco de dados não está disponível.

  • 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

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

Assigns maintenance window to a database.

Solicitação de exemplo

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

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

Resposta de exemplo

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

Solicitação de exemplo

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

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

Resposta de exemplo

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

Solicitação de exemplo

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

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

Resposta de exemplo

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

Definições

Nome Description
BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para esse banco de dados.

CatalogCollationType

Ordenação do catálogo de metadados.

CreateMode

Especifica o modo de criação do banco de dados.

Padrão: criação regular de banco de dados.

Copiar: cria um banco de dados como uma cópia de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados de origem.

Secundário: cria um banco de dados como um réplica secundário de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados primário existente.

PointInTimeRestore: cria um banco de dados restaurando um backup pontual de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados existente e restorePointInTime deve ser especificado.

Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. sourceDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável a ser restaurada.

Restauração: cria um banco de dados restaurando um backup de um banco de dados excluído. sourceDatabaseId deve ser especificado. Se sourceDatabaseId for a ID de recurso original do banco de dados, sourceDatabaseDeletionDate deverá ser especificado. Caso contrário, sourceDatabaseId deve ser a ID do recurso de banco de dados descartado restaurável e sourceDatabaseDeletionDate será ignorado. restorePointInTime também pode ser especificado para restaurar de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria um banco de dados restaurando de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId deve ser especificado como a ID do recurso do ponto de recuperação.

Não há suporte para Copy, Secondary e RestoreLongTermRetentionBackup na edição DataWarehouse.

Database

Um recurso de banco 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 ser aplicado a esse banco de dados. LicenseIncludedse você precisar de uma licença ou BasePrice se tiver uma licença e estiver qualificado para o Benefício Híbrido do Azure.

DatabaseReadScale

O estado do roteamento somente leitura. Se habilitadas, as conexões que têm a intenção do aplicativo definida como somente leitura em seus cadeia de conexão podem ser roteadas para um réplica secundário somente leitura na mesma região. Não aplicável a um banco de dados de Hiperescala em um pool elástico.

DatabaseStatus

O status do banco de dados.

DatabaseUpdate

Um recurso de atualização de banco de dados.

DatabaseUserIdentity

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

SampleName

O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados.

SecondaryType

O tipo secundário do banco de dados se ele for um 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 usado para armazenar backups para esse banco de dados.

Nome Tipo Description
Geo

string

GeoZone

string

Local

string

Zone

string

CatalogCollationType

Ordenação do catálogo de metadados.

Nome Tipo Description
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

CreateMode

Especifica o modo de criação do banco de dados.

Padrão: criação regular de banco de dados.

Copiar: cria um banco de dados como uma cópia de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados de origem.

Secundário: cria um banco de dados como um réplica secundário de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados primário existente.

PointInTimeRestore: cria um banco de dados restaurando um backup pontual de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados existente e restorePointInTime deve ser especificado.

Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. sourceDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável a ser restaurada.

Restauração: cria um banco de dados restaurando um backup de um banco de dados excluído. sourceDatabaseId deve ser especificado. Se sourceDatabaseId for a ID de recurso original do banco de dados, sourceDatabaseDeletionDate deverá ser especificado. Caso contrário, sourceDatabaseId deve ser a ID do recurso de banco de dados descartado restaurável e sourceDatabaseDeletionDate será ignorado. restorePointInTime também pode ser especificado para restaurar de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria um banco de dados restaurando de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId deve ser especificado como a ID do recurso do ponto de recuperação.

Não há suporte para Copy, Secondary e RestoreLongTermRetentionBackup na edição DataWarehouse.

Nome 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 banco de dados.

Nome Tipo Description
id

string

ID do recurso.

identity

DatabaseIdentity

A identidade do Azure Active Directory do banco de dados.

kind

string

Tipo de banco de dados. Esses são os metadados usados para a experiência de portal do Azure.

location

string

Local do recurso.

managedBy

string

Recurso que gerencia o banco de dados.

name

string

Nome do recurso.

properties.autoPauseDelay

integer

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

properties.catalogCollation

CatalogCollationType

Ordenação do catálogo de metadados.

properties.collation

string

A ordenação do banco de dados.

properties.createMode

CreateMode

Especifica o modo de criação do banco de dados.

Padrão: criação regular de banco de dados.

Copiar: cria um banco de dados como uma cópia de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados de origem.

Secundário: cria um banco de dados como um réplica secundário de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados primário existente.

PointInTimeRestore: cria um banco de dados restaurando um backup pontual de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados existente e restorePointInTime deve ser especificado.

Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. sourceDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável a ser restaurada.

Restauração: cria um banco de dados restaurando um backup de um banco de dados excluído. sourceDatabaseId deve ser especificado. Se sourceDatabaseId for a ID de recurso original do banco de dados, sourceDatabaseDeletionDate deverá ser especificado. Caso contrário, sourceDatabaseId deve ser a ID do recurso de banco de dados descartado restaurável e sourceDatabaseDeletionDate será ignorado. restorePointInTime também pode ser especificado para restaurar de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria um banco de dados restaurando de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId deve ser especificado como a ID do recurso do ponto de recuperação.

Não há suporte para Copy, Secondary e RestoreLongTermRetentionBackup na edição DataWarehouse.

properties.creationDate

string

A data de criação do banco de dados (formato ISO8601).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para esse banco de dados.

properties.currentServiceObjectiveName

string

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

properties.currentSku

Sku

O nome e a camada do SKU.

properties.databaseId

string

A ID do banco de dados.

properties.defaultSecondaryLocation

string

A região secundária padrão para esse banco de dados.

properties.earliestRestoreDate

string

Isso registra a data e a hora de início mais antigas em que a restauração está disponível para esse banco de dados (formato ISO8601).

properties.elasticPoolId

string

O identificador de recurso do pool elástico que contém esse banco de dados.

properties.failoverGroupId

string

Identificador de recurso do Grupo de Failover ao qual este banco de dados pertence.

properties.federatedClientId

string

A ID do cliente usada para o cenário de CMK entre locatários por banco de dados

properties.highAvailabilityReplicaCount

integer

O número de réplicas secundárias associadas ao banco de dados que são usadas para fornecer alta disponibilidade. Não aplicável a um banco de dados de Hiperescala em um pool elástico.

properties.isInfraEncryptionEnabled

boolean

A criptografia infra está habilitada para este banco de dados.

properties.isLedgerOn

boolean

Se esse banco de dados é ou não um banco de dados do razão, o que significa que todas as tabelas no banco de dados são tabelas do razão. Observação: o valor dessa propriedade não pode ser alterado após a criação do banco de dados.

properties.licenseType

DatabaseLicenseType

O tipo de licença a ser aplicado a esse banco de dados. LicenseIncludedse você precisar de uma licença ou BasePrice se tiver uma licença e estiver qualificado para o Benefício Híbrido do Azure.

properties.longTermRetentionBackupResourceId

string

O identificador de recurso do backup de retenção de longo prazo associado à operação de criação desse banco de dados.

properties.maintenanceConfigurationId

string

ID de configuração de manutenção atribuída ao banco de dados. Essa configuração define o período em que as atualizações de manutenção ocorrerão.

properties.maxLogSizeBytes

integer

O tamanho máximo do log para este banco de dados.

properties.maxSizeBytes

integer

O tamanho máximo do banco de dados expresso em bytes.

properties.minCapacity

number

Capacidade mínima que o banco de dados sempre terá alocado, se não estiver em pausa

properties.pausedDate

string

A data em que o banco de dados foi pausado pela configuração ou ação do usuário (formato ISO8601). Nulo se o banco de dados estiver pronto.

properties.readScale

DatabaseReadScale

O estado do roteamento somente leitura. Se habilitadas, as conexões que têm a intenção do aplicativo definida como somente leitura em seus cadeia de conexão podem ser roteadas para um réplica secundário somente leitura na mesma região. Não aplicável a um banco de dados de Hiperescala em um pool elástico.

properties.recoverableDatabaseId

string

O identificador de recurso do banco de dados recuperável associado à operação de criação desse banco de dados.

properties.recoveryServicesRecoveryPointId

string

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

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento a ser usado para armazenar backups para esse banco de dados.

properties.requestedServiceObjectiveName

string

O nome do objetivo de nível de serviço solicitado do banco de dados.

properties.restorableDroppedDatabaseId

string

O identificador de recurso do banco de dados descartado restaurável associado à operação de criação desse banco de dados.

properties.restorePointInTime

string

Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados.

properties.resumedDate

string

A data em que o banco de dados foi retomado pela ação do usuário ou pelo logon do banco de dados (formato ISO8601). Nulo se o banco de dados estiver em pausa.

properties.sampleName

SampleName

O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados.

properties.secondaryType

SecondaryType

O tipo secundário do banco de dados se ele for um secundário. Os valores válidos são Geo e Named.

properties.sourceDatabaseDeletionDate

string

Especifica a hora em que o banco de dados foi excluído.

properties.sourceDatabaseId

string

O identificador de recurso do banco de dados de origem associado à operação de criação desse banco de dados.

properties.sourceResourceId

string

O identificador de recurso da origem associada à operação de criação desse banco de dados.

Essa propriedade só tem suporte para a edição DataWarehouse e permite a restauração entre assinaturas.

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

Quando createMode é PointInTimeRestore, sourceResourceId deve ser a ID do recurso do banco de dados existente ou do pool de sql existente e restorePointInTime deve ser especificado.

Quando createMode é Restore, sourceResourceId deve ser a ID do recurso do banco de dados descartado restaurável ou do pool de sql descartado restaurável.

Quando createMode é Recover, sourceResourceId deve ser a ID do recurso do banco de dados recuperável ou do pool de sql recuperável.

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

properties.status

DatabaseStatus

O status do banco de dados.

properties.zoneRedundant

boolean

Se esse banco de dados tem ou não redundância de zona, o que significa que as réplicas desse banco de dados serão distribuídas entre várias zonas de disponibilidade.

sku

Sku

O SKU do banco de dados.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome do SKU, a camada/edição, a família e a capacidade) que estão disponíveis para sua assinatura em uma região do Azure, use 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

Marcas de recurso.

type

string

Tipo de recurso.

DatabaseIdentity

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

Nome Tipo Description
tenantId

string

A ID do locatário do Azure Active Directory.

type

DatabaseIdentityType

O tipo de identidade

userAssignedIdentities

<string,  DatabaseUserIdentity>

As IDs de recurso das identidades atribuídas pelo usuário a serem usadas

DatabaseIdentityType

O tipo de identidade

Nome Tipo Description
None

string

UserAssigned

string

DatabaseLicenseType

O tipo de licença a ser aplicado a esse banco de dados. LicenseIncludedse você precisar de uma licença ou BasePrice se tiver uma licença e estiver qualificado para o Benefício Híbrido do Azure.

Nome Tipo Description
BasePrice

string

LicenseIncluded

string

DatabaseReadScale

O estado do roteamento somente leitura. Se habilitadas, as conexões que têm a intenção do aplicativo definida como somente leitura em seus cadeia de conexão podem ser roteadas para um réplica secundário somente leitura na mesma região. Não aplicável a um banco de dados de Hiperescala em um pool elástico.

Nome Tipo Description
Disabled

string

Enabled

string

DatabaseStatus

O status do banco de dados.

Nome Tipo Description
AutoClosed

string

Copying

string

Creating

string

Disabled

string

EmergencyMode

string

Inaccessible

string

Offline

string

OfflineChangingDwPerformanceTiers

string

OfflineSecondary

string

Online

string

OnlineChangingDwPerformanceTiers

string

Paused

string

Pausing

string

Recovering

string

RecoveryPending

string

Restoring

string

Resuming

string

Scaling

string

Shutdown

string

Standby

string

Starting

string

Stopped

string

Stopping

string

Suspect

string

DatabaseUpdate

Um recurso de atualização de banco de dados.

Nome Tipo Description
identity

DatabaseIdentity

Identidade do banco de dados

properties.autoPauseDelay

integer

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

properties.catalogCollation

CatalogCollationType

Ordenação do catálogo de metadados.

properties.collation

string

A ordenação do banco de dados.

properties.createMode

CreateMode

Especifica o modo de criação do banco de dados.

Padrão: criação regular de banco de dados.

Copiar: cria um banco de dados como uma cópia de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados de origem.

Secundário: cria um banco de dados como um réplica secundário de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados primário existente.

PointInTimeRestore: cria um banco de dados restaurando um backup pontual de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados existente e restorePointInTime deve ser especificado.

Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. sourceDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável a ser restaurada.

Restauração: cria um banco de dados restaurando um backup de um banco de dados excluído. sourceDatabaseId deve ser especificado. Se sourceDatabaseId for a ID de recurso original do banco de dados, sourceDatabaseDeletionDate deverá ser especificado. Caso contrário, sourceDatabaseId deve ser a ID do recurso de banco de dados descartado restaurável e sourceDatabaseDeletionDate será ignorado. restorePointInTime também pode ser especificado para restaurar de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria um banco de dados restaurando de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId deve ser especificado como a ID do recurso do ponto de recuperação.

Não há suporte para Copy, Secondary e RestoreLongTermRetentionBackup na edição DataWarehouse.

properties.creationDate

string

A data de criação do banco de dados (formato ISO8601).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para esse banco de dados.

properties.currentServiceObjectiveName

string

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

properties.currentSku

Sku

O nome e a camada do SKU.

properties.databaseId

string

A ID do banco de dados.

properties.defaultSecondaryLocation

string

A região secundária padrão para esse banco de dados.

properties.earliestRestoreDate

string

Isso registra a data e a hora de início mais antigas em que a restauração está disponível para esse banco de dados (formato ISO8601).

properties.elasticPoolId

string

O identificador de recurso do pool elástico que contém esse banco de dados.

properties.failoverGroupId

string

Identificador de recurso do Grupo de Failover ao qual este banco de dados pertence.

properties.federatedClientId

string

A ID do cliente usada para o cenário de CMK entre locatários por banco de dados

properties.highAvailabilityReplicaCount

integer

O número de réplicas secundárias associadas ao banco de dados que são usadas para fornecer alta disponibilidade. Não aplicável a um banco de dados de Hiperescala em um pool elástico.

properties.isInfraEncryptionEnabled

boolean

A criptografia infra está habilitada para este banco de dados.

properties.isLedgerOn

boolean

Se esse banco de dados é ou não um banco de dados do razão, o que significa que todas as tabelas no banco de dados são tabelas do razão. Observação: o valor dessa propriedade não pode ser alterado após a criação do banco de dados.

properties.licenseType

DatabaseLicenseType

O tipo de licença a ser aplicado a esse banco de dados. LicenseIncludedse você precisar de uma licença ou BasePrice se tiver uma licença e estiver qualificado para o Benefício Híbrido do Azure.

properties.longTermRetentionBackupResourceId

string

O identificador de recurso do backup de retenção de longo prazo associado à operação de criação desse banco de dados.

properties.maintenanceConfigurationId

string

ID de configuração de manutenção atribuída ao banco de dados. Essa configuração define o período em que as atualizações de manutenção ocorrerão.

properties.maxLogSizeBytes

integer

O tamanho máximo do log para este banco de dados.

properties.maxSizeBytes

integer

O tamanho máximo do banco de dados expresso em bytes.

properties.minCapacity

number

Capacidade mínima que o banco de dados sempre terá alocado, se não estiver em pausa

properties.pausedDate

string

A data em que o banco de dados foi pausado pela configuração ou ação do usuário (formato ISO8601). Nulo se o banco de dados estiver pronto.

properties.readScale

DatabaseReadScale

O estado do roteamento somente leitura. Se habilitadas, as conexões que têm a intenção do aplicativo definida como somente leitura em seus cadeia de conexão podem ser roteadas para um réplica secundário somente leitura na mesma região. Não aplicável a um banco de dados de Hiperescala em um pool elástico.

properties.recoverableDatabaseId

string

O identificador de recurso do banco de dados recuperável associado à operação de criação desse banco de dados.

properties.recoveryServicesRecoveryPointId

string

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

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento a ser usado para armazenar backups para esse banco de dados.

properties.requestedServiceObjectiveName

string

O nome do objetivo de nível de serviço solicitado do banco de dados.

properties.restorableDroppedDatabaseId

string

O identificador de recurso do banco de dados descartado restaurável associado à operação de criação desse banco de dados.

properties.restorePointInTime

string

Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados.

properties.resumedDate

string

A data em que o banco de dados foi retomado pela ação do usuário ou pelo logon do banco de dados (formato ISO8601). Nulo se o banco de dados estiver em pausa.

properties.sampleName

SampleName

O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados.

properties.secondaryType

SecondaryType

O tipo secundário do banco de dados se ele for um secundário. Os valores válidos são Geo e Named.

properties.sourceDatabaseDeletionDate

string

Especifica a hora em que o banco de dados foi excluído.

properties.sourceDatabaseId

string

O identificador de recurso do banco de dados de origem associado à operação de criação desse banco de dados.

properties.status

DatabaseStatus

O status do banco de dados.

properties.zoneRedundant

boolean

Se esse banco de dados tem ou não redundância de zona, o que significa que as réplicas desse banco de dados serão distribuídas entre várias zonas de disponibilidade.

sku

Sku

O nome e a camada do SKU.

tags

object

Marcas de recurso.

DatabaseUserIdentity

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

Nome Tipo Description
clientId

string

A ID do cliente do Azure Active Directory.

principalId

string

A ID da entidade de segurança do Azure Active Directory.

SampleName

O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados.

Nome Tipo Description
AdventureWorksLT

string

WideWorldImportersFull

string

WideWorldImportersStd

string

SecondaryType

O tipo secundário do banco de dados se ele for um secundário. Os valores válidos são Geo e Named.

Nome Tipo Description
Geo

string

Named

string

Sku

Um SKU de recurso do ARM.

Nome Tipo Description
capacity

integer

Capacidade do SKU específico.

family

string

Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui.

name

string

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

size

string

Tamanho do SKU específico

tier

string

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