Power control Trays

PATCH

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/tray/power

Power control Trays with optional filters. If no filter is specified, targets all trays in the Site.

Supported power states: on, off, cycle, forceoff, forcecycle.

Filter constraints:

rackId and rackName are mutually exclusive
rackId/rackName cannot be combined with ids/componentIds (rack-level vs component-level targeting)
componentIds requires type to be specified

Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix.

Power control Trays with optional filters. If no filter is specified, targets all trays in the Site. Supported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`. **Filter constraints:** - `rackId` and `rackName` are mutually exclusive - `rackId`/`rackName` cannot be combined with `ids`/`componentIds` (rack-level vs component-level targeting) - `componentIds` requires `type` to be specified Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

Request

This endpoint expects an object.

siteIdstringRequiredformat: "uuid"

ID of the Site

stateenumRequired

Target power state

filterobjectOptional

Filter that selects Trays whose power state should be updated

ruleIdstringOptionalformat: "uuid"

Optional Operation Rule UUID. When set, pins every task spawned by this batch to the named rule and overrides Flow's default rule resolution.

overrideReadinessCheckbooleanOptionalDefaults to false

When true, proceed even if one or more target components (or hosts on the owning rack for rack-scoped components) are reported as not ready by their persisted status. Intended for operator-supervised maintenance.

Response

taskIdslist of strings

List of task IDs created for the power control operation (one per rack)

Errors

400

Bad Request Error

403

Forbidden Error

$	curl -X PATCH https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/tray/power \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"siteId": "550e8400-e29b-41d4-a716-446655440000",
>	"state": "on"
>	}'