terraform/website/source/docs/providers/azure/index.html.markdown

layout	page_title	sidebar_current	description
azure	Provider: Azure Service Management	docs-azure-index	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.

Azure Service Management Provider

The Azure Service Management 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.

Use the navigation to the left to read about the available resources.

Example Usage

# Configure the Azure Provider
provider "azure" {
  publish_settings = "${file("credentials.publishsettings")}"
}

# Create a web server
resource "azure_instance" "web" {
    ...
}

Argument Reference

The following arguments are supported:

• publish_settings - (Optional) Contents of a valid publishsettings file, used to authenticate with the Azure API. You can download the settings file here: https://manage.windowsazure.com/publishsettings. You must either provide publish settings or both a subscription_id and certificate. It can also be sourced from the AZURE_PUBLISH_SETTINGS environment variable.

• subscription_id - (Optional) The subscription ID to use. If a settings_file is not provided subscription_id is required. It can also be sourced from the AZURE_SUBSCRIPTION_ID environment variable.

• certificate - (Optional) The certificate used to authenticate with the Azure API. If a settings_file is not provided certificate is required. It can also be sourced from the AZURE_CERTIFICATE environment variable.

These arguments are supported for backwards compatibility, and may be removed in a future version:

• settings_file - Deprecated: please use publish_settings instead. Path to or contents of a valid publishsettings file, used to authenticate with the Azure API. You can download the settings file here: https://manage.windowsazure.com/publishsettings. You must either provide (or source from the AZURE_SETTINGS_FILE environment variable) a settings file or both a subscription_id and certificate.

Testing:

The following environment variables must be set for the running of the acceptance test suite:

• A valid combination of the above which are required for authentification.

• AZURE_STORAGE - The name of a storage account to be used in tests which require a storage backend. The storage account needs to be located in the Western US Azure region.