API - Connexion à IBM Cloud Direct Link sur Classic

Établissez une connexion avec IBM Cloud™ Direct Link sur Classic pour connecter vos actifs colocalisés IBX à vos ressources IBM Cloud.

Identifiez votre identifiant de compte IBM

Connectez-vous à la console IBM Cloud et sélectionnez gérer > compte pour localiser votre identifiant de compte IBM.

Conditions préalables pour l'API Fabric

Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Pour savoir comment appeler OAuth API pour valider et authentifier vos identifiants, reportez-vous à authentification API.
Déterminez vos informations A-Side. Récupérez les informations de vos ports Equinix Fabric à l'aide de la demandeGet All ports API.
Choisissez l'emplacement métropolitain Z-Side. Utilisez la demandeGet All Metros API pour trouver toutes lesmétros où Equinix Fabric est disponible et déterminer l'emplacement de destination.
Identifiez le profil de service. Utilisez la demande API récupérer les profils de service pour rechercher un profil de service spécifique ou la demande APIrépertorier les profils de service pour répertorier tous les profils deservice disponibles et identifier le système profil auquel vous souhaitez vous connecter.

Connexion à IBM Cloud Direct Link sur Classic à partir d'un port DOT1Q

Pour créer une connexion entre votre port DOT1Q et IBM Cloud Direct Link on Classic, envoyez POSTune demande au /fabric/v4/connectionspoint final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande.

	POST /fabric/v4/connections
Méthode	`POST`
Terminal	`/fabric/v4/connections`
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	`type`, `name`, `order`, `bandwidth`, , redundancy``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,
    "redundancy": {
        "priority": "PRIMARY"
    },
    "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"
            },
            "authenticationKey": "xx-xxx-xx",
            "sellerRegion": "us-west-1"
        }
    },
    "additionalInfo": [
        {
            "key": "ASN",
            "value": "12345"
        },
        {
            "key": "Global",
            "value": "false"
        }
    ],
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "test@equinix.com",
                "test2@equinix.com"
            ]
        }
    ]
}'

Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la référence 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,
    "redundancy": {
        "group": "m167f685-41b0-1b07-6de0-320a5c00abeu",
        "priority": "PRIMARY"
    },
    "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"
            },
            "sellerRegion": "us-west-1"
        }
    },
    "additionalInfo": [
        {
            "key": "ASN",
            "value": "12345"
        },
        {
            "key": "Global",
            "value": "false"
        }
    ],
    "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 réponse comprend les paramètres de configuration définis dans le corps de la demande. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, reportez-vous à la référence API .

Connexion à IBM Cloud Direct Link sur Classic à partir d'un port QINQ

Pour créer une connexion entre votre port QINQ et IBM Cloud Direct Link on Classic, envoyez POSTune demande au /fabric/v4/connectionspoint de terminaison. Spécifiez les détails de configuration de votre connexion dans le corps de la demande.

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": {
        "priority": "PRIMARY"
    },
    "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"
            },
            "authenticationKey": "xx-xxx-xx",
            "sellerRegion": "us-west-1"
        }
    },
    "additionalInfo": [
        {
            "key": "ASN",
            "value": "12345"
        },
        {
            "key": "Global",
            "value": "false"
        }
    ],
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "test@equinix.com",
                "test2@equinix.com"
            ]
        }
    ]
}'

Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la référence API .

Contrôle de l'état de la connexion

Envoyer une GET demande au fabric/v4/connections/{connectionId}point final pour surveiller l'état de la connexion.

`equinixStatus`valeurs d'attribut	`providerStatus`valeurs d'attribut	État d'IBM Direct Link	Description
`PROVISIONING`	`PROVISIONING`	-	La demande de connexion n'a pas encore été envoyée à IBM.
`PENDING_PROVIDER_VLAN`	`PENDING_APPROVAL`	Créer une approbation en attente	La connexion est en attente d'approbation.
`PROVISIONED`	`PROVISIONING / PROVISIONED`	Création en cours	Établissement de la connexion en cours.
`PROVISIONED`	`PROVISIONED`	Provisionné	Connexion établie.

Accepter la connexion

Connectez-vous à la console IBM Cloud et accédez à la page IBM Cloud Direct Link Exchange pour vérifier et accepter la connexion en attente.

Identifiez votre identifiant de compte IBM​

Conditions préalables pour l'API Fabric​

Connexion à IBM Cloud Direct Link sur Classic à partir d'un port DOT1Q​

Connexion à IBM Cloud Direct Link sur Classic à partir d'un port QINQ​

Contrôle de l'état de la connexion​

Accepter la connexion​