[minor_change] Migration of tenant into plugin framework

Author: akinross

aci/provider.go

@@ -77,8 +77,6 @@ func Provider() *schema.Provider {
 		},
 
 		ResourcesMap: map[string]*schema.Resource{
-			"aci_tenant":                                   resourceAciTenant(),
-			"aci_application_profile":                      resourceAciApplicationProfile(),
 			"aci_contract":                                 resourceAciContract(),
 			"aci_contract_subject":                         resourceAciContractSubject(),
 			"aci_contract_subject_filter":                  resourceAciSubjectFilter(),
@@ -320,8 +318,6 @@ func Provider() *schema.Provider {
 		},
 
 		DataSourcesMap: map[string]*schema.Resource{
-			"aci_tenant":                                   dataSourceAciTenant(),
-			"aci_application_profile":                      dataSourceAciApplicationProfile(),
 			"aci_contract":                                 dataSourceAciContract(),
 			"aci_contract_subject":                         dataSourceAciContractSubject(),
 			"aci_contract_subject_filter":                  dataSourceAciSubjectFilter(),

docs/data-sources/tenant.md

@@ -0,0 +1,67 @@
+---
+# Documentation generated by "gen/generator.go"; DO NOT EDIT.
+# In order to regenerate this file execute `go generate` from the repository root.
+# More details can be found in the [README](https://github.com/CiscoDevNet/terraform-provider-aci/blob/master/README.md).
+subcategory: "Application Management"
+layout: "aci"
+page_title: "ACI: aci_tenant"
+sidebar_current: "docs-aci-data-source-aci_tenant"
+description: |-
+  Data source for ACI Tenant
+---
+
+# aci_tenant #
+
+Data source for ACI Tenant
+
+## API Information ##
+
+* Class: [fvTenant](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/fvTenant/overview)
+
+* Supported in ACI versions: 1.0(1e) and later.
+
+* Distinguished Name Format: `uni/tn-{name}`
+
+## GUI Information ##
+
+* Location: `Tenants`
+
+## Example Usage ##
+
+```hcl
+
+data "aci_tenant" "example" {
+  name = "test_name"
+}
+
+```
+
+## Schema ##
+
+### Required ###
+
+* `name` (name) - (string) The name of the Tenant object.
+
+### Read-Only ###
+
+* `id` - (string) The distinguished name (DN) of the Tenant object.
+* `annotation` (annotation) - (string) The annotation of the Tenant object.
+* `description` (descr) - (string) The description of the Tenant object.
+* `name_alias` (nameAlias) - (string) The name alias of the Tenant object.
+* `owner_key` (ownerKey) - (string) The key for enabling clients to own their data for entity correlation.
+* `owner_tag` (ownerTag) - (string) A tag for enabling clients to add their own data. For example, to indicate who created this object.
+* `relation_to_tenant_monitoring_policy` - (map) A map of Relation To Tenant Monitoring Policy (ACI object [fvRsTenantMonPol](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/fvRsTenantMonPol/overview)) pointing to Monitoring Policy (ACI Object [monEPGPol](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/monEPGPol/overview)).
+    * `annotation` (annotation) - (string) The annotation of the Relation To Tenant Monitoring Policy object.
+    * `monitoring_policy_name` (tnMonEPGPolName) - (string) The name of the monitoring policy.
+    * `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.
+    * `tags` - (list) A list of Tags (ACI object [tagTag](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagTag/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.
+* `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.
+* `tags` - (list) A list of Tags (ACI object [tagTag](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagTag/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/tenant.md

@@ -0,0 +1,174 @@
+---
+# Documentation generated by "gen/generator.go"; DO NOT EDIT.
+# In order to regenerate this file execute `go generate` from the repository root.
+# More details can be found in the [README](https://github.com/CiscoDevNet/terraform-provider-aci/blob/master/README.md).
+subcategory: "Application Management"
+layout: "aci"
+page_title: "ACI: aci_tenant"
+sidebar_current: "docs-aci-resource-aci_tenant"
+description: |-
+  Manages ACI Tenant
+---
+
+# aci_tenant #
+
+Manages ACI Tenant
+
+
+
+## API Information ##
+
+* Class: [fvTenant](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/fvTenant/overview)
+
+* Supported in ACI versions: 1.0(1e) and later.
+
+* Distinguished Name Format: `uni/tn-{name}`
+
+## GUI Information ##
+
+* Location: `Tenants`
+
+## Example Usage ##
+
+The configuration snippet below creates a Tenant with only required attributes.
+
+```hcl
+
+resource "aci_tenant" "example" {
+  name = "test_name"
+}
+
+```
+The configuration snippet below shows all possible attributes of the Tenant.
+
+!> This example might not be valid configuration and is only used to show all possible attributes.
+
+```hcl
+
+resource "aci_tenant" "full_example" {
+  annotation  = "annotation"
+  description = "description_1"
+  name        = "test_name"
+  name_alias  = "name_alias_1"
+  owner_key   = "owner_key_1"
+  owner_tag   = "owner_tag_1"
+  relation_to_tenant_monitoring_policy = {
+    annotation             = "annotation_1"
+    monitoring_policy_name = aci_monitoring_policy.example.name
+    annotations = [
+      {
+        key   = "key_0"
+        value = "value_1"
+      }
+    ]
+    tags = [
+      {
+        key   = "key_0"
+        value = "value_1"
+      }
+    ]
+  }
+  annotations = [
+    {
+      key   = "key_0"
+      value = "value_1"
+    }
+  ]
+  tags = [
+    {
+      key   = "key_0"
+      value = "value_1"
+    }
+  ]
+}
+
+```
+
+All examples for the Tenant resource can be found in the [examples](https://github.com/CiscoDevNet/terraform-provider-aci/tree/master/examples/resources/aci_tenant) folder.
+
+## Schema ##
+
+### Required ###
+
+* `name` (name) - (string) The name of the Tenant object.
+
+### Read-Only ###
+
+* `id` - (string) The distinguished name (DN) of the Tenant object.
+
+### Optional ###
+
+* `annotation` (annotation) - (string) The annotation of the Tenant object.
+  - Default: `orchestrator:terraform`
+* `description` (descr) - (string) The description of the Tenant object.
+* `name_alias` (nameAlias) - (string) The name alias of the Tenant object.
+* `owner_key` (ownerKey) - (string) The key for enabling clients to own their data for entity correlation.
+* `owner_tag` (ownerTag) - (string) A tag for enabling clients to add their own data. For example, to indicate who created this object.
+* `relation_to_tenant_monitoring_policy` - (map) A map of Relation To Tenant Monitoring Policy (ACI object [fvRsTenantMonPol](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/fvRsTenantMonPol/overview)) pointing to Monitoring Policy (ACI Object [monEPGPol](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/monEPGPol/overview)) which can be configured using the [aci_monitoring_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/monitoring_policy) resource.
+  #### Optional ####
+    
+    * `annotation` (annotation) - (string) The annotation of the Relation To Tenant Monitoring Policy object.
+      - Default: `orchestrator:terraform`
+    * `monitoring_policy_name` (tnMonEPGPolName) - (string) The name of the monitoring policy.
+    * `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 ####
+  
+        * `key` (key) - (string) The key used to uniquely identify this configuration object.
+        * `value` (value) - (string) The value of the property.
+    * `tags` - (list) A list of Tags (ACI object [tagTag](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagTag/overview)). Tags can also be configured using a separate [aci_tag](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/tag) resource. This attribute is supported in ACI versions: 3.2(1l) and later.
+      #### Required ####
+  
+        * `key` (key) - (string) The key used to uniquely identify this configuration object.
+        * `value` (value) - (string) The value of the property.
+* `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 ####
+  
+    * `key` (key) - (string) The key used to uniquely identify this configuration object.
+    * `value` (value) - (string) The value of the property.
+* `tags` - (list) A list of Tags (ACI object [tagTag](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagTag/overview)). Tags can also be configured using a separate [aci_tag](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/tag) resource. This attribute is supported in ACI versions: 3.2(1l) and later.
+  #### Required ####
+  
+    * `key` (key) - (string) The key used to uniquely identify this configuration object.
+    * `value` (value) - (string) The value of the property.
+
+## Importing
+
+An existing Tenant can be [imported](https://www.terraform.io/docs/import/index.html) into this resource with its distinguished name (DN), via the following command:
+
+```
+terraform import aci_tenant.example uni/tn-{name}
+```
+
+Starting in Terraform version 1.5, an existing Tenant can be imported
+using [import blocks](https://developer.hashicorp.com/terraform/language/import) via the following configuration:
+
+```
+import {
+  id = "uni/tn-{name}"
+  to = aci_tenant.example
+}
+```
+
+## Child Resources
+  
+  - [aci_application_profile](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/application_profile)
+  - [aci_bridge_domain](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/bridge_domain)
+  - [aci_certificate_store](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/certificate_store)
+  - [aci_contract](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/contract)
+  - [aci_dhcp_relay_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/dhcp_relay_policy)
+  - [aci_end_point_retention_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/end_point_retention_policy)
+  - [aci_filter](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/filter)
+  - [aci_igmp_snooping_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/igmp_snooping_policy)
+  - [aci_imported_contract](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/imported_contract)
+  - [aci_l3_outside](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/l3_outside)
+  - [aci_mld_snooping_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/mld_snooping_policy)
+  - [aci_monitoring_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/monitoring_policy)
+  - [aci_neighbor_discovery_interface_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/neighbor_discovery_interface_policy)
+  - [aci_netflow_exporter_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/netflow_exporter_policy)
+  - [aci_netflow_monitor_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/netflow_monitor_policy)
+  - [aci_netflow_record_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/netflow_record_policy)
+  - [aci_out_of_band_contract](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/out_of_band_contract)
+  - [aci_pim_route_map_policy](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/pim_route_map_policy)
+  - [aci_route_control_profile](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/route_control_profile)
+  - [aci_taboo_contract](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/taboo_contract)
+  - [aci_vrf](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/vrf)

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

@@ -0,0 +1,4 @@
+
+data "aci_tenant" "example" {
+  name = "test_name"
+}

examples/data-sources/aci_tenant/provider.tf

@@ -0,0 +1,14 @@
+terraform {
+  required_providers {
+    aci = {
+      source = "ciscodevnet/aci"
+    }
+  }
+}
+
+provider "aci" {
+  username = ""
+  password = ""
+  url      = ""
+  insecure = true
+}

examples/resources/aci_tenant/provider.tf

@@ -0,0 +1,14 @@
+terraform {
+  required_providers {
+    aci = {
+      source = "ciscodevnet/aci"
+    }
+  }
+}
+
+provider "aci" {
+  username = ""
+  password = ""
+  url      = ""
+  insecure = true
+}

examples/resources/aci_tenant/resource-all-attributes.tf

@@ -0,0 +1,37 @@
+
+resource "aci_tenant" "full_example" {
+  annotation  = "annotation"
+  description = "description_1"
+  name        = "test_name"
+  name_alias  = "name_alias_1"
+  owner_key   = "owner_key_1"
+  owner_tag   = "owner_tag_1"
+  relation_to_tenant_monitoring_policy = {
+    annotation             = "annotation_1"
+    monitoring_policy_name = aci_monitoring_policy.example.name
+    annotations = [
+      {
+        key   = "key_0"
+        value = "value_1"
+      }
+    ]
+    tags = [
+      {
+        key   = "key_0"
+        value = "value_1"
+      }
+    ]
+  }
+  annotations = [
+    {
+      key   = "key_0"
+      value = "value_1"
+    }
+  ]
+  tags = [
+    {
+      key   = "key_0"
+      value = "value_1"
+    }
+  ]
+}

examples/resources/aci_tenant/resource.tf

@@ -0,0 +1,4 @@
+
+resource "aci_tenant" "example" {
+  name = "test_name"
+}

gen/definitions/classes.yaml

@@ -8,6 +8,18 @@ global:
 fvTenant:
   resource_name: "tenant"
   resource_identifier: "tn"
+  exclude_children:
+    - "cloudCertStore"
+  ui_locations:
+    - "Tenants"
+  sub_category: "Application Management"
+  migration_version: 1
+  migration_blocks:
+    fvRsTenantMonPol:
+      relation_fv_rs_tenant_mon_pol: relation_to_tenant_monitoring_policy.monitoring_policy_name
+
+fvRsTenantMonPol:
+  resource_name: "relation_to_tenant_monitoring_policy"
 
 fvAEPg:
   resource_name: "application_epg"