Creación de un router
Función
Esta API se utiliza para crear un router.
URI
POST /v2.0/routers
Mensaje 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. |
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. |
Ejemplo de la solicitud
POST https://{Endpoint}/v2.0/routers { "router": { "name": "router-test2", "admin_state_up": true } }
Mensaje de la respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
router |
router object |
Especifica el router. Para obtener más información, véase Tabla 5. |
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 |
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. |
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" } }
Código de estado
Véase Códigos de estado.
Código de error
Véase Códigos de error.