gcore 0.22.0, Apr 30 25

gcore 0.22.0 published on Wednesday, Apr 30, 2025 by g-core

gcore.Instance

Explore with Pulumi AI

gcore 0.22.0 published on Wednesday, Apr 30, 2025 by g-core

Example Usage

Coming soon!

Coming soon!

Coming soon!

Coming soon!

Coming soon!

resources:
  network:
    type: gcore:Network
    properties:
      mtu: 1450
      type: vxlan
      regionId: 1
      projectId: 1
  subnet:
    type: gcore:Subnet
    properties:
      cidr: 192.168.10.0/24
      networkId: ${network.networkId}
      dnsNameservers:
        - 8.8.4.4
        - 1.1.1.1
      hostRoutes:
        - destination: 10.0.3.0/24
          nexthop: 10.0.0.13
      gatewayIp: 192.168.10.1
      regionId: 1
      projectId: 1
  firstVolumeVolume:
    type: gcore:Volume
    properties:
      typeName: ssd_hiiops
      size: 5
      imageId: f4ce3d30-e29c-4cfd-811f-46f383b6081f
      regionId: 1
      projectId: 1
  secondVolume:
    type: gcore:Volume
    properties:
      typeName: ssd_hiiops
      size: 5
      regionId: 1
      projectId: 1
  instance: # ***
  # // another one example with one interface to private network and fip to internet
  # //***
    type: gcore:Instance
    properties:
      flavorId: g1-standard-2-4
      volumes:
        - source: existing-volume
          volumeId: ${firstVolumeVolume.volumeId}
          bootIndex: 0
        - source: existing-volume
          volumeId: ${secondVolume.volumeId}
          bootIndex: 1
      interfaces:
        - type: subnet
          networkId: ${network.networkId}
          subnetId: ${subnet.subnetId}
          securityGroups:
            - d75db0b2-58f1-4a11-88c6-a932bb897310
      # deprecated, use metadata_map instead
      #   //metadata {
      #   //  key = "some_key"
      #   //  value = "some_data"
      #   //}
      metadataMap:
        some_key: some_value
        stage: dev
      configurations:
        - key: some_key
          value: some_data
      regionId: 1
      projectId: 1
  fixedIp:
    type: gcore:Reservedfixedip
    properties:
      projectId: 1
      regionId: 1
      type: ip_address
      networkId: faf6507b-1ff1-4ebf-b540-befd5c09fe06
      fixedIpAddress: 192.168.13.6
      isVip: false
  firstVolumeIndex/volumeVolume:
    type: gcore:Volume
    properties:
      typeName: ssd_hiiops
      size: 10
      imageId: 6dc4e061-6fab-41f3-91a3-0ba848fb32d9
      projectId: 1
      regionId: 1
  fip:
    type: gcore:Floatingip
    properties:
      projectId: 1
      regionId: 1
      fixedIpAddress: ${fixedIp.fixedIpAddress}
      portId: ${fixedIp.portId}
  index/instanceInstance:
    type: gcore:Instance
    properties:
      projectId: 1
      regionId: 1
      flavorId: g1-standard-1-2
      volumes:
        - source: existing-volume
          volumeId: ${firstVolumeVolume.volumeId}
          bootIndex: 0
      interfaces:
        - type: reserved_fixed_ip
          portId: ${fixedIp.portId}
          fipSource: existing
          existingFipId: ${fip.floatingipId}
          securityGroups:
            - ada84751-fcca-4491-9249-2dfceb321616

Create Instance Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);

@overload
def Instance(resource_name: str,
             args: InstanceArgs,
             opts: Optional[ResourceOptions] = None)

@overload
def Instance(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             flavor_id: Optional[str] = None,
             interfaces: Optional[Sequence[InstanceInterfaceArgs]] = None,
             name_template: Optional[str] = None,
             last_updated: Optional[str] = None,
             configurations: Optional[Sequence[InstanceConfigurationArgs]] = None,
             instance_id: Optional[str] = None,
             allow_app_ports: Optional[bool] = None,
             keypair_name: Optional[str] = None,
             name_templates: Optional[Sequence[str]] = None,
             metadata_map: Optional[Mapping[str, str]] = None,
             metadatas: Optional[Sequence[InstanceMetadataArgs]] = None,
             name: Optional[str] = None,
             flavor: Optional[Mapping[str, str]] = None,
             addresses: Optional[Sequence[InstanceAddressArgs]] = None,
             region_name: Optional[str] = None,
             project_id: Optional[float] = None,
             project_name: Optional[str] = None,
             region_id: Optional[float] = None,
             password: Optional[str] = None,
             server_group: Optional[str] = None,
             status: Optional[str] = None,
             user_data: Optional[str] = None,
             userdata: Optional[str] = None,
             username: Optional[str] = None,
             vm_state: Optional[str] = None,
             volumes: Optional[Sequence[InstanceVolumeArgs]] = None)

func NewInstance(ctx *Context, name string, args InstanceArgs, opts ...ResourceOption) (*Instance, error)

public Instance(string name, InstanceArgs args, CustomResourceOptions? opts = null)

public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)

type: gcore:Instance
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 InstanceArgs: 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 InstanceArgs: 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 InstanceArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args InstanceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args InstanceArgs: 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 instanceResource = new Gcore.Instance("instanceResource", new()
{
    FlavorId = "string",
    Interfaces = new[]
    {
        new Gcore.Inputs.InstanceInterfaceArgs
        {
            ExistingFipId = "string",
            FipSource = "string",
            IpAddress = "string",
            NetworkId = "string",
            Order = 0,
            PortId = "string",
            SecurityGroups = new[]
            {
                "string",
            },
            SubnetId = "string",
            Type = "string",
        },
    },
    NameTemplate = "string",
    LastUpdated = "string",
    Configurations = new[]
    {
        new Gcore.Inputs.InstanceConfigurationArgs
        {
            Key = "string",
            Value = "string",
        },
    },
    InstanceId = "string",
    AllowAppPorts = false,
    KeypairName = "string",
    MetadataMap = 
    {
        { "string", "string" },
    },
    Name = "string",
    Flavor = 
    {
        { "string", "string" },
    },
    Addresses = new[]
    {
        new Gcore.Inputs.InstanceAddressArgs
        {
            Nets = new[]
            {
                new Gcore.Inputs.InstanceAddressNetArgs
                {
                    Addr = "string",
                    Type = "string",
                },
            },
        },
    },
    RegionName = "string",
    ProjectId = 0,
    ProjectName = "string",
    RegionId = 0,
    Password = "string",
    ServerGroup = "string",
    Status = "string",
    UserData = "string",
    Username = "string",
    VmState = "string",
    Volumes = new[]
    {
        new Gcore.Inputs.InstanceVolumeArgs
        {
            Source = "string",
            AttachmentTag = "string",
            BootIndex = 0,
            DeleteOnTermination = false,
            Id = "string",
            ImageId = "string",
            Name = "string",
            Size = 0,
            TypeName = "string",
            VolumeId = "string",
        },
    },
});

example, err := gcore.NewInstance(ctx, "instanceResource", &gcore.InstanceArgs{
	FlavorId: pulumi.String("string"),
	Interfaces: gcore.InstanceInterfaceArray{
		&gcore.InstanceInterfaceArgs{
			ExistingFipId: pulumi.String("string"),
			FipSource:     pulumi.String("string"),
			IpAddress:     pulumi.String("string"),
			NetworkId:     pulumi.String("string"),
			Order:         pulumi.Float64(0),
			PortId:        pulumi.String("string"),
			SecurityGroups: pulumi.StringArray{
				pulumi.String("string"),
			},
			SubnetId: pulumi.String("string"),
			Type:     pulumi.String("string"),
		},
	},
	NameTemplate: pulumi.String("string"),
	LastUpdated:  pulumi.String("string"),
	Configurations: gcore.InstanceConfigurationArray{
		&gcore.InstanceConfigurationArgs{
			Key:   pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
	InstanceId:    pulumi.String("string"),
	AllowAppPorts: pulumi.Bool(false),
	KeypairName:   pulumi.String("string"),
	MetadataMap: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Name: pulumi.String("string"),
	Flavor: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Addresses: gcore.InstanceAddressArray{
		&gcore.InstanceAddressArgs{
			Nets: gcore.InstanceAddressNetArray{
				&gcore.InstanceAddressNetArgs{
					Addr: pulumi.String("string"),
					Type: pulumi.String("string"),
				},
			},
		},
	},
	RegionName:  pulumi.String("string"),
	ProjectId:   pulumi.Float64(0),
	ProjectName: pulumi.String("string"),
	RegionId:    pulumi.Float64(0),
	Password:    pulumi.String("string"),
	ServerGroup: pulumi.String("string"),
	Status:      pulumi.String("string"),
	UserData:    pulumi.String("string"),
	Username:    pulumi.String("string"),
	VmState:     pulumi.String("string"),
	Volumes: gcore.InstanceVolumeArray{
		&gcore.InstanceVolumeArgs{
			Source:              pulumi.String("string"),
			AttachmentTag:       pulumi.String("string"),
			BootIndex:           pulumi.Float64(0),
			DeleteOnTermination: pulumi.Bool(false),
			Id:                  pulumi.String("string"),
			ImageId:             pulumi.String("string"),
			Name:                pulumi.String("string"),
			Size:                pulumi.Float64(0),
			TypeName:            pulumi.String("string"),
			VolumeId:            pulumi.String("string"),
		},
	},
})

var instanceResource = new Instance("instanceResource", InstanceArgs.builder()
    .flavorId("string")
    .interfaces(InstanceInterfaceArgs.builder()
        .existingFipId("string")
        .fipSource("string")
        .ipAddress("string")
        .networkId("string")
        .order(0)
        .portId("string")
        .securityGroups("string")
        .subnetId("string")
        .type("string")
        .build())
    .nameTemplate("string")
    .lastUpdated("string")
    .configurations(InstanceConfigurationArgs.builder()
        .key("string")
        .value("string")
        .build())
    .instanceId("string")
    .allowAppPorts(false)
    .keypairName("string")
    .metadataMap(Map.of("string", "string"))
    .name("string")
    .flavor(Map.of("string", "string"))
    .addresses(InstanceAddressArgs.builder()
        .nets(InstanceAddressNetArgs.builder()
            .addr("string")
            .type("string")
            .build())
        .build())
    .regionName("string")
    .projectId(0)
    .projectName("string")
    .regionId(0)
    .password("string")
    .serverGroup("string")
    .status("string")
    .userData("string")
    .username("string")
    .vmState("string")
    .volumes(InstanceVolumeArgs.builder()
        .source("string")
        .attachmentTag("string")
        .bootIndex(0)
        .deleteOnTermination(false)
        .id("string")
        .imageId("string")
        .name("string")
        .size(0)
        .typeName("string")
        .volumeId("string")
        .build())
    .build());

instance_resource = gcore.Instance("instanceResource",
    flavor_id="string",
    interfaces=[{
        "existing_fip_id": "string",
        "fip_source": "string",
        "ip_address": "string",
        "network_id": "string",
        "order": 0,
        "port_id": "string",
        "security_groups": ["string"],
        "subnet_id": "string",
        "type": "string",
    }],
    name_template="string",
    last_updated="string",
    configurations=[{
        "key": "string",
        "value": "string",
    }],
    instance_id="string",
    allow_app_ports=False,
    keypair_name="string",
    metadata_map={
        "string": "string",
    },
    name="string",
    flavor={
        "string": "string",
    },
    addresses=[{
        "nets": [{
            "addr": "string",
            "type": "string",
        }],
    }],
    region_name="string",
    project_id=0,
    project_name="string",
    region_id=0,
    password="string",
    server_group="string",
    status="string",
    user_data="string",
    username="string",
    vm_state="string",
    volumes=[{
        "source": "string",
        "attachment_tag": "string",
        "boot_index": 0,
        "delete_on_termination": False,
        "id": "string",
        "image_id": "string",
        "name": "string",
        "size": 0,
        "type_name": "string",
        "volume_id": "string",
    }])

const instanceResource = new gcore.Instance("instanceResource", {
    flavorId: "string",
    interfaces: [{
        existingFipId: "string",
        fipSource: "string",
        ipAddress: "string",
        networkId: "string",
        order: 0,
        portId: "string",
        securityGroups: ["string"],
        subnetId: "string",
        type: "string",
    }],
    nameTemplate: "string",
    lastUpdated: "string",
    configurations: [{
        key: "string",
        value: "string",
    }],
    instanceId: "string",
    allowAppPorts: false,
    keypairName: "string",
    metadataMap: {
        string: "string",
    },
    name: "string",
    flavor: {
        string: "string",
    },
    addresses: [{
        nets: [{
            addr: "string",
            type: "string",
        }],
    }],
    regionName: "string",
    projectId: 0,
    projectName: "string",
    regionId: 0,
    password: "string",
    serverGroup: "string",
    status: "string",
    userData: "string",
    username: "string",
    vmState: "string",
    volumes: [{
        source: "string",
        attachmentTag: "string",
        bootIndex: 0,
        deleteOnTermination: false,
        id: "string",
        imageId: "string",
        name: "string",
        size: 0,
        typeName: "string",
        volumeId: "string",
    }],
});

type: gcore:Instance
properties:
    addresses:
        - nets:
            - addr: string
              type: string
    allowAppPorts: false
    configurations:
        - key: string
          value: string
    flavor:
        string: string
    flavorId: string
    instanceId: string
    interfaces:
        - existingFipId: string
          fipSource: string
          ipAddress: string
          networkId: string
          order: 0
          portId: string
          securityGroups:
            - string
          subnetId: string
          type: string
    keypairName: string
    lastUpdated: string
    metadataMap:
        string: string
    name: string
    nameTemplate: string
    password: string
    projectId: 0
    projectName: string
    regionId: 0
    regionName: string
    serverGroup: string
    status: string
    userData: string
    username: string
    vmState: string
    volumes:
        - attachmentTag: string
          bootIndex: 0
          deleteOnTermination: false
          id: string
          imageId: string
          name: string
          size: 0
          source: string
          typeName: string
          volumeId: string

Instance 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 Instance resource accepts the following input properties:

FlavorId string
Interfaces List<InstanceInterface>
Addresses List<InstanceAddress>
AllowAppPorts bool
Configurations List<InstanceConfiguration>
Flavor Dictionary<string, string>
InstanceId string: The ID of this resource.
KeypairName string
LastUpdated string
MetadataMap Dictionary<string, string>
Metadatas List<InstanceMetadata>: Deprecated: Deprecated
Name string
NameTemplate string
NameTemplates List<string>: Deprecated: Deprecated
Password string
ProjectId double
ProjectName string
RegionId double
RegionName string
ServerGroup string
Status string
UserData string
Userdata string: Deprecated
Deprecated: Deprecated
Username string
VmState string: Current vm state, use stopped to stop vm and active to start
Volumes List<InstanceVolume>

FlavorId string
Interfaces []InstanceInterfaceArgs
Addresses []InstanceAddressArgs
AllowAppPorts bool
Configurations []InstanceConfigurationArgs
Flavor map[string]string
InstanceId string: The ID of this resource.
KeypairName string
LastUpdated string
MetadataMap map[string]string
Metadatas []InstanceMetadataArgs: Deprecated: Deprecated
Name string
NameTemplate string
NameTemplates []string: Deprecated: Deprecated
Password string
ProjectId float64
ProjectName string
RegionId float64
RegionName string
ServerGroup string
Status string
UserData string
Userdata string: Deprecated
Deprecated: Deprecated
Username string
VmState string: Current vm state, use stopped to stop vm and active to start
Volumes []InstanceVolumeArgs

flavorId String
interfaces List<InstanceInterface>
addresses List<InstanceAddress>
allowAppPorts Boolean
configurations List<InstanceConfiguration>
flavor Map<String,String>
instanceId String: The ID of this resource.
keypairName String
lastUpdated String
metadataMap Map<String,String>
metadatas List<InstanceMetadata>: Deprecated: Deprecated
name String
nameTemplate String
nameTemplates List<String>: Deprecated: Deprecated
password String
projectId Double
projectName String
regionId Double
regionName String
serverGroup String
status String
userData String
userdata String: Deprecated
Deprecated: Deprecated
username String
vmState String: Current vm state, use stopped to stop vm and active to start
volumes List<InstanceVolume>

flavorId string
interfaces InstanceInterface[]
addresses InstanceAddress[]
allowAppPorts boolean
configurations InstanceConfiguration[]
flavor {[key: string]: string}
instanceId string: The ID of this resource.
keypairName string
lastUpdated string
metadataMap {[key: string]: string}
metadatas InstanceMetadata[]: Deprecated: Deprecated
name string
nameTemplate string
nameTemplates string[]: Deprecated: Deprecated
password string
projectId number
projectName string
regionId number
regionName string
serverGroup string
status string
userData string
userdata string: Deprecated
Deprecated: Deprecated
username string
vmState string: Current vm state, use stopped to stop vm and active to start
volumes InstanceVolume[]

flavor_id str
interfaces Sequence[InstanceInterfaceArgs]
addresses Sequence[InstanceAddressArgs]
allow_app_ports bool
configurations Sequence[InstanceConfigurationArgs]
flavor Mapping[str, str]
instance_id str: The ID of this resource.
keypair_name str
last_updated str
metadata_map Mapping[str, str]
metadatas Sequence[InstanceMetadataArgs]: Deprecated: Deprecated
name str
name_template str
name_templates Sequence[str]: Deprecated: Deprecated
password str
project_id float
project_name str
region_id float
region_name str
server_group str
status str
user_data str
userdata str: Deprecated
Deprecated: Deprecated
username str
vm_state str: Current vm state, use stopped to stop vm and active to start
volumes Sequence[InstanceVolumeArgs]

flavorId String
interfaces List<Property Map>
addresses List<Property Map>
allowAppPorts Boolean
configurations List<Property Map>
flavor Map<String>
instanceId String: The ID of this resource.
keypairName String
lastUpdated String
metadataMap Map<String>
metadatas List<Property Map>: Deprecated: Deprecated
name String
nameTemplate String
nameTemplates List<String>: Deprecated: Deprecated
password String
projectId Number
projectName String
regionId Number
regionName String
serverGroup String
status String
userData String
userdata String: Deprecated
Deprecated: Deprecated
username String
vmState String: Current vm state, use stopped to stop vm and active to start
volumes List<Property Map>

Outputs

All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.
SecurityGroups List<InstanceSecurityGroup>: Firewalls list

Id string: The provider-assigned unique ID for this managed resource.
SecurityGroups []InstanceSecurityGroup: Firewalls list

id String: The provider-assigned unique ID for this managed resource.
securityGroups List<InstanceSecurityGroup>: Firewalls list

id string: The provider-assigned unique ID for this managed resource.
securityGroups InstanceSecurityGroup[]: Firewalls list

id str: The provider-assigned unique ID for this managed resource.
security_groups Sequence[InstanceSecurityGroup]: Firewalls list

id String: The provider-assigned unique ID for this managed resource.
securityGroups List<Property Map>: Firewalls list

Look up Existing Instance Resource

Get an existing Instance 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?: InstanceState, opts?: CustomResourceOptions): Instance

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        addresses: Optional[Sequence[InstanceAddressArgs]] = None,
        allow_app_ports: Optional[bool] = None,
        configurations: Optional[Sequence[InstanceConfigurationArgs]] = None,
        flavor: Optional[Mapping[str, str]] = None,
        flavor_id: Optional[str] = None,
        instance_id: Optional[str] = None,
        interfaces: Optional[Sequence[InstanceInterfaceArgs]] = None,
        keypair_name: Optional[str] = None,
        last_updated: Optional[str] = None,
        metadata_map: Optional[Mapping[str, str]] = None,
        metadatas: Optional[Sequence[InstanceMetadataArgs]] = None,
        name: Optional[str] = None,
        name_template: Optional[str] = None,
        name_templates: Optional[Sequence[str]] = None,
        password: Optional[str] = None,
        project_id: Optional[float] = None,
        project_name: Optional[str] = None,
        region_id: Optional[float] = None,
        region_name: Optional[str] = None,
        security_groups: Optional[Sequence[InstanceSecurityGroupArgs]] = None,
        server_group: Optional[str] = None,
        status: Optional[str] = None,
        user_data: Optional[str] = None,
        userdata: Optional[str] = None,
        username: Optional[str] = None,
        vm_state: Optional[str] = None,
        volumes: Optional[Sequence[InstanceVolumeArgs]] = None) -> Instance

func GetInstance(ctx *Context, name string, id IDInput, state *InstanceState, opts ...ResourceOption) (*Instance, error)

public static Instance Get(string name, Input<string> id, InstanceState? state, CustomResourceOptions? opts = null)

public static Instance get(String name, Output<String> id, InstanceState state, CustomResourceOptions options)

resources:  _:    type: gcore:Instance    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.

The following state arguments are supported:

Addresses List<InstanceAddress>
AllowAppPorts bool
Configurations List<InstanceConfiguration>
Flavor Dictionary<string, string>
FlavorId string
InstanceId string: The ID of this resource.
Interfaces List<InstanceInterface>
KeypairName string
LastUpdated string
MetadataMap Dictionary<string, string>
Metadatas List<InstanceMetadata>: Deprecated: Deprecated
Name string
NameTemplate string
NameTemplates List<string>: Deprecated: Deprecated
Password string
ProjectId double
ProjectName string
RegionId double
RegionName string
SecurityGroups List<InstanceSecurityGroup>: Firewalls list
ServerGroup string
Status string
UserData string
Userdata string: Deprecated
Deprecated: Deprecated
Username string
VmState string: Current vm state, use stopped to stop vm and active to start
Volumes List<InstanceVolume>

Addresses []InstanceAddressArgs
AllowAppPorts bool
Configurations []InstanceConfigurationArgs
Flavor map[string]string
FlavorId string
InstanceId string: The ID of this resource.
Interfaces []InstanceInterfaceArgs
KeypairName string
LastUpdated string
MetadataMap map[string]string
Metadatas []InstanceMetadataArgs: Deprecated: Deprecated
Name string
NameTemplate string
NameTemplates []string: Deprecated: Deprecated
Password string
ProjectId float64
ProjectName string
RegionId float64
RegionName string
SecurityGroups []InstanceSecurityGroupArgs: Firewalls list
ServerGroup string
Status string
UserData string
Userdata string: Deprecated
Deprecated: Deprecated
Username string
VmState string: Current vm state, use stopped to stop vm and active to start
Volumes []InstanceVolumeArgs

addresses List<InstanceAddress>
allowAppPorts Boolean
configurations List<InstanceConfiguration>
flavor Map<String,String>
flavorId String
instanceId String: The ID of this resource.
interfaces List<InstanceInterface>
keypairName String
lastUpdated String
metadataMap Map<String,String>
metadatas List<InstanceMetadata>: Deprecated: Deprecated
name String
nameTemplate String
nameTemplates List<String>: Deprecated: Deprecated
password String
projectId Double
projectName String
regionId Double
regionName String
securityGroups List<InstanceSecurityGroup>: Firewalls list
serverGroup String
status String
userData String
userdata String: Deprecated
Deprecated: Deprecated
username String
vmState String: Current vm state, use stopped to stop vm and active to start
volumes List<InstanceVolume>

addresses InstanceAddress[]
allowAppPorts boolean
configurations InstanceConfiguration[]
flavor {[key: string]: string}
flavorId string
instanceId string: The ID of this resource.
interfaces InstanceInterface[]
keypairName string
lastUpdated string
metadataMap {[key: string]: string}
metadatas InstanceMetadata[]: Deprecated: Deprecated
name string
nameTemplate string
nameTemplates string[]: Deprecated: Deprecated
password string
projectId number
projectName string
regionId number
regionName string
securityGroups InstanceSecurityGroup[]: Firewalls list
serverGroup string
status string
userData string
userdata string: Deprecated
Deprecated: Deprecated
username string
vmState string: Current vm state, use stopped to stop vm and active to start
volumes InstanceVolume[]

addresses Sequence[InstanceAddressArgs]
allow_app_ports bool
configurations Sequence[InstanceConfigurationArgs]
flavor Mapping[str, str]
flavor_id str
instance_id str: The ID of this resource.
interfaces Sequence[InstanceInterfaceArgs]
keypair_name str
last_updated str
metadata_map Mapping[str, str]
metadatas Sequence[InstanceMetadataArgs]: Deprecated: Deprecated
name str
name_template str
name_templates Sequence[str]: Deprecated: Deprecated
password str
project_id float
project_name str
region_id float
region_name str
security_groups Sequence[InstanceSecurityGroupArgs]: Firewalls list
server_group str
status str
user_data str
userdata str: Deprecated
Deprecated: Deprecated
username str
vm_state str: Current vm state, use stopped to stop vm and active to start
volumes Sequence[InstanceVolumeArgs]

addresses List<Property Map>
allowAppPorts Boolean
configurations List<Property Map>
flavor Map<String>
flavorId String
instanceId String: The ID of this resource.
interfaces List<Property Map>
keypairName String
lastUpdated String
metadataMap Map<String>
metadatas List<Property Map>: Deprecated: Deprecated
name String
nameTemplate String
nameTemplates List<String>: Deprecated: Deprecated
password String
projectId Number
projectName String
regionId Number
regionName String
securityGroups List<Property Map>: Firewalls list
serverGroup String
status String
userData String
userdata String: Deprecated
Deprecated: Deprecated
username String
vmState String: Current vm state, use stopped to stop vm and active to start
volumes List<Property Map>

Supporting Types

InstanceAddress, InstanceAddressArgs

Nets List<InstanceAddressNet>

Nets []InstanceAddressNet

nets List<InstanceAddressNet>

nets InstanceAddressNet[]

nets Sequence[InstanceAddressNet]

nets List<Property Map>

InstanceAddressNet, InstanceAddressNetArgs

Addr string
Type string

Addr string
Type string

addr String
type String

addr string
type string

addr str
type str

addr String
type String

InstanceConfiguration, InstanceConfigurationArgs

Key string
Value string

Key string
Value string

key String
value String

key string
value string

key str
value str

key String
value String

InstanceInterface, InstanceInterfaceArgs

ExistingFipId string
FipSource string
IpAddress string
NetworkId string: required if type is 'subnet' or 'any_subnet'
Order double: Order of attaching interface
PortId string: required if type is 'reservedfixedip'
SecurityGroups List<string>: list of security group IDs
SubnetId string: required if type is 'subnet'
Type string: Available value is 'subnet', 'anysubnet', 'external', 'reservedfixed_ip'

ExistingFipId string
FipSource string
IpAddress string
NetworkId string: required if type is 'subnet' or 'any_subnet'
Order float64: Order of attaching interface
PortId string: required if type is 'reservedfixedip'
SecurityGroups []string: list of security group IDs
SubnetId string: required if type is 'subnet'
Type string: Available value is 'subnet', 'anysubnet', 'external', 'reservedfixed_ip'

existingFipId String
fipSource String
ipAddress String
networkId String: required if type is 'subnet' or 'any_subnet'
order Double: Order of attaching interface
portId String: required if type is 'reservedfixedip'
securityGroups List<String>: list of security group IDs
subnetId String: required if type is 'subnet'
type String: Available value is 'subnet', 'anysubnet', 'external', 'reservedfixed_ip'

existingFipId string
fipSource string
ipAddress string
networkId string: required if type is 'subnet' or 'any_subnet'
order number: Order of attaching interface
portId string: required if type is 'reservedfixedip'
securityGroups string[]: list of security group IDs
subnetId string: required if type is 'subnet'
type string: Available value is 'subnet', 'anysubnet', 'external', 'reservedfixed_ip'

existing_fip_id str
fip_source str
ip_address str
network_id str: required if type is 'subnet' or 'any_subnet'
order float: Order of attaching interface
port_id str: required if type is 'reservedfixedip'
security_groups Sequence[str]: list of security group IDs
subnet_id str: required if type is 'subnet'
type str: Available value is 'subnet', 'anysubnet', 'external', 'reservedfixed_ip'

existingFipId String
fipSource String
ipAddress String
networkId String: required if type is 'subnet' or 'any_subnet'
order Number: Order of attaching interface
portId String: required if type is 'reservedfixedip'
securityGroups List<String>: list of security group IDs
subnetId String: required if type is 'subnet'
type String: Available value is 'subnet', 'anysubnet', 'external', 'reservedfixed_ip'

InstanceMetadata, InstanceMetadataArgs

Key string
Value string

Key string
Value string

key String
value String

key string
value string

key str
value str

key String
value String

InstanceSecurityGroup, InstanceSecurityGroupArgs

Id string
Name string

Id string
Name string

id String
name String

id string
name string

id str
name str

id String
name String

InstanceVolume, InstanceVolumeArgs

Source string: Currently available only 'existing-volume' value
AttachmentTag string
BootIndex double: If boot_index==0 volumes can not detached
DeleteOnTermination bool
Id string
ImageId string
Name string
Size double
TypeName string
VolumeId string

Source string: Currently available only 'existing-volume' value
AttachmentTag string
BootIndex float64: If boot_index==0 volumes can not detached
DeleteOnTermination bool
Id string
ImageId string
Name string
Size float64
TypeName string
VolumeId string

source String: Currently available only 'existing-volume' value
attachmentTag String
bootIndex Double: If boot_index==0 volumes can not detached
deleteOnTermination Boolean
id String
imageId String
name String
size Double
typeName String
volumeId String

source string: Currently available only 'existing-volume' value
attachmentTag string
bootIndex number: If boot_index==0 volumes can not detached
deleteOnTermination boolean
id string
imageId string
name string
size number
typeName string
volumeId string

source str: Currently available only 'existing-volume' value
attachment_tag str
boot_index float: If boot_index==0 volumes can not detached
delete_on_termination bool
id str
image_id str
name str
size float
type_name str
volume_id str

source String: Currently available only 'existing-volume' value
attachmentTag String
bootIndex Number: If boot_index==0 volumes can not detached
deleteOnTermination Boolean
id String
imageId String
name String
size Number
typeName String
volumeId String

Import

import using <project_id>:<region_id>:<instance_id> format

$ pulumi import gcore:index/instance:Instance instance1 1:6:447d2959-8ae0-4ca0-8d47-9f050a3637d7

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 gcore Terraform Provider.

gcore 0.22.0 published on Wednesday, Apr 30, 2025 by g-core

g-core/terraform-provider-gcore

gcore.Instance

On this page

On this page

Example Usage

Create Instance Resource

Constructor syntax

Parameters

Constructor example

Instance Resource Properties

Inputs

Outputs

Look up Existing Instance Resource

Supporting Types

InstanceAddress, InstanceAddressArgs

InstanceAddressNet, InstanceAddressNetArgs

InstanceConfiguration, InstanceConfigurationArgs

InstanceInterface, InstanceInterfaceArgs

InstanceMetadata, InstanceMetadataArgs

InstanceSecurityGroup, InstanceSecurityGroupArgs

InstanceVolume, InstanceVolumeArgs

Import

Package Details

On this page

On this page