API - Connexion à Alibaba
Établir une connexion directe de niveau 2 avec Alibaba Cloud.
Identifier l'identifiant de votre compte Alibaba
Connectez-vous à la console de gestion d'Alibaba Express Connect et recherchez votre identifiant de compte.
Conditions préalables pour l'API Fabric
-
Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
-
Déterminez les informations relatives à votre face A. Soit :
- Récupérez les informations sur les ports de votre Equinix Fabric à l'aide de la demande d'API Get All Ports.
OU
- Déterminez les informations relatives à votre périphérique Network Edge. Vous devez disposer d'un dispositif virtuel, d'un dispositif redondant ou d'un cluster Equinix provisionné avec une licence enregistrée. Vérifiez vos dispositifs virtuels et clusters disponibles en appelant Get Virtual Devices ou Get Virtual Device {uuid}. Vous pouvez choisir n'importe quelle interface disponible sur le périphérique pour votre connexion. Toutefois, Equinix sélectionnera une interface si vous n'en spécifiez pas.
-
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 répertorier tous les profils de service disponibles et identifier le profil de service. profil auquel vous souhaitez vous connecter.
Connexion à Alibaba Express Connect à partir d'un port DOT1Q
Pour créer une connexion depuis votre port DOT1Q vers Alibaba Express Connect, 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, 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 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,
"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 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).
Connexion à Alibaba Express Connect à partir d'un port QINQ
Pour créer une connexion depuis votre port QINQ vers Alibaba Express Connect, envoyez une requête POST au point de terminaison /fabric/v4/connexions. 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,
"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 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).
Connexion à Alibaba Express Connect à partir d'un appareil Network Edge
Pour créer une connexion entre votre appareil Network Edge et Alibaba Express Connect, envoyez une requête POST au point de terminaison /fabric/v4/connexions. 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, 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 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).
{
"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 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).
Contrôle 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 Physical Connections.
- Identifiez l'instance nouvellement créée et cliquez sur Acceptez et payez.
- Créez une instance de routeur frontalier virtuel (VBR) et associez-la à l'instance de routeur frontalier virtuel (VBR). connection.
Pour plus d'informations, reportez-vous à [Billing - Pricing | Alibaba Cloud Documentation Center] (https://www.alibabacloud.com/help/en/express-connect/latest/billing-method).