Querying the List of Deployed Containerized Applications on a Node

Function

Queries the list of containerized applications deployed on a specified node based on the node ID. The instance list of all containerized applications running on the node is returned based on the node ID, including the node and node group information, running status, and container status of these instances.

Syntax

Operation type: GET

URL: https://{ip}:{port}/edgemanager/v1/app/node?nodeID={id}

URL Parameters

**Table 1** URL parameter
Parameter	Mandatory/Optional	Description	Value
nodeID	Mandatory	Node ID	32-bit unsigned number. The minimum value is 1 and the maximum value is 2^32-1.

Usage Example

Request:

GET https://10.10.10.10:30035/edgemanager/v1/app/node?nodeID=2

Response:

{
    "status":"00000000",
    "msg":"success",
    "data":{
        "appInstances": [
            "appID":1,
            "appName":"testapp",
            "appStatus":"pending",
            "containerInfo":[
                {
                    "image":"euler_image:1.0",
                    "name":"testcontainer",
                    "status":"unknown",
                    "restartCount":0
                }
            ],
            "createdAt":"2022-12-14 08:47:42",
            "nodeGroupInfo":{
                 "nodeGroupID":1,
                 "nodeGroupName":"group1"
             },
             "nodeId":2,
             "nodeName":"localhost.localdomain",
             "nodeStatus":"ready"
        },
        {
            "appID":2,
            "appName":"testapp2",
            "appStatus":"pending",
            "containerInfo":[
                {
                    "image":"ubuntu:18.04",
                    "name":"c1",
                    "status":"unknown"
                    "restartCount":0
                }
            ],
            "createdAt":"2022-12-14 08:48:49",
            "nodeGroupInfo":{
                 "nodeGroupID":1,
                 "nodeGroupName":"group1"
                 },
            "nodeId":2,
            "nodeName":"localhost.localdomain",
            "nodeStatus":"ready"
            }
        ],
        "total": 2
    }
}

Response status code: 200

Output Description

For details about containerized application fields, see Request Parameters.

**Table 2** Operation output description
Field	Type	Description
status	String	Status code
msg	String	Description
data	Object	Query result

**Table 3** data field description
Field	Type	Description
appInstances	Object array	List of deployed containerized applications
total	Number	Total number of query results

**Table 4** appInstances field description
Field	Type	Description
appID	Number	Containerized application ID
appName	String	Name of a containerized application
appStatus	String	Pod running status: pending: waiting for processing running succeeded failed unknown
nodeGroupInfo	Object	Deployment node group information
nodeID	Number	Deployment node ID
nodeName	String	Deployment node name
nodeStatus	String	Node status: ready notReady offline unknown
createdAt	String	Creation time
contianerInfo	Object array	Pod information about containerized applications

**Table 5** containerInfo field description
Field	Type	Description
name	String	Container name in the pod of a containerized application
image	String	Container image name
status	String	Container running status in the pod: waiting running terminated unknown
restartCount	Number	Number of restart times of the container corresponding to a deployed containerized application

**Table 6** nodeGroupInfo field description
Field	Type	Description
nodeGroupID	Number	Node group ID
nodeGroupName	String	Node group name

Parent topic: Containerized Application Management APIs