###############################  Query  ####################################

action_id_path:
  type: string
  in: query
  required: true
  description: |
    The action UUID.

backup_id_path:
  type: string
  in: query
  required: true
  description: |
    The UUID of the backup.

client_id_path:
  type: string
  in: query
  required: true
  description: |
    The client ID.

job_id_path:
  type: string
  in: query
  required: true
  description: |
    The job UUID.

limit:
  description: |
    Requests a page size of items. Returns a number of items up to a limit
    value. Use the ``limit`` parameter to make an initial limited request and
    use the ID of the last-seen item from the response as the ``marker``
    parameter value in a subsequent limited request.
  in: query
  required: false
  type: integer

marker:
  description: |
    The ID of the last-seen item. Use the ``limit`` parameter to make an
    initial limited request and use the ID of the last-seen item from the
    response as the ``marker`` parameter value in a subsequent limited request.
  in: query
  required: false
  type: string

session_id_path:
  type: string
  in: query
  required: true
  description: |
    The session UUID.

###############################  Body  ####################################

action_id:
  type: string
  in: body
  required: true
  description: |
    The action UUID.

actions:
  type: list
  in: body
  required: true
  description: |
    A list of actions.

backup_id:
  type: string
  in: body
  required: true
  description: |
    The UUID of the backup.

backup_metadata:
  type: list
  in: body
  required: true
  description: |
    A list of backup metada information. This contains the backup details.
    like ``path_to_backup``, ``backup_name``, ``hostname``, ``job_id``,
    ``storage``, ...

backups:
  type: list
  in: body
  description: |
    A list of backups.

client_id:
  type: string
  in: body
  required: true
  description: |
    The client UUID.

clients:
  type: list
  in: body
  required: true
  description: |
    A list of clients.

freezer_action:
  type: dict
  in: body
  required: true
  description: |
    Action parameters. It depends on the actual action (backup, restore,
    admin, info) so the parameters differ.

hostname:
  type: string
  in: body
  required: true
  description: |
    The hostname of the machine that client is running on.

job_actions_req:
  type: list
  in: body
  required: true
  description: |
    A list of actions that carry out the backup/restore job.

job_description_req:
  type: string
  in: body
  required: true
  description: |
    The name of the job.

job_id:
  type: string
  in: body
  required: true
  description: |
    The job UUID.

job_schedule_req:
  type: dict
  in: body
  required: true
  description: |
    The schedule information of the job.

jobs:
  type: list
  in: body
  description: |
    A list of jobs.

max_retries:
  type: int
  in: body
  description: |
    A number of times freezer should retry to execute the action.

max_retries_interval:
  type: int
  in: body
  description: |
    The time that freezer should wait between diferrent retrials to execute
    the action.

result:
  type: string
  in: body
  description: |
    A string represents if the operation was successful ``success`` or failed.

search_option:
  type: dict
  in: body
  required: false
  description: |
     The query option of list. It is a JSON structure. It contains the keywords
     ``match``, ``match_not``, or one of the two. The values about keys
     ``match`` and ``match_not`` are a list of {key, value}.

session_description:
  type: string
  in: body
  required: true
  description: |
    A description of the session.

session_event:
  type: string
  in: body
  description: |
    The event is being used to start or stop a session.

session_hold_off:
  type: int
  in: body
  required: true
  description: |
    Amount of time to wait before re-running the same session again.

session_id:
  type: string
  in: body
  required: true
  description: |
    The session UUID.

session_schedule:
  type: dict
  in: body
  required: true
  description: |
    A dictionary that holds the session secheduling information. It's the
    same like job_schedule. it contains ``schedule_interval``, ``status``
    and ``event``.

session_schedule_internval:
  type: string
  in: body
  description: |
    The scheduling information of the session. for examples "2 hours" it
    means the session will be executed every 2 hours.

session_status:
  type: string
  in: body
  description: |
    The status of the session. Default is ``active``.

session_tag:
  type: string
  in: body
  required: true
  description: |
    The event is being used to start or stop a session.

sessions:
  type: list
  in: body
  description: |
    A list of existing sessions.

user_id:
  type: string
  in: body
  required: true
  description: |
    The user UUID.

username:
  type: string
  in: body
  required: true
  description: |
    The username.

uuid:
  type: string
  in: body
  required: true
  description: |
    The client UUID.

version_doc:
  type: int
  in: body
  required: true
  description: |
    The document version.

versions:
  type: list
  in: body
  required: True
  description: |
    A list of supported major API versions.