github.com/vtorhonen/terraform@v0.9.0-beta2.0.20170307220345-5d894e4ffda7/website/source/docs/providers/azure/index.html.markdown (about)

     1  ---
     2  layout: "azure"
     3  page_title: "Provider: Azure Service Management"
     4  sidebar_current: "docs-azure-index"
     5  description: |-
     6    The Azure provider is used to interact with the many resources supported by Azure. The provider needs to be configured with a publish settings file and optionally a subscription ID before it can be used.
     7  ---
     8  
     9  # Azure Service Management Provider
    10  
    11  [arm]: /docs/providers/azurerm/index.html
    12  
    13  The Azure Service Management provider is used to interact with the many resources supported
    14  by Azure. The provider needs to be configured with a [publish settings
    15  file](https://manage.windowsazure.com/publishsettings) and optionally a
    16  subscription ID before it can be used.
    17  
    18  Use the navigation to the left to read about the available resources.
    19  
    20  ## Example Usage
    21  
    22  ```
    23  # Configure the Azure Provider
    24  provider "azure" {
    25    publish_settings = "${file("credentials.publishsettings")}"
    26  }
    27  
    28  # Create a web server
    29  resource "azure_instance" "web" {
    30    # ...
    31  }
    32  ```
    33  
    34  ## Argument Reference
    35  
    36  The following arguments are supported:
    37  
    38  * `publish_settings` - (Optional) Contents of a valid `publishsettings` file,
    39    used to authenticate with the Azure API. You can download the settings file
    40    here: https://manage.windowsazure.com/publishsettings. You must either
    41    provide publish settings or both a `subscription_id` and `certificate`. It
    42    can also be sourced from the `AZURE_PUBLISH_SETTINGS` environment variable.
    43  
    44  * `subscription_id` - (Optional) The subscription ID to use. If a
    45    `settings_file` is not provided `subscription_id` is required. It can also
    46    be sourced from the `AZURE_SUBSCRIPTION_ID` environment variable.
    47  
    48  * `certificate` - (Optional) The certificate used to authenticate with the
    49    Azure API. If a `settings_file` is not provided `certificate` is required.
    50    It can also be sourced from the `AZURE_CERTIFICATE` environment variable.
    51  
    52  These arguments are supported for backwards compatibility, and may be removed
    53  in a future version:
    54  
    55  * `settings_file` - __Deprecated: please use `publish_settings` instead.__
    56    Path to or contents of a valid `publishsettings` file, used to
    57    authenticate with the Azure API. You can download the settings file here:
    58    https://manage.windowsazure.com/publishsettings. You must either provide
    59    (or source from the `AZURE_SETTINGS_FILE` environment variable) a settings
    60    file or both a `subscription_id` and `certificate`.
    61  
    62  ## Testing:
    63  
    64  The following environment variables must be set for the running of the
    65  acceptance test suite:
    66  
    67  * A valid combination of the above which are required for authentification.
    68  
    69  * `AZURE_STORAGE` - The name of a storage account to be used in tests which
    70    require a storage backend. The storage account needs to be located in
    71    the Western US Azure region.