Consulta de ECS por etiqueta
Función
Esta API se utiliza para filtrar ECS por etiqueta y obtener todas las etiquetas y recursos utilizados por un ECS.
URI
POST /v1/{project_id}/cloudservers/resource_instances/action
Parámetro |
Obligatorio |
Descripción |
---|---|---|
project_id |
Sí |
Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto. |
Solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
action |
Sí |
String |
Especifica la operación. El valor filter indica que se deben filtrar los ECS por etiqueta. Se muestran los ECS que cumplen los criterios de filtro. |
limit |
No |
String |
Limita el número máximo de ECS consultados. El valor no puede ser un número negativo. El valor máximo es 1000.
|
offset |
No |
String |
Especifica el inicio del registro que se va a devolver. El valor debe ser un número que sea mayor o igual a 0. Este parámetro es opcional cuando se consultan los datos de la primera página.
|
tags |
No |
Array of objects |
Muestra los ECS con todas las etiquetas especificadas. Para más detalles, consulte Tabla 3.
|
not_tags |
No |
Array of strings |
Muestra los ECS sin ninguna de las etiquetas especificadas.
|
matches |
No |
Array of objects |
Especifica el campo de búsqueda, que se utiliza para buscar ECS. Actualmente, solo se puede usar resource_name para la búsqueda. Para obtener más información, consulte Tabla 4. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
key |
Sí |
String |
Especifica la clave de etiqueta.
|
values |
Sí |
Array of strings |
Especifica los valores de etiqueta.
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
key |
Sí |
String |
Especifica el campo de clave que se va a hacer coincidir. La clave de etiqueta solo puede ser resource_name. En tal caso, el valor de etiqueta es el nombre de ECS.
|
value |
Sí |
String |
Especifica el valor de etiqueta. La clave de etiqueta solo puede ser resource_name. En tal caso, el valor de etiqueta es el nombre de ECS.
|
Respuesta
Parámetros de respuesta
Tabla 5 describe los parámetros de respuesta.
Parámetro |
Tipo |
Descripción |
---|---|---|
resources |
Array of objects |
Especifica los ECS devueltos. Para más detalles, consulte Tabla 6. |
total_count |
Integer |
Especifica el número total de ECS consultados. |
Parámetro |
Tipo |
Descripción |
---|---|---|
resource_id |
String |
Especifica el ID del ECS. |
resource_detail |
String |
Reservada |
tags |
Array of objects |
Enumera las etiquetas. |
resource_name |
String |
Especifica el nombre del recurso, que es el nombre de ECS. |
Parámetro |
Tipo |
Descripción |
---|---|---|
key |
String |
Especifica la clave de etiqueta.
|
value |
String |
Especifica el valor de etiqueta.
|
Ejemplos
- Ejemplo de la solicitud
POST https://{endpoint}/v1/{project_id}/cloudservers/resource_instances/action
{ "offset": "100", "limit": "1", "action": "filter", "matches":[ { "key": "resource_name", "value": "ecs_test" }], "tags": [ { "key": "key1", "values": [ "value1", "value2" ] }] }
- Ejemplo de la respuesta
{ "resources": [ { "resource_detail": null, "resource_id": "31760ffa-6711-406d-bc94-bce4ae925a8a", "resource_name": "ecs_test", "tags": [ { "key": "key1", "value": "value1" } ] } ], "total_count": 1000 }
Valores devueltos
Códigos de error
Consulte Códigos de error