Lancer le périphérique Cluster

Conditions préalables

Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.
Appelez obtenir les types de dispositif pour savoir quel dispositif de cluster (par exemple, routeur ou pare-feu) vous souhaitez lancer sur la plateforme ne. Vous découvrirez les régions métropolitaines où des dispositifs virtuels sont disponibles, les fournisseurs de dispositifs, le nombre de cœurs disponibles, les packages logiciels et leurs versions. Sélectionnez deviceTypeCode, metroCode, , core, packageCodeet version.
Appelez Get Allowed interfaces pour connaître le nombre d'interfaces autorisé pour votre core sélectionné. Vous pouvez sélectionner n'importe quelle interface de dispositif disponible en tant que sshInterfaceID. Dans le cas contraire, Equinix choisira la première interface disponible.
Appelez obtenir des comptes {metro} pour vérifier votre (ou acountReferenceId) et votre account numberstatut dans la zone métropolitaine où vous souhaitez un appareil virtuel. Pour des raisons de facturation, vous devez disposer d'un compte dans la zone métropolitaine où vous souhaitez un appareil virtuel, à l'état actif ou en attente. Si vous n'en avez pas, créez uncompte.

Si vous êtes un revendeur qui tente de créer un appareil pour votre client, vous devez vous assurer que les comptes du client et 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 POST 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 cluster Juniper. Cependant, vous pouvez télécharger deux fichiers de licence. Pour télécharger deux fichiers de licence, appelez le fichier post-licence deux fois. Vous obtiendrez le fichier de licence IDS dans la réponse que vous pourrez utiliser pour créer un cluster.
Cluster Palo Alto - vous devez télécharger deux jetons de licence du fournisseur. Les jetons de licence peuvent être identiques ou différents.
Cluster Fortinet - vous n'avez pas besoin de saisir de jeton ou de licence. Si vous souhaitez charger des fichiers de licence, vous devez charger deux fichiers de licence différents. Pour télécharger deux fichiers de licence, appelez le fichier post-licence deux fois. Vous obtiendrez le fichier de licence IDS dans la réponse que vous pourrez 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. Toutefois, 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 mettre à jour le dispositif virtuel avec la valeur d'état PROVISIONED.

Créer un périphérique de cluster

	PUBLIER /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 dispositif virtuel, vous acceptez les conditions de commande. Appelez obtenir les conditions de la commande pour consulter les détails.

Pour enregistrer un brouillon de dispositif, vous devez fournir un deviceTypeCode, un accountNumber ou un accountReferenceId 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 obtenir la 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 dispositif

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 doit être enregistrée avant de pouvoir utiliser ce cluster pour vous connecter à des fournisseurs de services cloud.

états des dispositifs 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 s'applique uniquement aux commandes provenant de Siebel et vers le ne. Les clients doivent se connecter au portail Network Edge et envoyer 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 et provenant de Siebel.
`WAITING_FOR_PRIMARY`	Le dispositif secondaire est prêt, mais pas le dispositif principal. Cet état peut apparaître si vous avez demandé un dispositif redondant.
`WAITING_FOR_SECONDARY`	Le dispositif principal est prêt, mais pas le dispositif secondaire. Cet état peut apparaître si vous avez demandé un dispositif 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 appareil à l'aide de l'APIde suppression de périphériques virtuels, l'appareil 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 dispositif​

Conditions préalables

Options de licence

Créer un périphérique de cluster

Exemple de réponse

État du dispositif