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 functools
  from typing import Any, Callable, Dict, Generic, Iterable, Optional, TypeVar, Union
  import warnings
  
  from azure.core.exceptions import ClientAuthenticationError, HttpResponseError, ResourceExistsError, ResourceNotFoundError, map_error
  from azure.core.paging import ItemPaged
  from azure.core.pipeline import PipelineResponse
  from azure.core.pipeline.transport import HttpResponse
  from azure.core.polling import LROPoller, NoPolling, PollingMethod
  from azure.core.rest import HttpRequest
  from azure.core.tracing.decorator import distributed_trace
  from azure.mgmt.core.exceptions import ARMErrorFormat
  from azure.mgmt.core.polling.arm_polling import ARMPolling
  from msrest import Serializer
  
  from .. import models as _models
  from .._vendor import _convert_request, _format_url_section
  T = TypeVar('T')
  JSONType = Any
  ClsType = Optional[Callable[[PipelineResponse[HttpRequest, HttpResponse], T, Dict[str, Any]], Any]]
  
  _SERIALIZER = Serializer()
  _SERIALIZER.client_side_validation = False
  
  def build_restore_request_initial(
      resource_group_name: str,
      service_name: str,
      subscription_id: str,
      *,
      json: JSONType = None,
      content: Any = None,
      **kwargs: Any
  ) -> HttpRequest:
      content_type = kwargs.pop('content_type', None)  # type: Optional[str]
  
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/restore')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "serviceName": _SERIALIZER.url("service_name", service_name, 'str', max_length=50, min_length=1, pattern=r'^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      if content_type is not None:
          header_parameters['Content-Type'] = _SERIALIZER.header("content_type", content_type, 'str')
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="POST",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          json=json,
          content=content,
          **kwargs
      )
  
  
  def build_backup_request_initial(
      resource_group_name: str,
      service_name: str,
      subscription_id: str,
      *,
      json: JSONType = None,
      content: Any = None,
      **kwargs: Any
  ) -> HttpRequest:
      content_type = kwargs.pop('content_type', None)  # type: Optional[str]
  
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backup')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "serviceName": _SERIALIZER.url("service_name", service_name, 'str', max_length=50, min_length=1, pattern=r'^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      if content_type is not None:
          header_parameters['Content-Type'] = _SERIALIZER.header("content_type", content_type, 'str')
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="POST",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          json=json,
          content=content,
          **kwargs
      )
  
  
  def build_create_or_update_request_initial(
      resource_group_name: str,
      service_name: str,
      subscription_id: str,
      *,
      json: JSONType = None,
      content: Any = None,
      **kwargs: Any
  ) -> HttpRequest:
      content_type = kwargs.pop('content_type', None)  # type: Optional[str]
  
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "serviceName": _SERIALIZER.url("service_name", service_name, 'str', max_length=50, min_length=1, pattern=r'^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      if content_type is not None:
          header_parameters['Content-Type'] = _SERIALIZER.header("content_type", content_type, 'str')
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="PUT",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          json=json,
          content=content,
          **kwargs
      )
  
  
  def build_update_request_initial(
      resource_group_name: str,
      service_name: str,
      subscription_id: str,
      *,
      json: JSONType = None,
      content: Any = None,
      **kwargs: Any
  ) -> HttpRequest:
      content_type = kwargs.pop('content_type', None)  # type: Optional[str]
  
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "serviceName": _SERIALIZER.url("service_name", service_name, 'str', max_length=50, min_length=1, pattern=r'^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      if content_type is not None:
          header_parameters['Content-Type'] = _SERIALIZER.header("content_type", content_type, 'str')
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="PATCH",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          json=json,
          content=content,
          **kwargs
      )
  
  
  def build_get_request(
      resource_group_name: str,
      service_name: str,
      subscription_id: str,
      **kwargs: Any
  ) -> HttpRequest:
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "serviceName": _SERIALIZER.url("service_name", service_name, 'str', max_length=50, min_length=1, pattern=r'^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="GET",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          **kwargs
      )
  
  
  def build_delete_request_initial(
      resource_group_name: str,
      service_name: str,
      subscription_id: str,
      **kwargs: Any
  ) -> HttpRequest:
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "serviceName": _SERIALIZER.url("service_name", service_name, 'str', max_length=50, min_length=1, pattern=r'^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="DELETE",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          **kwargs
      )
  
  
  def build_list_by_resource_group_request(
      resource_group_name: str,
      subscription_id: str,
      **kwargs: Any
  ) -> HttpRequest:
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="GET",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          **kwargs
      )
  
  
  def build_list_request(
      subscription_id: str,
      **kwargs: Any
  ) -> HttpRequest:
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/service')
      path_format_arguments = {
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="GET",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          **kwargs
      )
  
  
  def build_get_sso_token_request(
      resource_group_name: str,
      service_name: str,
      subscription_id: str,
      **kwargs: Any
  ) -> HttpRequest:
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/getssotoken')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "serviceName": _SERIALIZER.url("service_name", service_name, 'str', max_length=50, min_length=1, pattern=r'^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="POST",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          **kwargs
      )
  
  
  def build_check_name_availability_request(
      subscription_id: str,
      *,
      json: JSONType = None,
      content: Any = None,
      **kwargs: Any
  ) -> HttpRequest:
      content_type = kwargs.pop('content_type', None)  # type: Optional[str]
  
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/checkNameAvailability')
      path_format_arguments = {
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      if content_type is not None:
          header_parameters['Content-Type'] = _SERIALIZER.header("content_type", content_type, 'str')
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="POST",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          json=json,
          content=content,
          **kwargs
      )
  
  
  def build_get_domain_ownership_identifier_request(
      subscription_id: str,
      **kwargs: Any
  ) -> HttpRequest:
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/getDomainOwnershipIdentifier')
      path_format_arguments = {
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="POST",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          **kwargs
      )
  
  
  def build_apply_network_configuration_updates_request_initial(
      resource_group_name: str,
      service_name: str,
      subscription_id: str,
      *,
      json: JSONType = None,
      content: Any = None,
      **kwargs: Any
  ) -> HttpRequest:
      content_type = kwargs.pop('content_type', None)  # type: Optional[str]
  
      api_version = "2021-08-01"
      accept = "application/json"
      # Construct URL
      url = kwargs.pop("template_url", '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/applynetworkconfigurationupdates')
      path_format_arguments = {
          "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, 'str'),
          "serviceName": _SERIALIZER.url("service_name", service_name, 'str', max_length=50, min_length=1, pattern=r'^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$'),
          "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, 'str'),
      }
  
      url = _format_url_section(url, **path_format_arguments)
  
      # Construct parameters
      query_parameters = kwargs.pop("params", {})  # type: Dict[str, Any]
      query_parameters['api-version'] = _SERIALIZER.query("api_version", api_version, 'str')
  
      # Construct headers
      header_parameters = kwargs.pop("headers", {})  # type: Dict[str, Any]
      if content_type is not None:
          header_parameters['Content-Type'] = _SERIALIZER.header("content_type", content_type, 'str')
      header_parameters['Accept'] = _SERIALIZER.header("accept", accept, 'str')
  
      return HttpRequest(
          method="POST",
          url=url,
          params=query_parameters,
          headers=header_parameters,
          json=json,
          content=content,
          **kwargs
      )
  
  class ApiManagementServiceOperations(object):
      """ApiManagementServiceOperations operations.
  
      You should not instantiate this class directly. Instead, you should create a Client instance that
      instantiates it for you and attaches it as an attribute.
  
      :ivar models: Alias to model classes used in this operation group.
      :type models: ~api_management_client.models
      :param client: Client for service requests.
      :param config: Configuration of service client.
      :param serializer: An object model serializer.
      :param deserializer: An object model deserializer.
      """
  
      models = _models
  
      def __init__(self, client, config, serializer, deserializer):
          self._client = client
          self._serialize = serializer
          self._deserialize = deserializer
          self._config = config
  
      def _restore_initial(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: "_models.ApiManagementServiceBackupRestoreParameters",
          **kwargs: Any
      ) -> Optional["_models.ApiManagementServiceResource"]:
          cls = kwargs.pop('cls', None)  # type: ClsType[Optional["_models.ApiManagementServiceResource"]]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
  
          _json = self._serialize.body(parameters, 'ApiManagementServiceBackupRestoreParameters')
  
          request = build_restore_request_initial(
              resource_group_name=resource_group_name,
              service_name=service_name,
              subscription_id=self._config.subscription_id,
              content_type=content_type,
              json=_json,
              template_url=self._restore_initial.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200, 202]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              raise HttpResponseError(response=response, error_format=ARMErrorFormat)
  
          deserialized = None
          if response.status_code == 200:
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      _restore_initial.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/restore'}  # type: ignore
  
  
      @distributed_trace
      def begin_restore(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: "_models.ApiManagementServiceBackupRestoreParameters",
          **kwargs: Any
      ) -> LROPoller["_models.ApiManagementServiceResource"]:
          """Restores a backup of an API Management service created using the ApiManagementService_Backup
          operation on the current service. This is a long running operation and could take several
          minutes to complete.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :param service_name: The name of the API Management service.
          :type service_name: str
          :param parameters: Parameters supplied to the Restore API Management service from backup
           operation.
          :type parameters: ~api_management_client.models.ApiManagementServiceBackupRestoreParameters
          :keyword callable cls: A custom type or function that will be passed the direct response
          :keyword str continuation_token: A continuation token to restart a poller from a saved state.
          :keyword polling: By default, your polling method will be ARMPolling. Pass in False for this
           operation to not poll, or pass in your own initialized polling object for a personal polling
           strategy.
          :paramtype polling: bool or ~azure.core.polling.PollingMethod
          :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
           Retry-After header is present.
          :return: An instance of LROPoller that returns either ApiManagementServiceResource or the
           result of cls(response)
          :rtype:
           ~azure.core.polling.LROPoller[~api_management_client.models.ApiManagementServiceResource]
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
          polling = kwargs.pop('polling', True)  # type: Union[bool, azure.core.polling.PollingMethod]
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceResource"]
          lro_delay = kwargs.pop(
              'polling_interval',
              self._config.polling_interval
          )
          cont_token = kwargs.pop('continuation_token', None)  # type: Optional[str]
          if cont_token is None:
              raw_result = self._restore_initial(
                  resource_group_name=resource_group_name,
                  service_name=service_name,
                  parameters=parameters,
                  content_type=content_type,
                  cls=lambda x,y,z: x,
                  **kwargs
              )
          kwargs.pop('error_map', None)
  
          def get_long_running_output(pipeline_response):
              response = pipeline_response.http_response
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
              if cls:
                  return cls(pipeline_response, deserialized, {})
              return deserialized
  
  
          if polling is True: polling_method = ARMPolling(lro_delay, lro_options={'final-state-via': 'location'}, **kwargs)
          elif polling is False: polling_method = NoPolling()
          else: polling_method = polling
          if cont_token:
              return LROPoller.from_continuation_token(
                  polling_method=polling_method,
                  continuation_token=cont_token,
                  client=self._client,
                  deserialization_callback=get_long_running_output
              )
          else:
              return LROPoller(self._client, raw_result, get_long_running_output, polling_method)
  
      begin_restore.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/restore'}  # type: ignore
  
      def _backup_initial(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: "_models.ApiManagementServiceBackupRestoreParameters",
          **kwargs: Any
      ) -> Optional["_models.ApiManagementServiceResource"]:
          cls = kwargs.pop('cls', None)  # type: ClsType[Optional["_models.ApiManagementServiceResource"]]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
  
          _json = self._serialize.body(parameters, 'ApiManagementServiceBackupRestoreParameters')
  
          request = build_backup_request_initial(
              resource_group_name=resource_group_name,
              service_name=service_name,
              subscription_id=self._config.subscription_id,
              content_type=content_type,
              json=_json,
              template_url=self._backup_initial.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200, 202]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              raise HttpResponseError(response=response, error_format=ARMErrorFormat)
  
          deserialized = None
          if response.status_code == 200:
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      _backup_initial.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backup'}  # type: ignore
  
  
      @distributed_trace
      def begin_backup(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: "_models.ApiManagementServiceBackupRestoreParameters",
          **kwargs: Any
      ) -> LROPoller["_models.ApiManagementServiceResource"]:
          """Creates a backup of the API Management service to the given Azure Storage Account. This is long
          running operation and could take several minutes to complete.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :param service_name: The name of the API Management service.
          :type service_name: str
          :param parameters: Parameters supplied to the ApiManagementService_Backup operation.
          :type parameters: ~api_management_client.models.ApiManagementServiceBackupRestoreParameters
          :keyword callable cls: A custom type or function that will be passed the direct response
          :keyword str continuation_token: A continuation token to restart a poller from a saved state.
          :keyword polling: By default, your polling method will be ARMPolling. Pass in False for this
           operation to not poll, or pass in your own initialized polling object for a personal polling
           strategy.
          :paramtype polling: bool or ~azure.core.polling.PollingMethod
          :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
           Retry-After header is present.
          :return: An instance of LROPoller that returns either ApiManagementServiceResource or the
           result of cls(response)
          :rtype:
           ~azure.core.polling.LROPoller[~api_management_client.models.ApiManagementServiceResource]
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
          polling = kwargs.pop('polling', True)  # type: Union[bool, azure.core.polling.PollingMethod]
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceResource"]
          lro_delay = kwargs.pop(
              'polling_interval',
              self._config.polling_interval
          )
          cont_token = kwargs.pop('continuation_token', None)  # type: Optional[str]
          if cont_token is None:
              raw_result = self._backup_initial(
                  resource_group_name=resource_group_name,
                  service_name=service_name,
                  parameters=parameters,
                  content_type=content_type,
                  cls=lambda x,y,z: x,
                  **kwargs
              )
          kwargs.pop('error_map', None)
  
          def get_long_running_output(pipeline_response):
              response = pipeline_response.http_response
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
              if cls:
                  return cls(pipeline_response, deserialized, {})
              return deserialized
  
  
          if polling is True: polling_method = ARMPolling(lro_delay, lro_options={'final-state-via': 'location'}, **kwargs)
          elif polling is False: polling_method = NoPolling()
          else: polling_method = polling
          if cont_token:
              return LROPoller.from_continuation_token(
                  polling_method=polling_method,
                  continuation_token=cont_token,
                  client=self._client,
                  deserialization_callback=get_long_running_output
              )
          else:
              return LROPoller(self._client, raw_result, get_long_running_output, polling_method)
  
      begin_backup.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backup'}  # type: ignore
  
      def _create_or_update_initial(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: "_models.ApiManagementServiceResource",
          **kwargs: Any
      ) -> Optional["_models.ApiManagementServiceResource"]:
          cls = kwargs.pop('cls', None)  # type: ClsType[Optional["_models.ApiManagementServiceResource"]]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
  
          _json = self._serialize.body(parameters, 'ApiManagementServiceResource')
  
          request = build_create_or_update_request_initial(
              resource_group_name=resource_group_name,
              service_name=service_name,
              subscription_id=self._config.subscription_id,
              content_type=content_type,
              json=_json,
              template_url=self._create_or_update_initial.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200, 201, 202]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              raise HttpResponseError(response=response, error_format=ARMErrorFormat)
  
          deserialized = None
          if response.status_code == 200:
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
  
          if response.status_code == 201:
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      _create_or_update_initial.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}'}  # type: ignore
  
  
      @distributed_trace
      def begin_create_or_update(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: "_models.ApiManagementServiceResource",
          **kwargs: Any
      ) -> LROPoller["_models.ApiManagementServiceResource"]:
          """Creates or updates an API Management service. This is long running operation and could take
          several minutes to complete.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :param service_name: The name of the API Management service.
          :type service_name: str
          :param parameters: Parameters supplied to the CreateOrUpdate API Management service operation.
          :type parameters: ~api_management_client.models.ApiManagementServiceResource
          :keyword callable cls: A custom type or function that will be passed the direct response
          :keyword str continuation_token: A continuation token to restart a poller from a saved state.
          :keyword polling: By default, your polling method will be ARMPolling. Pass in False for this
           operation to not poll, or pass in your own initialized polling object for a personal polling
           strategy.
          :paramtype polling: bool or ~azure.core.polling.PollingMethod
          :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
           Retry-After header is present.
          :return: An instance of LROPoller that returns either ApiManagementServiceResource or the
           result of cls(response)
          :rtype:
           ~azure.core.polling.LROPoller[~api_management_client.models.ApiManagementServiceResource]
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
          polling = kwargs.pop('polling', True)  # type: Union[bool, azure.core.polling.PollingMethod]
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceResource"]
          lro_delay = kwargs.pop(
              'polling_interval',
              self._config.polling_interval
          )
          cont_token = kwargs.pop('continuation_token', None)  # type: Optional[str]
          if cont_token is None:
              raw_result = self._create_or_update_initial(
                  resource_group_name=resource_group_name,
                  service_name=service_name,
                  parameters=parameters,
                  content_type=content_type,
                  cls=lambda x,y,z: x,
                  **kwargs
              )
          kwargs.pop('error_map', None)
  
          def get_long_running_output(pipeline_response):
              response = pipeline_response.http_response
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
              if cls:
                  return cls(pipeline_response, deserialized, {})
              return deserialized
  
  
          if polling is True: polling_method = ARMPolling(lro_delay, **kwargs)
          elif polling is False: polling_method = NoPolling()
          else: polling_method = polling
          if cont_token:
              return LROPoller.from_continuation_token(
                  polling_method=polling_method,
                  continuation_token=cont_token,
                  client=self._client,
                  deserialization_callback=get_long_running_output
              )
          else:
              return LROPoller(self._client, raw_result, get_long_running_output, polling_method)
  
      begin_create_or_update.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}'}  # type: ignore
  
      def _update_initial(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: "_models.ApiManagementServiceUpdateParameters",
          **kwargs: Any
      ) -> Optional["_models.ApiManagementServiceResource"]:
          cls = kwargs.pop('cls', None)  # type: ClsType[Optional["_models.ApiManagementServiceResource"]]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
  
          _json = self._serialize.body(parameters, 'ApiManagementServiceUpdateParameters')
  
          request = build_update_request_initial(
              resource_group_name=resource_group_name,
              service_name=service_name,
              subscription_id=self._config.subscription_id,
              content_type=content_type,
              json=_json,
              template_url=self._update_initial.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200, 202]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              raise HttpResponseError(response=response, error_format=ARMErrorFormat)
  
          deserialized = None
          if response.status_code == 200:
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      _update_initial.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}'}  # type: ignore
  
  
      @distributed_trace
      def begin_update(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: "_models.ApiManagementServiceUpdateParameters",
          **kwargs: Any
      ) -> LROPoller["_models.ApiManagementServiceResource"]:
          """Updates an existing API Management service.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :param service_name: The name of the API Management service.
          :type service_name: str
          :param parameters: Parameters supplied to the CreateOrUpdate API Management service operation.
          :type parameters: ~api_management_client.models.ApiManagementServiceUpdateParameters
          :keyword callable cls: A custom type or function that will be passed the direct response
          :keyword str continuation_token: A continuation token to restart a poller from a saved state.
          :keyword polling: By default, your polling method will be ARMPolling. Pass in False for this
           operation to not poll, or pass in your own initialized polling object for a personal polling
           strategy.
          :paramtype polling: bool or ~azure.core.polling.PollingMethod
          :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
           Retry-After header is present.
          :return: An instance of LROPoller that returns either ApiManagementServiceResource or the
           result of cls(response)
          :rtype:
           ~azure.core.polling.LROPoller[~api_management_client.models.ApiManagementServiceResource]
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
          polling = kwargs.pop('polling', True)  # type: Union[bool, azure.core.polling.PollingMethod]
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceResource"]
          lro_delay = kwargs.pop(
              'polling_interval',
              self._config.polling_interval
          )
          cont_token = kwargs.pop('continuation_token', None)  # type: Optional[str]
          if cont_token is None:
              raw_result = self._update_initial(
                  resource_group_name=resource_group_name,
                  service_name=service_name,
                  parameters=parameters,
                  content_type=content_type,
                  cls=lambda x,y,z: x,
                  **kwargs
              )
          kwargs.pop('error_map', None)
  
          def get_long_running_output(pipeline_response):
              response = pipeline_response.http_response
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
              if cls:
                  return cls(pipeline_response, deserialized, {})
              return deserialized
  
  
          if polling is True: polling_method = ARMPolling(lro_delay, **kwargs)
          elif polling is False: polling_method = NoPolling()
          else: polling_method = polling
          if cont_token:
              return LROPoller.from_continuation_token(
                  polling_method=polling_method,
                  continuation_token=cont_token,
                  client=self._client,
                  deserialization_callback=get_long_running_output
              )
          else:
              return LROPoller(self._client, raw_result, get_long_running_output, polling_method)
  
      begin_update.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}'}  # type: ignore
  
      @distributed_trace
      def get(
          self,
          resource_group_name: str,
          service_name: str,
          **kwargs: Any
      ) -> "_models.ApiManagementServiceResource":
          """Gets an API Management service resource description.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :param service_name: The name of the API Management service.
          :type service_name: str
          :keyword callable cls: A custom type or function that will be passed the direct response
          :return: ApiManagementServiceResource, or the result of cls(response)
          :rtype: ~api_management_client.models.ApiManagementServiceResource
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceResource"]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          
          request = build_get_request(
              resource_group_name=resource_group_name,
              service_name=service_name,
              subscription_id=self._config.subscription_id,
              template_url=self.get.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              error = self._deserialize.failsafe_deserialize(_models.ErrorResponse, pipeline_response)
              raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat)
  
          deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      get.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}'}  # type: ignore
  
  
      def _delete_initial(
          self,
          resource_group_name: str,
          service_name: str,
          **kwargs: Any
      ) -> Optional["_models.ApiManagementServiceResource"]:
          cls = kwargs.pop('cls', None)  # type: ClsType[Optional["_models.ApiManagementServiceResource"]]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          
          request = build_delete_request_initial(
              resource_group_name=resource_group_name,
              service_name=service_name,
              subscription_id=self._config.subscription_id,
              template_url=self._delete_initial.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200, 202, 204]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              raise HttpResponseError(response=response, error_format=ARMErrorFormat)
  
          deserialized = None
          if response.status_code == 202:
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      _delete_initial.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}'}  # type: ignore
  
  
      @distributed_trace
      def begin_delete(
          self,
          resource_group_name: str,
          service_name: str,
          **kwargs: Any
      ) -> LROPoller["_models.ApiManagementServiceResource"]:
          """Deletes an existing API Management service.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :param service_name: The name of the API Management service.
          :type service_name: str
          :keyword callable cls: A custom type or function that will be passed the direct response
          :keyword str continuation_token: A continuation token to restart a poller from a saved state.
          :keyword polling: By default, your polling method will be ARMPolling. Pass in False for this
           operation to not poll, or pass in your own initialized polling object for a personal polling
           strategy.
          :paramtype polling: bool or ~azure.core.polling.PollingMethod
          :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
           Retry-After header is present.
          :return: An instance of LROPoller that returns either ApiManagementServiceResource or the
           result of cls(response)
          :rtype:
           ~azure.core.polling.LROPoller[~api_management_client.models.ApiManagementServiceResource]
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          polling = kwargs.pop('polling', True)  # type: Union[bool, azure.core.polling.PollingMethod]
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceResource"]
          lro_delay = kwargs.pop(
              'polling_interval',
              self._config.polling_interval
          )
          cont_token = kwargs.pop('continuation_token', None)  # type: Optional[str]
          if cont_token is None:
              raw_result = self._delete_initial(
                  resource_group_name=resource_group_name,
                  service_name=service_name,
                  cls=lambda x,y,z: x,
                  **kwargs
              )
          kwargs.pop('error_map', None)
  
          def get_long_running_output(pipeline_response):
              response = pipeline_response.http_response
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
              if cls:
                  return cls(pipeline_response, deserialized, {})
              return deserialized
  
  
          if polling is True: polling_method = ARMPolling(lro_delay, **kwargs)
          elif polling is False: polling_method = NoPolling()
          else: polling_method = polling
          if cont_token:
              return LROPoller.from_continuation_token(
                  polling_method=polling_method,
                  continuation_token=cont_token,
                  client=self._client,
                  deserialization_callback=get_long_running_output
              )
          else:
              return LROPoller(self._client, raw_result, get_long_running_output, polling_method)
  
      begin_delete.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}'}  # type: ignore
  
      @distributed_trace
      def list_by_resource_group(
          self,
          resource_group_name: str,
          **kwargs: Any
      ) -> Iterable["_models.ApiManagementServiceListResult"]:
          """List all API Management services within a resource group.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :keyword callable cls: A custom type or function that will be passed the direct response
          :return: An iterator like instance of either ApiManagementServiceListResult or the result of
           cls(response)
          :rtype:
           ~azure.core.paging.ItemPaged[~api_management_client.models.ApiManagementServiceListResult]
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceListResult"]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
          def prepare_request(next_link=None):
              if not next_link:
                  
                  request = build_list_by_resource_group_request(
                      resource_group_name=resource_group_name,
                      subscription_id=self._config.subscription_id,
                      template_url=self.list_by_resource_group.metadata['url'],
                  )
                  request = _convert_request(request)
                  request.url = self._client.format_url(request.url)
  
              else:
                  
                  request = build_list_by_resource_group_request(
                      resource_group_name=resource_group_name,
                      subscription_id=self._config.subscription_id,
                      template_url=next_link,
                  )
                  request = _convert_request(request)
                  request.url = self._client.format_url(request.url)
                  request.method = "GET"
              return request
  
          def extract_data(pipeline_response):
              deserialized = self._deserialize("ApiManagementServiceListResult", pipeline_response)
              list_of_elem = deserialized.value
              if cls:
                  list_of_elem = cls(list_of_elem)
              return deserialized.next_link or None, iter(list_of_elem)
  
          def get_next(next_link=None):
              request = prepare_request(next_link)
  
              pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
              response = pipeline_response.http_response
  
              if response.status_code not in [200]:
                  map_error(status_code=response.status_code, response=response, error_map=error_map)
                  error = self._deserialize.failsafe_deserialize(_models.ErrorResponse, pipeline_response)
                  raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat)
  
              return pipeline_response
  
  
          return ItemPaged(
              get_next, extract_data
          )
      list_by_resource_group.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service'}  # type: ignore
  
      @distributed_trace
      def list(
          self,
          **kwargs: Any
      ) -> Iterable["_models.ApiManagementServiceListResult"]:
          """Lists all API Management services within an Azure subscription.
  
          :keyword callable cls: A custom type or function that will be passed the direct response
          :return: An iterator like instance of either ApiManagementServiceListResult or the result of
           cls(response)
          :rtype:
           ~azure.core.paging.ItemPaged[~api_management_client.models.ApiManagementServiceListResult]
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceListResult"]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
          def prepare_request(next_link=None):
              if not next_link:
                  
                  request = build_list_request(
                      subscription_id=self._config.subscription_id,
                      template_url=self.list.metadata['url'],
                  )
                  request = _convert_request(request)
                  request.url = self._client.format_url(request.url)
  
              else:
                  
                  request = build_list_request(
                      subscription_id=self._config.subscription_id,
                      template_url=next_link,
                  )
                  request = _convert_request(request)
                  request.url = self._client.format_url(request.url)
                  request.method = "GET"
              return request
  
          def extract_data(pipeline_response):
              deserialized = self._deserialize("ApiManagementServiceListResult", pipeline_response)
              list_of_elem = deserialized.value
              if cls:
                  list_of_elem = cls(list_of_elem)
              return deserialized.next_link or None, iter(list_of_elem)
  
          def get_next(next_link=None):
              request = prepare_request(next_link)
  
              pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
              response = pipeline_response.http_response
  
              if response.status_code not in [200]:
                  map_error(status_code=response.status_code, response=response, error_map=error_map)
                  error = self._deserialize.failsafe_deserialize(_models.ErrorResponse, pipeline_response)
                  raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat)
  
              return pipeline_response
  
  
          return ItemPaged(
              get_next, extract_data
          )
      list.metadata = {'url': '/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/service'}  # type: ignore
  
      @distributed_trace
      def get_sso_token(
          self,
          resource_group_name: str,
          service_name: str,
          **kwargs: Any
      ) -> "_models.ApiManagementServiceGetSsoTokenResult":
          """Gets the Single-Sign-On token for the API Management Service which is valid for 5 Minutes.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :param service_name: The name of the API Management service.
          :type service_name: str
          :keyword callable cls: A custom type or function that will be passed the direct response
          :return: ApiManagementServiceGetSsoTokenResult, or the result of cls(response)
          :rtype: ~api_management_client.models.ApiManagementServiceGetSsoTokenResult
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceGetSsoTokenResult"]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          
          request = build_get_sso_token_request(
              resource_group_name=resource_group_name,
              service_name=service_name,
              subscription_id=self._config.subscription_id,
              template_url=self.get_sso_token.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              error = self._deserialize.failsafe_deserialize(_models.ErrorResponse, pipeline_response)
              raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat)
  
          deserialized = self._deserialize('ApiManagementServiceGetSsoTokenResult', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      get_sso_token.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/getssotoken'}  # type: ignore
  
  
      @distributed_trace
      def check_name_availability(
          self,
          parameters: "_models.ApiManagementServiceCheckNameAvailabilityParameters",
          **kwargs: Any
      ) -> "_models.ApiManagementServiceNameAvailabilityResult":
          """Checks availability and correctness of a name for an API Management service.
  
          :param parameters: Parameters supplied to the CheckNameAvailability operation.
          :type parameters:
           ~api_management_client.models.ApiManagementServiceCheckNameAvailabilityParameters
          :keyword callable cls: A custom type or function that will be passed the direct response
          :return: ApiManagementServiceNameAvailabilityResult, or the result of cls(response)
          :rtype: ~api_management_client.models.ApiManagementServiceNameAvailabilityResult
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceNameAvailabilityResult"]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
  
          _json = self._serialize.body(parameters, 'ApiManagementServiceCheckNameAvailabilityParameters')
  
          request = build_check_name_availability_request(
              subscription_id=self._config.subscription_id,
              content_type=content_type,
              json=_json,
              template_url=self.check_name_availability.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              error = self._deserialize.failsafe_deserialize(_models.ErrorResponse, pipeline_response)
              raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat)
  
          deserialized = self._deserialize('ApiManagementServiceNameAvailabilityResult', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      check_name_availability.metadata = {'url': '/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/checkNameAvailability'}  # type: ignore
  
  
      @distributed_trace
      def get_domain_ownership_identifier(
          self,
          **kwargs: Any
      ) -> "_models.ApiManagementServiceGetDomainOwnershipIdentifierResult":
          """Get the custom domain ownership identifier for an API Management service.
  
          :keyword callable cls: A custom type or function that will be passed the direct response
          :return: ApiManagementServiceGetDomainOwnershipIdentifierResult, or the result of cls(response)
          :rtype: ~api_management_client.models.ApiManagementServiceGetDomainOwnershipIdentifierResult
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceGetDomainOwnershipIdentifierResult"]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          
          request = build_get_domain_ownership_identifier_request(
              subscription_id=self._config.subscription_id,
              template_url=self.get_domain_ownership_identifier.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              error = self._deserialize.failsafe_deserialize(_models.ErrorResponse, pipeline_response)
              raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat)
  
          deserialized = self._deserialize('ApiManagementServiceGetDomainOwnershipIdentifierResult', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      get_domain_ownership_identifier.metadata = {'url': '/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/getDomainOwnershipIdentifier'}  # type: ignore
  
  
      def _apply_network_configuration_updates_initial(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: Optional["_models.ApiManagementServiceApplyNetworkConfigurationParameters"] = None,
          **kwargs: Any
      ) -> Optional["_models.ApiManagementServiceResource"]:
          cls = kwargs.pop('cls', None)  # type: ClsType[Optional["_models.ApiManagementServiceResource"]]
          error_map = {
              401: ClientAuthenticationError, 404: ResourceNotFoundError, 409: ResourceExistsError
          }
          error_map.update(kwargs.pop('error_map', {}))
  
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
  
          if parameters is not None:
              _json = self._serialize.body(parameters, 'ApiManagementServiceApplyNetworkConfigurationParameters')
          else:
              _json = None
  
          request = build_apply_network_configuration_updates_request_initial(
              resource_group_name=resource_group_name,
              service_name=service_name,
              subscription_id=self._config.subscription_id,
              content_type=content_type,
              json=_json,
              template_url=self._apply_network_configuration_updates_initial.metadata['url'],
          )
          request = _convert_request(request)
          request.url = self._client.format_url(request.url)
  
          pipeline_response = self._client._pipeline.run(request, stream=False, **kwargs)
          response = pipeline_response.http_response
  
          if response.status_code not in [200, 202]:
              map_error(status_code=response.status_code, response=response, error_map=error_map)
              raise HttpResponseError(response=response, error_format=ARMErrorFormat)
  
          deserialized = None
          if response.status_code == 200:
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
  
          if cls:
              return cls(pipeline_response, deserialized, {})
  
          return deserialized
  
      _apply_network_configuration_updates_initial.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/applynetworkconfigurationupdates'}  # type: ignore
  
  
      @distributed_trace
      def begin_apply_network_configuration_updates(
          self,
          resource_group_name: str,
          service_name: str,
          parameters: Optional["_models.ApiManagementServiceApplyNetworkConfigurationParameters"] = None,
          **kwargs: Any
      ) -> LROPoller["_models.ApiManagementServiceResource"]:
          """Updates the Microsoft.ApiManagement resource running in the Virtual network to pick the updated
          DNS changes.
  
          :param resource_group_name: The name of the resource group.
          :type resource_group_name: str
          :param service_name: The name of the API Management service.
          :type service_name: str
          :param parameters: Parameters supplied to the Apply Network Configuration operation. If the
           parameters are empty, all the regions in which the Api Management service is deployed will be
           updated sequentially without incurring downtime in the region.
          :type parameters:
           ~api_management_client.models.ApiManagementServiceApplyNetworkConfigurationParameters
          :keyword callable cls: A custom type or function that will be passed the direct response
          :keyword str continuation_token: A continuation token to restart a poller from a saved state.
          :keyword polling: By default, your polling method will be ARMPolling. Pass in False for this
           operation to not poll, or pass in your own initialized polling object for a personal polling
           strategy.
          :paramtype polling: bool or ~azure.core.polling.PollingMethod
          :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
           Retry-After header is present.
          :return: An instance of LROPoller that returns either ApiManagementServiceResource or the
           result of cls(response)
          :rtype:
           ~azure.core.polling.LROPoller[~api_management_client.models.ApiManagementServiceResource]
          :raises: ~azure.core.exceptions.HttpResponseError
          """
          content_type = kwargs.pop('content_type', "application/json")  # type: Optional[str]
          polling = kwargs.pop('polling', True)  # type: Union[bool, azure.core.polling.PollingMethod]
          cls = kwargs.pop('cls', None)  # type: ClsType["_models.ApiManagementServiceResource"]
          lro_delay = kwargs.pop(
              'polling_interval',
              self._config.polling_interval
          )
          cont_token = kwargs.pop('continuation_token', None)  # type: Optional[str]
          if cont_token is None:
              raw_result = self._apply_network_configuration_updates_initial(
                  resource_group_name=resource_group_name,
                  service_name=service_name,
                  parameters=parameters,
                  content_type=content_type,
                  cls=lambda x,y,z: x,
                  **kwargs
              )
          kwargs.pop('error_map', None)
  
          def get_long_running_output(pipeline_response):
              response = pipeline_response.http_response
              deserialized = self._deserialize('ApiManagementServiceResource', pipeline_response)
              if cls:
                  return cls(pipeline_response, deserialized, {})
              return deserialized
  
  
          if polling is True: polling_method = ARMPolling(lro_delay, lro_options={'final-state-via': 'location'}, **kwargs)
          elif polling is False: polling_method = NoPolling()
          else: polling_method = polling
          if cont_token:
              return LROPoller.from_continuation_token(
                  polling_method=polling_method,
                  continuation_token=cont_token,
                  client=self._client,
                  deserialization_callback=get_long_running_output
              )
          else:
              return LROPoller(self._client, raw_result, get_long_running_output, polling_method)
  
      begin_apply_network_configuration_updates.metadata = {'url': '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/applynetworkconfigurationupdates'}  # type: ignore
  