text: # coding=utf-8
  # --------------------------------------------------------------------------
  # Copyright (c) Microsoft Corporation. All rights reserved.
  # Licensed under the MIT License. See License.txt in the project root for
  # license information.
  #
  # Code generated by Microsoft (R) AutoRest Code Generator.
  # Changes may cause incorrect behavior and will be lost if the code is
  # regenerated.
  # --------------------------------------------------------------------------
  
  import uuid
  from msrest.pipeline import ClientRawResponse
  from msrestazure.azure_exceptions import CloudError
  from msrest.polling import LROPoller, NoPolling
  from msrestazure.polling.arm_polling import ARMPolling
  
  from .. import models
  
  
  class ResourceGroupsOperations(object):
      """ResourceGroupsOperations operations.
  
      You should not instantiate directly this class, but create a Client instance that will create it for you and attach it as attribute.
  
      :param client: Client for service requests.
      :param config: Configuration of service client.
      :param serializer: An object model serializer.
      :param deserializer: An object model deserializer.
      :ivar api_version: The API version to use for this operation. Constant value: "2020-06-01".
      """
  
      models = models
  
      def __init__(self, client, config, serializer, deserializer):
  
          self._client = client
          self._serialize = serializer
          self._deserialize = deserializer
          self.api_version = "2020-06-01"
  
          self.config = config
  
      def check_existence(
              self, resource_group_name, custom_headers=None, raw=False, **operation_config):
          """Checks whether a resource group exists.
  
          :param resource_group_name: The name of the resource group to check.
           The name is case insensitive.
          :type resource_group_name: str
          :param dict custom_headers: headers that will be added to the request
          :param bool raw: returns the direct response alongside the
           deserialized response
          :param operation_config: :ref:`Operation configuration
           overrides<msrest:optionsforoperations>`.
          :return: bool or ClientRawResponse if raw=true
          :rtype: bool or ~msrest.pipeline.ClientRawResponse
          :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
          """
          # Construct URL
          url = self.check_existence.metadata['url']
          path_format_arguments = {
              'resourceGroupName': self._serialize.url("resource_group_name", resource_group_name, 'str', max_length=90, min_length=1, pattern=r'^[-\w\._\(\)]+$'),
              'subscriptionId': self._serialize.url("self.config.subscription_id", self.config.subscription_id, 'str')
          }
          url = self._client.format_url(url, **path_format_arguments)
  
          # Construct parameters
          query_parameters = {}
          query_parameters['api-version'] = self._serialize.query("self.api_version", self.api_version, 'str')
  
          # Construct headers
          header_parameters = {}
          if self.config.generate_client_request_id:
              header_parameters['x-ms-client-request-id'] = str(uuid.uuid1())
          if custom_headers:
              header_parameters.update(custom_headers)
          if self.config.accept_language is not None:
              header_parameters['accept-language'] = self._serialize.header("self.config.accept_language", self.config.accept_language, 'str')
  
          # Construct and send request
          request = self._client.head(url, query_parameters, header_parameters)
          response = self._client.send(request, stream=False, **operation_config)
  
          if response.status_code not in [204, 404]:
              exp = CloudError(response)
              exp.request_id = response.headers.get('x-ms-request-id')
              raise exp
  
          deserialized = (response.status_code == 204)
          if raw:
              client_raw_response = ClientRawResponse(deserialized, response)
              return client_raw_response
          return deserialized
      check_existence.metadata = {'url': '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}'}
  
      def create_or_update(
              self, resource_group_name, parameters, custom_headers=None, raw=False, **operation_config):
          """Creates or updates a resource group.
  
          :param resource_group_name: The name of the resource group to create
           or update. Can include alphanumeric, underscore, parentheses, hyphen,
           period (except at end), and Unicode characters that match the allowed
           characters.
          :type resource_group_name: str
          :param parameters: Parameters supplied to the create or update a
           resource group.
          :type parameters:
           ~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroup
          :param dict custom_headers: headers that will be added to the request
          :param bool raw: returns the direct response alongside the
           deserialized response
          :param operation_config: :ref:`Operation configuration
           overrides<msrest:optionsforoperations>`.
          :return: ResourceGroup or ClientRawResponse if raw=true
          :rtype:
           ~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroup or
           ~msrest.pipeline.ClientRawResponse
          :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
          """
          # Construct URL
          url = self.create_or_update.metadata['url']
          path_format_arguments = {
              'resourceGroupName': self._serialize.url("resource_group_name", resource_group_name, 'str', max_length=90, min_length=1, pattern=r'^[-\w\._\(\)]+$'),
              'subscriptionId': self._serialize.url("self.config.subscription_id", self.config.subscription_id, 'str')
          }
          url = self._client.format_url(url, **path_format_arguments)
  
          # Construct parameters
          query_parameters = {}
          query_parameters['api-version'] = self._serialize.query("self.api_version", self.api_version, 'str')
  
          # Construct headers
          header_parameters = {}
          header_parameters['Accept'] = 'application/json'
          header_parameters['Content-Type'] = 'application/json; charset=utf-8'
          if self.config.generate_client_request_id:
              header_parameters['x-ms-client-request-id'] = str(uuid.uuid1())
          if custom_headers:
              header_parameters.update(custom_headers)
          if self.config.accept_language is not None:
              header_parameters['accept-language'] = self._serialize.header("self.config.accept_language", self.config.accept_language, 'str')
  
          # Construct body
          body_content = self._serialize.body(parameters, 'ResourceGroup')
  
          # Construct and send request
          request = self._client.put(url, query_parameters, header_parameters, body_content)
          response = self._client.send(request, stream=False, **operation_config)
  
          if response.status_code not in [200, 201]:
              exp = CloudError(response)
              exp.request_id = response.headers.get('x-ms-request-id')
              raise exp
  
          deserialized = None
          if response.status_code == 200:
              deserialized = self._deserialize('ResourceGroup', response)
          if response.status_code == 201:
              deserialized = self._deserialize('ResourceGroup', response)
  
          if raw:
              client_raw_response = ClientRawResponse(deserialized, response)
              return client_raw_response
  
          return deserialized
      create_or_update.metadata = {'url': '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}'}
  
  
      def _delete_initial(
              self, resource_group_name, force_deletion_resource_types=None, custom_headers=None, raw=False, **operation_config):
          # Construct URL
          url = self.delete.metadata['url']
          path_format_arguments = {
              'resourceGroupName': self._serialize.url("resource_group_name", resource_group_name, 'str', max_length=90, min_length=1, pattern=r'^[-\w\._\(\)]+$'),
              'subscriptionId': self._serialize.url("self.config.subscription_id", self.config.subscription_id, 'str')
          }
          url = self._client.format_url(url, **path_format_arguments)
  
          # Construct parameters
          query_parameters = {}
          if force_deletion_resource_types is not None:
              query_parameters['forceDeletionResourceTypes'] = self._serialize.query("force_deletion_resource_types", force_deletion_resource_types, 'str')
          query_parameters['api-version'] = self._serialize.query("self.api_version", self.api_version, 'str')
  
          # Construct headers
          header_parameters = {}
          if self.config.generate_client_request_id:
              header_parameters['x-ms-client-request-id'] = str(uuid.uuid1())
          if custom_headers:
              header_parameters.update(custom_headers)
          if self.config.accept_language is not None:
              header_parameters['accept-language'] = self._serialize.header("self.config.accept_language", self.config.accept_language, 'str')
  
          # Construct and send request
          request = self._client.delete(url, query_parameters, header_parameters)
          response = self._client.send(request, stream=False, **operation_config)
  
          if response.status_code not in [200, 202]:
              exp = CloudError(response)
              exp.request_id = response.headers.get('x-ms-request-id')
              raise exp
  
          if raw:
              client_raw_response = ClientRawResponse(None, response)
              return client_raw_response
  
      def delete(
              self, resource_group_name, force_deletion_resource_types=None, custom_headers=None, raw=False, polling=True, **operation_config):
          """Deletes a resource group.
  
          When you delete a resource group, all of its resources are also
          deleted. Deleting a resource group deletes all of its template
          deployments and currently stored operations.
  
          :param resource_group_name: The name of the resource group to delete.
           The name is case insensitive.
          :type resource_group_name: str
          :param force_deletion_resource_types: The resource types you want to
           force delete. Currently, only the following is supported:
           forceDeletionResourceTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets
          :type force_deletion_resource_types: str
          :param dict custom_headers: headers that will be added to the request
          :param bool raw: The poller return type is ClientRawResponse, the
           direct response alongside the deserialized response
          :param polling: True for ARMPolling, False for no polling, or a
           polling object for personal polling strategy
          :return: An instance of LROPoller that returns None or
           ClientRawResponse<None> if raw==True
          :rtype: ~msrestazure.azure_operation.AzureOperationPoller[None] or
           ~msrestazure.azure_operation.AzureOperationPoller[~msrest.pipeline.ClientRawResponse[None]]
          :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
          """
          raw_result = self._delete_initial(
              resource_group_name=resource_group_name,
              force_deletion_resource_types=force_deletion_resource_types,
              custom_headers=custom_headers,
              raw=True,
              **operation_config
          )
  
          def get_long_running_output(response):
              if raw:
                  client_raw_response = ClientRawResponse(None, response)
                  return client_raw_response
  
          lro_delay = operation_config.get(
              'long_running_operation_timeout',
              self.config.long_running_operation_timeout)
          if polling is True: polling_method = ARMPolling(lro_delay, **operation_config)
          elif polling is False: polling_method = NoPolling()
          else: polling_method = polling
          return LROPoller(self._client, raw_result, get_long_running_output, polling_method)
      delete.metadata = {'url': '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}'}
  
      def get(
              self, resource_group_name, custom_headers=None, raw=False, **operation_config):
          """Gets a resource group.
  
          :param resource_group_name: The name of the resource group to get. The
           name is case insensitive.
          :type resource_group_name: str
          :param dict custom_headers: headers that will be added to the request
          :param bool raw: returns the direct response alongside the
           deserialized response
          :param operation_config: :ref:`Operation configuration
           overrides<msrest:optionsforoperations>`.
          :return: ResourceGroup or ClientRawResponse if raw=true
          :rtype:
           ~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroup or
           ~msrest.pipeline.ClientRawResponse
          :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
          """
          # Construct URL
          url = self.get.metadata['url']
          path_format_arguments = {
              'resourceGroupName': self._serialize.url("resource_group_name", resource_group_name, 'str', max_length=90, min_length=1, pattern=r'^[-\w\._\(\)]+$'),
              'subscriptionId': self._serialize.url("self.config.subscription_id", self.config.subscription_id, 'str')
          }
          url = self._client.format_url(url, **path_format_arguments)
  
          # Construct parameters
          query_parameters = {}
          query_parameters['api-version'] = self._serialize.query("self.api_version", self.api_version, 'str')
  
          # Construct headers
          header_parameters = {}
          header_parameters['Accept'] = 'application/json'
          if self.config.generate_client_request_id:
              header_parameters['x-ms-client-request-id'] = str(uuid.uuid1())
          if custom_headers:
              header_parameters.update(custom_headers)
          if self.config.accept_language is not None:
              header_parameters['accept-language'] = self._serialize.header("self.config.accept_language", self.config.accept_language, 'str')
  
          # Construct and send request
          request = self._client.get(url, query_parameters, header_parameters)
          response = self._client.send(request, stream=False, **operation_config)
  
          if response.status_code not in [200]:
              exp = CloudError(response)
              exp.request_id = response.headers.get('x-ms-request-id')
              raise exp
  
          deserialized = None
          if response.status_code == 200:
              deserialized = self._deserialize('ResourceGroup', response)
  
          if raw:
              client_raw_response = ClientRawResponse(deserialized, response)
              return client_raw_response
  
          return deserialized
      get.metadata = {'url': '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}'}
  
      def update(
              self, resource_group_name, parameters, custom_headers=None, raw=False, **operation_config):
          """Updates a resource group.
  
          Resource groups can be updated through a simple PATCH operation to a
          group address. The format of the request is the same as that for
          creating a resource group. If a field is unspecified, the current value
          is retained.
  
          :param resource_group_name: The name of the resource group to update.
           The name is case insensitive.
          :type resource_group_name: str
          :param parameters: Parameters supplied to update a resource group.
          :type parameters:
           ~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroupPatchable
          :param dict custom_headers: headers that will be added to the request
          :param bool raw: returns the direct response alongside the
           deserialized response
          :param operation_config: :ref:`Operation configuration
           overrides<msrest:optionsforoperations>`.
          :return: ResourceGroup or ClientRawResponse if raw=true
          :rtype:
           ~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroup or
           ~msrest.pipeline.ClientRawResponse
          :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
          """
          # Construct URL
          url = self.update.metadata['url']
          path_format_arguments = {
              'resourceGroupName': self._serialize.url("resource_group_name", resource_group_name, 'str', max_length=90, min_length=1, pattern=r'^[-\w\._\(\)]+$'),
              'subscriptionId': self._serialize.url("self.config.subscription_id", self.config.subscription_id, 'str')
          }
          url = self._client.format_url(url, **path_format_arguments)
  
          # Construct parameters
          query_parameters = {}
          query_parameters['api-version'] = self._serialize.query("self.api_version", self.api_version, 'str')
  
          # Construct headers
          header_parameters = {}
          header_parameters['Accept'] = 'application/json'
          header_parameters['Content-Type'] = 'application/json; charset=utf-8'
          if self.config.generate_client_request_id:
              header_parameters['x-ms-client-request-id'] = str(uuid.uuid1())
          if custom_headers:
              header_parameters.update(custom_headers)
          if self.config.accept_language is not None:
              header_parameters['accept-language'] = self._serialize.header("self.config.accept_language", self.config.accept_language, 'str')
  
          # Construct body
          body_content = self._serialize.body(parameters, 'ResourceGroupPatchable')
  
          # Construct and send request
          request = self._client.patch(url, query_parameters, header_parameters, body_content)
          response = self._client.send(request, stream=False, **operation_config)
  
          if response.status_code not in [200]:
              exp = CloudError(response)
              exp.request_id = response.headers.get('x-ms-request-id')
              raise exp
  
          deserialized = None
          if response.status_code == 200:
              deserialized = self._deserialize('ResourceGroup', response)
  
          if raw:
              client_raw_response = ClientRawResponse(deserialized, response)
              return client_raw_response
  
          return deserialized
      update.metadata = {'url': '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}'}
  
  
      def _export_template_initial(
              self, resource_group_name, resources=None, options=None, custom_headers=None, raw=False, **operation_config):
          parameters = models.ExportTemplateRequest(resources=resources, options=options)
  
          # Construct URL
          url = self.export_template.metadata['url']
          path_format_arguments = {
              'subscriptionId': self._serialize.url("self.config.subscription_id", self.config.subscription_id, 'str'),
              'resourceGroupName': self._serialize.url("resource_group_name", resource_group_name, 'str', max_length=90, min_length=1, pattern=r'^[-\w\._\(\)]+$')
          }
          url = self._client.format_url(url, **path_format_arguments)
  
          # Construct parameters
          query_parameters = {}
          query_parameters['api-version'] = self._serialize.query("self.api_version", self.api_version, 'str')
  
          # Construct headers
          header_parameters = {}
          header_parameters['Accept'] = 'application/json'
          header_parameters['Content-Type'] = 'application/json; charset=utf-8'
          if self.config.generate_client_request_id:
              header_parameters['x-ms-client-request-id'] = str(uuid.uuid1())
          if custom_headers:
              header_parameters.update(custom_headers)
          if self.config.accept_language is not None:
              header_parameters['accept-language'] = self._serialize.header("self.config.accept_language", self.config.accept_language, 'str')
  
          # Construct body
          body_content = self._serialize.body(parameters, 'ExportTemplateRequest')
  
          # Construct and send request
          request = self._client.post(url, query_parameters, header_parameters, body_content)
          response = self._client.send(request, stream=False, **operation_config)
  
          if response.status_code not in [200, 202]:
              exp = CloudError(response)
              exp.request_id = response.headers.get('x-ms-request-id')
              raise exp
  
          deserialized = None
  
          if response.status_code == 200:
              deserialized = self._deserialize('ResourceGroupExportResult', response)
  
          if raw:
              client_raw_response = ClientRawResponse(deserialized, response)
              return client_raw_response
  
          return deserialized
  
      def export_template(
              self, resource_group_name, resources=None, options=None, custom_headers=None, raw=False, polling=True, **operation_config):
          """Captures the specified resource group as a template.
  
          :param resource_group_name: The name of the resource group. The name
           is case insensitive.
          :type resource_group_name: str
          :param resources: The IDs of the resources to filter the export by. To
           export all resources, supply an array with single entry '*'.
          :type resources: list[str]
          :param options: The export template options. A CSV-formatted list
           containing zero or more of the following:
           'IncludeParameterDefaultValue', 'IncludeComments',
           'SkipResourceNameParameterization', 'SkipAllParameterization'
          :type options: str
          :param dict custom_headers: headers that will be added to the request
          :param bool raw: The poller return type is ClientRawResponse, the
           direct response alongside the deserialized response
          :param polling: True for ARMPolling, False for no polling, or a
           polling object for personal polling strategy
          :return: An instance of LROPoller that returns
           ResourceGroupExportResult or
           ClientRawResponse<ResourceGroupExportResult> if raw==True
          :rtype:
           ~msrestazure.azure_operation.AzureOperationPoller[~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroupExportResult]
           or
           ~msrestazure.azure_operation.AzureOperationPoller[~msrest.pipeline.ClientRawResponse[~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroupExportResult]]
          :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
          """
          raw_result = self._export_template_initial(
              resource_group_name=resource_group_name,
              resources=resources,
              options=options,
              custom_headers=custom_headers,
              raw=True,
              **operation_config
          )
  
          def get_long_running_output(response):
              deserialized = self._deserialize('ResourceGroupExportResult', response)
  
              if raw:
                  client_raw_response = ClientRawResponse(deserialized, response)
                  return client_raw_response
  
              return deserialized
  
          lro_delay = operation_config.get(
              'long_running_operation_timeout',
              self.config.long_running_operation_timeout)
          if polling is True: polling_method = ARMPolling(lro_delay, lro_options={'final-state-via': 'location'}, **operation_config)
          elif polling is False: polling_method = NoPolling()
          else: polling_method = polling
          return LROPoller(self._client, raw_result, get_long_running_output, polling_method)
      export_template.metadata = {'url': '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/exportTemplate'}
  
      def list(
              self, filter=None, top=None, custom_headers=None, raw=False, **operation_config):
          """Gets all the resource groups for a subscription.
  
          :param filter: The filter to apply on the operation.<br><br>You can
           filter by tag names and values. For example, to filter for a tag name
           and value, use $filter=tagName eq 'tag1' and tagValue eq 'Value1'
          :type filter: str
          :param top: The number of results to return. If null is passed,
           returns all resource groups.
          :type top: int
          :param dict custom_headers: headers that will be added to the request
          :param bool raw: returns the direct response alongside the
           deserialized response
          :param operation_config: :ref:`Operation configuration
           overrides<msrest:optionsforoperations>`.
          :return: An iterator like instance of ResourceGroup
          :rtype:
           ~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroupPaged[~azure.mgmt.resource.resources.v2020_06_01.models.ResourceGroup]
          :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
          """
          def prepare_request(next_link=None):
              if not next_link:
                  # Construct URL
                  url = self.list.metadata['url']
                  path_format_arguments = {
                      'subscriptionId': self._serialize.url("self.config.subscription_id", self.config.subscription_id, 'str')
                  }
                  url = self._client.format_url(url, **path_format_arguments)
  
                  # Construct parameters
                  query_parameters = {}
                  if filter is not None:
                      query_parameters['$filter'] = self._serialize.query("filter", filter, 'str')
                  if top is not None:
                      query_parameters['$top'] = self._serialize.query("top", top, 'int')
                  query_parameters['api-version'] = self._serialize.query("self.api_version", self.api_version, 'str')
  
              else:
                  url = next_link
                  query_parameters = {}
  
              # Construct headers
              header_parameters = {}
              header_parameters['Accept'] = 'application/json'
              if self.config.generate_client_request_id:
                  header_parameters['x-ms-client-request-id'] = str(uuid.uuid1())
              if custom_headers:
                  header_parameters.update(custom_headers)
              if self.config.accept_language is not None:
                  header_parameters['accept-language'] = self._serialize.header("self.config.accept_language", self.config.accept_language, 'str')
  
              # Construct and send request
              request = self._client.get(url, query_parameters, header_parameters)
              return request
  
          def internal_paging(next_link=None):
              request = prepare_request(next_link)
  
              response = self._client.send(request, stream=False, **operation_config)
  
              if response.status_code not in [200]:
                  exp = CloudError(response)
                  exp.request_id = response.headers.get('x-ms-request-id')
                  raise exp
  
              return response
  
          # Deserialize response
          header_dict = None
          if raw:
              header_dict = {}
          deserialized = models.ResourceGroupPaged(internal_paging, self._deserialize.dependencies, header_dict)
  
          return deserialized
      list.metadata = {'url': '/subscriptions/{subscriptionId}/resourcegroups'}
  