add default team ID/slug in the provider configuration

Author: ramonsnir

docs/data-sources/site.md

@@ -31,7 +31,7 @@ data "netlify_site" "blog" {
 ### Optional
 
 - `name` (String)
-- `team_slug` (String)
+- `team_slug` (String) Required if name is specified and a default team was not configured in the provider configuration.
 
 ### Read-Only
 

docs/data-sources/sites.md

@@ -22,9 +22,9 @@ data "netlify_sites" "team" {
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
-### Required
+### Optional
 
-- `team_slug` (String)
+- `team_slug` (String) Required if a default team was not configured in the provider configuration.
 
 ### Read-Only
 

docs/data-sources/team.md

@@ -29,9 +29,9 @@ data "netlify_team" "team" {
 
 ### Optional
 
-- `slug` (String)
+- `id` (String) ID or slug are required if a default team was not configured in the provider configuration.
+- `slug` (String) ID or slug are required if a default team was not configured in the provider configuration.
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
 - `name` (String)

docs/index.md

@@ -48,19 +48,21 @@ terraform {
 
 provider "netlify" {
   token = var.netlify_api_token
+  # Optionally, set a default team through its ID or its slug to avoid repeating it.
+  default_team_slug = "your-team-slug"
 }
 
 data "netlify_team" "team" {
-  slug = "your-team-slug"
+  # slug coming from the default team
 }
 
 data "netlify_site" "blog" {
-  team_slug = data.netlify_team.team.slug
-  name      = "blog"
+  # team_slug coming from the default team
+  name = "blog"
 }
 
 resource "netlify_environment_variable" "astro_database_file" {
-  team_id = data.netlify_team.team.id
+  # team_id coming from the default team
   site_id = data.netlify_site.blog.id
   key     = "ASTRO_DATABASE_FILE"
   values = [
@@ -77,5 +79,7 @@ resource "netlify_environment_variable" "astro_database_file" {
 
 ### Optional
 
+- `default_team_id` (String) The default team ID to use for resources that require a team ID or a team slug. Warning: Changing this value may not trigger recreation of resources.
+- `default_team_slug` (String) The default team slug to use for resources that require a team ID or a team slug. Warning: Changing this value may not trigger recreation of resources.
 - `endpoint` (String) Defaults to: https://api.netlify.com
 - `token` (String, Sensitive) Read: https://docs.netlify.com/api/get-started/#authentication , will use the `NETLIFY_API_TOKEN` environment variable if not set.

docs/resources/dns_zone.md

@@ -28,7 +28,10 @@ resource "netlify_dns_zone" "example" {
 ### Required
 
 - `name` (String)
-- `team_slug` (String)
+
+### Optional
+
+- `team_slug` (String) Required if a default team was not configured in the provider configuration.
 
 ### Read-Only
 

docs/resources/environment_variable.md

@@ -91,13 +91,13 @@ resource "netlify_environment_variable" "astro_database_file" {
 ### Required
 
 - `key` (String)
-- `team_id` (String)
 
 ### Optional
 
 - `scopes` (Set of String) One or more of builds, functions, runtime, and post-processing
 - `secret_values` (Attributes Set) (see [below for nested schema](#nestedatt--secret_values))
 - `site_id` (String)
+- `team_id` (String) Required if a default team was not configured in the provider configuration.
 - `values` (Attributes Set) (see [below for nested schema](#nestedatt--values))
 
 ### Read-Only

docs/resources/team_firewall_traffic_rules.md

@@ -51,9 +51,12 @@ resource "netlify_team_firewall_traffic_rules" "team" {
 ### Required
 
 - `published` (Attributes) (see [below for nested schema](#nestedatt--published))
-- `team_id` (String)
 - `unpublished` (Attributes) (see [below for nested schema](#nestedatt--unpublished))
 
+### Optional
+
+- `team_id` (String) Required if a default team was not configured in the provider configuration.
+
 ### Read-Only
 
 - `last_updated` (String)

examples/misc/dns/main.tf

@@ -8,15 +8,12 @@ terraform {
 }
 
 # `token` comes from NETLIFY_API_TOKEN, but can be specified with a Terraform variable
-provider "netlify" {}
-
-# data "netlify_team" "current" {
-#   slug = "ramon-test-1"
-# }
+provider "netlify" {
+  default_team_slug = "ramon-test-1"
+}
 
 resource "netlify_dns_zone" "example" {
-  team_slug = "ramon-test-1" // data.netlify_team.current.slug
-  name      = "example-tf-test-test.com"
+  name = "example-tf-test-test.com"
   lifecycle {
     prevent_destroy = true
   }

examples/misc/env_vars/main.tf

@@ -8,7 +8,9 @@ terraform {
 }
 
 # `token` comes from NETLIFY_API_TOKEN, but can be specified with a Terraform variable
-provider "netlify" {}
+provider "netlify" {
+  default_team_slug = "ramon-test-1"
+}
 
 data "netlify_team" "current" {
   slug = "ramon-test-1"
@@ -31,6 +33,17 @@ resource "netlify_environment_variable" "woof" {
   ]
 }
 
+resource "netlify_environment_variable" "woof2" {
+  site_id = data.netlify_site.platform_test.id
+  key     = "WOOF2"
+  values = [
+    {
+      value   = "dogs are here",
+      context = "all",
+    }
+  ]
+}
+
 resource "netlify_environment_variable" "meow" {
   team_id = data.netlify_team.current.id
   site_id = data.netlify_site.platform_test.id

examples/misc/site_data_sources/main.tf

@@ -8,24 +8,25 @@ terraform {
 }
 
 # `token` comes from NETLIFY_API_TOKEN, but can be specified with a Terraform variable
-provider "netlify" {}
-
-data "netlify_team" "current" {
-  slug = "ramon-test-1"
+provider "netlify" {
+  default_team_slug = "ramon-test-1"
 }
 
+data "netlify_team" "current" {}
+
 data "netlify_site" "platform_test" {
-  team_slug = data.netlify_team.current.slug
-  name      = "platform-test-1"
+  name = "platform-test-1"
 }
 
-data "netlify_sites" "all" {
+data "netlify_sites" "mine" {}
+
+data "netlify_sites" "testing" {
   team_slug = "netlify-testing"
 }
 
 output "sites" {
   value = [
-    for site in data.netlify_sites.all.sites : site
+    for site in data.netlify_sites.testing.sites : site
     if site.custom_domain != ""
   ]
 }