Todos los productos
Search
Centro de documentos

:CreateNode

Última actualización: Sep 03, 2026

Agrega un nodo shard o mongos a una instancia de clúster fragmentado de ApsaraDB for MongoDB.

Antes de llamar a esta operación, asegúrese de comprender por completo los métodos de facturación y la facturación de ApsaraDB for MongoDB.

Esta operación solo aplica a instancias de clúster fragmentado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción
Action String Sí CreateNode

La operación que desea ejecutar. Establezca el valor en CreateNode.

DBInstanceId String Sí dds-bp11501cd7b5****

El ID de la instancia de clúster fragmentado.

NodeClass String Sí dds.shard.mid

Las especificaciones del nodo shard o mongos. Para obtener más información, consulte Tipos de instancia.

NodeStorage Integer No 10

La capacidad de disco del nodo. Unidad: GB.

Valores válidos: de 10 a 2000. El valor debe ser múltiplo de 10. Unidad: GB.

Nota Este parámetro es obligatorio si el parámetro NodeType está establecido en shard.
NodeType String Sí shard

El tipo de nodo. Valores válidos:

  • shard: nodo shard
  • mongos: nodo mongos
ClientToken String No ETnLKlblzczshOTUbOCz****

El token de cliente que garantiza la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero debe asegurarse de que sea único entre las distintas solicitudes. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud.

AutoPay Boolean No true

Especifica si se habilita el pago automático. Valor predeterminado: true. Valores válidos:

  • true: habilita el pago automático. Asegúrese de tener saldo suficiente en su cuenta.
  • false: deshabilita el pago automático. Para pagar la instancia, realice las siguientes operaciones: inicie sesión en la consola de ApsaraDB for MongoDB. En la esquina superior derecha de la página, elija Expenses > Orders. En la página Orders, busque el pedido y complete el pago.
Nota Este parámetro es obligatorio cuando el método de facturación de la instancia es suscripción.
ReadonlyReplicas Integer No 5

El número de nodos de solo lectura en el nodo shard.

Valores válidos: de 0 a 5. El valor debe ser un número entero. Valor predeterminado: 0.

Nota Este parámetro solo está disponible para instancias de ApsaraDB for MongoDB adquiridas en el sitio de China (aliyun.com).
BusinessInfo String No {“ActivityId":"000000000"}

La información comercial. Este es un parámetro adicional.

CouponNo String No youhuiquan_promotion_option_id_for_blank

El código de cupón. Valor predeterminado: youhuiquan_promotion_option_id_for_blank.

ShardDirect Boolean No false

Especifica si se solicita un endpoint para el nodo shard. Valor predeterminado: false. Valores válidos:

  • true: solicita un endpoint para el nodo shard.
  • false : no solicita un endpoint para el nodo shard.
AccountName String No ceshi

El nombre de usuario de la cuenta. Debe cumplir con los siguientes requisitos:

  • Comenzar con una letra minúscula.
  • Contener letras minúsculas, dígitos y guiones bajos (_).
  • Tener una longitud de 4 a 16 caracteres.
Nota
  • No se pueden utilizar palabras clave como nombres de usuario de cuenta.
  • Los permisos de esta cuenta son fijos de solo lectura.
  • El nombre de usuario y la contraseña solo deben configurarse cuando se solicita un endpoint para el nodo shard por primera vez.
AccountPassword String No 123+abc

La contraseña de la cuenta. Debe cumplir con los siguientes requisitos:

  • Contener como mínimo tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales específicos.
  • Los caracteres especiales incluyen ! @ # $ % ^ & * ( ) _ + - =
  • Tener una longitud de 8 a 32 caracteres.
Nota La contraseña de la cuenta del nodo shard no se puede restablecer.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

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

El ID de la solicitud.

NodeId

String

d-bp1b234bf7a4****

El ID del nodo.

OrderId

String

20951063702****

El ID del pedido.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas de ejemplo

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 error

Para obtener una lista de códigos de error, visite el Centro de errores de API.