Alterar as especificações de uma instância - : Central de Documentação do Alibaba Cloud

Chame a operação ModifyDBInstanceSpec para alterar o tipo ou a capacidade de armazenamento de uma instância. Essa operação é compatível com instâncias primárias e instâncias somente leitura, mas não é compatível com instâncias de recuperação de desastres ou instâncias temporárias.

Antes de chamar essa operação, verifique se os seguintes requisitos são atendidos:

A instância está no estado Running.
A instância não possui tarefas de backup em andamento.
Pelo menos um dos parâmetros DBInstanceClass e DBInstanceStorage deve ser especificado na solicitação.
Para reduzir a capacidade de armazenamento, a nova capacidade especificada deve ser maior ou igual a 1,1 vez a capacidade de armazenamento utilizada.
A instância é primária ou somente leitura.

Nota

Para fazer upgrade da edição RDS da instância, selecione apenas um tipo de instância compatível com a nova edição RDS. Por exemplo, para fazer upgrade da RDS Basic Edition para a RDS High-availability Edition, selecione um tipo de instância compatível com a RDS High-availability Edition.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyDBInstanceSpec	A operação a ser executada. Defina o valor como ModifyDBInstanceSpec.
DBInstanceId	String	Yes	rm-uf6wjk5*******	O ID da instância.
DBInstanceClass	String	No	rds.mys2.small	O novo tipo da instância. Para obter mais informações, consulte Tipos de instâncias primárias do ApsaraDB RDS. Chame a operação DescribeAvailableClasses para consultar os tipos de instâncias disponíveis em uma região. Nota Especifique pelo menos um dos parâmetros DBInstanceClass e DBInstanceStorage. Chame a operação DescribeDBInstanceAttribute para consultar o tipo de instância em uso.
DBInstanceStorage	Integer	No	20	A nova capacidade de armazenamento da instância. Unidade: GB. A capacidade pode ser aumentada em incrementos de 5 GB. Para obter mais informações, consulte Tipos de instâncias primárias do ApsaraDB RDS. Chame a operação DescribeAvailableClasses para consultar o intervalo de capacidade de armazenamento compatível com um tipo de instância. Nota Especifique pelo menos um dos parâmetros DBInstanceStorage e DBInstanceClass. Se a instância executar MySQL na RDS High-availability Edition e usar SSDs locais, a capacidade de armazenamento pode ser reduzida em incrementos de 5 GB. Chame a operação DescribeDBInstanceAttribute para consultar a capacidade de armazenamento atual da instância.
PayType	String	Yes	Postpaid	O método de faturamento da instância. Valores válidos: Postpaid: pagamento conforme o uso Prepaid: assinatura
EffectiveTime	String	No	MaintainTime	O momento em que a alteração deve entrar em vigor. Valores válidos: Immediate: a alteração entra em vigor imediatamente. MaintainTime: a alteração entra em vigor durante a janela de manutenção especificada. Para obter mais informações, consulte ModifyDBInstanceMaintainTime. Nota Valor padrão: Immediate.
EngineVersion	String	No	5,6	A versão do mecanismo de banco de dados da instância. Valores válidos quando o parâmetro Engine é definido como MySQL: 5,5, 5,6, 5,7 e 8,0 Valores válidos quando o parâmetro Engine é definido como SQLServer: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha e 2019_ent Valores válidos quando o parâmetro Engine é definido como PostgreSQL: 10,0, 11,0, 12,0, 13,0, 14,0 e 15,0 Valores válidos quando o parâmetro Engine é definido como MariaDB: 10,3
DBInstanceStorageType	String	No	local_ssd	O tipo de armazenamento da instância. Valores válidos: local_ssd: SSD local. cloud_ssd: SSD padrão. Este tipo de armazenamento não é recomendado e não está disponível em algumas regiões da Alibaba Cloud. cloud_essd: ESSD (enhanced SSD) de nível de desempenho 1 (PL1). cloud_essd2: ESSD de PL2. cloud_essd3: ESSD de PL3. Ao alterar o tipo de armazenamento, considere os seguintes itens: Em instâncias que executam PostgreSQL, é possível fazer upgrade do tipo de armazenamento de SSD padrão para ESSD, mas não é permitido fazer downgrade de ESSD para SSD padrão. Os ESSDs oferecem os seguintes níveis de desempenho (PLs): PL1, PL2 e PL3. É possível fazer upgrade ou downgrade entre ESSD de PL1, PL2 e PL3. Para obter mais informações, consulte Itens de configuração.
Direction	String	No	Up	O tipo de alteração a ser realizada na instância. Valores válidos: Up: faz upgrade de uma instância de assinatura, ou upgrade/downgrade de uma instância de pagamento conforme o uso. Down: faz downgrade de uma instância de assinatura. TempUpgrade: executa alterações elásticas de especificação em uma instância de assinatura. Este valor é obrigatório para alterações elásticas de especificação. Nota Valor padrão: Up. Se apenas o parâmetro DBInstanceStorageType for especificado, o parâmetro Direction pode ser deixado vazio. Por exemplo, para alterar somente o tipo de armazenamento de SSD padrão para ESSD, não é necessário especificar o parâmetro Direction.
SourceBiz	String	No	N/A	Um parâmetro descontinuado.
DedicatedHostGroupId	String	No	dhg-7a9********	O ID do cluster dedicado ao qual a instância pertence.
ZoneId	String	No	cn-hangzhou-b	O ID da zona da instância.
SwitchTime	String	No	2019-07-10T13:15:12Z	O horário em que você deseja alterar as especificações. Recomenda-se realizar a alteração durante períodos de baixo tráfego. Especifique o horário no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Nota O horário especificado deve ser posterior ao horário atual, que corresponde ao momento em que esta operação é chamada. Caso contrário, a tarefa de alteração de especificação falhará. Se a tarefa falhar, aguarde o cancelamento automático do pedido e chame esta operação novamente. Para aumentar a capacidade de armazenamento ou alterar o nível de desempenho de ESSDs entre PLs diferentes, a alteração entra em vigor imediatamente e não afeta as cargas de trabalho. Não é necessário configure este parâmetro nesses casos.
ResourceGroupId	String	No	rg-acfmy**********	O ID do grupo de recursos ao qual a instância pertence.
UsedTime	Long	No	3	O período de validade das alterações de especificação em uma instância ApsaraDB RDS for SQL Server. Unidade: dias.
MaxCapacity	double	No	8	O número máximo de RDS Capacity Units (RCUs).
MinCapacity	double	No	0,5	O número mínimo de RCUs.
AutoPause	Boolean	No	true	Indica se a suspensão automática é compatível com a instância.
SwitchForce	Boolean	No	false	Indica se o recurso de dimensionamento forçado está ativado para a instância serverless. Valores válidos: true: ativa o recurso. false: desativa o recurso. Este é o valor padrão.
Category	String	No	HighAvailability	A edição RDS da instância. Valores válidos: Basic: RDS Basic Edition. HighAvailability: RDS High-availability Edition. AlwaysOn: RDS Cluster Edition para SQL Server Finance: RDS Enterprise Edition. Esta edição está disponível apenas no site da China (aliyun.com). Nota Se o parâmetro EngineVersion for definido com uma versão do SQL Server, este parâmetro também deve ser especificado.

Parâmetros da resposta

Parameter	Type	Example	Description
DBInstanceId	String	rm-uf6wjk5***	O ID da instância.
RequestId	String	3C5CFDEE-F774-4DED-89A2-1D76EC63C575	O ID da solicitação.
OrderId	Long	20793850608****	O ID do pedido.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceSpec
&DBInstanceId=rm-uf6wjk5*******
&PayType=Postpaid
&DBInstanceClass=rds.mys2.small
&<Common request parameters>

Exemplos de respostas bem-sucedidas

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDBInstanceSpecResponse>
    <RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</RequestId>
    <DBInstanceId>rm-uf6wjk5*******</DBInstanceId>
    <OrderId>20793850608****</OrderId>
</ModifyDBInstanceSpecResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "3C5CFDEE-F774-4DED-89A2-1D76EC63C575",
  "DBInstanceId" : "rm-uf6wjk5*******",
  "OrderId" : "20793850608****"
}

Códigos de erro

Http status code	Error code	Error message	Description
400	CannotDecreaseEssdPerfLevel	cannot decrease cloud essd performance level.	A alteração do tipo de armazenamento não é permitida. O tipo de armazenamento de instâncias SQL Server com SSDs padrão pode ser alterado apenas para ESSDs. O tipo de armazenamento de instâncias SQL Server com SSDs locais pode ser alterado para SSDs padrão ou ESSDs.
400	InvalidEssdStorageSize	invalid cloud essd storage size.	O tipo de instância especificado é inválido. Selecione um tipo de instância válido e tente novamente.
400	NotSupportReduceDiskSize	Not support reduce disk size.	Não é possível reduzir a capacidade de armazenamento da instância.
400	InvalidDBInstanceClass.NotFound	Specified DB instance class is not found.	O novo tipo de instância não foi encontrado ou não está mais disponível para compra. Selecione um tipo de instância disponível.
400	InvalidAvZone.Format	Specified AvZone is not valid.	O valor do parâmetro ZoneID é inválido.
400	OperationDenied.OrderUnPaid	The operation is not permitted due to the wrong Order status (Unpaid).	Há pedidos não pagos. Quite os pedidos pendentes antes de chamar esta operação.
400	OperationDenied.InvalidStorageSize	The storage size limit is exceeded.	O uso de armazenamento excede o limite máximo. Libere espaço ou expanda a capacidade de armazenamento.
400	InsufficientResourceCapacity	The instance cluster does not support this operation.	A operação não é compatível com o cluster dedicado ao qual a instância pertence.
400	InvalidUsedTime	The parameter usedTime is invalid.	O valor do parâmetro UsedTime é inválido.
400	CannotChangeStorageType	Temp upgrade does not support changing storage type.	Upgrades elásticos não são compatíveis com alterações de tipo de armazenamento.
400	TempUpgrade.NotSupport	The instance does not support temp upgrade.	A instância não é compatível com upgrades elásticos.
400	EngineNotSupported	Engine specified cannot be supported the operation.	Esta operação não é compatível com o mecanismo de banco de dados em execução na instância. Atualize a versão secundária do mecanismo.
400	MaxscaleNotSupport	Maxscale not supported	A instância não é compatível com o recurso de proxy de banco de dados. Verifique a configuração do proxy especificada.
400	ADInstanceNotSupportThisOperation	The AD instance is not supported this operation	Esta operação não é compatível com instâncias adicionadas a um domínio do Active Directory (AD).
400	BYOKInstanceNotSupportThisOperation	The BYOK instance is not supported this operation	Esta operação não é compatível com instâncias que têm a criptografia de disco ativada.
400	BYOLInstanceNotSupportThisOperation	The BYOL instance is not supported this operation	Esta operação não é compatível com instâncias que utilizam Bring Your Own License (BYOL).
400	SSLInstanceNotSupportThisOperation	The instance opened SSL, upgrade is not this operation	Esta operação não é compatível com instâncias que têm o recurso de criptografia SSL ativado.
400	TDEInstanceNotSupportThisOperation	The instance opened TDE, this operation is not supported	Esta operação não é compatível com instâncias que têm o recurso Transparent Data Encryption (TDE) ativado.
400	InstanceIsSnapshotBackupNotSupportThisOperation	The instance backup method is snapshot backup, this operation is not supported	Esta operação não é compatível com instâncias que têm o recurso de backup por snapshot ativado.
400	InstanceHasReadOnlyInstanceNotSupportThisOperation	The instance has read-only instance or is read-only instance, this operation is not supported	Esta operação não é compatível com instâncias somente leitura nem com instâncias às quais instâncias somente leitura estão associadas.
400	BackupReadInstanceModifyNotAllowed	Modify Backup Read Instance Is Not Allowed.	Não é permitido modificar a instância de origem do backup.
400	MinorVersionNotSupport	The current database minor version does not support the operation.	A versão secundária atual do mecanismo de banco de dados da instância não é compatível com esta operação.
400	LX.ARGUMENT.ILLEGAL	The parameters that you specified for the specification change are invalid.	Os parâmetros especificados para a alteração de especificação são inválidos.
400	ORD.S.QUERY.PROD.ERROR	An error occurred while querying the ordering information	O pedido não foi encontrado.
403	IncorrectDBInstanceType	The database instance type does not support the operation.	O mecanismo de banco de dados em execução na instância não é compatível com esta operação.
403	OperationDenied.NotSupportedBackupMethod	When the storage is larger than 4000 GB, only snapshot backup is supported.	A capacidade de armazenamento é superior a 4.000 GB e apenas backups por snapshot são compatíveis.
403	IncorrectReadDBInstanceDisksize	Read instance disk size must be equal or higher than primary instance.	A capacidade de armazenamento da instância somente leitura é inferior à da instância primária. Garanta que a capacidade de armazenamento da instância somente leitura seja maior ou igual à da instância primária.
403	GroupReplicationNotSupport.InvalidEngineVersion	Group Replication requires the instance engine version to be 8.0.	A versão principal do mecanismo da instância não é MySQL 8.0 e o MySQL group replication (MGR) não é compatível.
403	GroupReplicationNotSupport.InvalidNodeClassCode	Group Replication requires the ClassCode of each node to be consistent.	As especificações dos nós da instância são diferentes entre si e o MGR não é compatível.
403	GroupReplicationNotSupport.InvalidNodeNum	Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3.	O número de nós da instância não é um número ímpar maior ou igual a 3 e o MGR não é compatível.
403	GroupReplicationNotSupport.InvalidXengine	Group Replication is not supported because the instance has xengine tables.	Existem tabelas X-Engine na instância e o MGR não é compatível.
403	GroupReplicationNotSupport.MemoryTooSmall	Group Replication is not supported because the memory is too small.	A capacidade de memória da instância é insuficiente e o MGR não é compatível.
403	ARMNotSupport	ARM arch does not support this operation.	Esta operação não é compatível com a arquitetura ARM.
403	HostTypeNotSupport	Host type is inconsistent, please check that the original host type is the same as the target host type.	Os tipos de host antes e após a alteração de especificação são diferentes.
403	CloudSSDNotSupport	Cloud ssd does not support this operation, please upgrade to essd.	O tipo de armazenamento SSD padrão não é compatível com esta operação. Faça upgrade do tipo de armazenamento da instância para ESSD.
403	MaxscaleInstanceNotSupport	Instances with maxscale instance do not support this operation.	Esta operação não é compatível com instâncias que têm o MaxScale ativado.
403	ReadInstanceNotSupport	Instances with read-only do not support this operation.	Esta operação não é compatível com instâncias às quais instâncias somente leitura estão associadas.
404	InvalidClusterKms	The current instance does not authorized to access the Key Management Service.	A instância não tem permissões para acessar o Key Management Service (KMS).

Para obter a lista de códigos de erro, consulte Códigos de erro do serviço.