文档首页/ 智能数据湖 AI DataLake/ API参考/ 端点管理/ 创建端点 - CreateV2Endpoint
更新时间:2026-10-10 GMT+08:00
分享

创建端点 - CreateV2Endpoint

功能介绍

在工作空间下创建端点。此接口为异步接口,可通过查询端点详情接口获取操作结果。

调用方法

请参见如何调用API。

URI

POST /v2/workspaces/{workspace_id}/endpoints

表1 路径参数

参数

是否必选

参数类型

描述

workspace_id

是

String

参数解释:工作空间ID,可通过查询工作空间列表获取工作空间ID。

约束限制:不涉及。

取值范围:长度为32~36的英文字符、数字和中划线的组合。

默认取值:不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:用户Token,通过调用获取IAM用户Token接口获取。

约束限制:不涉及。

取值范围:只能由英文字母、数字及特殊字符组成,长度不超过65534个字符。Token格式由IAM服务定义,具体字符集参见IAM服务相关文档。

默认取值:不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

compute_id

否

String

参数解释:计算资源ID。可通过查询计算资源列表获取计算资源ID。

约束限制:预留模式和混合模式端点必填。

取值范围:长度为1~36个英文字母、数字和中划线的组合。

默认取值:不涉及。

name

是

String

参数解释:端点名称。

约束限制:不涉及。

取值范围:支持小写字母、数字、中划线,必须字母开头、字母或数字结尾,长度为1~63个字符。

默认取值:不涉及。

display_name

否

String

参数解释:端点显示名称。

约束限制:不涉及。

取值范围:长度为1~63个字符,支持字母、数字、中划线、汉字。

默认取值:不涉及。

description

否

String

参数解释:引擎端点描述信息。

约束限制:不涉及。

取值范围:长度为0~1000个字符,支持中文字符、英文字母、数字及特殊字符。

默认取值:不涉及。

engine

是

One of:

参数解释:引擎配置。

约束限制:type取值范围:SparkJob,SparkSql,RayJob,RayCluster,FlinkJob,AuraJob,AuraJobV2。

capacity

是

Array of V2EndpointCapacityItem objects

参数解释:计算资源容量配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

prometheus_config

否

PrometheusConfig object

参数解释:AOM接入配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

lts_config

否

LtsConfig object

参数解释:LTS(云日志服务)配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

credential

否

CredentialConfig object

参数解释:Endpoint级别用户委托名称,用于Endpoint的存储等配置权限认证,以及作为作业运行时的默认委托。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

resource_type

是

String

参数解释:资源使用模式。

约束限制:不涉及。

取值范围:

  • RESERVED:预留资源。

  • ONDEMAND:按需弹性。

  • HYBRID:混合模式。

默认取值:不涉及。

tags

否

Array of V2ResourceTag objects

参数解释:标签列表,每个元素为一个V2ResourceTag对象,包含key(标签键)和value(标签值)字段。

约束限制:最多20个标签。

表4 CreateSparkJob

参数

是否必选

参数类型

描述

spark_config

否

Map<String,String>

参数解释:Spark参数配置,Map的key为Spark配置参数名,value为对应的参数值。

约束限制:最大数量为100。

取值范围:不涉及。

默认取值:不涉及。

scheduling_config

否

SparkSchedulingConfig object

参数解释:SparkJob调度配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

staging_config

是

StagingConfig object

参数解释:临时存储配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

image

否

V2ImageBriefInfo object

参数解释:镜像配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表5 SparkSchedulingConfig

参数

是否必选

参数类型

描述

max_concurrent_jobs

否

Integer

参数解释:端点最大并发作业数量。

约束限制:不涉及。

取值范围:1~1000。

默认取值:200。

scheduling_policy

否

String

参数解释:作业调度策略,支持随机和先进先出。

约束限制:不涉及。

取值范围:

  • RANDOM:随机。

  • FIFO:先进先出。

默认取值:RANDOM。

fifo_tolerance_seconds

否

Integer

参数解释:FIFO允许并发时间(秒)。

约束限制:不涉及。

取值范围:0~3600。

默认取值:300。

表6 CreateSparkSql

参数

是否必选

参数类型

描述

spark_config

否

Map<String,String>

参数解释:SparkSql参数配置。

约束限制:最大数量为100。

取值范围:不涉及。

默认取值:不涉及。

staging_config

是

StagingConfig object

参数解释:临时存储配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

cluster_config

是

SparkClusterConfig object

参数解释:集群配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

max_endpoint_concurrent_queries

否

Integer

参数解释:端点最大并发SQL数量。

约束限制:不涉及。

取值范围:1~1000。

默认取值:300。

image

否

V2ImageBriefInfo object

参数解释:镜像配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表7 SparkClusterConfig

参数

是否必选

参数类型

描述

aging_time

否

Integer

参数解释:集群老化时间(小时)。

约束限制:不涉及。

取值范围:1~12。

默认取值:6。

auto_stop_config

否

AutoStopConfig object

参数解释:集群自动停止配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

driver_resource_spec

是

SparkDriverResourceSpec object

参数解释:SparkSql端点的Driver资源配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

executor_resource_spec

是

SparkExecutorResourceSpec object

参数解释:SparkSql端点的Executor资源配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

min_clusters

否

Integer

参数解释:最小集群数量。

约束限制:不涉及。

取值范围:0~20。

默认取值:2。

max_clusters

否

Integer

参数解释:最大集群数量。

约束限制:不涉及。

取值范围:2~20。

默认取值:6。

max_cluster_concurrent_queries

否

Integer

参数解释:集群最大并发SQL数量。

约束限制:不涉及。

取值范围:1~30。

默认取值:16。

表8 AutoStopConfig

参数

是否必选

参数类型

描述

enabled

否

Boolean

参数解释:自动停止集群开关。

约束限制:不涉及。

取值范围:

  • true:开启自动停止集群。

  • false:关闭自动停止集群。

默认取值:不涉及。

idle_timeout_minutes

否

Integer

参数解释:指定时间不活动后自动停止集群,单位分钟。

约束限制:不涉及。

取值范围:5~360。

默认取值:10。

表9 SparkDriverResourceSpec

参数

是否必选

参数类型

描述

cpu

是

Integer

参数解释:Spark Driver CPU,单位毫核。

约束限制:不涉及。

取值范围:1000~48000。

默认取值:不涉及。

memory

是

Integer

参数解释:Spark Driver内存大小,单位MB,1GB=1024MB。

约束限制:不涉及。

取值范围:1024~393216。

默认取值:不涉及。

表10 SparkExecutorResourceSpec

参数

是否必选

参数类型

描述

cpu

是

Integer

参数解释:Spark Executor CPU,单位毫核。

约束限制:不涉及。

取值范围:1000~48000。

默认取值:不涉及。

memory

是

Integer

参数解释:Spark Executor内存大小,单位MB,1GB=1024MB。

约束限制:不涉及。

取值范围:1024~393216。

默认取值:不涉及。

min_executor_numbers

是

Integer

参数解释:Spark Executor最小数量。

约束限制:不涉及。

取值范围:1~2147483647。

默认取值:不涉及。

max_executor_numbers

是

Integer

参数解释:Spark Executor最大数量。

约束限制:不涉及。

取值范围:1~1000。

默认取值:不涉及。

表11 CreateRayJob

参数

是否必选

参数类型

描述

history_server_config

否

CreateHistoryServerConfig object

参数解释:History Server配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表12 CreateRayCluster

参数

是否必选

参数类型

描述

cluster_config

是

RayClusterConfigV3 object

参数解释:Ray集群规格。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

redis_config

否

RedisConfig object

参数解释:Redis集群配置,目前仅支持DCS。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

storages_config

否

CreateStoragesConfig object

参数解释:存储资源配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

image

是

V2ImageBriefInfo object

参数解释:镜像配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

history_server_config

否

CreateHistoryServerConfig object

参数解释:History Server配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表13 RayClusterConfigV3

参数

是否必选

参数类型

描述

head_group_spec

是

HeadGroupSpecV3 object

参数解释:HeadGroup的配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

worker_group_specs

是

Array of WorkerGroupSpecV3 objects

参数解释:Worker Group的配置。

约束限制:不涉及。

表14 HeadGroupSpecV3

参数

是否必选

参数类型

描述

resource

是

ResourceSpecV3 object

参数解释:资源规格。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表15 WorkerGroupSpecV3

参数

是否必选

参数类型

描述

name

是

String

参数解释:Worker Group的名称。

约束限制:不涉及。

取值范围:长度0~128字母、数字、中划线的组合。

默认取值:不涉及。

min_replicas

是

Integer

参数解释:最小副本数。

约束限制:不涉及。

取值范围:0~10000。

默认取值:不涉及。

max_replicas

是

Integer

参数解释:最大副本数。

约束限制:不涉及。

取值范围:1~10000。

默认取值:不涉及。

resource

是

ResourceSpecV3 object

参数解释:资源规格。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表16 ResourceSpecV3

参数

是否必选

参数类型

描述

spec_code

是

String

参数解释:规格编码。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

cpu

是

Integer

参数解释:CPU核数量,单位为毫核。

约束限制:不涉及。

取值范围:0~1000000。

默认取值:0。

memory

是

Integer

参数解释:内存大小,单位MB。

约束限制:不涉及。

取值范围:0~10000000。

默认取值:0。

npu

否

Double

参数解释:昇腾卡数量。单位:个。

约束限制:暂时只支持整数。

取值范围:0~100。

默认取值:0。

gpu

否

Double

参数解释:GPU卡数量。单位:个。

约束限制:暂时只支持整数。

取值范围:0~100。

默认取值:0。

表17 RedisConfig

参数

是否必选

参数类型

描述

username

否

String

参数解释:账号名称。

约束限制:不涉及。

取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。

默认取值:default。

dew_secret_name

是

String

参数解释:DEW的凭据名称。存储着DCS账号的密码,格式为:凭据键为password,值为实际的密码。

约束限制:不涉及。

取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。

默认取值:不涉及。

ssl_enable

否

Boolean

参数解释:是否开启SSL。

约束限制:不涉及。

取值范围:

  • true:开启SSL。

  • false:关闭SSL。

默认取值:true。

dcs_id

是

String

参数解释:DCS实例的ID。获取方式:在DCS控制台实例详情页查看,或通过调用查询DCS实例列表接口获取。

约束限制:不涉及。

取值范围:支持英文字母、数字及中划线,长度为4~1024个字符。

默认取值:不涉及。

vpcep_service_id

是

String

参数解释:VPCEP服务端ID,用于连接客户侧网络。获取方式:在VPCEP控制台查看,或通过调用查询VPCEP服务列表接口获取。开启GCS高可用时必填,用于通过VPCEP方式连接客户侧DCS。

约束限制:开启GCS高可用时必填。

取值范围:不涉及。

默认取值:不涉及。

表18 CreateStoragesConfig

参数

是否必选

参数类型

描述

files

否

Array of CreateFileStorageConfig objects

参数解释:文件存储配置。

约束限制:最多10个文件存储配置。

取值范围:不涉及。

默认取值:不涉及。

表19 CreateFileStorageConfig

参数

是否必选

参数类型

描述

storage_id

是

String

参数解释:存储资源ID。

约束限制:不涉及。

取值范围:长度为1~36的英文字符、数字和中划线的组合。

默认取值:不涉及。

storage_path

否

String

参数解释:存储上的路径。

约束限制:存储支持的格式。

取值范围:最小长度为1,最大长度为1024。

默认取值:/。

mount_path

否

String

参数解释:挂载到容器的路径。

约束限制:容器本地支持的格式,且不能覆盖系统路径,限制必须挂载在/home/service/下。

取值范围:最小长度为1,最大长度为1024。

默认取值:/home/service/works。

表20 CreateHistoryServerConfig

参数

是否必选

参数类型

描述

enabled

否

Boolean

参数解释:存储历史服务器功能的启用/禁用状态。必须将其设置为“true”才能启用该功能。

约束限制:不涉及。

取值范围:

  • true:启用。

  • false:禁用。

默认取值:false。

obs

否

ObsConfig object

参数解释:OBS存储配置。指定对象存储服务(OBS)桶,用于存储History Server收集器采集的诊断数据(例如Flow Insight收集的数据)。该服务使用指定的委托(Agency)对该桶进行读写操作。当“enabled” 为“true”时,此字段为必填项。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表21 CreateFlinkJob

参数

是否必选

参数类型

描述

flink_config

否

Map<String,String>

参数解释:Flink参数配置,Map的key为Flink配置参数名,value为对应的参数值。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

staging_config

是

StagingConfig object

参数解释:临时存储配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

image

否

V2ImageBriefInfo object

参数解释:镜像配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表22 StagingConfig

参数

是否必选

参数类型

描述

obs

否

ObsConfig object

参数解释:OBS存储配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表23 ObsConfig

参数

是否必选

参数类型

描述

bucket_name

否

String

参数解释:OBS桶名称。该桶的类型必须是并行文件系统。

约束限制:不涉及。

取值范围:长度为3~63个字符,支持小写字母、数字、中划线和句点的组合。

默认取值:不涉及。

agency_name

否

String

参数解释:委托名称。云服务将使用该委托操作OBS桶。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表24 V2ImageBriefInfo

参数

是否必选

参数类型

描述

id

是

String

参数解释:镜像ID。可通过查询自定义镜像版本列表获取镜像版本ID。

约束限制:不涉及。

取值范围:长度为32~36的英文、数字、中划线的组合。

默认取值:不涉及。

version_id

是

String

参数解释:镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。

约束限制:不涉及。

取值范围:长度为32~36的英文、数字、中划线的组合。

默认取值:不涉及。

表25 CreateAuraJob

参数

是否必选

参数类型

描述

storages_config

否

StoragesConfig object

参数解释:存储资源配置。

约束限制:不涉及。

表26 CreateAuraJobV2

参数

是否必选

参数类型

描述

expand_cpu_resource

否

Boolean

参数解释:开启后,通算工作组作业能够使用智算工作组空闲CPU及内存资源,该操作可能会导致智算任务因资源不足而排队。

约束限制:不涉及。

取值范围:

  • true:开启通算工作组作业使用智算工作组空闲CPU及内存资源。

  • false:关闭通算工作组作业使用智算工作组空闲CPU及内存资源。

默认取值:false。

worker_group_config

是

Array of WorkerGroupConfig objects

参数解释:工作组补充配置,和外部capacity对应。

约束限制:最多10个。

staging_config

是

AuraV2StagingConfig object

参数解释:计算结果集OBS存储配置。

约束限制:不涉及。

storages_config

是

StoragesConfig object

参数解释:存储资源配置。

约束限制:不涉及。

表27 WorkerGroupConfig

参数

是否必选

参数类型

描述

name

是

String

参数解释:工作组名称。

约束限制:已有工作组名称不支持修改,需和当前工作组名称保持一致;新增工作组该字段必填。

取值范围:长度为1~63个字符,支持字母、数字和中划线的组合。

默认取值:不涉及。

spec_code

是

String

参数解释:节点规格。

约束限制:不涉及。

取值范围:支持英文字母、数字、小数点及连字符,长度为1~64个字符。

默认取值:不涉及。

cpu

否

Integer

参数解释:通算CPU大小,单位毫核。

约束限制:不涉及。

取值范围:0~2147483647。

默认取值:不涉及。

memory

否

Integer

参数解释:通算内存大小,单位MB。

约束限制:不涉及。

取值范围:0~2147483647。

默认取值:不涉及。

gpu

否

Double

参数解释:GPU卡数量。单位:个。

约束限制:暂时只支持整数。

取值范围:0~2147483647。

默认取值:不涉及。

npu

否

Double

参数解释:NPU卡数量。单位:个。

约束限制:暂时只支持整数。

取值范围:0~2147483647。

默认取值:不涉及。

image

否

ImageVersionInfo object

参数解释:镜像。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表28 ImageVersionInfo

参数

是否必选

参数类型

描述

id

是

String

参数解释:镜像ID。可通过查询自定义镜像版本列表获取镜像版本ID。

取值范围:不涉及。

约束限制:不涉及。

version_id

是

String

参数解释:自定义镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。

取值范围:不涉及。

约束限制:不涉及。

表29 AuraV2StagingConfig

参数

是否必选

参数类型

描述

obs

是

AuraV2ObsConfig object

参数解释:OBS存储配置。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表30 AuraV2ObsConfig

参数

是否必选

参数类型

描述

bucket_name

是

String

参数解释:OBS桶名称。

约束限制:不涉及。

取值范围:长度为3~63个字符,支持小写字母、数字、中划线和句点的组合。

默认取值:不涉及。

表31 StoragesConfig

参数

是否必选

参数类型

描述

files

是

Array of FileStorageConfig objects

参数解释:文件存储配置。

约束限制:最多10个文件存储配置。

表32 FileStorageConfig

参数

是否必选

参数类型

描述

storage_id

是

String

参数解释:存储资源ID。

约束限制:不涉及。

取值范围:长度为1~36的英文字符、数字和中划线的组合。

默认取值:不涉及。

storage_name

否

String

参数解释:存储的名称,对应PVC的名称。

约束限制:不涉及。

取值范围:支持小写字母、数字、中划线的组合,长度为1~63个字符。

默认取值:不涉及。

storage_path

否

String

参数解释:存储上的路径。

约束限制:不涉及。

取值范围:支持英文字母、数字、斜杠及特殊字符,最小长度为1,最大长度为1024。

默认取值:不涉及。

mount_path

否

String

参数解释:挂载到容器的路径。

约束限制:不涉及。

取值范围:支持英文字母、数字、斜杠及特殊字符,最小长度为1,最大长度为1024。

默认取值:不涉及。

表33 V2EndpointCapacityItem

参数

是否必选

参数类型

描述

type

是

String

参数解释:资源类型。

约束限制:不涉及。

取值范围:

  • CPU:中央处理器。

  • GPU:图形处理器。

  • NPU:神经网络处理器。

默认取值:不涉及。

maximum_capacity

是

Integer

参数解释:资源数量。CPU资源单位为核,GPU/NPU资源单位为个。

约束限制:不涉及。

取值范围:1~10000。

默认取值:不涉及。

minimum_capacity

是

Integer

参数解释:最小资源数量。CPU资源单位为核,GPU/NPU资源单位为个。

约束限制:不涉及。

取值范围:0~10000,小于等于maximum_capacity。

默认取值:不涉及。

spec_code

否

String

参数解释:资源规格。获取方式:从规格列表查询获取。

约束限制:预留资源和混合模式端点此参数必填。端点创建后此参数不支持变更。

取值范围:支持英文字母、数字、小数点及连字符,长度为1~64个字符。

默认取值:不涉及。

use_ondemand_resource

否

Boolean

参数解释:容量是否使用弹性资源。

约束限制:端点创建后此参数不支持变更。

取值范围:

  • true:使用弹性资源。

  • false:不使用弹性资源。

默认取值:false。

表34 PrometheusConfig

参数

是否必选

参数类型

描述

enable

否

Boolean

参数解释:是否接入AOM。

约束限制:不涉及。

取值范围:

  • true:接入AOM。

  • false:不接入AOM。

默认取值:false。

aom_prometheus_id

否

String

参数解释:AOM Prometheus实例ID,可通过AOM管理控制台或查询AOM Prometheus实例列表接口获取。

约束限制:不涉及。

取值范围:长度为0~256个字符,支持英文字符、数字、中划线和下划线的组合。

默认取值:不涉及。

表35 LtsConfig

参数

是否必选

参数类型

描述

enable

否

Boolean

参数解释:是否开启LTS日志。

约束限制:不涉及。

取值范围:

  • true:开启。

  • false:不开启。

默认取值:false。

lts_group_id

否

String

参数解释:LTS日志组ID,可在云日志服务LTS控制台日志管理页面的日志组列表查看。

约束限制:enable为true的时候需要配置。

取值范围:长度为1~36个字符,支持英文字符、数字和中划线的组合。

默认取值:不涉及。

lts_stream_id

否

String

参数解释:LTS日志流ID,可在云日志服务LTS控制台日志管理页面的日志组列表展开查看对应的日志流。

约束限制:enable为true的时候需要配置。

取值范围:长度为1~36个字符,支持英文字符、数字和中划线的组合。

默认取值:不涉及。

表36 CredentialConfig

参数

是否必选

参数类型

描述

agency_name

否

String

参数解释:Endpoint级别用户委托名称,用于Endpoint的存储等配置权限认证,以及作为作业运行时的默认委托。

约束限制:不涉及。

取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。

默认取值:不涉及。

表37 V2ResourceTag

参数

是否必选

参数类型

描述

key

是

String

参数解释:资源标签的键。

约束限制:不涉及。

取值范围:长度1~128的多语言字母、空格、数字、下划线、点、冒号、斜杠、等号、加号、减号、@符号组合。

默认取值:不涉及。

value

否

String

参数解释:资源标签的值。

约束限制:不涉及。

取值范围:长度0~255的多语言字母、空格、数字、下划线、点、冒号、斜杠、等号、加号、减号、@符号组合。

默认取值:不涉及。

响应参数

状态码:200

表38 响应Body参数

参数

参数类型

描述

id

String

参数解释:端点ID。

取值范围:长度为1~36的英文字符、数字和中划线的组合。

name

String

参数解释:端点名称。

取值范围:长度为1~63个字符,遵循RFC 1035规范,支持小写字母、数字、中划线,必须字母开头、字母或数字结尾。

display_name

String

参数解释:端点显示名称。

取值范围:长度为1~63个字符,支持小写字母、数字、中划线、汉字。

description

String

参数解释:资源描述信息。

取值范围:长度为0~1000个字符,支持中文字符、英文字母、数字及特殊字符。

status

String

参数解释:Endpoint状态。

取值范围:

  • CREATING:创建中。

  • RUNNING:运行中。

  • CREATE_FAILED:创建失败。

  • DELETING:删除中。

  • DELETED:已删除。

  • UPDATING:更新中。

  • UPDATE_FAILED:更新失败。

  • DELETE_FAILED:删除失败。

  • FROZEN:冻结。

  • TRIAL_ENDED:试用结束。

  • ON_DEMAND_FROZEN:按需冻结。

engine

One of:

参数解释:引擎配置。

capacity

Array of V2EndpointCapacityItem objects

参数解释:计算资源容量配置。

resource_type

String

参数解释:资源使用模式。

取值范围:

  • RESERVED:预留资源。

  • ONDEMAND:按需弹性。

  • HYBRID:混合模式。

create_time

String

参数解释:资源创建时间,使用UTC时间,ISO 8601格式,yyyy-MM-dd'T'HH:mm:ss.SSSXXX,例如:2025-01-10T03:37:12.000+00:00。

取值范围:不涉及。

update_time

String

参数解释:资源更新时间,使用UTC时间,ISO 8601格式,例如:2025-01-10T03:37:12.000+00:00。

取值范围:不涉及。

compute_id

String

参数解释:计算资源ID。

取值范围:长度为1~36个英文字母、数字和中划线的组合。

credential

CredentialConfig object

参数解释:Endpoint级别用户委托名称,用于Endpoint的存储等配置权限认证,以及作为作业运行时的默认委托。

creator

Creator object

参数解释:资源所有者信息。

tags

Array of ResourceTag objects

参数解释:资源标签列表。

error

Error object

参数解释:失败时返回的文本消息内容,包含错误码、错误描述。

prometheus_config

PrometheusConfig object

参数解释:AOM接入配置。

取值范围:不涉及。

lts_config

LtsConfig object

参数解释:LTS(云日志服务)配置。

表39 SparkJob

参数

参数类型

描述

type

String

参数解释:引擎类型。

取值范围:SparkJob。

spark_config

Map<String,String>

参数解释:Spark参数配置,Map的key为Spark配置参数名,value为对应的参数值。

scheduling_config

SparkSchedulingConfig object

参数解释:SparkJob调度配置。

staging_config

StagingConfig object

参数解释:临时存储配置。

image

V2ImageBriefInfo object

参数解释:镜像配置。

表40 SparkSchedulingConfig

参数

参数类型

描述

max_concurrent_jobs

Integer

参数解释:端点最大并发作业数量。

取值范围:1~1000。

scheduling_policy

String

参数解释:作业调度策略,支持随机和先进先出。

取值范围:

  • RANDOM:随机。

  • FIFO:先进先出。

fifo_tolerance_seconds

Integer

参数解释:FIFO允许并发时间(秒)。

取值范围:0~3600。

表41 SparkSql

参数

参数类型

描述

spark_config

Map<String,String>

参数解释:Spark参数配置,Map的key为Spark配置参数名,value为对应的参数值。

staging_config

StagingConfig object

参数解释:临时存储配置。

cluster_config

SparkClusterConfig object

参数解释:集群配置。

max_endpoint_concurrent_queries

Integer

参数解释:端点最大并发SQL数量。

取值范围:1~1000。

image

V2ImageBriefInfo object

参数解释:镜像配置。

表42 SparkClusterConfig

参数

参数类型

描述

aging_time

Integer

参数解释:集群老化时间(小时)。

取值范围:1~12。

auto_stop_config

AutoStopConfig object

参数解释:集群自动停止配置。

取值范围:不涉及。

driver_resource_spec

SparkDriverResourceSpec object

参数解释:SparkSql端点的Driver资源配置。

取值范围:不涉及。

executor_resource_spec

SparkExecutorResourceSpec object

参数解释:SparkSql端点的Executor资源配置。

取值范围:不涉及。

min_clusters

Integer

参数解释:最小集群数量。

取值范围:0~20。

max_clusters

Integer

参数解释:最大集群数量。

取值范围:2~20。

max_cluster_concurrent_queries

Integer

参数解释:集群最大并发SQL数量。

取值范围:1~30。

表43 AutoStopConfig

参数

参数类型

描述

enabled

Boolean

参数解释:自动停止集群开关。

取值范围:

  • true:开启自动停止集群。

  • false:关闭自动停止集群。

idle_timeout_minutes

Integer

参数解释:指定时间不活动后自动停止集群,单位分钟。

取值范围:5~360。

表44 SparkDriverResourceSpec

参数

参数类型

描述

cpu

Integer

参数解释:Spark Driver CPU,单位毫核。

取值范围:1000~48000。

memory

Integer

参数解释:Spark Driver内存大小,单位MB,1GB=1024MB。

取值范围:1024~393216。

表45 SparkExecutorResourceSpec

参数

参数类型

描述

cpu

Integer

参数解释:Spark Executor CPU,单位毫核。

取值范围:1000~48000。

memory

Integer

参数解释:Spark Executor内存大小,单位MB,1GB=1024MB。

取值范围:1024~393216。

min_executor_numbers

Integer

参数解释:Spark Executor最小数量。

取值范围:1~2147483647。

max_executor_numbers

Integer

参数解释:Spark Executor最大数量。

取值范围:1~1000。

表46 RayCluster

参数

参数类型

描述

cluster_config

RayClusterConfigV3 object

参数解释:Ray集群规格。

redis_config

RedisConfig object

参数解释:Redis集群配置,目前仅支持DCS。

storages_config

StoragesConfig object

参数解释:存储资源配置。

image

V2ImageBriefInfo object

参数解释:镜像配置。

ray_federation_id

String

参数解释:Ray联邦端点ID。

取值范围:不涉及。

history_server_config

HistoryServerConfig object

参数解释:History Server配置。

表47 RayClusterConfigV3

参数

参数类型

描述

head_group_spec

HeadGroupSpecV3 object

参数解释:HeadGroup的配置。

取值范围:不涉及。

worker_group_specs

Array of WorkerGroupSpecV3 objects

参数解释:Worker Group的配置。

表48 HeadGroupSpecV3

参数

参数类型

描述

resource

ResourceSpecV3 object

参数解释:资源规格。

取值范围:不涉及。

表49 WorkerGroupSpecV3

参数

参数类型

描述

name

String

参数解释:Worker Group的名称。

取值范围:长度0~128字母、数字、中划线的组合。

min_replicas

Integer

参数解释:最小副本数。

取值范围:0~10000。

max_replicas

Integer

参数解释:最大副本数。

取值范围:1~10000。

resource

ResourceSpecV3 object

参数解释:资源规格。

取值范围:不涉及。

表50 ResourceSpecV3

参数

参数类型

描述

spec_code

String

参数解释:规格编码。

取值范围:不涉及。

cpu

Integer

参数解释:CPU核数量,单位为毫核。

取值范围:0~1000000。

memory

Integer

参数解释:内存大小,单位MB。

取值范围:0~10000000。

npu

Double

参数解释:昇腾卡数量。单位:个。

取值范围:0~100。

gpu

Double

参数解释:GPU卡数量。单位:个。

取值范围:0~100。

表51 RedisConfig

参数

参数类型

描述

username

String

参数解释:账号名称。

取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。

dew_secret_name

String

参数解释:DEW的凭据名称。存储着DCS账号的密码,格式为:凭据键为password,值为实际的密码。

取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。

ssl_enable

Boolean

参数解释:是否开启SSL。

取值范围:

  • true:开启SSL。

  • false:关闭SSL。

dcs_id

String

参数解释:DCS实例的ID。获取方式:在DCS控制台实例详情页查看,或通过调用查询DCS实例列表接口获取。

取值范围:支持英文字母、数字及中划线,长度为4~1024个字符。

vpcep_service_id

String

参数解释:VPCEP服务端ID,用于连接客户侧网络。获取方式:在VPCEP控制台查看,或通过调用查询VPCEP服务列表接口获取。开启GCS高可用时必填,用于通过VPCEP方式连接客户侧DCS。

取值范围:不涉及。

表52 RayJob

参数

参数类型

描述

type

String

参数解释:引擎类型。

取值范围:RayJob。

history_server_config

HistoryServerConfig object

参数解释:History Server配置。

表53 HistoryServerConfig

参数

参数类型

描述

enabled

Boolean

参数解释:存储历史服务器功能的启用/禁用状态。必须将其设置为“true”才能启用该功能。

取值范围:

  • true:启用。

  • false:禁用。

obs

ObsConfig object

参数解释:OBS存储配置。指定对象存储服务(OBS)桶,用于存储History Server收集器采集的诊断数据(例如Flow Insight收集的数据)。该服务使用指定的委托(Agency)对该桶进行读写操作。当“enabled” 为“true”时,此字段为必填项。

取值范围:不涉及。

flow_insight_enabled

Boolean

参数解释:Flow Insight是一项诊断与可观测性功能,它从Ray集群收集指标、日志及工作流执行数据,并通过History Server收集器将其传输至已配置的OBS存储。该功能仅在“enabled”参数设置为“true”时可用。

取值范围:

  • true:启用。

  • false:禁用。

表54 FlinkJob

参数

参数类型

描述

type

String

参数解释:引擎类型。

取值范围:FlinkJob。

flink_config

Map<String,String>

参数解释:Flink参数配置,Map的key为Flink配置参数名,value为对应的参数值。

staging_config

StagingConfig object

参数解释:临时存储配置。

image

V2ImageBriefInfo object

参数解释:镜像配置。

表55 StagingConfig

参数

参数类型

描述

obs

ObsConfig object

参数解释:OBS存储配置。

取值范围:不涉及。

表56 ObsConfig

参数

参数类型

描述

bucket_name

String

参数解释:OBS桶名称。该桶的类型必须是并行文件系统。

取值范围:长度为3~63个字符,支持小写字母、数字、中划线和句点的组合。

agency_name

String

参数解释:委托名称。云服务将使用该委托操作OBS桶。

取值范围:不涉及。

表57 V2ImageBriefInfo

参数

参数类型

描述

id

String

参数解释:镜像ID。可通过查询自定义镜像版本列表获取镜像版本ID。

取值范围:长度为32~36的英文、数字、中划线的组合。

version_id

String

参数解释:镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。

取值范围:长度为32~36的英文、数字、中划线的组合。

表58 AuraJob

参数

参数类型

描述

storages_config

StoragesConfig object

参数解释:存储资源配置。

表59 AuraJobV2

参数

参数类型

描述

type

String

参数解释:引擎类型。

取值范围:AuraJobV2。

expand_cpu_resource

Boolean

参数解释:开启后,通算工作组作业能够使用智算工作组空闲CPU及内存资源,该操作可能会导致智算任务因资源不足而排队。

取值范围:

  • true:开启通算工作组作业使用智算工作组空闲CPU及内存资源。

  • false:关闭通算工作组作业使用智算工作组空闲CPU及内存资源。

worker_group_config

Array of WorkerGroupConfig objects

参数解释:工作组补充配置,和外部capacity对应。

staging_config

AuraV2StagingConfig object

参数解释:计算结果集OBS存储配置。

storages_config

StoragesConfig object

参数解释:存储资源配置。

表60 WorkerGroupConfig

参数

参数类型

描述

name

String

参数解释:工作组名称。

取值范围:长度为1~63个字符,支持字母、数字和中划线的组合。

spec_code

String

参数解释:节点规格。

取值范围:支持英文字母、数字、小数点及连字符,长度为1~64个字符。

cpu

Integer

参数解释:通算CPU大小,单位毫核。

取值范围:0~2147483647。

memory

Integer

参数解释:通算内存大小,单位MB。

取值范围:0~2147483647。

gpu

Double

参数解释:GPU卡数量。单位:个。

取值范围:0~2147483647。

npu

Double

参数解释:NPU卡数量。单位:个。

取值范围:0~2147483647。

image

ImageVersionInfo object

参数解释:镜像。

取值范围:不涉及。

表61 ImageVersionInfo

参数

参数类型

描述

id

String

参数解释:镜像ID。可通过查询自定义镜像版本列表获取镜像版本ID。

取值范围:不涉及。

version_id

String

参数解释:自定义镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。

取值范围:不涉及。

表62 AuraV2StagingConfig

参数

参数类型

描述

obs

AuraV2ObsConfig object

参数解释:OBS存储配置。

取值范围:不涉及。

表63 AuraV2ObsConfig

参数

参数类型

描述

bucket_name

String

参数解释:OBS桶名称。

取值范围:长度为3~63个字符,支持小写字母、数字、中划线和句点的组合。

表64 StoragesConfig

参数

参数类型

描述

files

Array of FileStorageConfig objects

参数解释:文件存储配置。

表65 FileStorageConfig

参数

参数类型

描述

storage_id

String

参数解释:存储资源ID。

取值范围:长度为1~36的英文字符、数字和中划线的组合。

storage_name

String

参数解释:存储的名称,对应PVC的名称。

取值范围:支持小写字母、数字、中划线的组合,长度为1~63个字符。

storage_path

String

参数解释:存储上的路径。

取值范围:支持英文字母、数字、斜杠及特殊字符,最小长度为1,最大长度为1024。

mount_path

String

参数解释:挂载到容器的路径。

取值范围:支持英文字母、数字、斜杠及特殊字符,最小长度为1,最大长度为1024。

表66 V2EndpointCapacityItem

参数

参数类型

描述

type

String

参数解释:资源类型。

取值范围:

  • CPU:中央处理器。

  • GPU:图形处理器。

  • NPU:神经网络处理器。

maximum_capacity

Integer

参数解释:资源数量。CPU资源单位为核,GPU/NPU资源单位为个。

取值范围:1~10000。

minimum_capacity

Integer

参数解释:最小资源数量。CPU资源单位为核,GPU/NPU资源单位为个。

取值范围:0~10000,小于等于maximum_capacity。

spec_code

String

参数解释:资源规格。获取方式:从规格列表查询获取。

取值范围:支持英文字母、数字、小数点及连字符,长度为1~64个字符。

use_ondemand_resource

Boolean

参数解释:容量是否使用弹性资源。

取值范围:

  • true:使用弹性资源。

  • false:不使用弹性资源。

表67 CredentialConfig

参数

参数类型

描述

agency_name

String

参数解释:Endpoint级别用户委托名称,用于Endpoint的存储等配置权限认证,以及作为作业运行时的默认委托。

取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。

表68 Creator

参数

参数类型

描述

domain_name

String

参数解释:租户名称。

取值范围:支持中文字符、英文字母、数字及特殊字符,长度为1~64个字符。

domain_id

String

参数解释:租户ID。

取值范围:支持英文字母、数字及中划线,长度为1~64个字符。

user_name

String

参数解释:用户名称。

取值范围:支持英文字母、数字、下划线的组合,长度为1~64个字符。

user_id

String

参数解释:用户ID。

取值范围:支持英文字母、数字及中划线,长度为1~64个字符。

表69 ResourceTag

参数

参数类型

描述

key

String

参数解释:资源标签的键。

取值范围:长度1~128的多语言字母、空格、数字、下划线、点、冒号、斜杠、等号、加号、减号、@符号组合。

value

String

参数解释:资源标签的值。

取值范围:长度0~255的多语言字母、空格、数字、下划线、点、冒号、斜杠、等号、加号、减号、@符号组合。

表70 Error

参数

参数类型

描述

error_code

String

参数解释:失败状态时的错误编码。

取值范围:支持英文字母、数字、小数点及下划线,长度为0~36个字符。

error_msg

String

参数解释:失败状态时的错误信息。

取值范围:支持中文字符、英文字母、数字及特殊字符,长度为0~1024个字符。

表71 PrometheusConfig

参数

参数类型

描述

enable

Boolean

参数解释:是否接入AOM。

取值范围:

  • true:接入AOM。

  • false:不接入AOM。

aom_prometheus_id

String

参数解释:AOM Prometheus实例ID,可通过AOM管理控制台或查询AOM Prometheus实例列表接口获取。

取值范围:长度为0~256个字符,支持英文字符、数字、中划线和下划线的组合。

表72 LtsConfig

参数

参数类型

描述

enable

Boolean

参数解释:是否开启LTS日志。

取值范围:

  • true:开启。

  • false:不开启。

lts_group_id

String

参数解释:LTS日志组ID,可在云日志服务LTS控制台日志管理页面的日志组列表查看。

取值范围:长度为1~36个字符,支持英文字符、数字和中划线的组合。

lts_stream_id

String

参数解释:LTS日志流ID,可在云日志服务LTS控制台日志管理页面的日志组列表展开查看对应的日志流。

取值范围:长度为1~36个字符,支持英文字符、数字和中划线的组合。

状态码:400

表73 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

状态码:401

表74 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

状态码:403

表75 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

状态码:404

表76 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

状态码:500

表77 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

请求示例

  • 在工作空间下创建AuraJobV2类型端点。

    POST /v2/workspaces/{workspace_id}/endpoints
    
    {
      "name" : "aura-job-sune",
      "display_name" : "endpoint-01",
      "description" : "测试端点",
      "resource_type" : "RESERVED",
      "engine" : {
        "type" : "AuraJobV2",
        "staging_config" : {
          "obs" : {
            "bucket_name" : "1316265"
          }
        },
        "storages_config" : {
          "files" : [ {
            "storage_id" : "0df94743-6210-4134-bc46-acf3b46d9705"
          } ]
        },
        "expand_cpu_resource" : false,
        "worker_group_config" : [ {
          "spec_code" : "aidatalake.cpu.x86.general.1c4g",
          "cpu" : 1000,
          "memory" : 2048,
          "gpu" : 0,
          "npu" : 0,
          "name" : "WorkerGroup-1djd",
          "image" : {
            "id" : "94499750-bab9-4f51-bcd7-53ef6bf3a64b",
            "version_id" : "35e2204c-a915-4e4f-92f3-a0c7f8ffaabb"
          }
        }, {
          "spec_code" : "aidatalake.gpu.m.lnt002.2x.d",
          "cpu" : 13000,
          "memory" : 53248,
          "gpu" : 1,
          "npu" : 0,
          "name" : "WorkerGroup-s1lu",
          "image" : {
            "id" : "94499750-bab9-4f51-bcd7-53ef6bf3a64b",
            "version_id" : "35e2204c-a915-4e4f-92f3-a0c7f8ffaabb"
          }
        } ]
      },
      "compute_id" : "00030bf1-4466-4c84-b32d-f601b136f03b",
      "capacity" : [ {
        "type" : "CPU",
        "minimum_capacity" : 0,
        "maximum_capacity" : 10,
        "use_ondemand_resource" : false,
        "spec_code" : "aidatalake.cpu.x86.general.1c4g"
      }, {
        "type" : "GPU",
        "minimum_capacity" : 1,
        "maximum_capacity" : 1,
        "spec_code" : "aidatalake.gpu.m.lnt002.2x.d",
        "use_ondemand_resource" : false
      } ],
      "lts_config" : {
        "enable" : false
      }
    }
  • 在工作空间下创建SparkSql类型端点,配置集群资源规格和自动停止策略。

    POST /v2/workspaces/{workspace_id}/endpoints
    
    {
      "compute_id" : "0150a336-dda9-431c-9ef1-af02ec424a5e",
      "name" : "spark-sql-test",
      "display_name" : "spark-sql-test",
      "resource_type" : "RESERVED",
      "engine" : {
        "type" : "SparkSql",
        "spark_config" : { },
        "staging_config" : {
          "obs" : {
            "bucket_name" : "ai4db",
            "agency_name" : "aidatalake-spark"
          }
        },
        "cluster_config" : {
          "aging_time" : 6,
          "auto_stop_config" : {
            "enabled" : true,
            "idle_timeout_minutes" : 10
          },
          "driver_resource_spec" : {
            "cpu" : 4000,
            "memory" : 32768
          },
          "executor_resource_spec" : {
            "cpu" : 4000,
            "memory" : 32768,
            "min_executor_numbers" : 2,
            "max_executor_numbers" : 8
          },
          "min_clusters" : 0,
          "max_clusters" : 6,
          "max_cluster_concurrent_queries" : 16
        },
        "max_endpoint_concurrent_queries" : 300
      },
      "capacity" : [ {
        "type" : "CPU",
        "maximum_capacity" : 1000,
        "minimum_capacity" : 0,
        "use_ondemand_resource" : false,
        "spec_code" : "aidatalake.cpu.x86.general.1c2g"
      } ]
    }
  • 在工作空间下创建SparkJob类型端点,配置调度策略和OBS存储。

    POST /v2/workspaces/{workspace_id}/endpoints
    
    {
      "compute_id" : "0150a336-dda9-431c-9ef1-af02ec424a5e",
      "name" : "spark-job-test",
      "display_name" : "spark-job-test",
      "resource_type" : "RESERVED",
      "engine" : {
        "type" : "SparkJob",
        "spark_config" : { },
        "scheduling_config" : {
          "max_concurrent_jobs" : 300,
          "scheduling_policy" : "RANDOM"
        },
        "staging_config" : {
          "obs" : {
            "bucket_name" : "ai4db",
            "agency_name" : "aidatalake-spark"
          }
        }
      },
      "capacity" : [ {
        "type" : "CPU",
        "maximum_capacity" : 1000,
        "minimum_capacity" : 0,
        "use_ondemand_resource" : false,
        "spec_code" : "aidatalake.cpu.x86.general.1c2g"
      } ],
      "credential" : {
        "agency_name" : "aidatalake-spark"
      }
    }

响应示例

状态码:200

  • 创建AuraJobV2类型端点,返回创建中的端点信息。

    {
      "id" : "0b5633ba2b904511ad514346f4d23d4b",
      "name" : "aura-job-sune",
      "display_name" : "endpoint-01",
      "description" : "测试端点",
      "status" : "CREATING",
      "engine" : {
        "type" : "AuraJobV2",
        "worker_group_config" : [ {
          "name" : "WorkerGroup-wpif",
          "spec_code" : "aidatalake.cpu.x86.general.1c4g",
          "cpu" : 1000,
          "memory" : 2048,
          "gpu" : 0,
          "npu" : 0,
          "image" : {
            "id" : "94499750-bab9-4f51-bcd7-53ef6bf3a64b",
            "version_id" : "35e2204c-a915-4e4f-92f3-a0c7f8ffaabb"
          }
        } ],
        "staging_config" : {
          "obs" : {
            "bucket_name" : "1316265"
          }
        },
        "storages_config" : {
          "files" : [ {
            "storage_id" : "0df94743-6210-4134-bc46-acf3b46d9705"
          } ]
        }
      },
      "resource_type" : "RESERVED",
      "compute_id" : "00030bf1-4466-4c84-b32d-f601b136f03b",
      "capacity" : [ {
        "type" : "CPU",
        "maximum_capacity" : 10,
        "minimum_capacity" : 0,
        "use_ondemand_resource" : false,
        "spec_code" : "aidatalake.cpu.x86.general.1c4g"
      } ],
      "create_time" : "2025-01-10T03:37:12.000+00:00",
      "update_time" : "2025-01-10T03:37:12.000+00:00",
      "creator" : {
        "domain_name" : "test",
        "domain_id" : "0676610f3a0a4c2c80c50bea7ddf18c1",
        "user_id" : "019e19fb78887b57b2f6c4174cd5a002",
        "user_name" : "developer"
      },
      "lts_config" : {
        "enable" : false
      },
      "tags" : [ {
        "key" : "test",
        "value" : "ai"
      } ]
    }
  • 创建SparkSql类型端点,返回创建中的端点信息。

    {
      "id" : "1a2b3c4d5e6f7890abcdef1234567890",
      "name" : "spark-sql-test",
      "display_name" : "spark-sql-test",
      "description" : "SparkSql测试端点",
      "status" : "CREATING",
      "engine" : {
        "type" : "SparkSql",
        "spark_config" : { },
        "cluster_config" : {
          "aging_time" : 6,
          "auto_stop_config" : {
            "enabled" : true,
            "idle_timeout_minutes" : 10
          },
          "driver_resource_spec" : {
            "cpu" : 4000,
            "memory" : 32768
          },
          "executor_resource_spec" : {
            "cpu" : 4000,
            "memory" : 32768,
            "min_executor_numbers" : 2,
            "max_executor_numbers" : 8
          },
          "min_clusters" : 0,
          "max_clusters" : 6,
          "max_cluster_concurrent_queries" : 16
        },
        "max_endpoint_concurrent_queries" : 300
      },
      "resource_type" : "RESERVED",
      "compute_id" : "0150a336-dda9-431c-9ef1-af02ec424a5e",
      "capacity" : [ {
        "type" : "CPU",
        "maximum_capacity" : 1000,
        "minimum_capacity" : 0,
        "use_ondemand_resource" : false,
        "spec_code" : "aidatalake.cpu.x86.general.1c2g"
      } ],
      "create_time" : "2025-01-10T03:37:12.000+00:00",
      "update_time" : "2025-01-10T03:37:12.000+00:00",
      "creator" : {
        "domain_name" : "test",
        "domain_id" : "0676610f3a0a4c2c80c50bea7ddf18c1",
        "user_id" : "019e19fb78887b57b2f6c4174cd5a002",
        "user_name" : "developer"
      },
      "tags" : [ {
        "key" : "test",
        "value" : "ai"
      } ]
    }
  • 创建SparkJob类型端点,返回创建中的端点信息。

    {
      "id" : "2b3c4d5e6f7890abcdef1234567890ab",
      "name" : "spark-job-test",
      "display_name" : "spark-job-test",
      "description" : "SparkJob测试端点",
      "status" : "CREATING",
      "engine" : {
        "type" : "SparkJob",
        "spark_config" : { },
        "scheduling_config" : {
          "max_concurrent_jobs" : 300,
          "scheduling_policy" : "RANDOM"
        }
      },
      "resource_type" : "RESERVED",
      "compute_id" : "0150a336-dda9-431c-9ef1-af02ec424a5e",
      "capacity" : [ {
        "type" : "CPU",
        "maximum_capacity" : 1000,
        "minimum_capacity" : 0,
        "use_ondemand_resource" : false,
        "spec_code" : "aidatalake.cpu.x86.general.1c2g"
      } ],
      "create_time" : "2025-01-10T03:37:12.000+00:00",
      "update_time" : "2025-01-10T03:37:12.000+00:00",
      "creator" : {
        "domain_name" : "test",
        "domain_id" : "0676610f3a0a4c2c80c50bea7ddf18c1",
        "user_id" : "019e19fb78887b57b2f6c4174cd5a002",
        "user_name" : "developer"
      },
      "tags" : [ {
        "key" : "test",
        "value" : "ai"
      } ]
    }

状态码:400

{
  "error_code" : "AIDataLake.00010151",
  "error_msg" : "Parameter value is invalid.",
  "solution_msg" : "Please input valid parameter value."
}

状态码:401

{
  "error_code" : "APIGW.0301",
  "error_msg" : "Incorrect IAM authentication information: decrypt token fail.",
  "solution_msg" : "Check whether the IAM authentication information is correct."
}

状态码:403

{
  "error_code" : "AIDataLake.00010150",
  "error_msg" : "The operation is not allowed.",
  "solution_msg" : "Check whether the operation is allowed in the current status."
}

状态码:404

{
  "error_code" : "AIDataLake.00010009",
  "error_msg" : "No resources found.",
  "solution_msg" : "Ensure the requested resource exists and the parameters are correct."
}

状态码:500

{
  "error_code" : "AIDataLake.00011001",
  "error_msg" : "Internal error.",
  "solution_msg" : "Contact technical support or try again later."
}

状态码

状态码

描述

200

请求下发成功。

400

请求参数错误。

401

未授权。

403

禁止访问。

404

资源未找到。

500

内部服务器错误。

相关文档