Dell Servers Discovery API

openapi: 3.2.0
info:
  title: Dell Servers Dell OpenManage Enterprise Discovery API
  description: RESTful API for centralized management of Dell EMC servers, chassis, and storage through the OpenManage Enterprise console. Provides discovery, inventory, monitoring, alerting, firmware updates, configuration compliance, and lifecycle management of Dell PowerEdge infrastructure at scale. The API delivers JSON responses over HTTPS and follows OData v4 conventions.
  version: '4.0'
  contact:
    name: Dell Technologies Support
    url: https://www.dell.com/support
  termsOfService: https://i.dell.com/sites/csdocuments/Legal_Docs/en/us/api-terms-of-use_en.pdf
servers:
- url: https://{ome-server}/api
  description: OpenManage Enterprise API Server
  variables:
    ome-server:
      description: Hostname or IP address of the OpenManage Enterprise appliance
      default: ome-server.example.com
security:
- sessionAuth: []
tags:
- name: Discovery
  description: Network discovery configuration and job management
paths:
  /DiscoveryConfigService/DiscoveryConfigGroups:
    get:
      operationId: listDiscoveryConfigs
      summary: Dell Servers List discovery configurations
      description: Retrieves the collection of discovery configuration groups that define target ranges, protocols, and credentials used for device discovery.
      tags:
      - Discovery
      responses:
        '200':
          description: Collection of discovery configurations
          content:
            application/json:
              schema:
                type: object
                properties:
                  value:
                    type: array
                    items:
                      $ref: '#/components/schemas/DiscoveryConfigGroup'
        '401':
          description: Unauthorized - invalid or expired session token
    post:
      operationId: createDiscoveryConfig
      summary: Dell Servers Create a discovery configuration
      description: Creates a new discovery configuration group that defines network ranges, protocols, and credentials for discovering devices. When executed, the discovery job scans the specified ranges and adds discovered devices to the managed inventory.
      tags:
      - Discovery
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DiscoveryConfigGroup'
      responses:
        '201':
          description: Discovery configuration created
        '400':
          description: Invalid discovery configuration parameters
        '401':
          description: Unauthorized - invalid or expired session token
  /DiscoveryConfigService/Jobs:
    get:
      operationId: listDiscoveryJobs
      summary: Dell Servers List discovery jobs
      description: Retrieves the collection of discovery job instances showing status, progress, and results for discovery operations.
      tags:
      - Discovery
      responses:
        '200':
          description: Collection of discovery jobs
          content:
            application/json:
              schema:
                type: object
                properties:
                  value:
                    type: array
                    items:
                      $ref: '#/components/schemas/Job'
        '401':
          description: Unauthorized - invalid or expired session token
components:
  schemas:
    DiscoveryConfigGroup:
      type: object
      description: Discovery configuration group defining targets and credentials
      properties:
        DiscoveryConfigGroupId:
          type: integer
          description: Unique discovery configuration identifier
        DiscoveryConfigGroupName:
          type: string
          description: Name of the discovery configuration
        DiscoveryConfigModels:
          type: array
          description: Array of discovery targets with protocol settings
          items:
            type: object
            properties:
              DiscoveryConfigTargets:
                type: array
                description: Target IP ranges or hostnames
                items:
                  type: object
                  properties:
                    NetworkAddressDetail:
                      type: string
                      description: IP address, range, or CIDR notation
              ConnectionProfileId:
                type: integer
                description: Connection profile with credentials
              DeviceType:
                type: array
                description: Device types to discover
                items:
                  type: integer
        Schedule:
          type: object
          description: Discovery schedule configuration
          properties:
            RunNow:
              type: boolean
              description: Execute discovery immediately
            Cron:
              type: string
              description: Cron expression for recurring discovery
    Job:
      type: object
      description: An asynchronous job in OpenManage Enterprise
      properties:
        Id:
          type: integer
          description: Unique job identifier
        JobName:
          type: string
          description: Job name
        JobDescription:
          type: string
          description: Job description
        JobType:
          type: object
          description: Job type information
          properties:
            Id:
              type: integer
              description: Job type identifier
            Name:
              type: string
              description: Job type name
        LastRunStatus:
          type: object
          description: Status of the last job execution
          properties:
            Id:
              type: integer
              description: Status code
            Name:
              type: string
              description: Status description
        JobStatus:
          type: object
          description: Current job status
          properties:
            Id:
              type: integer
              description: Status code
            Name:
              type: string
              description: Status description
        PercentComplete:
          type: integer
          description: Job completion percentage
          minimum: 0
          maximum: 100
        StartTime:
          type: string
          format: date-time
          description: Job start timestamp
        EndTime:
          type: string
          format: date-time
          description: Job completion timestamp
  securitySchemes:
    sessionAuth:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: Session token obtained from the POST /SessionService/Sessions endpoint. Must be included in the X-Auth-Token header of all authenticated requests.
externalDocs:
  description: OpenManage Enterprise RESTful API Guide
  url: https://www.dell.com/support/manuals/en-us/dell-openmanage-enterprise/ome_p_api_guide/overview?guid=guid-fc1c0585-795c-41fe-9957-977678be554f&lang=en-us