POST /v1/selectiveDeploy - BlueCat Address Manager - 9.1.0

Address Manager API Guide
prodname
BlueCat Address Manager
version_custom
9.1.0

Description

Selectively deploys—creates a differential deployment task to deploy changes made to specific DNS entities, such as resource records, to a managed DNS/DHCP Server.

Parameters

Name Description
properties

Location: query

Type: string

A string containing the following deployment options:
  • scope —a string value. This property defines whether the deployment task includes objects that are related to the defined DNS resource records. The scope can be one of the following values:
    • related (default value) —deploys the DNS resource records defined in the entityIds list as well as DNS resource records that are related to those entities. For more information on additional entities that are deployed when the related scope is defined, refer to Reference: selective deployment related scope.
    • specific —deploys only the DNS resource records that are defined in the entityIds list.
  • batchMode —an enum value. This property batches selective deployment tasks. The scope can be one of the following values:
    • disabled (default value) —disables the batching of selective deployment tasks.
    • batch_by_server —enables the batching of selective deployment tasks.
    Note: The batching of selective deployment tasks is dependent on the following conditions:
    • The tasks are from the same server.
    • Each deployment task that is configured for batching must have batchMode set to batch_by_server.
    • The batched deployment contains less than 100 resource records.
  • continueOnFailure —a boolean value. This property specifies the mode of operation on a failed resource record. If set to false, deployment stops when a record fails. If set to true, deployment continues when a record fails and moves to the next record. The default value is true if batchMode is set to batch_by_server, otherwise the default value is false.
body

Location: body

A list of entity IDs that specify the DNS entities to deploy. Currently, only DNS resource records are supported.
Note: Restrictions:
  • You can only deploy a maximum of 100 DNS entities per selective deployment API call.
  • You cannot deploy dynamic records.
  • You cannot deploy external host records.
  • You cannot deploy resource records if they belong to multiple DNS/DHCP Servers.

Responses

Code Description
201

Type: string

Returns a token string value of the deployment task.