SH-183 Add example of fetching on-call users' emails

examples/on_call_calendars/README.md

@@ -0,0 +1,17 @@
+This directory contains a sample Terraform configuration for extracting current on-call
+user's email address for your primary on-call calendar, and a secondary one (fetched by name)
+
+## Usage
+
+```shell script
+git clone https://github.com/BetterStackHQ/terraform-provider-better-uptime && \
+  cd terraform-provider-better-uptime/examples/on_call_calendars
+
+echo '# See variables.tf for more.
+betteruptime_api_token               = "XXXXXXXXXXXXXXXXXXXXXXXX"
+betteruptime_secondary_calendar_name = "My secondary calendar"
+' > terraform.tfvars
+
+terraform init
+terraform apply
+```

examples/on_call_calendars/main.tf

@@ -0,0 +1,9 @@
+provider "betteruptime" {
+  api_token = var.betteruptime_api_token
+}
+
+data "betteruptime_on_call_calendar" "primary" {}
+
+data "betteruptime_on_call_calendar" "secondary" {
+  name = var.betteruptime_secondary_calendar_name
+}

examples/on_call_calendars/outputs.tf

@@ -0,0 +1,12 @@
+locals {
+  primary_on_calls   = data.betteruptime_on_call_calendar.primary.on_call_users
+  secondary_on_calls = data.betteruptime_on_call_calendar.secondary.on_call_users
+}
+
+output "on_call_primary" {
+  value = length(local.primary_on_calls) > 0 ? local.primary_on_calls[0].email : "Nobody on call!"
+}
+
+output "on_call_secondary" {
+  value = local.secondary_on_calls != null ? (length(local.secondary_on_calls) > 0 ? local.secondary_on_calls[0].email : "Nobody on call!") : "Secondary calendar not found!"
+}

examples/on_call_calendars/variables.tf

@@ -0,0 +1,17 @@
+variable "betteruptime_api_token" {
+  type        = string
+  description = <<EOF
+Better Stack Uptime API Token
+(https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/#obtaining-an-uptime-api-token)
+EOF
+  # The value can be omitted if BETTERUPTIME_API_TOKEN env var is set.
+  default = null
+}
+
+variable "betteruptime_secondary_calendar_name" {
+  type        = string
+  description = <<EOF
+The name of your secondary on-call calendar.
+EOF
+  default     = "Secondary calendar"
+}

examples/on_call_calendars/versions.tf

@@ -0,0 +1,10 @@
+terraform {
+  required_version = ">= 0.13"
+  required_providers {
+    betteruptime = {
+      source = "BetterStackHQ/better-uptime"
+      # https://github.com/BetterStackHQ/terraform-provider-better-uptime/blob/master/CHANGELOG.md
+      version = ">= 0.9.0"
+    }
+  }
+}