Actualización de un balanceador de carga
Función
Esta API se utiliza para actualizar el nombre o la descripción de un balanceador de carga.
URI
PUT /v2/{project_id}/elb/loadbalancers/{loadbalancer_id}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
Especifica el ID del proyecto. |
loadbalancer_id |
Sí |
String |
Especifica el ID del balanceador de carga. |
Solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
loadbalancer |
Sí |
Loadbalancer object |
Especifica el balanceador de carga. Para más detalles, consulte Tabla 3. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
name |
No |
String |
Especifica el nombre del balanceador de carga. El valor contiene un máximo de 255 caracteres. |
description |
No |
String |
Proporciona información adicional sobre el balanceador de carga. El valor contiene un máximo de 255 caracteres. |
admin_state_up |
No |
Boolean |
Especifica el estado administrativo del balanceador de carga. Este parámetro está reservado y el valor predeterminado es true. |
Respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
loadbalancer |
Loadbalancer object |
Especifica el balanceador de carga. Para más detalles, consulte Tabla 5. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del balanceador de carga. |
project_id |
String |
Especifica el ID del proyecto en el que se utiliza el balanceador de carga. |
tenant_id |
String |
Especifica el ID del proyecto en el que se utiliza el balanceador de carga. El valor contiene un máximo de 255 caracteres. |
name |
String |
Especifica el nombre del balanceador de carga. El valor contiene un máximo de 255 caracteres. |
description |
String |
Proporciona información adicional sobre el balanceador de carga. El valor contiene un máximo de 255 caracteres. |
vip_subnet_id |
String |
Especifica el ID de red IPv4 de la subred en la que funciona el balanceador de carga. |
vip_port_id |
String |
Especifica el ID del puerto enlazado a la dirección IP privada del balanceador de carga. |
provider |
String |
Especifica el proveedor del balanceador de carga. |
vip_address |
String |
Especifica la dirección IP privada del balanceador de carga. El valor incluye un máximo de 64 caracteres. |
listeners |
Array of Listeners objects |
Muestra los ID de oyentes agregados al balanceador de carga. Para más detalles, consulte Tabla 6. |
pools |
Array of Pools objects |
Muestra los ID de los grupos de servidores backend asociados con el balanceador de carga. Para más detalles, consulte Tabla 7. |
operating_status |
String |
Este parámetro está reservado, y su valor puede ser ONLINE o FROZEN. Especifica el estado de funcionamiento del balanceador de carga. |
provisioning_status |
String |
Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento del balanceador de carga. |
admin_state_up |
Boolean |
Especifica el estado administrativo del balanceador de carga. Este parámetro está reservado. El valor puede ser true o false.
|
tags |
Array |
Enumera las etiquetas de balanceador de carga. |
created_at |
String |
Especifica la hora en que se creó el balanceador de carga. La hora UTC está en formato AAAA-MM-DDTHH:MM:SS. El valor contiene un máximo de 19 caracteres. |
updated_at |
String |
Especifica la hora a la que se actualizó el balanceador de carga. La hora UTC está en formato AAAA-MM-DDTHH:MM:SS. El valor contiene un máximo de 19 caracteres. |
enterprise_project_id |
String |
Especifica el ID del proyecto de empresa. Al crear un balanceador de carga, puede asignar un proyecto de empresa al balanceador de carga. El valor es una string de caracteres 0 o un UUID con guiones (-). El valor 0 indica el proyecto de empresa predeterminado.
NOTA:
Para obtener más información acerca de los proyectos de empresa y cómo obtener los ID de proyecto de empresa, consulte Guía del usuario de Enterprise Management. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del oyente asociado. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del grupo de servidores backend asociado. |
Ejemplo de la solicitud
- Ejemplo de la solicitud
PUT https://{Endpoint}/v2/145483a5107745e9b3d80f956713e6a3/elb/loadbalancers/1e11b74e-30b7-4b78-b09b-84aec4a04487 { "loadbalancer": { "name": "lb_update_test", "description": "lb update test" } }
Ejemplo de la respuesta
- Ejemplo de la respuesta
{ "loadbalancer": { "description": "simple lb2", "admin_state_up": true, "tenant_id": "145483a5107745e9b3d80f956713e6a3", "project_id": "145483a5107745e9b3d80f956713e6a3", "provisioning_status": "ACTIVE", "vip_subnet_id": "823d5866-6e30-45c2-9b1a-a1ebc3757fdb", "listeners": [ { "id": "37ffe679-08ef-436e-b6bd-cf66fb4c3de2" } ], "vip_address": "192.172.1.68", "vip_port_id": "f42e3019-67f7-4d2a-8d1c-af49e7c22fa6", "provider": "vlb", "tags": [], "pools": [ { "id": "75c4f2d4-a213-4408-9fa8-d64708e8d1df" } ], "id": "c32a9f9a-0cc6-4f38-bb9c-cde79a533c19", "operating_status": "ONLINE", "name": "loadbalancer-test2", "created_at": "2018-07-25T01:54:13", "updated_at": "2018-07-25T01:54:14", "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2" } }
Código de estado
Para más detalles, consulte Códigos de estado.