/v3/api/sites (PATCH) - BlueCat DNS Edge

DNS Edge User Guide (Fleet Service Point)

Locale
English (United States)
Product name
BlueCat DNS Edge
Update the DNS resolver service version or logging endpoint configuration of specified sites.
Note: You must disable automatic DNS resolver service updates to update the DNS resolver service versions.
PATCH https://api-<DNS.Edge.URL>/v3/api/sites
Authorization: Bearer token
Content-type: application/JSON
[
    {
        "id": "a16a009e-4790-42b6-9374-b1b18e619d76",
        "version": "3.0.5",
        "blockedServicePointIds": ["7793fcc1-21d9-40d2-a382-3df72276b501", "1233fcc1-4569-40d2-a382-abc2276b502"]
        "streamDataToCI": true,
        "loggingEndpointId": "123e4567-e89b-12d3-a456-426614174000"
    },
    ...
]

Parameters

Name Description Type Required
id The ID of the site. String Required
version The updated DNS resolver service version of the site. This value must be a supported DNS resolver service version.
Attention: This parameter must not be included if automatic DNS resolver service updates is enabled.
String Optional
blockedServicePointIds The service points that were blocked from updating. Remove the ID of service points that were blocked to allow the service point to retry the update. String Optional
streamDataToCI Sends DNS queries from a service point to the DNS Edge Cloud console. The default value is true. If the value is false, loggingEndpointId must have a value. Boolean Optional
loggingEndpointId The ID of local logging endpoint. If this parameter does not have a value, the service point will not send DNS queries to a local logging endpoint. String Optional

Successful response

204 NO_CONTENT
If you have Edge Fleet Instances configured, the response returns a skippedInstances section contains a list of sites and any associated DNS resolver services on Edge Fleet Instances that did not successfully update due to version incompatibility. The following displays an example of the response:
200 OK
Content-Type: application/JSON
{
  "skippedInstances": {
    "site-id-1": ["dps-id-1", "dps-id-2"],
    "site-id-2": [...],
    ...
  }
}
Possible error codes
  • UNAUTHORIZED
  • NOT_FOUND
  • BAD_REQUEST
  • FORBIDDEN
  • UNEXPECTED_ERROR