创建交互式会话 - createRaySession

功能介绍

创建一个交互式会话。本接口为同步接口，用于Notebook等交互式工具连接Ray集群。联邦用户认证场景下，会返回含联邦用户身份对应的凭据名称。

调用方法

请参见如何调用API。

URI

POST /v2/workspaces/{workspace_id}/ray-sessions

请求参数

响应参数

状态码：200

状态码：400

状态码：401

状态码：403

状态码：404

状态码：408

状态码：500

请求示例

创建一个交互式会话。

POST https://{endpoint}/v2/workspaces/{workspace_id}/ray-sessions

{
  "name" : "my-session",
  "description" : "交互式会话示例",
  "endpoint_name" : "ray"
}

响应示例

状态码：200

{
  "session_id" : "ac8111bf-3601-4905-8ddd-b41d3e636a4e",
  "secret_name" : "pod_agency_myAgency_001234_20260717120000",
  "ray_grpc_server_port" : "10001"
}

状态码：400

{
  "error_code" : "common.01000001",
  "error_msg" : "failed to read http request, please check your input, code: 400, reason: Type mismatch., cause: TypeMismatchException",
  "solution_msg" : "Check whether the request parameters comply with the API definition and try again"
}

状态码：401

{
  "error_code" : "APIG.1002",
  "error_msg" : "Incorrect token or token resolution failed",
  "solution_msg" : "Please check if auth token is included in the request header."
}

状态码：403

{
  "error_code" : "APIG.1003",
  "error_msg" : "X-Auth-Token is invalid in the request",
  "solution_msg" : "Check whether the token in the request is valid and try again."
}

状态码：404

{
  "error_code" : "common.01000001",
  "error_msg" : "response status exception, code: 404",
  "solution_msg" : "Please try to use correct info."
}

状态码：408

{
  "error_code" : "common.00000408",
  "error_msg" : "timeout exception occurred",
  "solution_msg" : "The backend request timed out — check service health and network connectivity, then retry."
}

状态码：500

{
  "error_code" : "common.00000500",
  "error_msg" : "internal error",
  "solution_msg" : "Contact operations for analysis."
}

状态码