Fields and operators supported by AISearch - Object Storage Service

This topic describes the fields and operators supported by AISearch.

Supported fields

When you use the OSSUserMeta.* field to query objects, replace the asterisk (*) with the key of the user metadata. The system queries objects based on the key-value pair of the user metadata. The key of the user metadata is not case-sensitive, whereas the value is case-sensitive.
For example, if you want to query objects that contain the x-oss-meta-location=hangzhou user metadata field, set the query condition to {"Field": "OSSUserMeta.x-oss-meta-location", "Value": "hangzhou", "Operation": "eq"}.
When you use the OSSTagging.* field to query an object, replace the asterisk (*) with the key of an object tag. The system queries the object based on the key-value pair of the object tag. The keys and values of object tags are case-sensitive.
For example, if you want to query objects that contain the owner=John tag, set the query condition to {"Field": "OSSTagging.owner", "Value": "John", "Operation": "eq"}.

Category	Field	Description	Field-based object query	Field in the search results
Category	Field	Description	Field-based object query	Semantic content condition (no limit on object quantity)	Metadata condition (object quantity < 100 million)	Metadata condition (100 million < object quantity < 10 billion)
Basic information	URI	The path of the object.	✓	✓	✓	✓
	FileModifiedTime	The time when the object was last modified.	✓	✓	✓	✓
	Filename	The name of the object.	✓	✓	✓	✓
	Size	The size of the object.	✓	✓	✓	✓
	MediaType	The type of the media.	✓	✓	×	×
	ContentType	The Multipurpose Internet Mail Extensions (MIME) type of the object.	✓	✓	×	×
	ProduceTime	The time when the object was created.	✓	✓	×	×
	LatLong	The latitude and longitude of the address at which the object is created.	✓	✓	×	×
	Title	The title of the object.	✓	✓	×	×
OSS object information	ObjectACL	The access control list (ACL) of the object.	✓	✓	✓	✓
	ETag	ETag	✓	✓	✓	✓
	OSSCRC64	CRC64	✓	✓	✓	✓
	OSSObjectType	The type of the object.	✓	✓	✓	✓
	OSSStorageClass	The storage class of the object.	✓	✓	✓	✓
	OSSTagging.*	The tags of the object.	✓	✓	✓	✓
	OSSTaggingCount	The number of tags of the object.	✓	✓	✓	✓
	OSSUserMeta.*	The user metadata.	✓	✓	✓	×
	OSSExpiration	The time when the object expires.	✓	✓	✓	×
	AccessControlAllowOrigin	The origins from which cross-origin requests are allowed.	✓	✓	✓	×
	AccessControlRequestMethod	The allowed methods that are used to send cross-origin requests.	✓	✓	✓	×
	ServerSideDataEncryption	The server-side encryption method that is used to encrypt the object.	✓	✓	✓	×
	ServerSideEncryption	The server-side encryption algorithm that is used to encrypt the object.	✓	✓	✓	×
	ServerSideEncryptionCustomerAlgorithm	The server-side encryption algorithm specified by the customer.	✓	✓	✓	×
	ServerSideEncryptionKeyId	The ID of the customer master key (CMK) that is managed by Key Management Service (KMS) for server-side object encryption.	✓	✓	✓	×
	CacheControl	The caching behavior of the web page when the object is downloaded.	✓	✓	✓	×
	ContentDisposition	The method that is used to display the object.	✓	✓	✓	×
	ContentEncoding	The content encoding format of the object when the object is downloaded.	✓	✓	✓	×
	ContentLanguage	The language of the object content.	✓	✓	✓	×
Image information	ImageHeight	The height of the image.	✓	✓	×	×
Image information	ImageWidth	The width of the image.	✓	✓	×	×
Video information	VideoHeight	The height of the video.	✓	✓	×	×
	VideoWidth	The width of the video.	✓	✓	×	×
	VideoStreams.CodecName	The abbreviated name of the codec.	✓	✓	×	×
	VideoStreams.Language	The language used in the video stream.	✓	✓	×	×
	VideoStreams.Bitrate	The bitrate of the video stream.	×	✓	×	×
	VideoStreams.FrameRate	The frame rate of the video stream.	×	✓	×	×
	VideoStreams.StartTime	The start time of the video stream.	×	✓	×	×
	VideoStreams.Duration	The duration of the video stream.	×	✓	×	×
	VideoStreams.FrameCount	The number of video frames.	×	✓	×	×
	VideoStreams.BitDepth	The bit depth of the video stream.	×	✓	×	×
	VideoStreams.PixelFormat	The pixel format of the video stream.	×	✓	×	×
	VideoStreams.ColorSpace	The color space of the video stream.	×	✓	×	×
	VideoStreams.Height	The height of the video resolution.	×	✓	×	×
	VideoStreams.Width	The width of the video resolution.	×	✓	×	×
Audio information	AudioStreams.CodecName	The abbreviated name of the codec.	✓	✓	×	×
	AudioStreams.Bitrate	The bitrate.	×	✓	×	×
	AudioStreams.SampleRate	The sampling rate.	×	✓	×	×
	AudioStreams.StartTime	The start time of the audio stream.	×	✓	×	×
	AudioStreams.Duration	The duration of the audio stream.	×	✓	×	×
	AudioStreams.Channels	The number of sound channels.	×	✓	×	×
	AudioStreams.Language	The language used in the audio stream.	✓	✓	×	×
Subtitle information	Subtitles.CodecName	The abbreviated name of the codec.	✓	✓	×	×
	Subtitles.Language	The language of the subtitle.	✓	✓	×	×
	Subtitles.StartTime	The start time of the subtitle stream.	×	✓	×	×
	Subtitles.Duration	The duration of the subtitle stream.	×	✓	×	×
Media information	Bitrate	The bitrate.	✓	✓	×	×
	Artist	The artist.	✓	✓	×	×
	AlbumArtist	The artist of the album.	✓	✓	×	×
	Composer	The composer.	✓	✓	×	×
	Performer	The performer.	✓	✓	×	×
	Album	The name of the album.	✓	✓	×	×
	Duration	The duration of the media.	✓	✓	×	×
Geographic information	Addresses.AddressLine	The full address.	✓	✓	×	×
	Addresses.City	The city.	✓	✓	×	×
	Addresses.Country	The country.	✓	✓	×	×
	Addresses.District	The district.	✓	✓	×	×
	Addresses.Language	The language of the address.	✓	✓	×	×
	Addresses.Province	The province.	✓	✓	×	×
	Addresses.Township	The street.	✓	✓	×	×

Operators supported by fields

The following query operators are supported by fields: eq (equal to), gt (greater than), gte (greater than or equal to), lt (less than), lte (less than or equal to), match-phrase (string query), prefix (prefix query), nested (logical condition queries within the same object when the data type of a field is ARRAY), and exist (exists query).
The following aggregation operators are supported by fields: min (minimum), max (maximum), average (average), sum (sum), count (count), distinct (distinct count), and group (group count).

Category

Field

Description

Query operator

Aggregation operator

Sort

eq, gt,

gte, lt, lte

match-phrase

prefix

nested

exist

min, max,

sum, average

count

distinct

group

Basic information

URI

The path of the object.

✓

FileModifiedTime

The time when the object was last modified.

✓

Filename

The name of the object.

✓

Size

The size of the object.

✓

MediaType

The type of the media.

✓

ContentType

The MIME type of the object.

✓

ProduceTime

The time when the object was created.

✓

LatLong

The latitude and longitude of the address at which the object is created.

✓

Title

The title of the object.

✓

OSS object information

ObjectACL

The ACL of the object.

✓

ETag

✓

OSSCRC64

CRC64

✓

OSSObjectType

The type of the object.

✓

OSSStorageClass

The storage class of the object.

✓

OSSTagging.*

The tags of the object.

✓

OSSTaggingCount

The number of tags of the object.

✓

OSSUserMeta.*

The user metadata.

✓

OSSExpiration

The time when the object expires.

✓

AccessControlAllowOrigin

The origins from which cross-origin requests are allowed.

✓

AccessControlRequestMethod

The allowed methods that are used to send cross-origin requests.

✓

ServerSideDataEncryption

The server-side encryption method that is used to encrypt the object.

✓

ServerSideEncryption

The server-side encryption algorithm that is used to encrypt the object.

✓

ServerSideEncryptionCustomerAlgorithm

The server-side encryption algorithm specified by the customer.

✓

ServerSideEncryptionKeyId

The ID of the CMK that is managed by KMS for server-side object encryption.

✓

CacheControl

The caching behavior of the web page when the object is downloaded.

✓

ContentDisposition

The method that is used to display the object.

✓

ContentEncoding

The content encoding format of the object when the object is downloaded.

✓

ContentLanguage

The language of the object content.

✓

Image information

ImageHeight

The height of the image.

✓

ImageWidth

The width of the image.

✓

Video information

VideoHeight

The height of the video.

✓

VideoWidth

The width of the video.

✓

VideoStreams.CodecName

The abbreviated name of the codec.

✓

VideoStreams.Language

The language used in the video stream.

✓

VideoStreams.Bitrate

The bitrate of the video stream.

VideoStreams.FrameRate

The frame rate of the video stream.

VideoStreams.StartTime

The start time of the video stream.

VideoStreams.Duration

The duration of the video stream.

VideoStreams.FrameCount

The number of video frames.

VideoStreams.BitDepth

The bit depth of the video stream.

VideoStreams.PixelFormat

The pixel format of the video stream.

VideoStreams.ColorSpace

The color space of the video stream.

VideoStreams.Height

The height of the video resolution.

VideoStreams.Width

The width of the video resolution.

Audio information

AudioStreams.CodecName

The abbreviated name of the codec.

✓

AudioStreams.Bitrate

The bitrate.

AudioStreams.SampleRate

The sampling rate.

AudioStreams.StartTime

The start time of the audio stream.

AudioStreams.Duration

The duration of the audio stream.

AudioStreams.Channels

The number of sound channels.

AudioStreams.Language

The language used in the audio stream.

✓

Subtitle information

Subtitles.CodecName

The abbreviated name of the codec.

✓

Subtitles.Language

The language of the subtitle.

✓

Subtitles.StartTime

The start time of the subtitle stream.

Subtitles.Duration

The duration of the subtitle stream.

Media information

Bitrate

The bitrate.

✓

Artist

The artist.

✓

AlbumArtist

The artist of the album.

✓

Composer

The composer.

✓

Performer

The performer.

✓

Album

The name of the album.

✓

Duration

The duration of the media.

✓

Geographic information

Addresses.AddressLine

The full address.

✓

Addresses.City

The city.

✓

Addresses.Country

The country.

✓

Addresses.District

The district.

✓

Addresses.Language

The language of the address.

✓

Addresses.Province

The province.

✓

Addresses.Township

The street.

✓