Add availability zone info module (#85)

Author: gtema

meta/runtime.yml

@@ -6,6 +6,7 @@ action_groups:
     - as_config_info
     - as_group
     - as_policy_info
+    - availability_zone_info
     - cce_cluster
     - cce_cluster_cert_info
     - cce_cluster_info

plugins/modules/availability_zone_info.py

@@ -0,0 +1,90 @@
+#!/usr/bin/python
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+DOCUMENTATION = '''
+---
+module: availability_zone_info
+short_description: Get AZ info
+extends_documentation_fragment: opentelekomcloud.cloud.otc
+version_added: "0.7.0"
+author: "Artem Goncharov (@gtema)"
+description:
+  - Get AZ info.
+options:
+  name:
+    description: The name or ID of a AZ.
+    type: str
+  service:
+    description:
+      - Service name to list supported avaiability zones for.
+      - Currently only compute is supported
+    type: str
+    default: compute
+requirements: ["openstacksdk"]
+'''
+
+RETURN = '''
+availability_zone_info:
+  description: List of Availability zones.
+  type: complex
+  returned: On Success.
+  contains:
+    name:
+      description: Specifies the AZ name.
+      type: str
+'''
+
+EXAMPLES = '''
+# Get AZ.
+- opentelekomcloud.cloud.availability_zone_info:
+  register: az
+'''
+
+from ansible_collections.opentelekomcloud.cloud.plugins.module_utils.otc import OTCModule
+
+
+class AvailabilityZoneInfoModule(OTCModule):
+    argument_spec = dict(
+        name=dict(type='str', required=False),
+        service=dict(type='str', default='compute')
+    )
+
+    module_kwargs = dict(
+        supports_check_mode=True
+    )
+
+    def run(self):
+        data = []
+
+        raw_data = []
+        if self.params['service'] == 'compute':
+            raw_data = self.conn.compute.availability_zones()
+        if raw_data:
+            for raw in raw_data:
+                dt = raw.to_dict()
+                dt.pop('location')
+                data.append(dt)
+
+        self.exit(
+            changed=False,
+            availability_zones=data
+        )
+
+
+def main():
+    module = AvailabilityZoneInfoModule()
+    module()
+
+
+if __name__ == '__main__':
+    main()

tests/integration/targets/availability_zone_info/tasks/main.yaml

@@ -0,0 +1,20 @@
+---
+- module_defaults:
+    opentelekomcloud.cloud.availability_zone_info:
+      cloud: "{{ test_cloud }}"
+  block:
+    - name: Get AZ info (check mode)
+      opentelekomcloud.cloud.availability_zone_info:
+      check_mode: yes
+      register: az
+
+    - name: Get AZ info
+      opentelekomcloud.cloud.availability_zone_info:
+      register: az
+
+    - name: assert result
+      assert:
+        that:
+          - az is success
+          - az is not changed
+          - az.availability_zones is defined

tests/sanity/ignore-2.10.txt

@@ -3,6 +3,7 @@ plugins/modules/as_config_info.py validate-modules:missing-gplv3-license
 plugins/modules/as_group.py validate-modules:missing-gplv3-license
 plugins/modules/as_group_info.py validate-modules:missing-gplv3-license
 plugins/modules/as_policy_info.py validate-modules:missing-gplv3-license
+plugins/modules/availability_zone_info.py validate-modules:missing-gplv3-license
 plugins/modules/cce_cluster.py validate-modules:missing-gplv3-license
 plugins/modules/cce_cluster_cert_info.py validate-modules:missing-gplv3-license
 plugins/modules/cce_cluster_info.py validate-modules:missing-gplv3-license

tests/sanity/ignore-2.9.txt

@@ -3,6 +3,7 @@ plugins/modules/as_config_info.py validate-modules:missing-gplv3-license
 plugins/modules/as_group.py validate-modules:missing-gplv3-license
 plugins/modules/as_group_info.py validate-modules:missing-gplv3-license
 plugins/modules/as_policy_info.py validate-modules:missing-gplv3-license
+plugins/modules/availability_zone_info.py validate-modules:missing-gplv3-license
 plugins/modules/cce_cluster.py validate-modules:missing-gplv3-license
 plugins/modules/cce_cluster_node.py validate-modules:missing-gplv3-license
 plugins/modules/cce_cluster_cert_info.py validate-modules:missing-gplv3-license