Todos os produtos
Search
Central de documentação

Database Autonomy Service:ModifyAutoScalingConfig

Última atualização: Jun 28, 2026

Modifica as configurações de auto scaling de uma instância.

Descrição da operação

Modifica as seguintes configurações de auto scaling para uma instância: auto scaling para especificações, expansão automática de armazenamento, ajuste automático de largura de banda e auto scaling para recursos.

  • Você pode modificar as configurações do recurso de auto scaling para especificações para os seguintes tipos de instâncias de banco de dados:

    • Instâncias do PolarDB for MySQL Cluster Edition. Para obter mais informações sobre o recurso e as regras de cobrança, consulte Escalabilidade automática de desempenho.

    • Instâncias do ApsaraDB RDS for MySQL High-availability Edition que usam SSDs padrão ou SSDs aprimorados (ESSDs). Para obter mais informações sobre o recurso e as regras de cobrança, consulte Escalabilidade automática de desempenho.

  • Você pode modificar as configurações do recurso de expansão automática de armazenamento para os seguintes tipos de instâncias de banco de dados:

    • Instâncias do ApsaraDB RDS for MySQL High-availability Edition que usam SSDs padrão ou ESSDs. Para obter mais informações sobre o recurso e as regras de cobrança, consulte Expansão automática de espaço.

  • Você pode modificar as configurações do recurso de ajuste automático de largura de banda para os seguintes tipos de instâncias de banco de dados:

    • Instâncias do ApsaraDB for Redis Classic (Local Disk-based) Edition. Para obter mais informações sobre o recurso e as regras de cobrança, consulte Ajuste automático de largura de banda.

  • Você pode modificar as configurações do recurso de auto scaling para recursos para os seguintes tipos de instâncias de banco de dados:

  • Se você usar um SDK do Alibaba Cloud ou um SDK do Database Autonomy Service (DAS) para chamar esta operação, recomendamos que use a versão mais recente do SDK.

  • Se você usar um SDK para chamar operações do DAS, deverá definir o ID da região como cn-shanghai.

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

hdm:ModifyAutoScalingConfig

update

*All Resource

*

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

O item de configuração do recurso de auto scaling de especificações.

Apply

boolean

Não

Especifica se a configuração Spec do recurso de auto scaling de especificações deve ser aplicada. Valores válidos:

  • true

  • false

true

Upgrade

boolean

Não

Especifica se o scale-up automático de especificações deve ser ativado. Valores válidos:

  • true

  • false

true

CpuUsageUpperThreshold

integer

Não

O limite médio de utilização de CPU que aciona o scale-up automático de especificações. Unidade: %. Valores válidos:

  • 50

  • 60

  • 70

  • 80

  • 90

Nota

Este parâmetro deve ser especificado se a instância de banco de dados for uma instância do PolarDB for MySQL Cluster Edition ou uma instância do ApsaraDB RDS for MySQL High-availability Edition que usa SSDs padrão ou ESSDs.

70

MemUsageUpperThreshold

integer

Não

O limite médio de uso de memória que aciona o scale-up automático de especificações. Unidade: %. Valores válidos:

  • 50

  • 60

  • 70

  • 80

  • 90

Nota

Este parâmetro deve ser especificado se a instância de banco de dados for uma instância cloud-native do Tair (compatível com Redis OSS) Community Edition no site da China (aliyun.com).

70

MaxSpec

string

Não

As especificações máximas para as quais a instância de banco de dados pode sofrer scale-up. A instância de banco de dados só pode ser atualizada para uma instância de banco de dados da mesma edição com especificações superiores. Para obter informações sobre as especificações de diferentes instâncias de banco de dados, consulte os seguintes tópicos:

polar.mysql.x8.12xlarge

MaxReadOnlyNodes

integer

Não

O número máximo de nós somente leitura da instância.

Nota

Este parâmetro deve ser especificado se a instância de banco de dados for uma instância do PolarDB for MySQL Cluster Edition.

10

ObservationWindowSize

string

Não

A janela de observação. O valor deste parâmetro consiste em um valor numérico e um sufixo de unidade de tempo. O sufixo de unidade de tempo m especifica o minuto e o sufixo de unidade de tempo h especifica a hora.

  • Valores válidos para instâncias do PolarDB for MySQL Cluster Edition: 5m, 10m, 15m e 30m.

  • Valores válidos para instâncias do ApsaraDB RDS for MySQL High-availability Edition que usam SSDs padrão ou ESSDs: 5m, 20m, 30m, 40m e 1h.

  • Valores válidos para instâncias cloud-native do Tair (compatível com Redis OSS) Community Edition: 5m, 10m, 15m e 30m.

5m

CoolDownTime

string

Não

O período de inatividade. O valor deste parâmetro consiste em um valor numérico e um sufixo de unidade de tempo. O sufixo de unidade de tempo m especifica o minuto, o sufixo de unidade de tempo h especifica a hora e o sufixo de unidade de tempo d especifica o dia.

  • Valores válidos para instâncias do PolarDB for MySQL Cluster Edition: 5m, 10m, 30m, 1h, 2h, 3h, 1d e 7d.

  • Valores válidos para instâncias do ApsaraDB RDS for MySQL High-availability Edition que usam SSDs padrão ou Enterprise SSDs (ESSDs): 5m, 10m, 30m, 1h, 2h, 3h, 1d e 7d.

5m

Downgrade

boolean

Não

Especifica se o scale-down automático de especificações deve ser ativado. Valores válidos:

  • true

  • false

Nota

Este parâmetro deve ser especificado se a instância de banco de dados for uma instância do PolarDB for MySQL Cluster Edition ou uma instância do ApsaraDB RDS for MySQL High-availability Edition que usa SSDs padrão ou ESSDs.

true

Storage

object

Não

O item de configuração do recurso de expansão automática de armazenamento.

Apply

boolean

Não

Especifica se a configuração Storage do recurso de expansão automática de armazenamento deve ser aplicada. Valores válidos:

  • true

  • false

true

Upgrade

boolean

Não

Especifica se a expansão automática de armazenamento deve ser ativada. Valores válidos:

  • true

  • false

true

DiskUsageUpperThreshold

integer

Não

O limite médio de uso de armazenamento que aciona a expansão automática de armazenamento. Unidade: %. Valores válidos:

  • 50

  • 60

  • 70

  • 80

  • 90

70

MaxStorage

integer

Não

O tamanho máximo de armazenamento da instância de banco de dados. Unidade: GB. O valor deve ser maior ou igual ao tamanho total de armazenamento da instância.

  • Se a instância usar ESSDs, o valor máximo deste parâmetro pode ser 32000.

  • Se a instância usar SSDs padrão, o valor máximo deste parâmetro pode ser 6000.

Nota

O tipo de armazenamento SSD padrão foi descontinuado. Recomendamos que você atualize o tipo de armazenamento da sua instância de SSDs padrão para ESSDs.

32000

Bandwidth

object

Não

O item de configuração do recurso de auto scaling de largura de banda.

Apply

boolean

Não

Especifica se a configuração Bandwidth do recurso de auto scaling de largura de banda deve ser aplicada. Valores válidos:

  • true

  • false

true

Upgrade

boolean

Não

Especifica se o upgrade automático de largura de banda deve ser ativado. Valores válidos:

  • true

  • false

true

BandwidthUsageUpperThreshold

integer

Não

O limite médio de uso de largura de banda que aciona o upgrade automático de largura de banda. Unidade: %. Valores válidos:

  • 50

  • 60

  • 70

  • 80

  • 90

  • 95

70

ObservationWindowSize

string

Não

A janela de observação do recurso de auto scaling de largura de banda. O valor deste parâmetro consiste em um valor numérico e um sufixo de unidade de tempo. O sufixo de unidade de tempo m especifica o minuto. Valores válidos:

  • 1m

  • 5m

  • 10m

  • 15m

  • 30m

5m

Downgrade

boolean

Não

Especifica se o downgrade automático de largura de banda deve ser ativado. Valores válidos:

  • true

  • false

true

BandwidthUsageLowerThreshold

integer

Não

O limite médio de uso de largura de banda que aciona o downgrade automático de largura de banda. Unidade: %. Valores válidos:

  • 10

  • 20

  • 30

30

Shard

object

Não

O item de configuração do recurso de auto scaling de shards.

Apply

boolean

Não

Especifica se a configuração Shard do recurso de auto scaling de shards deve ser aplicada. Valores válidos:

  • true

  • false

Nota

O recurso de auto scaling de shards está disponível apenas para instâncias de cluster cloud-native do Tair (compatível com Redis OSS) no site da China (aliyun.com).

true

Upgrade

boolean

Não

Especifica se a adição automática de shards deve ser ativada. Valores válidos:

  • true

  • false

true

MemUsageUpperThreshold

integer

Não

O limite médio de uso de memória que aciona a adição automática de shards. Unidade: %. Valores válidos:

  • 50

  • 60

  • 70

  • 80

  • 90

70

MaxShards

integer

Não

O número máximo de shards na 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 do recurso de adição automática de shards. O valor deste parâmetro consiste em um valor numérico e um sufixo de unidade de tempo. O sufixo de unidade de tempo m especifica o minuto. Valores válidos:

  • 5m

  • 10m

  • 15m

  • 30m

5m

Downgrade

boolean

Não

Especifica se a remoção automática de shards deve ser ativada. Valores válidos:

  • true

  • false

Nota

O recurso de remoção automática de shards está em versão canary.

true

MemUsageLowerThreshold

integer

Não

O limite médio de uso de memória que aciona a remoção automática de shards. Unidade: %. Valores válidos:

  • 10

  • 20

  • 30

30

MinShards

integer

Não

O número mínimo de shards na 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 do recurso de remoção automática de shards. O valor deste parâmetro consiste em um valor numérico e um sufixo de unidade de tempo. O sufixo de unidade de tempo h especifica a hora. O sufixo de unidade de tempo d especifica o dia. Valores válidos:

  • 1h

  • 2h

  • 3h

  • 1d

  • 7d

1h

Resource

object

Não

O item de configuração do recurso de auto scaling de recursos.

Apply

boolean

Não

Especifica se a configuração Resource do recurso de auto scaling de recursos deve ser aplicada. Valores válidos:

  • true

  • false

true

Enable

boolean

Não

Especifica se o auto scaling de recursos deve ser ativado. Valores válidos:

  • true

  • false

true

CpuUsageUpperThreshold

integer

Não

O limite médio de utilização de CPU que aciona o scale-out automático de recursos. Unidade: %. Valores válidos:

  • 70

  • 80

  • 90

70

UpgradeObservationWindowSize

string

Não

A janela de observação do recurso de scale-out automático de recursos. O valor deste parâmetro consiste em um valor numérico e um sufixo de unidade de tempo. O sufixo de unidade de tempo m especifica o minuto. Valores válidos:

  • 1m

  • 3m

  • 5m

  • 10m

  • 20m

  • 30m

Valores válidos:

  • 30m :

    30m

  • 5m :

    5m

  • 3m :

    3m

  • 1m :

    1m

  • 10m :

    10m

  • 20m :

    20m

5m

DowngradeObservationWindowSize

string

Não

A janela de observação do recurso de scale-in automático de recursos. O valor deste parâmetro consiste em um valor numérico e um sufixo de unidade de tempo. O sufixo de unidade de tempo m especifica o minuto. Valores válidos:

  • 1m

  • 3m

  • 5m

  • 10m

  • 20m

  • 30m

5m

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

Code

string

O código de status HTTP 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. Valores válidos:

  • true

  • false

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.
403 NoPermission You are not authorized to do this action.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.