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)/ HTAP (edição padrão)/ Obtenção do tipo de armazenamento de uma instância de HTAP
Atualizado em 2025-05-23 GMT+08:00

Obtenção do tipo de armazenamento de uma instância de HTAP

Função

Essa API é usada para obter o tipo de armazenamento de uma instância de HTAP. Antes de chamar essa API:

URI

GET /v3/{project_id}/htap/storage-type/{database}

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

Sim

String

Nome do banco de dados HTAP. Valores:

  • star-rocks
  • click-house
Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

version_name

Sim

String

Número da versão principal do BD.

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.

Para obter esse valor, chame a API do IAM para obter um token de usuário.

O valor de X-Subject-Token no cabeçalho da resposta é o valor do token.

Content-Type

Sim

String

Tipo de conteúdo. Valor: application/json

X-Language

Não

String

Tipo de linguagem da solicitação. O valor padrão é en-us. Valores:

  • en-us
  • zh-cn

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

storage_type

Array of storage_type objects

Tipo de armazenamento.

Tabela 5 storage_type

Parâmetro

Tipo

Descrição

name

String

Nome do meio de armazenamento.

az_status

Map<String,String>

Se a AZ é suportada.

min_volume_size

Integer

Tamanho mínimo do disco.

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 tipos de armazenamento disponíveis para uma instância de StarRocks

GET https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/htap/storage-type/star-rocks?version_name=3.1.6.0

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "storage_type" : [ {
    "name" : "ULTRAHIGH",
    "az_status" : {
      "cn-southwest-244d" : "normal",
      "cn-southwest-244c" : "normal",
      "cn-southwest-244b" : "normal",
      "cn-southwest-244a" : "normal"
    },
    "min_volume_size" : 50
  }, {
    "name" : "ESSD",
    "az_status" : {
      "cn-southwest-244d" : "unsupported",
      "cn-southwest-244c" : "unsupported",
      "cn-southwest-244b" : "normal",
      "cn-southwest-244a" : "normal"
    },
    "min_volume_size" : 40
  } ]
}

Código de status: 400

Erro do cliente.

{
    "error_msg": "The DB engine or version is not supported."
    "error_code": "DBS.280238",
}

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.