Add existing instances to a Vultr cluster in bulk or individually. GPU clusters automatically configure fabric networking when instances join.
Adding instances to a cluster associates existing instances with the cluster and configures the fabric networking automatically. For GPU clusters, the high-performance interconnect (RoCE or InfiniBand) is provisioned when instances join — no manual VLAN or PKey setup is needed. You can add a single instance or multiple instances at once.
An instance can belong to only one cluster at a time. All instances in a cluster must be in the same region and match the cluster's plan type.
This guide explains how to add instances to a cluster using the Vultr API.
Send a GET request to the List Clusters endpoint to retrieve all clusters.
Note the id of the cluster to which you want to add instances.
Send a GET request to the List Instances endpoint to retrieve all instances.
Note the id of the instance(s) you want to add to the cluster.
Send a POST request to the Mass Update Cluster Instances endpoint to add multiple instances to the cluster. Replace {cluster-id} with the cluster id and provide the instance IDs in the instances array. Set action to add.
A successful request returns an HTTP 202 Accepted response.
Send a GET request to the Get Cluster endpoint to retrieve the cluster details. Replace {cluster-id} with the cluster id.
Verify that the added instances appear in the cluster's instance list.
Send a POST request to the Add Single Instance endpoint to add a single instance to the cluster. Replace {cluster-id} with the cluster id and {instance-id} with the instance id.
A successful request returns an HTTP 202 Accepted response.
Send a GET request to the Get Cluster endpoint to retrieve the cluster details.
Verify that the instance appears in the cluster's instance list.
0 Comments
Be the first to comment and share your perspective with the community.