github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/azurerm/r/traffic_manager_endpoint.html.markdown (about)

     1  ---
     2  layout: "azurerm"
     3  page_title: "Azure Resource Manager: azurerm_traffic_manager_endpoint"
     4  sidebar_current: "docs-azurerm-resource-network-traffic-manager-endpoint"
     5  description: |-
     6    Creates a Traffic Manager Endpoint.
     7  ---
     8  
     9  # azurerm\_traffic\_manager\_endpoint
    10  
    11  Creates a Traffic Manager Endpoint.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "azurerm_traffic_manager_profile" "test" {
    17    name                = "profile1"
    18    resource_group_name = "${azurerm_resource_group.test.name}"
    19    location            = "West US"
    20  
    21    traffic_routing_method = "Weighted"
    22  
    23    dns_config {
    24      relative_name = "profile1"
    25      ttl           = 100
    26    }
    27  
    28    monitor_config {
    29      protocol = "http"
    30      port     = 80
    31      path     = "/"
    32    }
    33  
    34    tags {
    35      environment = "Production"
    36    }
    37  }
    38  
    39  resource "azurerm_traffic_manager_endpoint" "test" {
    40    name                = "profile1"
    41    resource_group_name = "${azurerm_resource_group.test.name}"
    42    profile_name        = "${azurerm_traffic_manager_profile.test.name}"
    43    target              = "terraform.io"
    44    type                = "externalEndpoints"
    45    weight              = 100
    46  }
    47  ```
    48  
    49  ## Argument Reference
    50  
    51  The following arguments are supported:
    52  
    53  * `name` - (Required) The name of the Traffic Manager endpoint. Changing this forces a
    54      new resource to be created.
    55  
    56  * `resource_group_name` - (Required) The name of the resource group in which to
    57      create the Traffic Manager endpoint.
    58  
    59  * `profile_name` - (Required) The name of the Traffic Manager Profile to attach
    60      create the Traffic Manager endpoint.
    61  
    62  * `endpoint_status` - (Optional) The status of the Endpoint, can be set to
    63      either `Enabled` or `Disabled`. Defaults to `Enabled`.
    64  
    65  * `type` - (Required) The Endpoint type, must be one of:
    66      - `azureEndpoints`
    67      - `externalEndpoints`
    68      - `nestedEndpoints`
    69  
    70  * `target` - (Optional) The FQDN DNS name of the target. This argument must be
    71      provided for an endpoint of type `externalEndpoints`, for other types it
    72      will be computed.
    73  
    74  * `target_resource_id` - (Optional) The resource id of an Azure resource to
    75      target. This argument must be provided for an endpoint of type
    76      `azureEndpoints` or `nestedEndpoints`.
    77  
    78  * `weight` - (Optional) Specifies how much traffic should be distributed to this
    79      endpoint, this must be specified for Profiles using the  `Weighted` traffic
    80      routing method. Supports values between 1 and 1000.
    81  
    82  * `priority` - (Optional) Specifies the priority of this Endpoint, this must be
    83      specified for Profiles using the `Priority` traffic routing method. Supports
    84      values between 1 and 1000, with no Endpoints sharing the same value. If
    85      omitted the value will be computed in order of creation.
    86  
    87  * `endpoint_location` - (Optional) Specifies the Azure location of the Endpoint,
    88      this must be specified for Profiles using the `Performance` routing method
    89      if the Endpoint is of either type `nestedEndpoints` or `externalEndpoints`.
    90      For Endpoints of type `azureEndpoints` the value will be taken from the
    91      location of the Azure target resource.
    92  
    93  * `min_child_endpoints` - (Optional) This argument specifies the minimum number
    94      of endpoints that must be ‘online’ in the child profile in order for the
    95      parent profile to direct traffic to any of the endpoints in that child
    96      profile. This argument only applies to Endpoints of type `nestedEndpoints`
    97      and defaults to `1`.
    98  
    99  ## Attributes Reference
   100  
   101  The following attributes are exported:
   102  
   103  * `id` - The Traffic Manager Endpoint id.
   104  
   105  ## Import
   106  
   107  Traffic Manager Endpoints can be imported using the `resource id`, e.g.
   108  
   109  ```
   110  terraform import azurerm_traffic_manager_endpoint.testEndpoints /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/trafficManagerProfiles/mytrafficmanagerprofile1/azureEndpoints/mytrafficmanagerendpoint
   111  ```