调用ListTensorboards API查询Tensorboard-人工智能平台 PAI-阿里云-人工智能平台 PAI(PAI)-阿里云帮助中心

查询已创建的Tensorboard列表。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

paidlc:ListTensorboards

get

*全部资源

*

无

请求语法

GET /api/v1/tensorboards HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
Verbose	boolean	否	是否显示详情。 true：显示详情。 false：不显示详情。	true
WorkspaceId	string	否	工作空间 ID。根据工作空间 ID 来获取 Tensorboard 列表。参见 ListWorkspaces 获取工作空间 ID。	380
SourceType	string	否	数据来源。目前仅支持 DLC 训练任务，即 job。	job
SourceId	string	否	数据来源 ID。参见 ListJobs 获取任务 ID。	dlc-xxxxxx
DisplayName	string	否	Tensorboard 展示名称。	TestTensorboard
Status	string	否	Tensorboard 状态： Creating：创建中。 Running：运行中。 Stopped：已停止。 Succeeded：已成功。 Failed：已失败。	Running
StartTime	string	否	查询区间的起始时间。使用 Tensorboard 的创建 UTC 时间来过滤。若为空，则默认为当前时间的 7 天之前。	2020-11-08T16:00:00Z
EndTime	string	否	查询区间的截止时间。使用 Tensorboard 的创建 UTC 时间来过滤。若为空，则默认为当前时间。	2020-11-09T14:45:00Z
SortBy	string	否	按返回的以下字段排序。 DisplayName：任务名称。 GmtCreateTime：任务创建时间。	GmtCreateTime
PageNumber	integer	否	分页查询，指定当前需要返回的页码，起始值为 1。	1
PageSize	integer	否	分页查询中，指定每页返回的 Tensorboard 数量。	50
Order	string	否	排序顺序。 desc：降序。 asc：升序。	desc
JobId	string	否	根据 DLC 任务 ID 来过滤 Tensorboard 任务。参见 ListJobs 获取任务 ID。	dlc-xxx
TensorboardId	string	否	根据 Tensorboard ID，来过滤 Tensorboard 列表。	tensorboard-xxx
ShowOwn	boolean	否	是否只返回当前登录者所创建的 Tensorboard。	false
PaymentType	string	否	Tensorboard 任务的付费类型。 Free 代表使用了免费资源的 Tensorboard 任务。 Postpaid 代表使用了后付费资源的 Tensorboard 任务。	Postpaid
UserId	string	否	用户 ID。	161****3000
Username	string	否	用户名。	she****mo
QuotaId	string	否	资源配额 ID。说明当前仅白名单用户可以使用资源配额资源创建 Tensorboard 任务，若需要使用该功能，请和我们联系。当前仅当 Tensorboard 任务使用资源配额的资源时，该值有效。	quota12***
Accessibility	string	否	任务的可见性。 PUBLIC：在此工作空间中，对所有人可见。 PRIVATE：在此工作空间中，仅对您和管理员可见。	PRIVATE

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Tensorboards	array	Tensorboard 列表及详情。
	Tensorboard	Tensorboard 详情。
TotalCount	integer	符合条件的数据源总数量。	100

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Tensorboards": [
    {
      "TensorboardId": "tensorboard-xxx",
      "TensorboardUrl": "http://xxxxxx",
      "Status": "running",
      "Duration": "60",
      "GmtCreateTime": "2021-01-12T14:35:00Z",
      "GmtModifyTime": "2021-01-12T14:36:00Z",
      "GmtFinishTime": "null",
      "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
      "DisplayName": "test",
      "DataSourceId": "datasource-test",
      "SummaryPath": "/root/data",
      "UserId": "lycxxxxx",
      "Username": "tensorboard.pai",
      "ReasonCode": "\"\"",
      "ReasonMessage": "\"\"",
      "JobId": "dlc-20210114104214-vf9lowjt3pso",
      "TensorboardDataSources": [
        {
          "DirectoryName": "dlcJobName",
          "Name": "dlcJobName",
          "Id": "d-vf2fdhxxxxxx",
          "DataSourceType": "OSS",
          "Uri": "oss://examplebucket.oss-cn-shanghai-internal.aliyuncs.com/",
          "SourceType": "datasource",
          "SummaryPath": "/tensorboard/run1",
          "FullSummaryPath": "oss://xxxxx/tensorboard/run1"
        }
      ],
      "TensorboardSpec": {
        "VpcId": "vpc-xxxx",
        "EcsType": "ecs.g6.large",
        "SecurityGroupId": "sg-xxxxx",
        "SwitchId": "vsw-xxxx"
      },
      "QuotaId": "quota12***",
      "Priority": "1",
      "QuotaName": "dlc-quota",
      "Accessibility": "PRIVATE"
    }
  ],
  "TotalCount": 100
}

错误码

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

变更历史

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