Lancer le dispositif de cluster

Conditions préalables

Authentifier - Soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
Appelez Get Device Types pour savoir quel dispositif de cluster (par exemple, routeur ou pare-feu) vous voulez lancer sur la plateforme NE. Vous découvrirez les régions métropolitaines dans lesquelles des dispositifs virtuels sont disponibles, les fournisseurs de dispositifs, le nombre de cœurs disponibles, ainsi que les progiciels et leurs versions. Sélectionnez deviceTypeCode, metroCode, core, packageCode, et version.
Appelez [Get Allowed Interfaces] (/api-catalog/network-edgev1/#tag/NetworkEdge-Availability-and-Metros/operation/getAllowedInterfaces) pour connaître le nombre d'interfaces autorisées pour le cœur sélectionné. Vous pouvez sélectionner n'importe quelle interface disponible comme sshInterfaceId. Sinon, Equinix choisira la première interface disponible.
Appelez [Get Accounts {metro}] (/api-catalog/network-edgev1/#tag/NetworkEdge-Availability-and-Metros/operation/getAccountsWithStatus) pour vérifier votre numéro de compte (ou acountReferenceId) et votre statut dans le métro où vous voulez un appareil virtuel. Pour des raisons de facturation, vous devez avoir un compte dans le métro où vous voulez un appareil virtuel, soit dans l'état Actif, soit dans l'état En attente. Créez un compte si vous n'en avez pas.

Si vous êtes un revendeur **** et que vous essayez de créer un appareil pour votre client, vous devez vous assurer que le compte du client et le vôtre (celui du revendeur) sont tous deux dans le statut Actif ou En attente. Votre compte sera facturé, mais vous devez envoyer le numéro de compte du client à l'API POST pour créer un appareil pour votre client.

Options de licence

Pour l'instant, nous n'offrons que l'option BYOL (bring your own licensing) pour les clusters.

Juniper Cluster - Il n'est pas nécessaire de télécharger des fichiers de licence pour un Juniper Cluster. Cependant, 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 dans la réponse des identifiants de fichiers de licence que vous pourrez 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 d'entrer 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 dans la réponse des identifiants de fichiers de licence que vous pourrez utiliser pour créer un cluster.
Cluster Edge Arista VeloCloud SD-WAN 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] (/api-catalog/network-edgev1/#tag/Virtual-Device/operation/updateVirtualDeviceByUuid) avec la valeur d'état PROVISIONED.

Créer un dispositif 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 : en créant un appareil virtuel, vous acceptez les conditions de commande. Appelez Get Order Terms pour consulter les détails.

Pour enregistrer un projet 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"
}
'

Un 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] (/api-catalog/network-edgev1#operation/createVirtualDevice).

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

Lorsqu'un cluster est créé, le cluster auto-configuré passe par différents états au sein de l'infrastructure Equinix. Ces états peuvent être contrôlé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 cluster doit être provisionné et votre licence doit être enregistrée avant que vous puissiez utiliser ce cluster pour vous connecter aux fournisseurs de services en nuage.

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 dispositif à l'aide de l'API Delete Virtual Devices, le dispositif passe par les états suivants au sein de l'infrastructure Equinix.

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

Conditions préalables​

Options de licence​

Créer un dispositif de cluster​

Exemple de réponse​

État de l'appareil​

Conditions préalables

Options de licence

Créer un dispositif de cluster

Exemple de réponse

État de l'appareil