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.
  # --------------------------------------------------------------------------------------------
  
  from knack.help_files import helps  # pylint: disable=unused-import
  
  
  helps['apim'] = """
      type: group
      short-summary: Manage Azure API Management services.
  """
  
  helps['apim create'] = """
  type: command
  short-summary: Create an API Management service instance.
  parameters:
      -   name: --name -n
          type: string
          short-summary: unique name of the service instance to be created
          long-summary: |
              The name must be globally unique since it will be included as the gateway
              hostname like' https://my-api-servicename.azure-api.net'.  See examples.
  examples:
      - name: Create a Developer tier API Management service.
        text: |-
          az apim create --name MyApim -g MyResourceGroup -l eastus --publisher-email email@mydomain.com --publisher-name Microsoft
      - name: Create a Consumption tier API Management service.
        text: |-
          az apim create --name MyApim -g MyResourceGroup -l eastus --sku-name Consumption --enable-client-certificate \\
              --publisher-email email@mydomain.com --publisher-name Microsoft
  """
  
  helps['apim list'] = """
      type: command
      short-summary: List API Management service instances.
  """
  
  helps['apim delete'] = """
  type: command
  short-summary: Deletes an API Management service.
  examples:
    - name: Delete an API Management service.
      text: >
          az apim delete -n MyApim -g MyResourceGroup
  """
  
  helps['apim show'] = """
      type: command
      short-summary: Show details of an API Management service instance.
  """
  
  helps['apim update'] = """
      type: command
      short-summary: Update an API Management service instance.
  """
  
  helps['apim backup'] = """
      type: command
      short-summary: 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.
  """
  