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 2024-09-29 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	ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto.
database_name	Sim	String	Nome do banco de dados.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
version_name	Não	String	Número da versão do BD. Para obter esse valor, consulte Consulta de informações de versão sobre um mecanismo de BD. Atualmente, apenas o MySQL 8.0 é suportado.
availability_zone_mode	Sim	String	Modo de AZ. Seu valor não diferencia maiúsculas de minúsculas e pode ser: single: AZ única multi: várias AZs
spec_code	Não	String	Código de especificação.

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	Token do usuário. Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida. Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token.
X-Language	Não	String	Tipo de linguagem da solicitação. O valor padrão é en-us. Valor: en-us zh-cn

Parâmetros de resposta

Código de status: 202

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
flavors	Array of MysqlFlavorsInfo objects	Especificações de instância.

**Tabela 5** MysqlFlavorsInfo
Parâmetro	Tipo	Descrição
vcpus	String	Número de vCPUs. Por exemplo, o valor 1 indica 1 vCPU.
ram	String	Tamanho da memória em GB.
type	String	Arquitetura da CPU. Valor: arm: Arm exclusivo x86: x86 exclusivo generalX86: x86 de uso geral
id	String	ID da especificação. O valor deve ser único.
spec_code	String	Código de especificação do recurso. Seu valor é o mesmo que o valor de flavor_ref. Por exemplo: gaussdb.mysql.xlarge.x86.4.
version_name	String	Número da versão do BD.
instance_mode	String	Tipo de instância de BD. Atualmente, apenas o tipo de cluster é suportado.
az_status	Map<String,String>	Status da AZ onde a especificação pertence. O valor pode ser qualquer um dos seguintes: normal: à venda unsupported: não suportado sellout: esgotado

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 GaussDB(for MySQL)

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