Merge branch 'master' into dependabot/go_modules/github.com/hashicorp/terraform-plugin-framework-1.15.0

Author: unasra

docs/data-sources/ipam_next_available_ips.md

@@ -51,19 +51,41 @@ data "bloxone_ipam_next_available_ips" "example_next_ip_range" {
   id       = data.bloxone_ipam_ranges.example_by_attribute.results.0.id
   ip_count = 5
 }
+
+// next_available_ips by tag
+data "bloxone_ipam_next_available_ips" "example_next_ip_ab_by_tag" {
+  tags = {
+    name = "example_address_block"
+  }
+  ip_count      = 5
+  resource_type = "address_block"
+}
+data "bloxone_ipam_next_available_ips" "example_next_ip_sub_by_tag" {
+  tags = {
+    name = "example_subnet"
+  }
+  ip_count      = 5
+  resource_type = "subnet"
+}
+data "bloxone_ipam_next_available_ips" "example_next_ip_range_by_tag" {
+  tags = {
+    name = "example_range"
+  }
+  ip_count      = 5
+  resource_type = "range"
+}
 ```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
-### Required
-
-- `id` (String) An application specific resource identity of a resource
-
 ### Optional
 
 - `contiguous` (Boolean) Indicates whether the IP addresses should belong to a contiguous block. Defaults to false.
+- `id` (String) An application specific resource identity of a resource
 - `ip_count` (Number) The number of IP addresses requested. Defaults to 1.
+- `resource_type` (String) Resource type to search when using tag filters (address_block, subnet, or range)
+- `tag_filters` (Map of String) Map of tag key/value pairs to filter resources
 
 ### Read-Only
 

docs/data-sources/ipam_next_available_subnets.md

@@ -27,6 +27,14 @@ data "bloxone_ipam_next_available_subnets" "example_tf_subs" {
   cidr         = 29
   subnet_count = 5
 }
+
+data "bloxone_ipam_next_available_subnets" "example_next_available_subnet_by_tag" {
+  cidr         = 30
+  subnet_count = 15
+  tag_filters = {
+    environment = "prd"
+  }
+}
 ```
 
 <!-- schema generated by tfplugindocs -->
@@ -35,12 +43,13 @@ data "bloxone_ipam_next_available_subnets" "example_tf_subs" {
 ### Required
 
 - `cidr` (Number) The cidr value of subnets to be created.
-- `id` (String) An application specific resource identity of a resource.
 
 ### Optional
 
+- `id` (String) An application specific resource identity of a resource.
 - `subnet_count` (Number) Number of subnets to generate. Default 1 if not set.
+- `tag_filters` (Map of String) Key-value pairs to filter subnets by tags.
 
 ### Read-Only
 
-- `results` (List of String) List of Next available Subnet address in the specified resource
+- `results` (List of String) List of next available subnet addresses in the specified resource.

examples/data-sources/bloxone_ipam_next_available_ips/data-source.tf

@@ -36,3 +36,27 @@ data "bloxone_ipam_next_available_ips" "example_next_ip_range" {
   id       = data.bloxone_ipam_ranges.example_by_attribute.results.0.id
   ip_count = 5
 }
+
+// next_available_ips by tag
+data "bloxone_ipam_next_available_ips" "example_next_ip_ab_by_tag" {
+  tags = {
+    name = "example_address_block"
+  }
+  ip_count      = 5
+  resource_type = "address_block"
+}
+data "bloxone_ipam_next_available_ips" "example_next_ip_sub_by_tag" {
+  tags = {
+    name = "example_subnet"
+  }
+  ip_count      = 5
+  resource_type = "subnet"
+}
+data "bloxone_ipam_next_available_ips" "example_next_ip_range_by_tag" {
+  tags = {
+    name = "example_range"
+  }
+  ip_count      = 5
+  resource_type = "range"
+}
+

examples/data-sources/bloxone_ipam_next_available_subnets/data-source.tf

@@ -12,3 +12,11 @@ data "bloxone_ipam_next_available_subnets" "example_tf_subs" {
   cidr         = 29
   subnet_count = 5
 }
+
+data "bloxone_ipam_next_available_subnets" "example_next_available_subnet_by_tag" {
+  cidr         = 30
+  subnet_count = 15
+  tag_filters = {
+    environment = "prd"
+  }
+}