# Gestion des routeurs Fabric Cloud Router ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à [authentification API](https://docs.equinix.com/fr/equinix-api/api-authentication.md). ## Recherche et récupération des routeurs Fabric Cloud Router[​](#recherche-et-récupération-des-routeurs-fabric-cloud-router "Lien direct vers Recherche et récupération des routeurs Fabric Cloud Router") Cette demande API récupère les instances Fabric Cloud Router qui correspondent aux critères de recherche fournis. Envoyez une `POST` demande au [`/fabric/v4/routers/search`](https://docs.equinix.com/fr/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md)terminal, en spécifiant vos critères dans le corps de la demande. | | **POST /fabric/v4/routers/search** | | ---------------------------- | ---------------------------------- | | Méthode | `POST` | | URL ou point final | `/fabric/v4/routers/search` | | En-têtes | `Authorization` `Content-Type` | | Paramètres du chemin d'accès | Non applicable | | Paramètres d'interrogation | Non applicable | | Paramètres du corps | `filter`, `pagination`, `sort` | Exemple de requête curl : ``` curl -X POST 'http: //api.equinix.com/fabric/v4/routers/search' -H 'content-type: application/json' -H 'authorization: Bearer ' -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"         }     ] }' ``` Paramètres corporels remarquables : * `filter` *Objet* (obligatoire) - objet qui définit vos conditions de recherche. * `and` (Obligatoire) *array\[object]* - un objet de tableau qui sert d'opérateur logique appliqué aux objets de recherche dans le tableau. Vous pouvez effectuer une recherche sur : * `property` *Chaîne* (obligatoire) - paramètre de champ de recherche. Notez que la valeur de la propriété détermine la liste des opérateurs et des valeurs applicables. Valeurs applicables : `"/name"`, `"/uuid"`, `"/state"`, `"/location/metroCode"`, , `"/location/metroName"``"/package/code"` et une recherche dans toutes les catégories `"\*"`. * `operator` *Chaîne* (obligatoire) - opérateur de paramètre de champ de recherche. Valeurs applicables : `"="`, `"!="`, `">"`, `">="`, , `"<"``"<="`, `BETWEEN`, `LIKE`, `IN`, , `"NOT BETWEEN"``"NOT LIKE"`, `"NOT IN"`. * `value` (Obligatoire) *array\[chaîne]* - valeur du paramètre du champ de recherche. * `pagination` *Objet* - objet facultatif contenant les paramètres de pagination des résultats de la recherche avec `offset` des champs *entiers* et `limit`*entiers*. * `sort` *Objet* - objet facultatif qui définit vos paramètres de tri des résultats de recherche avec des `direction` champs *de chaîne* et `property`*de chaîne*. Pour obtenir la liste complète des propriétés consultables, des limites de pagination et des propriétés triables, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md) . Exemple de réponse : ``` {     "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"             }         }     ] } ``` ## Obtenir la spécification d'un routeur Fabric Cloud Router[​](#obtenir-la-spécification-dun-routeur-fabric-cloud-router "Lien direct vers Obtenir la spécification d'un routeur Fabric Cloud Router") Cette demande API récupère les détails d'un Fabric Cloud Router spécifié, envoie une `GET` demande au [`/fabric/v4/routers/{uuid}`](https://docs.equinix.com/fr/api-catalog/fabricv4/cloud-routers/getcloudrouterbyuuid.md)point final avec le `uuid`dans le chemin de la demande. | | **OBTENEZ /fabric/v4/routers/{uuid}** | | ---------------------------- | ------------------------------------- | | Méthode | `GET` | | URL ou point final | `/fabric/v4/routers/{uuid}` | | En-têtes | `Authorization` `Content-Type` | | Paramètres du chemin d'accès | `uuid` | | Paramètres d'interrogation | Non applicable | | Paramètres du corps | Non applicable | Exemple de requête curl : ``` curl -X GET 'https://api.equinix.com/fabric/v4/routers/{router_uuid}' -H 'content-type: application/json' -H 'authorization: Bearer ' ``` Exemple de réponse : ``` {     "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"     } } ``` ## Mise à jour d'un routeur Fabric Cloud Router[​](#mise-à-jour-dun-routeur-fabric-cloud-router "Lien direct vers Mise à jour d'un routeur Fabric Cloud Router") Pour mettre à jour un Fabric Cloud Router, envoyez une `PATCH` demande au [`/fabric/v4/routers/{routerId}`](https://docs.equinix.com/fr/api-catalog/fabricv4/cloud-routers/updatecloudrouterbyuuid.md)noeud final avec les paramètres que vous mettez à jour dans le corps de la demande. Vous pouvez mettre à jour le nom ou modifier le package. | | **PATCH /fabric/v4/routers/{uuid}** | | ---------------------------- | ----------------------------------- | | Méthode | PATCH | | URL ou point final | `/fabric/v4/routers/{uuid}` | | En-têtes | `Authorization` `Content-Type` | | Paramètres du chemin d'accès | `uuid` | | Paramètres d'interrogation | Non applicable | | Paramètres du corps | `op`, `path`, `value` | Exemple de requête curl : ``` curl -X PATCH 'https: //api.equinix.com/fabric/v4/routers/{router_uuid}' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '[     {         "op": "replace",         "path": "/name",         "value": "Cloud-Router-2"     } ]' ``` Paramètres corporels remarquables : * `op` *Chaîne* (obligatoire) - type de demande de mise à jour. Valeurs applicables : `replace`, `add`ou `remove`. * `path` (Obligatoire) *String* - chemin du paramètre de la valeur que vous mettez à jour. Valeurs applicables : `"/name"` ou `"/package/code"`. * `value` *Chaîne* (obligatoire) - la nouvelle valeur du paramètre. Pour obtenir la liste complète des champs pouvant être mis à jour et leurs valeurs, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/fabricv4/cloud-routers/updatecloudrouterbyuuid.md) . ## Supprimer le routeur Fabric Cloud Router[​](#supprimer-le-routeur-fabric-cloud-router "Lien direct vers Supprimer le routeur Fabric Cloud Router") Pour supprimer un Fabric Cloud Router, envoyez `DELETE`une demande au [`/fabric/v4/routers/{uuid}`](https://docs.equinix.com/fr/api-catalog/fabricv4/cloud-routers/deletecloudrouterbyuuid.md)point final. Dans le chemin, spécifiez le routeur que vous souhaitez supprimer`uuid`. | | **SUPPRIMER /fabric/v4/routers/{uuid}** | | ---------------------------- | --------------------------------------- | | Méthode | DELETE | | URL ou point final | `/fabric/v4/routers/{uuid}` | | En-têtes | `Authorization` `Content-Type` | | Paramètres du chemin d'accès | `uuid` | | Paramètres d'interrogation | Non applicable | | Paramètres du corps | Non applicable | Exemple de requête curl : ``` curl -X DELETE 'https://api.equinix.com/fabric/v4/routers/{router_uuid}' -H 'content-type: application/json' -H 'authorization: Bearer ' ```