Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ HTAP (Edición estándar)/ Creación de una instancia de StarRocks
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Creación de una instancia de StarRocks

Función

Esta API se utiliza para crear una instancia de StarRocks. Antes de invocar a esta API:

URI

POST /v3/{project_id}/instances/{instance_id}/starrocks

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

instance_id

Sí

String

ID de instancia de TaurusDB, que es compatible con el formato UUID.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Para obtener este valor, invoque a la API de IAM para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

Content-Type

Sí

String

Tipo de contenido. Valor: application/json

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:

  • en-us
  • zh-cn
Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

name

Sí

String

Nombre de instancia. Las instancias del mismo tipo pueden tener el mismo nombre bajo el mismo tenant.

El nombre debe comenzar con una letra y debe contener entre 4 y 64 caracteres. Solo se permiten letras (distinguen mayúsculas de minúsculas), dígitos, guiones (-) y guiones bajos (_).

engine

Sí

engine object

Información del motor.

ha

Sí

ha object

Información de despliegue.

fe_flavor_id

Sí

String

ID de especificación del nodo frontend. Puede utilizar el valor de id en la respuesta a la consulta de especificaciones HTAP.

be_flavor_id

Sí

String

ID de especificación del nodo backend. Puede utilizar el valor de id en la respuesta a la consulta de especificaciones HTAP.

db_root_pwd

Sí

String

Contraseña de base de datos.

La contraseña debe cumplir los siguientes requisitos:

  • La contraseña contiene al menos tres tipos de los siguientes caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales ~!@#$%^*-_=+?,()&|.,
  • La contraseña debe contener de 8 a 32 caracteres.
  • Se recomienda ingresar una contraseña segura para mejorar la seguridad y evitar riesgos de seguridad, como el agrietamiento por fuerza bruta. Si ingresa una contraseña débil, el sistema determina automáticamente que la contraseña no es válida.

fe_count

Sí

Integer

Cantidad de nodos frontend.

  • El valor se fija en 1 para una instancia de nodo único.
  • Para una instancia de clúster, el valor oscila entre 3 y 10.

be_count

Sí

Integer

Cantidad de nodos backend.

  • El valor se fija en 1 para una instancia de nodo único.
  • Para una instancia de clúster, el valor oscila entre 3 y 10.

az_mode

Sí

String

Tipo de AZ. Actualmente, solo se admite una sola AZ.

Valor enumerado: single

fe_volume

Sí

fe_volume object

Almacenamiento de información del nodo frontend.

be_volume

Sí

be_volume object

Almacenamiento de información del nodo backend.

az_code

Sí

String

Código de zona de disponibilidad.

time_zone

No

String

Zona horaria. El huso horario predeterminado es UTC+08:00.

tags_info

Sí

tags_info object

Información de la etiqueta.
Tabla 4 engine

Parámetro

Obligatorio

Tipo

Descripción

type

Sí

String

Tipo de motor. Solo se soporta StarRocks.

version

Sí

String

Número de versión principal del motor.
Tabla 5 ha

Parámetro

Obligatorio

Tipo

Descripción

mode

Sí

String

Modo del despliegue.

Valores enumerados:

  • Single
  • Cluster
Tabla 6 fe_volume

Parámetro

Obligatorio

Tipo

Descripción

io_type

Sí

String

Tipo de almacenamiento. El valor se puede obtener de la respuesta a la consulta de recursos del motor HTAP.

capacity_in_gb

Sí

Integer

Espacio de almacenamiento en GB. Incremento: 10 GB

  • Valor mínimo: 50
  • Valor máximo: 1000
Tabla 7 be_volume

Parámetro

Obligatorio

Tipo

Descripción

io_type

Sí

String

Tipo de almacenamiento. El valor se puede obtener de la respuesta a la consulta de recursos del motor HTAP.

capacity_in_gb

Sí

Integer

Espacio de almacenamiento en GB. Incremento: 10 GB

  • Valor mínimo: 50
  • Valor máximo: 32000
Tabla 8 tags_info

Parámetro

Obligatorio

Tipo

Descripción

sys_tags

Sí

Array of sys_tags objects

Etiquetas del sistema.
Tabla 9 sys_tags

Parámetro

Obligatorio

Tipo

Descripción

key

Sí

String

Clave de etiqueta.

Valor enumerado: _sys_enterprise_project_id

value

Sí

String

Valor de etiqueta.

Valor enumerado: 0

Parámetros de respuesta

Código de estado: 201

Tabla 10 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

instance

instance object

información sobre instancias

job_id

String

ID de flujo de trabajo.
Tabla 11 instance

Parámetro

Tipo

Descripción

id

String

ID de instancia de StarRocks, que es compatible con el formato UUID.

az_code

String

Código de zona de disponibilidad.

az_mode

String

Tipo de zona de disponibilidad.

Valores:

  • single: AZ única
  • multi: varias AZ

name

String

Nombre de instancia.

engine

engine object

Información del motor.

vpc_id

String

ID de VPC.

security_group_id

String

ID del grupo de seguridad.

sub_net_id

String

ID de subred.

db_user

String

Usuario de base de datos. El valor predeterminado es root.

port

Integer

Número de puerto de la base de datos. El valor predeterminado es 3306.

ha_mode

String

Modo del despliegue.

pay_info

pay_info object

Información de facturación.

enable_ssl

Boolean

Si se debe habilitar SSL.

status

String

Estado de la instancia.

region

String

Región donde se despliega la instancia.

tags_info

tags_info object

Etiquetas de instancia.
Tabla 12 engine

Parámetro

Tipo

Descripción

type

String

Tipo de motor.

version

String

Número de versión principal del motor.
Tabla 13 pay_info

Parámetro

Tipo

Descripción

pay_model

String

Modo de facturación.

  • 0: pago por uso
  • 1: anual/mensual

Las instancias de StarRocks solo admiten la facturación de pago por uso. El valor predeterminado es 0.

order_id

String

ID de pedido anual/mensual.

period

String

Período de suscripción anual/mensual.

period_type

String

Tipo de período de suscripción.

is_auto_renew

String

Si se debe renovar automáticamente la suscripción anual/mensual.
Tabla 14 tags_info

Parámetro

Tipo

Descripción

tags

Array of tags objects

Etiquetas de usuario. Este parámetro se deja en blanco por defecto.

sys_tags

Array of sys_tags objects

Etiquetas del sistema.
Tabla 15 tags

Parámetro

Tipo

Descripción

key

String

Clave de etiqueta.

value

String

Valor de etiqueta.
Tabla 16 sys_tags

Parámetro

Tipo

Descripción

key

String

Clave de etiqueta.

value

String

Valor de etiqueta.

Código de estado: 400

Tabla 17 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 18 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Creación de una instancia de BD

POST https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/instances/40dc4c5729f14aad893e2dcd5baf6a15in07/starrocks

{
  "name" : "htap-ff64",
  "engine" : {
    "type" : "star-rocks",
    "version" : "3.1"
  },
  "ha" : {
    "mode" : "Single"
  },
  "fe_flavor_id" : "afef3bfd-ac7c-32e1-ba44-c388acbb196a",
  "be_flavor_id" : "de565db8-0a96-37ea-9388-61167624712c",
  "db_root_pwd" : "Test@123!",
  "fe_count" : 1,
  "be_count" : 1,
  "az_mode" : "single",
  "fe_volume" : {
    "io_type" : "SSD",
    "capacity_in_gb" : 50
  },
  "be_volume" : {
    "io_type" : "SSD",
    "capacity_in_gb" : 50
  },
  "az_code" : "az",
  "time_zone" : "UTC+08:00",
  "tags_info" : {
    "sys_tags" : [ {
      "key" : "_sys_enterprise_project_id",
      "value" : "0"
    } ]
  }
}

Ejemplo de la respuesta

Código de estado: 201

Operación exitosa.

{
  "instance" : {
    "id" : "590031445ef845bb912d7fc8243db80cin17",
    "az_code" : "az1",
    "az_mode" : "single",
    "name" : "htap-ff64",
    "engine" : {
      "type" : "star-rocks",
      "version" : "3.1"
    },
    "vpc_id" : "d5a1a29b-1476-490f-9682-c1a59593e7b0",
    "security_group_id" : "967a0ac2-3cae-4e57-a49a-d0f6ff07dcc1",
    "sub_net_id" : "2ce0bc80-bfc5-4d5e-9b78-a7f91572e03b",
    "db_user" : "root",
    "port" : 3306,
    "ha_mode" : "Single",
    "pay_info" : {
      "pay_model" : "0",
      "order_id" : null,
      "period" : null,
      "period_type" : null,
      "is_auto_renew" : null
    },
    "enable_ssl" : false,
    "status" : "creating",
    "region" : "az",
    "tags_info" : {
      "tags" : [ ],
      "sys_tags" : [ {
        "key" : "_sys_enterprise_project_id",
        "value" : "0"
      } ]
    }
  },
  "job_id" : "cf0b7506-1505-450f-9d95-ce9d93b6b5c3"
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.

Tema principal: HTAP (Edición estándar)