mirror of
https://github.com/thegeeklab/ansible-later.git
synced 2024-07-06 09:00:58 +02:00
286 lines
8.6 KiB
Python
286 lines
8.6 KiB
Python
#!/usr/bin/python
|
|
#
|
|
# Copyright (c) 2018 Zim Kalinowski, <zikalino@microsoft.com>
|
|
#
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['preview'],
|
|
'supported_by': 'community'}
|
|
|
|
|
|
DOCUMENTATION = '''
|
|
---
|
|
module: azure_rm_resource
|
|
version_added: "2.6"
|
|
short_description: Create any Azure resource.
|
|
description:
|
|
- Create, update or delete any Azure resource using Azure REST API.
|
|
- This module gives access to resources that are not supported via Ansible modules.
|
|
- Refer to https://docs.microsoft.com/en-us/rest/api/ regarding details related to specific resource REST API.
|
|
|
|
options:
|
|
url:
|
|
description:
|
|
- Azure RM Resource URL.
|
|
api_version:
|
|
description:
|
|
- Specific API version to be used.
|
|
required: yes
|
|
provider:
|
|
description:
|
|
- Provider type.
|
|
- Required if URL is not specified.
|
|
resource_group:
|
|
description:
|
|
- Resource group to be used.
|
|
- Required if URL is not specified.
|
|
resource_type:
|
|
description:
|
|
- Resource type.
|
|
- Required if URL is not specified.
|
|
resource_name:
|
|
description:
|
|
- Resource name.
|
|
- Required if URL Is not specified.
|
|
subresource:
|
|
description:
|
|
- List of subresources
|
|
suboptions:
|
|
namespace:
|
|
description:
|
|
- Subresource namespace
|
|
type:
|
|
description:
|
|
- Subresource type
|
|
name:
|
|
description:
|
|
- Subresource name
|
|
body:
|
|
description:
|
|
- The body of the http request/response to the web service.
|
|
method:
|
|
description:
|
|
- The HTTP method of the request or response. It MUST be uppercase.
|
|
choices: [ "GET", "PUT", "POST", "HEAD", "PATCH", "DELETE", "MERGE" ]
|
|
default: "PUT"
|
|
status_code:
|
|
description:
|
|
- A valid, numeric, HTTP status code that signifies success of the
|
|
request. Can also be comma separated list of status codes.
|
|
default: [ 200, 201, 202 ]
|
|
idempotency:
|
|
description:
|
|
- If enabled, idempotency check will be done by using GET method first and then comparing with I(body)
|
|
default: no
|
|
type: bool
|
|
state:
|
|
description:
|
|
- Assert the state of the resource. Use C(present) to create or update resource or C(absent) to delete resource.
|
|
default: present
|
|
choices:
|
|
- absent
|
|
- present
|
|
|
|
extends_documentation_fragment:
|
|
- azure
|
|
|
|
author:
|
|
- "Zim Kalinowski (@zikalino)"
|
|
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
- name: Update scaleset info using azure_rm_resource
|
|
azure_rm_resource:
|
|
resource_group: "{{ resource_group }}"
|
|
provider: compute
|
|
resource_type: virtualmachinescalesets
|
|
resource_name: "{{ scaleset_name }}"
|
|
api_version: "2017-12-01"
|
|
body: "{{ body }}"
|
|
'''
|
|
|
|
RETURN = '''
|
|
response:
|
|
description: Response specific to resource type.
|
|
returned: always
|
|
type: dict
|
|
'''
|
|
|
|
from ansible.module_utils.azure_rm_common import AzureRMModuleBase
|
|
from ansible.module_utils.azure_rm_common_rest import GenericRestClient
|
|
from ansible.module_utils.common.dict_transformations import dict_merge
|
|
|
|
try:
|
|
from msrestazure.azure_exceptions import CloudError
|
|
from msrest.service_client import ServiceClient
|
|
from msrestazure.tools import resource_id, is_valid_resource_id
|
|
import json
|
|
|
|
except ImportError:
|
|
# This is handled in azure_rm_common
|
|
pass
|
|
|
|
|
|
class AzureRMResource(AzureRMModuleBase):
|
|
def __init__(self):
|
|
# define user inputs into argument
|
|
self.module_arg_spec = dict(
|
|
url=dict(
|
|
type='str',
|
|
required=False
|
|
),
|
|
provider=dict(
|
|
type='str',
|
|
),
|
|
resource_group=dict(
|
|
type='str',
|
|
),
|
|
resource_type=dict(
|
|
type='str',
|
|
),
|
|
resource_name=dict(
|
|
type='str',
|
|
),
|
|
subresource=dict(
|
|
type='list',
|
|
default=[]
|
|
),
|
|
api_version=dict(
|
|
type='str',
|
|
required=True
|
|
),
|
|
method=dict(
|
|
type='str',
|
|
default='PUT',
|
|
choices=["GET", "PUT", "POST", "HEAD", "PATCH", "DELETE", "MERGE"]
|
|
),
|
|
body=dict(
|
|
type='raw'
|
|
),
|
|
status_code=dict(
|
|
type='list',
|
|
default=[200, 201, 202]
|
|
),
|
|
idempotency=dict(
|
|
type='bool',
|
|
default=False
|
|
),
|
|
state=dict(
|
|
type='str',
|
|
default='present',
|
|
choices=['present', 'absent']
|
|
)
|
|
)
|
|
# store the results of the module operation
|
|
self.results = dict(
|
|
changed=False,
|
|
response=None
|
|
)
|
|
self.mgmt_client = None
|
|
self.url = None
|
|
self.api_version = None
|
|
self.provider = None
|
|
self.resource_group = None
|
|
self.resource_type = None
|
|
self.resource_name = None
|
|
self.subresource_type = None
|
|
self.subresource_name = None
|
|
self.subresource = []
|
|
self.method = None
|
|
self.status_code = []
|
|
self.idempotency = False
|
|
self.state = None
|
|
self.body = None
|
|
super(AzureRMResource, self).__init__(self.module_arg_spec, supports_tags=False)
|
|
|
|
def exec_module(self, **kwargs):
|
|
for key in self.module_arg_spec:
|
|
setattr(self, key, kwargs[key])
|
|
self.mgmt_client = self.get_mgmt_svc_client(GenericRestClient,
|
|
base_url=self._cloud_environment.endpoints.resource_manager)
|
|
|
|
if self.state == 'absent':
|
|
self.method = 'DELETE'
|
|
self.status_code.append(204)
|
|
|
|
if self.url is None:
|
|
orphan = None
|
|
rargs = dict()
|
|
rargs['subscription'] = self.subscription_id
|
|
rargs['resource_group'] = self.resource_group
|
|
if not (self.provider is None or self.provider.lower().startswith('.microsoft')):
|
|
rargs['namespace'] = "Microsoft." + self.provider
|
|
else:
|
|
rargs['namespace'] = self.provider
|
|
|
|
if self.resource_type is not None and self.resource_name is not None:
|
|
rargs['type'] = self.resource_type
|
|
rargs['name'] = self.resource_name
|
|
for i in range(len(self.subresource)):
|
|
resource_ns = self.subresource[i].get('namespace', None)
|
|
resource_type = self.subresource[i].get('type', None)
|
|
resource_name = self.subresource[i].get('name', None)
|
|
if resource_type is not None and resource_name is not None:
|
|
rargs['child_namespace_' + str(i + 1)] = resource_ns
|
|
rargs['child_type_' + str(i + 1)] = resource_type
|
|
rargs['child_name_' + str(i + 1)] = resource_name
|
|
else:
|
|
orphan = resource_type
|
|
else:
|
|
orphan = self.resource_type
|
|
|
|
self.url = resource_id(**rargs)
|
|
|
|
if orphan is not None:
|
|
self.url += '/' + orphan
|
|
query_parameters = {}
|
|
query_parameters['api-version'] = self.api_version
|
|
|
|
header_parameters = {}
|
|
header_parameters['Content-Type'] = 'application/json; charset=utf-8'
|
|
|
|
needs_update = True
|
|
response = None
|
|
|
|
if self.idempotency:
|
|
original = self.mgmt_client.query(self.url, "GET", query_parameters, None, None, [200, 404])
|
|
|
|
if original.status_code == 404:
|
|
if self.state == 'absent':
|
|
needs_update = False
|
|
else:
|
|
try:
|
|
response = json.loads(original.text)
|
|
needs_update = (dict_merge(response, self.body) != response)
|
|
except:
|
|
pass
|
|
|
|
if needs_update:
|
|
response = self.mgmt_client.query(self.url, self.method, query_parameters, header_parameters, self.body, self.status_code)
|
|
if self.state == 'present':
|
|
try:
|
|
response = json.loads(response.text)
|
|
except:
|
|
response = response.text
|
|
else:
|
|
response = None
|
|
|
|
self.results['response'] = response
|
|
self.results['changed'] = needs_update
|
|
|
|
return self.results
|
|
|
|
|
|
def main():
|
|
AzureRMResource()
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|