Gestión de Fabric Cloud Router

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.

Buscar y recuperar Fabric Cloud Router

Esta solicitud API recupera las instancias de Fabric Cloud Router que coinciden con los criterios de búsqueda proporcionados. Envíe una solicitud POST al punto final /fabric/v4/routers/search, especificando sus criterios en el cuerpo de la solicitud.

	POST /fabric/v4/routers/search
Method	`POST`
URL or Endpoint	`/fabric/v4/routers/search`
Headers	`Authorization`, `Content-Type`
Path Parameters	Not applicable
Query Parameters	Not applicable
Body Parameters	`filter`, `pagination`, `sort`

Ejemplo de solicitud curl:

curl -X POST 'http: //api.equinix.com/fabric/v4/routers/search'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "filter": {  
        "and": [  
            {  
                "property": "/name",  
                "operator": "LIKE",  
                "values": [  
                    "%Test%"  
                ]  
            },  
            {  
                "property": "/state",  
                "operator": "=",  
                "values": [  
                    "PROVISIONED"  
                ]  
            },  
            {  
                "property": "/project/projectId",  
                "operator": "=",  
                "values": [  
                    "995072000433550"  
                ]  
            },  
            {  
                "property": "/location/metroCode",  
                "operator": "=",  
                "values": [  
                    "SV"  
                ]  
            }  
        ]  
    },  
    "pagination": {  
        "offset": 0,  
        "limit": 20  
    },  
    "sort": [  
        {  
            "direction": "DESC",  
            "property": "/changeLog/createdDateTime"  
        }  
    ]  
}'

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.
pagination object - Objeto opcional que contiene los ajustes de paginación de los resultados de búsqueda con offset integer y limit campos integer.
sort object - Objeto opcional que define su configuración de ordenación de los resultados de búsqueda con direction string y property campos 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": 20,  
        "total": 1,  
        "next": "/search?offset=4&limit=2",  
        "previous": "/search?offset=0&limit=2"  
    },  
    "data": [  
        {  
            "href": "https://api.equinix.com/fabric/v4/routers/201b7346-a9eb-42fe-ae7a-08148c71928d",  
            "uuid": "201b7346-a9eb-42fe-ae7a-08148c71928d",  
            "state": "PROVISIONED",  
            "type": "XF_ROUTER",  
            "name": "My-Fabric-Cloud-Router",  
            "location": {  
                "metroCode": "HH"  
            },  
            "package": {  
                "code": "LAB"  
            },  
            "order": {  
                "purchaseOrderNumber": "1-129105284100"  
            },  
            "project": {  
                "projectId": "12345"  
            },  
            "notifications": [  
                {  
                    "type": "ALL",  
                    "emails": [  
                        "abc@abc.com"  
                    ]  
                }  
            ],  
            "account": {  
                "accountNumber": 123  
            },  
            "bgpIpv4RoutesCount": 0,  
            "bgpIpv6RoutesCount": 0,  
            "connectionsCount": 0,  
            "changeLog": {  
                "createdBy": "abc@xyz.com",  
                "createdByFullName": "abc",  
                "createdByEmail": "abc@xyz.com",  
                "createdDateTime": "2021-09-24T06:59:46Z"  
            }  
        }  
    ]  
}

Obtener Fabric Cloud Router especificado

Esta solicitud de API recupera detalles de un Fabric Cloud Router especificado, envíe una solicitud GET al punto final /fabric/v4/routers/{uuid} con el uuid en la ruta de la solicitud.

	GET /fabric/v4/routers/{uuid}
Method	`GET`
URL or Endpoint	`/fabric/v4/routers/{uuid}`
Headers	`Authorization`, `Content-Type`
Path Parameters	`uuid`
Query Parameters	Not applicable
Body Parameters	Not applicable

Ejemplo de solicitud curl:

curl -X  
GET 'https://api.equinix.com/fabric/v4/routers/{router_uuid}'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'

Respuesta de muestra:

{  
    "href": "https://api.equinix.com/fabric/v4/routers/201b7346-a9eb-42fe-ae7a-08148c71928d",  
    "uuid": "201b7346-a9eb-42fe-ae7a-08148c71928d",  
    "state": "PROVISIONED",  
    "type": "XF_ROUTER",  
    "name": "My-Fabric-Cloud-Router",  
    "location": {  
        "metroCode": "HH"  
    },  
    "package": {  
        "code": "LAB"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "project": {  
        "projectId": "12345"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "abc@abc.com"  
            ]  
        }  
    ],  
    "account": {  
        "accountNumber": 123  
    },  
    "bgpIpv4RoutesCount": 0,  
    "bgpIpv6RoutesCount": 0,  
    "distinctIpv4PrefixesCount": 4,  
    "distinctIpv6PrefixesCount": 4,  
    "connectionsCount": 0,  
    "changeLog": {  
        "createdBy": "abc@xyz.com",  
        "createdByFullName": "abc",  
        "createdByEmail": "abc@xyz.com",  
        "createdDateTime": "2021-09-24T06:59:46Z"  
    }  
}

Actualizar un Fabric Cloud Router

Para actualizar un Fabric Cloud Router, envíe una solicitud PATCH al punto final /fabric/v4/routers/{routerId} con los parámetros que está actualizando en el cuerpo de la solicitud. Puede actualizar el nombre o cambiar el paquete.

	PATCH /fabric/v4/routers/{uuid}
Method	PATCH
URL or Endpoint	`/fabric/v4/routers/{uuid}`
Headers	`Authorization`, `Content-Type`
Path Parameters	`uuid`
Query Parameters	Not applicable
Body Parameters	`op`, `path`, `value`

Ejemplo de solicitud curl:

curl -X  
PATCH 'https: //api.equinix.com/fabric/v4/routers/{router_uuid}'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[  
    {  
        "op": "replace",  
        "path": "/name",  
        "value": "Cloud-Router-2"  
    }  
]'

Parámetros corporales notables:

op (obligatorio) string - Tipo de solicitud de actualización. Valores aplicables: replace, add o remove.
path (obligatorio) string - Ruta del parámetro del valor que está actualizando. Valores aplicables: "/name" o "/package/code".
value (obligatorio) string - El nuevo valor del parámetro.

Para obtener una lista completa de los campos actualizables y sus valores, consulte la referencia API.

Borrar Fabric Cloud Router

Para eliminar un Fabric Cloud Router, envíe una solicitud DELETE al punto final /fabric/v4/routers/{uuid}. Especifique el enrutador que desea eliminar por uuid en la ruta.

	DELETE /fabric/v4/routers/{uuid}
Method	DELETE
URL or Endpoint	`/fabric/v4/routers/{uuid}`
Headers	`Authorization`, `Content-Type`
Path Parameters	`uuid`
Query Parameters	Not applicable
Body Parameters	Not applicable

Ejemplo de solicitud curl:

curl -X  
DELETE 'https://api.equinix.com/fabric/v4/routers/{router_uuid}'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'

Requisitos previos​

Buscar y recuperar Fabric Cloud Router​

Obtener Fabric Cloud Router especificado​

Actualizar un Fabric Cloud Router​

Borrar Fabric Cloud Router​

Requisitos previos

Buscar y recuperar Fabric Cloud Router

Obtener Fabric Cloud Router especificado

Actualizar un Fabric Cloud Router

Borrar Fabric Cloud Router