调用ListDataSources获取数据源列表,支持按名称模糊查找、排序和分页。

调试

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

请求语法

GET /api/v1/datasources?DataSourceType=String&DisplayName=String&PageNumber=Integer&PageSize=Integer&SortBy=String&Order=String HTTP/1.1
Content-Type:application/json

请求参数

表 1. 请求Query参数
参数名称 类型 是否必选 示例 说明
DataSourceType String nas

数据源类型;默认为空,代表任意类型。

DisplayName String nas-data

数据源名称,支持模糊查询。默认为空,代表任意数据源名称。

PageNumber Integer 1

查询第几页数据。默认为1。

PageSize Integer 50

设置查询的每页大小。默认为10。

SortBy String GmtCreateTime

返回数据源的排序字段,枚举型:

  • DataSourceType
  • DisplayName
  • GmtCreateTime
Order String desc

排序顺序,枚举:

  • desc
  • asc

响应体语法

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DataSources" : [ {
    "DataSourceType" : "String",
    "DataSourceId" : "String",
    "DisplayName" : "String",
    "Description" : "String",
    "FileSystemId" : "String",
    "MountPath" : "String",
    "UserId" : "String",
    "GmtCreateTime" : "String",
    "GmtModifyTime" : "String"
  } ],
  "TotalCount" : Long,
  "RequestId" : "String"
}

响应参数

表 2. 响应Body参数
参数名称 类型 示例 说明
DataSources Array of DataSourceItem

数据源列表

TotalCount Long 100

符合条件的数据源总数量

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

本次调用的请求ID,用于诊断和答疑。

查询所有nas类型的数据源

GET /api/v1/datasources?DataSourceType=nas HTTP/1.1 
Host:pai-dlc.aliyuncs.com 
Content-Type:application/json

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DataSources>
    <DataSourceType>nas</DataSourceType>
    <DataSourceId>data-20210114104214-vf9lowjt3pso</DataSourceId>
    <DisplayName>nas-data</DisplayName>
    <Description>data source of dlc examples</Description>
    <FileSystemId>1ca404****</FileSystemId>
    <MountPath>/root/data/</MountPath>
    <UserId>123456789</UserId>
    <GmtCreateTime>2021-01-12T14:35:00Z</GmtCreateTime>
    <GmtModifyTime>2021-01-12T14:36:00Z</GmtModifyTime>
</DataSources>
<TotalCount>100</TotalCount>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DataSources" : [ {
    "DataSourceType" : "nas",
    "DataSourceId" : "data-20210114104214-vf9lowjt3pso",
    "DisplayName" : "nas-data",
    "Description" : "data source of dlc examples",
    "FileSystemId" : "1ca404****",
    "MountPath" : "/root/data/",
    "UserId" : "123456789",
    "GmtCreateTime" : "2021-01-12T14:35:00Z",
    "GmtModifyTime" : "2021-01-12T14:36:00Z"
  } ],
  "TotalCount" : 100,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

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

开发者资源

  • SDK

    阿里云为您提供多种语言的SDK,帮助您快速通过API集成阿里云的产品和服务,推荐您使用SDK调用API,已免除您手动签名验证。

  • OpenAPI Explorer

    快速检索,可视化调试API,在线命令行工具,同步动态生成可执行的SDK代码示例。

  • 阿里云CLI

    阿里云资产管理和配置工具,可通过命令方式同时管理多个阿里云产品和服务,简单快捷,是您上云好帮手。