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:
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
GET /v3/{project_id}/htap/storage-type/{database}
| 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:
|
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| version_name | Sim | String | Número da versão principal do BD. |
Parâmetros 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:
|
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| storage_type | Array of storage_type objects | Tipo de armazenamento. |
| 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
| Parâmetro | Tipo | Descrição |
|---|---|---|
| error_code | String | Código de erro. |
| error_msg | String | Mensagem de erro. |
Código de status: 500
| 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.