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/ Actualización de un grupo de direcciones IP
Actualización más reciente 2022-11-17 GMT+08:00
Ver PDF
Compartir

Actualización de un grupo de direcciones IP

Función

Esta API se utiliza para actualizar un grupo de direcciones IP. Todas las direcciones IP del grupo de direcciones IP se sobrescribirán, y las direcciones IP que no están incluidas en el parámetro ip_list en el cuerpo de la solicitud se eliminarán. 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

PUT /v3/{project_id}/elb/ipgroups/{ipgroup_id}

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

ipgroup_id

Sí

String

Especifica el ID del grupo de direcciones IP.

project_id

Sí

String

Especifica el ID del proyecto.

Parámetros de solicitud

Tabla 2 Parámetros de cabecera 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 del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

ipgroup

Sí

UpdateIpGroupOption object

Especifica el grupo de direcciones IP.
Tabla 4 UpdateIpGroupOption

Parámetro

Obligatorio

Tipo

Descripción

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

No

Array of UpadateIpGroupIpOption objects

Muestra las direcciones IP del grupo de direcciones IP.
Tabla 5 UpadateIpGroupIpOption

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. No introduzca direcciones 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: 200

Tabla 6 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

ipgroup

IpGroup object

Especifica el 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 de oyente.

Ejemplo de las solicitudes

Actualización de un grupo de direcciones IP

PUT https://{ELB_Endpoint}/v3/45977fa2dbd7482098dd68d0d8970117/elb/ipgroups/8722e0e0-9cc9-4490-9660-8c9a5732fbb0

{
  "ipgroup" : {
    "name" : "test_ipg",
    "ip_list" : [ {
      "ip" : "192.168.1.123"
    }, {
      "ip" : "192.168.3.0/24",
      "description" : "test_ip"
    } ]
  }
}

Ejemplo de las respuestas

Código de estado: 200

Solicitud exitosa.

{
  "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"
  } ]
}

Códigos de estado

Código de estado

Descripción

200

Solicitud exitosa.

Códigos de error

Consulte Códigos de error.

Tema principal: Grupo de direcciones IP