Todos os produtos
Search
Central de documentação

:CreateNode

Última atualização: Jul 08, 2026

Adiciona um shard ou nó mongos a uma instância de cluster sharded do ApsaraDB for MongoDB.

Antes de chamar esta operação, compreenda totalmente os métodos de faturamento e a precificação do ApsaraDB for MongoDB.

Esta operação aplica-se apenas a instâncias de cluster sharded.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateNode

Operação a ser executada. Defina o valor como CreateNode.

DBInstanceId String Sim dds-bp11501cd7b5****

ID da instância de cluster sharded.

NodeClass String Sim dds.shard.mid

Especificações do shard ou nó mongos. Para mais informações, consulte Tipos de instância.

NodeStorage Integer Não 10

Capacidade de disco do nó. Unidade: GB.

Valores válidos: 10 a 2000. O valor deve ser múltiplo de 10. Unidade: GB.

Nota Parâmetro obrigatório se NodeType estiver definido como shard.
NodeType String Sim shard

Tipo do nó. Valores válidos:

  • shard: nó shard
  • mongos: nó mongos
ClientToken String Não ETnLKlblzczshOTUbOCz****

Token de cliente usado para garantir a idempotência da solicitação. Gere o valor pelo cliente, mas garanta que seja exclusivo entre solicitações diferentes. O token aceita apenas caracteres ASCII e limita-se a 64 caracteres.

AutoPay Boolean Não true

Defina se o pagamento automático estará ativado. Valor padrão: true. Valores válidos:

  • true: ative o pagamento automático. Garanta saldo suficiente na conta.
  • false: desativa o pagamento automático. Para pagar pela instância, siga estes passos: faça login no console do ApsaraDB for MongoDB. No canto superior direito da página, escolha Expenses > Orders. Na página Orders, localize o pedido e conclua o pagamento.
Nota Parâmetro obrigatório quando o método de faturamento da instância é assinatura.
ReadonlyReplicas Integer Não 5

Número de nós somente leitura no nó shard.

Valores válidos: 0 a 5. O valor deve ser inteiro. Valor padrão: 0.

Nota Disponível apenas para instâncias do ApsaraDB for MongoDB adquiridas no site da China (aliyun.com).
BusinessInfo String Não {“ActivityId":"000000000"}

Informações comerciais. Trata-se de um parâmetro adicional.

CouponNo String Não youhuiquan_promotion_option_id_for_blank

Código do cupom. Valor padrão: youhuiquan_promotion_option_id_for_blank.

ShardDirect Boolean Não false

Defina se haverá solicitação de endpoint para o nó shard. Valor padrão: false. Valores válidos:

  • true: solicita um endpoint para o nó shard.
  • false : não solicita endpoint para o nó shard.
AccountName String Não ceshi

Nome de usuário da conta. Deve atender aos seguintes requisitos:

  • Iniciar com letra minúscula.
  • Conter letras minúsculas, dígitos e sublinhados (_).
  • Ter de 4 a 16 caracteres.
Nota
  • Palavras-chave não são permitidas como nomes de usuário.
  • As permissões desta conta são fixas como somente leitura.
  • Defina o nome de usuário e a senha apenas ao solicitar um endpoint para o nó shard pela primeira vez.
AccountPassword String Não 123+abc

Senha da conta. Deve atender aos seguintes requisitos:

  • Conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais específicos.
  • Caracteres especiais permitidos: ! @ # $ % ^ & * ( ) _ + - =
  • Ter de 8 a 32 caracteres.
Nota Não é possível redefinir a senha da conta do nó shard.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

7D48FB19-20CA-4725-A870-3D8F5CE6****

ID da solicitação.

NodeId

String

d-bp1b234bf7a4****

ID do nó.

OrderId

String

20951063702****

ID do pedido.

Exemplos

Exemplos de solicitações

http(s)://mongodb.aliyuncs.com/?Action=CreateNode
&DBInstanceId=dds-bp11501cd7b5****
&NodeClass=dds.shard.mid
&NodeStorage=10
&NodeType=shard
&ClientToken=ETnLKlblzczshOTUbOCz****
&FromApp=mongo_buy
&AutoPay=true
&ReadonlyReplicas=5
&BusinessInfo={"ActivityId":"000000000"}
&CouponNo=youhuiquan_promotion_option_id_for_blank
&<Common request parameters>

Exemplos de respostas

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateNodeResponse>
    <RequestId>7D48FB19-20CA-4725-A870-3D8F5CE6****</RequestId>
    <NodeId>d-bp1b234bf7a4****</NodeId>
    <OrderId>20951063702****</OrderId>
</CreateNodeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7D48FB19-20CA-4725-A870-3D8F5CE6****",
  "NodeId" : "d-bp1b234bf7a4****",
  "OrderId" : "20951063702****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.