附录
更新时间:2024-09-25
基础类型
Tag
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| tagKey | String | 否 | 标签名 不可重复,有效的tag key必须由字母数字字符、'-'、'.'组成,并且必须以字母数字字符开始和结束。 |
| tagValue | String | 否 | 标签值 |
Label
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| labelKey | String | 否 | 标签名 |
| labelValue | String | 否 | 标签值 |
Port
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| name | String | 否 | 端口名 |
| port | Integer | 否 | 端口号 |
| protocol | String | 否 | 协议类型。 取值范围: TCP UDP |
HTTPHeader
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| name | String | 否 | http header name |
| value | String | 否 | http header value |
Environment
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| key | String | 否 | 环境变量名 |
| value | String | 否 | 环境变量值 |
ExecAction
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| command | List<String> | 否 | 使用命令行方式进行健康检查时,在容器内执行的命令。 |
TCPSocketAction
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| port | Integer | 否 | 使用TCP Socket方式进行健康检查时,TCP Socket检测的端口。 |
| host | String | 否 | 使用TCP Socket方式进行健康检查时,TCP Socket检测host。 |
HTTPGetAction
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| path | String | 否 | 使用HTTP请求方式进行健康检查时,HTTP Get请求检测的路径。 |
| port | Integer | 否 | 使用HTTP请求方式进行健康检查时,HTTP Get请求检测的端口号。 |
| scheme | String | 否 | 使用HTTP请求方式进行健康检查时,HTTP Get请求对应的协议类型,取值范围: HTTP HTTPS |
| host | String | 否 | 使用HTTP请求方式进行健康检查时,host值。 |
| httpHeaders | List<HTTPHeader> | 否 | 使用HTTP请求方式进行健康检查时,http header。 |
GRPCAction
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| port | Integer | 否 | 使用GRPC方式进行健康检查时,GRPC检测的端口。 |
| service | String | 否 | 使用GRPC方式进行健康检查时,GRPC检测服务。 |
实例相关
Probe
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| initialDelaySeconds | Integer | 否 | 检查开始执行的时间,以容器启动完成为起点计算。 |
| timeoutSeconds | Integer | 否 | 检查超时的时间,默认为1秒,最小为1秒。 |
| periodSeconds | Integer | 否 | 检查执行的周期,默认为10秒,最小为1秒。 |
| successThreshold | Integer | 否 | 从上次检查失败后重新认定检查成功的检查次数阈值(必须是连续成功),默认为1。当前必须为1。 |
| failureThreshold | Integer | 否 | 从上次检查成功后认定检查失败的检查次数阈值(必须是连续失败),默认为3。 |
| terminationGracePeriodSeconds | Long | 否 | 程序的缓冲时间,用于处理关闭之前的操作。 |
| httpGet | HTTPGetAction | 否 | HttpGet检测参数。 |
| tcpSocket | TCPSocketAction | 否 | TcpSocket检测的端口参数。 |
| exec | ExecAction | 否 | 容器内检测命令参数。 |
| grpc | GRPCAction | 否 | grpc检测的端口参数。 |
Container
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| name | String | 是 | 容器名 长度必须介于1和40之间,不可重复,有效的名称必须由字母数字字符、“-”或“.”组成,并且必须以字母数字字符开始和结束。 |
| image | String | 是 | 镜像 |
| memory | Float | 否 | 内存,单位:GiB。 限制该容器最多可使用的内存值,该值不可超过容器实例的总内存值。 |
| cpu | Float | 否 | CPU,单位:核。 限制容器最多可使用的核数,该值不可超过容器实例的总核数。 |
| gpu | Float | 否 | 容器使用的GPU个数 |
| workingDir | String | 否 | 容器工作目录 |
| imagePullPolicy | String | 否 | 镜像拉取策略。 取值范围: Always:总是拉取。每次都拉取镜像。 IfNotPresent:按需拉取。优先使用本地镜像,本地没有镜像时则拉取镜像。 Never:从不拉取。使用本地镜像,不拉取镜像。 |
| commands | List<String> | 是 | 容器启动命令 |
| args | List<String> | 否 | 容器启动参数 |
| volumeMounts | List<VolumeMount> | 是 | 数据卷挂载信息 |
| ports | List<Port> | 否 | 容器内端口信息 |
| environmentVars | List<Environment> | 否 | 容器内操作系统的环境变量 |
| livenessProbe | Probe | 否 | 存活探针 |
| readinessProbe | Probe | 否 | 就绪探针 |
| startupProbe | Probe | 否 | 启动探针 |
| stdin | Boolean | 否 | 此容器是否应在容器运行时为标准输入分配缓冲区。 如果未设置,则容器中标准输入的读取值将导致EOF。 默认值:false |
| stdinOnce | Boolean | 否 | 当标准输入为true时,标准输入流将在多个附加会话中是否保持开启状态。默认值:false |
| tty | Boolean | 否 | 是否开启交互。 当Command为/bin/bash命令时,需要设置为true。 默认值:false |
| securityContext | ContainerSecurityContext | 否 | 容器安全上下文信息。 |
InstanceModel
| 参数 | 类型 | 描述 |
|---|---|---|
| instanceId | String | 实例ID |
| instanceName | String | 实例名称,即容器组名称。 |
| status | String | 实例状态。可能值:状态信息不标准。 |
| zoneName | String | 实例所属的可用区 |
| cpuType | String | cpu类型 |
| gpuType | String | gpu类型 |
| cpu | Float | cpu核数,单位核 |
| memory | Float | memory大小,单位GiB |
| bandwidthInMbps | Integer | 弹性公网IP带宽大小,单位为Mb。 |
| internalIp | String | 内网Ip |
| publicIp | String | 外网Ip |
| createTime | String | 接到请求后的系统创建时间。UTC时间,RFC3339标准。 |
| updateTime | String | 实例更新时间 |
| deleteTime | String | 实例删除时间 |
| restartPolicy | String | 容器组的重启策略。取值范围: |
| tags | List<Tag> | 实例的标签键值对 |
InstanceDetailModel
继承InstanceModel,并新增如下字段:
| 参数 | 类型 | 描述 |
|---|---|---|
| volume | Volume | 容器实例存储卷 |
| containers | List<ContainerDetailModel> | 业务容器 |
| initContainers | List<ContainerDetailModel> | init容器 |
| securityGroups | List<SecurityGroupModel> | 安全组信息 |
| vpc | VpcModel | vpc信息 |
| subnet | SubnetModel | 子网信息 |
ContainerDetailModel
| 参数 | 类型 | 描述 |
|---|---|---|
| name | String | 容器名称 |
| image | String | 容器镜像 |
| cpu | Float | cpu数量 |
| gpu | Float | gpu数量 |
| memory | Float | 内存大小 |
| workingDir | String | 容器工作目录 |
| imagePullPolicy | String | 镜像拉取策略 |
| commands | List<String> | 容器启动命令 |
| args | List<String> | 容器启动参数 |
| ports | List<Port> | 容器内端口信息 |
| volumeMounts | List<VolumeMount> | 容器存储卷信息 |
| envs | List<Environment> | 容器环境变量列表 |
| createTime | String | 容器创建时间 |
| updateTime | String | 容器更新时间 |
| deleteTime | String | 容器删除时间 |
| previousState | ContainerStatus | 容器上一次状态 |
| currentState | ContainerStatus | 容器当前状态 |
| ready | Boolean | 容器是否已通过其就绪探针 |
| restartCount | Integer | 重启次数 |
ContainerStatus
| 参数 | 类型 | 描述 |
|---|---|---|
| state | String | 容器状态。可能值: |
| reason | String | 容器状态Reason |
| message | String | 容器状态信息 |
| startTime | String | 容器运行开始时间 |
| finishTime | String | 容器运行结束时间 |
| detailStatus | String | 状态详情 |
| exitCode | Integer | 容器运行退出码 |
SecurityGroupModel
| 参数 | 类型 | 描述 |
|---|---|---|
| securityGroupId | String | 安全组 Id |
| name | String | 安全组名称 |
| description | String | 安全组描述 |
| vpcId | String | vpc Id |
SubnetModel
| 参数 | 类型 | 描述 |
|---|---|---|
| subnetId | String | 子网ID |
| name | String | 子网名称 |
| cidr | String | 网段及子网掩码 |
| vpcId | String | vpcID |
| subnetType | String | 子网类型 |
| description | String | subnet描述 |
| createTime | String | 创建时间 |
VpcModel
| 参数 | 类型 | 描述 |
|---|---|---|
| vpcId | String | vpc Id |
| name | String | vpc名称 |
| cidr | String | 网段及子网掩码 |
| createTime | String | 创建时间 |
| description | String | vpc描述 |
| isDefault | Boolean | 是否是默认vpc |
存储卷相关
Volume
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| nfs | List<NfsVolume> | 否 | NFS类型数据卷,表示网络文件系统 |
| emptyDir | List<EmptyDirVolume> | 否 | EmptyDir类型数据卷,表示空目录 |
| configFile | List<ConfigFileVolume> | 否 | ConfigFile类型数据卷,表示配置文件 |
NfsVolume
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| name | String | 是 | NFS服务器名称。 |
| server | String | 是 | NFS服务器地址。 |
| path | String | 是 | NFS数据卷路径。 |
| readOnly | Boolean | 否 | NFS数据卷是否只读,默认为false。 |
EmptyDirVolume
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| name | String | 是 | EmptyDirVolume名称。 |
| medium | String | 否 | EmptyDirVolume的存储媒介,默认为空,使用node文件系统;支持 memory,表示使用内存。 |
| sizeLimit | Float | 否 | EmptyDirVolume的大小。单位为GiB。 |
ConfigFileVolume
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| name | String | 是 | ConfigFileVolume名称 |
| defaultMode | Integer | 是 | ConfigFileVolume默认的权限。 |
| configFiles | List<ConfigFileDetail> | 是 | ConfigFile类型的数据卷信息。 |
ConfigFileDetail
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| path | String | 是 | ConfigFile文件路径 |
| file | String | 是 | ConfigFile文件名 |
VolumeMount
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| name | String | 是 | 数据卷名称 |
| type | String | 是 | 数据卷类型 |
| mountPath | String | 是 | 容器挂载数据卷的目录 |
| readOnly | Boolean | 否 | 数据卷是否只读 默认值:false |
镜像相关
ImageRegistryCredential
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| server | String | 否 | 镜像仓库注册地址 |
| userName | String | 否 | 镜像仓库用户名 |
| password | String | 否 | 镜像仓库密码 |
OriginImage
| 字段名 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| originImageAddress | String | 否 | 原始镜像地址 |
| originImageVersion | String | 否 | 原始镜像版本 |
ImageCacheModel
| 参数 | 类型 | 描述 |
|---|---|---|
| imageCacheId | String | 镜像缓存id,全局唯一 |
| originImages | List<String> | 用户原始镜像地址 |
| status | String | 镜像缓存制作状态。可能状态为:创建成功,创建失败,创建中 |
| progress | Integer | 镜像缓存制作进度,范围[0,100]的正整数 |
| expiredTime | TimeStamp | 镜像缓存超时回收时间 |
| createdTime | TimeStamp | 镜像缓存创建时间 |
| lastestMatchedTime | TimeStamp | 镜像缓存最近一次使用时间 |
安全特性相关
ContainerSecurityContext
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| capabilities | Capabilities | 否 | 安全特性能力 |
| runAsUser | Long | 否 | 运行容器的用户ID |
| runAsGroup | Long | 否 | 运行容器进程入口点的GID |
| runAsNonRoot | Boolean | 否 | 容器是否必须以非root用户运行 |
| readOnlyRootFilesystem | Boolean | 否 | 容器运行的根文件系统是否为只读,默认为false |
Capabilities
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| add | List<String> | 否 | 启用安全能力项列表 |
| drop | List<String> | 否 | 禁用安全能力项列表 |
