GET /bsus/api/v1/batches - Adaptive Applications - BlueCat Gateway - 22.1

BlueCat Server Update Services Administration Guide

English (United States)
Product name
BlueCat Gateway


Retrieves a list of server batches on a particular page.


Name Description
limit Location: query

Type: integer

The size of the page to return. The value must be between 0 and 1000.

page Location: query

Type: integer

The page number to return. The value must be greater than 0.


Status Description

Code: 200

Returns all batches if not provided the limit and the page.

    "id": "string",
    "name": "string",
    "post_script": "string"
    "timestamp": "date string(%Y-%m-%dT%H:%M:%SZ)",
    "servers": [
        "name": "string",
        "order": int,
        "bam_id": "string"
        "management_ip": "string",
        "service_ip": "string",
        "appliance_type": "string",
        "role_enabled": [ "string" ],
        "software_version": "string",
        "patches_installed": [ "string" ],
        "services_health": int,
        "configuration": "string",
        "primary_ip": "string",
        "secondary_ip": "string",
        "secondary_services_health": int  


An array of Server Batch details:

  • id—the ID of the Server Batch.
  • name—the name of the Server Batch.
  • post_script—the customization package associated with the Server Batch.
  • timestamp—when the Server Batch was created.
  • servers—an array of servers:
    • name—the name of the DNS/DHCP Server.
    • order—the order in which the server appears in the Server Batch, relative to other servers and starting with 0.
    • bam_id—the object ID of the server within Address Manager.
    • management_ip—the IP address of the DNS/DHCP Server management interface.
    • service_ip—the IP address of the DNS/DHCP Server service interface.
    • appliance_type—the appliance type of the DNS/DHCP Server.
    • role_enabled—an array of roles that are enabled on the DNS/DHCP Server, such as "DNS" or "DHCP".
    • software_version—the current DNS/DHCP Server software version.
    • patches_installed—an array listing all patches currently installed on the DNS/DHCP Server.
    • services_health—the health status of the DNS/DHCP Server.
    • configuration—the configuration in Address Manager to which the server has been added.
    • primary_ip—the primary IP address for the DNS/DHCP Server.
    • secondary_ip—the secondary IP address for the DNS/DHCP Server.
    • secondary_services_health—the health status of the secondary server.

Code: 400

Bad request.

  "error": "The parameter "limit" must be in between 0 and 1000"
 "error": "The parameter "page" must be greater than 0"

Code: 401

Unauthorized error.

Code: 500

Internal server error.

  "error": <>

This can be caused when an unknown application error is encountered on the Server side. The API attempts to return additional details within the error parameter.