文档首页 > > API参考> API> 部署管理 v3 (推荐)> 查询应用实例列表

查询应用实例列表

分享
更新时间: 2020/01/16 GMT+08:00

功能介绍

查询应用实例列表

URI

GET /v3/{project_id}/edgemgr/pods

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

node_id

String

指定节点查询应用实例, 可选

group_id

String

指定节点组查询应用实例,可选

deployment_id

String

指定应用部署ID查询应用实例, 可选

请求参数

响应参数

状态码为 200 时:

表3 响应Body参数

参数

参数类型

描述

count

Long

应用实例总数

pods

Array of PodResponse objects

-

表4 PodResponse

参数

参数类型

描述

id

String

应用实例uuid

name

String

应用实例名称

description

String

应用实例描述

configs

PodConfigs object

应用实例配置

affinity

PodAffinity object

应用实例亲和性规则

init_containers

Array of ContainerResp objects

应用实例init容器

containers

Array of ContainerResp objects

应用实例业务容器

node_id

String

应用实例所在节点

project_id

String

项目ID

reason

String

应用实例故障原因

message

String

应用实例故障详情

created_at

String

应用实例创建时间

updated_at

String

应用实例更新时间

state

String

应用实例状态

表5 ContainerResp

参数

参数类型

描述

args

Array of strings

容器启动参数

command

Array of strings

容器启动命令

name

String

容器名称,只允许英文小写字母、数字、中划线,最大长度32, 英文小写字母或数字开头和结尾

envs

Array of Env objects

容器环境变量键值对

image_url

String

容器镜像URL

liveness_probe

Probe object

工作负载存活探针配置

readiness_probe

Probe object

工作负载业务探针配置

ports

Array of HostContainerPortMapping objects

容器端口映射

resources

ResQuest object

资源量

volumes

Array of Volume objects

容器挂载卷

restarts

Long

容器重启次数

message

String

容器故障详情

reason

String

容器故障原因

表6 Volume

参数

参数类型

描述

name

String

卷名称,小写字母或数字,最长63个字符

type

String

卷的类型,支持configMap,secret,emptyDir,hostPath

read_only

Boolean

读写权限,默认读

source

String

卷来源,type为hostPath时输入路径,要求以/开头,后面可包含中划线,反斜杠,下划线,点号,字母,数字; secret时输入secret名称,configMap时输入configMap名称,emptyDir时输入disk或memory

destination

String

卷挂载路径,必须是合法的路径

表7 ResQuest

参数

参数类型

描述

limits

Res object

资源限制量

requests

Res object

资源申请量

表8 Res

参数

参数类型

描述

cpu

String

cpu核数,大于等于0.01,最大1000

memory

String

内存大小,单位兆,大于等于0.01,最大1024000。注意:内存的limits值最小为4

gpu

String

Gpu显存大小,单位兆,大于等于0.01,最大1024000

npu

String

Npu个数,大于0,最大1000

表9 HostContainerPortMapping

参数

参数类型

描述

container_port

Long

容器端口,1到65535之间的整数

host_port

Long

容器端口,1到65535之间的整数

表10 Probe

参数

参数类型

描述

http_get

HttpGet object

http健康检查

exec

表12 object

执行命令检查

initial_delay_seconds

Long

表示从工作负载启动后从多久开始探测,大于0且不大于3600的整数,默认为10

timeout_seconds

Long

表示探测超时时间,大于0且不大于3600的整数,默认为1

表11 HttpGet

参数

参数类型

描述

path

String

必须要以/开头,构造结果为:协议类型://主机地址:端口路径

port

Integer

探测的http端口,1到65535之间的整数

schema

String

协议类型,HTTP或HTTPS,默认HTTP

表12 Exec

参数

参数类型

描述

command

String

探针执行命令,最大长度10240个字符

表13 Env

参数

参数类型

描述

name

String

环境变量的key,由大小写字母或下划线开头,由数字、大小写字母、下划线组成,最大长度2048个字符

value

String

环境变量的value,最大长度2048个字符

表14 PodAffinity

参数

参数类型

描述

node_affinity

Array of MatchExpression objects

节点亲和性

pod_affinity

Array of MatchExpression objects

应用亲和性

表15 MatchExpression

参数

参数类型

描述

key

String

应用部署亲和规则的key

operator

String

亲和规则operator,In、Exists表示亲和,NotIn、DoesNotExist表示反亲和

values

Array of strings

-

表16 PodConfigs

参数

参数类型

描述

host_network

Boolean

应用实例是否启用主机网络,不启用则使用端口映射,默认值false

host_pid

Boolean

应用实例是否与主机共PID命名空间,默认值false

migration

Boolean

应用实例故障是否迁移,指定节点组部署时必选,默认值false

restart_policy

String

应用实例重启策略,可选值Always、IfNotPresent、Never

toleration_seconds

int

应用实例故障容忍时间,容忍时间到达后迁移应用实例,只在指定节点组部署时生效

状态码为 400 时:

表17 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述信息

状态码为 500 时:

表18 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述信息

请求示例

响应示例

状态码为 200 时:

{
    "count": 1,
    "pods": [
        {
            "id": "3e64d98a-37c5-43a6-9bfe-052b9083e362",
            "name": "app-test-69f9dc4b67-wfwn6",
            "description": "this is a test pod",
            "configs": {
                "host_network": true,
                "host_pid": true,
                "migration": true,
                "restart_policy": "Always",
                "toleration_seconds": 300
            },
            "affinity": {
                "node_affinity": [
                    {
                        "key": "name",
                        "operator": "In",
                        "values": [
                            "29d20c18-c20c-4a45-a087-42c766fc5d97",
                            "6758b61d-2645-4f10-a594-66bc6c3b8aa8"
                        ]
                    }
                ],
                "pod_affinity": [
                    {
                        "key": "name",
                        "operator": "In",
                        "values": [
                            "29d20c18-c20c-4a45-a087-42c766fc5d97",
                            "6758b61d-2645-4f10-a594-66bc6c3b8aa8"
                        ]
                    }
                ]
            },
            "init_containers": [
                {
                    "args": [
                        "-c",
                        "sleep 1000"
                    ],
                    "command": [
                        "/bin/bash"
                    ],
                    "name": "container-0",
                    "envs": [
                        {
                            "name": "CERT_PATH",
                            "value": "/opt/cert"
                        }
                    ],
                    "image_url": "swr.cn-north-1.myhuaweicloud.com/ief-test/nginx:0705",
                    "liveness_probe": {
                        "http_get": {
                            "path": "/",
                            "port": 80,
                            "schema": "http"
                        },
                        "initial_delay_seconds": 10,
                        "timeout_seconds": 10
                    },
                    "readiness_probe": {
                        "http_get": {
                            "path": "/",
                            "port": 80,
                            "schema": "http"
                        },
                        "initial_delay_seconds": 10,
                        "timeout_seconds": 10
                    },
                    "ports": [
                        {
                            "container_port": 80,
                            "host_port": 80
                        }
                    ],
                    "resources": {
                        "limits": {
                            "cpu": "0.25",
                            "memory": "500",
                            "gpu": "500"
                        },
                        "requests": {
                            "cpu": "0.25",
                            "memory": "500",
                            "gpu": "500"
                        }
                    },
                    "volumes": [
                        {
                            "name": "log-volume",
                            "type": "hostPath",
                            "read_only": false,
                            "source": "/var/IEF",
                            "destination": "/var/IEF"
                        }
                    ],
                    "restarts": 0,
                    "message": "",
                    "reason": ""
                }
            ],
            "containers": [
                {
                    "args": [
                        "-c",
                        "sleep 1000"
                    ],
                    "command": [
                        "/bin/bash"
                    ],
                    "name": "container-0",
                    "envs": [
                        {
                            "name": "CERT_PATH",
                            "value": "/opt/cert"
                        }
                    ],
                    "image_url": "swr.cn-north-1.myhuaweicloud.com/ief-test/nginx:0705",
                    "liveness_probe": {
                        "http_get": {
                            "path": "/",
                            "port": 80,
                            "schema": "http"
                        },
                        "initial_delay_seconds": 10,
                        "timeout_seconds": 10
                    },
                    "readiness_probe": {
                        "http_get": {
                            "path": "/",
                            "port": 80,
                            "schema": "http"
                        },
                        "initial_delay_seconds": 10,
                        "timeout_seconds": 10
                    },
                    "ports": [
                        {
                            "container_port": 80,
                            "host_port": 80
                        }
                    ],
                    "resources": {
                        "limits": {
                            "cpu": 0.25,
                            "memory": 500,
                            "gpu": 500
                        },
                        "requests": {
                            "cpu": 0.25,
                            "memory": 500,
                            "gpu": 500
                        }
                    },
                    "volumes": [
                        {
                            "name": "log-volume",
                            "type": "hostPath",
                            "read_only": false,
                            "source": "/var/IEF",
                            "destination": "/var/IEF"
                        }
                    ],
                    "restarts": 0,
                    "message": "",
                    "reason": ""
                }
            ],
            "node_id": "bcd83056c918480f8f190844bd425b23",
            "project_id": "bcd83056c918480f8f190844bd425b23",
            "reason": "",
            "message": "",
            "created_at": "2019-10-10T02:24:02.325Z",
            "updated_at": "2019-10-10T02:24:02.325Z",
            "state": "RUNNING"
        }
    ]
}

状态码为 400 时:

{
	"error_code" : "IEF.100001",
	"error_msg" : "PROJECT_ID not found"
}

状态码为 500 时:

{
	"error_code" : "IEF.100158",
	"error_msg" : "Fail to extract gpu infomation"
}

返回值

返回值

描述

200

Get pods

400

The request contains a syntax error or mistake, unable to complete your request

500

Server error, server error in processing requests

错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区