# Obtenir des informations sur le port ## 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 savoir comment appeler OAuth API pour valider et authentifier vos identifiants, reportez-vous à [authentification API](https://docs.equinix.com/fr-CA/equinix-api/api-authentication.md). ## Obtenir tous les ports[​](#obtenir-tous-les-ports "Lien direct vers Obtenir tous les ports") Vous pouvez récupérer tous les ports disponibles pour vos identifiants utilisateur en envoyant une `GET` demande au [`/fabric/v4/ports`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getports.md)point final. | | | | --------------------------- | ------------------ | | Méthode | `GET` | | URL ou point de terminaison | `/fabric/v4/ports` | | En-têtes | `Authorization` | | Paramètres du chemin | Non applicable | | Paramètres de requête | `name` | | Paramètres corporels | Non applicable | Exemple de requête cURL: ``` curl -X GET 'https://api.equinix.com/fabric/v4/ports' -H 'Authorization: Bearer ' ``` Exemple de réponse: ``` { "pagination": { "offset": 0, "limit": 1000, "total": 2 }, "data": [ { "href": "https://api.equinix.com/fabric/v4/ports/c4d93b39-02db-2dbc-ace0-30fa5c00ad04", "type": "XF_PORT", "uuid": "c4d93b39-02db-2dbc-ace0-30fa5c00ad04", "name": "gen-l2-qa-01-auto-TY4-L-Qinq-STD-SEC-10G-JUN-598", "physicalPortsSpeed": 10000, "physicalPortsType": "10GBASE_LR", "connectivitySourceType": "COLO", "project": { "projectId": "333cd592-1709-4238-bb0d-2c2b41896aa1" }, "package": { "code": "STANDARD" }, "state": "REPROVISIONING", "cvpId": "1616554", "operation": { "connectionCount": 0, "evplVCCount": 0, "accessVCCount": 0 }, "account": { "accountNumber": 200559, "accountName": "gen-l2-qa-01-auto-200559", "orgId": 90946, "organizationName": "gen-l2-qa-01-auto-200551.", "ucmId": "500DFED2-EBDB-480d-896C-C7870E52D0D8", "globalCustId": "0017i000011X242AAC" }, "changeLog": { "createdBy": "vvyugovskiy-IMPORT_JOB", "createdDateTime": "2021-06-16T01:46:52Z", "updatedBy": "Order-to-activation", "updatedDateTime": "2025-04-07T23:03:08.900Z" }, "bandwidth": 10000, "availableBandwidth": 10000, "usedBandwidth": 0, "location": { "metroHref": "https://api.equinix.com/fabric/v4/metros/TY", "region": "APAC", "metroName": "Tokyo", "metroCode": "TY", "ibx": "TY4" }, "device": { "name": "sit-tb1-ty-a2.lab", "redundancy": { "priority": "SECONDARY" } }, "demarcationPointIbx": "TY4", "tetherIbx": "TY4", "redundancy": { "priority": "SECONDARY" }, "encapsulation": { "type": "QINQ", "tagProtocolId": 37120 }, "lagEnabled": false, "settings": { "buyout": false }, "physicalPorts": [ { "type": "XF_PHYSICAL_PORT", "id": 1362185, "state": "TO_BE_ADDED", "uuid": "01892489-ce9b-7f25-b1f5-d32a5ac6a423", "tether": { "crossConnectId": "ECX.05.00001836", "cabinetNumber": "Demarc", "systemName": "TY4:01:002181", "patchPanel": "PP:1240:1089399", "patchPanelPortA": "7", "patchPanelPortB": "8", "ibx": "TY4" }, "demarcationPoint": { "patchPanel": "PP:Demarc:00002181", "patchPanelName": "PP:Demarc:00002181", "patchPanelPortA": "5", "patchPanelPortB": "6", "ibx": "TY4" }, "operation": { "operationalStatus": "UP" } } ] }, { "href": "https://api.equinix.com/fabric/v4/ports/6f0f3015-2d51-4b6e-a98c-1defb4fe88f1", "type": "XF_PORT", "uuid": "6f0f3015-2d51-4b6e-a98c-1defb4fe88f1", "name": "200558-SY4-CX-PRI-02", "physicalPortsSpeed": 10000, "physicalPortsType": "10GBASE_LR", "project": { "projectId": "333cd592-1709-4238-bb0d-2c2b41896aa1" }, "package": { "code": "STANDARD" }, "state": "ACTIVE", "cvpId": "2000348", "operation": { "connectionCount": 1, "evplVCCount": 1, "accessVCCount": 0 }, "account": { "accountNumber": 200558, "accountName": "Gen-L2-Qa-01-Auto-200558", "orgId": 90946, "organizationName": "gen-l2-qa-01-auto-200551.", "ucmId": "2D26D682-B62E-495d-AFDF-698EC3B353F8", "globalCustId": "0017i000011X242AAC" }, "changeLog": { "createdDateTime": "2025-05-06T17:29:30.800Z", "updatedBy": "API", "updatedDateTime": "2025-05-06T17:29:40.300Z" }, "bandwidth": 10000, "availableBandwidth": 9500, "usedBandwidth": 500, "location": { "metroHref": "https://api.equinix.com/fabric/v4/metros/SY", "region": "APAC", "metroName": "Sydney", "metroCode": "SY", "ibx": "SY4" }, "device": { "name": "sit-tb1-sy-e1.lab", "redundancy": { "group": "1", "priority": "PRIMARY" } }, "demarcationPointIbx": "SY4", "tetherIbx": "SY4", "redundancy": { "priority": "PRIMARY" }, "encapsulation": { "type": "DOT1Q", "tagProtocolId": 33024 }, "lagEnabled": true, "settings": { "buyout": false }, "physicalPorts": [ { "type": "XF_PHYSICAL_PORT", "id": 1362737, "state": "ACTIVE", "uuid": "01892489-ce07-7962-b676-b1a4d8091515", "tether": { "crossConnectId": "22035616", "cabinetNumber": "Demarc", "systemName": "SY4:01:002204", "patchPanel": "PP:1240:1089399", "patchPanelPortA": "12", "patchPanelPortB": "14", "ibx": "SY4" }, "demarcationPoint": { "patchPanel": "PP:Demarc:00002204", "patchPanelName": "PP:Demarc:00002204", "patchPanelPortA": "17", "patchPanelPortB": "18", "ibx": "SY4" }, "operation": { "operationalStatus": "UP" } } ] } ] } ``` Pour obtenir une description détaillée des champs de réponse, reportez-vous à la [référence API](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getports.md) . ## Obtenez les détails d'un port[​](#obtenez-les-détails-dun-port "Lien direct vers Obtenez les détails d'un port") Pour obtenir les détails d'un port, envoyez une `GET` demande au [`/fabric/v4/ports/{portUuid}`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getportbyuuid.md)point final, en spécifiant l'identifiant du port dans le chemin de la demande. | | | | --------------------------- | ----------------------------- | | Méthode | `GET` | | URL ou point de terminaison | `/fabric/v4/ports/{portUuid}` | | En-têtes | `Authorization` | | Paramètres du chemin | `uuid` | | Paramètres de requête | Non applicable | | Paramètres corporels | Non applicable | Exemple de requête cURL: ``` curl -X GET 'https://api.equinix.com/fabric/v4/ports/{port_id}' -H 'Authorization: Bearer ' ``` Exemple de réponse: ``` { "href": "https://api.equinix.com/fabric/v4/ports/44c5712b-d704-4ca5-9b42-ee6be32ee06a", "type": "XF_PORT", "uuid": "44c5712b-d704-4ca5-9b42-ee6be32ee06a", "name": "270843-DA1-CX-PRI-33", "physicalPortsSpeed": 1000, "physicalPortsType": "1000BASE_LX", "project": { "projectId": "66a2d2f7-b79b-49bc-8642-d2b3c1c138b4" }, "package": { "code": "UNLIMITED" }, "state": "ACTIVE", "cvpId": "2000833", "connectivitySourceType": "COLO", "operation": { "operationalStatus": "UP", "connectionCount": 10, "evplVCCount": 10, "accessVCCount": 0 }, "account": { "accountNumber": 270843, "accountName": "ctr-sit-account1", "orgId": 93055, "organizationName": "ctr-sit-account1-270843", "ucmId": "64726950-A62C-4749-98E2-5AA4CA44284F", "globalCustId": "0016u000003JZ3XAAW" }, "change": { "uuid": "ed41e367-e09d-4c2f-b6ab-30506de4437f", "type": "PORT_UPDATE", "status": "COMPLETED", "data": { "op": "REPLACE", "path": "/encapsulation", "value": { "type": "QINQ", "tagProtocolId": 34984 } }, "createdDateTime": "2025-05-29T20:38:45.630759Z", "updatedDateTime": "2025-05-29T20:38:49.330822Z" }, "changeLog": { "createdBy": "qa-automation", "createdDateTime": "2025-05-21T18:12:18.300Z", "updatedBy": "qa-automation", "updatedDateTime": "2025-05-29T20:38:48.900Z" }, "bandwidth": 1000, "availableBandwidth": 500, "usedBandwidth": 500, "location": { "metroHref": "https://api.equinix.com/fabric/v4/metros/DA", "region": "AMER", "metroName": "Dallas", "metroCode": "DA", "ibx": "DA1" }, "device": { "name": "qa3-da-a1.lab", "redundancy": { "priority": "PRIMARY" } }, "demarcationPointIbx": "DA1", "tetherIbx": "DA1", "redundancy": { "priority": "PRIMARY" }, "encapsulation": { "type": "QINQ", "tagProtocolId": 34984 }, "lagEnabled": false, "settings": { "buyout": true, "viewPortPermission": true, "placeVcOrderPermission": true }, "physicalPorts": [ { "type": "XF_PHYSICAL_PORT", "id": 1426359, "state": "ADDED", "bandwidth": 0, "uuid": "0189244a-f3ac-7258-a8b4-3167af899305", "tether": { "crossConnectId": "513213223", "ibx": "DA1" }, "demarcationPoint": { "ibx": "DA1" }, "operation": { "operationalStatus": "UP" } } ] } ``` Pour obtenir une description détaillée des champs de réponse, reportez-vous à la [référence API](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getportbyuuid.md) . ## Obtenir des VLAN d'occasion[​](#obtenir-des-vlan-doccasion "Lien direct vers Obtenir des VLAN d'occasion") Pour obtenir une liste des VLAN utilisés pour un port, envoyez `GET`une demande au [`/fabric/v4/ports/{portUuid}/linkProtocols`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getvlans.md)point final. Spécifiez le port par identifiant dans le chemin de la demande. | | | | --------------------------- | ------------------------------------------- | | Méthode | `GET` | | URL ou point de terminaison | `/fabric/v4/ports/{portUuid}/linkProtocols` | | En-têtes | `Authorization` | | Paramètres du chemin | `uuid` | | Paramètres de requête | `offset`, `limit` | | Paramètres corporels | Non applicable | Exemple de requête cURL: ``` curl -X GET 'https://api.equinix.com/fabric/v4/ports/{port_id}/linkProtocols' -H 'Authorization: Bearer ' ``` Exemple de réponse: ``` { "pagination": { "offset": 0, "limit": 20, "total": 5 }, "data": [ { "type": "QINQ", "uuid": "52d61263-fb0a-459d-a086-bc7fd6bd7384", "state": "RESERVED", "vlanSTag": 1000, "vlanCTag": 500, "asset": { "href": "https://api.equinix.com/fabric/v4/connections/cd67f685-41b0-1b07-6de0-320a5c00abee", "uuid": "cd67f685-41b0-1b07-6de0-320a5c00abee" }, "changeLog": { "createdDateTime": "2020-05-21T10:30:00Z" } }, { "type": "QINQ", "uuid": "8c589394-b0eb-4057-97dc-3bdb4f8ff6db", "state": "RESERVED", "vlanSTag": 1000, "vlanCTag": 500, "serviceToken": { "href": "https://api.equinix.com/fabric/v4/serviceTokens/fc4fb78a-6b89-462d-a233-e75ef61a603f", "uuid": "fc4fb78a-6b89-462d-a233-e75ef61a603f" }, "changeLog": { "createdDateTime": "2020-05-21T10:30:00Z" } }, { "type": "QINQ", "uuid": "7f1da56d-e1ff-4b25-b542-883c7004e971", "state": "RESERVED", "vlanSTag": 1000, "vlanCTag": 500, "serviceToken": { "href": "https://api.equinix.com/fabric/v4/serviceTokens/90f1af0e-134b-40d6-a007-e62cd6866373", "uuid": "90f1af0e-134b-40d6-a007-e62cd6866373", "bandwidth": 1000 }, "changeLog": { "createdDateTime": "2020-05-21T10:30:00Z" } }, { "type": "QINQ", "uuid": "7c968801-e03b-4530-8424-aa5ecc4339e2", "state": "RESERVED", "vlanSTag": 1000, "vlanCTag": 500, "asset": { "href": "https://api.equinix.com/fabric/v4/connections/2ac4e14f-6120-4705-886e-d37f1d0c6a65", "uuid": "2ac4e14f-6120-4705-886e-d37f1d0c6a65" }, "changeLog": { "createdDateTime": "2020-05-21T10:30:00Z" } }, { "type": "QINQ", "uuid": "db812bba-94b8-43e6-8d9c-850f04350c3d", "state": "RESERVED", "vlanSTag": 1001, "vlanCTag": 1001, "asset": { "href": "https://api.equinix.com/fabric/v4/connections/3268d105-e57b-4b2b-8a0a-2e3e42312d95", "uuid": "3268d105-e57b-4b2b-8a0a-2e3e42312d95" }, "changeLog": { "createdDateTime": "2020-05-21T10:30:00Z", "updatedDateTime": "2020-05-21T10:30:00Z" } } ] } ``` Pour obtenir une description détaillée des champs de réponse, reportez-vous à la [référence API](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getvlans.md) . ## Rechercher des ports[​](#rechercher-des-ports "Lien direct vers Rechercher des ports") Pour rechercher les informations sur un port, envoyez une `POST` demande au [`/fabric/v4/ports/search`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/searchports.md)point final. Spécifiez vos critères de recherche à l'aide des paramètres disponibles dans le corps de la demande. | | | | --------------------------- | ------------------------------- | | Méthode | `POST` | | URL ou point de terminaison | `/fabric/v4/ports/search` | | En-têtes | `Authorization`, `Content-Type` | | Paramètres du chemin | Non applicable | | Paramètres de requête | Non applicable | | Paramètres corporels | `filter`, `pagination`, `sort` | Exemple de requête cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/ports/search' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "filter": { "or": [ { "and": [ { "property": "/state", "operator": "=", "values": [ "ACTIVE", "REPROVISIONING" ] }, { "property": "/settings/productCode", "operator": "=", "values": [ "CX" ] }, { "property": "/project/projectId", "operator": "=", "values": [ "66a2d2f7-b79b-49bc-8642-d2b3c1c138b4" ] } ] } ] }, "pagination": { "limit": 1000, "offset": 0 }, "sort": [ { "property": "/device/name", "direction": "DESC" } ] }' ``` Paramètres corporels notables: | **Paramètre** | **Description** | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | Filtre `object`REQUIS | Objet contenant des critères de filtrage pour rechercher des ports. | | Ou `array[object]`OBLIGATOIRE | Tableau de critères joints par l'opérateur « ou ». | | Et `array[object]`OBLIGATOIRE | Tableau de critères joints par l'opérateur « et ». | | Propriété `string`REQUISE | Rechercher des ports en fonction de critères de filtrage.**Valeurs applicables :** */Project/projectId* /State \* /settings/productCode | | Opérateur `string`REQUIS | Opérateur de paramètre.**Valeurs applicables :** \* = | | Valeurs `string`REQUISES | Valeur du paramètre.**Exemple :** 3a58dd05-f46d-4b1d-a154-2e85c396ea62 | | | | | **/Project/projectId** | **Exemple :** « propriété » : « /Project/projectId »,« opérateur » : « = »,« valeurs » : \[« xx-xx-xx »] | | Opérateur `string`REQUIS | Opérateur de champ de recherche. **Valeurs applicables :** \* = | | Valeur `array[string]`REQUISE | Nom de la connexion.**Exemple :** \[« xx-xx-xx »] | | | | | **/état** | **Exemple :** « propriété » : « /state »,« opérateur » : « = »,« valeurs » : \[« ACTIF] | | Opérateur `string`REQUIS | Opérateur de champ de recherche. **Valeurs applicables :** \* = | | Valeur `array[string]`REQUISE | État du port.**Exemple :** \[« ACTIF »] | | | | | **/Settings/productCode** | **Exemple :** « propriété » : « /Settings/productCode »,« opérateur » : « = »,« valeurs » : \[« CX »] | | Opérateur `string`REQUIS | Opérateur de champ de recherche. **Valeurs applicables :** \* = | | Valeur `array[string]`REQUISE | Rechercher par état des ports.**Exemple :** \[« CX »] | Exemple de réponse: ``` { "pagination": { "offset": 0, "limit": 1000, "total": 2 }, "data": [ { "href": "https://api.equinix.com/fabric/v4/ports/c4d93b39-02db-2dbc-ace0-30fa5c00ad04", "type": "XF_PORT", "uuid": "c4d93b39-02db-2dbc-ace0-30fa5c00ad04", "name": "gen-l2-qa-01-auto-TY4-L-Qinq-STD-SEC-10G-JUN-598", "physicalPortsSpeed": 10000, "physicalPortsType": "10GBASE_LR", "connectivitySourceType": "COLO", "project": { "projectId": "333cd592-1709-4238-bb0d-2c2b41896aa1" }, "package": { "code": "STANDARD" }, "state": "REPROVISIONING", "cvpId": "1616554", "operation": { "connectionCount": 0, "evplVCCount": 0, "accessVCCount": 0 }, "account": { "accountNumber": 200559, "accountName": "gen-l2-qa-01-auto-200559", "orgId": 90946, "organizationName": "gen-l2-qa-01-auto-200551.", "ucmId": "500DFED2-EBDB-480d-896C-C7870E52D0D8", "globalCustId": "0017i000011X242AAC" }, "changeLog": { "createdBy": "vvyugovskiy-IMPORT_JOB", "createdDateTime": "2021-06-16T01:46:52Z", "updatedBy": "Order-to-activation", "updatedDateTime": "2025-04-07T23:03:08.900Z" }, "bandwidth": 10000, "availableBandwidth": 10000, "usedBandwidth": 0, "location": { "metroHref": "https://api.equinix.com/fabric/v4/metros/TY", "region": "APAC", "metroName": "Tokyo", "metroCode": "TY", "ibx": "TY4" }, "device": { "name": "sit-tb1-ty-a2.lab", "redundancy": { "priority": "SECONDARY" } }, "demarcationPointIbx": "TY4", "tetherIbx": "TY4", "redundancy": { "priority": "SECONDARY" }, "encapsulation": { "type": "QINQ", "tagProtocolId": 37120 }, "lagEnabled": false, "settings": { "buyout": false }, "physicalPorts": [ { "type": "XF_PHYSICAL_PORT", "id": 1362185, "state": "TO_BE_ADDED", "uuid": "01892489-ce9b-7f25-b1f5-d32a5ac6a423", "tether": { "crossConnectId": "ECX.05.00001836", "cabinetNumber": "Demarc", "systemName": "TY4:01:002181", "patchPanel": "PP:1240:1089399", "patchPanelPortA": "7", "patchPanelPortB": "8", "ibx": "TY4" }, "demarcationPoint": { "patchPanel": "PP:Demarc:00002181", "patchPanelName": "PP:Demarc:00002181", "patchPanelPortA": "5", "patchPanelPortB": "6", "ibx": "TY4" }, "operation": { "operationalStatus": "UP" } } ] }, { "href": "https://api.equinix.com/fabric/v4/ports/6f0f3015-2d51-4b6e-a98c-1defb4fe88f1", "type": "XF_PORT", "uuid": "6f0f3015-2d51-4b6e-a98c-1defb4fe88f1", "name": "200558-SY4-CX-PRI-02", "physicalPortsSpeed": 10000, "physicalPortsType": "10GBASE_LR", "project": { "projectId": "333cd592-1709-4238-bb0d-2c2b41896aa1" }, "package": { "code": "STANDARD" }, "state": "ACTIVE", "cvpId": "2000348", "operation": { "connectionCount": 1, "evplVCCount": 1, "accessVCCount": 0 }, "account": { "accountNumber": 200558, "accountName": "Gen-L2-Qa-01-Auto-200558", "orgId": 90946, "organizationName": "gen-l2-qa-01-auto-200551.", "ucmId": "2D26D682-B62E-495d-AFDF-698EC3B353F8", "globalCustId": "0017i000011X242AAC" }, "changeLog": { "createdDateTime": "2025-05-06T17:29:30.800Z", "updatedBy": "API", "updatedDateTime": "2025-05-06T17:29:40.300Z" }, "bandwidth": 10000, "availableBandwidth": 9500, "usedBandwidth": 500, "location": { "metroHref": "https://api.equinix.com/fabric/v4/metros/SY", "region": "APAC", "metroName": "Sydney", "metroCode": "SY", "ibx": "SY4" }, "device": { "name": "sit-tb1-sy-e1.lab", "redundancy": { "group": "1", "priority": "PRIMARY" } }, "demarcationPointIbx": "SY4", "tetherIbx": "SY4", "redundancy": { "priority": "PRIMARY" }, "encapsulation": { "type": "DOT1Q", "tagProtocolId": 33024 }, "lagEnabled": true, "settings": { "buyout": false }, "physicalPorts": [ { "type": "XF_PHYSICAL_PORT", "id": 1362737, "state": "ACTIVE", "uuid": "01892489-ce07-7962-b676-b1a4d8091515", "tether": { "crossConnectId": "22035616", "cabinetNumber": "Demarc", "systemName": "SY4:01:002204", "patchPanel": "PP:1240:1089399", "patchPanelPortA": "12", "patchPanelPortB": "14", "ibx": "SY4" }, "demarcationPoint": { "patchPanel": "PP:Demarc:00002204", "patchPanelName": "PP:Demarc:00002204", "patchPanelPortA": "17", "patchPanelPortB": "18", "ibx": "SY4" }, "operation": { "operationalStatus": "UP" } } ] } ] } ``` Pour obtenir une description détaillée des champs de réponse, reportez-vous à la [référence API](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/searchports.md) .