List Operation Rules

GET

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/task/rule

GET

/v2/org/:org/nico/task/rule

$ curl -G https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/task/rule \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d siteId=siteId

1 [
2   {
3     "id": "a3f1c2d4-5b6e-7f89-0123-456789abcdef",
4     "name": "Rack Power Control Rule",
5     "operationType": "PowerControl",
6     "operationCode": "PWR_CTRL_001",
7     "ruleDefinition": {
8       "version": "v1",
9       "steps": [
10         {
11           "componentType": "Compute",
12           "stage": 1,
13           "mainOperation": {
14             "name": "Sleep",
15             "timeout": "PT10M",
16             "pollInterval": "PT30S",
17             "parameters": {}
18           },
19           "maxParallel": 3,
20           "timeout": "PT15M",
21           "retry": {
22             "maxAttempts": 3,
23             "initialInterval": "PT30S",
24             "backoffCoefficient": 1.5,
25             "maxInterval": "PT5M"
26           },
27           "preOperation": [
28             {
29               "name": "Sleep",
30               "timeout": "PT1M",
31               "pollInterval": "PT10S",
32               "parameters": {}
33             }
34           ],
35           "postOperation": [
36             {
37               "name": "Sleep",
38               "timeout": "PT2M",
39               "pollInterval": "PT15S",
40               "parameters": {}
41             }
42           ],
43           "delayAfter": "PT1M"
44         }
45       ]
46     },
47     "isDefault": true,
48     "created": "2024-01-15T09:30:00Z",
49     "updated": "2024-01-15T09:30:00Z",
50     "description": "Rule to manage power control operations on rack components"
51   }
52 ]

List Operation Rules on a Site. Filters compose with AND; results are paginated and the X-Pagination response header reports the total count over the post-filter set.

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

Query parameters

siteIdstringRequiredformat: "uuid"

ID of the Site that owns the rules (rules are site-scoped).

operationTypeenumOptional

Filter by operation type.

Allowed values:

pageNumberintegerOptional>=1

Page number of results returned (1-indexed).

pageSizeintegerOptional>=1

Number of results per page.

Response

idstringformat: "uuid"

Unique identifier of the rule.

namestring

Human-readable name of the rule. Required and non-empty.

operationTypeenum

Type of operation this rule applies to. Immutable after creation.

operationCodestring

Operation code within the operation type (e.g. power_on, power_off, upgrade). Server-side validated against Flow’s allow-list for the type. Immutable after creation.

ruleDefinitionobject

Executable definition of a rule. Mirrors Flow’s wire schema 1:1 so existing YAML rule files can be converted to JSON without any key renaming (nested fields use snake_case).

isDefaultboolean

Whether this rule is currently the default for its (operationType, operationCode) tuple.

createddatetime

Timestamp when the rule was created.

updateddatetime

Timestamp when the rule was last updated.

descriptionstring

Optional free-form description.

Errors

400

Bad Request Error

403

Forbidden Error