Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Elastic Load Balance> Referencia de la API> API del balanceador de carga dedicado> Grupo de direcciones IP> Creación de un grupo de direcciones IP

Actualización más reciente 2022-11-17 GMT+08:00

Ver PDF

Creación de un grupo de direcciones IP

Función

Esta API se utiliza para crear un grupo de direcciones IP. La dirección IP puede contener direcciones IP o bloques CIDR, y se admiten direcciones IPv4 e IPv6. 0.0.0.0 se considerará igual que 0.0.0.0/32. Si introduce tanto 0.0.0.0 como 0.0.0.0/32, solo se conservará uno. 0:0:0:0:0:0:0:1 se considerará igual que ::1 y ::1/128. Si escribe 0:0:0:0:0:0:0:0:1, ::1 y ::1/128, sólo se conservará uno. Esta función no se admite en la región eu-nl. Por favor, no lo use.

URI

POST /v3/{project_id}/elb/ipgroups

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del proyecto.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token utilizado para la autenticación IAM.

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
ipgroup	Sí	CreateIpGroupOption object	Especifica el cuerpo de la solicitud para crear un grupo de direcciones IP.

**Tabla 4** CreateIpGroupOption
Parámetro	Obligatorio	Tipo	Descripción
project_id	No	String	Especifica el ID de proyecto del grupo de direcciones IP. Mínimo: 32 Máximo: 32
description	No	String	Proporciona información adicional sobre el grupo de direcciones IP. Mínimo: 0 Máximo: 255
name	No	String	Especifica el nombre del grupo de direcciones IP. Mínimo: 0 Máximo: 255
ip_list	Sí	Array of CreateIpGroupIpOption objects	Especifica las direcciones IP o bloques CIDR en el grupo de direcciones IP. [] indica cualquier dirección IP.
enterprise_project_id	No	String	Especifica el ID del proyecto de empresa al que pertenece el grupo de direcciones IP.

**Tabla 5** CreateIpGroupIpOption
Parámetro	Obligatorio	Tipo	Descripción
ip	Sí	String	Especifica las direcciones IP del grupo de direcciones IP. Se admiten tanto IPv4 como IPv6. IPv6 no es compatible. El valor no puede ser una dirección IPv6.
description	No	String	Proporciona comentarios sobre el grupo de direcciones IP. Mínimo: 0 Máximo: 255

Parámetros de respuesta

Código de estado: 201

**Tabla 6** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
ipgroup	IpGroup object	Especifica el cuerpo de la respuesta para crear un grupo de direcciones IP.
request_id	String	Especifica el ID de la solicitud. El valor se genera automáticamente.

**Tabla 7** IpGroup
Parámetro	Tipo	Descripción
created_at	String	Especifica la hora a la que se creó el grupo de direcciones IP.
description	String	Especifica la hora a la que se actualizó el grupo de direcciones IP.
id	String	Especifica el ID del grupo de direcciones IP.
ip_list	Array of IpInfo objects	Especifica las direcciones IP o bloques CIDR en el grupo de direcciones IP. [] indica cualquier dirección IP.
listeners	Array of ListenerRef objects	Muestra los identificadores de oyentes con los que está asociado el grupo de direcciones IP.
name	String	Especifica el nombre del grupo de direcciones IP.
project_id	String	Especifica el ID de proyecto del grupo de direcciones IP.
updated_at	String	Especifica la hora a la que se actualizó el grupo de direcciones IP.

**Tabla 8** IpInfo
Parámetro	Tipo	Descripción
ip	String	Especifica las direcciones IP del grupo de direcciones IP. IPv6 no es compatible. No introduzca direcciones IPv6.
description	String	Proporciona comentarios sobre el grupo de direcciones IP. Mínimo: 0 Máximo: 255

**Tabla 9** ListenerRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID del listener.

Solicitudes de ejemplo

Creación de un grupo de direcciones IP

POST https://{ELB_Endpoint}/v3/45977fa2dbd7482098dd68d0d8970117/elb/ipgroups

{
  "ipgroup" : {
    "name" : "test_ipg",
    "ip_list" : [ {
      "ip" : "192.168.1.123"
    }, {
      "ip" : "192.168.3.0/24",
      "description" : "test_ip"
    }, {
      "ip" : "2001:0DB8:02de:0000:0000:0000:0000:0e13"
    } ]
  }
}

Ejemplo de respuestas

Código de estado: 201

Respuesta normal a las solicitudes POST.

{
  "ipgroup" : {
    "description" : "",
    "id" : "8722e0e0-9cc9-4490-9660-8c9a5732fbb0",
    "name" : "test_ipg",
    "project_id" : "45977fa2dbd7482098dd68d0d8970117",
    "ip_list" : [ {
      "ip" : "192.168.1.123",
      "description" : ""
    }, {
      "ip" : "192.168.3.0/24",
      "description" : "test_ip"
    } ],
    "listeners" : [ {
      "id" : "88f9c079-29cb-435a-b98f-0c5c0b90c2bd"
    }, {
      "id" : "2f4c9644-d5d2-4cf8-a3c0-944239a4f58c"
    } ],
    "created_at" : "2018-01-16T03:19:16",
    "updated_at" : "2018-01-16T03:19:16"
  }
}