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 Autenticación de API para obtener instrucciones sobre cómo llamar al API de 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 POST solicitud al /fabric/v4/routers/{uuid}/actions punto final.
POST /fabric/v4/routers/{uuid}/actions | |
|---|---|
| Método | POST |
| URL o punto final | /fabric/v4/routers/{uuid}/actions |
| Encabezados | Authorization, Content-Type |
| Parámetros de la ruta | uuid |
| Parámetros de consulta | No aplicable |
| Parámetros corporales | 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 a través de BGP, utiliceRECEIVED_ROUTE_ENTRY_UPDATE. Para ver los prefijos que FCR está enviando a través de BGP, utiliceADVERTISED_ROUTE_ENTRY_UPDATE. -
connection(Opcional) Objeto - Objeto que contiene unuuidcampo para especificar una conexión. Solo se requiere paraRECEIVED_ROUTE_ENTRY_UPDATEyADVERTISED_ROUTE_ENTRY_UPDATEtipos.
Para obtener información y ejemplos completos de los parámetros, consulte la referencia de 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 GET solicitud al /fabric/v4/routers/{uuid}/actions punto final. Utilice el stateparámetro de consulta para filtrar la respuesta por el estado de la solicitud.
GET /fabric/v4/routers/{uuid}/actions | |
|---|---|
| Método | GET |
| URL o punto final | /fabric/v4/routers/{uuid}/actions |
| Encabezados | Authorization |
| Parámetros de la ruta | uuid |
| Parámetros de consulta | state |
| Parámetros corporales | No aplicable |
Este API recupera solicitudes de acciones de gestión de tablas de enrutamiento.
Solicitud de curl de muestra
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,SUCCEEDED, oFAILED.
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 POST solicitud al /fabric/v4/routers/{routerId}/actions/searchpunto final, especificando los criterios de búsqueda en el cuerpo de la solicitud.
POST /fabric/v4/routers/{routerId}/actions/search | |
|---|---|
| Método | POST |
| URL o punto final | /fabric/v4/routers/{routerId}/actions/search |
| Encabezados | Authorization, Content-Type |
| Parámetros de la ruta | routerId |
| Parámetros de consulta | No aplicable |
| Parámetros corporales | 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 notables del cuerpo:
-
filterObjeto (obligatorio): El objeto que define sus condiciones de búsqueda. -
and(Obligatorio) Array[Object] - Un objeto de array que sirve como operador lógico aplicado a 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 de parámetros de campo de búsqueda. Valores aplicables:"=","!=",">"">=", , ,"<"``"<=",BETWEEN,LIKEIN, , ,"NOT BETWEEN"``"NOT LIKE","NOT IN".value(Requerido) Array[string] - Valor del parámetro del campo de búsqueda.
-
paginationObjeto - Objeto opcional que contiene la configuración de paginación de los resultados de búsqueda conoffsetcampos entero elimitentero. -
sortObjeto - Objeto opcional que define la configuración de clasificación de los resultados de búsqueda condirectioncampos de cadena ypropertycadena.
Para obtener una lista completa de las propiedades que se pueden buscar, los límites de paginación y las propiedades clasificables, consulte la referencia de 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"
}
}
]
}