Listado de grupos de protección
Función
Esta API se utiliza para listar grupos de protección.
Método de invocación
Para obtener más información, consulte Invocación de las API.
URI
GET /v5/{project_id}/security-protection-groups
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | Definición El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto. Restricciones N/D Rango N/D Valor predeterminado N/D |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| X-Auth-Token | Sí | String | Definición El token de usuario. Puede obtenerlo invocando la API de IAM para obtener un token de usuario. El token es el valor de X-Subject-Token en el encabezado de respuesta. Restricciones N/D Rango N/D Valor predeterminado N/D |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| security_protection_groups | Array of SecurityProtectionGroupDetail objects | Definición La lista de grupos de protección. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | String | Definición El ID del grupo de protección. Rango N/D |
| name | String | Definición El nombre del grupo de protección. Rango N/D |
| availability_zone | String | Definición La zona de disponibilidad del grupo de protección. Puede invocar la API Consulta de todas las zonas de disponibilidad o consultar Regiones y puntos de conexión para obtener la información de la zona de disponibilidad. Rango N/D |
| protection_domains | Array of ProtectionDomainDetail objects | Definición La información sobre todos los dominios de protección del grupo de protección. Rango N/D |
| created_at | String | Definición La hora en que se creó el grupo de protección. Rango N/D |
| updated_at | String | Definición La hora en que se actualizó el grupo de protección. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | String | Definición El ID del dominio de protección. Rango N/D |
| name | String | Definición El nombre del dominio de protección. Rango El valor se fija en PD1, PD2 o PD3. |
| volume_count | Integer | Definición La cantidad de discos en el dominio de protección. Rango N/D |
Código de estado: 400
| Parámetro | Tipo | Descripción |
|---|---|---|
| error | Error object | Definición La información de error devuelta si se produce un error. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | String | Definición El código de error devuelto si se produce un error. Rango Para obtener más información sobre el código de error, consulte Códigos de error. |
| message | String | Definición El mensaje de error devuelto si se produce un error. Rango N/D |
Ejemplos de solicitudes
Ninguna
Ejemplos de respuestas
Código de estado: 200
OK
{
"security_protection_groups" : [ {
"id" : "9ca00844-f8de-4184-9771-de792b728c28",
"name" : "test_name",
"availability_zone" : "az1.dc1",
"protection_domains" : [ {
"id" : "f96af29c-0212-4f94-a951-3b278ec6c776",
"name" : "PD1",
"volume_count" : 0
}, {
"id" : "cdb6c00a-b822-4733-bcb6-4b8b3479e8af",
"name" : "PD2",
"volume_count" : 0
}, {
"id" : "3a214fe1-6b5d-4b51-8376-2f1d4586741e",
"name" : "PD3",
"volume_count" : 0
} ],
"created_at" : "2025-06-30T09:34:44.483388",
"updated_at" : "2025-06-30T09:34:44.488778"
} ]
} Código de estado: 400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "EVS.XXX"
}
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | OK |
| 400 | Bad Request |
Códigos de error
Consulte Códigos de error.
