[ignore] make encapsulation a required attribute for aci_relation_from_application_epg_to_attachable_access_entity_profile

Author: akinross

docs/data-sources/application_epg.md

@@ -89,10 +89,10 @@ data "aci_application_epg" "example_application_profile" {
         * `key` (key) - (string) The key used to uniquely identify this configuration object.
         * `value` (value) - (string) The value of the property.
 * `relation_to_attachable_access_entity_profiles` - (list) A list of Relation From Application EPG To Attachable Access Entity Profiles (ACI object [fvRsAepAtt](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/fvRsAepAtt/overview)) pointing to Attachable Access Entity Profile (ACI Object [infraAttEntityP](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/infraAttEntityP/overview)). This attribute is supported in ACI versions: 6.1(3f) and later.
-    * `encapsulation` (encap) - (string) The encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object. The encapsulation refers to the EPG VLAN when class preference is set to 'encap', or to the Secondary VLAN when class preference is set to 'useg'.
+    * `encapsulation` (encap) - (string) The encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object.
     * `deployment_immediacy` (instrImedcy) - (string) The deployment immediacy of the Relation From Application EPG To Attachable Access Entity Profile object. Specifies when the policy is pushed into the hardware policy content-addressable memory (CAM).
     * `mode` (mode) - (string) The mode of the Relation From Application EPG To Attachable Access Entity Profile object.
-    * `primary_encapsulation` (primaryEncap) - (string) The primary encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object. This is used when the class preference is set to 'useg'.
+    * `primary_encapsulation` (primaryEncap) - (string) The primary encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object.
     * `attachable_access_entity_profile_name` (tnInfraAttEntityPName) - (string) The name of the Attachable Access Entity Profile object.
     * `annotations` - (list) A list of Annotations (ACI object [tagAnnotation](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagAnnotation/overview)). This attribute is supported in ACI versions: 3.2(1l) and later.
         * `key` (key) - (string) The key used to uniquely identify this configuration object.

docs/data-sources/relation_from_application_epg_to_attachable_access_entity_profile.md

@@ -48,10 +48,10 @@ data "aci_relation_from_application_epg_to_attachable_access_entity_profile" "ex
 ### Read-Only ###
 
 * `id` - (string) The distinguished name (DN) of the Relation From Application EPG To Attachable Access Entity Profile object.
-* `encapsulation` (encap) - (string) The encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object. The encapsulation refers to the EPG VLAN when class preference is set to 'encap', or to the Secondary VLAN when class preference is set to 'useg'.
+* `encapsulation` (encap) - (string) The encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object.
 * `deployment_immediacy` (instrImedcy) - (string) The deployment immediacy of the Relation From Application EPG To Attachable Access Entity Profile object. Specifies when the policy is pushed into the hardware policy content-addressable memory (CAM).
 * `mode` (mode) - (string) The mode of the Relation From Application EPG To Attachable Access Entity Profile object.
-* `primary_encapsulation` (primaryEncap) - (string) The primary encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object. This is used when the class preference is set to 'useg'.
+* `primary_encapsulation` (primaryEncap) - (string) The primary encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object.
 * `annotations` - (list) A list of Annotations (ACI object [tagAnnotation](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagAnnotation/overview)). This attribute is supported in ACI versions: 3.2(1l) and later.
     * `key` (key) - (string) The key used to uniquely identify this configuration object.
     * `value` (value) - (string) The value of the property.

docs/resources/application_epg.md

@@ -541,19 +541,17 @@ All examples for the Application EPG resource can be found in the [examples](htt
 * `relation_to_attachable_access_entity_profiles` - (list) A list of Relation From Application EPG To Attachable Access Entity Profiles (ACI object [fvRsAepAtt](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/fvRsAepAtt/overview)) pointing to Attachable Access Entity Profile (ACI Object [infraAttEntityP](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/infraAttEntityP/overview)) which can be configured using the [aci_attachable_access_entity_profile](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/attachable_access_entity_profile) resource. This attribute is supported in ACI versions: 6.1(3f) and later.
   #### Required ####
 
+    * `encapsulation` (encap) - (string) The encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object.
     * `attachable_access_entity_profile_name` (tnInfraAttEntityPName) - (string) The name of the Attachable Access Entity Profile object. This attribute can be referenced from a [resource](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/attachable_access_entity_profile) with `aci_attachable_access_entity_profile.example.name` or from a [datasource](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/data-sources/attachable_access_entity_profile) with `data.aci_attachable_access_entity_profile.example.name`.
   #### Optional ####
 
-    * `encapsulation` (encap) - (string) The encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object. The encapsulation refers to the EPG VLAN when class preference is set to 'encap', or to the Secondary VLAN when class preference is set to 'useg'.
-      - Default: `"unknown"`
     * `deployment_immediacy` (instrImedcy) - (string) The deployment immediacy of the Relation From Application EPG To Attachable Access Entity Profile object. Specifies when the policy is pushed into the hardware policy content-addressable memory (CAM).
       - Default: `"lazy"`
       - Valid Values: `"immediate"`, `"lazy"`.
     * `mode` (mode) - (string) The mode of the Relation From Application EPG To Attachable Access Entity Profile object.
       - Default: `"regular"`
       - Valid Values: `"native"`, `"regular"`, `"untagged"`.
-    * `primary_encapsulation` (primaryEncap) - (string) The primary encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object. This is used when the class preference is set to 'useg'.
-      - Default: `"unknown"`
+    * `primary_encapsulation` (primaryEncap) - (string) The primary encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object.
     * `annotations` - (list) A list of Annotations (ACI object [tagAnnotation](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagAnnotation/overview)). Annotations can also be configured using a separate [aci_annotation](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/annotation) resource. This attribute is supported in ACI versions: 3.2(1l) and later.
       #### Required ####
 

docs/resources/relation_from_application_epg_to_attachable_access_entity_profile.md

@@ -36,6 +36,7 @@ The configuration snippet below creates a Relation From Application EPG To Attac
 
 resource "aci_relation_from_application_epg_to_attachable_access_entity_profile" "example_application_epg" {
   parent_dn                             = aci_application_epg.example.id
+  encapsulation                         = "vlan-100"
   attachable_access_entity_profile_name = aci_attachable_access_entity_profile.example.name
 }
 
@@ -77,6 +78,7 @@ All examples for the Relation From Application EPG To Attachable Access Entity P
 
 * `parent_dn` - (string) The distinguished name (DN) of the parent object, possible resources:
   - [aci_application_epg](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/application_epg) ([fvAEPg](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/fvAEPg/overview))
+* `encapsulation` (encap) - (string) The encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object.
 * `attachable_access_entity_profile_name` (tnInfraAttEntityPName) - (string) The name of the Attachable Access Entity Profile object. This attribute can be referenced from a [resource](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/attachable_access_entity_profile) with `aci_attachable_access_entity_profile.example.name` or from a [datasource](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/data-sources/attachable_access_entity_profile) with `data.aci_attachable_access_entity_profile.example.name`.
 
 ### Read-Only ###
@@ -85,16 +87,13 @@ All examples for the Relation From Application EPG To Attachable Access Entity P
 
 ### Optional ###
 
-* `encapsulation` (encap) - (string) The encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object. The encapsulation refers to the EPG VLAN when class preference is set to 'encap', or to the Secondary VLAN when class preference is set to 'useg'.
-  - Default: `"unknown"`
 * `deployment_immediacy` (instrImedcy) - (string) The deployment immediacy of the Relation From Application EPG To Attachable Access Entity Profile object. Specifies when the policy is pushed into the hardware policy content-addressable memory (CAM).
   - Default: `"lazy"`
   - Valid Values: `"immediate"`, `"lazy"`.
 * `mode` (mode) - (string) The mode of the Relation From Application EPG To Attachable Access Entity Profile object.
   - Default: `"regular"`
   - Valid Values: `"native"`, `"regular"`, `"untagged"`.
-* `primary_encapsulation` (primaryEncap) - (string) The primary encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object. This is used when the class preference is set to 'useg'.
-  - Default: `"unknown"`
+* `primary_encapsulation` (primaryEncap) - (string) The primary encapsulation of the Relation From Application EPG To Attachable Access Entity Profile object.
 * `annotations` - (list) A list of Annotations (ACI object [tagAnnotation](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagAnnotation/overview)). Annotations can also be configured using a separate [aci_annotation](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/annotation) resource. This attribute is supported in ACI versions: 3.2(1l) and later.
   #### Required ####
 

examples/resources/aci_relation_from_application_epg_to_attachable_access_entity_profile/resource.tf

@@ -1,5 +1,6 @@
 
 resource "aci_relation_from_application_epg_to_attachable_access_entity_profile" "example_application_epg" {
   parent_dn                             = aci_application_epg.example.id
+  encapsulation                         = "vlan-100"
   attachable_access_entity_profile_name = aci_attachable_access_entity_profile.example.name
 }

gen/definitions/properties.yaml

@@ -840,23 +840,24 @@ infraRsDomP:
 fvRsAepAtt:
   overwrites:
     relation_from_application_epg_to_attachable_access_entity_profiles: "relation_to_attachable_access_entity_profiles"
+  resource_required:
+    - "encapsulation"
   ignores:
     - "annotation"
-  default_values:
-    encap: "unknown"
-    primaryEncap: "unknown"
   documentation:
-    encap: "The encapsulation of the %s object. The encapsulation refers to the EPG VLAN when class preference is set to 'encap', or to the Secondary VLAN when class preference is set to 'useg'."
-    primaryEncap: "The primary encapsulation of the %s object. This is used when the class preference is set to 'useg'."
+    encap: "The encapsulation of the %s object."
+    primaryEncap: "The primary encapsulation of the %s object."
     tnInfraAttEntityPName: "The name of the Attachable Access Entity Profile object"
     mode: "The mode of the %s object."
   test_values:
     default:
-      encapsulation: "unknown"
+      encapsulation: "vlan-100"
       primary_encapsulation: "unknown"
     all:
       encapsulation: "vlan-100"
       primary_encapsulation: "vlan-200"
+    resource_required:
+      encapsulation: "vlan-100"
 
 fvAEPg:
   read_only_properties:

gen/testvars/fvAEPg.yaml

@@ -158,7 +158,7 @@ children:
           - key: "key_1"
             value: "test_value"
 
-    - encapsulation: "unknown"
+    - encapsulation: "vlan-100"
       deployment_immediacy: "lazy"
       mode: "regular"
       primary_encapsulation: "unknown"

gen/testvars/fvRsAepAtt.yaml

@@ -4,7 +4,7 @@
 
 
 default:
-  encapsulation: "unknown"
+  encapsulation: "vlan-100"
   deployment_immediacy: "lazy"
   mode: "regular"
   primary_encapsulation: "unknown"
@@ -16,6 +16,7 @@ datasource_required:
   attachable_access_entity_profile_name: "test_tn_infra_att_entity_p_name"
 
 resource_required:
+  encapsulation: "vlan-100"
   attachable_access_entity_profile_name: "test_tn_infra_att_entity_p_name"
 
 all: