Consulta de pools de recursos dedicados
Função
Essa API é usada para obter informações sobre todos os pools de recursos dedicados que você criou. 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}/dedicated-resources
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. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
offset |
Não |
Integer |
Deslocamento do índice. Se offset for definido como N, a consulta de recursos será iniciada a partir da parte N+1 dos dados. O valor é 0 por padrão, indicando que a consulta começa a partir da primeira parte dos dados. O valor não pode ser um número negativo. |
limit |
Não |
Integer |
Número de registros a serem consultados. O valor padrão é 100. o valor deve ser um número inteiro positivo. O valor mínimo é 1 e o valor máximo é 100. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Token do usuário. Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida. Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token. |
X-Language |
Não |
String |
Tipo de linguagem da solicitação. O valor padrão é en-us. Valor:
|
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
resources |
Array of DedicatedResource objects |
Informações de pools de recursos dedicados. |
total_count |
Integer |
Número de pools de recursos dedicados. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
id |
String |
ID do pool de recursos dedicado. |
resource_name |
String |
Nome do pool de recursos dedicado. |
engine_name |
String |
Mecanismo de BD. |
architecture |
String |
Arquitetura da CPU. |
status |
String |
Status do pool de recursos dedicado. Valor:
|
capacity |
DedicatedResourceCapacity object |
Capacidade do pool de recursos dedicado. |
availability_zone |
Array of strings |
AZ onde o pool de recursos dedicado é implementado. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
ram |
Integer |
Tamanho da memória em GB. |
volume |
Long |
Capacidade do disco em GB. |
vcpus |
Integer |
Número de vCPUs. |
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 pools de recursos dedicados
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/dedicated-resources
Exemplo de resposta
Código de status: 200
Bem-sucedido.
{ "resources" : [ { "id" : "1d07f7ba-f140-46a7-b002-58ba22ee6ff3", "resource_name" : "testdcc", "engine_name" : "gaussdb-mysql", "architecture" : "ARM", "status" : "NORMAL", "capacity" : { "ram" : 256, "volume" : 10000000, "vcpus" : 64 }, "availability_zone" : [ "az1xahz" ] } ] }
Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.