Connexion à un fournisseur de services sur la Fabric

Établissez une connexion entre vos actifs colocalisés IBX et un profil de service.

Conditions préalables

1. Authentifier - Soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.

2. Déterminer les informations sur les ports du côté A. Obtenez vos informations de port pertinentes à l'aide du point de terminaison Get All Ports.

3. Choisissez l'emplacement du métro du côté z. Utilisez le point de terminaison Get All Metros pour trouver tous les métros où Equinix Fabric est disponible et déterminer l'emplacement de destination de votre connexion.

4. Identifiez les informations du profil de service du fournisseur de services. Utilisez le point de terminaison Retrieve Service Profiles pour rechercher un profil de service spécifique ou utilisez le point de terminaison Get Service Profiles pour dresser la liste de tous les profils de service disponibles et identifier le profil auquel vous souhaitez vous connecter.

Création d'une connexion entre un port DOT1Q et un fournisseur de services

Pour créer une connexion à partir d'un port DOT1Q vers un fournisseur de services, envoyez une requête POST au point de terminaison /fabric/v4/connections. Spécifiez les détails de configuration de votre connexion dans le corps de la requête.

	POST /fabric/v4/connections
Method	POST
Endpoint	/fabric/v4/connections
Headers	Authorization, Content-Type
Path Parameters	Not applicable
Query Parameters	Not applicable
Body Parameters	type, name, order, redundancy, bandwidth, aSide, zSide, notifications

Pour valider cette demande en toute sécurité en production sans créer de connexion, consultez Testing in Production (API Dry Run).

Exemple de requête cURL :

curl -X  
POST 'https: //api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "type": "EVPL_VC",  
    "name": "Conn-1",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "bandwidth": 1000,  
    "redundancy": {  
        "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",  
        "priority": "SECONDARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "DOT1Q",  
                "vlanTag": 1001  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"  
            },  
            "location": {  
                "metroCode": "SV"  
            }  
        }  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "test@equinix.com",  
                "test@equinix.com"  
            ]  
        }  
    ]  
}'

Les paramètres inclus dans le corps de la requête sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).

Exemple de réponse :

{  
"href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",  
"type": "EVPL_VC",  
"uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",  
"name": "Conn-1",  
"state": "PROVISIONING",  
"order": {  
    "purchaseOrderNumber": "1-129105284100",  
    "billingTier": "Up to 1 Gbps"  
},  
"bandwidth": 1000,  
"redundancy": {  
    "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",  
    "priority": "SECONDARY"  
},  
"aSide": {  
    "accessPoint": {  
        "type": "COLO",  
        "port": {  
            "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",  
            "type": "XF_PORT",  
            "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
        },  
        "linkProtocol": {  
            "type": "DOT1Q",  
            "vlanTag": 1001  
        }  
    }  
},  
"zSide": {  
    "accessPoint": {  
        "type": "SP",  
        "profile": {  
            "href": "https://api.equinix.com/fabric/v4/serviceProfiles/a867f685-41b0-1b07-6de0-320a5c00abdd",  
            "type": "L2_Profile",  
            "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
        },  
        "location": {  
            "href": "https://api.equinix.com/v4/metros/SV",  
            "metrocode": "SV",  
            "region": "AMER"  
        }  
    }  
},  
"notifications": [  
    {  
        "type": "ALL",  
        "emails": [  
            "test@equinix.com",  
            "test2@equinix.com"  
        ]  
    }  
],  
"operation": {  
    "equinixStatus": "PENDING_APPROVAL",  
    "providerStatus": "NOT_AVAILABLE"  
},  
"changeLog": {  
    "createdDateTime": "2021-07-15T19:30:29.526Z"  
}  
}

La charge utile de la réponse comprend les paramètres de configuration définis dans le corps de la demande. Pour une liste complète des paramètres possibles et de leurs descriptions, voir la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).

Création d'une connexion entre un port QINQ et un fournisseur de services

Pour créer une connexion entre un port QINQ et un fournisseur de services, envoyez une requête POST au point de terminaison /fabric/v4/connections. Spécifiez les détails de configuration de votre connexion dans le corps de la requête.

Exemple de requête cURL :

curl -X  
POST 'https: //api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "type": "EVPL_VC",  
    "name": "Conn-1",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "bandwidth": 1000,  
    "redundancy": {  
        "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",  
        "priority": "SECONDARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "QINQ",  
                "vlanCTag": 1001,  
                "vlanSTag": 1002  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"  
            },  
            "location": {  
                "metroCode": "SV"  
            }  
        }  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "test@equinix.com",  
                "test@equinix.com"  
            ]  
        }  
    ]  
}'

Les paramètres inclus dans le corps de la requête sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).

Contrôle de la connexion

Utilisez le point de terminaison Get Specified Connection pour surveiller l'état de la connexion.

equinixStatus parameter values	providerStatus parameter values	Description
PENDING_APPROVAL	NOT_AVAILABLE	Connection request awaiting approval.
PROVISIONING or REJECTED	NOT_AVAILABLE	Connection establishment in progress or the seller has rejected the connection.
PROVISIONED	AVAILABLE	Connection established.