tencent cloud

Cloud Infinite

Querying Metadata Indexes

다운로드
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-09-08 16:24:28
AI 번역

Feature Description

Obtain the metadata of an indexed file in the dataset.

Authorization Description

When using a sub-account, add the ci:DescribeFileMetaIndex permission to the action of the authorization policy. For all APIs supported by Cloud Infinite, see CI action.

Use Limits

Before using this API, confirm the relevant restrictions. For details, see Usage Limits.

Request

Request sample

GET /filemeta?datasetname=test&uri=cos%3A%2F%2Fexamplebucket-1250000000%2Ftest.jpg HTTP/1.1
Host: <AppId>.ci.ap-jakarta.myqcloud.com
Date: <GMT Date>
Authorization: Auth String
Accept: application/json
Note:
Authorization: Auth String (For details, see Request Signature).
When using a sub-account, grant the required permissions. For details, see Authorization Granularity Details.

Request header

This API only uses common request headers. For details, see Common Request Headers.

Request Parameters

Parameter Name
Description
Type
Required
datasetname
Dataset name, unique within the same account. You can query it through the console or API
String
Yes
uri
Resource identifier field, indicating the file address for which an index needs to be created. Currently, only files on COS are supported. Field rule: cos://<BucketName>/<ObjectKey>, where BucketName indicates the COS Bucket name and ObjectKey indicates the complete file path. Example: cos://examplebucket-1250000000/test1/img.jpg
Attention:
Only COS files within the current account are supported
Addresses starting with HTTP are not supported
Requires URL encoding
String
Yes

Request body

This request has no request body.

Response

Response Headers

This API only returns common response headers. For details, see Common Response Headers.

Response Body

{
"Files": [{
"COSCRC64": "1111122467985959934",
"COSStorageClass": "STANDARD",
"ContentType": "image/jpeg",
"CreateTime": "2023-12-26T11:43:18.92077679+08:00",
"CustomId": "001",
"CustomLabels": {
"age": "18",
"level": "18"
},
"DatasetName": "test",
"ETag": "\\"21aeb337eb76df70dcb1e2618598****\\"",
"FileModifiedTime": "2023-06-07T07:18:04Z",
"Filename": "examplebucket-1250000000/test.jpg",
"MediaType": "image",
"ObjectACL": "default",
"Size": "10000",
"URI": "cos://examplebucket-1250000000/test.jpg",
"UpdateTime": "2023-12-26T11:45:02.445509346+08:00"
}],
"RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"

}
The specific data content of the response body is as follows:
Parameter Name
Type
Description
Files
Container Array
Structure that contains file metadata. The data actually returned may not include all attributes of this structure, which depends on the workflow template configuration you selected when indexing the file and the content of the file itself
RequestId
String
Request ID
Files node content:
Parameter Name
Type
Description
COSCRC64
String
File CRC64 value
COSStorageClass
String
File storage class
ContentType
String
File content type (MIME Type)
CreateTime
String
Timestamp of metadata creation time in RFC3339Nano format
CustomId
String
Custom ID of the file. After the file is indexed into the dataset, it is stored as an attribute of the metadata in that row for association and mapping with your business system. You can pass in this value based on your business requirements, for example, associating a URI with an ID in your system. It is recommended to pass in a globally unique value
CustomLabels
Container
Custom tag list of the file. Stores the key names and key-value pairs defined by your business, which can be used as filter criteria for search during queries
DatasetName
String
Data set name
ETag
String
When an Object is generated, a corresponding ETag is created. The ETag is used to identify the content of the Object
FileModifiedTime
String
Timestamp of the file's last modification time in RFC3339Nano format
Filename
String
File path
MediaType
String
File media type. Enumerated values:
image: image
other: other
document: document
archive: archive
audio: audio
video: video
ObjectACL
String
Access control list of the object
Size
Int
File size, in bytes
URI
String
Resource identifier field, indicating the file address for which an index needs to be created
UpdateTime
String
The timestamp of the metadata modification time, in RFC3339Nano format
After metadata is created, if it has not been updated, the timestamp of the metadata modification time is the same as the timestamp of the metadata creation time

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백