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/ Creación de un router

Actualización más reciente 2025-08-25 GMT+08:00

Ver PDF

Creación de un router

Función

Esta API se utiliza para crear un router.

URI

POST /v2.0/routers

Mensaje de solicitud

**Tabla 1** Parámetro de solicitud
Parámetro	Tipo	Obligatorio	Descripción
router	router object	Sí	Especifica el router. Para obtener más información, véase Tabla 2.

**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.

**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.

Ejemplo de la solicitud

POST https://{Endpoint}/v2.0/routers 
{
    "router": {
           "name": "router-test2",
           "admin_state_up": true
    }
}

Mensaje de la respuesta

**Tabla 4** Parámetro de respuesta
Parámetro	Tipo	Descripción
router	router object	Especifica el router. Para obtener más información, véase Tabla 5.

**Tabla 5** Objetos de **router**
Atributo	Tipo	Descripción
id	String	Especifica el ID del router. Este parámetro no es obligatorio cuando consulta los enrutadores.
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 7.
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 6** 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 7** 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-test2",
        "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"
    }
}