openapi: 3.0.0
info:
  version: '2017-11-27'
  x-release: v4
  title: 'Amazon Comprehend #X Amz Target=Comprehend 20171127.BatchDetectDominantLanguage #X Amz Target=Comprehend 20171127.BatchDetectDominantLanguage #X Amz Target=Comprehend 20171127.ListFlywheelIterationHistory API'
  description: Amazon Comprehend is an Amazon Web Services service for gaining insight into the content of documents. Use these actions to determine the topics contained in your documents, the topics they discuss, the predominant sentiment expressed in them, the predominant language used, and more.
  x-logo:
    url: https://twitter.com/awscloud/profile_image?size=original
    backgroundColor: '#FFFFFF'
  termsOfService: https://aws.amazon.com/service-terms/
  contact:
    name: Mike Ralphson
    email: mike.ralphson@gmail.com
    url: https://github.com/mermade/aws2openapi
    x-twitter: PermittedSoc
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/
  x-providerName: amazonaws.com
  x-serviceName: comprehend
  x-aws-signingName: comprehend
  x-origin:
  - contentType: application/json
    url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/comprehend-2017-11-27.normal.json
    converter:
      url: https://github.com/mermade/aws2openapi
      version: 1.0.0
    x-apisguru-driver: external
  x-apiClientRegistration:
    url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
  x-apisguru-categories:
  - cloud
  x-preferred: true
servers:
- url: http://comprehend.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon Comprehend multi-region endpoint
- url: https://comprehend.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon Comprehend multi-region endpoint
- url: http://comprehend.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon Comprehend endpoint for China (Beijing) and China (Ningxia)
- url: https://comprehend.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon Comprehend endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: '#X Amz Target=Comprehend 20171127.ListFlywheelIterationHistory'
paths:
  /#X-Amz-Target=Comprehend_20171127.ListFlywheelIterationHistory:
    parameters:
    - $ref: '#/components/parameters/X-Amz-Content-Sha256'
    - $ref: '#/components/parameters/X-Amz-Date'
    - $ref: '#/components/parameters/X-Amz-Algorithm'
    - $ref: '#/components/parameters/X-Amz-Credential'
    - $ref: '#/components/parameters/X-Amz-Security-Token'
    - $ref: '#/components/parameters/X-Amz-Signature'
    - $ref: '#/components/parameters/X-Amz-SignedHeaders'
    post:
      operationId: ListFlywheelIterationHistory
      description: Information about the history of a flywheel iteration. For more information about flywheels, see <a href="https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html"> Flywheel overview</a> in the <i>Amazon Comprehend Developer Guide</i>.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFlywheelIterationHistoryResponse'
              examples:
                ListFlywheelIterationHistory200Example:
                  summary: Default ListFlywheelIterationHistory 200
                  x-microcks-default: true
                  value:
                    FlywheelIterationPropertiesList: example
                    NextToken: example
        '480':
          description: InvalidRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidRequestException'
              examples:
                ListFlywheelIterationHistory480Example:
                  summary: Default ListFlywheelIterationHistory 480
                  x-microcks-default: true
                  value: example
        '481':
          description: TooManyRequestsException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsException'
              examples:
                ListFlywheelIterationHistory481Example:
                  summary: Default ListFlywheelIterationHistory 481
                  x-microcks-default: true
                  value: example
        '482':
          description: InvalidFilterException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidFilterException'
              examples:
                ListFlywheelIterationHistory482Example:
                  summary: Default ListFlywheelIterationHistory 482
                  x-microcks-default: true
                  value: example
        '483':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
              examples:
                ListFlywheelIterationHistory483Example:
                  summary: Default ListFlywheelIterationHistory 483
                  x-microcks-default: true
                  value: example
        '484':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
              examples:
                ListFlywheelIterationHistory484Example:
                  summary: Default ListFlywheelIterationHistory 484
                  x-microcks-default: true
                  value: example
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFlywheelIterationHistoryRequest'
      parameters:
      - name: MaxResults
        in: query
        schema:
          type: string
        description: Pagination limit
        required: false
      - name: NextToken
        in: query
        schema:
          type: string
        description: Pagination token
        required: false
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - Comprehend_20171127.ListFlywheelIterationHistory
      summary: Amazon Comprehend List Flywheel Iteration History
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      tags:
      - '#X Amz Target=Comprehend 20171127.ListFlywheelIterationHistory'
components:
  schemas:
    ComprehendModelArn:
      type: string
      pattern: arn:aws(-[^:]+)?:comprehend:[a-zA-Z0-9-]*:[0-9]{12}:(document-classifier|entity-recognizer)/[a-zA-Z0-9](-*[a-zA-Z0-9])*(/version/[a-zA-Z0-9](-*[a-zA-Z0-9])*)?
      maxLength: 256
    FlywheelIterationStatus:
      type: string
      enum:
      - TRAINING
      - EVALUATING
      - COMPLETED
      - FAILED
      - STOP_REQUESTED
      - STOPPED
    ResourceNotFoundException: {}
    AnyLengthString:
      type: string
    S3Uri:
      type: string
      pattern: s3://[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9](/.*)?
      maxLength: 1024
    InvalidFilterException: {}
    ListFlywheelIterationHistoryRequest:
      type: object
      required:
      - FlywheelArn
      title: ListFlywheelIterationHistoryRequest
      properties:
        FlywheelArn:
          allOf:
          - $ref: '#/components/schemas/ComprehendFlywheelArn'
          - description: The ARN of the flywheel.
        Filter:
          allOf:
          - $ref: '#/components/schemas/FlywheelIterationFilter'
          - description: Filter the flywheel iteration history based on creation time.
        NextToken:
          allOf:
          - $ref: '#/components/schemas/String'
          - description: Next token
        MaxResults:
          allOf:
          - $ref: '#/components/schemas/MaxResultsInteger'
          - description: Maximum number of iteration history results to return
    FlywheelIterationPropertiesList:
      type: array
      items:
        $ref: '#/components/schemas/FlywheelIterationProperties'
    InvalidRequestException: {}
    String:
      type: string
      minLength: 1
    ComprehendFlywheelArn:
      type: string
      pattern: arn:aws(-[^:]+)?:comprehend:[a-zA-Z0-9-]*:[0-9]{12}:flywheel/[a-zA-Z0-9](-*[a-zA-Z0-9])*
      maxLength: 256
    Timestamp:
      type: string
      format: date-time
    Double:
      type: number
      format: double
    TooManyRequestsException: {}
    FlywheelIterationProperties:
      type: object
      properties:
        FlywheelArn:
          allOf:
          - $ref: '#/components/schemas/ComprehendFlywheelArn'
          - description: <p/>
        FlywheelIterationId:
          allOf:
          - $ref: '#/components/schemas/FlywheelIterationId'
          - description: <p/>
        CreationTime:
          allOf:
          - $ref: '#/components/schemas/Timestamp'
          - description: The creation start time of the flywheel iteration.
        EndTime:
          allOf:
          - $ref: '#/components/schemas/Timestamp'
          - description: The completion time of this flywheel iteration.
        Status:
          allOf:
          - $ref: '#/components/schemas/FlywheelIterationStatus'
          - description: The status of the flywheel iteration.
        Message:
          allOf:
          - $ref: '#/components/schemas/AnyLengthString'
          - description: A description of the status of the flywheel iteration.
        EvaluatedModelArn:
          allOf:
          - $ref: '#/components/schemas/ComprehendModelArn'
          - description: The ARN of the evaluated model associated with this flywheel iteration.
        EvaluatedModelMetrics:
          $ref: '#/components/schemas/FlywheelModelEvaluationMetrics'
        TrainedModelArn:
          allOf:
          - $ref: '#/components/schemas/ComprehendModelArn'
          - description: The ARN of the trained model associated with this flywheel iteration.
        TrainedModelMetrics:
          allOf:
          - $ref: '#/components/schemas/FlywheelModelEvaluationMetrics'
          - description: The metrics associated with the trained model.
        EvaluationManifestS3Prefix:
          allOf:
          - $ref: '#/components/schemas/S3Uri'
          - description: <p/>
      description: The configuration properties of a flywheel iteration.
    FlywheelIterationId:
      type: string
      pattern: '[0-9]{8}T[0-9]{6}Z'
      maxLength: 63
    FlywheelIterationFilter:
      type: object
      properties:
        CreationTimeAfter:
          allOf:
          - $ref: '#/components/schemas/Timestamp'
          - description: Filter the flywheel iterations to include iterations created after the specified time.
        CreationTimeBefore:
          allOf:
          - $ref: '#/components/schemas/Timestamp'
          - description: Filter the flywheel iterations to include iterations created before the specified time.
      description: Filter the flywheel iterations based on creation time.
    InternalServerException: {}
    FlywheelModelEvaluationMetrics:
      type: object
      properties:
        AverageF1Score:
          allOf:
          - $ref: '#/components/schemas/Double'
          - description: The average F1 score from the evaluation metrics.
        AveragePrecision:
          allOf:
          - $ref: '#/components/schemas/Double'
          - description: Average precision metric for the model.
        AverageRecall:
          allOf:
          - $ref: '#/components/schemas/Double'
          - description: Average recall metric for the model.
        AverageAccuracy:
          allOf:
          - $ref: '#/components/schemas/Double'
          - description: Average accuracy metric for the model.
      description: The evaluation metrics associated with the evaluated model.
    ListFlywheelIterationHistoryResponse:
      type: object
      properties:
        FlywheelIterationPropertiesList:
          allOf:
          - $ref: '#/components/schemas/FlywheelIterationPropertiesList'
          - description: List of flywheel iteration properties
        NextToken:
          allOf:
          - $ref: '#/components/schemas/String'
          - description: Next token
    MaxResultsInteger:
      type: integer
      minimum: 1
      maximum: 500
  parameters:
    X-Amz-Date:
      name: X-Amz-Date
      in: header
      schema:
        type: string
      required: false
    X-Amz-SignedHeaders:
      name: X-Amz-SignedHeaders
      in: header
      schema:
        type: string
      required: false
    X-Amz-Credential:
      name: X-Amz-Credential
      in: header
      schema:
        type: string
      required: false
    X-Amz-Content-Sha256:
      name: X-Amz-Content-Sha256
      in: header
      schema:
        type: string
      required: false
    X-Amz-Algorithm:
      name: X-Amz-Algorithm
      in: header
      schema:
        type: string
      required: false
    X-Amz-Signature:
      name: X-Amz-Signature
      in: header
      schema:
        type: string
      required: false
    X-Amz-Security-Token:
      name: X-Amz-Security-Token
      in: header
      schema:
        type: string
      required: false
  securitySchemes:
    hmac:
      type: apiKey
      name: Authorization
      in: header
      description: Amazon Signature authorization v4
      x-amazon-apigateway-authtype: awsSigv4
externalDocs:
  description: Amazon Web Services documentation
  url: https://docs.aws.amazon.com/comprehend/
x-hasEquivalentPaths: true