CreateDBInstance - - Centro de documentación de Alibaba Cloud

Crea o clona una instancia de conjunto de réplicas de ApsaraDB for MongoDB.

Antes de llamar a esta operación, asegúrese de comprender completamente los métodos de facturación y la facturación.

Para obtener más información sobre los tipos de instancia de ApsaraDB for MongoDB, consulte Tipos de instancia.

Para crear instancias de clúster fragmentado, puede llamar a la operación CreateShardingDBInstance.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer 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í	CreateDBInstance	La operación que desea realizar. Establezca el valor en CreateDBInstance.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
ClientToken	String	No	ETnLKlblzczshOTUbOCz****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud.
ZoneId	String	No	cn-hangzhou-g	El ID de zona de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de zonas más reciente.
Engine	String	Sí	MongoDB	El motor de la instancia. El valor se establece en MongoDB.
EngineVersion	String	Sí	4.4	La versión del motor de la instancia. Valores válidos: 6.0 5.0 4.4 4.2 4.0 Nota Si llama a esta operación para clonar una instancia, establezca el valor en el motor de la instancia de origen.
DBInstanceClass	String	Sí	dds.mongo.standard	El tipo de instancia. También puede llamar a la operación DescribeAvailableResource para consultar los tipos de instancia.
DBInstanceStorage	Integer	Sí	10	La capacidad de almacenamiento de la instancia. Unidad: GB. Los valores que se pueden especificar para este parámetro están sujetos a los tipos de instancia. Para obtener más información, consulte Tipos de instancia de conjunto de réplicas.
DBInstanceDescription	String	No	test	El nombre de la instancia. Valores válidos: El nombre debe comenzar con una letra. El nombre puede contener dígitos, letras, guiones bajos (_) y guiones (-). El nombre debe tener una longitud de 2 a 256 caracteres.
SecurityIPList	String	No	192.168.xx.xx,192.168.xx.xx	Las direcciones IP en una lista de permitidos de direcciones IP. Separe varias direcciones IP con comas (,). Cada dirección IP en la lista de permitidos debe ser única. Se admiten los siguientes tipos de direcciones IP: 0.0.0.0/0 Direcciones IP, como 10.23.12.24. Bloques Classless Inter-Domain Routing (CIDR), como 10.23.12.0/24. En este caso, /24 indica que el prefijo de cada dirección IP tiene una longitud de 24 bits. Puede reemplazar 24 con un valor dentro del rango de 1 a 32. Nota Se pueden configurar un máximo de 1,000 direcciones IP y bloques CIDR para cada instancia. Si introduce 0.0.0.0/0, todas las direcciones IP pueden acceder a la instancia. Esto puede introducir riesgos de seguridad en la instancia.
AccountPassword	String	No	123456Aa	La contraseña de la cuenta root. La contraseña debe cumplir los siguientes requisitos: La contraseña debe contener como mínimo tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Estos caracteres especiales incluyen ! # $ % ^ & * ( ) _ + - = La contraseña debe tener una longitud de 8 a 32 caracteres.
ChargeType	String	No	PrePaid	El método de facturación de la instancia. Valores válidos: PostPaid: pay-as-you-go PrePaid: suscripción Nota Si especifica este parámetro como PrePaid, también debe especificar el parámetro Period.
Period	Integer	No	1	El período de suscripción de la instancia. Unidad: meses. Valores válidos: 1 a 9, 12, 24, 36 y 60. Nota Si establece la propiedad ChargeType en PrePaid, debe configurar esta propiedad.
NetworkType	String	No	VPC	El tipo de red de la instancia. Valores válidos: VPC
VpcId	String	Sí	vpc-bp175iuvg8nxqraf2****	El ID de VPC de la instancia.
VSwitchId	String	Sí	vsw-bp1gzt31twhlo0sa5****	El ID de vSwitch de la instancia.
SrcDBInstanceId	String	No	dds-bp1ee12ad351****	El ID de la instancia de origen. Nota Este parámetro solo se puede especificar cuando se llama a esta operación para clonar instancias. También debe especificar el parámetro BackupId o el parámetro RestoreTime.
BackupId	String	No	32994****	El ID del conjunto de copia de seguridad. Puede llamar a la operación DescribeBackups para consultar el ID del conjunto de copia de seguridad. Nota Este parámetro es obligatorio solo cuando llama a esta operación para clonar una instancia. Si especifica este parámetro, también debe especificar el parámetro SrcDBInstanceId.
RestoreTime	String	No	2022-03-13T12:11:14Z	El punto en el tiempo para clonar la instancia, que debe estar dentro de los siete días. Especifique la hora en formato aaaa-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Nota Este parámetro es obligatorio solo cuando llama a esta operación para clonar una instancia. Si especifica este parámetro, también debe especificar el parámetro SrcDBInstanceId.
BusinessInfo	String	No	{“ActivityId":"000000000"}	La información comercial. Este es un parámetro adicional.
AutoRenew	String	No	true	Especifica si se habilita la renovación automática para la instancia. Valor predeterminado: false. Valores válidos: true false Nota Si establece el parámetro ChargeType en PrePaid, debe configurar este parámetro opcional.
DatabaseNames	String	No	mongodbtest	El nombre de la base de datos. Nota Cuando llama a esta operación para clonar una instancia, puede establecer las bases de datos especificadas por este parámetro para la clonación. De lo contrario, se clonan todas las bases de datos de la instancia.
CouponNo	String	No	youhuiquan_promotion_option_id_for_blank	El código de cupón. Valor predeterminado: `youhuiquan_promotion_option_id_for_blank`.
StorageEngine	String	No	WiredTiger	El motor de almacenamiento de la instancia. Valor predeterminado: WiredTiger. Nota Si llama a esta operación para clonar una instancia, establezca el valor en el motor de la instancia de origen. Para obtener más información sobre los límites de versiones de base de datos y motores de almacenamiento, consulte Versiones de MongoDB y motores de almacenamiento.
ReplicationFactor	String	No	3	El número de nodos en la instancia de conjunto de réplicas. Valor predeterminado: 3. Valores válidos: 3 5 7
ReadonlyReplicas	String	No	0	El número de nodos de solo lectura en la instancia de conjunto de réplicas. Valor predeterminado: 0. Valores válidos: 0 a 5.
StorageType	String	No	cloud_essd	El tipo de almacenamiento de la instancia. Valores válidos: cloud_essd: SSD mejorado (ESSD) local_ssd: SSD local

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	D8F1D721-6439-4257-A89C-F1E8E9C9****	El ID de la solicitud.
DBInstanceId	String	dds-bp144a7f2db8****	IDs de instancia.
OrderId	String	21077576248****	El ID del pedido.

Ejemplos

Solicitudes de ejemplo

http(s)://mongodb.aliyuncs.com/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&ClientToken=ETnLKlblzczshOTUbOCz****
&ZoneId=cn-hangzhou-g
&Engine=MongoDB
&EngineVersion=4.4
&DBInstanceClass=dds.mongo.standard
&DBInstanceStorage=10
&DBInstanceDescription=test
&SecurityIPList=192.168.xx.xx,192.168.xx.xx
&AccountPassword=123456Aa
&ChargeType=PrePaid
&Period=1
&NetworkType=VPC
&VpcId=vpc-bp175iuvg8nxqraf2****
&VSwitchId=vsw-bp1gzt31twhlo0sa5****
&BusinessInfo={“ActivityId":"000000000"}
&AutoRenew=true
&CouponNo=youhuiquan_promotion_option_id_for_blank
&StorageEngine=WiredTiger
&ReplicationFactor=3
&ReadonlyReplicas=0
&StorageType=cloud_essd
&SecondaryZoneId=cn-hangzhou-h
&HiddenZoneId=cn-hangzhou-i
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

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

<CreateDBInstanceResponse>
    <RequestId>D8F1D721-6439-4257-A89C-F1E8E9C9****</RequestId>
    <DBInstanceId>dds-bp144a7f2db8****</DBInstanceId>
    <OrderId>21077576248****</OrderId>
</CreateDBInstanceResponse>

Formato JSON

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

{
  "RequestId" : "D8F1D721-6439-4257-A89C-F1E8E9C9****",
  "DBInstanceId" : "dds-bp144a7f2db8****",
  "OrderId" : "21077576248****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDBInstanceDescription.Malformed	Specified parameter DBInstanceDescription is not valid.	El mensaje de error devuelto porque el nombre del nodo no es válido.
400	InsufficientBalance	Your account does not have enough balance.	El mensaje de error devuelto porque su pago falló. Agregue otro método de pago o añada fondos a su cuenta e inténtelo de nuevo.
400	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.	El mensaje de error devuelto porque el espacio de almacenamiento especificado de la instancia no es válido. Especifique un valor dentro del rango de valores válidos. Unidad: MB.
400	IdempotentParameterMismatch	Request uses a client token in a previous request but is not identical to that request.	El mensaje de error devuelto porque el parámetro ClientToken especificado ya se ha utilizado. Especifique un valor que no se haya usado. Puede usar el cliente para generar el valor, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	El mensaje de error devuelto porque no ha completado la verificación de nombre real para su cuenta de Alibaba Cloud. Complete la verificación de nombre real e inténtelo de nuevo.
403	IncorrectBackupSetState	Current backup set state does not support operations.	El mensaje de error devuelto porque el conjunto de copia de seguridad actual no está listo. Inténtelo de nuevo más tarde.

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