tencent cloud

Cloud Infinite

문서Cloud InfiniteAPI DocumentationIntelligent Search MetaInsightMetadata ManagementUpdating Metadata Index

Updating Metadata Index

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

Feature Description

Update part of the metadata for the indexed files in the dataset.
Not all metadata can be updated by you. When you initiate an update request, you need to specify the dataset. The system will re-extract metadata based on the dataset's search template and update the existing metadata index. You can also update some custom metadata indexes, such as CustomLabels and CustomId. For details, see Request Parameter Description.

Authorization Description

When using a sub-account, add the ci:UpdateFileMetaIndex permission to the action of the authorization policy. For all operation 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

PUT /filemeta HTTP/1.1
Host: <AppId>.ci.ap-jakarta.myqcloud.com
Authorization: Auth String
Content-Length: xxx
Content-Type: application/json
Accept: application/json
Note:
Authorization: A request header that carries authentication information and is used to verify the legitimacy of the request. For details, see Request Signature.

Request header

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

Request body

{
    "DatasetName": "test001",
    "File": {
        "URI": "cos://examplebucket-1250000000/test1/img.jpg",
        "CustomId": "001",
        "CustomLabels": {
            "age": "18",
            "level": "18"
        },
        "MediaType": "image",
        "ContentType": "image/jpeg"
    }
}
The specific parameters are as follows:
Parameter Name
Description
Type
Required
DatasetName
Dataset name, unique within the same account. You can query it through the console or API.
String
Yes
File
File information used to create indexes
Container
Yes
File node content:
Parameter Name
Description
Type
Required
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.
String
Yes
CustomId
Custom ID. 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. During queries, this field supports prefix search and sorting. For details, see Scalar Search Expression Syntax.
String
No
CustomLabels
Custom tag. You can add custom tag key-value pair information based on your business needs, which can be used as filter criteria for search during queries. For details, see Scalar Search Expression Syntax.
Object
No
Key
Custom tag key. For details, see Scalar Search Expression Syntax.
String
No
Value
Custom tag value. For details, see Scalar Search Expression Syntax.
String
No
MediaType
Optional. File media type. Enumerated values:
image: image
document: document
archive: archive
video: video
audio: audio
other: other
String
No
ContentType
Optional. File content type (MIME Type), such as image/jpeg
String
No

Response

Response Headers

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

Response Body

{
    "EventId": "wie3580c6ca88dd83382cf52540067****",
    "RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"
}
The specific data content of the response body is as follows:
Parameter Name
Type
Description
EventId
String
Task ID for Creating Metadata Index
RequestId
String
Request ID.

이전 주제: Creating a Metadata Index다음 주제: Querying Metadata Indexes

도움말 및 지원

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

피드백

키워드로 검색
    Enter keywords to search documentation