Tüm Ürünler
Search

Bu Ürün

    Object Storage Service:head-object

    Belge Merkezi

    Object Storage Service:head-object

    Son Güncelleme:Oct 01, 2026

    head-object komutu, bir nesnenin meta verilerini sorgular.

    Not

    • Bu komutu çalıştırdığınızda yanıtta nesnenin içeriği yer almaz.

    İzinler

    Varsayılan olarak Alibaba Cloud hesabı tam yetkilere sahiptir. Bir Alibaba Cloud hesabına ait RAM kullanıcıları veya RAM rolleri varsayılan olarak herhangi bir izne sahip değildir. Alibaba Cloud hesabı veya hesap yöneticisi, işlem izinlerini RAM ilkeleri veya Bucket Policy aracılığıyla vermelidir.


    API


    Eylem


    Açıklama


    HeadObject


    oss:GetObject


    Bir nesnenin meta verilerini sorgular.

    Komut sözdizimi

    ossutil api head-object --bucket value --key value [flags]


    Parametre


    Tür


    Açıklama


    --bucket


    dize


    Paket adı.


    --key


    dize


    Nesnenin tam yolu.


    --if-match


    dize


    İstekte belirtilen ETag değeri nesnenin ETag değeriyle eşleşirse 200 OK ve nesnenin meta verileri döndürülür. Aksi takdirde 412 precondition failed döndürülür.


    --if-modified-since


    dize


    Belirtilen zaman nesnenin son değiştirilme zamanından önceyse nesnenin meta verileri ve 200 OK döndürülür. Aksi takdirde 304 Not Modified döndürülür.


    --if-none-match


    dize


    Girilen ETag nesnenin ETag'i ile eşleşmiyorsa nesnenin meta verileri ve 200 OK döndürülür. Aksi takdirde 304 Not Modified döndürülür.


    --if-unmodified-since


    dize


    Belirtilen zaman nesnenin son değiştirilme zamanına eşitse veya daha geçse nesnenin meta verileri ve 200 OK döndürülür. Aksi takdirde 412 Precondition Failed döndürülür.


    --version-id


    dize


    Nesnenin sürüm kimliği.
    Not

    • head-object komutu HeadObject işlemine karşılık gelir. HeadObject işlemindeki parametreler hakkında daha fazla bilgi için bkz. HeadObject.

    • Desteklenen genel komut satırı seçenekleri hakkında daha fazla bilgi için bkz. Komut satırı seçenekleri.

    Örnekler

    • exampleobject nesnesinin meta verilerini sorgulayın.

      ossutil api head-object --bucket examplebucket --key exampleobject

    • exampleobject nesnesinin meta verilerini sorgulayın ve çıktıyı JSON biçiminde görüntüleyin.

      ossutil api head-object --bucket examplebucket --key exampleobject --output-format json

    • Sürüm kimliği 123 olan exampleobject nesnesinin meta verilerini sorgulayın.

      ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123

    • ETag değeri 123 olan exampleobject nesnesinin meta verilerini sorgulayın.

      ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123

    • Gerçek değiştirilme zamanı 'Thu, 11 Jul 2024 06:36:31 GMT' tarihinden önce olan exampleobject nesnesinin meta verilerini sorgulayın.

      ossutil api head-object --bucket examplebucket --key exampleobject --if-modified-since "Thu, 11 Jul 2024 06:36:31 GMT"