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.
---
Update cloudstack provider
2017-04-10 18:15:08 +02:00
# cloudstack_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
Creates and automatically starts a virtual machine based on a service offering,
disk offering, and template.
## Example Usage
Update cloudstack provider
2017-04-10 18:15:08 +02:00
```hcl
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
resource "cloudstack_instance" "web" {
website/docs: Run `terraform fmt` on code examples (#12075) * docs/vsphere: Fix code block * docs: Convert `...` to `# ...` to allow `terraform fmt`ing * docs: Trim trailing whitespace * docs: First-pass run of `terraform fmt` on code examples
2017-02-18 23:48:50 +01:00
name = "server-1"
service_offering = "small"
network_id = "6eb22f91-7454-4107-89f4-36afcdf33021"
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.
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
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.
Delete all deprecated parameters before the 0.7 release Updated the docs accordingly and also executed all the acceptance tests after making the changes…
2016-06-25 19:42:01 +02:00
* `template` - (Required) The name or ID of the template used for this
instance. Changing this forces a new resource to be created.
* `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.
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
Changing this forces a new resource to be created.
Delete all deprecated parameters before the 0.7 release Updated the docs accordingly and also executed all the acceptance tests after making the changes…
2016-06-25 19:42:01 +02:00
* `group` - (Optional) The group name of the instance.
* `affinity_group_ids` - (Optional) List of affinity group IDs to apply to this
instance.
* `affinity_group_names` - (Optional) List of affinity group names to apply to
this instance.
* `security_group_ids` - (Optional) List of security group IDs to apply to this
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
instance. Changing this forces a new resource to be created.
Delete all deprecated parameters before the 0.7 release Updated the docs accordingly and also executed all the acceptance tests after making the changes…
2016-06-25 19:42:01 +02:00
* `security_group_names` - (Optional) List of security group names to apply 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
* `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)
## Attributes Reference
The following attributes are exported:
* `id` - The instance ID.
* `display_name` - The display name of the instance.