Tareas iniciales
Esta sección describe cómo crear una instancia de clúster llamando a las API.
El período de validez de un token obtenido de IAM es de 24 horas. Si desea usar un token para la autenticación, guarde en caché para evitar llamadas frecuentes a la API de IAM.
APIs involucradas
Si utiliza un token para la autenticación, debe obtener el token del usuario y agregar X-Auth-Token al encabezado del mensaje de solicitud de la API de servicio al realizar una llamada a la API.
- API para obtener tokens de IAM
- Creación de una instancia de base de datos DDS mediante una API abierta
Procedimiento
- Obtenga el token siguiendo las instrucciones de la sección Autenticación.
- Enviar POST https://DDS endpoint/v3/{project_id}/instances.
- Agregue X-Auth-Token al encabezado de solicitud.
- Especifique los siguientes parámetros en el cuerpo de la solicitud:
Los valores de region y available_zone se usan como ejemplos.
Para obtener más información sobre la API utilizada para crear instancias de base de datos, consulte Creación de una instancia de base de datos.
{ "name": "test-cluster", //DB instance name "datastore": { "type": "DDS-Community", // Database type and version "version": "3.4", //Database version "storage_engine": "wiredTiger" //Storage engine }, "region": "aaa", //Region name "availability_zone": "bbb", //AZ name "vpc_id": "674e9b42-cd8d-4d25-a2e6-5abcc565b961", //VPC ID "subnet_id": "f1df08c5-71d1-406a-aff0-de435a51007b", //Subnet ID "security_group_id": "7aa51dbf-5b63-40db-9724-dad3c4828b58", //Security group ID "password": "******", //Administrator password "disk_encryption_id": "d4825f1b-5e47-4ff7-8ca9-0960da1770b1", //Key ID for encrypting disks "mode": "Sharding", //Sharded-cluster instance type "flavor": [ { "type":"mongos", //mongos node "num": 2, //Quantity "spec_code": "dds.mongodb.c6.medium.4.mongos" //Node resource code }, { "type":"shard", //shard node "num": 2, //Quantity "storage": "ULTRAHIGH", //Disk type "size": 20, //Disk size "spec_code": "dds.mongodb.c6.medium.4.shard" //Node resource code }, { "type":"config", //config node "num": 1, //Quantity "storage": "ULTRAHIGH", //Disk type "size": 20, //Disk size "spec_code": "dds.mongodb.c6.large.2.config" //Node resource type } ], "backup_strategy": { "start_time": "23:00-00:00", //Backup period "keep_days": "8" //Retention days of backup files }, "ssl_option":"1" }Si se muestra la siguiente información, la solicitud se realiza correctamente:
{ "id": "46125c43ca4d424a9f5c97354223c4e0in02", "name": "test-cluster", "datastore": { "type": "DDS-Community", "version": "3.4", "storage_engine": "wiredTiger" }, "created": "2019-01-14 08:50:27", "status": "creating", "region": "aaa", "availability_zone": "bbb", "vpc_id": "674e9b42-cd8d-4d25-a2e6-5abcc565b961", "subnet_id": "f1df08c5-71d1-406a-aff0-de435a51007b", "security_group_id": "7aa51dbf-5b63-40db-9724-dad3c4828b58", "disk_encryption_id": "d4825f1b-5e47-4ff7-8ca9-0960da1770b1", "mode": "Sharding", "flavor": [ { "type": "mongos", "num": 2, "spec_code": "dds.mongodb.c6.medium.4.mongos" }, { "type": "shard", "num": 2, "size": 20, "spec_code": "dds.mongodb.c6.medium.4.shard" }, { "type": "config", "num": 1, "size": 20, "spec_code": "dds.mongodb.c6.large.2.config" } ], "backup_strategy": { "start_time": "23:00-00:00", "keep_days": "8" }, "enterprise_project_id": "", "ssl_option":"1", "job_id": "c0c606b6-470a-48c7-97a2-6c7f146014d4" }Si la solicitud falla, se devuelve un código de error y la información de error. Para obtener más información, consulte la sección Código de error.
