Hızlı Başlangıç: Azure CLI ile blobları oluşturma, indirme ve listeleme
Azure CLI, Azure kaynaklarını yönetmek için Azure tarafından sunulan komut satırı deneyimidir. Azure Cloud Shell ile kendi tarayıcınızda da kullanabilirsiniz. Dilerseniz macOS, Linux veya Windows’a yükleyebilir ve komut satırından çalıştırabilirsiniz. Bu hızlı başlangıçta Azure Blob depolamaya veri yüklemek ve verileri indirmek için Azure CLI kullanma hakkında ayrıntılı bilgiler öğrenirsiniz.
Önkoşullar
Azure Depolama erişmek için bir Azure aboneliğiniz olmalıdır. Henüz aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Azure Depolama erişimi bir depolama hesabı üzerinden gerçekleştirilir. Bu hızlı başlangıç için Azure portalını, Azure PowerShell'i veya Azure CLI'yı kullanarak bir depolama hesabı oluşturun. Depolama hesabı oluşturma konusunda yardım için bkz . Depolama hesabı oluşturma.
Ortamınızı Azure CLI’ye hazırlama
Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.
CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.
Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.
İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.
Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.
- Bu makale, Azure CLI'nın 2.0.46 veya sonraki bir sürümünü gerektirir. Azure Cloud Shell kullanılıyorsa en son sürüm zaten yüklüdür.
Blob depolamaya erişimi yetkilendirme
Azure CLI'dan Blob depolamaya erişimi Microsoft Entra kimlik bilgileriyle veya depolama hesabı erişim anahtarını kullanarak yetkileyebilirsiniz. Microsoft Entra kimlik bilgilerinin kullanılması önerilir. Bu makalede, Microsoft Entra Id kullanarak Blob depolama işlemlerini yetkilendirme işlemi gösterilmektedir.
Blob depolamaya karşı veri işlemleri için Azure CLI komutları, belirli bir işlemin nasıl yetkilendirileceğini belirtmenize olanak tanıyan parametresini destekler --auth-mode . Parametresini --auth-mode Microsoft Entra kimlik bilgileriyle yetkilendirmek için login olarak ayarlayın. Daha fazla bilgi için bkz . Azure CLI ile blob veya kuyruk verilerine erişimi yetkilendirme.
Yalnızca Blob depolama veri işlemleri parametresini --auth-mode destekler. Kaynak grubu veya depolama hesabı oluşturma gibi yönetim işlemleri, yetkilendirme için otomatik olarak Microsoft Entra kimlik bilgilerini kullanır.
Başlamak için az login ile Azure hesabınızda oturum açın.
az login
Kaynak grubu oluşturma
az group create komutuyla bir Azure kaynak grubu oluşturun. Kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır.
Köşeli ayraçlardaki yer tutucu değerleri kendi değerlerinizle değiştirmeyi unutmayın:
az group create \
--name <resource-group> \
--location <location>
Depolama hesabı oluşturma
az storage account create komutuyla bir genel amaçlı depolama hesabı oluşturun. Genel amaçlı depolama hesabı; bloblar, dosyalar, tablolar ve kuyruklar olmak üzere dört hizmet için de kullanılabilir.
Köşeli ayraçlardaki yer tutucu değerleri kendi değerlerinizle değiştirmeyi unutmayın:
az storage account create \
--name <storage-account> \
--resource-group <resource-group> \
--location <location> \
--sku Standard_ZRS \
--encryption-services blob
Kapsayıcı oluşturma
Bloblar her zaman bir kapsayıcıya yüklenir. Kapsayıcılardaki blob gruplarını, bilgisayarınızdaki dosyalarınızı klasörler halinde düzenleme yönteminize benzer şekilde düzenleyebilirsiniz. az storage container create komutunu kullanarak blobları depolamak için bir kapsayıcı oluşturun.
Aşağıdaki örnek, kapsayıcıyı oluşturma işlemini yetkilendirmek için Microsoft Entra hesabınızı kullanır. Kapsayıcıyı oluşturmadan önce Depolama Blob Veri Katkıda Bulunanı rolünü kendinize atayın. Hesap sahibi olsanız bile, depolama hesabında veri işlemleri gerçekleştirmek için açık izinlere ihtiyacınız vardır. Azure rolleri atama hakkında daha fazla bilgi için bkz . Blob verilerine erişim için Azure rolü atama.
Köşeli ayraçlardaki yer tutucu değerleri kendi değerlerinizle değiştirmeyi unutmayın:
az ad signed-in-user show --query id -o tsv | az role assignment create \
--role "Storage Blob Data Contributor" \
--assignee @- \
--scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>"
az storage container create \
--account-name <storage-account> \
--name <container> \
--auth-mode login
Önemli
Azure rol atamalarının yayılması birkaç dakika sürebilir.
Kapsayıcıyı oluşturma işlemini yetkilendirmek için depolama hesabı anahtarını da kullanabilirsiniz. Azure CLI ile veri işlemlerini yetkilendirme hakkında daha fazla bilgi için bkz . Azure CLI ile blob veya kuyruk verilerine erişimi yetkilendirme.
Blobu karşıya yükleme
Blob depolama blok blobları, ekleme bloblarını ve sayfa bloblarını destekler. Bu hızlı başlangıçtaki örneklerde blok bloblarıyla çalışma gösterilmektedir.
İlk olarak, blok bloba yüklenecek bir dosya oluşturun. Azure Cloud Shell kullanıyorsanız, aşağıdaki komutu kullanarak bir dosya oluşturun:
vi helloworld
Dosya açıldığında insert tuşuna basın. Merhaba dünya yazın ve Esc tuşuna basın. Ardından, :x yazın ve Enter tuşuna basın.
Bu örnekte, son adımda az storage blob upload komutuyla oluşturduğunuz kapsayıcıya bir blob yükleyeceksiniz. Dosya kök dizinde oluşturulduğundan bir dosya yolu belirtmek gerekmez. Köşeli ayraçlardaki yer tutucu değerleri kendi değerlerinizle değiştirmeyi unutmayın:
az storage blob upload \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file myFile.txt \
--auth-mode login
Bu işlemle, daha önce oluşturulmadıysa bir blob oluşturulur, aksi takdirde üzerine yazılacaktır. Devam etmeden önce istediğiniz sayıda dosyayı karşıya yükleyin.
Azure CLI kullanarak bir blob yüklediğinizde, http ve https protokolleri aracılığıyla ilgili REST API çağrılarını oluşturur.
Aynı anda birden fazla dosya yüklemek için az storage blob upload-batch komutunu kullanabilirsiniz.
Kapsayıcıdaki blobları listeleme
az storage blob list komutuyla kapsayıcıdaki blobları listeleyin. Köşeli ayraçlardaki yer tutucu değerleri kendi değerlerinizle değiştirmeyi unutmayın:
az storage blob list \
--account-name <storage-account> \
--container-name <container> \
--output table \
--auth-mode login
Blobu indirme
Önceden karşıya yüklediğiniz bir blobu indirmek için az storage blob download komutunu kullanın. Köşeli ayraçlardaki yer tutucu değerleri kendi değerlerinizle değiştirmeyi unutmayın:
az storage blob download \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file <~/destination/path/for/file> \
--auth-mode login
AzCopy ile veri aktarımı
AzCopy komut satırı yardımcı programı, Azure Depolama için yüksek performanslı, betiklenebilir veri aktarımı sunar. Blob depolama ve Azure Dosyalar veri aktarmak için AzCopy'yi kullanabilirsiniz. AzCopy'nin en son sürümü olan AzCopy v10 hakkında daha fazla bilgi için bkz . AzCopy'yi kullanmaya başlama. Blob depolama ile AzCopy v10 kullanma hakkında bilgi edinmek için bkz . AzCopy ve Blob depolama ile veri aktarma.
Aşağıdaki örnek, yerel bir dosyayı bloba yüklemek için AzCopy'yi kullanır. Örnek değerleri kendi değerlerinizle değiştirmeyi unutmayın:
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Kaynakları temizleme
Depolama hesabı da dahil olmak üzere bu hızlı başlangıcın bir parçası olarak oluşturduğunuz kaynakları silmek istiyorsanız az group delete komutunu kullanarak kaynak grubunu silin . Köşeli ayraçlardaki yer tutucu değerleri kendi değerlerinizle değiştirmeyi unutmayın:
az group delete \
--name <resource-group> \
--no-wait
Sonraki adımlar
Bu hızlı başlangıçta, dosyaları yerel bir dosya sistemi ile Azure Blob depolamadaki bir kapsayıcı arasında aktarmayı öğrendiniz. Azure CLI kullanarak Blob depolama ile çalışma hakkında daha fazla bilgi edinmek için aşağıdaki bir seçeneği belirleyin.