Skip to content

Conversation

christoph-zededa
Copy link
Contributor

add some LOC documentation


This document explains the Local Operator Console(LOC) from the API point of view.

This document is similarly structured as PROFILE.md, because the topic is very similar.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we also introduce LOC here? What it is, when it is needed, difference between LOC and LPS, etc. Or will there be a separate md file in the EVE repo that would be linked here?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added a short explanation and a table with the differences. If you know more differences, please let me know.

GET /api/v2/edgedevice/certs
```

Returns the controller certificates.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should also document the payload for each endpoint. Name of the mime type (application/x-proto-binary), protobuf message name + link to its definition.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added the mime type and the protobuf message name including the filename where it is defined.

POST /api/v2/edgedevice/id/$UUID/compound-config
```

Returns edge device config as part of the compound config. It also includes:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should mention that the device config is in the same format as from the controller (EdgeDevConfig) and also signed by the controller.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added the word "signed" and mention EdgeDevConfig and where it is defined.

POST /api/v2/edgedevice/id/$UUID/metrics
```

This is where the metrics are sent. Similar to the controller.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar to the controller -> Similar to the controller API

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed (twice).

@christoph-zededa christoph-zededa force-pushed the doc_loc branch 3 times, most recently from 75663d1 to eaeafdb Compare October 20, 2025 16:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants