/v3/api/sites (PATCH) - 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 Service Point v4 instances configured, the response returns a skippedInstances section contains a list of sites and any associated DNS resolver services on Edge Service Point v4 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