Modifica a configuração de dimensionamento elástico de uma instância.
Descrição da operação
Esta operação de API permite modificar os recursos de Dimensionamento automático de armazenamento, expansão automática de armazenamento, dimensionamento elástico de largura de banda e dimensionamento elástico de recursos de uma instância de banco de dados:
-
Você pode modificar o recurso de dimensionamento elástico de especificações para as seguintes instâncias de banco de dados:
PolarDB for MySQL Cluster Edition. Para introdução ao recurso e informações de cobrança, consulte dimensionamento automático para otimização de desempenho.
ApsaraDB RDS for MySQL high availability series cloud disk edition. Para introdução ao recurso e informações de cobrança, consulte dimensionamento automático para otimização de desempenho.
Tair (Redis® OSS-Compatible) cloud-native (formerly cloud disk) open-source edition. Para introdução ao recurso e informações de cobrança, consulte Ativar dimensionamento automático.
-
Você pode modificar o recurso de expansão automática de armazenamento para as seguintes instâncias de banco de dados:
Instância do ApsaraDB RDS for MySQL high availability series cloud disk edition. Para introdução ao recurso e informações de cobrança, consulte expansão automática de espaço.
-
Você pode modificar o recurso de dimensionamento elástico de largura de banda para as seguintes instâncias de banco de dados:
Instâncias clássicas (anteriormente disco local) do Tair (Redis® OSS-Compatible). Para introdução ao recurso e informações de cobrança, consulte Ajuste automático de largura de banda.
-
Você pode modificar o recurso de dimensionamento elástico de fragmentos para as seguintes instâncias de banco de dados:
Edição de código aberto cloud-native (anteriormente disco em nuvem) do Tair (Redis® OSS-Compatible) em arquitetura de cluster. Para introdução ao recurso e informações de cobrança, consulte Adição automática de fragmentos.
-
Você pode modificar o recurso de dimensionamento elástico de recursos para as seguintes instâncias de banco de dados:
ApsaraDB RDS for MySQL high availability series local disk edition (uso geral) e RDS Enterprise Edition (uso geral). Para introdução ao recurso e informações de cobrança, consulte dimensionamento automático para otimização de desempenho.
-
Use a versão mais recente do SDK do Alibaba Cloud ou do DAS.
-
Ao usar o SDK para chamar o DAS, defina a região como cn-shanghai.
-
Você pode modificar o recurso de dimensionamento elástico de especificações para as seguintes instâncias de banco de dados:
PolarDB for MySQL Cluster Edition. Para introdução ao recurso e informações de cobrança, consulte dimensionamento automático para otimização de desempenho.
ApsaraDB RDS for MySQL high availability series cloud disk edition. Para introdução ao recurso e informações de cobrança, consulte dimensionamento automático para otimização de desempenho.
-
Você pode modificar o recurso de expansão automática de armazenamento para as seguintes instâncias de banco de dados:
Instância do ApsaraDB RDS for MySQL high availability series cloud disk edition. Para introdução ao recurso e informações de cobrança, consulte expansão automática de espaço.
-
Você pode modificar o recurso de dimensionamento elástico de largura de banda para as seguintes instâncias de banco de dados:
Instâncias clássicas (anteriormente disco local) do Tair (Redis® OSS-Compatible). Para introdução ao recurso e informações de cobrança, consulte Ajuste automático de largura de banda.
-
Você pode modificar o recurso de dimensionamento elástico de recursos para as seguintes instâncias de banco de dados:
RDS Enterprise Edition (uso geral). Para introdução ao recurso e informações de cobrança, consulte dimensionamento automático para otimização de desempenho.
-
Use a versão mais recente do SDK do Alibaba Cloud ou do DAS.
-
Ao usar o SDK para chamar o DAS, defina a região como cn-shanghai.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
hdm:ModifyAutoScalingConfig |
update |
*All resources.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| InstanceId |
string |
Sim |
O ID da instância. |
rm-2ze8g2am97624**** |
| Spec |
object |
Não |
Os itens de configuração para o recurso de dimensionamento elástico de especificações. |
|
| Apply |
boolean |
Não |
Especifica se as configurações sob o item de configuração Spec devem ser aplicadas para o recurso de dimensionamento elástico de especificações:
|
true |
| Upgrade |
boolean |
Não |
Especifica se o scale-up automático de especificações deve ser ativado:
|
true |
| CpuUsageUpperThreshold |
integer |
Não |
O limite de utilização média da CPU que aciona o scale-up automático de especificações. Unidade: %. Valores válidos:
Importante Você deve definir este parâmetro quando a instância de banco de dados de destino for o PolarDB for MySQL Cluster Edition ou o ApsaraDB RDS for MySQL high availability series cloud disk edition.
Valores válidos:
|
70 |
| MemUsageUpperThreshold |
integer |
Não |
O limite de utilização média de memória que aciona o scale-up automático de especificações. Unidade: %. Valores válidos:
Importante Você deve definir este parâmetro quando a instância de banco de dados de destino for a edição de código aberto cloud-native (anteriormente disco em nuvem) do Tair (Redis® OSS-Compatible) no site da China.
Valores válidos:
|
70 |
| MaxSpec |
string |
Não |
O limite superior da especificação para scale-up automático. Você só pode fazer scale-up para uma especificação superior dentro da mesma série da instância de banco de dados. Para mais detalhes, consulte a documentação de especificações de cada instância de banco de dados:
|
polar.mysql.x8.12xlarge |
| MaxReadOnlyNodes |
integer |
Não |
O número máximo de nós somente leitura para a instância. Importante Você deve definir este parâmetro quando a instância de banco de dados de destino for o PolarDB for MySQL Cluster Edition.
|
10 |
| ObservationWindowSize |
string |
Não |
A janela de observação. O valor do parâmetro consiste em um número e um sufixo de unidade de tempo. As instâncias de banco de dados suportadas e os valores válidos são os seguintes. O sufixo de tempo m indica minutos e h indica horas:
|
5m |
| CoolDownTime |
string |
Não |
O período de resfriamento. O valor do parâmetro consiste em um número e um sufixo de unidade de tempo. As instâncias de banco de dados suportadas e os valores válidos são os seguintes. O sufixo de tempo m indica minutos, h indica horas e d indica dias:
|
5m |
| Downgrade |
boolean |
Não |
Especifica se o scale-down automático de especificações está ativado:
Importante Você deve definir este parâmetro quando a instância de banco de dados de destino for o PolarDB for MySQL Cluster Edition ou o ApsaraDB RDS for MySQL high availability series cloud disk edition.
|
true |
| Storage |
object |
Não |
Os itens de configuração para o recurso de expansão automática de armazenamento. |
|
| Apply |
boolean |
Não |
Especifica se as configurações sob o item de configuração Storage devem ser aplicadas para o recurso de expansão automática de armazenamento:
|
true |
| Upgrade |
boolean |
Não |
Especifica se a expansão automática de armazenamento deve ser ativada:
|
true |
| DiskUsageUpperThreshold |
integer |
Não |
O limite de utilização média do espaço de armazenamento que aciona a expansão automática de armazenamento. Unidade: %. Valores válidos:
Valores válidos:
|
70 |
| MaxStorage |
integer |
Não |
O limite superior do espaço de armazenamento. O valor deve ser maior ou igual ao espaço total de armazenamento atual da instância. Valores válidos:
Nota
Os SSDs padrão foram descontinuados. Faça upgrade para discos em nuvem ESSD. |
32000 |
| Bandwidth |
object |
Não |
Os itens de configuração para o recurso de dimensionamento elástico de largura de banda. |
|
| Apply |
boolean |
Não |
Especifica se as configurações sob o item de configuração Bandwidth devem ser aplicadas para o recurso de dimensionamento elástico de largura de banda:
|
true |
| Upgrade |
boolean |
Não |
Especifica se o upgrade automático de largura de banda deve ser ativado:
|
true |
| BandwidthUsageUpperThreshold |
integer |
Não |
O limite de uso médio de largura de banda que aciona o upgrade automático de largura de banda. Unidade: %. Valores válidos:
|
70 |
| ObservationWindowSize |
string |
Não |
A janela de observação para o upgrade automático de largura de banda. O valor do parâmetro consiste em um número e um sufixo de unidade de tempo. O sufixo de tempo m indica minutos. Valores válidos:
Valores válidos:
|
5m |
| Downgrade |
boolean |
Não |
Especifica se o downgrade automático de largura de banda deve ser ativado:
|
true |
| BandwidthUsageLowerThreshold |
integer |
Não |
O limite de uso médio de largura de banda que aciona o downgrade automático de largura de banda. Unidade: %. Valores válidos:
|
30 |
| Shard |
object |
Não |
Os itens de configuração para o recurso de dimensionamento elástico de fragmentos. |
|
| Apply |
boolean |
Não |
Especifica se as configurações sob o item de configuração Shard devem ser aplicadas para o recurso de dimensionamento elástico de fragmentos:
Importante O recurso de dimensionamento elástico de fragmentos é suportado apenas quando a instância de banco de dados de destino é a edição cloud-native (anteriormente disco em nuvem) do Tair (Redis® OSS-Compatible) em arquitetura de cluster no site da China.
|
true |
| Upgrade |
boolean |
Não |
Especifica se a adição automática de fragmentos deve ser ativada:
|
true |
| MemUsageUpperThreshold |
integer |
Não |
O limite de utilização média de memória que aciona a adição automática de fragmentos. Unidade: %. Valores válidos:
Valores válidos:
|
70 |
| MaxShards |
integer |
Não |
O número total máximo de fragmentos para a instância. O valor deve ser um número inteiro positivo. Valores válidos: 4 a 32. |
16 |
| UpgradeObservationWindowSize |
string |
Não |
A janela de observação para a adição automática de fragmentos. O valor do parâmetro consiste em um número e um sufixo de unidade de tempo. O sufixo de tempo m indica minutos. Valores válidos:
Valores válidos:
|
5m |
| Downgrade |
boolean |
Não |
Especifica se a redução automática de fragmentos deve ser ativada:
Nota
O recurso de redução automática de fragmentos está atualmente em versão canary. |
true |
| MemUsageLowerThreshold |
integer |
Não |
O limite de utilização média de memória que aciona a redução automática de fragmentos. Unidade: %. Valores válidos:
Valores válidos:
|
30 |
| MinShards |
integer |
Não |
O número total mínimo de fragmentos para a instância. O valor deve ser um número inteiro positivo. Valores válidos: 4 a 32. |
4 |
| DowngradeObservationWindowSize |
string |
Não |
A janela de observação para a redução automática de fragmentos. O valor do parâmetro consiste em um número e um sufixo de unidade de tempo. O sufixo de tempo h indica horas e d indica dias. Valores válidos:
Valores válidos:
|
1h |
| Resource |
object |
Não |
Os itens de configuração para o recurso de dimensionamento elástico de recursos. |
|
| Apply |
boolean |
Não |
Especifica se as configurações sob o item de configuração Resource devem ser aplicadas para o recurso de dimensionamento elástico de recursos:
|
true |
| Enable |
boolean |
Não |
Especifica se o dimensionamento elástico de recursos deve ser ativado:
|
true |
| CpuUsageUpperThreshold |
integer |
Não |
O limite de utilização média da CPU que aciona o scale-up automático de recursos. Unidade: %. Valores válidos:
Valores válidos:
|
70 |
| UpgradeObservationWindowSize |
string |
Não |
A janela de observação para scale-up. O valor do parâmetro consiste em um número e um sufixo de unidade de tempo. O sufixo de tempo m indica minutos. Valores válidos:
Valores válidos:
|
5m |
| DowngradeObservationWindowSize |
string |
Não |
A janela de observação para scale-down. O valor do parâmetro consiste em um número e um sufixo de unidade de tempo. O sufixo de tempo m indica minutos. Valores válidos:
Valores válidos:
|
5m |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| Code |
string |
O código de status retornado. |
200 |
| Message |
string |
A mensagem retornada. Nota
Se a solicitação for bem-sucedida, Successful será retornado. Se a solicitação falhar, uma mensagem de erro, como um código de erro, será retornada. |
Successful |
| RequestId |
string |
O ID da solicitação. |
B6D17591-B48B-4D31-9CD6-9B9796B2**** |
| Success |
string |
Indica se a solicitação foi bem-sucedida:
|
true |
Exemplos
Resposta de sucesso
JSON formato
{
"Code": "200",
"Message": "Successful",
"RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
"Success": "true"
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | Os parâmetros da solicitação são inválidos. |
| 403 | NoPermission | You are not authorized to do this action. | Você não tem permissão para realizar esta operação. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.