github.com/koding/terraform@v0.6.4-0.20170608090606-5d7e0339779d/website/source/docs/providers/cloudstack/index.html.markdown (about) 1 --- 2 layout: "cloudstack" 3 page_title: "Provider: CloudStack" 4 sidebar_current: "docs-cloudstack-index" 5 description: |- 6 The CloudStack provider is used to interact with the many resources supported by CloudStack. The provider needs to be configured with a URL pointing to a running CloudStack API and the proper credentials before it can be used. 7 --- 8 9 # CloudStack Provider 10 11 The CloudStack provider is used to interact with the many resources 12 supported by CloudStack. The provider needs to be configured with a 13 URL pointing to a running CloudStack API and the proper credentials 14 before it can be used. 15 16 In order to provide the required configuration options you can either 17 supply values for the `api_url`, `api_key` and `secret_key` fields, or 18 for the `config` and `profile` fields. A combination of both is not 19 allowed and will not work. 20 21 Use the navigation to the left to read about the available resources. 22 23 ## Example Usage 24 25 ```hcl 26 # Configure the CloudStack Provider 27 provider "cloudstack" { 28 api_url = "${var.cloudstack_api_url}" 29 api_key = "${var.cloudstack_api_key}" 30 secret_key = "${var.cloudstack_secret_key}" 31 } 32 33 # Create a web server 34 resource "cloudstack_instance" "web" { 35 # ... 36 } 37 ``` 38 39 ## Argument Reference 40 41 The following arguments are supported: 42 43 * `api_url` - (Optional) This is the CloudStack API URL. It can also be sourced 44 from the `CLOUDSTACK_API_URL` environment variable. 45 46 * `api_key` - (Optional) This is the CloudStack API key. It can also be sourced 47 from the `CLOUDSTACK_API_KEY` environment variable. 48 49 * `secret_key` - (Optional) This is the CloudStack secret key. It can also be 50 sourced from the `CLOUDSTACK_SECRET_KEY` environment variable. 51 52 * `config` - (Optional) The path to a `CloudMonkey` config file. If set the API 53 URL, key and secret will be retrieved from this file. 54 55 * `profile` - (Optional) Used together with the `config` option. Specifies which 56 `CloudMonkey` profile in the config file to use. 57 58 * `http_get_only` - (Optional) Some cloud providers only allow HTTP GET calls to 59 their CloudStack API. If using such a provider, you need to set this to `true` 60 in order for the provider to only make GET calls and no POST calls. It can also 61 be sourced from the `CLOUDSTACK_HTTP_GET_ONLY` environment variable. 62 63 * `timeout` - (Optional) A value in seconds. This is the time allowed for Cloudstack 64 to complete each asynchronous job triggered. If unset, this can be sourced from the 65 `CLOUDSTACK_TIMEOUT` environment variable. Otherwise, this will default to 300 66 seconds.