Skip to content

Commit

Permalink
docs: rename local mgmt api (#2845)
Browse files Browse the repository at this point in the history
* docs: rename local mgmt api

* docs: incorprate feedback

---------

Co-authored-by: Lenny Chen <lenny.chen@spectrocloud.com>
(cherry picked from commit 88c8bc3)
  • Loading branch information
lennessyy committed May 15, 2024
1 parent 2654420 commit 6318548
Showing 1 changed file with 11 additions and 15 deletions.
26 changes: 11 additions & 15 deletions docs/api-content/api-docs/1-introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,7 @@ sidebar_custom_props:
icon: "graph"
---

The API documentation section includes documentation for Palette API and Edge Host API. Edge Host API endpoints are Tech
Preview features and should not be used in production workloads.
The API documentation section includes documentation for Palette API and Local Management API.

## Palette API

Expand Down Expand Up @@ -155,8 +154,6 @@ The API response for the list includes the listMeta resource that contains the `
you need to check whether the `continue` token value is present in the API response. For subsequent requests, use the
`continue` token as a query parameter to paginate the remaining resource items.

<br />

```json hideClipboard
"listmeta": {
"continue": "eyJvZmZzZXQiOjUwLCJjb3VudCI6MTE3LCJ0b2tlbiI6IiJ9",
Expand All @@ -166,12 +163,8 @@ you need to check whether the `continue` token value is present in the API respo
}
```

<br />

Example of a subsequent request using the `continue` token.

<br />

```shell hideClipboard
curl --location 'https://api.spectrocloud.com/v1/packs?continue=eyJvZmZzZXQiOjUwLCJjb3VudCI6MTE3LCJ0b2tlbiI6IiJ9' \
--header 'Accept: application/json' \
Expand Down Expand Up @@ -267,12 +260,15 @@ The API rate limits are as follows:
| /v1/clusterprofiles/:uid/validate/packs | 50 | 5 | 250 |
| /v1/spectroclusters/:uid/profiles | 50 | 5 | 250 |

## Edge Host API
## Local Management API

An Edge host has its own set of API endpoints. These API endpoints are available on each Edge host instead of on a
Palette instance. You can use Edge Host API endpoints to programmatically perform tasks such as retrieve information
about Edge clusters, retrieve the list of available images on your Edge host, and create local clusters using embedded
cluster definitions.
Palette instance. You can use Local Management API endpoints to programmatically perform tasks such as retrieve
information about Edge clusters, retrieve the list of available images on your Edge host, and create local clusters
using embedded cluster definitions.

You can find the Open API Swagger specification for the Local Management API at the following location:
https://raw.githubusercontent.com/spectrocloud/librarium/version-4-3/docs/api-content/api-docs/edge-v1/emc-api.json

:::preview

Expand Down Expand Up @@ -304,9 +300,9 @@ If your credentials are valid, you will receive a authorization token.
```

Include this token in the header of your subsequent requests to the Edge Host API to authenticate your requests. For
example, the following request retrieves information about the Edge host such as the processor architecture and the host
name.
Include this token in the header of your subsequent requests to the Local Management API to authenticate your requests.
For example, the following request retrieves information about the Edge host such as the processor architecture and the
host name.

```shell
curl --location 'https://10.10.135.182:5080/v1/edge-mgmt/edgehosts/current' \
Expand Down

0 comments on commit 6318548

Please sign in to comment.