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.