POST /v1/selectiveDeploy - BlueCat Integrity - 9.5.0

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 including 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.

• dynamicRecords —an enum value. This property defines how dynamic records are handled with selective deployment tasks. The value can be one of the following:
  • fail (default value) —the selective deployment task fails when a dynamic record is encountered.
  • skip —skips dynamic records by removing them from the list of entity IDs before the selective deployment task is performed.
    Note: If you perform a selective deployment where all entities are dynamic and you define the skip option, all records will be removed from the selective deployment task and the deployment fails with the following message:

    Verify input error.: Empty entity id input

  • makestatic —dynamic records are updated to static records before the selective deployment task is performed. You can use this option to convert previously created dynamic records, such as records created using the addDeviceInstance method, to static records and selectively deploy the changes to the DNS/DHCP Server. This has no effect on related records that are deployed using the related scope.
    Note: If you define the makestatic option and the selective deployment task fails for any reason, the updated records are not rolled back and remain static records.

A list of entity IDs that specify the DNS entities to deploy. You can provide the entity IDs of DNS resource records and IP addresses. When you provide the entity ID of an IP address, the PTR records that are linked to the host records (A or AAAA) are deployed.

Returns a token string value of the deployment task.