Criação de um cluster

Função

Essa API é usada para criar clusters.

O cluster deve ser executado em uma VPC. Antes de criar um cluster, você precisa criar uma VPC e obter os ID da VPC e da sub-rede.

Esta API é uma API assíncrona. Leva de 10 a 15 minutos para criar um cluster.

Depuração

Você pode depurar essa API no Explorador de API.

URI

• Formato URI

  POST /v1.0/{project_id}/clusters

• Descrição do parâmetro

  Tabela 1 Parâmetros URI

  Parâmetro	Obrigatório	Tipo	Descrição
  project_id	Sim	String	Project ID. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID do projeto.

Mensagem de solicitação

• Exemplo de solicitação

  POST  https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/clusters
  
  {
  "cluster": {
          "node_type":  "dws.m1.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"     }
  }

• Descrição do parâmetro

  Tabela 2 Parâmetros de solicitação

  Parâmetro	Obrigatório	Tipo	Descrição
  cluster	Sim	CreateClusterInfo object	Objeto de cluster

  Tabela 3 CreateClusterInfo

  Parâmetro	Obrigatório	Tipo	Descrição
  node_type	Sim	String	Para obter detalhes, consulte Para obter detalhes, consulte Tipos de data warehouse.
  number_of_node	Sim	Integer	Número de nós de cluster. Para um cluster, o valor varia de 3 a 256. Para um data warehouse híbrido (autônomo), o valor é 1.
  subnet_id	Sim	String	ID de sub-rede, que é usada para configurar a rede do cluster.
  security_group_id	Sim	String	ID de um grupo de segurança, que é usado para configurar a rede do cluster.
  vpc_id	Sim	String	VPC ID, que é usado para configurar a rede do cluster.
  availability_zone	Não	String	AZ de um cluster Para obter detalhes, consulte Regiões e endpoints.
  port	Não	Integer	Porta de serviço de um cluster. O valor varia de 8000 a 30000. O valor padrão é 8000.
  name	Sim	String	Nome do cluster, que deve ser exclusivo. O nome do cluster deve conter de 4 a 64 caracteres, que devem começar com uma letra. Apenas letras, números, hifens (-) e sublinhados (_) são permitidos.
  user_name	Sim	String	Nome de usuário do administrador para efetuar login em um cluster GaussDB(DWS). O nome de usuário do administrador deve: Consistem em letras minúsculas, dígitos ou sublinhados. Comece com uma letra minúscula ou um sublinhado. Contém de 1 a 63 caracteres. Não pode ser uma palavra-chave do banco de dados GaussDB(DWS).
  user_pwd	Sim	String	Senha de administrador para fazer login em um cluster GaussDB(DWS) Contém de 8 a 32 caracteres. Contém pelo menos três tipos dos seguintes caracteres: letras maiúsculas, minúsculas, dígitos e caracteres especiais (~!?, .:;-_(){}[]/<>@# %^&*+|\=). Não pode ser o mesmo que o nome de usuário ou o nome de usuário escrito na ordem inversa.
  public_ip	Não	PublicIp object	Endereço IP público. Se o parâmetro não for especificado, a conexão pública não será usada por padrão.
  number_of_cn	Não	Integer	Número dos CN implantados. O valor varia de 2 até o número de nós do cluster. O valor máximo é 20 e o valor padrão é 3.
  enterprise_project_id	Não	String	Projeto empresarial A ID de projeto empresarial padrão é 0.

  Tabela 4 PublicIp

  Parâmetro	Obrigatório	Tipo	Descrição
  public_bind_type	Sim	String	Tipo de vinculação de um EIP. O valor pode ser um dos seguintes: auto_assign not_use bind_existing
  eip_id	Não	String	ID do EIP

Mensagem de resposta

• Exemplo de resposta

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

• Descrição do parâmetro

  Tabela 5 Descrição do parâmetro de resultados

  Parâmetro	Tipo	Descrição
  cluster	Cluster object	Objeto de cluster

  Tabela 6 Cluster

  Parâmetro	Tipo	Descrição
  id	String	ID do cluster

Código de status

• Normal

  200

• Exceção

  Tabela 7 Valores retornados

  Valor retornado	Descrição
  400 Bad Request	Erro na solicitação.
  401 Unauthorized	Autenticação falhou.
  403 Forbidden	Sem permissão de operação.
  404 Not Found	Nenhum recurso encontrado.
  500 Internal Server Error	Erro de serviço interno.
  503 Service Unavailable	Serviço não está disponível.