ModifyNodeSpecBatch - ApsaraDB for MongoDB: Central de Documentação do Alibaba Cloud

Altera a configuração de um ou mais nós Mongos ou shard em uma instância de cluster fragmentado do ApsaraDB for MongoDB.

Descrição da operação

Antes de chamar esta operação, certifique-se de que você compreende os métodos de cobrança e os preços do ApsaraDB for MongoDB.

Esta operação aplica-se apenas a instâncias de cluster fragmentado do ApsaraDB for MongoDB.

Ao fazer upgrade ou downgrade de várias instâncias de cluster fragmentado em lote, os tipos de instância de destino estão sujeitos a determinadas restrições. Por exemplo, se você expandir a capacidade de armazenamento, a capacidade de destino deve ser maior ou igual à capacidade atual. Se as instâncias tiverem tipos de instância diferentes, o sistema seleciona aleatoriamente o tipo de instância de uma instância e aplica suas restrições a todo o lote. Isso pode causar falha no upgrade ou downgrade. Se não for possível fazer upgrade ou downgrade de instâncias em lote, você pode usar a operação ModifyNodeSpec para alterar a configuração de uma única instância de cluster fragmentado.

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

dds:ModifyNodeSpecBatch

update

*Instance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

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
DBInstanceId	string	Sim	O ID da instância para a qual você deseja alterar as configurações.	dds-bp1337621e8f****
NodesInfo	string	Sim	Os tipos de instância dos nós Mongos e shard que você deseja alterar. Para mais informações, consulte Tipos de instância.	{"Shards":[{"DBInstanceClass":"dds.shard.mid","DBInstanceName":"d-bp14ae4572fd**","Storage":20},{"DBInstanceClass":"dds.shard.mid","DBInstanceName":"d-bp19f4f92dc5**","Storage":30}]}
ClientToken	string	Não	Um token de cliente. É usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que o valor seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.	ETnLKlblzczshOTUbOCz****
AutoPay	boolean	Não	Especifica se o pagamento automático deve ser ativado. Valores válidos: true: O pagamento automático é ativado. Certifique-se de que sua conta tenha saldo suficiente. false: O pagamento manual é ativado. Faça logon no console do ApsaraDB for MongoDB. No canto superior direito, escolha Expenses > Expenses and Costs. No painel de navegação à esquerda, clique em Order Management. Na página Product Orders, localize o pedido desejado e efetue o pagamento. Valor padrão: true.	true
EffectiveTime	string	Não	O período efetivo da alteração de configuração. Valores válidos: Immediately: A alteração entra em vigor imediatamente. MaintainTime: A alteração entra em vigor durante a janela de manutenção da instância. Nota Você pode chamar a operação ModifyDBInstanceMaintainTime para alterar a janela de manutenção de uma instância. Você pode chamar a operação DescribeDBInstanceAttribute para visualizar a janela de manutenção de uma instância. Valor padrão: Immediately.	Immediately
OrderType	string	Não	O tipo de alteração de configuração. Valores válidos: UPGRADE: Faz upgrade da configuração da instância. DOWNGRADE: Faz downgrade da configuração da instância. Nota Este parâmetro está disponível apenas quando o método de cobrança da instância é assinatura.	UPGRADE
CouponNo	string	Não	Especifica se um cupom deve ser usado. Valores válidos: default ou null (padrão): Um cupom é usado. youhuiquan_promotion_option_id_for_blank: Um cupom não é usado.	default
BusinessInfo	string	Não	As informações comerciais.	{“ActivityId":"000000000"}
TargetVswitchId	string	Não	O ID do virtual switch de destino para uma alteração de configuração que envolve migração de zona. Importante Este parâmetro aplica-se apenas a instâncias que usam discos. Nota Este parâmetro é obrigatório apenas para uma alteração de configuração que envolve migração de zona.	vsw-xxxxxxxx
TargetHiddenZoneId	string	Não	A zona de destino do nó oculto para uma alteração de configuração que envolve migração de zona. Importante Este parâmetro aplica-se apenas a instâncias que usam discos. Importante O valor deste parâmetro não pode ser igual ao valor do parâmetro TargetZoneId ou TargetSecondaryZoneId. Nota Este parâmetro é obrigatório apenas para uma alteração de configuração que envolve migração de zona.	cn-hangzhou-e
TargetZoneId	string	Não	A zona de destino do nó primário para uma alteração de configuração que envolve migração de zona. Importante Este parâmetro aplica-se apenas a instâncias que usam discos. Importante O valor deste parâmetro não pode ser igual ao valor do parâmetro TargetSecondaryZoneId ou TargetHiddenZoneId. Nota Este parâmetro é obrigatório apenas para uma alteração de configuração que envolve migração de zona.	cn-hangzhou-h
TargetSecondaryZoneId	string	Não	A zona de destino do nó secundário para uma alteração de configuração que envolve migração de zona. Importante Este parâmetro aplica-se apenas a instâncias que usam discos. Importante O valor deste parâmetro não pode ser igual ao valor do parâmetro TargetZoneId ou TargetHiddenZoneId. Nota Este parâmetro é obrigatório apenas para uma alteração de configuração que envolve migração de zona.	cn-hangzhou-j

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
OrderId	string	O ID do pedido.	21012719476****
RequestId	string	O ID da solicitação.	0637BC25-6895-5500-871F-1127CA34****

Exemplos

Resposta de sucesso

JSON formato

{
  "OrderId": "21012719476****",
  "RequestId": "0637BC25-6895-5500-871F-1127CA34****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	GadInstanceNotSupport	GAD Instance doesn't support the operation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.