Skip to main content

Get Dataset

Query detailed information about a specified RAG dataset

POST
/api/v1/connector/dash/getConnector
cURL
curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/connector/dash/getConnector" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connectorId": "conn_abc123"
  }'
{
  "code": "Success",
  "message": "",
  "messageUnmodified": false,
  "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "data": {
    "connectorId": "conn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxx",
    "connectorName": "默认文件数据集",
    "connectorType": "FILE",
    "connectorSubType": "UNSTRUCTURED",
    "description": "默认文件类型数据集",
    "gmtCreate": "2026-03-16 16:13:26",
    "gmtModified": "2026-03-16 16:13:26"
  },
  "status": 200
}
This resource is called a dataset in the console. For API compatibility, the endpoint path, operation name, and parameter names continue to use connector. At least one of connectorId and connectorName must be provided; if both are provided, connectorId takes precedence.

Authorizations

​
string
header
required

DashScope API Key，在控制台 API Key 页面 获取。

Body

application/json
​
string

数据集 ID，与 connectorName 至少传入一个。

​
string

数据集名称，与 connectorId 至少传入一个。

Required range:length <= 20

Response

200-application/json
​
string

响应码，成功时为 Success。

​
string

错误或提示信息，成功时为空字符串。

​
string

请求唯一标识，排查问题时请提供此 ID。

​
object
​
integer

业务状态码。成功为 200，参数错误等失败场景为 400。注意失败时 HTTP 状态码仍为 200，需根据本字段与 code 判断结果。