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

DNS Edge User Guide

Locale
English (United States)
Product name
BlueCat DNS Edge
Update the service point version or logging endpoint configuration of specified sites.
Note: You must disable automatic service point updates to update the service point 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 service point version of the site. This value must be a supported service point version.
Attention: This parameter must not be included if automatic service point 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
Possible error codes
  • UNAUTHORIZED
  • NOT_FOUND
  • BAD_REQUEST
  • FORBIDDEN
  • UNEXPECTED_ERROR