github.com/turtlemonvh/terraform@v0.6.9-0.20151204001754-8e40b6b855e8/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  Use the navigation to the left to read about the available resources.
    17  
    18  ## Example Usage
    19  
    20  ```
    21  # Configure the CloudStack Provider
    22  provider "cloudstack" {
    23      api_url = "${var.cloudstack_api_url}"
    24      api_key = "${var.cloudstack_api_key}"
    25      secret_key = "${var.cloudstack_secret_key}"
    26  }
    27  
    28  # Create a web server
    29  resource "cloudstack_instance" "web" {
    30      ...
    31  }
    32  ```
    33  
    34  ## Argument Reference
    35  
    36  The following arguments are supported:
    37  
    38  * `api_url` - (Required) This is the CloudStack API URL. It must be provided, but
    39    it can also be sourced from the `CLOUDSTACK_API_URL` environment variable.
    40  
    41  * `api_key` - (Required) This is the CloudStack API key. It must be provided, but
    42    it can also be sourced from the `CLOUDSTACK_API_KEY` environment variable.
    43  
    44  * `secret_key` - (Required) This is the CloudStack secret key. It must be provided,
    45    but it can also be sourced from the `CLOUDSTACK_SECRET_KEY` environment variable.
    46  
    47  * `http_get_only` - (Optional) Some cloud providers only allow HTTP GET calls to
    48    their CloudStack API. If using such a provider, you need to set this to `true`
    49    in order for the provider to only make GET calls and no POST calls. It can also
    50    be sourced from the `CLOUDSTACK_HTTP_GET_ONLY` environment variable.
    51  
    52  * `timeout` - (Optional) A value in seconds. This is the time allowed for Cloudstack
    53    to complete each asynchronous job triggered. If unset, this can be sourced from the
    54    `CLOUDSTACK_TIMEOUT` environment variable. Otherwise, this will default to 300
    55    seconds.