Hızlı başlangıç: Azure CLı 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.

Not

Bu makalede açıklanan özellikler, hiyerarşik bir ad alanı olan hesaplar için de kullanılabilir. Sınırlamaları gözden geçirmek için Azure Data Lake Storage 2. makalesinde bulunan BLOB Storage özellikleri bölümüne bakın.

Önkoşullar

Azure depolama 'ya erişmek için bir Azure aboneliğine sahip olmanız gerekir. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Tüm Azure depolama erişimi bir depolama hesabı üzerinden gerçekleşir. Bu hızlı başlangıçta Azure Portal, Azure PowerShell veya Azure CLI 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'Da Bash ortamını kullanın.

    Cloud Shell’i yeni bir pencerede başlatma

  • Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.

    • 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. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantıları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 CLı 'nin sürüm 2.0.46 veya üstünü gerektirir. Azure Cloud Shell kullanılıyorsa, en son sürüm zaten yüklüdür.

Blob depolamaya erişim yetkisi verme

Azure CLı 'dan Azure AD kimlik bilgileriyle veya depolama hesabı erişim anahtarını kullanarak blob depolamaya erişim yetkisi verebilirsiniz. Azure AD kimlik bilgilerinin kullanılması önerilir. Bu makalede, Azure AD kullanarak BLOB depolama işlemlerini yetkilendirme işlemi gösterilmektedir.

Blob depolamaya yönelik veri işlemlerine yönelik Azure CLı komutları --auth-mode , belirli bir işlemin yetkilendirmesini belirtmenize olanak sağlayan parametresini destekler. --auth-modeParametresini login Azure AD kimlik bilgileriyle yetkilendirmek için olarak ayarlayın. Daha fazla bilgi için bkz. Azure CLI ile blob veya kuyruk verilerine erişim yetkisi verme.

Yalnızca BLOB depolama veri işlemleri parametreyi destekler --auth-mode . Kaynak grubu veya depolama hesabı oluşturma gibi yönetim işlemleri, yetkilendirme için otomatik olarak Azure AD kimlik bilgilerini kullanır.

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.

Açılı ayraçlar içindeki yer tutucu değerlerini 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.

Açılı ayraçlar içindeki yer tutucu değerlerini 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ı, dosyalarınızı bilgisayarınızdaki dosyalarınıza düzenlemenize 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 Azure AD hesabınızı kullanır. Kapsayıcıyı oluşturmadan önce, Depolama Blobu veri katılımcısı rolünü kendinize atayın. Hesap sahibi olsanız bile, depolama hesabında veri işlemleri gerçekleştirmek için açık izinlere sahip olmanız gerekir. Azure rolleri atama hakkında daha fazla bilgi için bkz. BLOB verilerine erişim Için Azure rolü atama.

Açılı ayraçlar içindeki yer tutucu değerlerini kendi değerlerinizle değiştirmeyi unutmayın:

az ad signed-in-user show --query objectId -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.

Ayrıca, kapsayıcıyı oluşturmak için işlemi yetkilendirmek üzere depolama hesabı anahtarını da kullanabilirsiniz. Veri işlemlerini Azure CLı ile yetkilendirme hakkında daha fazla bilgi için bkz. Azure CLI ile blob veya kuyruk verilerine erişim yetkisi verme.

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 bloblarla nasıl çalışılacağı gösterilmektedir.

İlk olarak, bir blok blobuna yüklemek için bir dosya oluşturun. Azure Cloud Shell kullanıyorsanız, bir dosya oluşturmak için aşağıdaki komutu kullanın:

vi helloworld

Dosya açıldığında, Ekle' ye basın. Merhaba Dünya yazın ve ardından ESC tuşuna basın. Sonra, şunu yazın : 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 dizininde oluşturulduğundan bu yana bir dosya yolu belirtmeniz gerekmez. Açılı ayraçlar içindeki yer tutucu değerlerini kendi değerlerinizle değiştirmeyi unutmayın:

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --name helloworld \
    --file helloworld \
    --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.

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. Açılı ayraçlar içindeki yer tutucu değerlerini 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. Açılı ayraçlar içindeki yer tutucu değerlerini kendi değerlerinizle değiştirmeyi unutmayın:

az storage blob download \
    --account-name <storage-account> \
    --container-name <container> \
    --name helloworld \
    --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ı ve komut dosyalı veri aktarımı sağlar. BLOB depolama ve Azure dosyalarına veri aktarmak için AzCopy kullanabilirsiniz. AzCopy 'in en son sürümü olan AzCopy ile v10 arasındaki hakkında daha fazla bilgi için bkz. AzCopy ile çalışmaya başlama. AzCopy ile v10 arasındaki 'i blob Storage ile kullanma hakkında bilgi edinmek için bkz. AzCopy ve BLOB Storage ile veri aktarma.

Aşağıdaki örnek, bir Blobun yerel bir dosyayı karşıya yüklemek için AzCopy kullanır. Örnek değerleri kendi değerlerinizle değiştirmeyi unutmayın:

azcopy login
azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt'

Kaynakları temizleme

Depolama hesabı da dahil olmak üzere bu hızlı başlangıç kapsamında oluşturduğunuz kaynakları silmek istiyorsanız, az Group Delete komutunu kullanarak kaynak grubunu silin. Açılı ayraçlar içindeki yer tutucu değerlerini 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 depolama alanındaki bir kapsayıcı arasında aktarmayı öğrendiniz. Azure CLı kullanarak blob depolamayla çalışma hakkında daha fazla bilgi edinmek için, BLOB depolama için Azure CLı örnekleri ' ni gezin.