Créer un dispositif

Conditions préalables

Authentifier - soumettre vos informations d'identification utilisateur, ID client et secret client pour l'authentification OAuth2. Reportez-vous à authentification API pour obtenir des instructions sur la façon d'appeler le API OAuth pour valider et authentifier vos informations d'identification.

Étape 2 : Obtenir les détails de l'appareil

Appelez Get Device types pour savoir quel périphérique auto-configuré (par exemple, routeur ou pare-feu) vous souhaitez lancer sur la plate-forme ne. Vous découvrirez les régions métropolitaines où des périphériques virtuels sont disponibles, les fournisseurs de périphériques, le nombre de cœurs disponibles, les progiciels et leurs versions. Sélectionnez deviceTypeCode, metroCode, core, , packageCodeet version.
Appelez Get Allowed interfaces pour connaître le nombre d'interfaces autorisées pour le core sélectionné. Vous pouvez sélectionner n'importe quelle interface de périphérique disponible comme sshInterfaceId. Sinon, Equinix choisira la première interface disponible.
Appelez Get Accounts {metro} pour vérifier votre numéro de compte (ou accountReferenceId) et le statut dans le métro où vous voulez un périphérique virtuel. Pour des raisons de facturation, vous devez avoir un compte dans le métro où vous voulez un périphérique virtuel, à l'état actif ou en attente. Créez un compte si vous n'en avez pas.

Si vous êtes un revendeur qui tente de créer un appareil pour votre client, vous devez vous assurer que le compte du client et celui de votre revendeur sont tous deux à l'état actif ou en attente. Votre compte sera facturé, cependant, vous devez envoyer le numéro de compte du client au API pour créer un appareil pour votre client.

Étape 3 : Options de licence

Nous proposons BYOL (Bring Your Own Licensing) comme option de licence pour la plupart des appareils. Téléchargez un fichier de licence ou un code/jeton/ID, selon ce que votre fournisseur propose. Pour Cisco 8000V, vous disposez de l'option de licence par abonnement.

Arista : Nous ne prenons pas en charge le téléchargement d'une licence pour les appareils Arista. Cependant, vous pouvez vous connecter à votre appareil après sa création pour télécharger une licence afin d'augmenter votre débit.
Cisco et Palo Alto fournissent des jetons de licence. Entrez le jeton de licence dans le champ licenseToken.
Juniper fournit des fichiers de licence. Pour apporter votre propre licence (BYOL) pour un équipement Juniper, utilisez [Post License File] (/api-catalog/network-edgev1/#tag/NetworkEdge-Availability-and-Metros/operation/uploadLicense) pour télécharger un fichier de licence. Vous obtiendrez un identifiant de fichier que vous pourrez utiliser pour créer un dispositif virtuel. Si vous disposez d'un appareil Juniper redondant, vous pouvez utiliser le même ID de fichier pour l'appareil principal et l'appareil secondaire.
Fortinet : La licence n'est pas obligatoire pour les appareils Fortinet au moment de la création de l'appareil. Si vous avez un jeton, saisissez-le dans le champ licenseToken. Pour configurer un fichier de licence pour un appareil Fortinet, vous devez procéder comme suit :
- Générer un fichier de licence sur le portail Fortinet.
- Téléchargez le fichier de licence sur le portail Equinix en appelant Post License File. Vous obtiendrez un fileId que vous pourrez utiliser pour créer un périphérique virtuel.
- Connectez-vous à l'appareil pour vérifier l'état de votre licence.

Étape 4 : Création d'un dispositif autoconfiguré

	POST /ne/v1/devices
Méthode	`POST`
URL ou point final	`/ne/v1/devices`
En-têtes	`Authorization` jeton, `Content-Type`
Paramètres d'interrogation	`draft` `draftUuid`

Pour créer un dispositif redondant avec des dispositifs primaires et secondaires :

Définir les paramètres de l'objet secondaire
Si vous êtes un revendeur essayant de créer un appareil redondant pour votre client, assurez-vous que les métros principal et secondaire se trouvent dans le même pays. Les numéros de compte principal et secondaire doivent être identiques. Bien que le compte du revendeur soit facturé, ce API accepte le numéro de compte du client pour créer des appareils pour le client. Les restrictions ci-dessus sont nécessaires car chaque client est associé au compte de facturation d'un revendeur.
Dans le cas des appareils Cisco FTD, le type de gestion doit être le même pour l'appareil principal et l'appareil secondaire.

Remarques

En créant un périphérique virtuel, vous acceptez les conditions de commande. Appelez Get Order Terms pour consulter les détails. Cochez la case création d'un périphérique Edge auto-configuré pour comprendre les détails de l'entreprise.

Pour enregistrer un projet d'appareil, vous devez fournir deviceTypeCode, accountNumber ou accountReferenceId, et metroCode.

Exemples de demandes

Un exemple de requête curl pour créer un seul appareil.

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "metroCode": "SV",  
    "deviceTypeCode": "VSRX",  
    "agreeOrderTerms": true,  
    "termLength": "1",  
    "licenseMode": "BYOL",  
    "packageCode": "STD",  
    "virtualDeviceName": "Test-device-001-SROY",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC12",  
    "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "200541",  
    "version": "23.2R1.13",  
    "interfaceCount": 8,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 2,  
    "userPublicKey": {  
        "username": "userName",  
        "keyName": "keyName"  
    },  
    "additionalBandwidth": "100"  
}  
'

Un exemple de requête curl pour créer un dispositif redondant.

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "metroCode": "DC",  
    "deviceTypeCode": "C8000V",  
    "agreeOrderTerms": true,  
    "termLength": "1",  
    "licenseMode": "BYOL",  
    "packageCode": "network-advantage",  
    "virtualDeviceName": "Test-device-001-SROY - primary",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC01",  
        "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "201148",  
    "version": "17.06.06a",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 2,  
    "userPublicKey": {  
        "username": "sroy",  
        "keyName": "keyWIQzB"  
    },  
    "sshInterfaceId": "3",  
    "channelPartner": "SDCI",  
    "secondary": {  
        "metroCode": "DC",  
        "hostNamePrefix": "TC02",  
        "notifications": [  
            "test@equinix.com"  
        ],  
        "virtualDeviceName": "Test-device-002-SROY - secondary",  
        "additionalBandwidth": "100",  
            "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
        "accountNumber": "201148",  
        "sshInterfaceId": "4"  
    }  
}  
'

Un exemple de requête curl pour créer un appareil secondaire Cisco FTD sans accès à l'internet.

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "deviceTypeCode": "Cisco_NGFW",  
    "licenseMode": "BYOL",  
    "packageCode": "FTDv5",  
    "virtualDeviceName": "NEAut-",  
    "metroCode": "DC",  
    "notifications": [  
        "t@t.com"  
    ],  
    "hostNamePrefix": "test",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 4,  
    "version": "7.0.4-55",  
    "vendorConfig": {  
        "managementType": "FDM"  
    },  
    "connectivity": "PRIVATE",  
    "secondary": {  
        "hostNamePrefix": "test-123",  
        "metroCode": "DC",  
        "notifications": [  
            "t@t.com"  
        ],  
        "virtualDeviceName": "test-secondary",  
        "vendorConfig": {  
            "managementType": "FDM"  
        }  
    }  
}  
'

Pour une liste complète des paramètres et des options, consultez la [Référence API] (/api-catalog/network-edgev1#operation/createVirtualDevice).

Exemples de réponses

Exemple de réponse pour un seul appareil. 202 : Demande acceptée.

{  
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec"  
}

Exemple de réponse pour un dispositif redondant. 202 : Demande acceptée.

{  
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec",  
    "secondaryUuid": "de5cf79b-3d16-4ccd-841b-3b68ecda2142"  
}

État de l'appareil

Surveillez l'état de votre appareil en appelant Get Virtual Device {uuid}. Votre appareil doit être provisionné et votre licence doit être enregistrée avant que vous puissiez vous connecter aux fournisseurs de services en nuage.

« État » du périphérique virtuel	Description de l'entreprise
`INITIALIZING`	Equinix est en train de réserver des ressources et de créer le dispositif.
`PROVISIONING`	L'appareil démarre.
`PENDING_ORDER`	La commande a été transmise à NE par Siebel. Les clients doivent se connecter au portail NE et soumettre la commande.
`PENDING_SIGNATURE`	Le client s'est inscrit pour l'acceptation hors ligne des conditions du NE mais n'a pas encore accepté les conditions.
`CANCEL_ORDER`	La commande de Siebel à NE est annulée.
`WAITING_FOR_PRIMARY`	L'appareil secondaire est prêt, mais l'appareil principal ne l'est pas. Cet état ne peut apparaître que si vous avez créé un appareil secondaire pour la redondance.
`WAITING_FOR_SECONDARY`	L'appareil principal est prêt, mais l'appareil secondaire ne l'est pas. Cet état ne peut apparaître que si vous avez créé un appareil secondaire pour la redondance.
`FAILED`	La création de l'appareil a échoué.
`PROVISIONED`	L'appareil est prêt.

Lorsque les utilisateurs finaux suppriment un dispositif à l'aide de l'API Delete Virtual Devices, le dispositif passe par les états suivants au sein de l'infrastructure Equinix.

Appareil virtuel "status" sous /ne/v1/devices/{uuid}	Description
DÉPROVISIONNEMENT	Equinix a accepté la demande du client de supprimer un dispositif virtuel.
DÉPROVISIONNÉ	L'appareil est déprovisionné/supprimé.

Conditions préalables​

Étape 2 : Obtenir les détails de l'appareil​

Étape 3 : Options de licence​

Étape 4 : Création d'un dispositif autoconfiguré​

Exemples de demandes​

Exemples de réponses​

État de l'appareil​