Altera as configurações de uma instância Tair (compatível com Redis OSS).
Descrição da operação
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
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
kvstore:ModifyInstanceSpec |
update |
*DBInstance
|
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:
|
true |
| EffectiveTime |
string |
Não |
O horário em que você deseja que as configurações sejam alteradas. Valores válidos:
|
Immediately |
| AutoPay |
boolean |
Não |
Especifica se o pagamento automático deve ser ativado. Valores válidos:
|
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:
Nota
Valores válidos:
|
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
|
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
|
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:
|
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 |
| NodeType |
string |
Não |
O tipo do nó. Valores válidos:
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.