GetRuntime - 获取运行时详情

更新时间:
复制为 MD 格式

获取运行时的详情。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
pailangstudio:GetRuntimeget
*全部资源
*

请求语法

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

请求参数

名称类型必填描述示例值
WorkspaceIdstring

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

478***
RuntimeIdstring

运行时 ID。

rtime-apje******beaz

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求 ID

963BD7F9-0C02-5594-9550-BCC6DD43E3C0
WorkspaceIdstring

工作空间 ID。

478***
RuntimeIdstring

运行时 ID。

rtime-apje******beaz
RuntimeNamestring

运行时的名称。

dev01
RuntimeTypestring

运行时类型。

DSW
RuntimeStatusstring

运行时状态。取值:

  • Creating: 创建中
  • SaveFailed: 镜像保存失败
  • Stopped: 已停止
  • Failed: 失败
  • ResourceAllocating:资源分配中
  • Stopping: 停止中
  • Updating: 更新中
  • Saving: 镜像保存中
  • Queuing: 排队中
  • Recovering: 实例恢复中
  • Starting: 创建中
  • Running: 运行中
  • Saved: 镜像保存成功
  • Deleting: 删除中
  • EnvPreparing: 环境准备中
Running
GmtCreateTimestring

创建时间。

2025-09-24T07:33:53Z
GmtModifiedTimestring

修改时间。

2025-09-24T08:24:36Z
Creatorstring

创建者 ID。

2680******4103
Accessibilitystring

工作空间可见性。

PRIVATE
EcsSpecobject

ECS 资源配置

InstanceTypestring

实例类型。

ecs.c6.large
GPUTypestring

GPU 类型。

V100
CPUinteger

CPU 数量。

4
GPUinteger

GPU 数量。

0
Memoryinteger

内存大小,单位 GB。

8
SharedMemoryinteger

共享内存大小,单位 GB。

8
Driverstring

GPU 驱动版本。

535.161.08
ResourceIdstring

资源配额 ID。

quota18******zv9
UserVpcobject

用户 VPC 配置。

VpcIdstring

专有网络 ID。

vpc-wz90****5v23
VSwitchIdstring

交换机 ID。

vsw-wz9r****ng10
SecurityGroupIdstring

安全组 ID。

sg-wz9i****1129
DefaultRoutestring

默认路由。

eth0
ExtendedCIDRsarray

扩展网段。

ExtendedCIDRstring

扩展网段。

172.16.1.0/24
Envsarray<object>

环境变量。

Envobject
Keystring

环境键。

testKey1
Valuestring

环境值。

testValue1
Labelsarray<object>

标签。

Labelobject
Keystring

标签键。

testKey1
Valuestring

标签值。

testValue1
DataSourcesarray<object>

挂载数据源。

DataSourceobject
DatasetIdstring

数据集 ID。与 Uri 二选一。

d-umns******zij4szhc
Uristring

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

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

挂载路径。

/mnt/data
RunTimeoutinteger

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

180
CredentialConfigobject

凭据配置。

EnableCredentialInjectboolean

是否开启 Credential 注入。

true
AliyunEnvRoleKeystring

环境变量角色 Key。

0
CredentialConfigItemsarray<object>

Credential 配置列表。

CredentialConfigItemobject
Keystring

标识配置的 Key。

0
Typestring

配置类型。可选值包括:

  • Role:角色扮演
  • RoleChain:角色链扮演
Role
Rolesarray<object>

配置的角色列表。

Roleobject
AssumeRoleForstring

扮演角色的所属主体。

1095******785714
RoleTypestring

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

  • service:由服务扮演
  • user:由普通用户账号扮演
service
RoleArnstring

角色 ARN。

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

工作目录的 OSS 路径。

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

运行时镜像版本。

2.0.0
RuntimeLogstring

运行时的日志。

oss://path/to/log/file

示例

正常返回示例

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"
}

错误码

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

变更历史

变更时间变更内容概要操作
2026-03-12新增 OpenAPI查看变更详情