#!/usr/bin/python # Copyright (c) 2017-present Alibaba Group Holding Limited. He Guimin # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt) # # This file is part of Ansible # # Ansible is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # Ansible is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Ansible. If not, see http://www.gnu.org/licenses/. ANSIBLE_METADATA = {'metadata_version': '1.1', 'status': ['deprecated'], 'supported_by': 'community'} DOCUMENTATION = """ --- module: alicloud_vswitch version_added: "1.0.9" short_description: Create, Query or Delete Vswitch. description: - Create, Query or Delete vswitch which in the vpc. deprecated: removed_in: "1.5.0" why: Alibaba Cloud module name prefix "ali" will be more concise. alternative: Use M(ali_vswitch) instead. options: state: description: - Whether or not to create, delete or query vswitch. choices: ['present', 'absent', 'list'] default: 'present' alicloud_zone: description: - Aliyun availability zone ID which to launch the vswitch or list vswitches. It is required when creating a vswitch. aliases: [ 'zone_id', 'zone' ] vpc_id: description: - The ID of a VPC to which that Vswitch belongs. It is required when creating a vswitch. cidr_block: description: - The CIDR block representing the Vswitch e.g. 10.0.0.0/8. The value must be sub cidr_block of Vpc. It is required when creating a vswitch. vswitch_name: description: - The name of vswitch, which is a string of 2 to 128 Chinese or English characters. It must begin with an uppercase/lowercase letter or a Chinese character and can contain numerals, "_" or "-". It cannot begin with http:// or https://. aliases: [ 'name', 'subnet_name' ] description: description: - The description of vswitch, which is a string of 2 to 256 characters. It cannot begin with http:// or https://. vswitch_id: description: - VSwitch ID. It is used to manage the existing VSwitch. Such as modifying VSwitch's attribute or deleting VSwitch. aliases: [ 'subnet_id' ] is_default: description: - When retrieving VSwitch, it can mark the VSwitch is created by system. type: bool requirements: - "python >= 2.6" - "footmark >= 1.1.16" extends_documentation_fragment: - alicloud author: - "He Guimin (@xiaozhu36)" """ EXAMPLES = """ # basic provisioning example to create vswitch - name: create vswitch hosts: localhost connection: local vars: alicloud_region: cn-hongkong vpc_id: xxxxxxxxxx alicloud_zone: cn-hongkong-b cidr_block: '172.16.0.0/24' name: 'Demo_VSwitch' description: 'akashhttp://' state: present tasks: - name: create vswitch alicloud_vswitch: alicloud_region: '{{ alicloud_region }}' cidr_block: '{{ cidr_blok }}' name: '{{ name }}' description: '{{ description }}' vpc_id: '{{ vpc_id }}' state: '{{ state }}' register: result - debug: var=result # basic provisioning example to delete vswitch - name: delete vswitch hosts: localhost connection: local vars: alicloud_region: cn-hongkong vpc_id: xxxxxxxxxx vswitch_id: xxxxxxxxxx state: absent tasks: - name: delete vswitch alicloud_vswitch: alicloud_region: '{{ alicloud_region }}' vpc_id: '{{ vpc_id }}' vswitch_id: '{{ vswitch_id }}' state: '{{ state }}' register: result - debug: var=result """ RETURN = ''' vswitch: description: Dictionary of vswitch values returned: always type: complex contains: id: description: alias of vswitch_id returned: always type: string sample: vsw-b883b2c4 cidr_block: description: The IPv4 CIDR of the VSwitch returned: always type: string sample: "10.0.0.0/16" availability_zone: description: Availability zone of the VSwitch returned: always type: string sample: cn-beijing-a state: description: state of the Subnet returned: always type: string sample: available is_default: description: indicates whether this is the default VSwitch returned: always type: bool sample: false tags: description: tags attached to the Subnet, includes name returned: always type: dict sample: {"Name": "My Subnet", "env": "staging"} vpc_id: description: the id of the VPC where this VSwitch exists returned: always type: string sample: vpc-67236184 available_ip_address_count: description: number of available IPv4 addresses returned: always type: string sample: 250 vswitch_id: description: VSwitch resource id returned: always type: string sample: vsw-b883b2c4 subnet_id: description: alias of vswitch_id returned: always type: string sample: vsw-b883b2c4 vswitch_name: description: VSwitch resource name returned: always type: string sample: my-vsw creation_time: description: The time the VSwitch was created. returned: always type: string sample: 2018-06-24T15:14:45Z ''' import time, inspect from ansible.module_utils.basic import AnsibleModule from ansible.module_utils.alicloud_ecs import ecs_argument_spec, vpc_connect HAS_FOOTMARK = False try: from footmark.exception import VPCResponseError HAS_FOOTMARK = True except ImportError: HAS_FOOTMARK = False def uniquely_find_vswitch(connection, module): vswitch_id = module.params["vswitch_id"] cidr_block = module.params['cidr_block'] vpc_id = module.params['vpc_id'] try: if not vswitch_id and not cidr_block and not vpc_id: return None vsws = connection.get_all_vswitches(module.params) for v in vsws: if vswitch_id and v.vswitch_id == vswitch_id: return v if cidr_block == v.cidr_block: return v return None except Exception as e: module.fail_json(msg=e.message) def main(): argument_spec = ecs_argument_spec() argument_spec.update(dict( state=dict(type='str', default='present', choices=['present', 'absent']), cidr_block=dict(type='str'), description=dict(type='str'), availability_zone=dict(aliases=['alicloud_zone']), vpc_id=dict(type='str'), vswitch_name=dict(aliases=['name', 'subnet_name']), vswitch_id=dict(type='str', aliases=['subnet_id', 'id']), )) module = AnsibleModule(argument_spec=argument_spec, required_if=([ ('state', 'absent', ['vswitch_id']) ]) ) if HAS_FOOTMARK is False: module.fail_json(msg='footmark required for the module ali_vswitch.') vpc = vpc_connect(module) # Get values of variable state = module.params['state'] vswitch_name = module.params['vswitch_name'] description = module.params['description'] changed = False vswitch = uniquely_find_vswitch(vpc, module) if state == 'absent': if not vswitch: module.exit_json(changed=changed, vswitch={}) try: changed = vswitch.delete() module.exit_json(changed=changed, vswitch={}) except VPCResponseError as ex: module.fail_json(msg='Unable to delete vswitch: {0}, error: {1}'.format(vswitch.id, ex)) if str(description).startswith('http://') or str(description).startswith('https://'): module.fail_json(msg='description can not start with http:// or https://') if str(vswitch_name).startswith('http://') or str(vswitch_name).startswith('https://'): module.fail_json(msg='vswitch_name can not start with http:// or https://') if not vswitch: try: params = module.params params['client_token'] = "Ansible-Alicloud-{0}-{1}".format(hash(str(module.params)), str(time.time())) vswitch = vpc.create_vswitch(params) module.exit_json(changed=True, vswitch=vswitch.get().read()) except VPCResponseError as e: module.fail_json(msg='Unable to create VSwitch, error: {0}'.format(e)) if not vswitch_name: vswitch_name = vswitch.vswitch_name if not description: description = vswitch.description try: if vswitch.modify(name=vswitch_name, description=description): changed = True except VPCResponseError as e: module.fail_json(msg='Unable to modify vswitch attribute, error: {0}'.format(e)) module.exit_json(changed=changed, vswitch=vswitch.get().read()) if __name__ == '__main__': main()