Azure Blob Depolama REST API

Azure Blob Depolama metin ve ikili verileri bulutta nesne olarak depolar. Blob Depolama şu kaynakları sunar: depolama hesabı, kapsayıcılar ve bloblar. Depolama hesabınızda kapsayıcılar blob kümelerini düzenlemek için bir yol sağlar.

Metin ve ikili verileri aşağıdaki blob türlerinden birinde depolayabilirsiniz:

  • Akış için iyileştirilmiş blok blobları.

  • Ekleme işlemleri için iyileştirilmiş ekleme blobları.

  • Rastgele okuma/yazma işlemleri için iyileştirilmiş olan ve blobdaki bir bayt aralığına yazma olanağı sağlayan sayfa blobları.

Daha fazla bilgi için bkz. Blok bloblarını, ekleme bloblarını ve sayfa bloblarını anlama.

Blob Depolama için REST API depolama hesabına, kapsayıcılara ve bloblara karşı HTTP işlemlerini tanımlar. API, aşağıdaki tabloda listelenen işlemleri içerir.

İşlem Kaynak türü Description
Kapsayıcıları Listele Hesap Bir depolama hesabındaki tüm kapsayıcıları Listeler.
Blob Depolama Özelliklerini Ayarlama Hesap Günlük ve ölçüm ayarları ve varsayılan hizmet sürümü dahil olmak üzere Blob Depolama'nın özelliklerini ayarlar.
Blob Depolama Özelliklerini Alma Hesap Günlük ve ölçüm ayarları ve varsayılan hizmet sürümü dahil olmak üzere Blob Depolama özelliklerini alır.
Denetim Öncesi Blob İsteği Hesap Gerçek isteği göndermeden önce Blob Depolama için Çıkış Noktaları Arası Kaynak Paylaşımı (CORS) kurallarını sorgular.
Blob Depolama İstatistiklerini Alma Hesap Blob Depolama için çoğaltmayla ilgili istatistikleri alır. Bu işlem yalnızca depolama hesabı için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde ikincil konum uç noktasında kullanılabilir.
Hesap Bilgilerini Al Hesap Belirtilen hesap için SKU adını ve hesap türünü döndürür.
Kullanıcı Temsilcisi Anahtarı Alma Hesap Kullanıcı temsilcisi paylaşılan erişim imzasını imzalamak için kullanılabilecek bir anahtar alır. Bu imza, Microsoft Entra kimlik bilgilerini kullanarak Blob Depolama'daki kaynaklara erişim verir.
Kapsayıcı Oluşturma Kapsayıcı Depolama hesabında yeni bir kapsayıcı oluşturur.
Kapsayıcı Özelliklerini Alma Kapsayıcı Bir kapsayıcının tüm kullanıcı tanımlı meta verilerini ve sistem özelliklerini döndürür.
Kapsayıcı Meta Verilerini Alma Kapsayıcı Kapsayıcının yalnızca kullanıcı tanımlı meta verilerini döndürür.
Kapsayıcı Meta Verilerini Ayarlama Kapsayıcı Kapsayıcının kullanıcı tanımlı meta verilerini ayarlar.
Kapsayıcı ACL'lerini alma Kapsayıcı Genel erişim ilkesini ve kapsayıcı için depolanan erişim ilkelerini alır.
Kapsayıcı ACL'lerini ayarlama Kapsayıcı Kapsayıcı için genel erişim ilkesini ve depolanmış erişim ilkelerini ayarlar.
Kira Kapsayıcısı Kapsayıcı Silme işlemleri için bir kapsayıcının kilidini oluşturur ve yönetir.
Kapsayıcıyı Silme Kapsayıcı Kapsayıcıyı ve içerdiği tüm blobları siler.
Blobları Listeleme Kapsayıcı Kapsayıcıdaki tüm blobları Listeler.
İkili Büyük Nesne Koyma Blok, ekleme ve sayfa blobları Yeni bir blob oluşturur veya kapsayıcı içindeki mevcut blobu değiştirir.
Blob Alma Blok, ekleme ve sayfa blobları Blob Depolama'dan kullanıcı tanımlı meta verileri ve sistem özellikleri dahil olmak üzere blobu okur veya indirir.
BLOB özelliklerini Al Blok, ekleme ve sayfa blobları Blob üzerindeki tüm sistem özelliklerini ve kullanıcı tanımlı meta verileri döndürür.
Blob Özelliklerini Ayarlama Blok, ekleme ve sayfa blobları Mevcut blob için tanımlanan sistem özelliklerini ayarlar.
Blob Süre Sonunu Ayarla Blok blobları Mevcut blob için süre sonu süresini ayarlar.
Blob Meta Verilerini Alma Blok, ekleme ve sayfa blobları Mevcut bir blobun veya anlık görüntünün kullanıcı tanımlı tüm meta verilerini alır.
Blob Meta Verilerini Ayarlama Blok, ekleme ve sayfa blobları Mevcut blobun kullanıcı tanımlı meta verilerini ayarlar.
Blob Etiketlerini Alma Blok, ekleme ve sayfa blobları Mevcut blobun kullanıcı tanımlı etiketlerini alır.
Blob Etiketlerini Ayarlama Blok, ekleme ve sayfa blobları İkincil dizin oluşturan mevcut blobun kullanıcı tanımlı etiketlerini ayarlar.
Etiketlere Göre Blob Bulma Blok, ekleme ve sayfa blobları Blobları kullanıcı tanımlı etiketleriyle Listeler.
İkili Büyük Nesneyi Silme Blok, ekleme ve sayfa blobları Bir blobu silinmek üzere işaretler.
Blobu Geri Alma Blok, ekleme ve sayfa blobları Geçici olarak silinen bir blobun veya tüm ilişkili geçici olarak silinen anlık görüntülerin içeriğini ve meta verilerini geri yükler.
Blob Kiralama Blok, ekleme ve sayfa blobları Yazma ve silme işlemlerinde kilit oluşturur ve yönetir. Kilitli bir blobu silmek veya bu bloba yazmak için istemcinin kira kimliğini sağlaması gerekir.
İkili Büyük Nesne Anlık Görüntüsünü Alma Blok, ekleme ve sayfa blobları Blobun salt okunur anlık görüntüsünü oluşturur.
İkili Büyük Nesneyi Kopyalama Blok, ekleme ve sayfa blobları Kaynak blobu bu depolama hesabındaki veya başka bir depolama hesabındaki hedef bloba kopyalar.
Blob Kopyalamayı Durdur Blok, ekleme ve sayfa blobları Bekleyen Copy Blob işlemi durdurur ve hedef blobu sıfır uzunlukta ve tam meta veriyle bırakır.
Blok Koy Yalnızca blok blobları Blok blobunun parçası olarak işlenecek yeni bir blok oluşturur.
URL'den Blok Koy Yalnızca blok blobları İçeriğin bir URL'den okunduğu blok blobunun parçası olarak işlenecek yeni bir blok oluşturur.
Put Block List Yalnızca blok blobları Blok blobunu oluşturan blok kimlikleri kümesini belirterek bir blob işler.
Blok Listesini Al Yalnızca blok blobları Blok blobunun parçası olarak karşıya yüklenen blokların listesini alır.
Blob İçeriklerini Sorgulama Yalnızca blok blobları Blobun içeriğine basit bir Yapılandırılmış Sorgu Dili (SQL) deyimi uygular ve verilerin yalnızca sorgulanan alt kümesini döndürür.
Blob Katmanını Ayarla Blok ve sayfa blobları Blobun katmanını ayarlar.
Sayfa Koy Yalnızca sayfa blobları Sayfa blobuna bir sayfa aralığı yazar.
Sayfa Aralıklarını Alma Yalnızca sayfa blobları Sayfa blobu için geçerli sayfa aralıklarının listesini veya sayfa blobunun anlık görüntüsünü döndürür.
Artımlı Kopyalama Blobu Yalnızca sayfa blobları Kaynak sayfa blobunun anlık görüntüsünü hedef sayfa blobuna kopyalar. Yalnızca değişiklik değişiklikleri aktarılır.
Ekleme Bloğu Yalnızca ekleme blobları Ekleme blobunun sonuna bir veri bloğu yazar.

Bu bölümde

Blob Depolama kavramları

Hesap üzerindeki işlemler (Blob Depolama)

Kapsayıcılardaki işlemler

Bloblardaki işlemler

Bloblardaki işlemler (hiyerarşik ad alanı özellikli hesaplar)

Ayrıca bkz.

Depolama hizmetleri REST