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

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:

Saiba como autorizá-la e autenticá-la.
Obtenha a região e o ponto de extremidade necessários.

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"
    }
  } ]
}