JavaScript veya TypeScript ile blob kapsayıcılarını listeleme
Bir Azure Depolama hesabındaki kapsayıcıları kodunuzdan listelediğinizde, sonuçların Azure Depolama'dan nasıl döndürüleceğini yönetmek için çeşitli seçenekler belirtebilirsiniz. Bu makalede JavaScript için Azure Depolama istemci kitaplığını kullanarak kapsayıcıları listeleme adımları gösterilmektedir.
Önkoşullar
- Bu makaledeki örneklerde JavaScript için Azure Blob Depolama istemci kitaplığıyla çalışmak üzere ayarlanmış bir projeniz olduğu varsayılır. Paket yükleme, modülleri içeri aktarma ve veri kaynaklarıyla çalışmak üzere yetkili bir istemci nesnesi oluşturma gibi projenizi ayarlama hakkında bilgi edinmek için bkz. Azure Blob Depolama ve JavaScript'i kullanmaya başlama.
- Yetkilendirme mekanizmasının blob kapsayıcılarını listeleme izinleri olmalıdır. Daha fazla bilgi edinmek için aşağıdaki REST API işlemi için yetkilendirme kılavuzuna bakın:
Kapsayıcı listeleme seçenekleri hakkında
Kodunuzdaki kapsayıcıları listelerken, sonuçların Azure Depolama'dan nasıl döndürüleceğini yönetmek için seçenekler belirtebilirsiniz. Her sonuç kümesinde döndürülecek sonuç sayısını belirtebilir ve ardından sonraki kümeleri alabilirsiniz. Ayrıca sonuçları bir ön eke göre filtreleyebilir ve sonuçları içeren kapsayıcı meta verilerini döndürebilirsiniz. Bu seçenekler aşağıdaki bölümlerde açıklanmıştır.
Depolama hesabınızdaki kapsayıcıları listelemek için aşağıdaki yöntemi çağırın:
Bu yöntem ContainerItem nesnelerinin listesini döndürür. Kapsayıcılar ada göre sözcük temelli olarak sıralanır.
Kaç sonuç döndürülür yönetme
Varsayılan olarak, bir listeleme işlemi bir kerede en çok 5000 sonuç döndürür, ancak her listeleme işleminin döndürmesini istediğiniz sonuç sayısını belirtebilirsiniz. Bu makalede sunulan örnekler, sonuçları sayfalarda nasıl döndürebileceğinizi gösterir.
Sonuçları ön ek ile filtreleme
Kapsayıcı listesini filtrelemek için ServiceListContainersOptions içinde parametresi için prefix bir dize belirtin. Ön ek dizesi bir veya daha fazla karakter içerebilir. Azure Depolama daha sonra yalnızca adları bu ön ek ile başlayan kapsayıcıları döndürür.
Kapsayıcı meta verilerini dahil et
Sonuçlara kapsayıcı meta verilerini eklemek için parametresini includeMetadata true ServiceListContainersOptions içinde olarak ayarlayın. Azure Depolama, döndürülen her kapsayıcıyla meta veriler içerdiğinden kapsayıcı meta verilerini ayrı olarak getirmeniz gerekmez.
Silinen kapsayıcıları dahil et
Geçici olarak silinen kapsayıcıları sonuçlara eklemek için ServiceListContainersOptions içinde parametresini ayarlayınincludeDeleted.
Kod örneği: Kapsayıcıları listeleme
Aşağıdaki örnek, belirtilen ön ek ile başlayan bir depolama hesabındaki kapsayıcıları zaman uyumsuz olarak listeler. Örnek, belirtilen ön ek ile başlayan kapsayıcıları listeler ve listeleme işlemine yapılan çağrı başına belirtilen sayıda sonuç döndürür. Daha sonra bir sonraki sonuç kesimini almak için devamlılık belirtecini kullanır. Örnek ayrıca sonuçları içeren kapsayıcı meta verilerini döndürür.
async function listContainers(blobServiceClient, containerNamePrefix) {
const options = {
includeDeleted: false,
includeMetadata: true,
includeSystem: true,
prefix: containerNamePrefix
}
console.log("Containers (by page):");
for await (const response of blobServiceClient.listContainers(options).byPage({
maxPageSize: 20,
})) {
console.log("- Page:");
if (response.containerItems) {
for (const container of response.containerItems) {
console.log(` - ${container.name}`);
}
}
}
}
Kaynaklar
JavaScript için Azure Blob Depolama istemci kitaplığını kullanarak kapsayıcıları listeleme hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın.
REST API işlemleri
JavaScript için Azure SDK, Azure REST API'sinin üzerinde derlenmiş kitaplıklar içerir ve tanıdık JavaScript paradigmalarıyla REST API işlemleriyle etkileşim kurmanızı sağlar. Kapsayıcıları listelemek için istemci kitaplığı yöntemleri aşağıdaki REST API işlemini kullanır:
- Liste Kapsayıcıları (REST API)
Kod örnekleri
- Bu makaledeki JavaScript ve TypeScript kod örneklerini görüntüleyin (GitHub)