Gestionar tablas de enrutamiento
Requisitos previos
Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.
Actualizar tablas de enrutamiento
Para activar una actualización de las tablas de enrutamiento de su Fabric Cloud Router, envíe una solicitud POST al punto final /fabric/v4/routers/{uuid}/actions.
POST /fabric/v4/routers/{uuid}/actions | |
|---|---|
| Method | POST |
| URL or Endpoint | /fabric/v4/routers/{uuid}/actions |
| Headers | Authorization, Content-Type |
| Path Parameters | uuid |
| Query Parameters | Not applicable |
| Body Parameters | type |
Ejemplo de solicitud curl:
curl -X
POST 'https://api.equinix.com/fabric/v4/routers/{router_uuid}/actions'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
"type": "ROUTE_TABLE_ENTRY_UPDATE"
}'
Parámetros corporales:
-
type(obligatorio) string - La acción de gestión de la tabla de enrutamiento. Para actualizar sus tablas de enrutamiento, utiliceROUTE_TABLE_ENTRY_UPDATE. Para ver todos los prefijos aprendidos vía BGP, utiliceRECEIVED_ROUTE_ENTRY_UPDATE. Para ver los prefijos que FCR está enviando vía BGP, utiliceADVERTISED_ROUTE_ENTRY_UPDATE. -
connection(opcional) object - Objeto que contiene un campouuidpara especificar una conexión. Sólo se requiere para los tiposRECEIVED_ROUTE_ENTRY_UPDATEyADVERTISED_ROUTE_ENTRY_UPDATE.
Para obtener información completa sobre los parámetros y ejemplos, consulte la Referencia API.
Respuesta de muestra:
{
"type": "ROUTE_TABLE_ENTRY_UPDATE",
"uuid": "37c10edc-ba2e-4240-a850-8a48f9c47d00",
"state": "PENDING",
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z",
"updatedDateTime": "2021-08-15T19:30:29.526Z"
}
}
Obtener solicitudes de gestión de tablas de enrutamiento
Para obtener una lista de solicitudes de gestión de tablas de enrutamiento, envíe una solicitud GET al punto final /fabric/v4/routers/{uuid}/actions. Utilice el parámetro de consulta state para filtrar la respuesta por el estado de la solicitud.
GET /fabric/v4/routers/{uuid}/actions | |
|---|---|
| Method | GET |
| URL or Endpoint | /fabric/v4/routers/{uuid}/actions |
| Headers | Authorization |
| Path Parameters | uuid |
| Query Parameters | state |
| Body Parameters | Not applicable |
Esta API recupera las solicitudes de acciones de gestión de tablas de enrutamiento.
Ejemplo de solicitud curl
curl -X
GET 'https://api.equinix.com/fabric/v4/routers/{router_uuid}/actions?state=<state>'
-H 'authorization: Bearer <token>'
Parámetro de consulta:
state(opcional) string - Estado de ejecución de la acción. Valores aplicables:PENDING,SUCCEEDEDoFAILED.
Respuesta de muestra:
{
"type": "ROUTE_TABLE_ENTRY_UPDATE",
"uuid": "37c10edc-ba2e-4240-a850-8a48f9c47d00",
"state": "PENDING",
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z",
"updatedDateTime": "2021-08-15T19:30:29.526Z"
}
}
Búsqueda de tablas de enrutamiento Solicitudes de gestión
Para buscar solicitudes de gestión de tablas de enrutamiento, envíe una solicitud POST al punto final /fabric/v4/routers/{routerId}/actions/search, especificando los criterios de búsqueda en el cuerpo de la solicitud.
POST /fabric/v4/routers/{routerId}/actions/search | |
|---|---|
| Method | POST |
| URL or Endpoint | /fabric/v4/routers/{routerId}/actions/search |
| Headers | Authorization, Content-Type |
| Path Parameters | routerId |
| Query Parameters | Not applicable |
| Body Parameters | filter, pagination, sort |
Ejemplo de solicitud curl:
curl -X POST 'http: //api.equinix.com/fabric/v4/routers/{router_uuid}/actions/search'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
"filter": {
"and": [
{
"property": "/type",
"operator": "IN",
"values": [
"ROUTE_TABLE_ENTRY_UPDATE",
"RECEIVED_ROUTE_ENTRY_UPDATE"
]
},
{
"property": "/state",
"operator": "=",
"values": [
"SUCCEEDED"
]
},
{
"property": "/connection/uuid",
"operator": "IN",
"values": [
"3066ab1d-af87-49d7-8a14-c9bdb57ac809"
]
}
]
},
"pagination": {
"offset": 0,
"limit": 1
},
"sort": [
{
"property": "/changeLog/createdDateTime",
"direction": "DESC"
}
]
}'
Parámetros corporales notables:
-
filter(obligatorio) object - El objeto que define sus condiciones de búsqueda. -
and(obligatorio) array[objeto] - Un objeto array que sirve como operador lógico aplicado sobre los objetos de búsqueda en el array. Puede buscar en:property(obligatorio) string - Parámetro del campo de búsqueda. Tenga en cuenta que el valor de la propiedad determina la lista de operadores y valores aplicables. Valores aplicables:"/name","/uuid","/state","/location/metroCode","/location/metroName","/package/code"y una búsqueda de todas las categorías"\*".operator(obligatorio) string - Operador del parámetro del campo de búsqueda. Valores aplicables:"=","!=",">",">=","<","<=",BETWEEN,LIKE,IN,"NOT BETWEEN","NOT LIKE","NOT IN".value(obligatorio) array[cadena] - Valor del parámetro del campo de búsqueda.
-
paginationobject - Objeto opcional que contiene los ajustes de paginación de los resultados de búsqueda conoffsetinteger ylimitcampos integer. -
sortobject - Objeto opcional que define su configuración de ordenación de los resultados de búsqueda condirectionstring ypropertycampos string.
Para obtener una lista completa de las propiedades buscables, los límites de paginación y las propiedades ordenables, consulte la referencia API.
Respuesta de muestra:
{
"pagination": {
"offset": 0,
"limit": 1,
"total": 2,
"prev": null,
"next": null
},
"data": [
{
"href": "https://api.equinix.com//fabric/v4/routers/a1c6b7fd-aead-410a-96b4-b1dfa1071700/actions/1e9414f1-763e-4c0a-86c6-0bc8336048d9",
"uuid": "1e9414f1-763e-4c0a-86c6-0bc8336048d9",
"type": "RECEIVED_ROUTE_ENTRY_UPDATE",
"state": "SUCCEEDED",
"connection": {
"uuid": "3066ab1d-af87-49d7-8a14-c9bdb57ac809"
},
"operation": {
"bgpIpv4RoutesCount": 6,
"bgpIpv6RoutesCount": 6
},
"changeLog": {
"createdDateTime": "2024-01-01T01:00:00.000Z",
"updatedDateTime": "2024-01-01T01:01:00.000Z"
}
}
]
}