ModifyDatabaseConfig - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Modifica os atributos de um banco de dados do ApsaraDB RDS for SQL Server.

Descrição da operação

Mecanismos compatíveis

ApsaraDB RDS for SQL Server

Documentação de recursos relacionados

Os recursos compatíveis com esta operação incluem Modificação dos atributos de um banco de dados SQL Server e Arquivamento de dados de disco em nuvem no OSS. Antes de usar o recurso de arquivamento de dados no OSS chamando esta operação de API, você deve ativar o recurso de arquivamento de dados no console.

Importante Antes de chamar esta operação de API, leia atentamente a documentação do recurso para garantir que você compreenda totalmente os pré-requisitos e os impactos da operação.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

rds:ModifyDatabaseConfig

update

*DBInstance

acs:rds:{#regionId}:{#accountId}:dbinstance/{#DbInstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBInstanceId	string	Sim	O ID da instância.	rm-t4nnu1my39q******
DBName	string	Sim	O nome do banco de dados. Nota Você não pode especificar vários nomes de banco de dados.	testDB
DatabasePropertyName	string	Sim	O atributo do banco de dados a ser modificado. Recurso de modificação de atributos do banco de dados: Especifique o nome do atributo para o banco de dados de destino. Recurso de arquivamento de dados no OSS: Especifique o status do banco de dados de destino. Defina o valor como `covert_online_db_to_cold_storage` para converter um banco de dados online em um banco de dados de armazenamento frio, ou defina o valor como `convert_cold_storage_db_to_online` para converter um banco de dados de armazenamento frio em um banco de dados online.	compatibility_level
DatabasePropertyValue	string	Sim	O valor esperado do atributo do banco de dados. Recurso de modificação de atributos do banco de dados: Especifique o valor do atributo para o banco de dados de destino. Recurso de arquivamento de dados no OSS: Defina o valor como 1 para converter o banco de dados de destino para um estado de armazenamento frio ou online.	150

Nomes de parâmetros nativos do SQL Server

Nome do parâmetro	Valores válidos	Acesso exclusivo ao banco de dados necessário para modificação	Versão mínima do SQL Server
compatibility_level	100 110 120 130 140 150 160	Não	SQL Server 2008
parameterization	FORCED SIMPLE	Não	Todas as versões
delayed_durability	DISABLED ALLOWED FORCED	Não	SQL Server 2014
accelerated_database_recovery	ON OFF	Sim	SQL Server 2019
read_committed_snapshot	ON OFF	Sim	SQL Server 2008
page_verify	CHECKSUM TORN_PAGE_DETECTION (A modificação do valor para TORN_PAGE_DETECTION não é suportada)	Não	Todas as versões
auto_update_statistics	ON OFF	Não	Todas as versões
auto_update_statistics_async	ON OFF	Não	SQL Server 2012
allow_snapshot_isolation	ON OFF	Não	Todas as versões
ansi_null_default	ON OFF	Não	Todas as versões
ansi_nulls	ON OFF	Não	Todas as versões
ansi_warnings	ON OFF	Não	Todas as versões
ansi_padding	ON OFF	Não	Todas as versões
concat_null_yields_null	ON OFF	Não	Todas as versões
recursive_triggers	ON OFF	Não	Todas as versões
auto_close	OFF	Não	Todas as versões

Nomes de parâmetros personalizados do RDS

Importante Os nomes de parâmetros personalizados do RDS começam com rds_.

Nome do parâmetro	Valores válidos	Acesso exclusivo ao banco de dados necessário para modificação	Versão mínima do SQL Server	Observações
rds_optimize_db_file_grow	1	Não	Todas as versões	Configurações para todo o crescimento de arquivo no banco de dados para um tamanho fixo de 256 MB.
rds_set_db_online	1	Não	Todas as versões	Coloca o banco de dados online. Se o banco de dados já estiver online, esta operação será ignorada.
rds_shrink_database_log	1	Não	Todas as versões	Reduz o banco de dados. O sucesso da operação de redução depende se o status log_reuse_wait_desc do log é "Nothing".
rds_update_db_stats	1	Não	Todas as versões	Atualiza as informações de estatísticas no banco de dados usando o procedimento armazenado interno do SQL Server sp_updatestats.
rds_rebuild_db_index	1	Não	Todas as versões	Reconstrói todos os índices não clusterizados com uma taxa de fragmentação maior que 50% no banco de dados. As seguintes condições devem ser atendidas: - O tamanho do banco de dados é menor que 10 GB. - O espaço restante em disco é maior que 10 GB.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
Code	string	O código.	200
Message	string	A mensagem retornada.	successful
RequestId	string	O ID da solicitação.	F5C79A20-E931-5389-BC04-DEBA2D3ABD8D

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "F5C79A20-E931-5389-BC04-DEBA2D3ABD8D"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	SqlExecuteFailedOrTimeout	%s.
400	InvalidDatabasePropertyValue	Specified value for the database property is not valid.	O valor do atributo do banco de dados a ser modificado não está dentro do intervalo válido.
400	InvalidDatabaseProperty	Specified name for the database property is not valid.	O nome do atributo do banco de dados especificado é inválido.
400	DatabasePropertyModificationFail	Database property modification failed, possibly due to high workload on the database or inability to obtain an exclusive lock. Please attempt to modify the property during periods of low workload.	A modificação da propriedade do banco de dados falhou. Isso pode ocorrer devido a uma alta carga de trabalho do banco de dados ou à impossibilidade de obter um bloqueio exclusivo. Tente modificar a propriedade em horários fora de pico.
400	InvalidDatabaseVersion	Specified database property is not compatible with the SQL Server major version.	A propriedade atual do banco de dados não é aplicável à versão principal do SQL Server.
400	InvalidDBInstanceEngineType.Format	the DB instance engine type does not support this operation.	Esta operação não é suportada para o tipo de mecanismo de banco de dados da instância.
400	UserAlreadyExistInDb	The current login already has a mapped user with the same name in the specific database. please try removing the existing user and retrying.	Um usuário mapeado com o mesmo nome já existe para o logon atual no banco de dados especificado. Exclua o usuário existente e tente novamente.
400	InvalidDiskType	Current disk type does not support this operation.	O tipo de disco em nuvem atual não suporta esta operação.
400	CurrentInsHasColdDB	The current instance has cold storage db.	A instância atual contém bancos de dados em armazenamento frio.
400	CurrentInsHasColdStorage	Current instance has cold storage.	A instância atual contém armazenamento frio.
400	ColdDBHasSameNameWithOnlineDB	The instance has cold db and online db with the same name.	A instância contém bancos de dados em armazenamento frio e online que possuem o mesmo nome.
400	DiskSpaceInsufficientForColdOperation	Insufficient disk space to bring db online.	O banco de dados não pode ser convertido para o estado online devido ao espaço em disco insuficiente.
400	InvalidRestoreTimeSpecified	Unable to restore to the specified time, because the database is in cold storage at this time. Please choose a valid restore point.	O banco de dados não pode ser restaurado para o ponto no tempo especificado porque estava no armazenamento frio naquele momento. Selecione outro ponto no tempo válido.
400	InvalidRestoreDB	Unable to restore, because the database is in cold storage now. Please skip this database.	O banco de dados atual não pode ser restaurado porque está no armazenamento frio. Ignore este banco de dados.
400	CurrentDBIsInColdStorage	current db is cold db.	O banco de dados atual está no armazenamento frio.
400	ColdDBNumExceedsLimit	the number of cold db exceeds the limit.	O número de bancos de dados em armazenamento frio excede o limite.
400	Order.ComboInstanceNotAllowOperate	A package instance is not allowed to operate independently.	Operações individuais não são permitidas para instâncias agrupadas.
400	Price.PricingPlanResultNotFound	Pricing plan price result not found.	O resultado de preços para o plano de preços não foi encontrado.
400	Order.NoRealNameAuthentication	You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication.	Você não concluiu a verificação de nome real e não atende aos requisitos de compra. Faça login em Despesas e Custos para concluir a verificação de nome real.
400	InsufficientAvailableQuota	Your account quota limit is less than 0, please recharge before trying to purchase.	O saldo disponível da sua conta é menor que 0. Recarregue sua conta antes de tentar fazer uma compra.
400	CommodityServiceCalling.Exception	Failed to call commodity service.	A chamada para o serviço de produtos falhou.
400	RegionDissolvedEOM	Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support.	O Alibaba Cloud planeja otimizar e ajustar a região atual, e os serviços em nuvem nesta região cessarão as operações. Para garantir a continuidade dos negócios e uma transição suave para a migração de dados, você não pode realizar novos pedidos de compra no momento. Agradecemos sua compreensão e apoio.
400	Commodity.InvalidComponent	The module you purchased is not legal, please buy it again.	O módulo especificado é inválido. Adquira um módulo válido.
400	RegionEndTimeDissolvedAustralia	Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024.	A região foi desativada.
400	Price.CommoditySys	Commodity system call exception.	Ocorreu uma exceção ao chamar o sistema de produtos.
400	Pay.InsufficientBalance	Insufficient available balance.
400	Order.PeriodInvalid	There is a problem with the period you selected, please choose again.	O período de assinatura selecionado é inválido. Selecione novamente o período de assinatura.
400	pay.noCreditCard	Account not bound to credit card.	A conta não está vinculada a um cartão de crédito.
400	Order.InstHasUnpaidOrder	There is an unpaid order for the service you have purchased. Please pay or void it before placing the order.	Você tem pedidos não pagos para o serviço selecionado. Pague ou cancele os pedidos não pagos antes de fazer um novo pedido.
400	noAvailablePaymentMethod	No payment method is specified for your account. We recommend that you add a payment method.	Nenhum método de pagamento está especificado para a sua conta. Adicione um método de pagamento.
400	BasicInfoUncompleted	Your information is incomplete. Complete your information before the operation.	Suas informações estão incompletas. Complete suas informações antes de prosseguir.
400	Risk.RiskControlRejection	Your account is abnormal, please contact customer service for details.	Sua conta está em um estado anormal. Entre em contato com o suporte ao cliente para obter detalhes.
400	Api.NotSupport	Specified api is not supported.	A operação de API atual não é suportada.
400	ContainForbiddenLabelError	There is a label that prohibits placing orders. Please contact your distributor for assistance.	Uma tag que proíbe a realização de pedidos está presente. Entre em contato com seu distribuidor para obter assistência.
400	InvalidDBInstanceId.NotFound	The DBInstanceId provided does not exist in records.	A instância especificada não existe. Verifique se a instância existe e se não foi excluída.
400	InvalidInstanceLevel.DiskType	Specified instance level not support request disk type	O tipo de instância atual não suporta este tipo de armazenamento.
400	InvalidParam	Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica.	A operação falhou porque o parâmetro especificado é inválido.
400	KmsApiError	User secret key invalid.	A chave do usuário é inválida.
400	System.SaleValidateFailed	Sales expression validation system error.
400	Abs.InvalidAccount.NotFound	account is not found.	A conta não existe.
400	ColdData.EngineVersionNotSupport	The current instance engine version not support coldDataEnabled.	A versão atual do mecanismo de banco de dados da instância não suporta o arquivamento de dados frios.
400	ColdData.MinorVersionNotSupport	The current instance minor version not support coldDataEnabled.	A versão atual do kernel não suporta o arquivamento de dados frios.
400	IncorrectTargetClasscode	The current instance type does not support this operation.	O tipo de instância atual não suporta esta operação.
400	InvalidConnectionString.Duplicate	Specified connection string already exists in the RDS.	O nome do endpoint está duplicado. Reconfigure a string de conexão.
400	RequiredParam.NotFound	Required input param is not found.	Os parâmetros obrigatórios não foram fornecidos.
400	Parameters.Invalid	Parameter error, please check the parameters.	O parâmetro especificado é inválido. Verifique os parâmetros.
400	BackupPolicyNotSupport	Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy.	O arquivamento de dados não suporta backups entre regiões ou snapshots em segundos. Verifique a política de backup.
400	InvalideStatus.Format	The instance status does not support this operation.	O status atual da instância não oferece suporte a esta operação.
400	InvalidReleasedKeepPolicy.Format	Specified Released Keep Policy is not valid.	A política de retenção para backups arquivados após a liberação da instância é inválida.
400	Pay.NoCreditCard	No credit cards.
400	VpcNetworkTypeNotSupport	The vpc network type instance does not support this operation.	Esta operação não é suportada para instâncias do tipo VPC.
400	MirrorInsExists	Specified DB instance mirror ins already existed.	A imagem da instância de banco de dados atual já existe.
400	UnsupportedClassCode	The specified DB instance class stops selling.	O tipo de instância não está mais disponível para compra.
400	InvalidBackupSet	The specified database does not exist in the backup set.	O banco de dados especificado não existe no conjunto de backups.
400	OrdTCommodityQueryError	Failed to query for product.	Falha ao consultar o produto.
400	ProductInstanceReleased	The instance has been released. Please check before placing the order.	A instância foi liberada. Verifique o status da instância antes de fazer um pedido.
400	RegionEndTimeDissolvedIndia	The region is no longer supported.	A região foi desativada.
400	InvalidCharacter.DbOrAccount	The database name or account name contains invalid characters.	O nome do banco de dados ou o nome da conta contém caracteres inválidos.
400	StatisticsUpdateNotSupported	Updating statistics is not supported.	Não há suporte para a atualização de informações de estatísticas.
500	ExternalFailure	The request processing has failed due to external service failure.	A solicitação de serviço falhou. Tente novamente mais tarde.
500	RequestMetaDataFailed	The service request failed. Please try again later or contact service personnel.	A solicitação de serviço falhou. Tente novamente mais tarde ou entre em contato com o suporte técnico.
500	InvokeProxyFailure	The request processing has failed due to service failure of rds api.	O processamento da solicitação falhou devido a uma falha no serviço da API do RDS.
403	InvalidDB.NotFound	Specified db does not exist or DB status does not support.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	A operação falhou. O status atual da instância não suporta esta operação. Tente novamente mais tarde.
403	OrderStatus.UnPaid	The specified db instance has unpaid order.	A instância possui pedidos não pagos. Pague os pedidos e tente novamente.
403	InvalidReduceDiskSize	The storage capacity after the scale-down must be larger than the used amount.	A capacidade de destino para redução de escala não pode ser menor que o uso de armazenamento atual.
403	CloudSSDNotSupport	Cloud ssd does not support this operation, please upgrade to essd.	Esta operação não é suportada para SSDs padrão. Faça upgrade para ESSDs.
403	InvalidUserOperatorPermission	The user permission does not support this operation.	Você não tem as permissões necessárias para realizar esta operação.
403	InvalidVswitchId	Specified conn vswitch id is not valid.	O VSwitchId especificado é inválido ou está vazio.
403	IncorrectMinorVersion	Current engine minor version does not support operations.	A versão secundária atual do mecanismo não suporta esta operação.
403	OperationDenied.ZoneResource	There is no available zone for inventory.	Nenhuma zona com estoque disponível foi encontrada.
403	NotInFlowController	Sorry,no permission.	Este recurso não está disponível para usuários de nuvem que não pertencem a um grupo. Você não tem as permissões necessárias.
403	InvalidKmsKey	Kms key is disabled.	A chave KMS especificada está desativada.
403	InvalidInstanceLevel.Malformed	Current DB instance level does not support this operation.	A operação falhou porque o código de especificação especificado não suporta o número de endpoints. Verifique o número de shards e o número atual de endpoints.
404	InvalidClusterKms	The current instance does not authorized to access the Key Management Service.	A instância atual não está autorizada a acessar o Key Management Service (KMS).
404	Request.NotFound	The requested resource is not available.	O recurso solicitado não está disponível.
404	HostInfo.NotFound	The specified host info is not found.	As informações do host especificado não existem.
409	ConflictingDatabaseOperation	There is already some operation on the database and the current operation should wait till it is done.	Uma modificação de propriedade do banco de dados está atualmente em andamento para o banco de dados atual.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.