IBM WebSphere MBeans API

openapi: 3.1.0
info:
  title: Open Liberty APIs Applications MBeans API
  description: Open Liberty provides application programming interfaces that extend and complement Jakarta EE and MicroProfile APIs. Includes APIs for security, admin connectors, batch processing, messaging, health checking, metrics, OpenAPI documentation, and more. Open Liberty is the open-source foundation for WebSphere Liberty.
  version: 24.0.0
  license:
    name: Eclipse Public License 1.0
    url: https://www.eclipse.org/legal/epl-v10.html
  contact:
    name: Open Liberty Community
    url: https://openliberty.io/
servers:
- url: https://localhost:9443
  description: Default Open Liberty Server
security:
- basicAuth: []
tags:
- name: MBeans
  description: JMX MBean operations and attribute access
paths:
  /mbeans:
    get:
      operationId: listMBeans
      summary: List Registered Mbeans
      description: Returns a list of all MBeans registered in the MBean server.
      tags:
      - MBeans
      parameters:
      - name: objectName
        in: query
        description: ObjectName pattern to filter MBeans
        schema:
          type: string
        example: example_value
      - name: className
        in: query
        description: Filter by MBean class name
        schema:
          type: string
        example: example_value
      responses:
        '200':
          description: List of registered MBeans
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MBeanInfo'
              examples:
                Listmbeans200Example:
                  summary: Default listMBeans 200 response
                  x-microcks-default: true
                  value:
                  - objectName: example_value
                    className: example_value
                    description: A sample description.
                    URL: https://www.example.com
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /mbeans/{objectName}:
    get:
      operationId: getMBeanInfo
      summary: Get Mbean Information
      description: Returns metadata about a specific MBean including attributes, operations, and notifications.
      tags:
      - MBeans
      parameters:
      - $ref: '#/components/parameters/objectName'
      responses:
        '200':
          description: MBean metadata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MBeanDetail'
              examples:
                Getmbeaninfo200Example:
                  summary: Default getMBeanInfo 200 response
                  x-microcks-default: true
                  value:
                    objectName: example_value
                    className: example_value
                    description: A sample description.
                    attributes:
                    - name: Example Title
                      type: example_value
                      description: A sample description.
                      readable: true
                      writable: true
                    operations:
                    - name: Example Title
                      description: A sample description.
                      returnType: example_value
                      parameters:
                      - {}
                      impact: ACTION
                    notifications:
                    - name: Example Title
                      description: A sample description.
                      notifTypes:
                      - {}
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /mbeans/{objectName}/attributes:
    get:
      operationId: getMBeanAttributes
      summary: Get Mbean Attributes
      description: Returns the current values of all readable attributes for the specified MBean.
      tags:
      - MBeans
      parameters:
      - $ref: '#/components/parameters/objectName'
      responses:
        '200':
          description: MBean attribute values
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                Getmbeanattributes200Example:
                  summary: Default getMBeanAttributes 200 response
                  x-microcks-default: true
                  value: {}
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /mbeans/{objectName}/attributes/{attributeName}:
    get:
      operationId: getMBeanAttribute
      summary: Get a Specific Mbean Attribute
      description: Returns the value of a specific attribute for the specified MBean.
      tags:
      - MBeans
      parameters:
      - $ref: '#/components/parameters/objectName'
      - name: attributeName
        in: path
        required: true
        description: Name of the MBean attribute
        schema:
          type: string
        example: example_value
      responses:
        '200':
          description: Attribute value
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttributeValue'
              examples:
                Getmbeanattribute200Example:
                  summary: Default getMBeanAttribute 200 response
                  x-microcks-default: true
                  value:
                    name: Example Title
                    value: example_value
                    type: example_value
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: setMBeanAttribute
      summary: Set a Specific Mbean Attribute
      description: Sets the value of a writable attribute for the specified MBean.
      tags:
      - MBeans
      parameters:
      - $ref: '#/components/parameters/objectName'
      - name: attributeName
        in: path
        required: true
        schema:
          type: string
        example: example_value
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AttributeValue'
            examples:
              SetmbeanattributeRequestExample:
                summary: Default setMBeanAttribute request
                x-microcks-default: true
                value:
                  name: Example Title
                  value: example_value
                  type: example_value
      responses:
        '200':
          description: Attribute value updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttributeValue'
              examples:
                Setmbeanattribute200Example:
                  summary: Default setMBeanAttribute 200 response
                  x-microcks-default: true
                  value:
                    name: Example Title
                    value: example_value
                    type: example_value
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /mbeans/{objectName}/operations/{operationName}:
    post:
      operationId: invokeMBeanOperation
      summary: Invoke an Mbean Operation
      description: Invokes an operation on the specified MBean with optional parameters.
      tags:
      - MBeans
      parameters:
      - $ref: '#/components/parameters/objectName'
      - name: operationName
        in: path
        required: true
        description: Name of the MBean operation to invoke
        schema:
          type: string
        example: example_value
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                params:
                  type: array
                  items: {}
                  description: Operation parameters
                signature:
                  type: array
                  items:
                    type: string
                  description: Parameter type signatures
            examples:
              InvokembeanoperationRequestExample:
                summary: Default invokeMBeanOperation request
                x-microcks-default: true
                value:
                  params: []
                  signature:
                  - example_value
      responses:
        '200':
          description: Operation result
          content:
            application/json:
              schema:
                type: object
                properties:
                  value: {}
              examples:
                Invokembeanoperation200Example:
                  summary: Default invokeMBeanOperation 200 response
                  x-microcks-default: true
                  value:
                    value: example_value
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  responses:
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  parameters:
    objectName:
      name: objectName
      in: path
      required: true
      description: JMX ObjectName (URL-encoded)
      schema:
        type: string
  schemas:
    MBeanDetail:
      type: object
      properties:
        objectName:
          type: string
          example: example_value
        className:
          type: string
          example: example_value
        description:
          type: string
          example: A sample description.
        attributes:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              type:
                type: string
              description:
                type: string
              readable:
                type: boolean
              writable:
                type: boolean
          example: []
        operations:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              description:
                type: string
              returnType:
                type: string
              parameters:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    type:
                      type: string
                    description:
                      type: string
              impact:
                type: string
                enum:
                - ACTION
                - ACTION_INFO
                - INFO
                - UNKNOWN
          example: []
        notifications:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              description:
                type: string
              notifTypes:
                type: array
                items:
                  type: string
          example: []
    MBeanInfo:
      type: object
      properties:
        objectName:
          type: string
          description: JMX ObjectName
          example: example_value
        className:
          type: string
          description: MBean implementation class
          example: example_value
        description:
          type: string
          description: MBean description
          example: A sample description.
        URL:
          type: string
          format: uri
          description: URL for accessing this MBean's details
          example: https://www.example.com
    Error:
      type: object
      properties:
        code:
          type: string
          example: example_value
        message:
          type: string
          example: example_value
      required:
      - code
      - message
    AttributeValue:
      type: object
      properties:
        name:
          type: string
          example: Example Title
        value:
          example: example_value
        type:
          type: string
          example: example_value
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: MicroProfile JWT authentication
externalDocs:
  description: Open Liberty API Reference
  url: https://openliberty.io/docs/latest/reference/api/open-liberty-apis.html