Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/TaurusDB/Referência de API/APIs (recomendadas)/Consultas de especificação de banco de dados/Consulta de especificações de banco de dados
Atualizado em 2025-05-23 GMT+08:00
Ver PDF
Compartilhar

Consulta de especificações de banco de dados

Função

Essa API é usada para consultar as especificações do banco de dados de uma versão especificada do mecanismo de banco de dados. Antes de chamar essa API:

URI

GET /v3/{project_id}/flavors/{database_name}

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

Explicação:

ID do projeto de um locatário numa região.

Para obter esse valor, consulte Obtenção de um ID de projeto.

Restrições:

Nenhuma

Intervalo de valores:

O valor pode conter 32 caracteres. Apenas letras e dígitos são permitidos.

Valor padrão:

Nenhum

database_name

Sim

String

Explicação:

Nome do mecanismo de BD.

Restrições:

Nenhuma

Intervalo de valores:

gaussdb-mysql

Valor padrão:

Nenhum

Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

availability_zone_mode

Sim

String

Explicação:

Tipo de AZ.

Restrições:

Nenhuma

Intervalo de valores:

  • single: AZ única
  • multi: várias AZs

Valor padrão:

single

version_name

Não

String

Explicação:

Número da versão do BD.

Restrições:

Atualmente, apenas o MySQL 8.0 é suportado.

Intervalo de valores:

8.0

Valor padrão:

8.0

spec_code

Não

String

Explicação:

Código de especificação do recurso. Exemplo: gaussdb.mysql.xlarge.x86.4

  • gaussdb.mysql indica o produto.
  • xlarge indica as especificações (4 vCPUs).
  • x86 indica a arquitetura x86.
  • 4 indica que a proporção entre vCPUs e memória é de 1:4.

Para obter mais informações, consulte Especificações de instância.

Restrições:

Nenhuma

Intervalo de valores:

Nenhum

Valor padrão:

Nenhum

Parâmetros de solicitação

Tabela 3 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Explicação:

Token do usuário.

Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário.

O valor de X-Subject-Token no cabeçalho da resposta é o valor do token.

Restrições:

Nenhuma

Intervalo de valores:

Nenhum

Valor padrão:

Nenhum

X-Language

Não

String

Explicação:

Tipo de linguagem da solicitação.

Restrições:

Nenhuma

Intervalo de valores:

  • en-us
  • zh-cn

Valor padrão:

en-us

Parâmetros de resposta

Código de status: 202

Tabela 4 Parâmetro do corpo da resposta

Parâmetro

Tipo

Descrição

flavors

Array of MysqlFlavorsInfo objects

Explicação:

Especificações de instância.

Tabela 5 MysqlFlavorsInfo

Parâmetro

Tipo

Descrição

vcpus

String

Explicação:

Número de vCPUs. Por exemplo, o valor 1 indica 1 vCPU.

Intervalo de valores:

Nenhum

ram

String

Explicação:

Tamanho da memória em GB.

Intervalo de valores:

Nenhum

type

String

Explicação:

Arquitetura da CPU.

Intervalo de valores:

  • arm: Arm exclusivo
  • x86: x86 exclusivo
  • generalX86: x86 de uso geral

id

String

Explicação:

ID da especificação, que identifica exclusivamente uma especificação.

Intervalo de valores:

Nenhum

spec_code

String

Explicação:

Código de especificação do recurso. Seu valor é o mesmo que o valor de spec_code. Exemplo: gaussdb.mysql.xlarge.x86.4

  • gaussdb.mysql indica o produto.
  • xlarge indica as especificações (4 vCPUs).
  • x86 indica a arquitetura x86.
  • 4 indica que a proporção entre vCPUs e memória é de 1:4.

Para obter mais informações, consulte Especificações de instância.

Intervalo de valores:

Nenhum

version_name

String

Explicação:

Número da versão do BD.

Intervalo de valores:

8.0

instance_mode

String

Explicação:

Tipo de instância. Atualmente, apenas o tipo de cluster é suportado.

Intervalo de valores:

Cluster

az_status

Map<String,String>

Explicação:

Status da especificação na AZ.

Intervalo de valores:

  • normal: a especificação está disponível na AZ.
  • unsupported: a especificação não é suportada.
  • sellout: a especificação está esgotada.

Código de status: 400

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 7 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

Consulta de especificações específicas de uma instância do TaurusDB

GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/flavors/gaussdb-mysql?version_name=8.0&spec_code=gaussdb.mysql.xlarge.x86.4&availability_zone_mode=single

Exemplo de resposta

Código de status: 202

Bem-sucedido.

{
  "flavors" : [ {
    "vcpus" : "4",
    "ram" : "16",
    "type" : "x86",
    "id" : "3169caaf-6c2f-41d5-aadd-c8fc3d83597e",
    "spec_code" : "gaussdb.mysql.xlarge.x86.4",
    "instance_mode" : "Cluster",
    "version_name" : "8.0",
    "az_status" : {
      "az1" : "normal",
      "az2" : "normal"
    }
  } ]
}

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.