API - Se connecter à Alibaba
Établissez une connexion directe de couche 2 à Alibaba Cloud.
Identifiez votre identifiant de compte Alibaba
Connectez-vous à la console de gestion Alibaba Express Connect et recherchez votre identifiant de compte.
Prérequis de l'API Fabric
-
Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour OAuth2 Authentification. Consultez Authentification API pour obtenir des instructions sur la façon d'appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
-
Déterminez vos informations de la face A. Soit:
- Récupérez les informations sur les ports de votre Equinix Fabric à l'aide de la requête API Get All Ports.
OU
- Identifiez les renseignements relatifs à votre appareil Network Edge. Vous avez besoin d'un périphérique virtuel/d'un périphérique redondant/d'une grappe Equinix provisionnée et disposant d'une licence enregistrée. Consultez la liste des périphériques virtuels et des grappes disponibles en appelant Get Virtual Devices ou Get Virtual Device {uuid}. Vous pouvez choisir n'importe quelle interface disponible sur l'appareil pour votre connexion. Toutefois, Equinix choisira une interface par défaut.
-
Choisissez l'emplacement du métro côté Z. Utilisez la requête API Get All Metros pour trouver tous les métros où Equinix Fabric est disponible et déterminer l'emplacement de destination.
-
Identifiez le profil de service. Utilisez la requête API Retrieve Service Profiles pour rechercher un profil de service spécifique ou utilisez la requête API Get Service Profiles pour lister tous les profils de service disponibles et identifier le profil de service souhaité. profil auquel vous voulez vous connecter.
Connexion à Alibaba Express Connect depuis un port DOT1Q
Pour établir une connexion entre votre port DOT1Q et Alibaba Express Connect, envoyez une requête POST au point de terminaison /fabric/v4/connections. Précisez 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, bandwidth, aSide, zSide, additionalInfo, notifications |
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,
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "4c4b8edf-873b-4c6c-805a-edb2c335bd6c"
},
"location": {
"metroCode": "SV"
},
"authenticationKey": "xx-xxx-xx",
"sellerRegion": "us-west-1"
}
},
"notifications": {
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@equinix.com"
]
}
}'
Les paramètres inclus dans le corps de la requête sont propres à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.
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,
"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/services/serviceProfiles/20d32a80-0d61-4333-bc03-707b591ae2f5",
"type": "L2_PROFILE",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"
},
"location": {
"href": "https://api.equinix.com/v4/metros/SV",
"metroCode": "SV",
"region": "AMER"
},
"authenticationKey": "xx-xxx-xx",
"sellerRegion": "us-west-1"
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@equinix.com"
]
}
],
"operation": {
"equinixStatus": "PROVISIONING",
"providerStatus": "PROVISIONING"
},
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z"
}
}
La charge utile de la réponse inclut les paramètres de configuration définis dans le corps de la requête. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, consultez la référence de l'API.
Connexion à Alibaba Express Connect depuis un port QINQ
Pour établir une connexion entre votre port QINQ et Alibaba Express Connect, envoyez une requête POST au point de terminaison /fabric/v4/connections. Précisez 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,
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "QINQ",
"vlanCTag": 1001,
"vlanSTag": 1002
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "4c4b8edf-873b-4c6c-805a-edb2c335bd6c"
},
"location": {
"metroCode": "SV"
},
"authenticationKey": "xx-xxx-xx",
"sellerRegion": "us-west-1"
}
},
"notifications": {
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@equinix.com"
]
}
}'
Les paramètres inclus dans le corps de la requête sont propres à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.
Connexion à Alibaba Express Connect depuis un périphérique Network Edge
Pour établir une connexion entre votre périphérique Network Edge et Alibaba Express Connect, envoyez une requête POST au point de terminaison /fabric/v4/connections. Précisez 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, bandwidth, aSide, zSide, additionalInfo, notifications |
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": "vd2Alibaba-vvv-0425b",
"bandwidth": "50",
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"type": "L2_PROFILE",
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
},
"location": {
"metroCode": "SV"
},
"authenticationKey": "XXXXXXXXXXXXXXX",
"sellerRegion": "us-west-1"
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"X@gmail.com"
]
}
],
"project": {
"projectId": "16799d66-ef43-445c-ba29-d17522d8a137"
}
}'
Les paramètres inclus dans le corps de la requête sont propres à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.
{
"type": "EVPL_VC",
"href": "https://api.equinix.com/fabric/v4/connections/66ed4e8a-584c-4027-9788-748fecb5ce35",
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"name": "vd2Alibaba-vvv-0425c",
"operation": {
"providerStatus": "PROVISIONING",
"equinixStatus": "PROVISIONING"
},
"order": {
"billingTier": "Up to 50 MB"
},
"notifications": [
{
"type": "ALL",
"emails": [
"X@gmail.com"
]
}
],
"changeLog": {
"createdBy": "fabricamcrh1",
"createdByFullName": "fabric amcrh1",
"createdByEmail": "X@gmail.com",
"createdDateTime": "2024-04-25T20:43:43.199Z",
"updatedBy": "fabricamcrh1",
"updatedByFullName": "fabric amcrh1",
"updatedByEmail": "X@gmail.com",
"updatedDateTime": "2024-04-25T20:43:43.199Z"
},
"bandwidth": 50,
"redundancy": {
"group": "160e06b5-cd42-4c2c-b674-6dcda54da4d8",
"priority": "PRIMARY"
},
"aSide": {
"accessPoint": {
"interface": {
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"id": 6,
"type": "CLOUD"
},
"location": {
"metroCode": "DC"
},
"virtualDevice": {
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"type": "EDGE"
}
}
},
"zSide": {
"accessPoint": {
"location": {
"metroCode": "SV"
},
"profile": {
"href": "https://api.equinix.com/fabric/v4/serviceProfiles/4c4b8edf-873b-4c6c-805a-edb2c335bd6c",
"type": "L2_PROFILE",
"name": "Alibaba Cloud Express Connect",
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
},
"sellerRegion": "us-west-1",
"authenticationKey": "1111111111111"
}
}
}
La charge utile de la réponse inclut les paramètres de configuration définis dans le corps de la requête. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, consultez la référence de l'API.
Surveillance de l'état de la connexion
Envoyez une requête GET au point de terminaison fabric/v4/connections/{connectionId} pour surveiller l'état de la connexion.
equinixStatus attribute values | providerStatus attribute values | Alibaba Cloud status | Description |
|---|---|---|---|
PROVISIONING | NOT_AVAILABLE | - | Connection request has not been sent to Alibaba yet. |
PROVISIONED | PENDING_APPROVAL | Pending creation | The connection awaits for approval. |
PROVISIONED | PROVISIONING / PROVISIONED | Create in progress | Connection establishment in progress. |
PROVISIONED | PROVISIONED | Active | Connection established. |
Accepter et payer la connexion
- Connectez-vous à la console de gestion Alibaba Express Connect.
- Dans le menu de gauche, sélectionnez Connexions physiques.
- Identifiez l'instance nouvellement créée et cliquez Acceptez et payez.
- Créez une instance de routeur de frontière virtuelle (VBR) et liez-la au connection.
Pour plus d'informations, consultez [Facturation - Tarification | Centre de documentation Alibaba Cloud.