创建端点应用示例

概述

本文指导用户通过调用API的方式，介绍创建端点的完整流程，包括创建端点、查看端点流程。

本流程假设终端租户已经在Console界面完成AI DataLake的服务授权，且已创建工作空间。API的调用方法请参见如何调用API。

前提条件

• 已完成AI DataLake服务授权。
• 已获取待创建资源池的工作空间ID。
• 如果创建预留资源和混合模式的端点，还需要计算资源池ID，如果是按需弹性的端点，则不需要计算资源池ID。

创建端点

• 接口相关信息

  URI格式：POST /v2/workspaces/{workspace_id}/endpoints

  {workspace_id}：为端点所在工作空间ID。

  详情请参见创建端点 - CreateV2Endpoint。

• 请求示例

  POST /v2/workspaces/{workspace_id}/endpoints

  Body：

  {
    "compute_id" : "0150a336-dda9-xxxx-xxxx-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"
    }
  }

• 响应示例

  {
    "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-xxxx-xxxx-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" : "0676610f3a0xxxxxxxx50bea7ddf18c1",
      "user_id" : "019e19fb78887xxxxxxxx4174cd5a002",
      "user_name" : "developer"
    }
  }

查看端点详情

• 接口相关信息

  URI格式：GET /v2/workspaces/{workspace_id}/endpoints/{endpoint_id}

  {workspace_id}：资源池所在工作空间ID。

  详情请参见查询端点详情 - ShowV2Endpoint。

• 请求示例

  GET /v2/workspaces/{workspace_id}/endpoints/{endpoint_id}

• 响应示例

  {
    "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-xxxx-xxxx-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" : "0676610f3a0xxxxxxxx50bea7ddf18c1",
      "user_id" : "019e19fb78887xxxxxxxx4174cd5a002",
      "user_name" : "developer"
    }
  }