add environment option in DE_info module

Signed-off-by: curtis <curtis@cloudera.com>

Author: curtishoward

plugins/modules/de_info.py

@@ -29,24 +29,22 @@
 description:
     - Gather information about CDP DE Workspaces
 author:
-  - "Webster Mudge (@wmudge)"
-  - "Dan Chaffelson (@chaffelson)"
+  - "Curtis Howard (@curtishoward)"
   - "Alan Silva (@acsjumpi)"
 requirements:
   - cdpy
 options:
-  id:
+  name:
     description:
-      - If a name is provided, that Data Warehouse Cluster will be described.
-      - environment must be provided if using name to retrieve a Cluster
+      - If a name is provided, that DE service will be described (if it exists)
+      - Note that there should be only 1 or 0 (non-deleted) services with a given name
     type: str
     required: False
     aliases:
       - name
   environment:
     description:
-      - The name of the Environment in which to find and describe the Data Warehouse Clusters.
-      - Required with name to retrieve a Cluster
+      - The name of the Environment in which to find and describe the DE service(s).
     type: str
     required: False
     aliases:
@@ -62,13 +60,143 @@
 # List basic information about all DE Services
 - cloudera.cloud.de_info:
 
+# List basic information about all DE Services within a given environment
+- cloudera.cloud.de_info:
+    environment: example-environment
+
 # Gather detailed information about a named DE Service
 - cloudera.cloud.de_info:
     name: example-service
+
+# Gather detailed information about a named DE Service within a particular environment
+- cloudera.cloud.de_info:
+    name: example-service
+    environment: example-environment
 '''
 
 RETURN = r'''
-TODO..
+services:
+  description: List of DE service descriptions
+  type: list
+  returned: always
+  elements: complex
+  contains:
+    clusterId:
+      description: Cluster Id of the CDE Service.
+      returned: always
+      type: str
+    creatorEmail:
+      description: Email Address of the CDE creator.
+      returned: always
+      type: str
+    enablingTime:
+      description: Timestamp of service enabling.
+      returned: always 
+      type: str
+    environmentName:
+      description: CDP Environment Name.
+      returned: always
+      type: str
+    name:
+      description: Name of the CDE Service.
+      returned: always
+      type: str
+    status:
+      description: Status of the CDE Service.
+      returned: always
+      type: str
+    chartValueOverrides:
+      description: Status of the CDE Service.
+      returned: if full service description 
+      type: array
+      elements: complex
+      contains:
+        ChartValueOverridesResponse:
+          type: list
+          returned: always
+          contains:
+            chartName:
+              description: Name of the chart that has to be overridden.
+              returned: always
+              type: str
+            overrides:
+              description: Space separated key value-pairs for overriding chart values (colon separated)
+              returned: always
+              type: str
+    cloudPlatform:
+      description: The cloud platform where the CDE service is enabled.
+      returned: if full service description 
+      type: str
+    clusterFqdn:
+      description: FQDN of the CDE service.
+      returned: if full service description
+      type: str
+    creatorCrn:
+      description: CRN of the creator. 
+      returned: if full service description
+      type: str
+    dataLakeAtlasUIEndpoint:
+      description: Endpoint of Data Lake Atlas.E
+      returned: if full service description
+      type: str
+    dataLakeFileSystems:
+      description: The Data lake file system. 
+      returned: if full service description
+      type: str
+    environmentCrn:
+      description: CRN of the environment.
+      returned: if full service description
+      type: str
+    logLocation:
+      description: Location for the log files of jobs.
+      returned: if full service description
+      type: str
+    resources:
+      description: Resources details of CDE Service.
+      returned: if full service description
+      type: complex
+      contains:
+        ServiceResources:
+          description: Object to store resources for a CDE service.
+          returned: always
+          type: complex
+          contains:
+            initial_instances:
+              description: Initial instances for the CDE service.
+              returned: always
+              type: str
+            initial_spot_instances:
+              description: Initial Spot Instances for the CDE Service.
+              returned: always
+              type: str
+            instance_type:
+              description: Instance type of the CDE service.
+              returned: always
+              type: str
+            max_instances:
+              description: Maximum instances for the CDE service.
+              returned: always
+              type: str
+            max_spot_instances:
+              description: Maximum Number of Spot instances.
+              returned: always
+              type: str
+            min_instances:
+              description: Minimum Instances for the CDE service.
+              returned: always
+              type: str
+            min_spot_instances:
+              description: Minimum number of spot instances for the CDE service.
+              returned: always
+              type: str
+            root_vol_size:
+              description: Root Volume Size.
+              returned: always
+              type: str
+    tenantId:
+      description: CDP tenant ID. 
+      returned: if full service description
+      type: str
 '''
 
 
@@ -78,6 +206,7 @@ def __init__(self, module):
 
         # Set variables
         self.name = self._get_param('name')
+        self.env = self._get_param('environment')
 
         # Initialize return values
         self.services = []
@@ -87,18 +216,26 @@ def __init__(self, module):
 
     @CdpModule._Decorators.process_debug
     def process(self):
+        service_list = self.cdpy.de.list_services(remove_deleted=True)
         if self.name:
-            for service in self.cdpy.de.list_services(remove_deleted=True):
-                if service['name'] == self.name:
-                    self.services.append(self.cdpy.de.describe_service(service['clusterId']))
+            name_match = list(filter(lambda s: s['name'] == self.name, service_list))
+            if self.env:
+                env_match = list(filter(lambda s: s['environmentName'] == self.env, name_match))
+                if env_match:
+                    self.services.append(self.cdpy.de.describe_service(env_match[0]['clusterId']))
+            elif name_match:
+                self.services.append(self.cdpy.de.describe_service(name_match[0]['clusterId']))
+        elif self.env:
+            env_match = list(filter(lambda s: s['environmentName'] == self.env, service_list))
+            self.services.extend(env_match)
         else:
-            self.services = self.cdpy.de.list_services(remove_deleted=True)
-
+            self.services.extend(service_list)
 
 def main():
     module = AnsibleModule(
         argument_spec=CdpModule.argument_spec(
-            name=dict(required=False, type='str', aliases=['workspace'])
+            name=dict(required=False, type='str', aliases=['workspace']),
+            environment=dict(required=False, type='str', aliases=['env'])
         ),
         supports_check_mode=True
     )