Creación de un grupo de protección
Función
Esta API se utiliza para crear un grupo de protección.
Método de invocación
Para obtener más información, consulte Invocación de las API.
URI
POST /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ámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| security_protection_group | Sí | Definición La información sobre el grupo de protección. Restricciones N/D Rango N/D Valor predeterminado N/D |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| name | Sí | String | Definición El nombre del grupo de protección. Restricciones El valor no puede estar vacío y puede contener un máximo de 64 caracteres. Rango N/D Valor predeterminado N/D |
| availability_zone | Sí | 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. Restricciones El valor es obligatorio. Puede contener un máximo de 128 caracteres, que solo pueden ser letras, dígitos, guiones medios (-), guiones bajos (_) y puntos (.). Rango N/D Valor predeterminado N/D |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| security_protection_group | Definición La información sobre el grupo 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
POST https://{endpoint}/v5/{project_id}/security-protection-groups
{
"security_protection_group" : {
"name" : "security-protection-group-001",
"availability_zone" : "az1"
}
} Ejemplos de respuestas
Código de estado: 200
OK
{
"security_protection_group" : {
"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.
