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:

Esta API estará indisponível em 31 de março de 2025. É aconselhável mudar as cargas de trabalho para a nova API (Consulta de especificações de banco de dados) antes disso.

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

URI

• Formato de URI

  GET https://{endpoint}/mysql/v3/{project_id}/flavors/{database_name}?version_name={version_name}&spec_code={spec_code}&availability_zone_mode={availability_zone_mode}

• Exemplo

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

• Descrição do parâmetro

  Tabela 1 Descrição do parâmetro

  Nome	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	Mecanismo de BD. Seu valor não diferencia maiúsculas de minúsculas e pode ser: gaussdb-mysql
  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 pode ser single ou multi e não diferencia maiúsculas de minúsculas.
  spec_code	Não	String	Código de especificação.

Solicitação

Nenhuma.

Resposta

• Resposta normal

  Tabela 2 Descrição do parâmetro

  Nome	Tipo	Descrição
  flavors	Array of objects	Lista de especificações da instância de banco de dados. Para mais detalhes, consulte Tabela 3.

  Tabela 3 Descrição da estrutura de dados do campo flavors

  Nome	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	Tipo de especificação. O valor pode ser arm.
  id	String	ID da especificação. O valor deve ser exclusivo.
  spec_code	String	Código de especificação do recurso. Seu valor é o mesmo que o valor de flavor_ref.
  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. Seu valor pode ser qualquer um dos seguintes: normal: à venda. unsupported: não suportado sellout: esgotado

• Exemplo de resposta normal

  {
      "flavors":[
          {
              "vcpus":"1",
              "ram":"4",
              "type":"x86",           
              "id":"3169caaf-6c2f-41d5-aadd-c8fc3d83597e",
              "spec_code":"gaussdb.xlarge.x86.4",
              "instance_mode":"Cluster",
              "version_name": "8.0",
              "az_status":{
                  "az1":"normal",
                  "az2":"normal"
              }
          },
          {
              "vcpus":"2",
              "ram":"4",
              "type":"arm"
              "id":"cefb8fab-c9f7-482f-a97c-e8a0c8abe35b",
              "spec_code":"gaussdb.mysql.xlarge.x86.2",
              "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.