PUT /bsus/api/v1/scheduled_update - Adaptive Applications - BlueCat Gateway - 21.1.1

BlueCat Server Update Services Administration Guide

Locale
English
Product name
BlueCat Gateway
Version
21.1.1

Description

Update a configured scheduled update.

Parameters

Name Description
body Location: body

Type: application/json

The body of the scheduled update that you would like to modify. The JSON body is as follows:
{
  "patches": [
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "release_date": "date string (yyyy/mm/dd)",
      "patch_dir": "string",
      "enabled": bool
    }
  ],
  "datetime": int(epoch),
  "type": "SCHEDULE_MODIFY",
  "batches": [
    {
      "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_enabled": "string",
          "software_version": "string",
          "patches_installed": "string",
          "services_health": int,
          "configuration": "string",
          "primary_ip": "string",
          "secondary_ip": "string",
        }
      ]
    }
  ],
  "id": "string"
}
Parameters
  • servers—an array of patches with the following information:
    • id—the ID of the patch.
    • name—the name of the patch.
    • type—the type of patch, such as bind_hotfix.
    • release_date—the release date of the patch.
    • patch_dir—the file path to the patch file.
    • enabled—set to true if the patch is scheduled to be applied; set to false if the patch is not scheduled to be applied.
  • datetime—the date and time that the scheduled update is to be applied.
    Note: The date and time must be greater than the time at which the API request is sent by at least 5 minutes.
  • type—the type of update to the scheduled update. Set the value to SCHEDULE_MODIFY to indicate that you are modifying the scheduled update.
  • batches—an array of Server Batches to which the scheduled update is to be applied with the following information:
    • 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
      • 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.
      • 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.
      • primary_ip—the primary IP address of the DNS/DHCP Server.
      • secondary_ip—the secondary IP address of the DNS/DHCP Server.

Responses

Status Description
Successful

Code: 200

Body:
{
  "status": "successfully"
}
Error

Code: 400

Body:
{
  "status": "fail"
}