Todos os produtos
Search
Central de documentação

Tair (Redis® OSS-Compatible):ModifyInstanceSpec

Última atualização: Jun 29, 2026

Altera as configurações de uma instância Tair (compatível com Redis OSS).

Descrição da operação

Nota

Para obter mais informações sobre o procedimento, os impactos, os limites e as taxas desta operação, consulte Alterar as configurações de uma instância.

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

kvstore:ModifyInstanceSpec

update

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Não

O ID da região. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

InstanceId

string

Sim

O ID da instância. Você pode chamar a operação DescribeInstances para consultar o ID da instância.

r-bp1zxszhcgatnx****

InstanceClass

string

Não

O novo tipo de instância. Você pode chamar a operação DescribeAvailableResource para consultar os tipos de instância disponíveis para alteração de configuração na zona à qual a instância pertence.

Nota

Para obter mais informações sobre os tipos de instância, consulte Visão geral.

redis.master.small.default

BusinessInfo

string

Não

O ID do evento promocional ou as informações comerciais.

000000001

CouponNo

string

Não

O código do cupom. Valor padrão: youhuiquan_promotion_option_id_for_blank.

youhuiquan_promotion_option_id_for_blank

ForceUpgrade

boolean

Não

Especifica se deve forçar a alteração das configurações. Valores válidos:

  • false: O sistema não força a alteração das configurações.

  • true (padrão): O sistema força a alteração das configurações.

true

EffectiveTime

string

Não

O horário em que você deseja que as configurações sejam alteradas. Valores válidos:

  • Immediately (padrão): altera as configurações imediatamente.

  • MaintainTime: altera as configurações dentro da janela de manutenção. Você pode chamar a operação ModifyInstanceMaintainTime para alterar a janela de manutenção.

Immediately

AutoPay

boolean

Não

Especifica se o pagamento automático deve ser ativado. Valores válidos:

  • true (padrão): ativa o pagamento automático.

  • false: desativa o pagamento automático. Se você definir este parâmetro como false, a instância deverá ser renovada manualmente antes de expirar. Para obter mais informações, consulte Renovar uma instância.

true

OrderType

string

Não

O tipo de alteração. Este parâmetro é obrigatório quando você altera as configurações de uma instância por assinatura. Valores válidos:

  • UPGRADE (padrão): faz upgrade das configurações da instância por assinatura.

  • DOWNGRADE: faz downgrade das configurações da instância por assinatura.

Nota
  • Para fazer downgrade de uma instância por assinatura, você deve definir este parâmetro como DOWNGRADE.

  • Se o preço de uma instância aumentar após a alteração de suas configurações, a instância sofrerá upgrade. Se o preço diminuir, a instância sofrerá downgrade. Por exemplo, o preço de uma instância de divisão de leitura/gravação de 8 GB com cinco réplicas de leitura é maior que o de uma instância de cluster de 16 GB. Se você quiser alterar uma instância de cluster de 16 GB para uma instância de divisão de leitura/gravação de 8 GB com cinco réplicas de leitura, deverá fazer upgrade da instância.

Valores válidos:

  • DOWNGRADE :

    DOWNGRADE.

  • UPGRADE :

    UPGRADE.

DOWNGRADE

MajorVersion

string

Não

A versão principal da instância clássica que você deseja atualizar. Valores válidos: 2.8, 4.0 e 5.0.

Nota

O parâmetro InstanceClass é obrigatório quando você atualiza a versão da instância. Este parâmetro indica que você pode atualizar a versão da instância apenas ao atualizar as especificações da instância. Se você precisar apenas atualizar a versão da instância, chame a operação ModifyInstanceMajorVersion.

5.0

ClientToken

string

Não

O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.

ETnLKlblzczshOTUbOCz****

SourceBiz

string

Não

A origem da operação. Este parâmetro é usado apenas para manutenção interna. Você não precisa especificar este parâmetro.

SDK

ShardCount

integer

Não

O número de shards. Este parâmetro é aplicável apenas a instâncias de cluster nativas da nuvem.

Nota
  • Se você quiser alterar uma instância de cluster nativa da nuvem para uma instância padrão, deverá definir explicitamente o parâmetro ShardCount como 1 e especificar as especificações da instância mestre-réplica.

  • Para alterar uma instância padrão nativa da nuvem para uma instância de cluster, você deve definir explicitamente o parâmetro ShardCount com um valor maior que 1 e especificar as especificações da instância de cluster.

8

ReplicaCount

integer

Não

O número de nós de réplica na zona primária. Este parâmetro é aplicável apenas a instâncias de cluster de múltiplas réplicas nativas da nuvem. Valores válidos: 1 a 4.

Nota
  • A soma dos valores deste parâmetro e do parâmetro SlaveReplicaCount não pode ser maior que 4.

  • Você pode especificar ReplicaCount ou ReadOnlyCount.

  • Uma instância mestre-réplica não pode conter vários nós de réplica.

1

SlaveReplicaCount

integer

Não

O número de nós de réplica na zona secundária ao criar uma instância de cluster de múltiplas réplicas nativa da nuvem implantada em várias zonas. A soma dos valores deste parâmetro e do parâmetro ReplicaCount não pode ser maior que 4.

Nota

Ao criar uma instância de cluster de múltiplas réplicas nativa da nuvem implantada em várias zonas, você deve especificar tanto SlaveReplicaCount quanto SecondaryZoneId.

1

ReadOnlyCount

integer

Não

O número de réplicas de leitura na zona primária. Valores válidos: 0 a 5. Este parâmetro se aplica apenas aos seguintes cenários:

  • Se a instância for uma instância padrão nativa da nuvem, você pode definir este parâmetro com um valor maior que 0 para ativar a arquitetura de divisão de leitura/gravação.

  • Se a instância for uma instância de divisão de leitura/gravação nativa da nuvem, você pode usar este parâmetro para personalizar o número de réplicas de leitura. Você também pode definir este parâmetro como 0 para desativar a arquitetura de divisão de leitura/gravação e alternar a instância para a arquitetura padrão.

5

SlaveReadOnlyCount

integer

Não

O número de réplicas de leitura na zona secundária ao criar uma instância de divisão de leitura/gravação implantada em várias zonas. Valores válidos: 1 a 9. A soma dos valores deste parâmetro e do parâmetro ReadOnlyCount não pode ser maior que 9.

2

ForceTrans

boolean

Não

Especifica se a transmissão forçada deve ser ativada durante uma alteração de configuração. Valores válidos:

  • false (padrão): Antes da alteração de configuração, o sistema verifica a versão secundária da instância. Se a versão secundária da instância estiver desatualizada, um erro será relatado. Você deve atualizar a versão secundária da instância e tentar novamente.

  • true: O sistema ignora a verificação de versão e executa diretamente a alteração de configuração.

false

NodeType

string

Não

O tipo do nó. Valores válidos:

  • MASTER_SLAVE: alta disponibilidade (mestre-réplica)

  • STAND_ALONE: standalone

  • double: mestre-réplica

  • single: standalone

Nota

Para criar uma instância nativa da nuvem, defina este parâmetro como MASTER_SLAVE ou STAND_ALONE. Para criar uma instância clássica, defina este parâmetro como double ou single.

MASTER_SLAVE

StorageType

string

Não

O tipo de armazenamento. Valores válidos: essd_pl1, essd_pl2 e essd_pl3.

Nota

Este parâmetro é obrigatório apenas quando você define o parâmetro InstanceType como tair_essd para criar uma instância baseada em ESSD.

essd_pl1

Storage

integer

Não

A capacidade de armazenamento da instância baseada em ESSD/SSD. Os valores válidos variam de acordo com o tipo de instância. Para obter mais informações, consulte Instâncias baseadas em ESSD/SSD.

Nota

Este parâmetro é obrigatório apenas quando você define o parâmetro InstanceType como tair_essd para criar uma instância baseada em ESSD. Se você criar uma instância Tair baseada em SSD, o parâmetro Storage será especificado automaticamente com base em especificações predefinidas. Você não precisa especificar este parâmetro.

60

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

OrderId

string

O ID do pedido.

20722623431****

RequestId

string

O ID da solicitação.

0DA1D7EF-C80D-432C-8758-7D225182626B

Exemplos

Resposta de sucesso

JSON formato

{
  "OrderId": "20722623431****",
  "RequestId": "0DA1D7EF-C80D-432C-8758-7D225182626B"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 PaymentMethodNotFound No payment method has been registered on the account.
400 HasRenewChangeOrder This instance has a renewChange order.
400 %s Warn: {%s} are not supported after upgraded. you can set forceUpgrade=true to force upgrade.
400 GdcInstanceNotSupport The gdc custins trans not support.
400 AbnormalResourceStatusForRenew Abnormal resource status for renew.
400 MissingRedisShardingUnsupportPerfItem The metadb is missing redis sharding unsupoort command perf item.
400 IllegalParamError Action or resource must not be null.
400 IncorrectTargetMajorVersion Current target majorversion does not support this operation. the current operation does not support the specified target major version. make sure that the specified target major version is greater than the current major version of the instance.
400 IncorrectMinorVersion Current engine minor version does not support operations. The operation is not supported by the minor version of the instance. Update the instance to the latest minor version and try again.
400 DirectTargetLevelNotSupport The direct custins tranfer target instance level does not support.
400 DirectTransPreCheckError The direct custins trans pre check IsAddReduceNodes error.
400 DtsOpendNotSupportTrans The custins DtsSyncStatus opend does not support trans.
400 DirectTransNodeDoubleLevelError The direct custins tranfer node double target level error. When adjusting only the number of shards for directly connected instances and global multi-active instances, you need to specify 2 or 0.5 times the original number of shards.
400 DirectTransUpgradeMajorVersionNotSupport The direct custins tranfer does not support upgrade major version.
403 TargetMemoryLessThanCurrentUsed The target instance memory size below the current instance used memory.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.