Tüm Ürünler
Search

Bu Ürün

    :DoMetaQuery

    Belge Merkezi

    :DoMetaQuery

    Son Güncelleme:Oct 01, 2026

    DoMetaQuery işlemi, belirtilen koşulları karşılayan nesneleri sorgular ve nesne bilgilerini belirtilen bir alana ve sıralama düzenine göre listeler. Karmaşık sorgular için Query öğelerini iç içe yerleştirebilir ve alan değerleri üzerinde istatistik toplamak için toplu işlem operasyonlarını kullanabilirsiniz.

    Dikkat Edilmesi Gerekenler

    Belirtilen koşulları karşılayan nesneleri sorgulamak için oss:DoMetaQuery iznine sahip olmanız gerekir. RAM kullanıcısına özel izinler atayın.

    İstek sözdizimi

    Skaler alma

    POST /?metaQuery&comp=query&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken></NextToken>
  <MaxResults>5</MaxResults>
  <Query>{"Field": "Size","Value": "1048576","Operation": "gt"}</Query>
  <Sort>Size</Sort>
  <Order>asc</Order>
  <Aggregations>
    <Aggregation>
      <Field>Size</Field>
      <Operation>sum</Operation>
    </Aggregation>
    <Aggregation>
      <Field>Size</Field>
      <Operation>max</Operation>
    </Aggregation>
  </Aggregations>
</MetaQuery>

    Vektör alma

    POST /?metaQuery&comp=query&mode=semantic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <MaxResults>99</MaxResults>
  <Query>An aerial view of a snow-covered forest</Query>
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>  
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

    İstek üstbilgileri

    DescribeRegions yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

    İstek öğeleri

    Skaler alma

    Ad

    Tür

    Gerekli

    Örnek değer

    Açıklama

    mode

    String

    Evet

    basic

    Alma modunu skaler almaya ayarlar.

    MetaQuery

    Container

    Evet

    Yok

    Sorgu koşulları için kapsayıcı.

    Alt düğümler: NextToken, MaxResults, Query, Sort, Order ve Aggregations

    NextToken

    String

    Hayır

    MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****

    Sayfalama belirteci. Toplam nesne sayısı MaxResults değerini aştığında gereklidir.

    Nesne bilgileri, NextToken tarafından belirtilen nesneden başlayarak sözlük sırasına göre döndürülür.

    İlk istek için bu alanı boş bırakın.

    Üst düğüm: MetaQuery

    MaxResults

    Integer

    Hayır

    5

    Döndürülecek maksimum nesne sayısı. Geçerli değerler: 0 ila 100.

    Varsayılan: 100. Ayarlanmadığında veya 0 olarak ayarlandığında etkin olur.

    Üst düğüm: MetaQuery

    Query

    String

    Evet

    {"Field": "Size","Value": "1048576","Operation": "gt"}

    Sorgu koşulu. Seçenekler:

    • Operation: Operatör. Geçerli değerler: eq (eşittir), gt (büyüktür), gte (büyük veya eşittir), lt (küçüktür), lte (küçük veya eşittir), match (bulanık sorgu), prefix (ön ek sorgusu), and (mantıksal VE), or (mantıksal VEYA) ve not (mantıksal DEĞİL).

    • Field: Alan adı. Desteklenen alanlar ve operatörler Ek: Skaler alma için alanlar ve operatörler bölümünde listelenmiştir.

    • Value: Alan değeri.

    • SubQueries: Alt sorgu koşulları. Seçenekler basit sorgu koşullarıyla aynıdır. Yalnızca Operation mantıksal bir operatör (and, or veya not) olduğunda gereklidir.

    Sorgu örnekleri için bkz. DoMetaQuery.

    Üst düğüm: MetaQuery

    Sort

    String

    Hayır

    Size

    Sonuçları belirtilen bir alana göre sıralar. Sıralanabilir alanlar Ek: Skaler alma için alanlar ve operatörler bölümünde listelenmiştir.

    Üst düğüm: MetaQuery

    Order

    String

    Hayır

    asc

    Sıralama düzeni. Geçerli değerler:

    • asc: artan

    • desc (varsayılan): azalan

    Üst düğüm: MetaQuery

    Aggregations

    Container

    Hayır

    Yok

    Toplu işlem operasyonları için kapsayıcı.

    Alt düğüm: Aggregation

    Üst düğüm: MetaQuery

    Aggregation

    Container

    Hayır

    Yok

    Tek bir toplu işlem operasyonu için kapsayıcı.

    Alt düğümler: Field ve Operation

    Üst düğüm: Aggregations

    Field

    String

    Hayır

    Size

    Alan adı. Desteklenen alanlar ve operatörler Ek: Skaler alma için alanlar ve operatörler bölümünde listelenmiştir.

    Üst düğüm: Aggregation

    Operation

    String

    Hayır

    sum

    Toplu işlem operasyonundaki operatör. Geçerli değerler:

    • min: minimum değer

    • max: maksimum değer

    • average: ortalama değer

    • sum: toplam

    • Count

    • distinct: yinelenmeyen sayı

    • group: grup sayısı

    Üst düğüm: Aggregation

    Vektör alma

    Ad

    Tür

    Gerekli

    Örnek

    Açıklama

    mode

    String

    Evet

    semantic

    Alma modunu vektör almaya ayarlar.

    MetaQuery

    Container

    Evet

    Yok

    Sorgu koşulları için kapsayıcı.

    Alt düğümler: MaxResults, Query, MediaTypes ve SimpleQuery

    MaxResults

    Integer

    Hayır

    5

    Döndürülecek maksimum nesne sayısı. Geçerli değerler: 0 ila 100.

    Varsayılan: 100. Ayarlanmadığında veya 0 olarak ayarlandığında etkin olur.

    Üst düğüm: MetaQuery

    Query

    String

    Evet

    An aerial view of a snow-covered forest

    Alınacak içerik.

    Üst düğüm: MetaQuery

    MediaTypes

    Container

    Evet

    Yok

    Multimedya meta verisi alma koşulları.

    Üst düğüm: MetaQuery

    MediaType

    String

    Evet

    image

    Alınacak multimedya türü. Geçerli değerler:

    • Image:

    • video

    • audio

    • document

    Üst düğüm: MediaTypes

    SimpleQuery

    String

    Hayır

    {"Operation":"gt", "Field": "Size", "Value": "30"}

    Sorgu koşulu. Seçenekler:

    • Operation: Operatör. Geçerli değerler: eq (eşittir), gt (büyüktür), gte (büyük veya eşittir), lt (küçüktür), lte (küçük veya eşittir), match (bulanık sorgu), prefix (ön ek sorgusu), and (mantıksal VE), or (mantıksal VEYA) ve not (mantıksal DEĞİL).

    • Field: Alan adı. Desteklenen alanlar ve operatörler Ek: Vektör alma için alanlar ve operatörler bölümünde listelenmiştir.

    • Value: Alan değeri.

    • SubQueries: Alt sorgu koşulları. Seçenekler basit sorgu koşullarıyla aynıdır. Yalnızca Operation mantıksal bir operatör (and, or veya not) olduğunda gereklidir.

    Üst düğüm: MetaQuery

    Yanıt üstbilgileri

    Yanıt yalnızca ortak yanıt üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

    Yanıt öğeleri

    Scalar retrieval

    Name

    Type

    Example

    Description

    MetaQuery

    Container

    N/A

    Sorgu sonuçları için kapsayıcı.

    Alt düğümler: NextToken, Files ve Aggregations

    NextToken

    String

    MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****

    Sayfalama belirteci. Toplam nesne sayısı MaxResults değerini aştığında gereklidir.

    Kalan sonuçları almak için bu değeri sonraki istekte NextToken olarak iletin.

    Yalnızca yanıtta tüm nesneler yer almıyorsa döndürülür.

    Üst düğüm: MetaQuery

    Files

    Container

    N/A

    Nesne bilgileri için kapsayıcı.

    Alt düğüm: File

    Üst düğüm: MetaQuery

    File

    Container

    N/A

    Tek bir nesne için kapsayıcı.

    Alt düğümler: Filename, Size, FileModifiedTime, OSSObjectType, OSSStorageClass, ObjectACL, ETag, OSSTaggingCount, OSSTagging ve OSSCRC64

    Üst düğüm: Files

    Filename

    String

    exampleobject.txt

    Nesnenin tam yolu.

    Üst düğüm: File

    Size

    Integer

    120

    Nesnenin bayt cinsinden boyutu.

    Üst düğüm: File

    FileModifiedTime

    String

    2025-05-19T16:14:38+08:00

    Nesnenin son değiştirilme zamanı. Format RFC3339Nano şeklindedir.

    Üst düğüm: File

    OSSObjectType

    String

    Normal

    Nesne türü. Geçerli değerler:

    • Normal: Nesne, PutObject işlemi çağrılarak yüklenir veya CreateDirectory işlemi çağrılarak oluşturulur.

    • Appendable: Nesne, AppendObject işlemi çağrılarak yüklenir.

    • Multipart: Nesne, MultipartUpload işlemi çağrılarak yüklenir.

    • Symlink: Sembolik bağlantı, PutSymlink işlemi çağrılarak oluşturulur.

    Üst düğüm: File

    OSSStorageClass

    String

    Standard

    Nesnenin depolama sınıfı. Geçerli değerler:

    • Standard: Sık erişilen veriler için yüksek güvenilirlikli, yüksek kullanılabilirliğe sahip ve yüksek performanslı depolama.

    • IA: Nadiren erişilen (ortalama ayda bir veya iki kez) uzun süreli depolama için uygundur.

    • Archive: Nadiren erişilen verilerin (altı ay veya daha fazla önerilir) uzun süreli arşivlenmesi için uygundur. Okuma öncesinde yaklaşık 1 dakikalık geri yükleme süresi gerektirir.

    • ColdArchive: Nadiren erişilen verilerin uzun süreli depolanması için uygundur.

    Üst düğüm: File

    ObjectACL

    String

    default

    Nesnenin ACL'si. Geçerli değerler:

    • default: Paket ACL'sini devralır.

    • private: Yalnızca nesne sahibi ve yetkilendirilmiş kullanıcılar okuma ve yazma yapabilir. Diğer kullanıcılar nesneye erişemez.

    • public-read: Sahip ve yetkilendirilmiş kullanıcılar okuma ve yazma yapabilir. Diğer kullanıcılar yalnızca okuma yapabilir. Dikkatli kullanın.

    • public-read-write: Tüm kullanıcılar okuma ve yazma yapabilir. Dikkatli kullanın.

    Üst düğüm: File

    ETag

    String

    "fba9dede5f27731c9771645a3986****"

    Bir nesne oluşturulduğunda bir ETag üretilir. Bu etiket, nesnenin içeriğini tanımlar.

    • PutObject isteğiyle oluşturulan bir nesne için ETag değeri, içeriğin MD5 karma değeridir.

    • Diğer yöntemlerle oluşturulan nesneler için ETag benzersiz bir değerdir ancak içeriğin MD5 karma değeri değildir.

    Not

    Nesne içeriğinin değişip değişmediğini kontrol etmek için ETag'i kullanabilirsiniz, ancak veri bütünlüğü doğrulaması için MD5 karması olarak kullanmayın.

    Üst düğüm: File

    OSSTaggingCount

    Integer

    2

    Nesnenin etiket sayısı.

    Üst düğüm: File

    OSSTagging

    Container

    N/A

    Etiket bilgileri için kapsayıcı.

    Alt düğüm: Tagging

    Üst düğüm: File

    Tagging

    Container

    N/A

    Tek bir etiket için kapsayıcı.

    Alt düğümler: Key ve Value

    Üst düğüm: OSSTagging

    Key

    String

    owner

    Etiketin veya kullanıcı tanımlı meta verilerin anahtarı.

    Kullanıcı tanımlı meta verilerin anahtarı x-oss-meta- önekiyle başlamalıdır.

    Üst düğümler: Tagging ve UserMeta

    Value

    String

    John

    Etiketin veya kullanıcı tanımlı meta verilerin değeri.

    Üst düğümler: Tagging ve UserMeta

    OSSCRC64

    String

    4858A48BD1466884

    Nesnenin 64 bitlik CRC değeri. 64 bitlik CRC değeri, CRC-64/XZ standardına göre hesaplanır.

    Üst düğüm: File

    Aggregations

    Container

    N/A

    Toplama işlemleri için kapsayıcı.

    Alt düğümler: Field, Operation, Operation, Value ve Groups

    Üst düğüm: MetaQuery

    Field

    String

    Size

    Alan adı.

    Üst düğüm: Aggregations

    Operation

    String

    sum

    Toplama operatörü.

    Üst düğüm: Aggregations

    Value

    Floating-point number

    200

    Toplama işleminin sonuç değeri.

    Üst düğüm: Aggregations

    Groups

    Container

    N/A

    Gruplama ve toplama sonuçlarının listesi.

    Alt düğümler: Value ve Count

    Üst düğüm: Aggregations

    Value

    String

    100

    Gruplama ve toplamanın değeri.

    Üst düğüm: Groups

    Count

    Integer

    5

    Gruplama ve toplama sonuçlarının sayısı.

    Üst düğüm: Groups

    Vektör getirme

    Ad

    Tür

    Örnek

    Açıklama

    MetaQuery

    Container

    N/A

    Sorgu sonuçları için kapsayıcı.

    Alt düğüm: Files

    Files

    Container

    N/A

    Nesne bilgilerinin listesi.

    Alt düğüm: File

    Üst düğüm: MetaQuery

    File

    Container

    N/A

    Tek bir nesneye ilişkin bilgiler.

    Üst düğüm: Files

    URI

    String

    oss://examplebucket/test-object.jpg

    Nesnenin tam yolu.

    Üst düğüm: File

    Filename

    String

    exampleobject.txt

    Nesnenin adı.

    Üst düğüm: File

    Size

    Integer

    120

    Nesnenin bayt cinsinden boyutu.

    Üst düğüm: File

    ObjectACL

    String

    default

    Nesnenin Erişim Kontrol Listesi (ACL). Geçerli değerler:

    • default: Paket ACL'sini devralır.

    • private: Yalnızca nesne sahibi ve yetkili kullanıcılar okuma ve yazma işlemi yapabilir. Diğer kullanıcılar nesneye erişemez.

    • public-read: Sahip ve yetkili kullanıcılar okuma ve yazma işlemi yapabilir. Diğer kullanıcılar yalnızca okuma yapabilir. Dikkatli kullanın.

    • public-read-write: Tüm kullanıcılar okuma ve yazma işlemi yapabilir. Dikkatli kullanın.

    Üst düğüm: File

    FileModifiedTime

    String

    2025-05-19T16:15:33+08:00

    Nesnenin son değiştirilme zamanı. Format RFC3339Nano şeklindedir.

    Üst düğüm: File

    ETag

    String

    "fba9dede5f27731c9771645a3986****"

    Bir nesne oluşturulduğunda ETag üretilir. Bu etiket, nesnenin içeriğini tanımlar.

    • PutObject isteğiyle oluşturulan bir nesne için ETag değeri, içeriğin MD5 karmasıdır.

    • Diğer yöntemlerle oluşturulan nesneler için ETag benzersiz bir değerdir ancak içeriğin MD5 karması değildir.

    Not

    Nesne içeriğinin değişip değişmediğini kontrol etmek için ETag'i kullanabilirsiniz ancak veri bütünlüğü doğrulaması için MD5 karması olarak kullanmayın.

    Üst düğüm: File

    OSSCRC64

    String

    4858A48BD1466884

    Nesnenin 64 bitlik CRC değeri. 64 bitlik CRC değeri, CRC-64/XZ standardına göre hesaplanır.

    Üst düğüm: File

    ProduceTime

    String

    2021-06-29T14:50:13.011643661+08:00

    Fotoğraf veya videonun cihaz tarafından çekildiği zaman.

    Üst düğüm: File

    ContentType

    String

    image/jpeg

    Çok Amaçlı İnternet Posta Uzantıları (MIME) türü.

    Üst düğüm: File

    MediaType

    String

    image

    Medya türü.

    Üst düğüm: File

    LatLong

    String

    30.134390,120.074997

    Enlem ve boylam bilgisi.

    Üst düğüm: File

    Title

    String

    test

    Dosyanın başlığı.

    Üst düğüm: File

    OSSExpiration

    String

    2124-12-01T12:00:00.000Z

    Dosyanın sona erme zamanı.

    Üst düğüm: File

    AccessControlAllowOrigin

    String

    https://aliyundoc.com

    Kaynaklar arası istek göndermesine izin verilen kaynak.

    Üst düğüm: File

    AccessControlRequestMethod

    String

    PUT

    Kaynaklar arası istekte kullanılan yöntem.

    Üst düğüm: File

    CacheControl

    String

    no-cache

    Nesne indirilirken web sayfası önbelleğe alma davranışı.

    Üst düğüm: File

    ContentDisposition

    String

    attachment; filename =test.jpg

    Nesne indirilirken kullanılacak dosya adı.

    Üst düğüm: File

    ContentEncoding

    String

    UTF-8

    Nesne indirilirken kullanılan içerik kodlama formatı.

    Üst düğüm: File

    ContentLanguage

    String

    zh-CN

    Nesne içeriğinde kullanılan dil.

    Üst düğüm: File

    ImageHeight

    Integer

    500

    Görüntünün piksel (px) cinsinden yüksekliği.

    Üst düğüm: File

    ImageWidth

    Integer

    270

    Görüntünün piksel (px) cinsinden genişliği.

    Üst düğüm: File

    VideoWidth

    Integer

    1080

    Video karesinin piksel (px) cinsinden genişliği.

    Üst düğüm: File

    VideoHeight

    Integer

    1920

    Video karesinin piksel (px) cinsinden yüksekliği.

    Üst düğüm: File

    VideoStreams

    Container

    N/A

    Video akışlarının listesi.

    Üst düğüm: File

    VideoStream

    Container

    N/A

    Video akışı.

    Üst düğüm: VideoStreams

    CodecName

    String

    h264

    Kod çözücünün adı.

    Üst düğüm: VideoStream

    Language

    String

    en

    Video akışında kullanılan dil. Format BCP 47 şeklindedir.

    Üst düğüm: VideoStream

    Bitrate

    Integer

    5407765

    Bit hızı (bit/s).

    Üst düğüm: VideoStream

    FrameRate

    String

    25/1

    Video akışının kare hızı.

    Üst düğüm: VideoStream

    StartTime

    Double-precision floating-point number

    0.000000

    Video akışının saniye (s) cinsinden başlangıç zamanı.

    Üst düğüm: VideoStream

    Duration

    Double-precision floating-point number

    22.88

    Video akışının saniye (s) cinsinden süresi.

    Üst düğüm: VideoStream

    FrameCount

    Integer

    572

    Video karelerinin sayısı.

    Üst düğüm: VideoStream

    BitDepth

    Integer

    8

    Piksel bit derinliği.

    Üst düğüm: VideoStream

    PixelFormat

    String

    yuv420p

    Video akışının piksel formatı.

    Üst düğüm: VideoStream

    ColorSpace

    String

    bt709

    Renk uzayı.

    Üst düğüm: VideoStream

    Height

    Integer

    720

    Video akışı karesinin piksel (px) cinsinden yüksekliği.

    Üst düğüm: VideoStream

    Width

    Integer

    1280

    Video akışı karesinin piksel (px) cinsinden genişliği.

    Üst düğüm: VideoStream

    AudioStreams

    Container

    N/A

    Ses akışlarının listesi.

    Üst düğüm: File

    AudioStream

    Container

    N/A

    Ses akışı.

    Üst düğüm: AudioStreams

    CodecName

    String

    aac

    Kod çözücünün adı.

    Üst düğüm: AudioStream

    Bitrate

    Integer

    320087

    Bit hızı (bit/s).

    Üst düğüm: AudioStream

    SampleRate

    Integer

    48000

    Örnekleme hızı (Hz).

    Üst düğüm: AudioStream

    StartTime

    Double-precision floating-point number

    0.0235

    Ses akışının saniye (s) cinsinden başlangıç zamanı.

    Üst düğüm: AudioStream

    Duration

    Double-precision floating-point number

    3.690667

    Ses akışının saniye (s) cinsinden süresi.

    Üst düğüm: AudioStream

    Channels

    Integer

    2

    Ses kanallarının sayısı.

    Üst düğüm: AudioStream

    Language

    String

    en

    Ses akışında kullanılan dil. Format BCP 47 şeklindedir.

    Üst düğüm: AudioStream

    Subtitles

    Container

    N/A

    Altyazı akışlarının listesi.

    Üst düğüm: File

    Subtitle

    Container

    N/A

    Altyazı akışı.

    Üst düğüm: Subtitles

    CodecName

    String

    mov_text

    Kod çözücünün adı.

    Üst düğüm: Subtitle

    Language

    String

    en

    Altyazının dili. Format BCP 47 şeklindedir.

    Üst düğüm: Subtitle

    StartTime

    Double-precision floating-point number

    0.000000

    Altyazı akışının saniye (s) cinsinden başlangıç zamanı.

    Üst düğüm: Subtitle

    Duration

    Double-precision floating-point number

    71.378

    Altyazı akışının saniye (s) cinsinden süresi.

    Üst düğüm: Subtitle

    Bitrate

    Integer

    13091201

    Bit hızı (bit/s).

    Üst düğüm: File

    Artist

    String

    Jane

    Sanatçı.

    Üst düğüm: File

    AlbumArtist

    String

    Jenny

    Sanatçı.

    Üst düğüm: File

    Composer

    String

    Jane

    Besteci.

    Üst düğüm: File

    Performer

    String

    Jane

    İcra eden sanatçı.

    Üst düğüm: File

    Album

    String

    FirstAlbum

    Albüm.

    Üst düğüm: File

    Duration

    Double-precision floating-point number

    15.263000

    Videonun toplam süresi (saniye).

    Üst düğüm: File

    Addresses

    Container

    N/A

    Adres bilgisi.

    Üst düğüm: File

    Address

    Container

    N/A

    Adres bilgisi.

    Üst düğüm: Addresses

    AddressLine

    String

    No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China

    Tam adres.

    Üst düğüm: Address

    City

    String

    Hangzhou

    Şehir.

    Üst düğüm: Address

    District

    String

    Yuhang District

    İlçe.

    Üst düğüm: Address

    Language

    String

    zh-Hans

    Dil. Format BCP 47 şeklindedir.

    Üst düğüm: Address

    Province

    String

    Zhejiang

    Eyalet.

    Üst düğüm: Address

    Township

    String

    Wenyi West Road

    Cadde.

    Üst düğüm: Address

    OSSObjectType

    String

    Normal

    Nesne türü.

    Üst düğüm: File

    OSSStorageClass

    String

    Standard

    Nesnenin depolama sınıfı.

    Üst düğüm: File

    OSSTaggingCount

    Integer

    2

    Nesnenin etiket sayısı.

    Üst düğüm: File

    OSSTagging

    Container

    N/A

    Etiket bilgilerinin listesi.

    Alt düğüm: Tagging

    Üst düğüm: File

    Tagging

    Container

    N/A

    Tek bir etiket için kapsayıcı.

    Alt düğümler: Key ve Value

    Üst düğüm: OSSTagging

    Key

    String

    owner

    Etiket anahtarı.

    Üst düğüm: Tagging

    Value

    String

    John

    Etiket değeri.

    Üst düğüm: Tagging

    Key

    String

    owner

    Kullanıcı tanımlı meta verilerin anahtarı.

    Üst düğüm: Tagging

    Value

    String

    John

    Kullanıcı tanımlı meta verilerin değeri.

    Üst düğüm: Tagging

    Örnekler

    İstek örnekleri

    Skaler erişim

    POST /?metaQuery&comp=query&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken></NextToken>
  <MaxResults>5</MaxResults>
  <Query>{"Field": "Size","Value": "1048576","Operation": "gt"}</Query>
  <Sort>Size</Sort>
  <Order>asc</Order>
  <Aggregations>
    <Aggregation>
      <Field>Size</Field>
      <Operation>sum</Operation>
    </Aggregation>
    <Aggregation>
      <Field>Size</Field>
      <Operation>max</Operation>
    </Aggregation>
  </Aggregations>
</MetaQuery>

    Vektör erişimi

    POST /?metaQuery&comp=query&mode=semantic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 12 Sep 2024 13:08:38 GMT
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <MaxResults>99</MaxResults>
  <Query>An aerial view of a snow-covered forest</Query> // Required
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>
  // SimpleQuery is equivalent to the Query field in simple mode.
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

    Yanıt örnekleri

    Skaler erişim

    HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken>MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****</NextToken>
  <Files>
    <File>
      <Filename>exampleobject.txt</Filename>
      <Size>120</Size>
      <FileModifiedTime>2025-05-19T16:14:38+08:00</FileModifiedTime>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <ObjectACL>default</ObjectACL>
      <ETag>"fba9dede5f27731c9771645a3986****"</ETag>
      <OSSCRC64>4858A48BD1466884</OSSCRC64>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>owner</Key>
          <Value>John</Value>
        </Tagging>
        <Tagging>
          <Key>type</Key>
          <Value>document</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>

    Vektör erişimi

    Görüntü erişim isteği için yanıt örneği
    HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Thu, 12 Sep 2024 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<MetaQuery>
  <Files>
    <File>
      <URI>oss://examplebucket/test-object.jpg</URI>
      <Filename>sampleobject.jpg</Filename>
      <Size>1000</Size>
      <ObjectACL>default</ObjectACL>
      <FileModifiedTime>2025-05-19T16:14:38+08:00</FileModifiedTime>
      <ETag>\"1D9C280A7C4F67F7EF873E28449****\"</ETag>
      <OSSCRC64>559890638950338001</OSSCRC64>
      <ProduceTime>2021-06-29T14:50:15.011643661+08:00</ProduceTime>
      <ContentType>image/jpeg</ContentType>
      <MediaType>image</MediaType>
      <LatLong>30.134390,120.074997</LatLong>
      <Title>test</Title>
      <OSSExpiration>2024-12-01T12:00:00.000Z</OSSExpiration>
      <AccessControlAllowOrigin>https://aliyundoc.com</AccessControlAllowOrigin>
      <AccessControlRequestMethod>PUT</AccessControlRequestMethod>
      <CacheControl>no-cache</CacheControl>
      <ContentDisposition>attachment; filename =test.jpg</ContentDisposition>
      <ContentEncoding>UTF-8</ContentEncoding>
      <ContentLanguage>zh-CN</ContentLanguage>
      <ImageHeight>500</ImageHeight>
      <ImageWidth>270</ImageWidth>
      <Addresses>
        <Address>
          <AddressLine>No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
        <Address>
          <AddressLine>No. 970, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
      </Addresses>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>
    Ses veya video erişim isteği için yanıt örneği
    HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Thu, 12 Sep 2024 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<MetaQuery>
  <Files>
    <File>
      <URI>oss://examplebucket/test-object.jpg</URI>
      <Filename>sampleobject.jpg</Filename>
      <Size>1000</Size>
      <ObjectACL>default</ObjectACL>
      <FileModifiedTime>2021-06-29T14:50:14.011643661+08:00</FileModifiedTime>
      <ETag>\"1D9C280A7C4F67F7EF873E28449****\"</ETag>
      <OSSCRC64>559890638950338001</OSSCRC64>
      <ProduceTime>2021-06-29T14:50:15.011643661+08:00</ProduceTime>
      <ContentType>image/jpeg</ContentType>
      <MediaType>image</MediaType>
      <LatLong>30.134390,120.074997</LatLong>
      <Title>test</Title>
      <OSSExpiration>2024-12-01T12:00:00.000Z</OSSExpiration>
      <AccessControlAllowOrigin>https://aliyundoc.com</AccessControlAllowOrigin>
      <AccessControlRequestMethod>PUT</AccessControlRequestMethod>
      <CacheControl>no-cache</CacheControl>
      <ContentDisposition>attachment; filename =test.jpg</ContentDisposition>
      <ContentEncoding>UTF-8</ContentEncoding>
      <ContentLanguage>zh-CN</ContentLanguage>
      <VideoWidth>1080</VideoWidth>
      <VideoHeight>1920</VideoHeight>
      <VideoStreams>
        <VideoStream>
          <CodecName>h264</CodecName>
          <Language>en</Language>
          <Bitrate>5407765</Bitrate>
          <FrameRate>25/1</FrameRate>
          <StartTime>0</StartTime>
          <Duration>22.88</Duration>
          <FrameCount>572</FrameCount>
          <BitDepth>8</BitDepth>
          <PixelFormat>yuv420p</PixelFormat>
          <ColorSpace>bt709</ColorSpace>
          <Height>720</Height>
          <Width>1280</Width>
        </VideoStream>
        <VideoStream>
          <CodecName>h264</CodecName>
          <Language>en</Language>
          <Bitrate>5407765</Bitrate>
          <FrameRate>25/1</FrameRate>
          <StartTime>0</StartTime>
          <Duration>22.88</Duration>
          <FrameCount>572</FrameCount>
          <BitDepth>8</BitDepth>
          <PixelFormat>yuv420p</PixelFormat>
          <ColorSpace>bt709</ColorSpace>
          <Height>720</Height>
          <Width>1280</Width>
        </VideoStream>
      </VideoStreams>
      <AudioStreams>
        <AudioStream>
          <CodecName>aac</CodecName>
          <Bitrate>1048576</Bitrate>
          <SampleRate>48000</SampleRate>
          <StartTime>0.0235</StartTime>
          <Duration>3.690667</Duration>
          <Channels>2</Channels>
          <Language>en</Language>
        </AudioStream>
      </AudioStreams>
      <Subtitles>
        <Subtitle>
          <CodecName>mov_text</CodecName>
          <Language>en</Language>
          <StartTime>0</StartTime>
          <Duration>71.378</Duration>
        </Subtitle>
        <Subtitle>
          <CodecName>mov_text</CodecName>
          <Language>en</Language>
          <StartTime>72</StartTime>
          <Duration>71.378</Duration>
        </Subtitle>
      </Subtitles>
      <Bitrate>5407765</Bitrate>
      <Artist>Jane</Artist>
      <AlbumArtist>Jenny</AlbumArtist>
      <Composer>Jane</Composer>
      <Performer>Jane</Performer>
      <Album>FirstAlbum</Album>
      <Duration>71.378</Duration>
      <Addresses>
        <Address>
          <AddressLine>No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
        <Address>
          <AddressLine>No. 970, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
      </Addresses>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>

    Sorgu örnekleri

    Karmaşık sorgu koşulları oluşturmak ve ihtiyaç duyduğunuz içeriği kesin olarak erişmek için Query öğelerini iç içe yerleştirin.

    • Adı exampleobject.txt olan ve boyutu 1000 bayttan küçük bir nesneyi aramak için Query öğesini aşağıdaki gibi yapılandırın:

      
{
  "SubQueries":[
    {
      "Field":"Filename",
      "Value": "exampleobject.txt",
      "Operation":"eq"
    },         
    {
      "Field":"Size",
      "Value":"1000",
      "Operation":"lt"
    }
  ],
  "Operation":"and"
}

    • exampledir/ ön ekiyle başlayan, type=document veya owner=John etiketini içeren ve boyutu 10 MB'tan büyük nesneleri aramak için Query öğesini aşağıdaki gibi yapılandırın:

      
{
  "SubQueries": [
    {
      "Field": "Filename",
      "Value": "exampledir/",
      "Operation": "prefix"
    },
    {
      "Field": "Size",
      "Value": "1048576",
      "Operation": "gt"
    },
    {
      "SubQueries": [
        {
          "Field": "OSSTagging.type",
          "Value": "document",
          "Operation": "eq"
        },
        {
          "Field": "OSSTagging.owner",
          "Value": "John",
          "Operation": "eq"
        }
      ],
      "Operation": "or"
    }
  ],
  "Operation": "and"
}

    Arama koşullarının yanı sıra, eşleşen nesneler üzerinde toplam boyut, sayı, ortalama, maksimum veya minimum gibi istatistiksel analizler gerçekleştirmek veya eşleşen görüntülerin boyut dağılımını analiz etmek için toplama işlemlerini kullanabilirsiniz.

    SDK

    Bu işlem için kullanılabilen SDK'lar:

    ossutil komut satırı aracı

    DoMetaQuery işlemi, ossutil'deki do-meta-query komutuna karşılık gelir.