Creates appliance's constraints values.

post https://api.gridx.de/clusters/{clusterID}/appliances/{applianceID}/constraints

Appliance constraints allows to set constraints to an appliance.

Constraints can consist in:

operational ranges, i.e min/max values. For example, to allow a battery to only discharge up to 2kW, set maxActivePower=0 and minActivePower=-2000.
To limit the power output of an inverter to 7kW, set minActivePower=-7000.
direct set points, i.e. the control value directly expected to be applied to an appliance. For example, to charge an EV with 2kW, set activePower = 2000.
Direct set point constraints are only considered if the local EMS is disabled for this system.

To each constraint is associated:

a date after which the constraint expires (invalidAt). Maximal allowed value for invalidAt is 25 hours in the future.
a priority level: 0-low, 2^31-1(2147483647)-high.
Note that constraints used for direct set points should have a priority greater or equal to 2000.
In case multiple constraints are set to a same field, or if conflicting constraints are set, the priority level allows to determine the final operating constraint.
For example the following two constraints are in conflict:
```
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "priority": 3000,
  "activePower": -1500,
  "minActivePower": -2000,
  "maxActivePower" : 0,
  "invalidAt": "1985-04-12T23:20:50Z"
}
```
```
{
  "id": "95f712de-89e4-43c4-9293-c667ef22c60a",
  "priority": 3001,
  "activePower": -2000,
  "minActivePower": -2000,
  "maxActivePower" : 0,
  "invalidAt": "1985-04-12T23:20:50Z"
}
```
the constraint with priority 3001 is considered first. In this case, the constraint with priority 3000 will be discarded.

Note: properties that are not required and are not set in the POST to create the constraints are considered as null (see nullable attribute).

Following section describes provided examples.

Examples description

Constraint applicable to appliance type battery

Use-Case 1: Charge battery via direct power control.

Active power Set Point = 600 Watt
```
{
  "priority": 2000,
  "invalidAt": "1985-04-12T23:20:50Z",
  "activePower": 600
}
```
📘
Note
Only applicable if the local EMS is disabled for this system.

Use-Case 2: Set Battery's min/max State of Charge.

Set stateOfCharge min/max values.

{
  "priority": 100,
  "deepDischargeStateOfCharge": 5,
  "minStateOfChargeLock": 15,
  "maxStateOfChargeLock": 95,
  "minStateOfCharge": 10,
  "maxStateOfCharge": 100,
  "id": "3c0d25f0-b199-4692-a529-d243aebef93a",
  "invalidAt": "1985-04-12T23:20:50Z",
}

📘
Note
Only applicable if the local EMS is enabled for this system.

Constraint applicable to appliance type EV

Use-Case 3: Set EV charging station's min/max power constraints

{
  "priority": 100,
  "id": "3c0d25f0-b199-4692-a529-d243aebef93a",
  "invalidAt": "1985-04-12T23:20:50Z",
  "maxActivePower": 1000,
  "minActivePower": -1000,
}

📘
Note
Only applicable if the local EMS is enabled for this system.

Constraint applicable to appliance type water heater

Use-Case 4: Set heater's constraints

Start heating via direct power control.
```
{
  "priority": 2000,
  "id": "3c0d25f0-b199-4692-a529-d243aebef93a",
  "invalidAt": "1985-04-12T23:20:50Z",
  "activePower": 600
}
```
📘
Note
Only applicable if the local EMS is disabled for this system.

Constraint applicable to appliance type Grid Connexion Point Meter

Use-Case 5: Set grid connection point's max apparent power

{
  "priority": 100,
  "id": "3c0d25f0-b199-4692-a529-d243aebef93a",
  "invalidAt": "1985-04-12T23:20:50Z",
  "maxApparentPower": 1200,
  "maxApparentPowerL1": 400,
  "maxApparentPowerL2": 400,
  "maxApparentPowerL3": 400
}

📘
Note
Only applicable if the local EMS is enabled for this system.

Constraint applicable to appliance type PV inverter

Use-Case 6: Limit PV inverter's max output power to 7 kW

The minActivePower property limits the maximum output power of the PV inverter.

{
  "priority": 2000,
  "gridConnectionPointPhaseMapping": [1, 2, 3],
  "id": "3c0d25f0-b199-4692-a529-d243aebef93a",
  "invalidAt": "1985-04-12T23:20:50Z",
  "minActivePower": -7000
}

Constraint applicable to appliance type smart-grid ready Heat Pump

Use-Case 7: Set heat pump active power constraint.

Set ActivePower to 3kW.

{
  "priority": 2000,
  "gridConnectionPointPhaseMapping": [1, 2, 3],
  "id": "3c0d25f0-b199-4692-a529-d243aebef93a",
  "invalidAt": "1985-04-12T23:20:50Z",
  "activePower": 3000
}

📘
Note
Only applicable if the local EMS is enabled for this system.