Consulta de grupos de recursos dedicados
Función
Esta API se utiliza para obtener información sobre todos los grupos de recursos dedicados que ha creado. Antes de invocar a esta API:
- Aprender cómo autorizar y autenticarla.
- Obtenga la región y el punto de conexión requeridos.
URI
GET /v3/{project_id}/dedicated-resources
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
project_id |
Sí |
String |
ID de proyecto de un tenant en una región. Para obtener este valor, vea Obtención de un ID de proyecto. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
offset |
No |
Integer |
Desplazamiento de índice. Si offset se establece en N, la consulta de recursos comienza desde el dato N+1. El valor es 0 de forma predeterminada, lo que indica que la consulta comienza desde el primer dato. El valor no puede ser un número negativo. |
|
limit |
No |
Integer |
Número de registros a consultar. El valor predeterminado es 100. El valor debe ser un número positivo entero. El valor mínimo es de 1 y el valor máximo de 100. |
Parámetros de solicitud
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
X-Auth-Token |
Sí |
String |
Token de usuario. Para obtener este valor, invoque a la API de IAM para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token. |
|
X-Language |
No |
String |
Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:
|
Parámetros de respuesta
Código de estado: 200
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
resources |
Array of DedicatedResource objects |
Información del grupo de recursos dedicado. |
|
total_count |
Integer |
Número de grupos de recursos dedicados. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
id |
String |
ID del grupo de recursos dedicado. |
|
resource_name |
String |
Nombre del grupo de recursos dedicado. |
|
engine_name |
String |
Motor de base de datos. |
|
architecture |
String |
Arquitectura de CPU. |
|
status |
String |
Estado del grupo de recursos dedicados. Valores:
Valores enumerados:
|
|
capacity |
DedicatedResourceCapacity object |
Capacidad del fondo de recursos dedicado. |
|
availability_zone |
Array of strings |
AZ donde se despliega el grupo de recursos dedicado. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
ram |
Integer |
Tamaño de la memoria en GB. |
|
volume |
Long |
Capacidad del disco en GB. |
|
vcpus |
Integer |
Número de vCPU. |
Código de estado: 400
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
error_code |
String |
Código de error. |
|
error_msg |
String |
Mensaje de error. |
Código de estado: 500
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
error_code |
String |
Código de error. |
|
error_msg |
String |
Mensaje de error. |
Solicitud de ejemplo
Consulta de grupos de recursos dedicados
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/dedicated-resources
Ejemplo de respuesta
Código de estado: 200
Operación exitosa.
{
"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 estado
Para más detalles, véase Códigos de estado.
Código de error
Para más detalles, véase Códigos de error.
