跳到主要内容

查看导入进度
即将作废

Retrieves the progress of a specified import task.

GET
/v1/vector/collections/import/get
Base URL

该 API 的 Base URL 格式如下:

https://controller.api.${CLOUD_REGION}.zilliz.com.cn

📘说明
export CLOUD_REGION="ali-cn-hangzhou"
export BASE_URL="https://controller.api.${CLOUD_REGION}.zilliz.com.cn"
参数
Authorizationstringheaderrequired

认证令牌,应为具备适当权限的 API 密钥或用冒号分隔的用户名和密码,如 username:password

示例值:Bearer {{TOKEN}}
jobIdstringqueryrequired

导入任务的 ID。

示例值:job-xxxxxxxxxxxxxxxxxx
clusterIdstringqueryrequired

集群 ID。

示例值:inxx-xxxxxxxxxxxxxxx
export TOKEN="YOUR_API_KEY"

curl --request GET \
--url "${BASE_URL}/v1/vector/collections/import/get?jobId=job-xxxxxxxxxxxxxxxxxx&clusterId=inxx-xxxxxxxxxxxxxxx" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json"
响应200 - application/json
codeinteger

响应码。

dataobject

指定导入任务的进度详情。

fileNamestring

The path of the data file object in the object storage.

fileSizeinteger<int64>

The size of the data file object.

readyPercentagenumber<float>

The indicator of the import progress

completeTimestring

The time at which the import task completes. null indicates that the file import is going on.

errorMessagestring

The message that explains the reason for an import failure. null indicates that no error occurs.

collectionNamestring

The target collection name of the import task.

jobIdstring

The ID of an import task.

detailsarray

The import task details

[]detailsobject

A list of import progress details per data files

fileNamestring

The path to a file being imported.

fileSizeinteger<int64>

The size of a file being imported.

readyPercentagenumber<float>

The import progress of a specific file.

completeTimestring

The time at which the import progress ends for a specific file. null indicates that the file import is going on.

errorMessagestring

The message that explains the reason for an import failure. null indicates that no error occurs.

返回错误消息。

codeinteger

响应码。

messagestring

错误描述。

{
"code": 200,
"data": {
"collectionName": "medium_articles",
"fileName": "1af78216-xxxx-xxxx-xxxx-2b0a73c566ed/1.parquet",
"fileSize": 19599887,
"readyPercentage": 0,
"completeTime": null,
"errorMessage": null,
"jobId": "job-xxxxxxxxxxxxxxxxxxxxxx",
"details": [
{
"fileName": "1af78216-xxxx-xxxx-xxxx-2b0a73c566ed/1.parquet",
"fileSize": 19599887,
"readyPercentage": 0,
"completeTime": null,
"errorMessage": null
}
]
}
}