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

BlueCat Server Update Services Administration Guide

Locale
English
Product name
BlueCat Gateway
Version
23.1

Description

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

Parameters

Name Description
batch_id Location: Path

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:
{
  "name": "string",
  "servers": [
    {
      "name": "string",
      "bam_id": int,
      "management_ip": "string",
      "service_ip": "string",
      "appliance_type": "string",
      "role_enable": "string",
    }
  ],
  "postcript_options": {
    "install": true,
    "apply_and_run": true,
    "postscript_id": "string"
  }
  "service_template_ids": [
    "string"
  ]
}
Parameters
  • 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.
    • bam_id—the object ID of the Address Manager server to which the server is associated.
    • 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.
  • postscript_options—Options to set for the Server Batch's customization package:
    • install—set to true if the customization package should be sent to the DNS/DHCP Server during an update.
    • apply_and_run—set to true if the customization package's post-update script should be called after an update to restore customized server settings (customize.sh -r).
    • postscript_id—The ID of the package to associate with this Server Batch.
  • service_template_ids—an array of IDs for service Configuration Templates associated with the Server Batch.

Responses

Status Description
Successful

Code: 202

Server Batch updated successfully.

Body:
{
  "id": "string",
  "name": "string",
  "post_script": {
    "id": "string",
    "name": "string"
  },
  "timestamp": "2023-04-18T18:41:18.292Z",
  "servers": [
    {
      "server_id": "string",
      "name": "string",
      "order": 0,
      "bam_id": 0,
      "management_ip": "string",
      "service_ip": "string",
      "appliance_type": "string",
      "role_enabled": [
        "string"
      ],
      "software_version": "string",
      "patches_installed": [
        "string"
      ],
      "outdated_agent": true,
      "services_health": 0,
      "service_sync_status": 0,
      "profile": "string",
      "configuration": "string",
      "primary_ip": "string",
      "secondary_ip": "string",
      "secondary_services_health": 0,
      "service_template_id": "string"
    }
  ],
  "service_templates": [
    "string"
  ]
}

Displays the updated list of servers that are within the specified Server Batch. For descriptions of each field, see Parameters above.

Error

Code: 400

Invalid input.

Body:

{
  "errors": [
    "string"
  ]
}

Code: 404

Server Batch or service template not found.

Body:

{
  "errors": [ "Batch not found with ID <batch_id>"
}
{
  "errors": "Service template ID <service_template_id> not found"
}

Code: 409

Server Batch name already in use.

Body:
{
  "errors": [
    "string"
  ]
}

Code: 500

Internal server error.

Body:
{
  "error": "string"
}