获取应用详情

Path Parameters

subscription_name string required

订阅名称

resource_group_name string required

资源组名称

zone string required

可用区

workspace_name string required

Possible values: <= 63 characters

工作空间名称

app_name string required

应用名称

Responses

200
default

application/json

Schema

Example (from schema)

Schema

name string

Possible values: non-empty and <= 63 characters

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

display_name string required

Possible values: non-empty and <= 256 characters

应用显示名称。填写需要遵循以下规则： 1. 1～256 个字符。 2. 以中文字符、英文字母或数字开头。 3. 由中文字符、英文字母、数字、点号（.）、半角冒号（:）、下划线（_）和连字符（-）组成

ownership object

所有权关系

template object

实例模板

init_containers object[]

初始化容器列表

Array [

name string

容器名称

image_path string required

镜像地址

command string[]

容器命令列表。命令不会在 shell 中运行，传统的 shell 指令（如 '|'）无效。如果需要使用 shell，需显式调用。注意：当前端请求（通过 x-ui-valid 头标识）时，系统会自动将命令包装为 ["bash", "-c", ...原始命令...] 以支持 shell 语法。非前端请求保持原始格式

env object[]

容器环境变量列表

Array [

name string required

Possible values: <= 255 characters

环境变量名称。可以包含字母(A-Z, a-z)、数字(0-9)、下划线(_)、点(.)或短横线(-)，但第一个字符不能是数字。参考: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/

value string required

环境变量值

need_mosaic boolean required

是否需要马赛克处理

]

resource_request object required

容器资源请求。如果为空，则使用资源规格中的默认值

property name* string

volume_mounts object[]

卷挂载

Array [

type enum required

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

挂载类型

name string

卷名称

mount_path string

挂载路径

id string

卷 ID

volume_capacity string

卷容量

subdir string

指定挂载卷下的子目录

zone string

可用区

endpoint string

挂载卷的 endpoint

mount_options string

挂载选项。当前仅支持通过 GeeseFS 挂载 AOSS 时的相关配置。示例：--no-preload-dir --uid=1000 其中 no-preload-dir 表示关闭预加载功能，uid=1000 表示设置文件所有者为用户ID1000

]

liveness_probe object

存活探针

probe_type enum required

Possible values: [PROBE_TYPE_UNSPECIFIED, EXEC, HTTP_GET]

探针类型，目前仅支持 exec 类型

exec object

命令行探针

command string[] required

使用命令行方式进行健康检查时，在容器内执行的命令。该命令不会在 shell 中运行，因此传统的 shell 指令（如 '|'）无效。如果需要使用 shell，需显式调用。退出状态码为 0 表示存活/健康，非 0 表示不健康

initial_delay_seconds int32

首次检测延迟时间（秒），从容器启动完成开始计算

period_seconds int32

检测间隔时间（秒），默认为 10 秒，最小值为 1 秒

timeout_seconds int32

Possible values: >= 1

探测超时时间（秒），默认为 1 秒，最小值为 1 秒

failure_threshold int32

Possible values: >= 1

探测失败的阈值，连续失败次数达到该值后认为探针失败，默认为 3，最小值为 1

readiness_probe object

就绪探针

probe_type enum required

Possible values: [PROBE_TYPE_UNSPECIFIED, EXEC, HTTP_GET]

探针类型，目前仅支持 exec 类型

exec object

命令行探针

command string[] required

initial_delay_seconds int32

首次检测延迟时间（秒），从容器启动完成开始计算

period_seconds int32

检测间隔时间（秒），默认为 10 秒，最小值为 1 秒

timeout_seconds int32

Possible values: >= 1

探测超时时间（秒），默认为 1 秒，最小值为 1 秒

failure_threshold int32

Possible values: >= 1

探测失败的阈值，连续失败次数达到该值后认为探针失败，默认为 3，最小值为 1

metadata object

元数据。支持的元数据键: - access_key: 访问密钥 ID。 - secret_key: 明文私密密钥 (与 encrypted_secret_key 二选一)。 - encrypted_secret_key: 加密后的私密密钥 (JWE A256GCM 加密格式)，安全存储场景下优先使用该字段替代明文 secret_key

items object[]

键值对数组

Array [

key string

元数据条目的键

value string

元数据条目的值

]

containers object[] required

容器列表

Array [

name string

容器名称

image_path string required

镜像地址

command string[]

env object[]

容器环境变量列表

Array [

name string required

Possible values: <= 255 characters

value string required

环境变量值

need_mosaic boolean required

是否需要马赛克处理

]

resource_request object required

容器资源请求。如果为空，则使用资源规格中的默认值

property name* string

volume_mounts object[]

卷挂载

Array [

type enum required

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

挂载类型

name string

卷名称

mount_path string

挂载路径

id string

卷 ID

volume_capacity string

卷容量

subdir string

指定挂载卷下的子目录

zone string

可用区

endpoint string

挂载卷的 endpoint

mount_options string

]

liveness_probe object

存活探针

probe_type enum required

Possible values: [PROBE_TYPE_UNSPECIFIED, EXEC, HTTP_GET]

探针类型，目前仅支持 exec 类型

exec object

命令行探针

command string[] required

initial_delay_seconds int32

首次检测延迟时间（秒），从容器启动完成开始计算

period_seconds int32

检测间隔时间（秒），默认为 10 秒，最小值为 1 秒

timeout_seconds int32

Possible values: >= 1

探测超时时间（秒），默认为 1 秒，最小值为 1 秒

failure_threshold int32

Possible values: >= 1

探测失败的阈值，连续失败次数达到该值后认为探针失败，默认为 3，最小值为 1

readiness_probe object

就绪探针

probe_type enum required

Possible values: [PROBE_TYPE_UNSPECIFIED, EXEC, HTTP_GET]

探针类型，目前仅支持 exec 类型

exec object

命令行探针

command string[] required

initial_delay_seconds int32

首次检测延迟时间（秒），从容器启动完成开始计算

period_seconds int32

检测间隔时间（秒），默认为 10 秒，最小值为 1 秒

timeout_seconds int32

Possible values: >= 1

探测超时时间（秒），默认为 1 秒，最小值为 1 秒

failure_threshold int32

Possible values: >= 1

探测失败的阈值，连续失败次数达到该值后认为探针失败，默认为 3，最小值为 1

metadata object

items object[]

键值对数组

Array [

key string

元数据条目的键

value string

元数据条目的值

]

resource_spec object required

计算资源规格

name string

资源规格名称，例如：N2lS.Ie.I60.2

limits object

资源限制列表，键值包括：CPU(cpu)、内存(memory)、设备数量(device)

property name* string

requests object

资源请求列表，键值包括：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

资源池

name string

资源名称

display_name string

资源显示名称

vpc_id string

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

available_zone string

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

scheduling object

调度

priority enum required

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

优先级，默认为 NORMAL 优先级

quota_type enum

Possible values: [QUOTA_TYPE_UNSPECIFIED, RESERVED, SPOT]

可选，配额类型，默认为 Reserved

hints string[]

模型缓存调度的提示信息

instance_affinity enum

Possible values: [POD_AFFINITY_TYPE_UNSPECIFIED, POD_AFFINITY, POD_ANITAFFINITY]

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

scoring_strategy object

评分策略

type enum

Possible values: [MOST_ALLOCATED, LEAST_ALLOCATED]

评分策略类型

rolling_update_strategy object

滚动升级策略

max_surge string

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

max_unavailable string

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

steps string[]

分批发布步骤，支持数字或 0-100% 百分比，表示每批发布的 Pod 数量或比例

replicas int32

指定副本数

termination_grace_period_seconds int32

停止前的优雅退出时间（秒）

{
  "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",
            "zone": "string",
            "endpoint": "string",
            "mount_options": "string"
          }
        ],
        "liveness_probe": {
          "probe_type": "PROBE_TYPE_UNSPECIFIED",
          "exec": {
            "command": [
              "string"
            ]
          },
          "initial_delay_seconds": 0,
          "period_seconds": 0,
          "timeout_seconds": 0,
          "failure_threshold": 0
        },
        "readiness_probe": {
          "probe_type": "PROBE_TYPE_UNSPECIFIED",
          "exec": {
            "command": [
              "string"
            ]
          },
          "initial_delay_seconds": 0,
          "period_seconds": 0,
          "timeout_seconds": 0,
          "failure_threshold": 0
        },
        "metadata": {
          "items": [
            {
              "key": "string",
              "value": "string"
            }
          ]
        }
      }
    ],
    "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",
            "zone": "string",
            "endpoint": "string",
            "mount_options": "string"
          }
        ],
        "liveness_probe": {
          "probe_type": "PROBE_TYPE_UNSPECIFIED",
          "exec": {
            "command": [
              "string"
            ]
          },
          "initial_delay_seconds": 0,
          "period_seconds": 0,
          "timeout_seconds": 0,
          "failure_threshold": 0
        },
        "readiness_probe": {
          "probe_type": "PROBE_TYPE_UNSPECIFIED",
          "exec": {
            "command": [
              "string"
            ]
          },
          "initial_delay_seconds": 0,
          "period_seconds": 0,
          "timeout_seconds": 0,
          "failure_threshold": 0
        },
        "metadata": {
          "items": [
            {
              "key": "string",
              "value": "string"
            }
          ]
        }
      }
    ],
    "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": "2026-01-08T07:57:50.284Z",
        "end_time": "2026-01-08T07:57:50.284Z",
        "action": "ACTION_TYPE_UNSPECIFIED",
        "replicas_change_each_time": 0,
        "create_time": "2026-01-08T07:57:50.284Z"
      }
    ]
  },
  "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",
    "scoring_strategy": {
      "type": "MOST_ALLOCATED"
    }
  },
  "rolling_update_strategy": {
    "max_surge": "string",
    "max_unavailable": "string",
    "steps": [
      "string"
    ],
    "step": 0
  },
  "replicas": 0,
  "state": "STATE_UNSPECIFIED",
  "ready_replicas": 0,
  "root_mapping": "string",
  "create_time": "2026-01-08T07:57:50.284Z",
  "update_time": "2026-01-08T07:57:50.284Z",
  "termination_grace_period_seconds": 0,
  "current_revision": "string",
  "update_revision": "string",
  "update_replicas": 0,
  "ready_step": 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"
    }
  ]
}

获取应用详情​

获取应用详情