github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/alicloud/d/zones.html.markdown (about)

     1  ---
     2  layout: "alicloud"
     3  page_title: "Alicloud: alicloud_zones"
     4  sidebar_current: "docs-alicloud-datasource-zones"
     5  description: |-
     6      Provides a list of Availability Zones which can be used by an Alicloud account.
     7  ---
     8  
     9  # alicloud_zones
    10  
    11  The Zones data source allows access to the list of Alicloud Zones which can be accessed by an Alicloud account within the region configured in the provider.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  # Declare the data source
    17  data "alicloud_zones" "default" {
    18    "available_instance_type" = "ecs.s2.large"
    19    "available_disk_category" = "cloud_ssd"
    20  }
    21  
    22  # Create ecs instance with the first matched zone
    23  
    24  resource "alicloud_instance" "instance" {
    25    availability_zone = "${data.alicloud_zones.default.zones.0.id}"
    26  
    27    # ...
    28  }
    29  ```
    30  
    31  ## Argument Reference
    32  
    33  The following arguments are supported:
    34  
    35  * `available_instance_type` - (Optional) Limit search to specific instance type.
    36  * `available_resource_creation` - (Optional) Limit search to specific resource type. The following values are allowed `Instance`, `Disk` and `VSwitch`.
    37  * `available_disk_category` - (Optional) Limit search to specific disk category. Can be either `cloud`, `ephemeral`, or `ephemeral_ssd`.
    38  
    39  ## Attributes Reference
    40  
    41  The following attributes are exported:
    42  
    43  * `id` - ID of the zone.
    44  * `local_name` - Name of the zone in the local language.
    45  * `available_instance_types` - Instance types allowed.
    46  * `available_resource_creation` - Type of resource that can be created.
    47  * `available_disk_categories` - Set of supported disk categories.