system.ntpserver.create
=======================

Add an NTP Server.

`address` specifies the hostname/IP address of the NTP server.

`burst` when enabled makes sure that if server is reachable, sends a burst of eight packets instead of one. This is designed to improve timekeeping quality with the server command.

`iburst` when enabled speeds up the initial synchronization, taking seconds rather than minutes.

`prefer` marks the specified server as preferred. When all other things are equal, this host is chosen for synchronization acquisition with the server command. It is recommended that they be used for servers with time monitoring hardware.

`minpoll` is minimum polling time in seconds. It must be a power of 2 and less than `maxpoll`.

`maxpoll` is maximum polling time in seconds. It must be a power of 2 and greater than `minpoll`.

`force` when enabled forces the addition of NTP server even if it is currently unreachable.

.. raw:: html

    <div id="json-schema">
    <span class="badge badge-dark value-type">Type: object</span><br/>
    <div class="accordion" id="accordionCall_parameters">
    <div class="card">
    <div class="card-header" id="headingCall_parameters">
    <h2 class="mb-0">
    <button aria-controls="Call_parameters" aria-expanded="" class="btn btn-link property-name-button" data-target="#Call_parameters" data-toggle="collapse" onclick="setAnchor('#Call_parameters')" type="button"><span class="property-name">Call parameters</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingCall_parameters" class="collapse property-definition-div" data-parent="#accordionCall_parameters" id="Call_parameters">
    <div class="card-body pl-5">
    <span class="badge badge-dark value-type">Type: array</span><br/>
    <span class="badge badge-info no-additional">No Additional Items</span><h4>Tuple Validation</h4>
    <h5>Parameter 1: ntp_server_create</h5>
    <div class="card">
    <div class="card-body items-definition" id="Call_parameters_items_i0">
    <h4>ntp_server_create</h4><span class="badge badge-dark value-type">Type: object</span><br/>
    <span class="description"><p>Configuration for creating a new NTP server.</p>
    </span> <span class="badge badge-info no-additional">No Additional Properties</span>
    <div class="accordion" id="accordionCall_parameters_items_i0_address">
    <div class="card">
    <div class="card-header" id="headingCall_parameters_items_i0_address">
    <h2 class="mb-0">
    <button aria-controls="Call_parameters_items_i0_address" aria-expanded="" class="btn btn-link property-name-button" data-target="#Call_parameters_items_i0_address" data-toggle="collapse" onclick="setAnchor('#Call_parameters_items_i0_address')" type="button"><span class="property-name">address</span> <span class="badge badge-warning required-property">Required</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingCall_parameters_items_i0_address" class="collapse property-definition-div" data-parent="#accordionCall_parameters_items_i0_address" id="Call_parameters_items_i0_address">
    <div class="card-body pl-5">
    <h4>Address</h4><span class="badge badge-dark value-type">Type: string</span><br/>
    <span class="description"><p>Hostname or IP address of the NTP server.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionCall_parameters_items_i0_burst">
    <div class="card">
    <div class="card-header" id="headingCall_parameters_items_i0_burst">
    <h2 class="mb-0">
    <button aria-controls="Call_parameters_items_i0_burst" aria-expanded="" class="btn btn-link property-name-button" data-target="#Call_parameters_items_i0_burst" data-toggle="collapse" onclick="setAnchor('#Call_parameters_items_i0_burst')" type="button"><span class="property-name">burst</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingCall_parameters_items_i0_burst" class="collapse property-definition-div" data-parent="#accordionCall_parameters_items_i0_burst" id="Call_parameters_items_i0_burst">
    <div class="card-body pl-5">
    <h4>Burst</h4><span class="badge badge-dark value-type">Type: boolean</span> <span class="badge badge-success default-value">Default: false</span><br/>
    <span class="description"><p>Send a burst of packets when the server is reachable.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionCall_parameters_items_i0_iburst">
    <div class="card">
    <div class="card-header" id="headingCall_parameters_items_i0_iburst">
    <h2 class="mb-0">
    <button aria-controls="Call_parameters_items_i0_iburst" aria-expanded="" class="btn btn-link property-name-button" data-target="#Call_parameters_items_i0_iburst" data-toggle="collapse" onclick="setAnchor('#Call_parameters_items_i0_iburst')" type="button"><span class="property-name">iburst</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingCall_parameters_items_i0_iburst" class="collapse property-definition-div" data-parent="#accordionCall_parameters_items_i0_iburst" id="Call_parameters_items_i0_iburst">
    <div class="card-body pl-5">
    <h4>Iburst</h4><span class="badge badge-dark value-type">Type: boolean</span> <span class="badge badge-success default-value">Default: true</span><br/>
    <span class="description"><p>Send a burst of packets when the server is unreachable.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionCall_parameters_items_i0_prefer">
    <div class="card">
    <div class="card-header" id="headingCall_parameters_items_i0_prefer">
    <h2 class="mb-0">
    <button aria-controls="Call_parameters_items_i0_prefer" aria-expanded="" class="btn btn-link property-name-button" data-target="#Call_parameters_items_i0_prefer" data-toggle="collapse" onclick="setAnchor('#Call_parameters_items_i0_prefer')" type="button"><span class="property-name">prefer</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingCall_parameters_items_i0_prefer" class="collapse property-definition-div" data-parent="#accordionCall_parameters_items_i0_prefer" id="Call_parameters_items_i0_prefer">
    <div class="card-body pl-5">
    <h4>Prefer</h4><span class="badge badge-dark value-type">Type: boolean</span> <span class="badge badge-success default-value">Default: false</span><br/>
    <span class="description"><p>Mark this server as preferred for time synchronization.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionCall_parameters_items_i0_minpoll">
    <div class="card">
    <div class="card-header" id="headingCall_parameters_items_i0_minpoll">
    <h2 class="mb-0">
    <button aria-controls="Call_parameters_items_i0_minpoll" aria-expanded="" class="btn btn-link property-name-button" data-target="#Call_parameters_items_i0_minpoll" data-toggle="collapse" onclick="setAnchor('#Call_parameters_items_i0_minpoll')" type="button"><span class="property-name">minpoll</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingCall_parameters_items_i0_minpoll" class="collapse property-definition-div" data-parent="#accordionCall_parameters_items_i0_minpoll" id="Call_parameters_items_i0_minpoll">
    <div class="card-body pl-5">
    <h4>Minpoll</h4><span class="badge badge-dark value-type">Type: integer</span> <span class="badge badge-success default-value">Default: 6</span><br/>
    <span class="description"><p>Minimum polling interval (log2 seconds).</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionCall_parameters_items_i0_maxpoll">
    <div class="card">
    <div class="card-header" id="headingCall_parameters_items_i0_maxpoll">
    <h2 class="mb-0">
    <button aria-controls="Call_parameters_items_i0_maxpoll" aria-expanded="" class="btn btn-link property-name-button" data-target="#Call_parameters_items_i0_maxpoll" data-toggle="collapse" onclick="setAnchor('#Call_parameters_items_i0_maxpoll')" type="button"><span class="property-name">maxpoll</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingCall_parameters_items_i0_maxpoll" class="collapse property-definition-div" data-parent="#accordionCall_parameters_items_i0_maxpoll" id="Call_parameters_items_i0_maxpoll">
    <div class="card-body pl-5">
    <h4>Maxpoll</h4><span class="badge badge-dark value-type">Type: integer</span> <span class="badge badge-success default-value">Default: 10</span><br/>
    <span class="description"><p>Maximum polling interval (log2 seconds).</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionCall_parameters_items_i0_force">
    <div class="card">
    <div class="card-header" id="headingCall_parameters_items_i0_force">
    <h2 class="mb-0">
    <button aria-controls="Call_parameters_items_i0_force" aria-expanded="" class="btn btn-link property-name-button" data-target="#Call_parameters_items_i0_force" data-toggle="collapse" onclick="setAnchor('#Call_parameters_items_i0_force')" type="button"><span class="property-name">force</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingCall_parameters_items_i0_force" class="collapse property-definition-div" data-parent="#accordionCall_parameters_items_i0_force" id="Call_parameters_items_i0_force">
    <div class="card-body pl-5">
    <h4>Force</h4><span class="badge badge-dark value-type">Type: boolean</span> <span class="badge badge-success default-value">Default: false</span><br/>
    <span class="description"><p>Force creation even if the server is unreachable.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionReturn_value">
    <div class="card">
    <div class="card-header" id="headingReturn_value">
    <h2 class="mb-0">
    <button aria-controls="Return_value" aria-expanded="" class="btn btn-link property-name-button" data-target="#Return_value" data-toggle="collapse" onclick="setAnchor('#Return_value')" type="button"><span class="property-name">Return value</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingReturn_value" class="collapse property-definition-div" data-parent="#accordionReturn_value" id="Return_value">
    <div class="card-body pl-5">
    <h4>NTPServerEntry</h4><span class="badge badge-dark value-type">Type: object</span><br/>
    <span class="description"><p>The newly created NTP server configuration.</p>
    </span> <span class="badge badge-info no-additional">No Additional Properties</span>
    <div class="accordion" id="accordionReturn_value_id">
    <div class="card">
    <div class="card-header" id="headingReturn_value_id">
    <h2 class="mb-0">
    <button aria-controls="Return_value_id" aria-expanded="" class="btn btn-link property-name-button" data-target="#Return_value_id" data-toggle="collapse" onclick="setAnchor('#Return_value_id')" type="button"><span class="property-name">id</span> <span class="badge badge-warning required-property">Required</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingReturn_value_id" class="collapse property-definition-div" data-parent="#accordionReturn_value_id" id="Return_value_id">
    <div class="card-body pl-5">
    <h4>Id</h4><span class="badge badge-dark value-type">Type: integer</span><br/>
    <span class="description"><p>Unique identifier for the NTP server configuration.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionReturn_value_address">
    <div class="card">
    <div class="card-header" id="headingReturn_value_address">
    <h2 class="mb-0">
    <button aria-controls="Return_value_address" aria-expanded="" class="btn btn-link property-name-button" data-target="#Return_value_address" data-toggle="collapse" onclick="setAnchor('#Return_value_address')" type="button"><span class="property-name">address</span> <span class="badge badge-warning required-property">Required</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingReturn_value_address" class="collapse property-definition-div" data-parent="#accordionReturn_value_address" id="Return_value_address">
    <div class="card-body pl-5">
    <h4>Address</h4><span class="badge badge-dark value-type">Type: string</span><br/>
    <span class="description"><p>Hostname or IP address of the NTP server.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionReturn_value_burst">
    <div class="card">
    <div class="card-header" id="headingReturn_value_burst">
    <h2 class="mb-0">
    <button aria-controls="Return_value_burst" aria-expanded="" class="btn btn-link property-name-button" data-target="#Return_value_burst" data-toggle="collapse" onclick="setAnchor('#Return_value_burst')" type="button"><span class="property-name">burst</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingReturn_value_burst" class="collapse property-definition-div" data-parent="#accordionReturn_value_burst" id="Return_value_burst">
    <div class="card-body pl-5">
    <h4>Burst</h4><span class="badge badge-dark value-type">Type: boolean</span> <span class="badge badge-success default-value">Default: false</span><br/>
    <span class="description"><p>Send a burst of packets when the server is reachable.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionReturn_value_iburst">
    <div class="card">
    <div class="card-header" id="headingReturn_value_iburst">
    <h2 class="mb-0">
    <button aria-controls="Return_value_iburst" aria-expanded="" class="btn btn-link property-name-button" data-target="#Return_value_iburst" data-toggle="collapse" onclick="setAnchor('#Return_value_iburst')" type="button"><span class="property-name">iburst</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingReturn_value_iburst" class="collapse property-definition-div" data-parent="#accordionReturn_value_iburst" id="Return_value_iburst">
    <div class="card-body pl-5">
    <h4>Iburst</h4><span class="badge badge-dark value-type">Type: boolean</span> <span class="badge badge-success default-value">Default: true</span><br/>
    <span class="description"><p>Send a burst of packets when the server is unreachable.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionReturn_value_prefer">
    <div class="card">
    <div class="card-header" id="headingReturn_value_prefer">
    <h2 class="mb-0">
    <button aria-controls="Return_value_prefer" aria-expanded="" class="btn btn-link property-name-button" data-target="#Return_value_prefer" data-toggle="collapse" onclick="setAnchor('#Return_value_prefer')" type="button"><span class="property-name">prefer</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingReturn_value_prefer" class="collapse property-definition-div" data-parent="#accordionReturn_value_prefer" id="Return_value_prefer">
    <div class="card-body pl-5">
    <h4>Prefer</h4><span class="badge badge-dark value-type">Type: boolean</span> <span class="badge badge-success default-value">Default: false</span><br/>
    <span class="description"><p>Mark this server as preferred for time synchronization.</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionReturn_value_minpoll">
    <div class="card">
    <div class="card-header" id="headingReturn_value_minpoll">
    <h2 class="mb-0">
    <button aria-controls="Return_value_minpoll" aria-expanded="" class="btn btn-link property-name-button" data-target="#Return_value_minpoll" data-toggle="collapse" onclick="setAnchor('#Return_value_minpoll')" type="button"><span class="property-name">minpoll</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingReturn_value_minpoll" class="collapse property-definition-div" data-parent="#accordionReturn_value_minpoll" id="Return_value_minpoll">
    <div class="card-body pl-5">
    <h4>Minpoll</h4><span class="badge badge-dark value-type">Type: integer</span> <span class="badge badge-success default-value">Default: 6</span><br/>
    <span class="description"><p>Minimum polling interval (log2 seconds).</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    <div class="accordion" id="accordionReturn_value_maxpoll">
    <div class="card">
    <div class="card-header" id="headingReturn_value_maxpoll">
    <h2 class="mb-0">
    <button aria-controls="Return_value_maxpoll" aria-expanded="" class="btn btn-link property-name-button" data-target="#Return_value_maxpoll" data-toggle="collapse" onclick="setAnchor('#Return_value_maxpoll')" type="button"><span class="property-name">maxpoll</span></button>
    </h2>
    </div>
    <div aria-labelledby="headingReturn_value_maxpoll" class="collapse property-definition-div" data-parent="#accordionReturn_value_maxpoll" id="Return_value_maxpoll">
    <div class="card-body pl-5">
    <h4>Maxpoll</h4><span class="badge badge-dark value-type">Type: integer</span> <span class="badge badge-success default-value">Default: 10</span><br/>
    <span class="description"><p>Maximum polling interval (log2 seconds).</p>
    </span>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div>
    </div><br><br>

*Required roles:* NETWORK_GENERAL_WRITE