IBM WebSphere MBeans API

openapi: 3.2.0
info:
  title: WebSphere Liberty REST Connector M Beans API
  description: Secure REST-based JMX connector for remote administration of Liberty servers. Provides file transfer and JMX MBean access through HTTPS endpoints, requiring TLS for confidential communication. Supports MBean operations, attribute access, and notification subscriptions.
  version: 2.0.0
  license:
    name: IBM International License Agreement
    url: https://www.ibm.com/legal/terms
  contact:
    name: IBM Support
    url: https://www.ibm.com/mysupport
servers:
- url: https://localhost:9443/IBMJMXConnectorREST/api
  description: Default Liberty JMX REST Connector
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:
  schemas:
    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
    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
    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: []
  parameters:
    objectName:
      name: objectName
      in: path
      required: true
      description: JMX ObjectName (URL-encoded)
      schema:
        type: string
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication with administrator role
externalDocs:
  description: REST Connector Feature Documentation
  url: https://openliberty.io/docs/latest/reference/feature/restConnector-2.0.html