Saltar al contenido principal

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étodoPOST
URL o punto final/fabric/v4/routers/{uuid}/actions
EncabezadosAuthorization, Content-Type
Parámetros de la rutauuid
Parámetros de consultaNo aplicable
Parámetros corporalestype

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, utilice ROUTE_TABLE_ENTRY_UPDATE. Para ver todos los prefijos aprendidos a través de BGP, utilice RECEIVED_ROUTE_ENTRY_UPDATE. Para ver los prefijos que FCR está enviando a través de BGP, utilice ADVERTISED_ROUTE_ENTRY_UPDATE.

  • connection (Opcional) Objeto - Objeto que contiene un uuid campo para especificar una conexión. Solo se requiere para RECEIVED_ROUTE_ENTRY_UPDATE y ADVERTISED_ROUTE_ENTRY_UPDATE tipos.

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étodoGET
URL o punto final/fabric/v4/routers/{uuid}/actions
EncabezadosAuthorization
Parámetros de la rutauuid
Parámetros de consultastate
Parámetros corporalesNo 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, o FAILED.

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étodoPOST
URL o punto final/fabric/v4/routers/{routerId}/actions/search
EncabezadosAuthorization, Content-Type
Parámetros de la rutarouterId
Parámetros de consultaNo aplicable
Parámetros corporalesfilter, 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:

  • filter Objeto (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, LIKE IN, , , "NOT BETWEEN"``"NOT LIKE", "NOT IN".
    • value (Requerido) Array[string] - Valor del parámetro del campo de búsqueda.
  • pagination Objeto - Objeto opcional que contiene la configuración de paginación de los resultados de búsqueda con offset campos entero e limitentero.

  • sort Objeto - Objeto opcional que define la configuración de clasificación de los resultados de búsqueda con direction campos de cadena y propertycadena.

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"
      }
    }
  ]
}
¿Le ha resultado útil esta página?