GetRuntime - 获取运行时详情

更新时间:
复制 MD 格式

获取运行时的详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

pailangstudio:GetRuntime

get

*全部资源

*

无 无

请求语法

GET /api/v1/langstudio/runtimes/{RuntimeId} HTTP/1.1

路径参数

名称

类型

必填

描述

示例值

RuntimeId

string

否

运行时 ID。

rtime-apje******beaz

请求参数

名称

类型

必填

描述

示例值

WorkspaceId

string

否

工作空间 ID。如何获取工作空间 ID,请参见 ListWorkspaces 。

478***

返回参数

名称

类型

描述

示例值

object

返回结果。

RequestId

string

请求 ID

963BD7F9-0C02-5594-9550-BCC6DD43E3C0

WorkspaceId

string

工作空间 ID。

478***

RuntimeId

string

运行时 ID。

rtime-apje******beaz

RuntimeName

string

运行时的名称。

dev01

RuntimeType

string

运行时类型。

DSW

RuntimeStatus

string

运行时状态。取值:

  • Creating: 创建中

  • SaveFailed: 镜像保存失败

  • Stopped: 已停止

  • Failed: 失败

  • ResourceAllocating:资源分配中

  • Stopping: 停止中

  • Updating: 更新中

  • Saving: 镜像保存中

  • Queuing: 排队中

  • Recovering: 实例恢复中

  • Starting: 创建中

  • Running: 运行中

  • Saved: 镜像保存成功

  • Deleting: 删除中

  • EnvPreparing: 环境准备中

Running

GmtCreateTime

string

创建时间,采用 ISO 8601 格式的 UTC 时间。

2025-09-24T07:33:53Z

GmtModifiedTime

string

最后修改时间,采用 ISO 8601 格式的 UTC 时间。

2025-09-24T08:24:36Z

Creator

string

创建者 ID。

2680******4103

Accessibility

string

工作空间可见性。

PRIVATE

EcsSpec

object

ECS 资源配置

InstanceType

string

实例类型。

ecs.c6.large

GPUType

string

GPU 类型。

V100

CPU

integer

CPU 数量。

4

GPU

integer

GPU 数量。

0

Memory

integer

内存大小,单位 GB。

8

SharedMemory

integer

共享内存大小,单位 GB。

8

Driver

string

GPU 驱动版本。

535.161.08

ResourceId

string

资源配额 ID。

quota18******zv9

UserVpc

object

用户 VPC 配置。

VpcId

string

专有网络 ID。

vpc-wz90****5v23

VSwitchId

string

交换机 ID。

vsw-wz9r****ng10

SecurityGroupId

string

安全组 ID。

sg-wz9i****1129

DefaultRoute

string

默认路由。

eth0

ExtendedCIDRs

array

扩展网段。

string

扩展网段。

172.16.1.0/24

Envs

array<object>

环境变量。

object

Key

string

环境键。

testKey1

Value

string

环境值。

testValue1

Labels

array<object>

标签。

object

Key

string

标签键。

testKey1

Value

string

标签值。

testValue1

DataSources

array<object>

挂载数据源。

object

DatasetId

string

数据集 ID。与 Uri 二选一。

d-umns******zij4szhc

Uri

string

数据源 OSS 的路径。与 DatasetId 二选一。

oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/source/

MountPath

string

挂载路径。

/mnt/data

RunTimeout

integer

在运行时上执行的单次测试运行的超时,单位秒。

180

CredentialConfig

object

凭据配置。

EnableCredentialInject

boolean

是否开启 Credential 注入。

true

AliyunEnvRoleKey

string

环境变量角色 Key。

0

CredentialConfigItems

array<object>

Credential 配置列表。

array<object>

Key

string

标识配置的 Key。

0

Type

string

配置类型。可选值包括:

  • Role:角色扮演

  • RoleChain:角色链扮演

Role

Roles

array<object>

配置的角色列表。

object

AssumeRoleFor

string

扮演角色的所属主体。

1095******785714

RoleType

string

扮演的角色类型。可选值包括:

  • service:由服务扮演

  • user:由普通用户账号扮演

service

RoleArn

string

角色 ARN。

acs:ram::1095******785714:role/testrole

WorkDir

string

工作目录的 OSS 路径。

oss://mybucket.oss-cn-hangzhou-internal.aliyuncs.com/workdir/

Version

string

运行时镜像版本。

2.0.0

RuntimeLog

string

运行时的日志。

oss://path/to/log/file

AutoUpdateImage

boolean

是否自动更新镜像。当有新的镜像版本可用时,系统在业务低谷时自动更新运行时的镜像。

示例

正常返回示例

JSON格式

{
  "RequestId": "963BD7F9-0C02-5594-9550-BCC6DD43E3C0",
  "WorkspaceId": "478***",
  "RuntimeId": "rtime-apje******beaz",
  "RuntimeName": "dev01",
  "RuntimeType": "DSW",
  "RuntimeStatus": "Running",
  "GmtCreateTime": "2025-09-24T07:33:53Z",
  "GmtModifiedTime": "2025-09-24T08:24:36Z",
  "Creator": "2680******4103",
  "Accessibility": "PRIVATE",
  "EcsSpec": {
    "InstanceType": "ecs.c6.large",
    "GPUType": "V100",
    "CPU": 4,
    "GPU": 0,
    "Memory": 8,
    "SharedMemory": 8,
    "Driver": "535.161.08"
  },
  "ResourceId": "quota18******zv9",
  "UserVpc": {
    "VpcId": "vpc-wz90****5v23",
    "VSwitchId": "vsw-wz9r****ng10",
    "SecurityGroupId": "sg-wz9i****1129",
    "DefaultRoute": "eth0",
    "ExtendedCIDRs": [
      "172.16.1.0/24"
    ]
  },
  "Envs": [
    {
      "Key": "testKey1",
      "Value": "testValue1"
    }
  ],
  "Labels": [
    {
      "Key": "testKey1",
      "Value": "testValue1"
    }
  ],
  "DataSources": [
    {
      "DatasetId": "d-umns******zij4szhc",
      "Uri": "oss://test-bucket.oss-cn-hangzhou-internal.aliyuncs.com/langstudio/source/",
      "MountPath": "/mnt/data"
    }
  ],
  "RunTimeout": 180,
  "CredentialConfig": {
    "EnableCredentialInject": true,
    "AliyunEnvRoleKey": "0",
    "CredentialConfigItems": [
      {
        "Key": "0",
        "Type": "Role",
        "Roles": [
          {
            "AssumeRoleFor": "1095******785714",
            "RoleType": "service",
            "RoleArn": "acs:ram::1095******785714:role/testrole"
          }
        ]
      }
    ]
  },
  "WorkDir": "oss://mybucket.oss-cn-hangzhou-internal.aliyuncs.com/workdir/",
  "Version": "2.0.0",
  "RuntimeLog": "oss://path/to/log/file",
  "AutoUpdateImage": true
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。