published on Tuesday, Mar 24, 2026 by g-core
published on Tuesday, Mar 24, 2026 by g-core
GPU virtual clusters provide managed virtual GPU servers with auto-scaling for parallel computation workloads.
Example Usage
Basic GPU cluster with public networking
Create a GPU virtual cluster with external IPv4 networking and a boot volume from an image.
import * as pulumi from "@pulumi/pulumi";
import * as gcore from "@pulumi/gcore";
// Create a GPU virtual cluster with public networking
const example = new gcore.CloudGpuVirtualCluster("example", {
projectId: 1,
regionId: 1,
name: "my-gpu-cluster",
flavor: "g3-ai-192-1536-12000-l40s-48-8",
serversCount: 2,
serversSettings: {
interfaces: [{
name: "pub_net",
type: "external",
ipFamily: "ipv4",
}],
volumes: [{
name: "root-volume",
size: 120,
type: "ssd_hiiops",
source: "image",
imageId: "4536337d-17c7-48f4-8ac5-01a41dc06f58",
bootIndex: 0,
}],
credentials: {
sshKeyName: "my-ssh-key",
},
},
tags: {
environment: "ml-training",
},
});
import pulumi
import pulumi_gcore as gcore
# Create a GPU virtual cluster with public networking
example = gcore.CloudGpuVirtualCluster("example",
project_id=1,
region_id=1,
name="my-gpu-cluster",
flavor="g3-ai-192-1536-12000-l40s-48-8",
servers_count=2,
servers_settings={
"interfaces": [{
"name": "pub_net",
"type": "external",
"ip_family": "ipv4",
}],
"volumes": [{
"name": "root-volume",
"size": 120,
"type": "ssd_hiiops",
"source": "image",
"image_id": "4536337d-17c7-48f4-8ac5-01a41dc06f58",
"boot_index": 0,
}],
"credentials": {
"ssh_key_name": "my-ssh-key",
},
},
tags={
"environment": "ml-training",
})
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
// Create a GPU virtual cluster with public networking
_, err := gcore.NewCloudGpuVirtualCluster(ctx, "example", &gcore.CloudGpuVirtualClusterArgs{
ProjectId: pulumi.Float64(1),
RegionId: pulumi.Float64(1),
Name: pulumi.String("my-gpu-cluster"),
Flavor: pulumi.String("g3-ai-192-1536-12000-l40s-48-8"),
ServersCount: pulumi.Float64(2),
ServersSettings: &gcore.CloudGpuVirtualClusterServersSettingsArgs{
Interfaces: gcore.CloudGpuVirtualClusterServersSettingsInterfaceArray{
&gcore.CloudGpuVirtualClusterServersSettingsInterfaceArgs{
Name: pulumi.String("pub_net"),
Type: pulumi.String("external"),
IpFamily: pulumi.String("ipv4"),
},
},
Volumes: gcore.CloudGpuVirtualClusterServersSettingsVolumeArray{
&gcore.CloudGpuVirtualClusterServersSettingsVolumeArgs{
Name: pulumi.String("root-volume"),
Size: pulumi.Float64(120),
Type: pulumi.String("ssd_hiiops"),
Source: pulumi.String("image"),
ImageId: pulumi.String("4536337d-17c7-48f4-8ac5-01a41dc06f58"),
BootIndex: pulumi.Float64(0),
},
},
Credentials: &gcore.CloudGpuVirtualClusterServersSettingsCredentialsArgs{
SshKeyName: pulumi.String("my-ssh-key"),
},
},
Tags: pulumi.StringMap{
"environment": pulumi.String("ml-training"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcore = Pulumi.Gcore;
return await Deployment.RunAsync(() =>
{
// Create a GPU virtual cluster with public networking
var example = new Gcore.CloudGpuVirtualCluster("example", new()
{
ProjectId = 1,
RegionId = 1,
Name = "my-gpu-cluster",
Flavor = "g3-ai-192-1536-12000-l40s-48-8",
ServersCount = 2,
ServersSettings = new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsArgs
{
Interfaces = new[]
{
new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsInterfaceArgs
{
Name = "pub_net",
Type = "external",
IpFamily = "ipv4",
},
},
Volumes = new[]
{
new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsVolumeArgs
{
Name = "root-volume",
Size = 120,
Type = "ssd_hiiops",
Source = "image",
ImageId = "4536337d-17c7-48f4-8ac5-01a41dc06f58",
BootIndex = 0,
},
},
Credentials = new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsCredentialsArgs
{
SshKeyName = "my-ssh-key",
},
},
Tags =
{
{ "environment", "ml-training" },
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcore.CloudGpuVirtualCluster;
import com.pulumi.gcore.CloudGpuVirtualClusterArgs;
import com.pulumi.gcore.inputs.CloudGpuVirtualClusterServersSettingsArgs;
import com.pulumi.gcore.inputs.CloudGpuVirtualClusterServersSettingsCredentialsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
// Create a GPU virtual cluster with public networking
var example = new CloudGpuVirtualCluster("example", CloudGpuVirtualClusterArgs.builder()
.projectId(1.0)
.regionId(1.0)
.name("my-gpu-cluster")
.flavor("g3-ai-192-1536-12000-l40s-48-8")
.serversCount(2.0)
.serversSettings(CloudGpuVirtualClusterServersSettingsArgs.builder()
.interfaces(CloudGpuVirtualClusterServersSettingsInterfaceArgs.builder()
.name("pub_net")
.type("external")
.ipFamily("ipv4")
.build())
.volumes(CloudGpuVirtualClusterServersSettingsVolumeArgs.builder()
.name("root-volume")
.size(120.0)
.type("ssd_hiiops")
.source("image")
.imageId("4536337d-17c7-48f4-8ac5-01a41dc06f58")
.bootIndex(0.0)
.build())
.credentials(CloudGpuVirtualClusterServersSettingsCredentialsArgs.builder()
.sshKeyName("my-ssh-key")
.build())
.build())
.tags(Map.of("environment", "ml-training"))
.build());
}
}
resources:
# Create a GPU virtual cluster with public networking
example:
type: gcore:CloudGpuVirtualCluster
properties:
projectId: 1
regionId: 1
name: my-gpu-cluster
flavor: g3-ai-192-1536-12000-l40s-48-8
serversCount: 2
serversSettings:
interfaces:
- name: pub_net
type: external
ipFamily: ipv4
volumes:
- name: root-volume
size: 120
type: ssd_hiiops
source: image
imageId: 4536337d-17c7-48f4-8ac5-01a41dc06f58
bootIndex: 0
credentials:
sshKeyName: my-ssh-key
tags:
environment: ml-training
Create CloudGpuVirtualCluster Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new CloudGpuVirtualCluster(name: string, args: CloudGpuVirtualClusterArgs, opts?: CustomResourceOptions);@overload
def CloudGpuVirtualCluster(resource_name: str,
args: CloudGpuVirtualClusterArgs,
opts: Optional[ResourceOptions] = None)
@overload
def CloudGpuVirtualCluster(resource_name: str,
opts: Optional[ResourceOptions] = None,
flavor: Optional[str] = None,
servers_count: Optional[float] = None,
servers_settings: Optional[CloudGpuVirtualClusterServersSettingsArgs] = None,
name: Optional[str] = None,
project_id: Optional[float] = None,
region_id: Optional[float] = None,
tags: Optional[Mapping[str, str]] = None)func NewCloudGpuVirtualCluster(ctx *Context, name string, args CloudGpuVirtualClusterArgs, opts ...ResourceOption) (*CloudGpuVirtualCluster, error)public CloudGpuVirtualCluster(string name, CloudGpuVirtualClusterArgs args, CustomResourceOptions? opts = null)
public CloudGpuVirtualCluster(String name, CloudGpuVirtualClusterArgs args)
public CloudGpuVirtualCluster(String name, CloudGpuVirtualClusterArgs args, CustomResourceOptions options)
type: gcore:CloudGpuVirtualCluster
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args CloudGpuVirtualClusterArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args CloudGpuVirtualClusterArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args CloudGpuVirtualClusterArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args CloudGpuVirtualClusterArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args CloudGpuVirtualClusterArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var cloudGpuVirtualClusterResource = new Gcore.CloudGpuVirtualCluster("cloudGpuVirtualClusterResource", new()
{
Flavor = "string",
ServersCount = 0,
ServersSettings = new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsArgs
{
Interfaces = new[]
{
new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsInterfaceArgs
{
Type = "string",
FloatingIp = new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsInterfaceFloatingIpArgs
{
Source = "string",
},
IpFamily = "string",
Name = "string",
NetworkId = "string",
SubnetId = "string",
},
},
Volumes = new[]
{
new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsVolumeArgs
{
BootIndex = 0,
Name = "string",
Size = 0,
Source = "string",
Type = "string",
DeleteOnTermination = false,
ImageId = "string",
Tags =
{
{ "string", "string" },
},
},
},
Credentials = new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsCredentialsArgs
{
PasswordWo = "string",
PasswordWoVersion = 0,
SshKeyName = "string",
Username = "string",
},
FileShares = new[]
{
new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsFileShareArgs
{
Id = "string",
MountPath = "string",
},
},
SecurityGroups = new[]
{
new Gcore.Inputs.CloudGpuVirtualClusterServersSettingsSecurityGroupArgs
{
Id = "string",
},
},
UserData = "string",
},
Name = "string",
ProjectId = 0,
RegionId = 0,
Tags =
{
{ "string", "string" },
},
});
example, err := gcore.NewCloudGpuVirtualCluster(ctx, "cloudGpuVirtualClusterResource", &gcore.CloudGpuVirtualClusterArgs{
Flavor: pulumi.String("string"),
ServersCount: pulumi.Float64(0),
ServersSettings: &gcore.CloudGpuVirtualClusterServersSettingsArgs{
Interfaces: gcore.CloudGpuVirtualClusterServersSettingsInterfaceArray{
&gcore.CloudGpuVirtualClusterServersSettingsInterfaceArgs{
Type: pulumi.String("string"),
FloatingIp: &gcore.CloudGpuVirtualClusterServersSettingsInterfaceFloatingIpArgs{
Source: pulumi.String("string"),
},
IpFamily: pulumi.String("string"),
Name: pulumi.String("string"),
NetworkId: pulumi.String("string"),
SubnetId: pulumi.String("string"),
},
},
Volumes: gcore.CloudGpuVirtualClusterServersSettingsVolumeArray{
&gcore.CloudGpuVirtualClusterServersSettingsVolumeArgs{
BootIndex: pulumi.Float64(0),
Name: pulumi.String("string"),
Size: pulumi.Float64(0),
Source: pulumi.String("string"),
Type: pulumi.String("string"),
DeleteOnTermination: pulumi.Bool(false),
ImageId: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
},
},
Credentials: &gcore.CloudGpuVirtualClusterServersSettingsCredentialsArgs{
PasswordWo: pulumi.String("string"),
PasswordWoVersion: pulumi.Float64(0),
SshKeyName: pulumi.String("string"),
Username: pulumi.String("string"),
},
FileShares: gcore.CloudGpuVirtualClusterServersSettingsFileShareArray{
&gcore.CloudGpuVirtualClusterServersSettingsFileShareArgs{
Id: pulumi.String("string"),
MountPath: pulumi.String("string"),
},
},
SecurityGroups: gcore.CloudGpuVirtualClusterServersSettingsSecurityGroupArray{
&gcore.CloudGpuVirtualClusterServersSettingsSecurityGroupArgs{
Id: pulumi.String("string"),
},
},
UserData: pulumi.String("string"),
},
Name: pulumi.String("string"),
ProjectId: pulumi.Float64(0),
RegionId: pulumi.Float64(0),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
})
var cloudGpuVirtualClusterResource = new CloudGpuVirtualCluster("cloudGpuVirtualClusterResource", CloudGpuVirtualClusterArgs.builder()
.flavor("string")
.serversCount(0.0)
.serversSettings(CloudGpuVirtualClusterServersSettingsArgs.builder()
.interfaces(CloudGpuVirtualClusterServersSettingsInterfaceArgs.builder()
.type("string")
.floatingIp(CloudGpuVirtualClusterServersSettingsInterfaceFloatingIpArgs.builder()
.source("string")
.build())
.ipFamily("string")
.name("string")
.networkId("string")
.subnetId("string")
.build())
.volumes(CloudGpuVirtualClusterServersSettingsVolumeArgs.builder()
.bootIndex(0.0)
.name("string")
.size(0.0)
.source("string")
.type("string")
.deleteOnTermination(false)
.imageId("string")
.tags(Map.of("string", "string"))
.build())
.credentials(CloudGpuVirtualClusterServersSettingsCredentialsArgs.builder()
.passwordWo("string")
.passwordWoVersion(0.0)
.sshKeyName("string")
.username("string")
.build())
.fileShares(CloudGpuVirtualClusterServersSettingsFileShareArgs.builder()
.id("string")
.mountPath("string")
.build())
.securityGroups(CloudGpuVirtualClusterServersSettingsSecurityGroupArgs.builder()
.id("string")
.build())
.userData("string")
.build())
.name("string")
.projectId(0.0)
.regionId(0.0)
.tags(Map.of("string", "string"))
.build());
cloud_gpu_virtual_cluster_resource = gcore.CloudGpuVirtualCluster("cloudGpuVirtualClusterResource",
flavor="string",
servers_count=0,
servers_settings={
"interfaces": [{
"type": "string",
"floating_ip": {
"source": "string",
},
"ip_family": "string",
"name": "string",
"network_id": "string",
"subnet_id": "string",
}],
"volumes": [{
"boot_index": 0,
"name": "string",
"size": 0,
"source": "string",
"type": "string",
"delete_on_termination": False,
"image_id": "string",
"tags": {
"string": "string",
},
}],
"credentials": {
"password_wo": "string",
"password_wo_version": 0,
"ssh_key_name": "string",
"username": "string",
},
"file_shares": [{
"id": "string",
"mount_path": "string",
}],
"security_groups": [{
"id": "string",
}],
"user_data": "string",
},
name="string",
project_id=0,
region_id=0,
tags={
"string": "string",
})
const cloudGpuVirtualClusterResource = new gcore.CloudGpuVirtualCluster("cloudGpuVirtualClusterResource", {
flavor: "string",
serversCount: 0,
serversSettings: {
interfaces: [{
type: "string",
floatingIp: {
source: "string",
},
ipFamily: "string",
name: "string",
networkId: "string",
subnetId: "string",
}],
volumes: [{
bootIndex: 0,
name: "string",
size: 0,
source: "string",
type: "string",
deleteOnTermination: false,
imageId: "string",
tags: {
string: "string",
},
}],
credentials: {
passwordWo: "string",
passwordWoVersion: 0,
sshKeyName: "string",
username: "string",
},
fileShares: [{
id: "string",
mountPath: "string",
}],
securityGroups: [{
id: "string",
}],
userData: "string",
},
name: "string",
projectId: 0,
regionId: 0,
tags: {
string: "string",
},
});
type: gcore:CloudGpuVirtualCluster
properties:
flavor: string
name: string
projectId: 0
regionId: 0
serversCount: 0
serversSettings:
credentials:
passwordWo: string
passwordWoVersion: 0
sshKeyName: string
username: string
fileShares:
- id: string
mountPath: string
interfaces:
- floatingIp:
source: string
ipFamily: string
name: string
networkId: string
subnetId: string
type: string
securityGroups:
- id: string
userData: string
volumes:
- bootIndex: 0
deleteOnTermination: false
imageId: string
name: string
size: 0
source: string
tags:
string: string
type: string
tags:
string: string
CloudGpuVirtualCluster Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The CloudGpuVirtualCluster resource accepts the following input properties:
- Flavor string
- Cluster flavor ID
- Servers
Count double - Number of servers in the cluster
- Servers
Settings CloudGpu Virtual Cluster Servers Settings - Configuration settings for the servers in the cluster
- Name string
- Cluster name
- Project
Id double - Project ID
- Region
Id double - Region ID
- Dictionary<string, string>
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- Flavor string
- Cluster flavor ID
- Servers
Count float64 - Number of servers in the cluster
- Servers
Settings CloudGpu Virtual Cluster Servers Settings Args - Configuration settings for the servers in the cluster
- Name string
- Cluster name
- Project
Id float64 - Project ID
- Region
Id float64 - Region ID
- map[string]string
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- flavor String
- Cluster flavor ID
- servers
Count Double - Number of servers in the cluster
- servers
Settings CloudGpu Virtual Cluster Servers Settings - Configuration settings for the servers in the cluster
- name String
- Cluster name
- project
Id Double - Project ID
- region
Id Double - Region ID
- Map<String,String>
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- flavor string
- Cluster flavor ID
- servers
Count number - Number of servers in the cluster
- servers
Settings CloudGpu Virtual Cluster Servers Settings - Configuration settings for the servers in the cluster
- name string
- Cluster name
- project
Id number - Project ID
- region
Id number - Region ID
- {[key: string]: string}
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- flavor str
- Cluster flavor ID
- servers_
count float - Number of servers in the cluster
- servers_
settings CloudGpu Virtual Cluster Servers Settings Args - Configuration settings for the servers in the cluster
- name str
- Cluster name
- project_
id float - Project ID
- region_
id float - Region ID
- Mapping[str, str]
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- flavor String
- Cluster flavor ID
- servers
Count Number - Number of servers in the cluster
- servers
Settings Property Map - Configuration settings for the servers in the cluster
- name String
- Cluster name
- project
Id Number - Project ID
- region
Id Number - Region ID
- Map<String>
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
Outputs
All input properties are implicitly available as output properties. Additionally, the CloudGpuVirtualCluster resource produces the following output properties:
- Created
At string - Cluster creation date time
- Id string
- The provider-assigned unique ID for this managed resource.
- Servers
Ids List<string> - List of cluster nodes
- Status string
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- Updated
At string - Cluster update date time
- Created
At string - Cluster creation date time
- Id string
- The provider-assigned unique ID for this managed resource.
- Servers
Ids []string - List of cluster nodes
- Status string
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- Updated
At string - Cluster update date time
- created
At String - Cluster creation date time
- id String
- The provider-assigned unique ID for this managed resource.
- servers
Ids List<String> - List of cluster nodes
- status String
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- updated
At String - Cluster update date time
- created
At string - Cluster creation date time
- id string
- The provider-assigned unique ID for this managed resource.
- servers
Ids string[] - List of cluster nodes
- status string
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- updated
At string - Cluster update date time
- created_
at str - Cluster creation date time
- id str
- The provider-assigned unique ID for this managed resource.
- servers_
ids Sequence[str] - List of cluster nodes
- status str
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- updated_
at str - Cluster update date time
- created
At String - Cluster creation date time
- id String
- The provider-assigned unique ID for this managed resource.
- servers
Ids List<String> - List of cluster nodes
- status String
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- updated
At String - Cluster update date time
Look up Existing CloudGpuVirtualCluster Resource
Get an existing CloudGpuVirtualCluster resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: CloudGpuVirtualClusterState, opts?: CustomResourceOptions): CloudGpuVirtualCluster@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
created_at: Optional[str] = None,
flavor: Optional[str] = None,
name: Optional[str] = None,
project_id: Optional[float] = None,
region_id: Optional[float] = None,
servers_count: Optional[float] = None,
servers_ids: Optional[Sequence[str]] = None,
servers_settings: Optional[CloudGpuVirtualClusterServersSettingsArgs] = None,
status: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
updated_at: Optional[str] = None) -> CloudGpuVirtualClusterfunc GetCloudGpuVirtualCluster(ctx *Context, name string, id IDInput, state *CloudGpuVirtualClusterState, opts ...ResourceOption) (*CloudGpuVirtualCluster, error)public static CloudGpuVirtualCluster Get(string name, Input<string> id, CloudGpuVirtualClusterState? state, CustomResourceOptions? opts = null)public static CloudGpuVirtualCluster get(String name, Output<String> id, CloudGpuVirtualClusterState state, CustomResourceOptions options)resources: _: type: gcore:CloudGpuVirtualCluster get: id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Created
At string - Cluster creation date time
- Flavor string
- Cluster flavor ID
- Name string
- Cluster name
- Project
Id double - Project ID
- Region
Id double - Region ID
- Servers
Count double - Number of servers in the cluster
- Servers
Ids List<string> - List of cluster nodes
- Servers
Settings CloudGpu Virtual Cluster Servers Settings - Configuration settings for the servers in the cluster
- Status string
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- Dictionary<string, string>
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- Updated
At string - Cluster update date time
- Created
At string - Cluster creation date time
- Flavor string
- Cluster flavor ID
- Name string
- Cluster name
- Project
Id float64 - Project ID
- Region
Id float64 - Region ID
- Servers
Count float64 - Number of servers in the cluster
- Servers
Ids []string - List of cluster nodes
- Servers
Settings CloudGpu Virtual Cluster Servers Settings Args - Configuration settings for the servers in the cluster
- Status string
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- map[string]string
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- Updated
At string - Cluster update date time
- created
At String - Cluster creation date time
- flavor String
- Cluster flavor ID
- name String
- Cluster name
- project
Id Double - Project ID
- region
Id Double - Region ID
- servers
Count Double - Number of servers in the cluster
- servers
Ids List<String> - List of cluster nodes
- servers
Settings CloudGpu Virtual Cluster Servers Settings - Configuration settings for the servers in the cluster
- status String
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- Map<String,String>
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- updated
At String - Cluster update date time
- created
At string - Cluster creation date time
- flavor string
- Cluster flavor ID
- name string
- Cluster name
- project
Id number - Project ID
- region
Id number - Region ID
- servers
Count number - Number of servers in the cluster
- servers
Ids string[] - List of cluster nodes
- servers
Settings CloudGpu Virtual Cluster Servers Settings - Configuration settings for the servers in the cluster
- status string
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- {[key: string]: string}
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- updated
At string - Cluster update date time
- created_
at str - Cluster creation date time
- flavor str
- Cluster flavor ID
- name str
- Cluster name
- project_
id float - Project ID
- region_
id float - Region ID
- servers_
count float - Number of servers in the cluster
- servers_
ids Sequence[str] - List of cluster nodes
- servers_
settings CloudGpu Virtual Cluster Servers Settings Args - Configuration settings for the servers in the cluster
- status str
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- Mapping[str, str]
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- updated_
at str - Cluster update date time
- created
At String - Cluster creation date time
- flavor String
- Cluster flavor ID
- name String
- Cluster name
- project
Id Number - Project ID
- region
Id Number - Region ID
- servers
Count Number - Number of servers in the cluster
- servers
Ids List<String> - List of cluster nodes
- servers
Settings Property Map - Configuration settings for the servers in the cluster
- status String
- Cluster status Available values: "active", "creating", "degraded", "deleting", "error", "rebooting", "rebuilding", "resizing", "shutoff".
- Map<String>
- Key-value tags to associate with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Both tag keys and values have a maximum length of 255 characters. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
- updated
At String - Cluster update date time
Supporting Types
CloudGpuVirtualClusterServersSettings, CloudGpuVirtualClusterServersSettingsArgs
- Interfaces
List<Cloud
Gpu Virtual Cluster Servers Settings Interface> - Subnet IPs and floating IPs
- Volumes
List<Cloud
Gpu Virtual Cluster Servers Settings Volume> - List of volumes
- Credentials
Cloud
Gpu Virtual Cluster Servers Settings Credentials - Optional server access credentials
-
List<Cloud
Gpu Virtual Cluster Servers Settings File Share> - List of file shares to be mounted across the cluster.
- Security
Groups List<CloudGpu Virtual Cluster Servers Settings Security Group> - List of security groups UUIDs
- User
Data string - Optional custom user data (Base64-encoded)
- Interfaces
[]Cloud
Gpu Virtual Cluster Servers Settings Interface - Subnet IPs and floating IPs
- Volumes
[]Cloud
Gpu Virtual Cluster Servers Settings Volume - List of volumes
- Credentials
Cloud
Gpu Virtual Cluster Servers Settings Credentials - Optional server access credentials
-
[]Cloud
Gpu Virtual Cluster Servers Settings File Share - List of file shares to be mounted across the cluster.
- Security
Groups []CloudGpu Virtual Cluster Servers Settings Security Group - List of security groups UUIDs
- User
Data string - Optional custom user data (Base64-encoded)
- interfaces
List<Cloud
Gpu Virtual Cluster Servers Settings Interface> - Subnet IPs and floating IPs
- volumes
List<Cloud
Gpu Virtual Cluster Servers Settings Volume> - List of volumes
- credentials
Cloud
Gpu Virtual Cluster Servers Settings Credentials - Optional server access credentials
-
List<Cloud
Gpu Virtual Cluster Servers Settings File Share> - List of file shares to be mounted across the cluster.
- security
Groups List<CloudGpu Virtual Cluster Servers Settings Security Group> - List of security groups UUIDs
- user
Data String - Optional custom user data (Base64-encoded)
- interfaces
Cloud
Gpu Virtual Cluster Servers Settings Interface[] - Subnet IPs and floating IPs
- volumes
Cloud
Gpu Virtual Cluster Servers Settings Volume[] - List of volumes
- credentials
Cloud
Gpu Virtual Cluster Servers Settings Credentials - Optional server access credentials
-
Cloud
Gpu Virtual Cluster Servers Settings File Share[] - List of file shares to be mounted across the cluster.
- security
Groups CloudGpu Virtual Cluster Servers Settings Security Group[] - List of security groups UUIDs
- user
Data string - Optional custom user data (Base64-encoded)
- interfaces
Sequence[Cloud
Gpu Virtual Cluster Servers Settings Interface] - Subnet IPs and floating IPs
- volumes
Sequence[Cloud
Gpu Virtual Cluster Servers Settings Volume] - List of volumes
- credentials
Cloud
Gpu Virtual Cluster Servers Settings Credentials - Optional server access credentials
-
Sequence[Cloud
Gpu Virtual Cluster Servers Settings File Share] - List of file shares to be mounted across the cluster.
- security_
groups Sequence[CloudGpu Virtual Cluster Servers Settings Security Group] - List of security groups UUIDs
- user_
data str - Optional custom user data (Base64-encoded)
- interfaces List<Property Map>
- Subnet IPs and floating IPs
- volumes List<Property Map>
- List of volumes
- credentials Property Map
- Optional server access credentials
- List<Property Map>
- List of file shares to be mounted across the cluster.
- security
Groups List<Property Map> - List of security groups UUIDs
- user
Data String - Optional custom user data (Base64-encoded)
CloudGpuVirtualClusterServersSettingsCredentials, CloudGpuVirtualClusterServersSettingsCredentialsArgs
- Password
Wo string - Used to set the password for the specified 'username' on Linux instances. If 'username' is not provided, the password is applied to the default user of the image. Mutually exclusive with '
user_data' - only one can be specified. - Password
Wo doubleVersion - Version of the password write-only field. Increment this value to trigger an update when changing the password.
- Ssh
Key stringName - Specifies the name of the SSH keypair, created via the
/v1/
ssh_keysendpoint. - Username string
- The 'username' and 'password' fields create a new user on the system
- Password
Wo string - Used to set the password for the specified 'username' on Linux instances. If 'username' is not provided, the password is applied to the default user of the image. Mutually exclusive with '
user_data' - only one can be specified. - Password
Wo float64Version - Version of the password write-only field. Increment this value to trigger an update when changing the password.
- Ssh
Key stringName - Specifies the name of the SSH keypair, created via the
/v1/
ssh_keysendpoint. - Username string
- The 'username' and 'password' fields create a new user on the system
- password
Wo String - Used to set the password for the specified 'username' on Linux instances. If 'username' is not provided, the password is applied to the default user of the image. Mutually exclusive with '
user_data' - only one can be specified. - password
Wo DoubleVersion - Version of the password write-only field. Increment this value to trigger an update when changing the password.
- ssh
Key StringName - Specifies the name of the SSH keypair, created via the
/v1/
ssh_keysendpoint. - username String
- The 'username' and 'password' fields create a new user on the system
- password
Wo string - Used to set the password for the specified 'username' on Linux instances. If 'username' is not provided, the password is applied to the default user of the image. Mutually exclusive with '
user_data' - only one can be specified. - password
Wo numberVersion - Version of the password write-only field. Increment this value to trigger an update when changing the password.
- ssh
Key stringName - Specifies the name of the SSH keypair, created via the
/v1/
ssh_keysendpoint. - username string
- The 'username' and 'password' fields create a new user on the system
- password_
wo str - Used to set the password for the specified 'username' on Linux instances. If 'username' is not provided, the password is applied to the default user of the image. Mutually exclusive with '
user_data' - only one can be specified. - password_
wo_ floatversion - Version of the password write-only field. Increment this value to trigger an update when changing the password.
- ssh_
key_ strname - Specifies the name of the SSH keypair, created via the
/v1/
ssh_keysendpoint. - username str
- The 'username' and 'password' fields create a new user on the system
- password
Wo String - Used to set the password for the specified 'username' on Linux instances. If 'username' is not provided, the password is applied to the default user of the image. Mutually exclusive with '
user_data' - only one can be specified. - password
Wo NumberVersion - Version of the password write-only field. Increment this value to trigger an update when changing the password.
- ssh
Key StringName - Specifies the name of the SSH keypair, created via the
/v1/
ssh_keysendpoint. - username String
- The 'username' and 'password' fields create a new user on the system
CloudGpuVirtualClusterServersSettingsFileShare, CloudGpuVirtualClusterServersSettingsFileShareArgs
- id str
- Unique identifier of the file share in UUID format.
- mount_
path str - Absolute mount path inside the system where the file share will be mounted.
CloudGpuVirtualClusterServersSettingsInterface, CloudGpuVirtualClusterServersSettingsInterfaceArgs
- Type string
- Available values: "external", "subnet", <span pulumi-lang-nodejs=""anySubnet"" pulumi-lang-dotnet=""AnySubnet"" pulumi-lang-go=""anySubnet"" pulumi-lang-python=""any_subnet"" pulumi-lang-yaml=""anySubnet"" pulumi-lang-java=""anySubnet"">"any_subnet".
- Floating
Ip CloudGpu Virtual Cluster Servers Settings Interface Floating Ip - Floating IP config for this subnet attachment
- Ip
Family string - Which subnets should be selected: IPv4, IPv6, or use dual stack. Available values: "dual", "ipv4", "ipv6".
- Name string
- Interface name
- Network
Id string - Network ID the subnet belongs to. Port will be plugged in this network
- Subnet
Id string - Port is assigned an IP address from this subnet
- Type string
- Available values: "external", "subnet", <span pulumi-lang-nodejs=""anySubnet"" pulumi-lang-dotnet=""AnySubnet"" pulumi-lang-go=""anySubnet"" pulumi-lang-python=""any_subnet"" pulumi-lang-yaml=""anySubnet"" pulumi-lang-java=""anySubnet"">"any_subnet".
- Floating
Ip CloudGpu Virtual Cluster Servers Settings Interface Floating Ip - Floating IP config for this subnet attachment
- Ip
Family string - Which subnets should be selected: IPv4, IPv6, or use dual stack. Available values: "dual", "ipv4", "ipv6".
- Name string
- Interface name
- Network
Id string - Network ID the subnet belongs to. Port will be plugged in this network
- Subnet
Id string - Port is assigned an IP address from this subnet
- type String
- Available values: "external", "subnet", <span pulumi-lang-nodejs=""anySubnet"" pulumi-lang-dotnet=""AnySubnet"" pulumi-lang-go=""anySubnet"" pulumi-lang-python=""any_subnet"" pulumi-lang-yaml=""anySubnet"" pulumi-lang-java=""anySubnet"">"any_subnet".
- floating
Ip CloudGpu Virtual Cluster Servers Settings Interface Floating Ip - Floating IP config for this subnet attachment
- ip
Family String - Which subnets should be selected: IPv4, IPv6, or use dual stack. Available values: "dual", "ipv4", "ipv6".
- name String
- Interface name
- network
Id String - Network ID the subnet belongs to. Port will be plugged in this network
- subnet
Id String - Port is assigned an IP address from this subnet
- type string
- Available values: "external", "subnet", <span pulumi-lang-nodejs=""anySubnet"" pulumi-lang-dotnet=""AnySubnet"" pulumi-lang-go=""anySubnet"" pulumi-lang-python=""any_subnet"" pulumi-lang-yaml=""anySubnet"" pulumi-lang-java=""anySubnet"">"any_subnet".
- floating
Ip CloudGpu Virtual Cluster Servers Settings Interface Floating Ip - Floating IP config for this subnet attachment
- ip
Family string - Which subnets should be selected: IPv4, IPv6, or use dual stack. Available values: "dual", "ipv4", "ipv6".
- name string
- Interface name
- network
Id string - Network ID the subnet belongs to. Port will be plugged in this network
- subnet
Id string - Port is assigned an IP address from this subnet
- type str
- Available values: "external", "subnet", <span pulumi-lang-nodejs=""anySubnet"" pulumi-lang-dotnet=""AnySubnet"" pulumi-lang-go=""anySubnet"" pulumi-lang-python=""any_subnet"" pulumi-lang-yaml=""anySubnet"" pulumi-lang-java=""anySubnet"">"any_subnet".
- floating_
ip CloudGpu Virtual Cluster Servers Settings Interface Floating Ip - Floating IP config for this subnet attachment
- ip_
family str - Which subnets should be selected: IPv4, IPv6, or use dual stack. Available values: "dual", "ipv4", "ipv6".
- name str
- Interface name
- network_
id str - Network ID the subnet belongs to. Port will be plugged in this network
- subnet_
id str - Port is assigned an IP address from this subnet
- type String
- Available values: "external", "subnet", <span pulumi-lang-nodejs=""anySubnet"" pulumi-lang-dotnet=""AnySubnet"" pulumi-lang-go=""anySubnet"" pulumi-lang-python=""any_subnet"" pulumi-lang-yaml=""anySubnet"" pulumi-lang-java=""anySubnet"">"any_subnet".
- floating
Ip Property Map - Floating IP config for this subnet attachment
- ip
Family String - Which subnets should be selected: IPv4, IPv6, or use dual stack. Available values: "dual", "ipv4", "ipv6".
- name String
- Interface name
- network
Id String - Network ID the subnet belongs to. Port will be plugged in this network
- subnet
Id String - Port is assigned an IP address from this subnet
CloudGpuVirtualClusterServersSettingsInterfaceFloatingIp, CloudGpuVirtualClusterServersSettingsInterfaceFloatingIpArgs
- Source string
- Available values: "new".
- Source string
- Available values: "new".
- source String
- Available values: "new".
- source string
- Available values: "new".
- source str
- Available values: "new".
- source String
- Available values: "new".
CloudGpuVirtualClusterServersSettingsSecurityGroup, CloudGpuVirtualClusterServersSettingsSecurityGroupArgs
- Id string
- Resource ID
- Id string
- Resource ID
- id String
- Resource ID
- id string
- Resource ID
- id str
- Resource ID
- id String
- Resource ID
CloudGpuVirtualClusterServersSettingsVolume, CloudGpuVirtualClusterServersSettingsVolumeArgs
- Boot
Index double - Boot index of the volume
- Name string
- Volume name
- Size double
- Volume size in GiB
- Source string
- Available values: "new", "image".
- Type string
- Volume type Available values: "cold", "ssdhiiops", "ssdlocal", <span pulumi-lang-nodejs=""ssdLowlatency"" pulumi-lang-dotnet=""SsdLowlatency"" pulumi-lang-go=""ssdLowlatency"" pulumi-lang-python=""ssd_lowlatency"" pulumi-lang-yaml=""ssdLowlatency"" pulumi-lang-java=""ssdLowlatency"">"ssd_lowlatency", "standard", "ultra".
- Delete
On boolTermination - Flag indicating whether the volume is deleted on instance termination
- Image
Id string - Image ID for the volume (required if source is 'image')
- Dictionary<string, string>
- Tags associated with the volume
- Boot
Index float64 - Boot index of the volume
- Name string
- Volume name
- Size float64
- Volume size in GiB
- Source string
- Available values: "new", "image".
- Type string
- Volume type Available values: "cold", "ssdhiiops", "ssdlocal", <span pulumi-lang-nodejs=""ssdLowlatency"" pulumi-lang-dotnet=""SsdLowlatency"" pulumi-lang-go=""ssdLowlatency"" pulumi-lang-python=""ssd_lowlatency"" pulumi-lang-yaml=""ssdLowlatency"" pulumi-lang-java=""ssdLowlatency"">"ssd_lowlatency", "standard", "ultra".
- Delete
On boolTermination - Flag indicating whether the volume is deleted on instance termination
- Image
Id string - Image ID for the volume (required if source is 'image')
- map[string]string
- Tags associated with the volume
- boot
Index Double - Boot index of the volume
- name String
- Volume name
- size Double
- Volume size in GiB
- source String
- Available values: "new", "image".
- type String
- Volume type Available values: "cold", "ssdhiiops", "ssdlocal", <span pulumi-lang-nodejs=""ssdLowlatency"" pulumi-lang-dotnet=""SsdLowlatency"" pulumi-lang-go=""ssdLowlatency"" pulumi-lang-python=""ssd_lowlatency"" pulumi-lang-yaml=""ssdLowlatency"" pulumi-lang-java=""ssdLowlatency"">"ssd_lowlatency", "standard", "ultra".
- delete
On BooleanTermination - Flag indicating whether the volume is deleted on instance termination
- image
Id String - Image ID for the volume (required if source is 'image')
- Map<String,String>
- Tags associated with the volume
- boot
Index number - Boot index of the volume
- name string
- Volume name
- size number
- Volume size in GiB
- source string
- Available values: "new", "image".
- type string
- Volume type Available values: "cold", "ssdhiiops", "ssdlocal", <span pulumi-lang-nodejs=""ssdLowlatency"" pulumi-lang-dotnet=""SsdLowlatency"" pulumi-lang-go=""ssdLowlatency"" pulumi-lang-python=""ssd_lowlatency"" pulumi-lang-yaml=""ssdLowlatency"" pulumi-lang-java=""ssdLowlatency"">"ssd_lowlatency", "standard", "ultra".
- delete
On booleanTermination - Flag indicating whether the volume is deleted on instance termination
- image
Id string - Image ID for the volume (required if source is 'image')
- {[key: string]: string}
- Tags associated with the volume
- boot_
index float - Boot index of the volume
- name str
- Volume name
- size float
- Volume size in GiB
- source str
- Available values: "new", "image".
- type str
- Volume type Available values: "cold", "ssdhiiops", "ssdlocal", <span pulumi-lang-nodejs=""ssdLowlatency"" pulumi-lang-dotnet=""SsdLowlatency"" pulumi-lang-go=""ssdLowlatency"" pulumi-lang-python=""ssd_lowlatency"" pulumi-lang-yaml=""ssdLowlatency"" pulumi-lang-java=""ssdLowlatency"">"ssd_lowlatency", "standard", "ultra".
- delete_
on_ booltermination - Flag indicating whether the volume is deleted on instance termination
- image_
id str - Image ID for the volume (required if source is 'image')
- Mapping[str, str]
- Tags associated with the volume
- boot
Index Number - Boot index of the volume
- name String
- Volume name
- size Number
- Volume size in GiB
- source String
- Available values: "new", "image".
- type String
- Volume type Available values: "cold", "ssdhiiops", "ssdlocal", <span pulumi-lang-nodejs=""ssdLowlatency"" pulumi-lang-dotnet=""SsdLowlatency"" pulumi-lang-go=""ssdLowlatency"" pulumi-lang-python=""ssd_lowlatency"" pulumi-lang-yaml=""ssdLowlatency"" pulumi-lang-java=""ssdLowlatency"">"ssd_lowlatency", "standard", "ultra".
- delete
On BooleanTermination - Flag indicating whether the volume is deleted on instance termination
- image
Id String - Image ID for the volume (required if source is 'image')
- Map<String>
- Tags associated with the volume
Import
$ pulumi import gcore:index/cloudGpuVirtualCluster:CloudGpuVirtualCluster example '<project_id>/<region_id>/<cluster_id>'
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- gcore g-core/terraform-provider-gcore
- License
- Notes
- This Pulumi package is based on the
gcoreTerraform Provider.
published on Tuesday, Mar 24, 2026 by g-core
