Consulta de especificações de uma instância de HTAP
Função
Essa API é usada para consultar especificações 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/flavors/{engine_name}
|
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. |
|
engine_name |
Sim |
String |
Nome do mecanismo HTAP. Valores:
|
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
availability_zone_mode |
Não |
String |
Modo de AZ. Atualmente, apenas uma única AZ é suportada. |
|
spec_code |
Não |
String |
Código de especificação. Se este parâmetro for especificado, somente o código de especificação especificado será consultado. |
|
version_name |
Não |
String |
Número da versão do BD. Se esse parâmetro for deixado em branco, o valor padrão 3.1.6.0 será usado. |
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 |
|---|---|---|
|
flavors |
Array of flavors objects |
Informações de especificação. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
type |
String |
Tipo de especificação. O valor pode ser arm, x86 ou generalX86.
|
|
vcpus |
String |
Número de vCPUs. Por exemplo, o valor 1 indica 1 vCPU. |
|
ram |
String |
Tamanho da memória em GB. |
|
id |
String |
ID da especificação. O valor é único. |
|
spec_code |
String |
Código de especificação do recurso. Seu valor é o mesmo que o valor de flavor_ref. Exemplo: gaussdb.sr-be.xlarge.x86.4
|
|
version_name |
String |
Número da versão do BD. |
|
instance_mode |
String |
Tipo de instância. O valor pode ser Cluster ou Single. |
|
az_status |
Map<String,String> |
Status da especificação na AZ. O valor pode ser qualquer um dos seguintes:
|
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 especificações do StarRocks
GET https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/htap/flavors/star-rocks?availability_zone_mode=single
Exemplo de resposta
Código de status: 200
Bem-sucedido.
{
"flavors" : [ {
"type" : "x86",
"vcpus" : "4",
"ram" : "16",
"id" : "de565db8-0a96-37ea-9388-61167624712c",
"spec_code" : "gaussdb.sr-be.xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "4",
"ram" : "16",
"id" : "afef3bfd-ac7c-32e1-ba44-c388acbb196a",
"spec_code" : "gaussdb.sr-fe.xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "8",
"ram" : "32",
"id" : "c50e8e15-f2fc-3b40-aca6-c98f07ce2ce0",
"spec_code" : "gaussdb.sr-be.2xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "8",
"ram" : "32",
"id" : "24059750-4280-3ee5-a44b-488b924633b4",
"spec_code" : "gaussdb.sr-fe.2xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "16",
"ram" : "64",
"id" : "a48c63dc-5563-3813-9e13-39d3301e56f4",
"spec_code" : "gaussdb.sr-be.4xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "16",
"ram" : "64",
"id" : "0ef44c01-f7a1-30f5-9f05-9e47094e8c1f",
"spec_code" : "gaussdb.sr-fe.4xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "32",
"ram" : "128",
"id" : "2bf6aa50-50da-3f27-91af-a8c873070537",
"spec_code" : "gaussdb.sr-fe.8xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "normal"
}
}, {
"type" : "x86",
"vcpus" : "32",
"ram" : "128",
"id" : "9f52a065-aa93-371a-9975-959fedf6e24f",
"spec_code" : "gaussdb.sr-be.8xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "normal"
}
}, {
"type" : "x86",
"vcpus" : "64",
"ram" : "256",
"id" : "709822e4-567f-3e85-b4af-cb099206c8e2",
"spec_code" : "gaussdb.sr-fe.16xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "64",
"ram" : "256",
"id" : "4e56e208-0226-34bb-b84d-035ab0497824",
"spec_code" : "gaussdb.sr-be.16xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
} ]
}
Código de status: 400
Erro do cliente.
{
"error_msg" : "Invalid specification code.",
"error_code" : "DBS.280434"
}
Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.
