Creación de un clúster

Función

Esta API se utiliza para crear clústeres.

El clúster debe ejecutarse en una VPC. Antes de crear un clúster, debe crear una VPC y obtener los ID de VPC y subred.

Esta API es una API asíncrona. Se tarda de 10 a 15 minutos en crear un clúster.

Actualmente, solo se pueden crear almacenes de datos estándar a través de esta API.

URI

• Formato URI

  POST /v1.0/{project_id}/clusters

• Descripción del parámetro

  Tabla 1 Parámetros URI

  Parámetro	Obligatorio	Tipo	Descripción
  project_id	Sí	String	ID de proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.

Request Message

• Ejemplo de solicitud

  POST /v1.0/89cd04f168b84af6be287f71730fdb4b/clusters
  
  {
  "cluster": {
          "node_type":  "dws.d1.xlarge.ultrahigh",
          "number_of_node": 3,
          "subnet_id": "374eca02-cfc4-4de7-8ab5-dbebf7d9a720",
          "security_group_id": "dc3ec145-9029-4b39-b5a3-ace5a01f772b",
          "vpc_id": "85b20d7e-9eb7-4b2a-98f3-3c8843ea3574",
          "availability_zone": "ap-southeast-1",
          "port": 8000,
          "name": "dws-1",
          "user_name": "dbadmin",
          "user_pwd": "Password!",
          "public_ip": {
              "public_bind_type": "auto_assign",
              "eip_id": ""
          }, 
          "enterprise_project_id":"aca4e50a-266f-4786-827c-f8d6cc3fbada"     }
  }

• Descripción del parámetro

  Tabla 2 Parámetros de solicitud

  Parámetro	Obligatorio	Tipo	Descripción
  cluster	Sí	CreateClusterInfo object	Objeto de clúster

  Tabla 3 CreateClusterInfo

  Parámetro	Obligatorio	Tipo	Descripción
  node_type	Sí	String	Tipo de nodo
  number_of_node	Sí	Integer	Número de nodos en el clúster. El valor varía de 2 a 256.
  subnet_id	Sí	String	ID de subred, que se utiliza para configurar la red del clúster.
  security_group_id	Sí	String	ID de un grupo de seguridad, que se utiliza para configurar la red del clúster.
  vpc_id	Sí	String	ID de VPC, que se utiliza para configurar la red del clúster.
  availability_zone	No	String	Zona de disponibilidad de un clúster
  port	No	Integer	Puerto de servicio de un clúster. El valor varía de 8000 a 30000. El valor predeterminado es 8000.
  name	Sí	String	Nombre del clúster, que debe ser único. El nombre del clúster debe contener entre 4 y 64 caracteres, que deben comenzar con una letra.Only letters, digits, hyphens (-), and underscores (_) are allowed.
  user_name	Sí	String	Nombre de usuario del administrador para iniciar sesión en un clúster de GaussDB(DWS). El nombre de usuario del administrador debe: Constar de letras minúsculas, dígitos o guiones bajos. Comenzar con una letra minúscula o un guion bajo. Contener de 1 a 63 caracteres. No puede ser una palabra clave de la base de datos GaussDB(DWS).
  user_pwd	Sí	String	Contraseña de administrador para iniciar sesión en un clúster de GaussDB(DWS)
  public_ip	No	PublicIp object	Dirección IP pública. Si no se especifica el parámetro, la conexión pública no se utiliza de forma predeterminada.
  number_of_cn	No	Integer	Número de CNs desplegados. El valor oscila entre 2 y el número de nodos de clúster menos 1. El valor máximo es 20 y el valor predeterminado es 3.
  enterprise_project_id	No	String	Proyecto empresarial El ID predeterminado del proyecto de empresa es 0.

  Tabla 4 PublicIp

  Parámetro	Obligatorio	Tipo	Descripción
  public_bind_type	Sí	String	Tipo de vinculación de un EIP. El valor puede ser uno de los siguientes: auto_assign not_use bind_existing
  eip_id	No	String	ID de la EIP

Mensaje de la respuesta

• Ejemplo de respuesta

  {
      "cluster": {
          "id": "7d85f602-a948-4a30-afd4-e84f47471c15"
       }
  }

• Descripción del parámetro

  Tabla 5 Parámetros de respuesta

  Parámetro	Tipo	Descripción
  cluster	Cluster object	Objeto de clúster

  Tabla 6 Clúster

  Parámetro	Tipo	Descripción
  id	String	ID del clúster

Código de estado

• Normal

  200

• Excepción

  Tabla 7 Valores devueltos

  Valor devuelto	Descripción
  400 Bad Request	Error de solicitud.
  401 Unauthorized	Error en la autorización.
  403 Forbidden	No hay permiso de operación.
  404 Not Found	No se encontraron recursos.
  500 Internal Server Error	Error interno del servicio.
  503 Service Unavailable	El servicio no está disponible.