PUT /bsus/api/v1/batches/{batch_id} - Adaptive Applications - BlueCat Gateway - 21.1.1

BlueCat Server Update Services Administration Guide
ft:locale
en-US
Product name
BlueCat Gateway
Version
21.1.1

Description

Update the servers in an existing Server Batch based on the ID provided

Parameters

Name Description
batch_id Location: query

Type: string

The ID of the Server Batch in which you would like to add servers.
body Location: body

Type: application/json

The body of the servers to be added to the Server Batch. The JSON body is as follows:
{
  "id": "string",
  "name": "string",
  "servers": [
    {
      "name": "string",
      "order": 0,
      "management_ip": "string",
      "service_ip": "string",
      "appliance_type": "string",
      "role_enable": "string",
      "software_version": "string",
      "patches_installed": "string",
      "services_health": 0,
      "configuration": "string"
    }
  ]
}
Parameters
  • id—the ID of the Server Batch
  • name—the name of the Server Batch.
  • servers—an array of servers to add to the server batch with the following information:
    • name—the name of the DNS/DHCP Server.
    • order—the order in which the server appears in the Server Batch
    • 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—the role that has been enabled on the DNS/DHCP Server, such as DNS.
    • software_version—the version of DNS/DHCP Server installed on the server.
    • patches_installed—the list of DNS/DHCP Server patches installed on the server.
    • services_health—the health status of the server.
    • configuration—the configuration in Address Manager in which the server has been added.

Responses

Status Description
Successful

Code: 202

Body:
{
  "id": "string",
  "name": "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_enable": "string",
      "software_version": "string",
      "patches_installed": "string",
      "services_health": int,
      "configuration": "string"
    }
  ]
}

Displays the updated list of servers that are within the specified Server Batch.
Error

Code: 400

Body: 
{
  "errors": [
    "missing credentials errors message"
  ]
}

Code: 404

Body: 
{
  "errors": [
    "Batch not found with ID <batch_id>"
  ]
}

Code: 409

Body: 
{
  "errors": [
    "The batch with name '<batch_name>' is already in use"
  ]
}
{
  "errors": [
    "conflict server errors message"
  ]
}