创建端点 - CreateV2Endpoint
功能介绍
在工作空间下创建端点。此接口为异步接口,可通过查询端点详情接口获取操作结果。
调用方法
请参见如何调用API。
URI
POST /v2/workspaces/{workspace_id}/endpoints
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| workspace_id | 是 | String | 参数解释:工作空间ID,可通过查询工作空间列表获取工作空间ID。 约束限制:不涉及。 取值范围:长度为32~36的英文字符、数字和中划线的组合。 默认取值:不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释:用户Token,通过调用获取IAM用户Token接口获取。 约束限制:不涉及。 取值范围:只能由英文字母、数字及特殊字符组成,长度不超过65534个字符。Token格式由IAM服务定义,具体字符集参见IAM服务相关文档。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 参数解释:资源使用模式。 约束限制:不涉及。 取值范围: 默认取值:不涉及。 |
| tags | 否 | Array of V2ResourceTag objects | 参数解释:标签列表,每个元素为一个V2ResourceTag对象,包含key(标签键)和value(标签值)字段。 约束限制:最多20个标签。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| spark_config | 否 | Map<String,String> | 参数解释:Spark参数配置,Map的key为Spark配置参数名,value为对应的参数值。 约束限制:最大数量为100。 取值范围:不涉及。 默认取值:不涉及。 |
| scheduling_config | 否 | SparkSchedulingConfig object | 参数解释:SparkJob调度配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| staging_config | 是 | StagingConfig object | 参数解释:临时存储配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| image | 否 | V2ImageBriefInfo object | 参数解释:镜像配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| max_concurrent_jobs | 否 | Integer | 参数解释:端点最大并发作业数量。 约束限制:不涉及。 取值范围:1~1000。 默认取值:200。 |
| scheduling_policy | 否 | String | 参数解释:作业调度策略,支持随机和先进先出。 约束限制:不涉及。 取值范围: 默认取值:RANDOM。 |
| fifo_tolerance_seconds | 否 | Integer | 参数解释:FIFO允许并发时间(秒)。 约束限制:不涉及。 取值范围:0~3600。 默认取值:300。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 参数解释:镜像配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enabled | 否 | Boolean | 参数解释:自动停止集群开关。 约束限制:不涉及。 取值范围: 默认取值:不涉及。 |
| idle_timeout_minutes | 否 | Integer | 参数解释:指定时间不活动后自动停止集群,单位分钟。 约束限制:不涉及。 取值范围:5~360。 默认取值:10。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| cpu | 是 | Integer | 参数解释:Spark Driver CPU,单位毫核。 约束限制:不涉及。 取值范围:1000~48000。 默认取值:不涉及。 |
| memory | 是 | Integer | 参数解释:Spark Driver内存大小,单位MB,1GB=1024MB。 约束限制:不涉及。 取值范围:1024~393216。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| history_server_config | 否 | CreateHistoryServerConfig object | 参数解释:History Server配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| head_group_spec | 是 | HeadGroupSpecV3 object | 参数解释:HeadGroup的配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| worker_group_specs | 是 | Array of WorkerGroupSpecV3 objects | 参数解释:Worker Group的配置。 约束限制:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| resource | 是 | ResourceSpecV3 object | 参数解释:资源规格。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 是 | String | 参数解释:Worker Group的名称。 约束限制:不涉及。 取值范围:长度0~128字母、数字、中划线的组合。 默认取值:不涉及。 |
| min_replicas | 是 | Integer | 参数解释:最小副本数。 约束限制:不涉及。 取值范围:0~10000。 默认取值:不涉及。 |
| max_replicas | 是 | Integer | 参数解释:最大副本数。 约束限制:不涉及。 取值范围:1~10000。 默认取值:不涉及。 |
| resource | 是 | ResourceSpecV3 object | 参数解释:资源规格。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| username | 否 | String | 参数解释:账号名称。 约束限制:不涉及。 取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。 默认取值:default。 |
| dew_secret_name | 是 | String | 参数解释:DEW的凭据名称。存储着DCS账号的密码,格式为:凭据键为password,值为实际的密码。 约束限制:不涉及。 取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。 默认取值:不涉及。 |
| ssl_enable | 否 | Boolean | 参数解释:是否开启SSL。 约束限制:不涉及。 取值范围: 默认取值:true。 |
| dcs_id | 是 | String | 参数解释:DCS实例的ID。获取方式:在DCS控制台实例详情页查看,或通过调用查询DCS实例列表接口获取。 约束限制:不涉及。 取值范围:支持英文字母、数字及中划线,长度为4~1024个字符。 默认取值:不涉及。 |
| vpcep_service_id | 是 | String | 参数解释:VPCEP服务端ID,用于连接客户侧网络。获取方式:在VPCEP控制台查看,或通过调用查询VPCEP服务列表接口获取。开启GCS高可用时必填,用于通过VPCEP方式连接客户侧DCS。 约束限制:开启GCS高可用时必填。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| files | 否 | Array of CreateFileStorageConfig objects | 参数解释:文件存储配置。 约束限制:最多10个文件存储配置。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| storage_id | 是 | String | 参数解释:存储资源ID。 约束限制:不涉及。 取值范围:长度为1~36的英文字符、数字和中划线的组合。 默认取值:不涉及。 |
| storage_path | 否 | String | 参数解释:存储上的路径。 约束限制:存储支持的格式。 取值范围:最小长度为1,最大长度为1024。 默认取值:/。 |
| mount_path | 否 | String | 参数解释:挂载到容器的路径。 约束限制:容器本地支持的格式,且不能覆盖系统路径,限制必须挂载在/home/service/下。 取值范围:最小长度为1,最大长度为1024。 默认取值:/home/service/works。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enabled | 否 | Boolean | 参数解释:存储历史服务器功能的启用/禁用状态。必须将其设置为“true”才能启用该功能。 约束限制:不涉及。 取值范围: 默认取值:false。 |
| obs | 否 | ObsConfig object | 参数解释:OBS存储配置。指定对象存储服务(OBS)桶,用于存储History Server收集器采集的诊断数据(例如Flow Insight收集的数据)。该服务使用指定的委托(Agency)对该桶进行读写操作。当“enabled” 为“true”时,此字段为必填项。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| flink_config | 否 | Map<String,String> | 参数解释:Flink参数配置,Map的key为Flink配置参数名,value为对应的参数值。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| staging_config | 是 | StagingConfig object | 参数解释:临时存储配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| image | 否 | V2ImageBriefInfo object | 参数解释:镜像配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| obs | 否 | ObsConfig object | 参数解释:OBS存储配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| bucket_name | 否 | String | 参数解释:OBS桶名称。该桶的类型必须是并行文件系统。 约束限制:不涉及。 取值范围:长度为3~63个字符,支持小写字母、数字、中划线和句点的组合。 默认取值:不涉及。 |
| agency_name | 否 | String | 参数解释:委托名称。云服务将使用该委托操作OBS桶。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| id | 是 | String | 参数解释:镜像ID。可通过查询自定义镜像版本列表获取镜像版本ID。 约束限制:不涉及。 取值范围:长度为32~36的英文、数字、中划线的组合。 默认取值:不涉及。 |
| version_id | 是 | String | 参数解释:镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。 约束限制:不涉及。 取值范围:长度为32~36的英文、数字、中划线的组合。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| expand_cpu_resource | 否 | Boolean | 参数解释:开启后,通算工作组作业能够使用智算工作组空闲CPU及内存资源,该操作可能会导致智算任务因资源不足而排队。 约束限制:不涉及。 取值范围: 默认取值:false。 |
| worker_group_config | 是 | Array of WorkerGroupConfig objects | 参数解释:工作组补充配置,和外部capacity对应。 约束限制:最多10个。 |
| staging_config | 是 | AuraV2StagingConfig object | 参数解释:计算结果集OBS存储配置。 约束限制:不涉及。 |
| storages_config | 是 | StoragesConfig object | 参数解释:存储资源配置。 约束限制:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 参数解释:镜像。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| id | 是 | String | 参数解释:镜像ID。可通过查询自定义镜像版本列表获取镜像版本ID。 取值范围:不涉及。 约束限制:不涉及。 |
| version_id | 是 | String | 参数解释:自定义镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。 取值范围:不涉及。 约束限制:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| obs | 是 | AuraV2ObsConfig object | 参数解释:OBS存储配置。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| bucket_name | 是 | String | 参数解释:OBS桶名称。 约束限制:不涉及。 取值范围:长度为3~63个字符,支持小写字母、数字、中划线和句点的组合。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| files | 是 | Array of FileStorageConfig objects | 参数解释:文件存储配置。 约束限制:最多10个文件存储配置。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| storage_id | 是 | String | 参数解释:存储资源ID。 约束限制:不涉及。 取值范围:长度为1~36的英文字符、数字和中划线的组合。 默认取值:不涉及。 |
| storage_name | 否 | String | 参数解释:存储的名称,对应PVC的名称。 约束限制:不涉及。 取值范围:支持小写字母、数字、中划线的组合,长度为1~63个字符。 默认取值:不涉及。 |
| storage_path | 否 | String | 参数解释:存储上的路径。 约束限制:不涉及。 取值范围:支持英文字母、数字、斜杠及特殊字符,最小长度为1,最大长度为1024。 默认取值:不涉及。 |
| mount_path | 否 | String | 参数解释:挂载到容器的路径。 约束限制:不涉及。 取值范围:支持英文字母、数字、斜杠及特殊字符,最小长度为1,最大长度为1024。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| type | 是 | String | 参数解释:资源类型。 约束限制:不涉及。 取值范围: 默认取值:不涉及。 |
| 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 | 参数解释:容量是否使用弹性资源。 约束限制:端点创建后此参数不支持变更。 取值范围: 默认取值:false。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enable | 否 | Boolean | 参数解释:是否接入AOM。 约束限制:不涉及。 取值范围: 默认取值:false。 |
| aom_prometheus_id | 否 | String | 参数解释:AOM Prometheus实例ID,可通过AOM管理控制台或查询AOM Prometheus实例列表接口获取。 约束限制:不涉及。 取值范围:长度为0~256个字符,支持英文字符、数字、中划线和下划线的组合。 默认取值:不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enable | 否 | Boolean | 参数解释:是否开启LTS日志。 约束限制:不涉及。 取值范围: 默认取值:false。 |
| lts_group_id | 否 | String | 参数解释:LTS日志组ID,可在云日志服务LTS控制台日志管理页面的日志组列表查看。 约束限制:enable为true的时候需要配置。 取值范围:长度为1~36个字符,支持英文字符、数字和中划线的组合。 默认取值:不涉及。 |
| lts_stream_id | 否 | String | 参数解释:LTS日志流ID,可在云日志服务LTS控制台日志管理页面的日志组列表展开查看对应的日志流。 约束限制:enable为true的时候需要配置。 取值范围:长度为1~36个字符,支持英文字符、数字和中划线的组合。 默认取值:不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释:端点ID。 取值范围:长度为1~36的英文字符、数字和中划线的组合。 |
| name | String | 参数解释:端点名称。 取值范围:长度为1~63个字符,遵循RFC 1035规范,支持小写字母、数字、中划线,必须字母开头、字母或数字结尾。 |
| display_name | String | 参数解释:端点显示名称。 取值范围:长度为1~63个字符,支持小写字母、数字、中划线、汉字。 |
| description | String | 参数解释:资源描述信息。 取值范围:长度为0~1000个字符,支持中文字符、英文字母、数字及特殊字符。 |
| status | String | 参数解释:Endpoint状态。 取值范围: |
| engine | One of: | 参数解释:引擎配置。 |
| capacity | Array of V2EndpointCapacityItem objects | 参数解释:计算资源容量配置。 |
| resource_type | String | 参数解释:资源使用模式。 取值范围: |
| 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(云日志服务)配置。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释:镜像配置。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| max_concurrent_jobs | Integer | 参数解释:端点最大并发作业数量。 取值范围:1~1000。 |
| scheduling_policy | String | 参数解释:作业调度策略,支持随机和先进先出。 取值范围: |
| fifo_tolerance_seconds | Integer | 参数解释:FIFO允许并发时间(秒)。 取值范围:0~3600。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释:镜像配置。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| enabled | Boolean | 参数解释:自动停止集群开关。 取值范围: |
| idle_timeout_minutes | Integer | 参数解释:指定时间不活动后自动停止集群,单位分钟。 取值范围:5~360。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| cpu | Integer | 参数解释:Spark Driver CPU,单位毫核。 取值范围:1000~48000。 |
| memory | Integer | 参数解释:Spark Driver内存大小,单位MB,1GB=1024MB。 取值范围:1024~393216。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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配置。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| head_group_spec | HeadGroupSpecV3 object | 参数解释:HeadGroup的配置。 取值范围:不涉及。 |
| worker_group_specs | Array of WorkerGroupSpecV3 objects | 参数解释:Worker Group的配置。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 参数解释:Worker Group的名称。 取值范围:长度0~128字母、数字、中划线的组合。 |
| min_replicas | Integer | 参数解释:最小副本数。 取值范围:0~10000。 |
| max_replicas | Integer | 参数解释:最大副本数。 取值范围:1~10000。 |
| resource | ResourceSpecV3 object | 参数解释:资源规格。 取值范围:不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| spec_code | String | 参数解释:规格编码。 取值范围:不涉及。 |
| cpu | Integer | 参数解释:CPU核数量,单位为毫核。 取值范围:0~1000000。 |
| memory | Integer | 参数解释:内存大小,单位MB。 取值范围:0~10000000。 |
| npu | Double | 参数解释:昇腾卡数量。单位:个。 取值范围:0~100。 |
| gpu | Double | 参数解释:GPU卡数量。单位:个。 取值范围:0~100。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| username | String | 参数解释:账号名称。 取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。 |
| dew_secret_name | String | 参数解释:DEW的凭据名称。存储着DCS账号的密码,格式为:凭据键为password,值为实际的密码。 取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。 |
| ssl_enable | Boolean | 参数解释:是否开启SSL。 取值范围: |
| dcs_id | String | 参数解释:DCS实例的ID。获取方式:在DCS控制台实例详情页查看,或通过调用查询DCS实例列表接口获取。 取值范围:支持英文字母、数字及中划线,长度为4~1024个字符。 |
| vpcep_service_id | String | 参数解释:VPCEP服务端ID,用于连接客户侧网络。获取方式:在VPCEP控制台查看,或通过调用查询VPCEP服务列表接口获取。开启GCS高可用时必填,用于通过VPCEP方式连接客户侧DCS。 取值范围:不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| type | String | 参数解释:引擎类型。 取值范围:RayJob。 |
| history_server_config | HistoryServerConfig object | 参数解释:History Server配置。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| enabled | Boolean | 参数解释:存储历史服务器功能的启用/禁用状态。必须将其设置为“true”才能启用该功能。 取值范围: |
| obs | ObsConfig object | 参数解释:OBS存储配置。指定对象存储服务(OBS)桶,用于存储History Server收集器采集的诊断数据(例如Flow Insight收集的数据)。该服务使用指定的委托(Agency)对该桶进行读写操作。当“enabled” 为“true”时,此字段为必填项。 取值范围:不涉及。 |
| flow_insight_enabled | Boolean | 参数解释:Flow Insight是一项诊断与可观测性功能,它从Ray集群收集指标、日志及工作流执行数据,并通过History Server收集器将其传输至已配置的OBS存储。该功能仅在“enabled”参数设置为“true”时可用。 取值范围: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| type | String | 参数解释:引擎类型。 取值范围:FlinkJob。 |
| flink_config | Map<String,String> | 参数解释:Flink参数配置,Map的key为Flink配置参数名,value为对应的参数值。 |
| staging_config | StagingConfig object | 参数解释:临时存储配置。 |
| image | V2ImageBriefInfo object | 参数解释:镜像配置。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| bucket_name | String | 参数解释:OBS桶名称。该桶的类型必须是并行文件系统。 取值范围:长度为3~63个字符,支持小写字母、数字、中划线和句点的组合。 |
| agency_name | String | 参数解释:委托名称。云服务将使用该委托操作OBS桶。 取值范围:不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释:镜像ID。可通过查询自定义镜像版本列表获取镜像版本ID。 取值范围:长度为32~36的英文、数字、中划线的组合。 |
| version_id | String | 参数解释:镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。 取值范围:长度为32~36的英文、数字、中划线的组合。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| type | String | 参数解释:引擎类型。 取值范围:AuraJobV2。 |
| expand_cpu_resource | Boolean | 参数解释:开启后,通算工作组作业能够使用智算工作组空闲CPU及内存资源,该操作可能会导致智算任务因资源不足而排队。 取值范围: |
| worker_group_config | Array of WorkerGroupConfig objects | 参数解释:工作组补充配置,和外部capacity对应。 |
| staging_config | AuraV2StagingConfig object | 参数解释:计算结果集OBS存储配置。 |
| storages_config | StoragesConfig object | 参数解释:存储资源配置。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释:镜像。 取值范围:不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释:镜像ID。可通过查询自定义镜像版本列表获取镜像版本ID。 取值范围:不涉及。 |
| version_id | String | 参数解释:自定义镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。 取值范围:不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| storage_id | String | 参数解释:存储资源ID。 取值范围:长度为1~36的英文字符、数字和中划线的组合。 |
| storage_name | String | 参数解释:存储的名称,对应PVC的名称。 取值范围:支持小写字母、数字、中划线的组合,长度为1~63个字符。 |
| storage_path | String | 参数解释:存储上的路径。 取值范围:支持英文字母、数字、斜杠及特殊字符,最小长度为1,最大长度为1024。 |
| mount_path | String | 参数解释:挂载到容器的路径。 取值范围:支持英文字母、数字、斜杠及特殊字符,最小长度为1,最大长度为1024。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| type | String | 参数解释:资源类型。 取值范围: |
| 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 | 参数解释:容量是否使用弹性资源。 取值范围: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| agency_name | String | 参数解释:Endpoint级别用户委托名称,用于Endpoint的存储等配置权限认证,以及作为作业运行时的默认委托。 取值范围:支持英文字母、数字及特殊字符,长度为1~64个字符。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| domain_name | String | 参数解释:租户名称。 取值范围:支持中文字符、英文字母、数字及特殊字符,长度为1~64个字符。 |
| domain_id | String | 参数解释:租户ID。 取值范围:支持英文字母、数字及中划线,长度为1~64个字符。 |
| user_name | String | 参数解释:用户名称。 取值范围:支持英文字母、数字、下划线的组合,长度为1~64个字符。 |
| user_id | String | 参数解释:用户ID。 取值范围:支持英文字母、数字及中划线,长度为1~64个字符。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| key | String | 参数解释:资源标签的键。 取值范围:长度1~128的多语言字母、空格、数字、下划线、点、冒号、斜杠、等号、加号、减号、@符号组合。 |
| value | String | 参数解释:资源标签的值。 取值范围:长度0~255的多语言字母、空格、数字、下划线、点、冒号、斜杠、等号、加号、减号、@符号组合。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释:失败状态时的错误编码。 取值范围:支持英文字母、数字、小数点及下划线,长度为0~36个字符。 |
| error_msg | String | 参数解释:失败状态时的错误信息。 取值范围:支持中文字符、英文字母、数字及特殊字符,长度为0~1024个字符。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| enable | Boolean | 参数解释:是否接入AOM。 取值范围: |
| aom_prometheus_id | String | 参数解释:AOM Prometheus实例ID,可通过AOM管理控制台或查询AOM Prometheus实例列表接口获取。 取值范围:长度为0~256个字符,支持英文字符、数字、中划线和下划线的组合。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| enable | Boolean | 参数解释:是否开启LTS日志。 取值范围: |
| lts_group_id | String | 参数解释:LTS日志组ID,可在云日志服务LTS控制台日志管理页面的日志组列表查看。 取值范围:长度为1~36个字符,支持英文字符、数字和中划线的组合。 |
| lts_stream_id | String | 参数解释:LTS日志流ID,可在云日志服务LTS控制台日志管理页面的日志组列表展开查看对应的日志流。 取值范围:长度为1~36个字符,支持英文字符、数字和中划线的组合。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释:错误码。 取值范围:长度为8~36个字符。 |
| error_msg | String | 参数解释:错误描述。 取值范围:长度为2~512个字符。 |
| solution_msg | String | 参数解释:解决方案。 取值范围:长度为0~4096个字符。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释:错误码。 取值范围:长度为8~36个字符。 |
| error_msg | String | 参数解释:错误描述。 取值范围:长度为2~512个字符。 |
| solution_msg | String | 参数解释:解决方案。 取值范围:长度为0~4096个字符。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释:错误码。 取值范围:长度为8~36个字符。 |
| error_msg | String | 参数解释:错误描述。 取值范围:长度为2~512个字符。 |
| solution_msg | String | 参数解释:解决方案。 取值范围:长度为0~4096个字符。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释:错误码。 取值范围:长度为8~36个字符。 |
| error_msg | String | 参数解释:错误描述。 取值范围:长度为2~512个字符。 |
| solution_msg | String | 参数解释:解决方案。 取值范围:长度为0~4096个字符。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释:错误码。 取值范围:长度为8~36个字符。 |
| error_msg | String | 参数解释:错误描述。 取值范围:长度为2~512个字符。 |
| solution_msg | String | 参数解释:解决方案。 取值范围:长度为0~4096个字符。 |
请求示例
-
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
-
{ "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" } ] } -
{ "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" } ] } -
{ "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 | 内部服务器错误。 |