文档首页/ 智能数据湖 AIDataLake/ API参考/ 端点管理/ 查询所有端点列表 - ListV2AllEndpoints

更新时间：2026-07-13 GMT+08:00

查询所有端点列表 - ListV2AllEndpoints

功能介绍

列举该租户所有端点列表。用户可使用该接口列举该租户端点列表，支持输入名称、类型等参数过滤，支持分页查询。此接口为同步接口。

调用方法

URI

GET /v2/endpoints

表1 Query参数
参数	是否必选	参数类型	描述
offset	否	Integer	参数解释：分页偏移量。约束限制：不涉及。取值范围：0~10000。默认取值：0。
limit	否	Integer	参数解释：分页大小。约束限制：不涉及。取值范围：1~1000。默认取值：100。
name	否	String	参数解释：端点名称，精确查询。约束限制：不涉及。取值范围：长度为1~63个字符，遵循RFC 1035规范，支持小写字母、数字、中划线，必须字母开头、字母或数字结尾。默认取值：不涉及。
engine_types	否	Array of strings	参数解释：端点引擎类型列表。约束限制：不涉及。取值范围： AuraJob：AuraJob引擎。 SparkSql：SparkSql引擎。 SparkJob：SparkJob引擎。 AuraJobV2：AuraJobV2引擎。 RayCluster：RayCluster引擎。 RayJob：RayJob引擎。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。约束限制：不涉及。取值范围：长度不超过65534个字符。默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
total	Integer	参数解释：总记录数。取值范围：不涉及。
endpoints	Array of V2EndpointSpaceInfo objects	参数解释：端点列表。

表4 V2EndpointSpaceInfo
参数	参数类型	描述
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: SparkJob object SparkSql object RayCluster object AuraJob object AuraJobV2 object Object	参数解释：引擎配置。type取值范围：SparkJob，SparkSql，RayJob，RayCluster，AuraJob，AuraJobV2。
capacity	Array of V2EndpointCapacityItem objects	参数解释：计算资源容量配置。
resource_type	String	参数解释：资源使用模式。取值范围： RESERVED：预留资源。 ONDEMAND：按需弹性。 HYBRID：混合模式。
create_time	String	参数解释：资源创建时间。取值范围：ISO 8601格式，例如2025-01-10T03:37:12.000+00:00。
update_time	String	参数解释：资源更新时间。取值范围：ISO 8601格式，例如2025-01-10T03:37:12.000+00:00。
compute_id	String	参数解释：计算资源ID。取值范围：长度为1~36的英文字符、数字和中划线的组合。
credential	CredentialConfig object	参数解释：Endpoint级别用户委托名称，用于Endpoint的存储等配置权限认证，以及作为作业运行时的默认委托。
creator	Creator object	参数解释：资源所有者信息。
error	Error object	参数解释：失败时返回的文本消息内容，包含错误码、错误描述。
workspace	BriefWorkspace object	参数解释：工作空间简要信息。

表5 SparkJob
参数	参数类型	描述
spark_config	Map<String,String>	参数解释：Spark参数配置。
scheduling_config	SparkSchedulingConfig object	参数解释：SparkJob调度配置。
staging_config	StagingConfig object	参数解释：临时存储配置。

表6 SparkSchedulingConfig
参数	参数类型	描述
max_concurrent_jobs	Integer	参数解释：端点最大并发作业数量。约束限制：不涉及。取值范围：1~1000。默认取值：200。
scheduling_policy	String	参数解释：作业调度策略，支持随机和先进先出。约束限制：不涉及。取值范围： RANDOM：随机。 FIFO：先进先出。默认取值：RANDOM。
fifo_tolerance_seconds	Integer	参数解释：FIFO允许并发时间（秒）。约束限制：不涉及。取值范围：0~3600。默认取值：300。

表7 SparkSql
参数	参数类型	描述
spark_config	Map<String,String>	参数解释：Spark参数配置。
staging_config	StagingConfig object	参数解释：临时存储配置。
cluster_config	SparkClusterConfig object	参数解释：集群配置。
max_endpoint_concurrent_queries	Integer	参数解释：端点最大并发sql数量。约束限制：不涉及。取值范围：1~1000。默认取值：300。
image	V2ImageBriefInfo object	参数解释：镜像配置。

表8 StagingConfig
参数	参数类型	描述
obs	ObsConfig object	参数解释：OBS存储配置。

表9 ObsConfig
参数	参数类型	描述
bucket_name	String	参数解释：OBS桶名称。该桶的类型必须是并行文件系统。约束限制：不涉及。取值范围：长度为3~63个字符，支持小写字母、数字、中划线和句点的组合。默认取值：不涉及。
agency_name	String	参数解释：委托名称。云服务将使用该委托操作OBS桶。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

**表10** 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	参数解释：最小集群数量。约束限制：不涉及。取值范围：小于等于20。默认取值：2。
max_clusters	Integer	参数解释：最大集群数量。约束限制：不涉及。取值范围：2~20。默认取值：6。
max_cluster_concurrent_queries	Integer	参数解释：集群最大并发SQL数量。约束限制：不涉及。取值范围：1~30。默认取值：16。

**表11** AutoStopConfig
参数	参数类型	描述
enabled	Boolean	参数解释：自动停止集群开关。约束限制：不涉及。取值范围： true：开启自动停止集群。 false：关闭自动停止集群。默认取值：不涉及。
idle_timeout_minutes	Integer	参数解释：指定时间不活动后自动停止集群,单位分钟。约束限制：不涉及。取值范围：5~360。默认取值：10。

**表12** SparkDriverResourceSpec
参数	参数类型	描述
cpu	Integer	参数解释：Spark Driver CPU，单位毫核。约束限制：不涉及。取值范围：1000~64000。默认取值：不涉及。
memory	Integer	参数解释：Spark Driver内存大小，单位MB，1GB=1024MB。约束限制：不涉及。取值范围：1024~524288。默认取值：不涉及。

**表13** SparkExecutorResourceSpec
参数	参数类型	描述
cpu	Integer	参数解释：Spark Executor CPU，单位毫核。约束限制：不涉及。取值范围：1000~64000。默认取值：不涉及。
memory	Integer	参数解释：Spark Executor内存大小，单位MB，1GB=1024MB。约束限制：不涉及。取值范围：1024~524288。默认取值：不涉及。
min_executor_numbers	Integer	参数解释：Spark Executor最小数量。约束限制：不涉及。取值范围：大于等于1。默认取值：不涉及。
max_executor_numbers	Integer	参数解释：Spark Executor最大数量。约束限制：不涉及。取值范围：1~1000。默认取值：不涉及。

**表14** RayCluster
参数	参数类型	描述
cluster_config	RayClusterConfigV3 object	参数解释：Ray集群规格。
storages_config	StoragesConfig object	参数解释：存储资源配置。
image	V2ImageBriefInfo object	参数解释：镜像配置。

**表15** RayClusterConfigV3
参数	参数类型	描述
head_group_spec	HeadGroupSpecV3 object	参数解释：HeadGroup的配置。
worker_group_specs	Array of WorkerGroupSpecV3 objects	参数解释：Worker Group的配置。

**表16** HeadGroupSpecV3
参数	参数类型	描述
resource	ResourceSpecV3 object	参数解释：资源规格。约束限制：不涉及。

**表17** WorkerGroupSpecV3
参数	参数类型	描述
name	String	参数解释：名称。约束限制：不涉及。取值范围：长度0~128字母、数字、中划线的组合。默认取值：不涉及。
min_replicas	Integer	参数解释：最小副本数。约束限制：不涉及。取值范围：0~10000。默认取值：不涉及。
max_replicas	Integer	参数解释：最大副本数。约束限制：不涉及。取值范围：1~10000。默认取值：不涉及。
resource	ResourceSpecV3 object	参数解释：资源规格。约束限制：不涉及。

**表18** 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。

**表19** V2ImageBriefInfo
参数	参数类型	描述
id	String	参数解释：镜像ID。约束限制：不涉及。取值范围：长度为32~36的英文、数字、中划线的组合。默认取值：不涉及。
version_id	String	参数解释：镜像版本ID。约束限制：不涉及。取值范围：长度为32~36的英文、数字、中划线的组合。默认取值：不涉及。

**表20** AuraJob
参数	参数类型	描述
storages_config	StoragesConfig object	参数解释：存储资源配置。

**表21** AuraJobV2
参数	参数类型	描述
expand_cpu_resource	Boolean	参数解释：开启后，通算工作组作业能够使用智算工作组空闲CPU及内存资源，该操作可能会导致智算任务因资源不足而排队。约束限制：不涉及。取值范围： TRUE：开启通算工作组作业使用智算工作组空闲CPU及内存资源。 false：关闭通算工作组作业使用智算工作组空闲CPU及内存资源。默认取值：false。
worker_group_config	Array of WorkerGroupConfig objects	参数解释：工作组补充配置，和外部capacity对应。
staging_config	AuraV2StagingConfig object	参数解释：计算结果集OBS存储配置。
storages_config	StoragesConfig object	参数解释：存储资源配置。

**表22** WorkerGroupConfig
参数	参数类型	描述
name	String	参数解释：工作组名称。约束限制：已有工作组名称不支持修改，需和当前工作组名称保持一致；新增工作组该字段必填。取值范围：长度为1~63个字符，支持字母、数字和中划线的组合。默认取值：不涉及。
spec_code	String	参数解释：节点规格。约束限制：不涉及。取值范围：从规格列表查询获取。默认取值：不涉及。
cpu	Integer	参数解释：通算CPU大小，单位毫核。约束限制：不涉及。取值范围：大于等于0。默认取值：不涉及。
memory	Integer	参数解释：通算内存大小，单位MB。约束限制：不涉及。取值范围：大于等于0。默认取值：不涉及。
gpu	Double	参数解释：GPU卡数量。约束限制：暂时只支持整数。取值范围：大于等于0。默认取值：不涉及。
npu	Double	参数解释：NPU卡数量。约束限制：暂时只支持整数。取值范围：大于等于0。默认取值：不涉及。
image	ImageVersionInfo object	参数解释：镜像。约束限制：不涉及。

**表23** ImageVersionInfo
参数	参数类型	描述
id	String	参数解释：镜像版本ID。取值范围：不涉及。
version_id	String	参数解释：自定义镜像版本ID。取值范围：不涉及。

**表24** AuraV2StagingConfig
参数	参数类型	描述
obs	AuraV2ObsConfig object	参数解释：OBS存储配置。

**表25** AuraV2ObsConfig
参数	参数类型	描述
bucket_name	String	参数解释：OBS桶名称。约束限制：不涉及。取值范围：长度为3~63个字符，支持小写字母、数字、中划线和句点的组合。默认取值：不涉及。

**表26** StoragesConfig
参数	参数类型	描述
files	Array of FileStorageConfig objects	参数解释：文件存储配置。

**表27** FileStorageConfig
参数	参数类型	描述
storage_id	String	参数解释：存储间ID。取值范围：长度为1~36的英文字符、数字和中划线的组合。
storage_name	String	参数解释：存储的名称，对应PVC的名称。取值范围：最小长度为1，最大长度为63。
storage_path	String	参数解释：存储上的路径。取值范围：最小长度为1，最大长度为1024。
mount_path	String	参数解释：挂载到容器的路径。取值范围：最小长度为1，最大长度为1024。

**表28** V2EndpointCapacityItem
参数	参数类型	描述
type	String	参数解释：资源类型。约束限制：不涉及。取值范围： CPU：CPU资源。 GPU：GPU资源。 NPU：NPU资源。默认取值：不涉及。
maximum_capacity	Integer	参数解释：资源数量。约束限制：不涉及。取值范围：1~10000。默认取值：不涉及。
minimum_capacity	Integer	参数解释：最小资源数量。约束限制：不涉及。取值范围：0~10000，小于等于maximum_capacity。默认取值：不涉及。
spec_code	String	参数解释：资源规格。约束限制：更新端点时，此参数无法变更。取值范围：长度为1~64个字符。默认取值：不涉及。
use_ondemand_resource	Boolean	参数解释：容量是否使用弹性资源。约束限制：更新端点时，此参数无法变更。取值范围： true：使用弹性资源。 false：不使用弹性资源。默认取值：false。

**表29** CredentialConfig
参数	参数类型	描述
agency_name	String	参数解释：Endpoint级别用户委托名称，用于Endpoint的存储等配置权限认证，以及作为作业运行时的默认委托。约束限制：不涉及。取值范围：长度为1~64个字符。默认取值：不涉及。

**表30** Creator
参数	参数类型	描述
domain_name	String	参数解释：租户名称。取值范围：长度为1~64个字符。
domain_id	String	参数解释：租户ID。取值范围：长度为1~64个字符。
user_name	String	参数解释：用户名称。取值范围：长度为1~64个字符。
user_id	String	参数解释：用户ID。取值范围：长度为1~64个字符。

**表31** Error
参数	参数类型	描述
error_code	String	参数解释：失败状态时的错误编码。取值范围：长度为0~36个字符。
error_msg	String	参数解释：失败状态时的错误信息。取值范围：长度为0~1024个字符。

**表32** BriefWorkspace
参数	参数类型	描述
id	String	参数解释：工作空间ID。取值范围：长度为1~36的英文字母、数字和中划线的组合。
name	String	参数解释：工作空间名称。取值范围：长度为4~32的英文字母、数字、下划线和中划线的组合。

状态码：400

**表33** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：401

**表34** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：403

**表35** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：404

**表36** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：500

**表37** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

请求示例

查询所有端点列表，通过名称过滤，返回端点简要信息。

GET /v2/endpoints?name={endpoint_name}

响应示例

状态码：200

请求成功。

查询所有端点列表，返回AuraJob类型的端点信息。

{
  "total" : 1,
  "endpoints" : [ {
    "id" : "0b5633ba2b904511ad514346f4d23d4b",
    "name" : "endpoint-01",
    "display_name" : "endpoint-01",
    "description" : "测试端点",
    "status" : "RUNNING",
    "engine" : {
      "type" : "AuraJob"
    },
    "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"
    },
    "workspace" : {
      "id" : "00315974-7ee8-4900-8034-2e8f9ee61520",
      "name" : "test1"
    }
  } ]
}

查询所有端点列表，返回SparkSql和SparkJob类型的端点信息。

{
  "total" : 2,
  "endpoints" : [ {
    "id" : "1a2b3c4d5e6f7890abcdef1234567890",
    "name" : "spark-sql-test",
    "display_name" : "spark-sql-test",
    "description" : "SparkSql测试端点",
    "status" : "RUNNING",
    "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"
    },
    "workspace" : {
      "id" : "00315974-7ee8-4900-8034-2e8f9ee61520",
      "name" : "test1"
    }
  }, {
    "id" : "2b3c4d5e6f7890abcdef1234567890ab",
    "name" : "spark-job-test",
    "display_name" : "spark-job-test",
    "description" : "SparkJob测试端点",
    "status" : "RUNNING",
    "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"
    },
    "workspace" : {
      "id" : "00315974-7ee8-4900-8034-2e8f9ee61520",
      "name" : "test1"
    }
  } ]
}

状态码：400

请求参数错误。

{
  "error_code" : "AIDataLake.00010011",
  "error_msg" : "Invalid specification code.",
  "solution_msg" : "Enter a correct specification code."
}

状态码：401

未授权。

{
  "error_code" : "APIGW.0301",
  "error_msg" : "Incorrect IAM authentication information decrypt token fail"
}

状态码：403

禁止访问。

{
  "error_code" : "AIDataLake.00010038",
  "error_msg" : "Unauthorized requests.",
  "solution_msg" : "Check permissions {xxx} and retry after authorization."
}

状态码：404

资源未找到。

{
  "error_code" : "AIDataLake.00010004",
  "error_msg" : "Not Found",
  "solution_msg" : "Please check the resource ID and try again"
}

状态码：500

内部服务器错误。

{
  "error_code" : "AIDataLake.00010067",
  "error_msg" : "Failed to initialize the task because the number of tasks may have reached the upper limit.",
  "solution_msg" : "Try again later."
}