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

BlueCat Server Update Services Administration Guide

Locale
English (United States)
Product name
BlueCat Gateway
Version
22.1

Description

Retrieves a list of server batches on a particular page.

Parameters

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.

Responses

Status Description
Successful

Code: 200

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

Body:
[
  {
    "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  
      }
    ]
  }
]

Results

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

Code: 400

Bad request.

Body:
{
  "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.

Body:
{
  "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.