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/ Relational Database Service/ Referência de API/ API v3 (recomendada)/ Consulta de especificações de banco de dados
Atualizado em 2023-05-05 GMT+08:00

Consulta de especificações de banco de dados

Função

Esta API é usada para consultar as especificações de banco de dados de uma versão especificada do mecanismo de banco de dados.

  • Antes de chamar uma API, você precisa entender a API em Autenticação.

URI

  • Formato de URI

    GET /v3/{project_id}/flavors/{database_name}?version_name={version_name}&spec_code={spec_code}

  • Descrição do parâmetro
    Tabela 1 Descrição do parâmetro

    Nome

    Obrigatório

    Descrição

    project_id

    Sim

    Especifica o ID do projeto de um locatário em uma região.

    Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.

    database_name

    Sim

    Especifica o nome do mecanismo de banco de dados. O valor pode ser qualquer um dos seguintes e não diferencia entre maiúsculas e minúsculas:

    • MySQL
    • PostgreSQL
    • SQLServer

    version_name

    Não

    Especifica a versão de banco de dados. Para obter detalhes sobre como obter a versão de banco de dados, consulte a seção Consulta de informações de versão sobre um mecanismo de banco de dados. (A versão secundária é suportada.)

    spec_code

    Não

    Especifica o código de especificação.

Solicitação

  • Parâmetros de solicitação

    Nenhum

  • Exemplo de URI

    GET https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/flavors/mysql?version_name=5.7&spec_code=rds.mysql.m1.xlarge.rr

Resposta

  • Resposta normal
    Tabela 2 Descrição do parâmetro

    Nome

    Tipo

    Descrição

    flavors

    Array of objects

    Indica a lista das informações 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

    Indica o tamanho da CPU. Por exemplo, o valor 1 indica 1 vCPU.

    ram

    Integer

    Indica o tamanho da memória em GB.

    id

    String

    Indica o ID da especificação, que é exclusivo.

    spec_code

    String

    Indica o código de especificação do recurso. Use rds.mysql.m1.xlarge.rr como um exemplo.

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

    • rds: indica o produto RDS.
    • mysql: indica o motor de banco de dados.
    • m1.xlarge: indica as especificações de alto desempenho da memória.
    • rr: indica réplicas de leitura (.ha indica instâncias primárias/em espera de banco de dados).
    • rha.rr indica réplicas de leitura HA. Exemplo de código de especificação: rds.mysql.n1.large.4.rha.rr.
      • As réplicas de leitura HA estão disponíveis apenas para usuários com a permissão open beta test (OBT). Você pode entrar em contato com o atendimento ao cliente para solicitar a permissão.
      • Para obter detalhes sobre réplicas de leitura de HA, consulte Primeiros passos de réplicas de leitura de HA.

    version_name

    Array

    Indica a versão de banco de dados.

    Exemplo de valor para o MySQL: ["5.6","5.7","8.0"]

    instance_mode

    String

    Indica o tipo de instância de banco de dados. O valor pode ser qualquer um dos seguintes:

    • ha: indica instâncias primárias/em espera.
    • replica: indica réplicas de leitura.
    • single: indica instâncias de banco de dados únicas.

    az_status

    Map<String, String>

    Indica o status da especificação em uma AZ. O valor pode ser qualquer um dos seguintes:

    • normal: indica que as especificações na AZ estão disponíveis.
    • unsupported: indica que as especificações não são suportadas pela AZ.
    • sellout: indica que as especificações na AZ estão esgotadas.

    az_desc

    Map<String, String>

    Indica a descrição da AZ à qual as especificações pertencem.

    group_type

    String

    Indica as especificações de desempenho. O valor pode ser qualquer um dos seguintes:

    • normal: geral-aprimorado
    • normal2: geral-aprimorado II
    • armFlavors: Kunpeng geral-aprimorado
    • dedicicateNormal (dedicatedNormalLocalssd): exclusivo x86
    • armLocalssd: padrão Kunpeng
    • normalLocalssd: padrão x86
    • general: uso geral
    • dedicated:
      • para o mecanismo de banco de dados do MySQL: dedicado
      • Para mecanismos de banco de dados do PostgreSQL e SQL Server: dedicado, que é suportado apenas para SSDs na nuvem
    • rapid:
      • para o mecanismo de banco de dados do MySQL: dedicado (off-line)
      • Para mecanismos de banco de dados do PostgreSQL e SQL Server: dedicado, que é suportado apenas para SSDs extremas
    • bigmem: grande-memória
  • Exemplo de resposta normal
    {
    	"flavors": [{
    			"vcpus": "1",
    			"ram": 2,
                            "id":"2988b9cc-2aac-3a94-898c-14666702f129",
    			"spec_code": "rds.mysql.c2.medium.ha",
                            "version_name": ["5.6","5.7","8.0"],
    			"instance_mode": "ha",
    			"az_status": {
    				"az1": "normal",
    				"az2": "normal"
    			},
    			"az_desc": {
    				"az1": "az1",
    				"az2": "az2"
    			},
                            "group_type": "normal"
    		},
    		{
    			"vcpus": "1",
    			"ram": 2,
                            "id":"2988b9cc-2aac-3a94-898c-14666702f130",
    			"spec_code": "rds.mysql.c2.medium.rr",
                            "version_name": ["5.6","5.7","8.0"],
    			"instance_mode": "replica",
    			"az_status": {
    				"az1": "normal",
    				"az2": "normal"
    			},
    			"az_desc": {
    				"az1": "az1",
    				"az2": "az2"
    			},
                            "group_type": "normal"
    		}
    	]
    }
  • Resposta anormal

    Para mais detalhes, consulte Resultados anormais da solicitação.

Código de status

Código de erro

Para mais detalhes, consulte Códigos de erro.