swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector generateThumbnail API
schemes:
- https
tags:
- name: generateThumbnail
paths:
  /generateThumbnail:
    post:
      description: This operation generates a thumbnail image with the user-specified width and height. By default, the service analyzes the image, identifies the region of interest (ROI), and generates smart cropping coordinates based on the ROI. Smart cropping helps when you specify an aspect ratio that differs from that of the input image. A successful response contains the thumbnail image binary. If the request failed, the response contains an error code and a message to help determine what went wrong.
      operationId: microsoftAzureGeneratethumbnail
      consumes:
      - application/json
      produces:
      - application/octet-stream
      parameters:
      - name: width
        type: integer
        in: query
        required: true
        minimum: 1
        maximum: 1023
        description: Width of the thumbnail. It must be between 1 and 1024. Recommended minimum of 50.
      - name: height
        type: integer
        in: query
        required: true
        minimum: 1
        maximum: 1023
        description: Height of the thumbnail. It must be between 1 and 1024. Recommended minimum of 50.
      - $ref: ../../../Common/Parameters.json#/parameters/ImageUrl
      - name: smartCropping
        type: boolean
        in: query
        required: false
        default: false
        description: Boolean flag for enabling smart cropping.
      responses:
        '200':
          description: The generated thumbnail in binary format.
          schema:
            type: file
        default:
          description: Error response.
          schema:
            $ref: '#/definitions/ComputerVisionError'
      x-ms-examples:
        Successful Generate Thumbnail request:
          $ref: ./examples/SuccessfulGenerateThumbnailWithUrl.json
      summary: Microsoft Azure Post Generatethumbnail
      tags:
      - generateThumbnail
definitions:
  ComputerVisionError:
    type: object
    required:
    - code
    - message
    properties:
      code:
        type: string
        description: The error code.
        enum:
        - InvalidImageUrl
        - InvalidImageFormat
        - InvalidImageSize
        - NotSupportedVisualFeature
        - NotSupportedImage
        - InvalidDetails
        - NotSupportedLanguage
        - BadArgument
        - FailedToProcess
        - Timeout
        - InternalServerError
        - Unspecified
        - StorageException
        x-ms-enum:
          name: ComputerVisionErrorCodes
          modelAsString: false
      message:
        type: string
        description: A message explaining the error reported by the service.
      requestId:
        type: string
        description: A unique request identifier.
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'