LitmusEdgeManager 2.31.x API Documentation/Admin Console APIs/Docker Registry - LE, LEM, LUNS API Docs

Image List

GET {{LEM_adminURL}}/admin/v1/registry/image

Image List

Returns the images stored in LEM's internal Docker registry. Each entry: name, tag, digest, timestamp, size.

Endpoint

GET {{LEM_adminURL}}/admin/v1/registry/image

Authentication

HTTP Basic Auth. Username is your API token, password is empty. Tokens are managed under System > Access Control > Tokens.

Errors

HTTP status	When it happens
`400 Bad Request`	Missing or malformed query/body parameter.
`401 Unauthorized`	Missing or invalid credentials.
`403 Forbidden`	Token lacks permission for this operation.
`404 Not Found`	Target entity does not exist.
`5xx`	Service is unreachable, restarting, or internally errored. Inspect device logs under `System > Support`.

TLS note: edge devices use a self-signed certificate by default. Either install the device CA in your client trust store or disable certificate verification when calling this endpoint directly.

Response

Status: 200 OK

[
    {
        "name": "python",
        "tag": "3.9",
        "digest": "sha256:ddf3e328f78494805eeb0c43b6754178a941ae93b26949e493368af633c9c8a2",
        "timestamp": 1698800006000,
        "size": 373886615
    }
]

Docker Pull

POST {{LEM_adminURL}}/admin/v1/registry/image/upload-remote?externalUrl=docker.io&externalName=python&externalTag=3.9&internalName=python&internalTag=3.9

Docker Pull

Pulls an image from an external registry into LEM's internal registry. Useful for mirroring vendor images to a self-hosted registry for offline edge deployments.

Endpoint

POST {{LEM_adminURL}}/admin/v1/registry/image/upload-remote?externalUrl=docker.io&externalName=python&externalTag=3.9&internalName=python&internalTag=3.9

Authentication

HTTP Basic Auth. Username is your API token, password is empty. Tokens are managed under System > Access Control > Tokens.

Parameters

Parameter	Description
`externalUrl`	Source registry (e.g. `docker.io`).
`externalName`	Source image name.
`externalTag`	Source tag.
`internalName`	Name to store as inside LEM's registry.
`internalTag`	Tag to store as.

Errors

HTTP status	When it happens
`400 Bad Request`	Missing or malformed query/body parameter.
`401 Unauthorized`	Missing or invalid credentials.
`403 Forbidden`	Token lacks permission for this operation.
`404 Not Found`	Target entity does not exist.
`5xx`	Service is unreachable, restarting, or internally errored. Inspect device logs under `System > Support`.

TLS note: edge devices use a self-signed certificate by default. Either install the device CA in your client trust store or disable certificate verification when calling this endpoint directly.

Response

Status: 200 OK

{
    "code": "S",
    "message": null,
    "messageDetails": null
}

Delete Image

DELETE {{LEM_adminURL}}/admin/v1/registry/image/?name=python&digest=sha256:ddf3e328f78494805eeb0c43b6754178a941ae93b26949e493368af633c9c8a2

Delete Image

Removes an image from LEM's registry by name + digest.

Endpoint

DELETE {{LEM_adminURL}}/admin/v1/registry/image/?name=python&digest=sha256:ddf3e328f78494805eeb0c43b6754178a941ae93b26949e493368af633c9c8a2

Authentication

HTTP Basic Auth. Username is your API token, password is empty. Tokens are managed under System > Access Control > Tokens.

Errors

HTTP status	When it happens
`400 Bad Request`	Missing or malformed query/body parameter.
`401 Unauthorized`	Missing or invalid credentials.
`403 Forbidden`	Token lacks permission for this operation.
`404 Not Found`	Target entity does not exist.
`5xx`	Service is unreachable, restarting, or internally errored. Inspect device logs under `System > Support`.

TLS note: edge devices use a self-signed certificate by default. Either install the device CA in your client trust store or disable certificate verification when calling this endpoint directly.

Response

Status: 204 No Content

Registry Info

GET {{LEM_adminURL}}/admin/v1/registry/info

Registry Info

Returns the registry's runtime state, auth state, and proxy config.

Endpoint

GET {{LEM_adminURL}}/admin/v1/registry/info

Authentication

HTTP Basic Auth. Username is your API token, password is empty. Tokens are managed under System > Access Control > Tokens.

Response

{ "state": true, "authState": true, "proxyState": true, "proxyUser": null }

Errors

HTTP status	When it happens
`400 Bad Request`	Missing or malformed query/body parameter.
`401 Unauthorized`	Missing or invalid credentials.
`403 Forbidden`	Token lacks permission for this operation.
`404 Not Found`	Target entity does not exist.
`5xx`	Service is unreachable, restarting, or internally errored. Inspect device logs under `System > Support`.

TLS note: edge devices use a self-signed certificate by default. Either install the device CA in your client trust store or disable certificate verification when calling this endpoint directly.

Response

Status: 200 OK

{
    "state": true,
    "authState": true,
    "proxyState": true,
    "proxyUser": null
}