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

44 lines
1.4 KiB
Markdown

---
layout: "azure"
page_title: "Provider: Azure"
sidebar_current: "docs-azure-index"
description: |-
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 Provider
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](https://manage.windowsazure.com/publishsettings) 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" {
settings_file = "${var.azure_settings_file}"
}
# Create a web server
resource "azure_instance" "web" {
...
}
```
## Argument Reference
The following arguments are supported:
* `settings_file` - (Required) The path to a publish settings file used to
authenticate with the Azure API. You can download the settings file here:
https://manage.windowsazure.com/publishsettings. It must be provided, but
it can also be sourced from the `AZURE_SETTINGS_FILE` environment variable.
* `subscription_id` - (Optional) The subscription ID to use. If not provided
the first subscription ID in publish settings file will be used. It can
also be sourced from the `AZURE_SUBSCRIPTION_ID` environment variable.