Lancer le périphérique Cluster

Préalable

Authentification: soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète pour l’authentification OAuth2. Consultez la documentation relative à l’authentification API (Authentification API) pour savoir comment appeler l’API OAuth afin de valider et d’authentifier vos identifiants.
Appelez Get Device Types pour identifier le périphérique de grappe (routeur ou pare-feu, par exemple) à déployer sur la plateforme NE. Vous obtiendrez des renseignements sur les régions métropolitaines où les appareils virtuels sont disponibles, leurs fournisseurs, le nombre de cœurs disponibles, ainsi que les progiciels et leurs versions. Sélectionnez deviceTypeCode, metroCode, core, packageCode et version.
Appelez Obtenir les interfaces autorisées pour connaître le nombre d'interfaces autorisées pour le cœur sélectionné. Vous pouvez choisir n'importe quelle interface disponible comme sshInterfaceId. Sinon, Equinix choisira la première interface disponible.
Appelez Get Accounts {metro} pour vérifier votre numéro de compte (ou acountReferenceId) et son statut dans la zone métropolitaine où vous souhaitez déployer un appareil virtuel. Pour des raisons de facturation, vous devez avoir un compte dans cette zone, qu'il soit actif ou en attente. Si vous n'en avez pas, créez un compte.

Si vous êtes un revendeur et que vous souhaitez créer un appareil pour votre client, vous devez vous assurer que les comptes du client et le vôtre (celui du revendeur) sont actifs ou en attente. Votre compte sera facturé, mais vous devrez transmettre le numéro de compte du client à l'API POST pour créer l'appareil.

Options de licence

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

Cluster Juniper - Il n'est pas nécessaire de télécharger les fichiers de licence pour une grappe Juniper. Cependant, vous pouvez en télécharger deux. Pour ce faire, appelez deux fois la méthode Post License File. Vous obtiendrez alors les identifiants des fichiers de licence, que vous pourrez utiliser pour créer le cluster.
Cluster Palo Alto - Vous devez importer deux jetons de licence du fournisseur. Ces jetons peuvent être identiques ou différents.
Cluster Fortinet - Aucune saisie de jeton ou de licence n'est requise. Si vous voulez importer des fichiers de licence, vous devez en importer deux. Pour ce faire, appelez deux fois l'opération Post License File. Vous recevrez alors les identifiants des fichiers de licence, que vous pourrez utiliser pour créer un cluster.
Arista VeloCloud SD-WAN Edge Cluster Vous n'avez pas besoin de télécharger de fichier de licence ni de jeton. Cependant, vous devez fournir votre clé d'activation. Si l'enregistrement de votre licence échoue après la création de votre appareil, vous devez vous y connecter et télécharger la licence. Ensuite, appelez l'API Mise à jour Virtual Device avec la valeur d'état PROVISIONED.

Créer un périphérique de cluster

	POST /ne/v1/devices
Method	`POST`
URL or End Point	`/ne/v1/devices`
Headers	`Authorization` token, `Content-Type`
Query Parameters	`draft`, `draftUuid`

Remarque: La création d’un appareil virtuel implique l’acceptation des conditions générales de vente. Pour consulter les détails, appelez Obtenir les conditions générales de vente.

Pour enregistrer un brouillon d'appareil, 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 une liste complète des paramètres et des options, consultez 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 de l'appareil

Lors de la création d'une grappe, celle-ci, autoconfigurée, passe par différents états au sein du Infrastructure Equinix. Ces états peuvent être surveillés à l'aide de l'attribut de réponse status de la méthode Get Virtual Device {uuid} (/api-catalog/network-edgev1/#tag/Virtual-Device/operation/getVirtualDeviceByUuid). Votre grappe doit être approvisionnée et votre licence enregistrée avant de pouvoir l'utiliser pour vous connecter à des fournisseurs de services cloud.

Virtual device states	Description
`INITIALIZING`	Equinix is in the process of reserving resources and creating the device.
`PENDING_ACCOUNT`	Customer's account is not approved. The device creation will continue once the account gets approved.
`PROVISIONING`	The device is booting.
`PENDING_ORDER`	This status only applies to orders coming to NE from Siebel. Customers need to log in to the Network Edge portal and submit the pending order.
`PENDING_SIGNATURE`	The customer has not yet accepted Network Edge terms.
`CANCEL_ORDER`	The order from Siebel to NE is canceled. This status only applies to orders coming to Network Edge from Siebel.
`WAITING_FOR_PRIMARY`	The secondary device is ready but the primary is not. This state may appear if you have requested a redundant device.
`WAITING_FOR_SECONDARY`	The primary device is ready but the secondary is not. This state may appear if you have requested a redundant device.
`FAILED`	The device creation failed.
`PROVISIONED`	The device is ready.
`DEPROVISIONING`	Equinix accepted the customer's request to delete the virtual device.
`DEPROVISIONED`	The device is de-provisioned/deleted.

Lorsqu'un utilisateur final supprime un périphérique à l'aide de l'API Supprimer les périphériques virtuels, l'appareil passe par les états suivants au sein d'Equinix. infrastructure.

status	Description
`DEPROVISIONING`	Equinix accepted the customer's request to delete the virtual device.
`DEPROVISIONED`	The device is de-provisioned/deleted.

Préalable​

Options de licence​

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

Exemple de réponse​

État de l'appareil​

Préalable

Options de licence

Créer un périphérique de cluster

Exemple de réponse

État de l'appareil