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

     1  ---
     2  layout: "datadog"
     3  page_title: "Datadog: datadog_downtime"
     4  sidebar_current: "docs-datadog-resource-downtime"
     5  description: |-
     6    Provides a Datadog downtime resource. This can be used to create and manage downtimes.
     7  ---
     8  
     9  # datadog_downtime
    10  
    11  Provides a Datadog downtime resource. This can be used to create and manage Datadog downtimes.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  # Create a new daily 1700-0900 Datadog downtime
    17  resource "datadog_downtime" "foo" {
    18    scope = ["*"]
    19    start = 1483308000
    20    end   = 1483365600
    21  
    22    recurrence {
    23      type   = "days"
    24      period = 1
    25    }
    26  }
    27  ```
    28  
    29  ## Argument Reference
    30  
    31  The following arguments are supported:
    32  
    33  * `scope` - (Required) A list of items to apply the downtime to, e.g. host:X
    34  * `start` - (Optional) POSIX timestamp to start the downtime.
    35  * `end` - (Optional) POSIX timestamp to end the downtime.
    36  * `recurrence` - (Optional) A dictionary to configure the downtime to be recurring.
    37      * `type` - days, weeks, months, or years
    38      * `period` - How often to repeat as an integer. For example to repeat every 3 days, select a type of days and a period of 3.
    39      * `week_days` - (Optional) A list of week days to repeat on. Choose from: Mon, Tue, Wed, Thu, Fri, Sat or Sun. Only applicable when type is weeks. First letter must be capitalized.
    40      * `until_occurrences` - (Optional) How many times the downtime will be rescheduled. `until_occurrences` and `until_date` are mutually exclusive.
    41      * `until_date` - (Optional) The date at which the recurrence should end as a POSIX timestamp. `until_occurrences` and `until_date` are mutually exclusive.
    42  * `message` - (Optional) A message to include with notifications for this downtime.
    43  
    44  ## Attributes Reference
    45  
    46  The following attributes are exported:
    47  
    48  * `id` - ID of the Datadog downtime
    49  
    50  ## Import
    51  
    52  Downtimes can be imported using their numeric ID, e.g.
    53  
    54  ```
    55  $ terraform import datadog_downtime.bytes_received_localhost 2081
    56  ```