查询应用列表

Path Parameters

subscription_name string required

resource_group_name string required

资源组

zone string required

可用区

workspace_name string required

Possible values: <= 63 characters

工作空间资源名称

Query Parameters

state enum

Possible values: [STATE_UNSPECIFIED, INIT, UPDATING, QUEUING, SCHEDULED, PROGRESSING, RUNNING, FAILED, DELETING, DELETED, SUSPENDING, SUSPENDED]

应用状态

owner_id string

拥有者唯一标识

page_size int32

可选，单页结果数，默认10，最大500，需为非负整数，如果不填或填0，则使用默认值。超过最大值则使用最大值，负值将返回错误

page_token string

可选，指定要使用的页码，默认1.如果未指定则使用默认值，非正值返回错误

filter string

可选，过滤条件，仅支持display_name、user_name、name状态的过滤条件,格式请参考：https://google.aip.dev/160

Responses

200
default

application/json

Schema

Example (from schema)

Schema

apps object[]

应用列表

Array [

name string

Possible values: non-empty and <= 63 characters

应用名称. 不填写，则由后台默认随机生成. 若填入,则需要遵循以下规范: 1、1～63个字符 2、小写字母开头，小写字母或数字结尾 3、可包含小写英文字母、数字、中划线-

display_name string required

应用显示名称. 填写需要遵循规则: 1、2～128个字符 2、以大小写字母或中文开头 3、可包含数字、点号（.）、下划线（_）、半角冒号（:）或连字符（-）

ownership object

所有权关系

template object

实例模板

init_containers object[]

初始化容器列表

Array [

name string

容器名称

image_path string required

镜像真实路径

command string[]

容器命令列表. 这个命令并不是在shell中运行,所以传统的shell指令('|'等)是不起作用的。如果要使用shell,您需要明确调用该shell

env object[]

容器环境变量列表

Array [

name string required

环境变量名称

value string required

环境变量值

need_mosaic boolean required

需要马赛克

]

resource_request object required

容器资源请求. 若资源请求为空时，取用resource spec的规格

property name* string

volume_mounts object[]

卷挂载

Array [

type enum required

Possible values: [MOUNT_TYPE_UNSPECIFIED, PV_AFS, CONFIGMAP, SECRET, PV_ACS]

挂载类型

name string

卷名

mount_path string

挂载路径

id string

AI文件存储配置

volume_capacity string

卷容量

subdir string

指定挂载卷下的子目录

]

liveness_probe object

探针

probe_type enum required

Possible values: [PROBE_TYPE_UNSPECIFIED, EXEC, HTTP_GET]

探针类型，取值exec、目前只支持exec类型，

exec object

命令行探针

command string[] required

使用命令行方式进行健康检查时，在容器内执行的命令.这个命令并不是在shell中运行,所以传统的shell指令('|'等)是不起作用的。如果要使用shell,您需要明确调用该shell。退出状态码0被视为存活/健康,非0为不健康

initial_delay_seconds int32

首次检测延迟，以容器启动完成为起点计算

period_seconds int32

检测间隔，检查执行的周期，默认为10秒，最小为1秒

readiness_probe object

探针

probe_type enum required

Possible values: [PROBE_TYPE_UNSPECIFIED, EXEC, HTTP_GET]

探针类型，取值exec、目前只支持exec类型，

exec object

命令行探针

command string[] required

initial_delay_seconds int32

首次检测延迟，以容器启动完成为起点计算

period_seconds int32

检测间隔，检查执行的周期，默认为10秒，最小为1秒

]

containers object[] required

容器列表

Array [

name string

容器名称

image_path string required

镜像真实路径

command string[]

容器命令列表. 这个命令并不是在shell中运行,所以传统的shell指令('|'等)是不起作用的。如果要使用shell,您需要明确调用该shell

env object[]

容器环境变量列表

Array [

name string required

环境变量名称

value string required

环境变量值

need_mosaic boolean required

需要马赛克

]

resource_request object required

容器资源请求. 若资源请求为空时，取用resource spec的规格

property name* string

volume_mounts object[]

卷挂载

Array [

type enum required

Possible values: [MOUNT_TYPE_UNSPECIFIED, PV_AFS, CONFIGMAP, SECRET, PV_ACS]

挂载类型

name string

卷名

mount_path string

挂载路径

id string

AI文件存储配置

volume_capacity string

卷容量

subdir string

指定挂载卷下的子目录

]

liveness_probe object

探针

probe_type enum required

Possible values: [PROBE_TYPE_UNSPECIFIED, EXEC, HTTP_GET]

探针类型，取值exec、目前只支持exec类型，

exec object

命令行探针

command string[] required

initial_delay_seconds int32

首次检测延迟，以容器启动完成为起点计算

period_seconds int32

检测间隔，检查执行的周期，默认为10秒，最小为1秒

readiness_probe object

探针

probe_type enum required

Possible values: [PROBE_TYPE_UNSPECIFIED, EXEC, HTTP_GET]

探针类型，取值exec、目前只支持exec类型，

exec object

命令行探针

command string[] required

initial_delay_seconds int32

首次检测延迟，以容器启动完成为起点计算

period_seconds int32

检测间隔，检查执行的周期，默认为10秒，最小为1秒

]

resource_spec object required

资源规格

name string

资源规格名称. 根据资源规格列表获取. 例: N2lS.Ie.I60.2

limits object

资源列表. key值: CPU(cpu)、内存(memory)、设备数量(device)

property name* string

requests object

资源列表. key值: CPU(cpu)、内存(memory)、设备数量(device)

property name* string

elastic_scaling object

弹性伸缩

elastic_scaling_on_time object[]

Possible values: <= 10

按时间弹性伸缩集合.beta版本

Array [

name string required

按时间弹性伸缩策略名称

display_name string

按时间弹性伸缩策略显示名称

id string

按时间弹性伸缩策略ID

uid string

按时间弹性伸缩策略UID

cycle enum required

Possible values: [STRATEGY_CYCLE_UNSPECIFIED, STRATEGY_CYCLE_ONCE, STRATEGY_CYCLE_EVERYDAY, STRATEGY_CYCLE_SUNDAY, STRATEGY_CYCLE_MONDAY, STRATEGY_CYCLE_TUESDAY, STRATEGY_CYCLE_WEDNESDAY, STRATEGY_CYCLE_THURSDAY, STRATEGY_CYCLE_FRIDAY, STRATEGY_CYCLE_SATURDAY]

策略执行周期

start_time date-time required

策略开始时间

end_time date-time

策略结束时间

action enum required

Possible values: [ACTION_TYPE_UNSPECIFIED, SCALE_IN, SCALE_OUT]

执行动作，分为横向扩容、横向缩容

replicas_change_each_time int32 required

Possible values: <= 128

每次改变副本数

]

resource_pool object required

资源池

name string

资源名称

display_name string

资源名称

vpc_id string

虚拟私有云, 选择公共集群时必填

available_zone string

应用实际可用区, 选择公共集群时必填

scheduling object required

调度相关

priority enum required

Possible values: [PRIORITY_UNSPECIFIED, NORMAL, HIGH, HIGHEST]

优先级. 默认为普通优先级

quota_type enum

Possible values: [QUOTA_TYPE_UNSPECIFIED, RESERVED, SPOT]

可选, 任务配额类型. 默认为reserved

hints string[]

模型缓存调度的 hints

instance_affinity enum

Possible values: [POD_AFFINITY_TYPE_UNSPECIFIED, POD_AFFINITY, POD_ANITAFFINITY]

副本亲和与反亲和，公共集群不可用

rolling_update_strategy object

滚动升级策略

max_surge string

指定可以超过期望的 Pod 数量的百分比，默认值25%，不能与max_unavailable同时为0

max_unavailable string

在升级过程中不可用 Pod 数量的百分比，默认值25%，不能与maxSurge同时为0

replicas int32

指定副本数

termination_grace_period_seconds int32

停止前的优雅退出时间(秒)

]

next_page_token string

(暂不支持)下一页的token，用户需将该值作为下一次请求的page_token透传回来

total_size int32

符合当前查询条件的后台数据总数

{
  "apps": [
    {
      "name": "string",
      "display_name": "string",
      "uid": "string",
      "id": "string",
      "ownership": {
        "user_name": "string",
        "user_id": "string",
        "tenant_id": "string",
        "requestor_id": "string"
      },
      "template": {
        "init_containers": [
          {
            "name": "string",
            "image_path": "string",
            "command": [
              "string"
            ],
            "env": [
              {
                "name": "string",
                "value": "string",
                "need_mosaic": true
              }
            ],
            "resource_request": {},
            "volume_mounts": [
              {
                "type": "MOUNT_TYPE_UNSPECIFIED",
                "name": "string",
                "mount_path": "string",
                "id": "string",
                "volume_capacity": "string",
                "subdir": "string"
              }
            ],
            "liveness_probe": {
              "probe_type": "PROBE_TYPE_UNSPECIFIED",
              "exec": {
                "command": [
                  "string"
                ]
              },
              "initial_delay_seconds": 0,
              "period_seconds": 0
            },
            "readiness_probe": {
              "probe_type": "PROBE_TYPE_UNSPECIFIED",
              "exec": {
                "command": [
                  "string"
                ]
              },
              "initial_delay_seconds": 0,
              "period_seconds": 0
            }
          }
        ],
        "containers": [
          {
            "name": "string",
            "image_path": "string",
            "command": [
              "string"
            ],
            "env": [
              {
                "name": "string",
                "value": "string",
                "need_mosaic": true
              }
            ],
            "resource_request": {},
            "volume_mounts": [
              {
                "type": "MOUNT_TYPE_UNSPECIFIED",
                "name": "string",
                "mount_path": "string",
                "id": "string",
                "volume_capacity": "string",
                "subdir": "string"
              }
            ],
            "liveness_probe": {
              "probe_type": "PROBE_TYPE_UNSPECIFIED",
              "exec": {
                "command": [
                  "string"
                ]
              },
              "initial_delay_seconds": 0,
              "period_seconds": 0
            },
            "readiness_probe": {
              "probe_type": "PROBE_TYPE_UNSPECIFIED",
              "exec": {
                "command": [
                  "string"
                ]
              },
              "initial_delay_seconds": 0,
              "period_seconds": 0
            }
          }
        ],
        "resource_spec": {
          "name": "string",
          "description": "string",
          "limits": {},
          "requests": {}
        }
      },
      "elastic_scaling": {
        "elastic_scaling_on_time": [
          {
            "name": "string",
            "display_name": "string",
            "id": "string",
            "uid": "string",
            "type": "SCALING_TYPE_UNSPECIFIED",
            "cycle": "STRATEGY_CYCLE_UNSPECIFIED",
            "start_time": "2024-12-05T02:41:59.434Z",
            "end_time": "2024-12-05T02:41:59.434Z",
            "action": "ACTION_TYPE_UNSPECIFIED",
            "replicas_change_each_time": 0,
            "create_time": "2024-12-05T02:41:59.434Z"
          }
        ]
      },
      "resource_pool": {
        "name": "string",
        "display_name": "string",
        "vpc_id": "string",
        "available_zone": "string"
      },
      "scheduling": {
        "priority": "PRIORITY_UNSPECIFIED",
        "quota_type": "QUOTA_TYPE_UNSPECIFIED",
        "hints": [
          "string"
        ],
        "instance_affinity": "POD_AFFINITY_TYPE_UNSPECIFIED"
      },
      "rolling_update_strategy": {
        "max_surge": "string",
        "max_unavailable": "string"
      },
      "replicas": 0,
      "state": "STATE_UNSPECIFIED",
      "ready_replicas": 0,
      "root_mapping": "string",
      "create_time": "2024-12-05T02:41:59.434Z",
      "update_time": "2024-12-05T02:41:59.434Z",
      "termination_grace_period_seconds": 0
    }
  ],
  "next_page_token": "string",
  "total_size": 0
}

Default error response

application/json

Schema

Example (from schema)

Schema

code int32

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

message string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

details object[]

A list of messages that carry the error details. There is a common set of message types for APIs to use.

Array [

@type string

The type of the serialized message.

]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

查询应用列表​

查询应用列表