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

• Normal

  200

• Anormal

  Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.