> ## 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.

# 根据Id设置Job定义优先级

> Sets an overriding execution priority for jobs with the given definition id.
Optionally, the priorities of all the definitions' existing jobs are
updated accordingly. The priority can be reset by setting it to
`null`, meaning that a new job's priority will not be determined based
on its definition's priority any longer. See the
[user guide on job prioritization](https://docs.camunda.org/manual/7.22/user-guide/process-engine/the-job-executor/#set-job-definition-priorities-via-managementservice-api)
for details.



## OpenAPI

````yaml PUT /job-definition/{id}/jobPriority
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:
  /job-definition/{id}/jobPriority:
    put:
      tags:
        - Job Definition
      summary: Set Job Definition Priority by Id
      description: >-
        Sets an overriding execution priority for jobs with the given definition
        id.

        Optionally, the priorities of all the definitions' existing jobs are

        updated accordingly. The priority can be reset by setting it to

        `null`, meaning that a new job's priority will not be determined based

        on its definition's priority any longer. See the

        [user guide on job
        prioritization](https://docs.camunda.org/manual/7.22/user-guide/process-engine/the-job-executor/#set-job-definition-priorities-via-managementservice-api)

        for details.
      operationId: setJobPriorityJobDefinition
      parameters:
        - name: id
          in: path
          schema:
            type: string
          required: true
          description: The id of the job definition to be updated.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JobDefinitionPriorityDto'
            examples:
              example-1:
                summary: PUT `/job-definition/aJobDefId/jobPriority`
                value:
                  priority: 10
                  includeJobs: true
      responses:
        '204':
          description: Request successful. This method returns no content.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionDto'
          description: >-
            Job definition with given id does not exist. See the

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

            for the error response format.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionDto'
          description: >-
            The retries could not be set successfully. See the

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

            for the error response format.
components:
  schemas:
    JobDefinitionPriorityDto:
      type: object
      properties:
        priority:
          type: integer
          format: int64
          nullable: true
          description: >-
            The new execution priority number for jobs of the given definition.
            The

            definition's priority can be reset by using the value `null`. In

            that case, the job definition's priority no longer applies but a new

            job's priority is determined as specified in the process model.
        includeJobs:
          type: boolean
          nullable: true
          description: >-
            A boolean value indicating whether existing jobs of the given
            definition should

            receive the priority as well. Default value is `false`. Can only be

            `true` when the __priority__ parameter is not `null`.
    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

````