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}
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
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
String |
Especifica el token utilizado para la autenticación IAM. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
ipgroup |
Sí |
UpdateIpGroupOption object |
Especifica el grupo de direcciones IP. |
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. |
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
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. |
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. |
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.