what is an object - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

Object Storage Service (OSS) içinde nesne, veri depolamanın temel birimidir ve dosyaya benzer. Belge, görüntü veya video gibi herhangi bir dosya, yönetim amacıyla bir paket içinde nesne olarak saklanır.

Bir nesnenin bileşenleri

Anahtar: Nesnenin adıdır. Nesneyi sorgulamak için kullanılır ve benzersiz olmalıdır.
Veri: Nesnenin gerçek verisidir. Bir bayt dizisinden oluşur.
Nesne Meta Verileri: Nesnenin meta verileridir. Meta veriler, son değiştirilme zamanı ve boyut gibi nesnenin özelliklerini açıklayan anahtar-değer çiftlerinden oluşan bir kümedir. Özel bilgileri saklamak için de meta verileri kullanabilirsiniz.
Sürüm Kimliği: sürüm oluşturma özelliğini etkinleştirirseniz bir nesnenin birden çok sürümünü kaydedebilirsiniz. Zaten var olan ada sahip bir nesneyi her yüklediğinizde OSS yeni bir sürüm oluşturur ve buna benzersiz bir sürüm kimliği atar. Bu kimlik, nesnenin belirli sürümlerine erişmek ve bunları yönetmek için kullanılır.

Nesne adlandırma (Anahtar)

Her nesnenin Anahtar olarak adlandırılan benzersiz bir adı vardır. Örneğin, "exampledir/example.jpg" anahtarı exampledir klasöründeki example.jpg dosyasını temsil eder.

SDK belgelerinde Anahtar, ObjectKey, ObjectName veya nesne adı olarak da anılır. Bu terimlerin anlamı aynıdır.

Adlandırma kuralları

UTF-8 kodlamasını kullanın.
Uzunluk 1 ile 1.023 bayt arasında olmalıdır.
Eğik çizgi (/) veya ters eğik çizgi (\) ile başlamayın.
Anahtarlar büyük/küçük harfe duyarlıdır.

Adlandırma önerileri

Anlamlı adlar kullanın. Dosya adları, tarihler veya kullanıcı kimlikleri gibi adlar kullanarak nesnelerin aranmasını ve anlaşılmasını kolaylaştırın.
Verileri düzenlemek için önekler kullanın. Tarihler, kullanıcı kimlikleri veya bölgeler gibi önekler kullanarak bir hiyerarşi oluşturabilirsiniz.
Ad benzersizliğini sağlayın. Çakışmaları önlemek için nesne adlarına rastgele sayılar veya UUID'ler ekleyebilirsiniz.

Adlandırma örnekleri

Paketteki nesne konumu	Anahtar temsili
examplebucket paketinin kök dizininde exampleobject.txt adlı bir nesne saklanır.	exampleobject.txt
examplebucket paketinin kök dizini içindeki destdir dizininde exampleobject.jpg adlı bir nesne saklanır.	destdir/exampleobject.jpg

OSS dizinlerinin görüntülenmesi

OSS'te dosyalar ve klasörler gibi geleneksel dosya sistemi kavramları bulunmaz. Kullanıcı deneyimini geliştirmek için nesne anahtarlarında exampledir/example.jpg gibi bir klasör yapısını taklit etmek amacıyla eğik çizgiler (/) kullanılır. Verilen örnek, exampledir içini bir klasör olarak ve example.jpg dosyasını bu klasörde simüle eder. Bu klasör benzeri yapı, OSS konsolunda ve ossbrowser gibi grafik araçlarda görünür. Ancak nesne anahtarı exampledir/example.jpg olarak kalır. Daha fazla bilgi için bkz. Dizinleri yönetme.

Nesne türleri

Nesneler, oluşturma yöntemlerine göre dört türe ayrılır. Aşağıdaki tabloda bu dört tür açıklanmaktadır.

Önemli

Nesneler bir türden diğerine dönüştürülemez. Örneğin, Normal bir nesne Çok Parçalı veya Eklenebilir bir nesneye dönüştürülemez.

Tür	Tanım	Açıklama
Normal	Bu türdeki nesneler basit yükleme kullanılarak oluşturulur.	Sürüm oluşturma devre dışı bırakılmış veya askıya alınmış bir pakete birden çok kullanıcı aynı ada sahip nesneler yüklediğinde en son yüklenen nesne öncekinin üzerine yazar. Yalnızca en son yüklenen nesne saklanır. Örneğin, Kullanıcı B'den sonra Kullanıcı A bir nesne yüklerse Kullanıcı A'nın nesnesi korunur ve Kullanıcı B'nin nesnesinin yerine geçer. Sürüm oluşturma etkinleştirilmiş bir pakete birden çok kullanıcı aynı ada sahip nesneler yüklediğinde OSS her yükleme işlemi için nesnenin yeni bir sürümünü oluşturur ve yeni sürüme benzersiz bir sürüm kimliği atar. OSS, nesnenin en son sürümünü yükleme başlangıç zamanına göre belirler. Örneğin, Kullanıcı A ve Kullanıcı B sürüm oluşturma etkinleştirilmiş bir pakete aynı ada sahip nesneler yükler ve Kullanıcı B yüklemeye Kullanıcı A'dan sonra başlarsa Kullanıcı B tarafından yüklenen nesne en son sürüm olarak atanır.
Çok Parçalı	Bu türdeki nesneler çok parçalı yükleme kullanılarak oluşturulur.	Yüklenen parçaları, sürüm oluşturma devre dışı bırakılmış veya askıya alınmış bir pakette mevcut olan nesneyle aynı ada sahip eksiksiz bir nesne olarak birleştirirseniz yeni nesne mevcut olanın yerine geçer. Yalnızca en son birleştirilen nesne korunur. Yüklenen parçaları, sürüm oluşturma etkinleştirilmiş bir pakette mevcut olan nesneyle aynı ada sahip eksiksiz bir nesne olarak birleştirirseniz OSS nesnenin yeni bir sürümünü oluşturur ve buna benzersiz bir sürüm kimliği atar. En son birleştirilen nesne en son sürüm olarak atanır.
Eklenebilir	Bu türdeki nesneler ekleme yükleme kullanılarak oluşturulur.	Eklenebilir bir nesneye veri eklendiğinde OSS sürüm oluşturma durumundan bağımsız olarak nesnenin yeni bir sürümünü oluşturmaz. Veriler doğrudan orijinal nesneye eklenir.
Sembolik Bağlantı	Bu türdeki nesneler PutSymlink işlemi çağrılarak oluşturulan sembolik bağlantılar kullanılarak oluşturulur.	Sık erişilen nesnelere erişmek için sembolik bağlantıları kullanabilirsiniz.

Silme işaretçileri

OSS, silme işaretçisi olarak adlandırılan özel bir nesne işaretçisi türü kullanır. Sürüm oluşturma etkinleştirilmiş veya askıya alınmış bir pakette bir nesneyi silmek için DeleteObject işlemini çağırdığınızda OSS nesne için bir silme işaretçisi oluşturur. Silme sırasında bir sürüm kimliği belirtilmezse OSS silme işaretçisini nesnenin en son sürümü olarak atar. Bu, nesnedeki verilerin korunmasını ve silmeden sonra bile geri yüklenmesini sağlar. Ancak bir sürüm kimliği belirtilirse OSS belirli sürümü siler ve silme işaretçisi oluşturmaz.

Özellikler

Nesneleri yükleme

Yordam	Açıklama
Basit yükleme	5 GB'tan küçük tek bir dosyayı yüklemek için PutObject API işlemini kullanın. Bu yöntem, tek bir HTTP isteğinde tamamlanabilen yüklemeler için uygundur.
Çok parçalı yükleme	Bir dosyayı birden çok parçaya bölün ve bunları ayrı ayrı yükleyin. Tüm parçalar yüklendikten sonra parçaları tek bir nesne olarak birleştirmek için CompleteMultipartUpload API işlemini çağırın.
Kaldığı yerden devam eden yükleme	Bir kontrol noktası dosyasında bir kontrol noktası belirtin. Bir ağ hatası veya program çökmesi nedeniyle yükleme başarısız olursa yükleme kalan parçaları aktarmak için kaydedilen kontrol noktasından devam eder.
Yükleme geri araması	OSS, bir dosya yüklemesi tamamlandıktan sonra bir uygulama sunucusuna geri arama gönderebilir. Geri aramayı uygulamak için OSS'e gönderilen istekte ilgili geri arama parametrelerini ekleyin.
Doğrudan istemci yüklemesi	Dosyaları doğrudan bir istemciden OSS'e yükleyin. Bu yöntem, dosyaların uygulama sunucunuz üzerinden yönlendirilmesini önler; bu da yükleme hızını artırır ve sunucu kaynaklarını korur.
Form yükleme	Bir HTML formundan bir dosya yüklemek için PostObject API işlemini kullanın. Yüklenen dosya 5 GB'ı aşamaz.
Ekleme yükleme	İçeriği doğrudan mevcut bir Eklenebilir nesnenin sonuna ekleyin.
RTMP tabanlı akış alma	H.264 ile kodlanmış video akışlarını ve AAC ile kodlanmış ses akışlarını OSS'e almak için Real-Time Messaging Protocol (RTMP) kullanabilirsiniz. Yüklenen ses ve video verileri isteğe bağlı oynatılabilir veya gecikmenin kritik olmadığı senaryolarda canlı yayın için kullanılabilir.

Nesneleri indirme

Yordam	Açıklama
Basit indirme	Yüklenen bir dosyayı indirmek için GetObject API işlemini kullanın. Bu yöntem, tek bir HTTP isteğinde tamamlanabilen indirmeler için uygundur.
Kaldığı yerden devam eden indirme	Belirtilen bir konumdan başlayarak bir dosya indirin. Büyük dosyaları indirirken bunları birden çok parça halinde indirebilirsiniz. İndirme kesintiye uğrarsa kaldığı yerden devam edebilirsiniz.
Nesneyi indirmek için imzalı URL kullanma	Bir dosya bir pakete yüklendikten sonra önizleme veya indirme amacıyla URL'sini üçüncü taraflarla paylaşabilirsiniz.
Koşullu indirme	Nesneler yalnızca içerikleri değiştiğinde, son değiştirilme zamanı veya ETag ile belirlenen şekilde indirilir. Bu özellik, gereksiz tekrarlanan indirmelerden kaçınarak indirmelerin yalnızca güncellemeler gerçekleştiğinde tetiklenmesini sağlar.

Nesneleri yönetme

Yordam	Açıklama
Nesneleri listeleme	Bir paketteki nesneler varsayılan olarak alfabetik sırayla listelenir. İhtiyaca göre mevcut paketteki tüm nesneleri, belirli bir öneke sahip nesneleri veya belirli sayıda nesneyi listeleyebilirsiniz.
Dosyaları kopyalama	Dosya içeriğini değiştirmeden bir dosyayı aynı bölgedeki kaynak paketten hedef pakete kopyalayın.
Nesneleri yeniden adlandırma	Bir paketteki bir nesneyi yeniden adlandırabilirsiniz.
Dosya arama	Bir paket çok sayıda nesne içerdiğinde OSS, bir dosya adı öneki belirterek hedef dosyayı hızlıca aramayı ve bulmayı destekler.
Dosyaları geri yükleme	Cold Archive veya Deep Cold Archive içindeki bir nesneye erişmeden önce nesne için bir geri yükleme işlemi başlatmanız gerekir.
Nesneleri silme	Artık bir pakette tutmanız gerekmeyen nesneleri çeşitli yöntemler kullanarak silin.
Nesneleri etiketleme	OSS, bir paketteki nesneleri sınıflandırmak için etiketleri kullanmayı destekler. Aynı etikete sahip nesneler için yaşam döngüsü kuralları ve erişim izinleri ayarlayabilirsiniz.
Sembolik bağlantı oluşturma	Sembolik bağlantı özelliği, bir pakette sık kullanılan nesnelere hızlı erişim için kullanılır. Sembolik bağlantıyı ayarladıktan sonra nesneyi sembolik bağlantı dosyasını kullanarak hızlıca açabilirsiniz.
Nesne meta verilerini yönetme	Nesne meta verileri bir dosyanın özelliklerini açıklar. Standart HTTP üstbilgilerini ve kullanıcı tanımlı meta verileri (User Meta) içerir. Önbellek ilkeleri ve zorunlu indirme ilkeleri gibi HTTP istek ilkelerini özelleştirmek için dosya HTTP üstbilgilerini ayarlayabilirsiniz. Ayrıca bir nesnenin amacını veya özelliklerini tanımlamak için kullanıcı tanımlı meta verileri ayarlayabilirsiniz.
Tek bağlantı bant genişliği kısıtlaması	Bir istemci OSS'teki dosyalara eriştiğinde büyük miktarda bant genişliği tüketebilir; bu da diğer uygulamaları etkileyebilir. Dosya yükleme ve indirme gibi işlemler sırasında trafiği kontrol etmek için OSS tarafından sağlanan tek bağlantı bant genişliği kısıtlama özelliğini kullanabilirsiniz. Bu, diğer uygulamalar için yeterli ağ bant genişliği sağlar.
Dosyaları sorgulama	Hedef dosyada bir SQL deyimi yürütmek ve yürütme sonucunu döndürmek için SelectObject kullanın.
Parçaları silme	Çok parçalı yükleme sırasında bazı parçalara artık ihtiyaç duyulmuyorsa bu tamamlanmamış parçaları silmek için AbortMultipartUpload API işlemini çağırabilirsiniz.
Cloud Storage Gateway ile OSS paketini bağlama	Farklı konumlardan ve cihazlardan birden çok kullanıcının bir OSS paketindeki kaynaklara erişmesini sağlamak için OSS paketini paylaşılan bir dosya depolama sistemine eşlemek üzere Cloud Storage Gateway (CSG) kullanabilirsiniz. Bu, kullanıcıların OSS kaynaklarında yerel dosyalar ve disklerle yaptıkları gibi işlemler gerçekleştirmesine olanak tanır.

Object Storage Service:Overview