ResiLien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
terraform/website/source/docs/providers/cloudstack/r/instance.html.markdown

85 lines
2.7 KiB
Markdown
Raw Normal View History

First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
---
layout: "cloudstack"
page_title: "CloudStack: cloudstack_instance"
sidebar_current: "docs-cloudstack-resource-instance"
description: |-
Creates and automatically starts a virtual machine based on a service offering, disk offering, and template.
---
# cloudstack\_instance
Creates and automatically starts a virtual machine based on a service offering,
disk offering, and template.
## Example Usage
```
resource "cloudstack_instance" "web" {
Adding some needed references and updated a couple of passes
2015-01-13 11:28:05 +01:00
name = "server-1"
service_offering= "small"
Refactor the use of names vs IDs for parameters referencing other TF resources We have a curtesy function in place allowing you to specify both a `name` of `ID`. But in order for the graph to be build correctly when you recreate or taint stuff that other resources depend on, we need to reference the `ID` and *not* the `name`. So in order to enforce this and by that help people to not make this mistake unknowingly, I deprecated all the parameters this allies to and changed the logic, docs and tests accordingly.
2016-04-11 17:14:19 +02:00
network_id = "6eb22f91-7454-4107-89f4-36afcdf33021"
Adding some needed references and updated a couple of passes
2015-01-13 11:28:05 +01:00
template = "CentOS 6.5"
zone = "zone-1"
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
}
```
## Argument Reference
The following arguments are supported:
Update the docs to match the changes made in PR #5587
2016-03-25 18:24:16 +01:00
* `name` - (Required) The name of the instance.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
* `display_name` - (Optional) The display name of the instance.
Added group attribute to cloudstack instance documentation markdown
2016-04-11 19:26:46 +02:00
* `group` - (Optional) The group name of the instance.
provider/cloudstack: updating and tweaking tests and docs Making sure everything is up-to-spec again and all tests run flawless, after merging in some new functionality.
2015-06-09 12:38:05 +02:00
* `service_offering` - (Required) The name or ID of the service offering used
for this instance.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
Refactor the use of names vs IDs for parameters referencing other TF resources We have a curtesy function in place allowing you to specify both a `name` of `ID`. But in order for the graph to be build correctly when you recreate or taint stuff that other resources depend on, we need to reference the `ID` and *not* the `name`. So in order to enforce this and by that help people to not make this mistake unknowingly, I deprecated all the parameters this allies to and changed the logic, docs and tests accordingly.
2016-04-11 17:14:19 +02:00
* `network_id` - (Optional) The ID of the network to connect this instance
provider/cloudstack: updating and tweaking tests and docs Making sure everything is up-to-spec again and all tests run flawless, after merging in some new functionality.
2015-06-09 12:38:05 +02:00
to. Changing this forces a new resource to be created.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
Refactor the use of names vs IDs for parameters referencing other TF resources We have a curtesy function in place allowing you to specify both a `name` of `ID`. But in order for the graph to be build correctly when you recreate or taint stuff that other resources depend on, we need to reference the `ID` and *not* the `name`. So in order to enforce this and by that help people to not make this mistake unknowingly, I deprecated all the parameters this allies to and changed the logic, docs and tests accordingly.
2016-04-11 17:14:19 +02:00
* `network` - (Optional, Deprecated) The name or ID of the network to connect
this instance to. Changing this forces a new resource to be created.
Make the CloudStack provider more inline with the other provider It turns out all other providers use `ip_address` where the CloudStack provider uses `ipaddress`. To make this more consistent this PR deprecates `ipaddress` and adds `ip_address` where needed…
2016-04-04 22:13:27 +02:00
* `ip_address` - (Optional) The IP address to assign to this instance. Changing
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
this forces a new resource to be created.
Make the CloudStack provider more inline with the other provider It turns out all other providers use `ip_address` where the CloudStack provider uses `ipaddress`. To make this more consistent this PR deprecates `ipaddress` and adds `ip_address` where needed…
2016-04-04 22:13:27 +02:00
* `ipaddress` - (Optional, Deprecated) The IP address to assign to this instance.
Changing this forces a new resource to be created.
provider/cloudstack: updating and tweaking tests and docs Making sure everything is up-to-spec again and all tests run flawless, after merging in some new functionality.
2015-06-09 12:38:05 +02:00
* `template` - (Required) The name or ID of the template used for this
instance. Changing this forces a new resource to be created.
* `project` - (Optional) The name or ID of the project to deploy this
instance to. Changing this forces a new resource to be created.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
Updates and tweaks
2015-07-16 17:40:04 +02:00
* `zone` - (Required) The name or ID of the zone where this instance will be
created. Changing this forces a new resource to be created.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
provider/cloudstack: updating and tweaking tests and docs Making sure everything is up-to-spec again and all tests run flawless, after merging in some new functionality.
2015-06-09 12:38:05 +02:00
* `user_data` - (Optional) The user data to provide when launching the
instance.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
provider/cloudstack: updating and tweaking tests and docs Making sure everything is up-to-spec again and all tests run flawless, after merging in some new functionality.
2015-06-09 12:38:05 +02:00
* `keypair` - (Optional) The name of the SSH key pair that will be used to
access this instance.
Update docs for Cloudstack with SSH keypair and timeout
2015-06-03 12:40:53 +02:00
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
* `expunge` - (Optional) This determines if the instance is expunged when it is
destroyed (defaults false)
provider/cloudstack: add root_disk_size
2016-06-08 10:23:14 +02:00
* `root_disk_size` - (Optional) The size of the root disk in
gigabytes. The root disk is resized on deploy. Only applies to
template-based deployments.
provider/cloudstack: add affinity_group_names
2016-06-20 17:52:35 +02:00
* `affinity_group_names` - (Optional) List of affinity groups to apply to this
instance. Changing this forces a new resource to be created.
provider/cloudstack: add security_group_names
2016-06-20 17:12:52 +02:00
* `security_group_names` - (Optional) List of security groups to apply to this
isnstance. Changing this forces a new resource to be created.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
## Attributes Reference
The following attributes are exported:
* `id` - The instance ID.
* `display_name` - The display name of the instance.