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 do tipo de armazenamento de um banco de dados
Atualizado em 2023-05-05 GMT+08:00

Consulta do tipo de armazenamento de um banco de dados

Função

Esta API é usada para consultar o tipo de armazenamento de uma versão do mecanismo de banco de dados especificado.

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

URI

  • Formato de URI

    GET /v3/{project_id}/storage-type/{database_name}?version_name={version_name}&ha_mode={ha_mode}

  • 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 faz distinção entre maiúsculas e minúsculas:

    • MySQL
    • PostgreSQL
    • SQLServer

    version_name

    Sim

    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.

    ha_mode

    Não

    Especifica o modo HA. As opções de valor são as seguintes:

    • single
    • ha
    • replica

Solicitação

  • Parâmetros de solicitação

    Nenhum

  • Exemplo de URI

    GET https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/storage-type/mysql?version_name=5.7&ha_mode=ha

Resposta

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

    Nome

    Tipo

    Descrição

    storage_type

    Array of objects

    Indica a lista de informações de especificações da instância de banco de dados.

    Para mais detalhes, consulte Tabela 3.

    dsspool_info

    Array of objects

    Indica a lista de informações de especificações do dsspool.

    Para mais detalhes, consulte Tabela 4.

    NOTA:

    Somente usuários da Dedicated Cloud (DeC) são suportados.

    Tabela 3 Descrição da estrutura de dados campo storage_type

    Nome

    Tipo

    Descrição

    name

    String

    Indica o tipo de armazenamento. O valor pode ser qualquer um dos seguintes:

    • ULTRAHIGH: armazenamento SSD.
    • LOCALSSD: armazenamento SSD local.
    • CLOUDSSD: armazenamento SSD na nuvem. Este tipo de armazenamento é suportado apenas com instâncias de banco de dados dedicadas e de uso geral.
    • ESSD: armazenamento SSD extrema. Este tipo de armazenamento é compatível apenas com instâncias de banco de dados dedicadas.

    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 da AZ estão esgotadas.

    support_compute_group_type

    List<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: 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 só é suportado para SSDs extremas
    • bigmem: memória grande
    Tabela 4 Descrição da estrutura de dados do campo dsspool_info

    Nome

    Tipo

    Descrição

    az_name

    String

    Indica o nome da AZ onde o dsspool está localizado.

    free_capacity_gb

    String

    Indica a capacidade disponível do dsspool.

    dsspool_volume_type

    String

    Indica o tipo de volume dsspool.

    dsspool_id

    String

    Indica o ID do dsspool.

    dsspool_status

    String

    Indica o status do dsspool. O valor pode ser qualquer um dos seguintes:

    • available
    • deploying
    • enlarging
    • frozen
    • sellout
  • Exemplo de resposta normal
    {
    	"storage_type": [{
    			"name": "COMMON",
    			"az_status": {
    				"az1": "normal",
    				"az2": "normal"
    			},
                            "support_compute_group_type": [
                                    "normal",
                                    "normal2",
                                    "armFlavors"
                            ]
    		},
    		{
    			"name": "ULTRAHIGH",
    			"az_status": {
    				"az1": "normal",
    				"az2": "normal"
    			},
                            "support_compute_group_type": [
                                    "normal",
                                    "normal2",
                                    "armFlavors"
                            ]
    		}
    	],
            "dsspool_info": []
    }

    Exemplo de resposta de consulta do usuário da DeC

    {
    	"storage_type": [
    		{
    			"name": "COMMON",
    			"az_status": {
    				"az1xahz": "normal",
    				"az3xahz": "normal"
    			},
                            "support_compute_group_type": [
                                    "normal",
                                    "normal2"
                            ]
    		},
    		{
    			"name": "ULTRAHIGH",
    			"az_status": {
    				"az1xahz": "normal",
    				"az3xahz": "normal"
    			},
                            "support_compute_group_type": [
                                    "normal",
                                    "normal2"
                            ]
    		}
    	],
    	"dsspool_info": [
    		{
    			"az_name": "az1xahz",
    			"free_capacity_gb": "8656",
    			"dsspool_volume_type": "ULTRAHIGH",
    			"dsspool_id": "f5f84ed7-6f19-4bd4-99d7-b450ad6cc4dd",
    			"dsspool_status": "available"
    		}
    	]
    }
  • 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.