Lists logical routers that are accessible to the tenant who submits the request.This operation lists routers for the specified tenant. Default policy settings return only those routers
that are owned by the tenant who submits the request, unless an admin user submits the request. You can
control which attributes are returned by using the fields query parameter, and you can
specify how many results to return per page. For information, see
Filtering
Requests
or
Pagination
of Requests
in the Cloud Networks API Developer Guide.{
"routers":
[
{
"status": "ACTIVE",
"external_gateway_info": null,
"name": "second_routers",
"admin_state_up": true,
"tenant_id": "6b96ff0cb17a4b859e1e575d221683d3",
"id": "7177abc4-5ae9-4bb7-b0d4-89e94a4abf3b"
},
{
"status": "ACTIVE",
"external_gateway_info":
{
"network_id": "3c5bcddd-6af9-4e6b-9c3e-c153e521cab8"
},
"name": "router1",
"admin_state_up": true,
"tenant_id": "33a40233088643acb66ff6eb0ebea679",
"id": "a9254bdb-2613-4a13-ac4c-adc581fba50d"
}
]
}The router status.The network_id, for the external gateway.The router name.The administrative state of the router. (True if up or
False if down)The tenant ID.The router ID.Creates a logical router.This operation creates a new logical router. When it is created, a logical router does not have any
internal interface, and it is not associated to any subnet. You can optionally specify an external gateway
for a router at creation time. The external gateway for the router must be plugged into an external network,
which has its extended field router:external set to true. To specify an
external gateway, the identifier of the external network must be passed in the
external_gateway_info parameter in the request body, as follows:
"external_gateway_info" :
{
"network_id": external_network_uuid
}
{
"router":
{
"name": "another_router",
"admin_state_up": true
}
}A router object.The router name.The administrative state of the router (True if up or
False if down).{
"router":
{
"status": "ACTIVE",
"external_gateway_info": null,
"name": "another_router",
"admin_state_up": true,
"tenant_id": "6b96ff0cb17a4b859e1e575d221683d3",
"id": "8604a0de-7f6b-409a-a47c-a1cc7bc77b2e"
}
}A router object.The router status.The network_id, for the external gateway.The router name.The administrative state of the router. (True if up or
False if down)The tenant ID.The router ID.The UUID of the
router.Shows details for the specified router.This operation shows details for the specified router. You can control which parameters are returned by
using the fields query parameter, and you can specify how many results to return per
page. For information, see
Filtering
Requests
or
Pagination
of Requests
in the Cloud Networks API Developer Guide.{"router":
{
"status": "ACTIVE",
"external_gateway_info":
{
"network_id": "3c5bcddd-6af9-4e6b-9c3e-c153e521cab8"
},
"name": "router1",
"admin_state_up": true,
"tenant_id": "33a40233088643acb66ff6eb0ebea679",
"id": "a9254bdb-2613-4a13-ac4c-adc581fba50d"
}
}A routers object.The router status.The network_id, for the external gateway.The router name.The administrative state of the router. (True if up or
False if down)The tenant ID.The router ID.Updates the specified router.This operation updates any of the name, admin_state_up, and
external_gateway_info parameters for the specified router. For more information
about how to set the external_gateway_info parameter for a router, see
.This operation does not allow you to update the router interfaces. To update a router, use
and
operations. {
"router":
{
"status": "ACTIVE",
"external_gateway_info": null,
"name": "another_router",
"admin_state_up": true,
"tenant_id": "6b96ff0cb17a4b859e1e575d221683d3",
"id": "8604a0de-7f6b-409a-a47c-a1cc7bc77b2e"
}
}A routers object.The router status.The network_id, for the external gateway.The router name.The administrative state of the router. (True if up or
False if down)The tenant ID.The router ID.{
"router":
{
"status": "ACTIVE",
"external_gateway_info":
{
"network_id": "8ca37218-28ff-41cb-9b10-039601ea7e6b"
},
"name": "another_router",
"admin_state_up": true,
"tenant_id": "6b96ff0cb17a4b859e1e575d221683d3",
"id": "8604a0de-7f6b-409a-a47c-a1cc7bc77b2e"
}
}A router object.The router status.The network_id, for the external gateway.The router name.The administrative state of the router. (True if up or
False if down)The tenant ID.The router ID.Deletes the logical router and its external gateway interface.This operation deletes the specified router and, if present, its external gateway interface.The operation fails if the router has attached interfaces.Use the
operation to remove all router interfaces before you delete the router.The UUID of the
router.Adds an internal interface to the specified logical router.This operation attaches a subnet to an internal router interface. You must specify either a
subnet_id or a port_id parameter in the request body. If you
specify both IDs, the operation returns a 400 Bad Request error.If you specify a subnet_id parameter in the request body, the gateway IP address for
the subnet is used to create the router interface.If you specify a port_id parameter in the request body, the IP address associated with
the port is used to create the router interface.If either multiple IP addresses are associated with the specified port, or if no IP address is
associated with the specified port, the operation returns a 400 Bad Request
error.If the port is already used, the operation returns a 409 Conflict error.The port id that is returned by this operation can either be the same ID passed in
the request body or the ID of a new port created by this operation to attach the specified subnet to the
router. After you run this operation, the device_id parameter of this port is set to
the ID of the router, and the device_ownerparameter is set to
network:router_interface, as shown in this example:{
"port":{
"status":"ACTIVE",
"name":"",
"admin_state_up":true,
"network_id":"5307648b-e836-4658-8f1a-ff7536870c64",
"tenant_id":"6b96ff0cb17a4b859e1e575d221683d3",
"device_owner":"network:router_interface",
"mac_address":"fa:16:3e:f7:d1:9c",
"fixed_ips":[
{
"subnet_id":"a2f1f29d-571b-4533-907f-5803ab96ead1",
"ip_address":"10.1.1.1"
}
],
"id":"3a44f4e5-1694-493a-a1fb-393881c673a4",
"device_id":"7177abc4-5ae9-4bb7-b0d4-89e94a4abf3b"
}{
"subnet_id": "a2f1f29d-571b-4533-907f-5803ab96ead1"
}The subnet ID.The port ID.{
"subnet_id": "a2f1f29d-571b-4533-907f-5803ab96ead1",
"port_id": "3a44f4e5-1694-493a-a1fb-393881c673a4"
}The subnet ID.The port ID.The UUID of the
router.Removes an internal interface from the specified logical router.This operation removes an internal router interface, which detaches a subnet from the router. It also
removes the port connecting the router with the subnet from that subnet.You must specify a subnet_id parameter, a port_id, or both
subnet_id and port_id parameters in the request body, which
will identify the router interface to remove.If you specify both IDs, the subnet_id parameter must correspond to the
subnet_id of the first IP address on the port specified by the
port_id parameter. Otherwise, the operation returns a 409
Conflict error. The response contains information about the affected router and
interface.If the router, subnet, or port either do not exist or are not visible to you, the operation returns a
404 Not Found.{
"subnet_id": "a2f1f29d-571b-4533-907f-5803ab96ead1"
}The subnet ID.The port ID.{
"id": "8604a0de-7f6b-409a-a47c-a1cc7bc77b2e",
"tenant_id": "2f245a7b-796b-4f26-9cf9-9e82d248fda7",
"port_id": "3a44f4e5-1694-493a-a1fb-393881c673a4",
"subnet_id": "a2f1f29d-571b-4533-907f-5803ab96ead1"
}The router ID.The tenant ID.The port ID.The subnet ID.