CreateNode - ApsaraDB for MongoDB - Centro de documentación de Alibaba Cloud

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

Descripción de la operación

Antes de llamar a esta operación, asegúrese de estar familiarizado con los métodos de facturación y los precios de ApsaraDB for MongoDB.

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

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dds:CreateNode

create

*dbinstance

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DBInstanceId	string	Sí	El ID de la instancia de clúster fragmentado.	dds-bp11501cd7b5****
NodeClass	string	Sí	El tipo de instancia del nodo shard o mongos. Para obtener más información, consulte Tipos de instancias de clúster fragmentado.	dds.shard.mid
NodeStorage	integer	No	El espacio de almacenamiento del nodo. Unidad: GB. Los valores válidos de este parámetro varían según el tipo de almacenamiento de la instancia. Para obtener más información, consulte Tipos de instancias de clúster fragmentado. Nota Este parámetro es obligatorio cuando el tipo de nodo es shard.	20
NodeType	string	Sí	El tipo de nodo. Valores válidos: shard: Un nodo shard. mongos: Un nodo mongos.	shard
ClientToken	string	No	Un token generado por el cliente para garantizar la idempotencia de la solicitud. El token debe ser único entre solicitudes, contener solo caracteres ASCII y no exceder los 64 caracteres de longitud.	ETnLKlblzczshOTUbOCz****
AutoPay	boolean	No	Especifica si se debe habilitar el pago automático. Valores válidos: true: (Predeterminado) Habilita el pago automático. Asegúrese de que su cuenta tenga saldo suficiente. false: Deshabilita el pago automático. En este caso, debe pagar manualmente el nodo. Para ello, inicie sesión en la consola de ApsaraDB for MongoDB. En la esquina superior derecha de la página, seleccione Facturación > Gestión de facturación. En el panel de navegación izquierdo, haga clic en Gestión de pedidos. En la página Pedidos de productos, busque el pedido y complete el pago. Nota Este parámetro es obligatorio para instancias de suscripción.	true
ReadonlyReplicas	integer	No	El número de nodos de solo lectura en un nodo shard. Valores válidos: 0 a 5. El valor predeterminado es 0. Nota Este parámetro solo está disponible en el sitio de China (aliyun.com).	5
BusinessInfo	string	No	Información comercial adicional.	{“ActivityId":"000000000"}
CouponNo	string	No	Especifica si se debe usar un cupón. Valores válidos: default o null: (Predeterminado) Se aplica automáticamente un cupón disponible. youhuiquan_promotion_option_id_for_blank: No se usa ningún cupón.	default
ShardDirect	boolean	No	Especifica si se debe habilitar un endpoint público para el nodo shard. Valores válidos: true: Habilita un endpoint público para el nodo shard. false: (Predeterminado) No habilita un endpoint público para el nodo shard.	false
AccountName	string	No	El nombre de la cuenta. El nombre debe cumplir los siguientes requisitos: Debe comenzar con una letra minúscula. Debe consistir en letras minúsculas, dígitos y guiones bajos (_). Debe tener una longitud de 4 a 16 caracteres. Nota Las palabras clave de ApsaraDB for MongoDB no se pueden usar como nombre de cuenta. La cuenta tiene permisos de solo lectura. Debe configurar el nombre y la contraseña de la cuenta solo cuando habilite un endpoint público para un nodo shard por primera vez. Estos parámetros no son obligatorios en solicitudes posteriores.	ceshi
AccountPassword	string	No	La contraseña de la cuenta. La contraseña debe cumplir los siguientes requisitos: Debe contener caracteres de al menos tres de las siguientes categorías: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Los caracteres especiales incluyen `!@#$%^&()_+-=`. Debe tener una longitud de 8 a 32 caracteres. Nota* ApsaraDB for MongoDB no admite restablecer la contraseña de la cuenta para nodos shard.	123+abc
SearchDBInstanceClass	string	No
SearchStorage	integer	No
SearchNodeCount	integer	No

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	7D48FB19-20CA-4725-A870-3D8F5CE6****
NodeId	string	El ID del nodo.	d-bp1b234bf7a4****
OrderId	string	El ID del pedido.	20951063702****

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	SSLNotSupportAddNode	Instance with SSL certificate can't add node, please contact us to solve this problem.	SSL encryption instances do not allow nodes to be added. If you need to, contact us to solve the problem.
400	ErrorInsufficientResource	There is not enough resource for your operation, requestId: %s.	There is not enough resource for your operation, requestId: %s.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.