列出数据集

最近更新时间:2024-06-17 10:23:11

我的收藏

简介

列出数据集功能是由 数据万象(Cloud Infinite,CI)提供的,数据万象将处理能力与 COS SDK 完全结合,您可以直接按照本篇文档指引进行使用。 本文档提供关于列出数据集的相关 API 概览以及 SDK 示例代码。
注意:
COS Javascript SDK 版本需要大于等于 v1.8.1。
API
操作描述
获取数据集(Dataset)列表。

列出数据集

功能说明

获取数据集(Dataset)列表。

使用示例

function describeDatasets() {
// sdk引入以及初始化请参考:https://cloud.tencent.com/document/product/436/11459
const config = {
// 需要替换成您自己的存储桶信息
AppId: '1250000000', // AppId,必须字段
Region: 'COS_REGION', // 存储桶所在地域,必须字段 如 ap-beijing
};
const key = 'datasets'; // 固定值
const host = `${config.AppId}.ci.${config.Region}.myqcloud.com`;
const url = `https://${host}/${key}`;
cos.request(
{
Method: 'GET', // 固定值,必须
Key: key, // 必须
Url: url, // 请求的url,必须
Query: {
// 本次返回数据集的最大个数,取值范围为0~200。不设置此参数或者设置为0时,则默认值为100。;是否必传:否
maxresults: 100,
// 翻页标记。当文件总数大于设置的MaxResults时,用于翻页的Token。从NextToken开始按字典序返回文件信息列表。填写上次查询返回的值,首次使用时填写为空。;是否必传:否
// nexttoken: '',
// 数据集名称前缀。;是否必传:否
// prefix: 'test',
},
Headers: {
// 设置响应体为json,固定值,必须
Accept: 'application/json',
},
},
function (err, data) {
if (err) {
// 处理请求失败
console.log(err.code, err.message);
} else {
// 处理请求成功
console.log(data);
}
}
);
}
describeDatasets()

参数说明

cos.request 方法参数说明:
参数名称
参数描述
类型
是否必填
Method
固定值:GET
String
Key
固定值:datasets
String
Url
请求 url,固定值
String
maxresults
本次返回数据集的最大个数,取值范围为0~200。不设置此参数或者设置为0时,则默认值为100。
Integer
nexttoken
翻页标记。当文件总数大于设置的 MaxResults 时,用于翻页的Token。从 NextToken 开始按字典序返回文件信息列表。填写上次查询返回的值,首次使用时填写为空。
String
prefix
数据集名称前缀。
String
Accept
设置响应体为 json,固定值
String

回调函数说明

function(err, data) { ... }
参数名称
参数描述
类型
err
请求发生错误时返回的对象,包括网络错误和业务错误。如果请求成功则为空,更多详情请参见 错误码
Object
- statusCode
请求返回的 HTTP 状态码,例如200、403、404等
Number
- headers
请求返回的头部信息
Object
data
请求成功时返回的对象,如果请求发生错误,则为空
Object
- statusCode
请求返回的 HTTP 状态码,例如200、403、404等
Number
- headers
请求返回的头部信息
Object
- Datasets
数据集信息,详情请参见 列出数据集
Object
- RequestId
请求 ID
String
- NextToken
翻页标记。
当文件总数大于设置的 MaxResults 时,用于翻页的 Token。
符合条件的文件信息未全部返回时,此参数才有值。
下一次列出文件信息时将此值作为 NextToken 传入,将后续的文件信息返回。
String

相关链接