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/ Virtual Private Cloud/ Referencia de la API/ API nativa de OpenStack Neutron (V2.0)/ Router/ Actualización de un router
Actualización más reciente 2025-08-25 GMT+08:00
Ver PDF
Compartir

Actualización de un router

Función

Esta API se utiliza para actualizar un router.

URI

PUT /v2.0/routers/{router_id}

Mensaje de solicitud

Tabla 1 Parámetro de solicitud

Parámetro

Obligatorio

Tipo

Descripción

router

Sí

router object

Especifica el router. Para obtener más información, véase Tabla 2.

Debe especificar al menos un atributo al actualizar un router.
Tabla 2 Objetos de router

Atributo

Obligatorio

Tipo

Descripción

name

No

String

Especifica el nombre del router.

Instrucciones:

El nombre solo puede contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).

admin_state_up

No

Boolean

Especifica el estado administrativo.

El valor solo puede ser true.

external_gateway_info

No

external_gateway_info object

Especifica el gateway externo. Este es un atributo extendido. Para obtener más información, consulte los objetos de external_gateway_info.

routes

No

Array of route objects

Especifica una lista de rutas. Este es un atributo extendido. Para obtener más información, véase Tabla 4.
Tabla 3 Objetos de external_gateway_info

Atributo

Obligatorio

Tipo

Descripción

network_id

No

String

Especifica el UUID de la red externa.

Puede utilizar GET /v2.0/networks?router:external=True o ejecutar el comando neutron net-external-list para consultar información sobre la red externa.
Tabla 4 Objetos de route

Atributo

Obligatorio

Tipo

Descripción

destination

No

String

Especifica el intervalo de direcciones IP.

Instrucciones:

El prefijo no puede ser el mismo que el de una ruta directa.

nexthop

No

String

Especifica la dirección IP del salto siguiente. La dirección IP solo puede ser una en la subred asociada con el router.

Ejemplo de la solicitud

PUT https://{Endpoint}/v2.0/routers/f5dbdfe0-86f9-4b0a-9a32-6be143f0a076  
{
    "router": {
           "name": "router-220"
    }
}

Mensaje de la respuesta

Tabla 5 Parámetro de respuesta

Parámetro

Tipo

Descripción

router

router object

Especifica el router. Para obtener más información, véase Tabla 6.
Tabla 6 Objetos de router

Atributo

Tipo

Descripción

id

String

Especifica el ID del router.

Este parámetro no es obligatorio cuando consulta los routers.

name

String

Especifica el nombre del router.

El nombre solo puede contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).

admin_state_up

Boolean

Especifica el estado administrativo.

El valor solo puede ser true.

status

String

Especifica el estado del router. El valor puede ser ACTIVE, DOWN o ERROR.

tenant_id

String

Especifica el ID del proyecto.

external_gateway_info

external_gateway_info object

Especifica el gateway externo. Este es un atributo extendido. Para obtener más información, consulte los objetos de external_gateway_info.

routes

Array of route objects

Especifica una lista de rutas. Este es un atributo extendido. Para obtener más información, véase Tabla 8.

project_id

String

Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto.

created_at

String

Especifica la hora (UTC) cuando se crea el router.

Formato: aaaa-MM-ddTHH:mm:ss

updated_at

String

Especifica la hora (UTC) cuando se actualiza el router.

Formato: aaaa-MM-ddTHH:mm:ss
Tabla 7 Objetos de external_gateway_info

Atributo

Tipo

Descripción

network_id

String

Especifica el UUID de la red externa.

Puede utilizar GET /v2.0/networks?router:external=True o ejecutar el comando neutron net-external-list para consultar información sobre la red externa.

enable_snat

Boolean

Especifica si la función SNAT está habilitada.

El valor predeterminado es false.
Tabla 8 Objetos de route

Atributo

Tipo

Descripción

destination

String

Especifica el intervalo de direcciones IP.

nexthop

String

Especifica la dirección IP del salto siguiente. La dirección IP solo puede ser una en la subred asociada con el router.

Ejemplo de la respuesta

{
    "router": {
        "id": "f5dbdfe0-86f9-4b0a-9a32-6be143f0a076",
        "name": "router-220",
        "status": "ACTIVE",
        "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "admin_state_up": true,
        "external_gateway_info": {
            "network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
            "enable_snat": false
        },
        "routes": [],
        "created_at": "2018-09-20T02:06:07",
        "updated_at": "2018-09-20T02:06:09"
    }
}

Código de estado

Consulte Códigos de estado.

Código de error

Consulte Códigos de error.

Tema principal: Router