Lancer le périphérique Cluster

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.
Appelez Get Device types pour savoir quel périphérique de cluster (par exemple, routeur ou pare-feu) vous souhaitez lancer sur la plate-forme ne. Vous en apprendrez plus sur les régions métropolitaines où les 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 (ou acountReferenceId) et votre account numberstatut 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 POST API pour créer un appareil pour votre client.

Options de licence

Pour l'instant, nous proposons uniquement l'option BYOL (apportez votre propre licence) pour les clusters.

Juniper Cluster - il n'est pas nécessaire de télécharger des fichiers de licence pour un Juniper Cluster. Toutefois, vous pouvez télécharger deux fichiers de licence. Pour télécharger deux fichiers de licence, appelez Post License File deux fois. Vous obtiendrez le fichier de licence IDS dans la réponse que vous pouvez utiliser pour créer un cluster.
Palo Alto Cluster - vous devez télécharger deux jetons de licence du fournisseur. Les jetons de licence peuvent être identiques ou différents.
Fortinet Cluster - vous n'avez pas besoin de saisir un jeton ou une licence. Si vous souhaitez télécharger des fichiers de licence, vous devez télécharger deux fichiers de licence différents. Pour télécharger deux fichiers de licence, appelez Post License File deux fois. Vous obtiendrez le fichier de licence IDS dans la réponse que vous pouvez utiliser pour créer un cluster.
Arista VeloCloud SD-WAN Edge Cluster vous n'avez pas besoin de télécharger un fichier de licence ou un jeton. Cependant, vous devez fournir votre clé d'activation. Si votre licence ne s'enregistre pas après la création de votre appareil, vous devez vous connecter à l'appareil et télécharger la licence. Ensuite, appelez Update Virtual Device avec la valeur d'état PROVISIONED.

Créer un périphérique de cluster

	POST /ne/v1/devices
Méthode	`POST`
URL ou point de terminaison	`/ne/v1/devices`
En-têtes	`Authorization` jeton, `Content-Type`
Paramètres de requête	`draft`, `draftUuid`

Remarque : En créant un périphérique virtuel, vous acceptez les conditions de commande. Appelez Get Order Terms pour consulter les détails.

Pour enregistrer un brouillon de périphérique, vous devez fournir un deviceTypeCode, un accountNumber ou accountReferenceIdun et un metroCode.

Un exemple de requête curl pour créer un cluster vSRX:

curl -X
POST "https://api.equinix.com/ne/v1/devices?draft=false"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '
{
    "deviceTypeCode": "VSRX",
    "clusterDetails": {
        "clusterName": "sroy-juniper",
        "clusterNodeDetails": {
            "node0": {
                "vendorConfig": {
                    "hostname": "sr012"
                },
                "licenseFileId": "1274fe9f-511c-436f-bc0c-14c876ec55da"
            },
            "node1": {
                "vendorConfig": {
                    "hostname": "sr123"
                },
                "licenseFileId": "65a9be3f-57fb-4c4d-a15b-40950951bc13"
            }
        }
    },
    "metroCode": "SV",
    "termLength": "1",
    "licenseMode": "BYOL",
    "packageCode": "STD",
    "virtualDeviceName": "Test-device-001-SROY",
    "notifications": [
        "test@equinix.com"
    ],
    "hostname": "sr012",
    "aclDetails": [
       {
         "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",
         "interfaceType": "WAN"
       }
    ],
    "accountNumber": "201148",
    "version": "18.4R3-S2",
    "interfaceCount": 8,
    "agreeOrderTerms": true,
    "deviceManagementType": "SELF-CONFIGURED",
    "core": 5,
    "userPublicKey": {
        "username": "sroy",
        "keyName": "keyLlhzL"
    },
    "additionalBandwidth": "100"
}
'

Exemple de requête curl pour créer un cluster SDWAN Arista Velocloud:

curl -X
POST "https://api.equinix.com/ne/v1/devices?draft=false"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '
{
    "metroCode": "SY",
    "deviceTypeCode": "VELOCLOUD-SDWAN",
    "termLength": "1",
    "clusterDetails": {
        "clusterName": "sroy-velo-cluster",
        "vendorConfig": {
            "node0": {
                "activationKey": "GJUK-JM2X-59BJ-SAMPLE",
                "controllerFqdn": "demo.velocloud.net",
                "rootPassword": "TestPassword!"
            },
            "node1": {
                "rootPassword": "TestPassword#"
            }
        }
    },
    "licenseMode": "BYOL",
    "packageCode": "VeloCloud-4",
    "virtualDeviceName": "velo-cluster",
    "notifications": [
        "test@equinix.com"
    ],
    "aclDetails": [
       {
         "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",
         "interfaceType": "WAN"
       }
    ],
    "accountNumber": "2393479",
    "version": "3.4.2",
    "interfaceCount": 8,
    "deviceManagementType": "SELF-CONFIGURED",
    "agreeOrderTerms": true,
    "core": 4,
    "userPublicKey": {
        "username": "sroy",
        "keyName": "key7YFfL"
    },
    "additionalBandwidth": "200"
}
'

Un exemple de requête curl pour créer un cluster PANW sans accès Internet:

curl -X
POST "https://api.equinix.com/ne/v1/devices?draft=false"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '
{
    "deviceTypeCode": "PA-VM",
    "clusterDetails": {
        "clusterName": "NEAut-",
        "clusterNodeDetails": {
            "node0": {
            "vendorConfig": {
                "hostname": "PANCluster"
            }
            },
            "node1": {
            "vendorConfig": {
                "hostname": "PANCluster"
            }
            }
        }
    },
    "metroCode": "#(supportedMetro)",
    "zoneCode": "Zone1",
    "termLength": "1",
    "licenseMode": "BYOL",
    "packageCode": "VM100",
    "virtualDeviceName": "NEAut-",
    "notifications": [
        "t@t.com"
    ],
    "version": "10.1.3",
    "interfaceCount": 10,
    "deviceManagementType": "SELF-CONFIGURED",
    "core": 2,
    "connectivity": "PRIVATE"
}
'

Pour une liste complète des paramètres et des options, reportez-vous à la référence API .

Exemple de réponse

Exemple de réponse 202 : Demande acceptée.

{
    "uuid": "34b7838c-ec82-4166-ac19-efa03b4e34fe",
    "deviceIds": {
        "node0": "34b7838c-ec82-4166-ac19-efa03b4e34fe",
        "node1": "f27f1475-3c7f-447f-b0db-e3bb3af3de16"
    },
    "clusterId": "27eea9aa-327b-431b-bf62-3cee4d880f2e"
}

État du périphérique

Lorsqu'un cluster est créé, le cluster auto-configuré passe par différents états au sein de l' infrastructure Equinix. Ces états peuvent être surveillés à l'aide de l'statusattribut response de la méthodeGet Virtual Device {UUID}. Votre cluster doit être provisionné et votre licence enregistrée avant de pouvoir utiliser ce cluster pour vous connecter à des fournisseurs de services cloud.

états des périphériques virtuels	Description
`INITIALIZING`	Equinix est en train de réserver des ressources et de créer l'appareil.
`PENDING_ACCOUNT`	Le compte du client n'est pas approuvé. La création de l'appareil se poursuivra une fois le compte approuvé.
`PROVISIONING`	L'appareil est en cours de démarrage.
`PENDING_ORDER`	Ce statut ne s'applique qu'aux commandes provenant de Siebel et destinées au ne. Les clients doivent se connecter au portail Network Edge et soumettre la commande en attente.
`PENDING_SIGNATURE`	Le client n'a pas encore accepté les conditions de Network Edge .
`CANCEL_ORDER`	La commande de Siebel à NE est annulée. Ce statut s'applique uniquement aux commandes provenant de Network Edge.
`WAITING_FOR_PRIMARY`	Le périphérique secondaire est prêt, mais pas le périphérique principal. Cet état peut apparaître si vous avez demandé un périphérique redondant.
`WAITING_FOR_SECONDARY`	Le périphérique principal est prêt, mais pas le périphérique secondaire. Cet état peut apparaître si vous avez demandé un périphérique redondant.
`FAILED`	La création de l'appareil a échoué.
`PROVISIONED`	L'appareil est prêt.
`DEPROVISIONING`	Equinix a accepté la demande du client de supprimer l'appareil virtuel.
`DEPROVISIONED`	L'appareil est déprovisionné/supprimé.

Lorsqu'un utilisateur final supprime un terminal à l'aide de l'APISupprimer les périphériques virtuels, le terminal passe par les états suivants au sein de l' infrastructure Equinix.

statut	Description
`DEPROVISIONING`	Equinix a accepté la demande du client de supprimer l'appareil virtuel.
`DEPROVISIONED`	L'appareil est déprovisionné/supprimé.

Conditions préalables​

Options de licence​

Créer un périphérique de cluster​

Exemple de réponse​

État du périphérique​

Conditions préalables

Options de licence

Créer un périphérique de cluster

Exemple de réponse

État du périphérique