> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eorion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取计数(POST)

> Queries for the number of external tasks that fulfill given parameters. This method takes the same message
body as the [Get External Tasks (POST)](https://docs.camunda.org/manual/7.22/reference/rest/external-task/post-query/) method.



## OpenAPI

````yaml POST /external-task/count
openapi: 3.0.2
info:
  title: ORION Platform REST API
  description: OpenApi Spec for ORION Camunda Platform REST API.
  version: 7.22.6-ee
  license:
    name: Apache License 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: http://{host}:{port}/{contextPath}
    description: The API server for the default process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
  - url: http://{host}:{port}/{contextPath}/engine/{engineName}
    description: The API server for a named process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
      engineName:
        default: default
  - url: '{url}'
    description: The API server with a custom url
    variables:
      url:
        default: ''
security:
  - basicAuth: []
tags:
  - name: Authorization
  - name: Batch
  - name: Condition
  - name: Decision Definition
  - name: Decision Requirements Definition
  - name: Deployment
  - name: Engine
  - name: Event Subscription
  - name: Execution
  - name: External Task
  - name: Filter
  - name: Group
  - name: Historic Activity Instance
  - name: Historic Batch
  - name: Historic Decision Definition
  - name: Historic Decision Instance
  - name: Historic Decision Requirements Definition
  - name: Historic Detail
  - name: Historic External Task Log
  - name: Historic Identity Link Log
  - name: Historic Incident
  - name: Historic Job Log
  - name: Historic Process Definition
  - name: Historic Process Instance
  - name: Historic Task Instance
  - name: Historic User Operation Log
  - name: Historic Variable Instance
  - name: History Cleanup
  - name: Identity
  - name: Incident
  - name: Job
  - name: Job Definition
  - name: Message
  - name: Metrics
  - name: Migration
  - name: Modification
  - name: Process Definition
  - name: Process Instance
  - name: Signal
  - name: Schema Log
  - name: Task
  - name: Task Attachment
  - name: Task Comment
  - name: Task Identity Link
  - name: Task Local Variable
  - name: Task Variable
  - name: Telemetry
  - name: Tenant
  - name: User
  - name: Variable Instance
  - name: Version
externalDocs:
  description: Find out more about ORION Rest API
  url: https://docs.eorion.com
paths:
  /external-task/count:
    post:
      tags:
        - External Task
      summary: Get List Count (POST)
      description: >-
        Queries for the number of external tasks that fulfill given parameters.
        This method takes the same message

        body as the [Get External Tasks
        (POST)](https://docs.camunda.org/manual/7.22/reference/rest/external-task/post-query/)
        method.
      operationId: queryExternalTasksCount
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExternalTaskQueryDto'
            examples:
              example-1:
                summary: POST /external-task/count
                value:
                  topicName: aTopicName
                  withRetriesLeft: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountResultDto'
              examples:
                example-1:
                  summary: Status 200 Response
                  value:
                    count: 1
          description: Request successful.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionDto'
          description: >-
            Returned if some of the query parameters are invalid. See the

            [Introduction](https://docs.camunda.org/manual/7.22/reference/rest/overview/#error-handling)

            for the error response format.
components:
  schemas:
    ExternalTaskQueryDto:
      title: ExternalTaskQueryDto
      type: object
      description: 'A JSON object with the following properties:'
      properties:
        externalTaskId:
          type: string
          nullable: true
          description: Filter by an external task's id.
        externalTaskIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: Filter by the comma-separated list of external task ids.
        topicName:
          type: string
          nullable: true
          description: Filter by an external task topic.
        workerId:
          type: string
          nullable: true
          description: >-
            Filter by the id of the worker that the task was most recently
            locked by.
        locked:
          type: boolean
          nullable: true
          description: >-
            Only include external tasks that are currently locked (i.e., they
            have a lock time and it has not expired).

            Value may only be `true`, as `false` matches any external task.
        notLocked:
          type: boolean
          nullable: true
          description: >-
            Only include external tasks that are currently not locked (i.e.,
            they have no lock or it has expired).

            Value may only be `true`, as `false` matches any external task.
        withRetriesLeft:
          type: boolean
          nullable: true
          description: >-
            Only include external tasks that have a positive (> 0) number of
            retries (or `null`). Value may only be

            `true`, as `false` matches any external task.
        noRetriesLeft:
          type: boolean
          nullable: true
          description: >-
            Only include external tasks that have 0 retries. Value may only be
            `true`, as `false` matches any

            external task.
        lockExpirationAfter:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to external tasks that have a lock that expires after a
            given date. By

            [default](https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/),
            the date must have the format

            `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`.
        lockExpirationBefore:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to external tasks that have a lock that expires before a
            given date. By

            [default](https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/),
            the date must have the format

            `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`.
        activityId:
          type: string
          nullable: true
          description: >-
            Filter by the id of the activity that an external task is created
            for.
        activityIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Filter by the comma-separated list of ids of the activities that an
            external task is created for.
        executionId:
          type: string
          nullable: true
          description: Filter by the id of the execution that an external task belongs to.
        processInstanceId:
          type: string
          nullable: true
          description: >-
            Filter by the id of the process instance that an external task
            belongs to.
        processInstanceIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Filter by a comma-separated list of process instance ids that an
            external task may belong to.
        processDefinitionId:
          type: string
          nullable: true
          description: >-
            Filter by the id of the process definition that an external task
            belongs to.
        tenantIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: |-
            Filter by a comma-separated list of tenant ids.
            An external task must have one of the given tenant ids.
        active:
          type: boolean
          nullable: true
          description: >-
            Only include active tasks. Value may only be `true`, as `false`
            matches any external task.
        suspended:
          type: boolean
          nullable: true
          description: >-
            Only include suspended tasks. Value may only be `true`, as `false`
            matches any external task.
        priorityHigherThanOrEquals:
          type: integer
          format: int64
          nullable: true
          description: >-
            Only include jobs with a priority higher than or equal to the given
            value.

            Value must be a valid `long` value.
        priorityLowerThanOrEquals:
          type: integer
          format: int64
          nullable: true
          description: >-
            Only include jobs with a priority lower than or equal to the given
            value.

            Value must be a valid `long` value.
        sorting:
          type: array
          nullable: true
          description: >-
            A JSON array of criteria to sort the result by. Each element of the
            array is a JSON object that
                                specifies one ordering. The position in the array identifies the rank of an ordering, i.e., whether
                                it is primary, secondary, etc. The ordering objects have the following properties:

                                **Note:** The `sorting` properties will not be applied to the External Task count query.
          items:
            type: object
            properties:
              sortBy:
                type: string
                nullable: true
                enum:
                  - id
                  - lockExpirationTime
                  - processInstanceId
                  - processDefinitionId
                  - processDefinitionKey
                  - taskPriority
                  - createTime
                  - tenantId
                description: |-
                  Sort the results lexicographically by a given criterion.
                  Must be used in conjunction with the sortOrder parameter.
              sortOrder:
                type: string
                nullable: true
                enum:
                  - asc
                  - desc
                description: >-
                  Sort the results in a given order. Values may be `asc` for
                  ascending order or `desc` for

                  descending order. Must be used in conjunction with the sortBy
                  parameter.
    CountResultDto:
      type: object
      properties:
        count:
          type: integer
          format: int64
          description: The number of matching instances.
    ExceptionDto:
      title: ExceptionDto
      type: object
      properties:
        type:
          type: string
          nullable: true
          description: An exception class indicating the occurred error.
        message:
          type: string
          nullable: true
          description: A detailed message of the error.
        code:
          type: number
          description: >-
            The code allows your client application to identify the error in an
            automated fashion.

            You can look up the meaning of all built-in codes and learn how to
            add custom codes

            in the [User
            Guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/error-handling/#exception-codes).
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````