创建一个Tensorboard，可以通过一个任务或者指定数据源配置来创建。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| paidlc:CreateTensorboard | create |
|
| 无 |
请求语法
POST /api/v1/tensorboards
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| body | object | 否 | 请求参数。 | |
| WorkspaceId | string | 否 | 工作空间 ID。如何获取工作空间 ID，请参见 ListWorkspaces 。 | 123*** |
| JobId | string | 否 | 任务 ID。如何获取任务 ID，请参见 ListJobs 。 | dlc-20210126170216-mtl37ge7gkvdz |
| DataSourceId | string | 否 | 数据集 ID，如何获取数据集 ID，请参见 ListDatasets 。 | d-xxxxxxxx |
| DataSourceType | string | 否 | 数据集类型，取值如下：
| OSS |
| Uri | string | 否 | 数据集的 URI：
| oss://.oss-cn-shanghai-finance-1.aliyuncs.com/ |
| Options | string | 否 | 数据集的扩展字段为 JSON 格式，当前支持 MountPath：自定义数据集挂载的路径。 | {"mountpath":"/root/data/"} |
| SummaryPath | string | 否 | Summary 目录。 | /root/data/ |
| SummaryRelativePath | string | 否 | Summary 相对目录。 | /summary/ |
| DisplayName | string | 否 | Tensorboard 名称。 | tensorboard |
| SourceType | string | 否 | 来源类型。 | job |
| SourceId | string | 否 | 来源 ID。 | dlc-xxxxxx |
| MaxRunningTimeMinutes | long | 否 | 最长运行时长，单位为：分钟。 | 240 |
| DataSources | array | 否 | 数据源配置。 | |
| DataSourceItem | 否 | 数据源信息。 | ||
| Cpu | long | 否 | CPU 核数。 | 1 |
| Memory | long | 否 | 内存大小，单位为：GB。 | 1000 |
| TensorboardDataSources | array | 否 | Tensorboard 任务挂载的数据集配置列表。 | |
| TensorboardDataSourceSpec | 否 | Tensorboard 数据源配置信息，用于 Tensorboard 挂载多数据集功能。目前支持按数据集配置（datasource）和按任务配置（dlc）。当 Tensorboard 数据源配置信息不为空时，DataSourceId 配置，Uri, DataSourceType 等参数不生效 | ||
| TensorboardSpec | TensorboardSpec | 否 | Tensorboard 后付费配置信息，用于创建使用后付费资源的 Tensorboard 任务。 | |
| QuotaId | string | 否 | 资源配额 ID。使用资源配额的资源创建 Tensorboard 任务时的必填参数。如何获取资源配额 ID，请参见 ListQuotas 。 当前仅白名单用户可以使用资源配额资源创建 Tensorboard 任务，若需要使用该功能，请和我们联系 | quota12345 |
| Priority | string | 否 | 任务的优先级，可选参数，默认值 1，参数值的范围是 1~9。其中：
| 1 |
| Accessibility | string | 否 | 任务的可见性，取值如下：
| PRIVATE |
返回参数
示例
正常返回示例
JSON格式
{
"JobId": "dlc-20210126170216-xxxxxxxx",
"DataSourceId": "ds-20210126170216-xxxxxxxx",
"TensorboardId": "tbxxxxxxxx",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-07-11 | API 内部配置变更，不影响调用 | 查看变更详情 |
| 2024-03-28 | API 内部配置变更，不影响调用 | 查看变更详情 |