Hızlı Başlangıç: Azure CLı kullanarak Blobları karşıya yükleme, indirme ve listelemeQuickstart: Upload, download, and list blobs using the Azure CLI

Azure CLI, Azure kaynaklarını yönetmek için Azure tarafından sunulan komut satırı deneyimidir.The Azure CLI is Azure's command-line experience for managing Azure resources. Azure Cloud Shell ile kendi tarayıcınızda da kullanabilirsiniz.You can use it in your browser with Azure Cloud Shell. Dilerseniz macOS, Linux veya Windows’a yükleyebilir ve komut satırından çalıştırabilirsiniz.You can also install it on macOS, Linux, or Windows and run it from the command line. 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.In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Not

Bu makalede açıklanan özellikler yalnızca Data Lake Storage üzerindeki çoklu protokol erişiminingenel önizlemesine kaydoldıysanız hiyerarşik bir ad alanına sahip hesaplar için kullanılabilir.The features described in this article are available to accounts that have a hierarchical namespace only if you enroll in the public preview of multi-protocol access on Data Lake Storage. Sınırlamaları gözden geçirmek için, bilinen sorunlar makalesine bakın.To review limitations, see the known issues article.

ÖnkoşullarPrerequisites

Azure depolamaya erişmek için bir Azure aboneliği gerekir.To access Azure Storage, you'll need an Azure subscription. Bir aboneliğiniz zaten yoksa, oluşturup bir ücretsiz bir hesap başlamadan önce.If you don't already have a subscription, then create a free account before you begin.

Tüm Azure depolama erişimi bir depolama hesabı üzerinden gerçekleşir.All access to Azure Storage takes place through a storage account. Bu hızlı başlangıçta kullanarak bir depolama hesabı oluşturma Azure portalında, Azure PowerShell veya Azure CLI.For this quickstart, create a storage account using the Azure portal, Azure PowerShell, or Azure CLI. Hesap oluşturmayla ilgili yardım için bkz. Depolama hesabı oluşturma.For help creating the account, see Create a storage account.

Azure Cloud Shell kullanmaUse Azure Cloud Shell

Azure, tarayıcınız aracılığıyla kullanabileceğiniz etkileşimli bir kabuk ortamı Azure Cloud Shell.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Cloud Shell, ya da bash PowerShell Azure hizmetleriyle çalışmak için kullanmanıza olanak sağlar.Cloud Shell lets you use either bash or PowerShell to work with Azure services. Bu makaledeki kodu, yerel ortamınıza herhangi bir şey yüklemeye gerek kalmadan çalıştırmak için Cloud Shell önceden yüklenmiş komutları kullanabilirsiniz.You can use the Cloud Shell pre-installed commands to run the code in this article without having to install anything on your local environment.

Azure Cloud Shell başlatmak için:To launch Azure Cloud Shell:

SeçenekOption Örnek/bağlantıExample/Link
Kod bloğunun sağ üst köşesindeki Deneyin’i seçin.Select Try It in the upper-right corner of a code block. Dene ' nin seçilmesi, kodu Cloud Shell otomatik olarak kopyalamaz.Selecting Try It doesn't automatically copy the code to Cloud Shell. Azure Cloud Shell için deneme örneği
Tarayıcınızda Cloud Shell açmak için Başlat Cloud Shell düğmesine gidin veyaseçin. https://shell.azure.comGo to https://shell.azure.com or select the Launch Cloud Shell button to open Cloud Shell in your browser. Cloud Shell yeni bir pencerede BaşlatLaunch Cloud Shell in a new window
Azure Portalsağ üstteki menü çubuğunda Cloud Shell düğmesini seçin.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Azure portaldaki Cloud Shell düğmesi

Bu makaledeki kodu Azure Cloud Shell çalıştırmak için:To run the code in this article in Azure Cloud Shell:

  1. Cloud Shell başlatın.Launch Cloud Shell.

  2. Kodu kopyalamak için bir kod bloğunda Kopyala düğmesini seçin.Select the Copy button on a code block to copy the code.

  3. Kodu Windows ve Linux 'ta CTRL+SHIFT+v veya MacOS 'ta cmd+Shift+v ile Cloud Shell oturumuna yapıştırın.Paste the code into the Cloud Shell session with Ctrl+Shift+V on Windows and Linux, or Cmd+Shift+V on macOS.

  4. Kodu çalıştırmak için ENTER tuşuna basın.Press Enter to run the code.

CLI'yi yerel olarak yükleyip kullanmayı seçerseniz bu hızlı başlangıç için Azure CLI 2.0.4 veya sonraki bir sürümünü kullanmanız gerekir.If you choose to install and use the CLI locally, this quickstart requires that you are running the Azure CLI version 2.0.4 or later. Sürümünüzü belirlemek için az --version çalıştırın.Run az --version to determine your version. Yükleme veya yükseltme yapmanız gerekirse bkz. Azure CLI’yı yükleme.If you need to install or upgrade, see Install the Azure CLI.

Kaynak grubu oluşturmaCreate a resource group

az group create komutuyla bir Azure kaynak grubu oluşturun.Create an Azure resource group with the az group create command. Kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır.A resource group is a logical container into which Azure resources are deployed and managed.

az group create \
    --name myResourceGroup \
    --location eastus

Depolama hesabı oluşturmaCreate a storage account

az storage account create komutuyla bir genel amaçlı depolama hesabı oluşturun.Create a general-purpose storage account with the az storage account create command. Genel amaçlı depolama hesabı; bloblar, dosyalar, tablolar ve kuyruklar olmak üzere dört hizmet için de kullanılabilir.The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

az storage account create \
    --name mystorageaccount \
    --resource-group myResourceGroup \
    --location eastus \
    --sku Standard_LRS \
    --encryption blob

Depolama hesabının kimlik bilgilerini belirtmeSpecify storage account credentials

Bu öğreticideki komutların çoğu için Azure CLI’sının depolama hesabı kimlik bilgilerinize ihtiyacı vardır.The Azure CLI needs your storage account credentials for most of the commands in this tutorial. Bunu yapmak için birkaç seçenek olsa da bunları sağlamanın en kolay yollarından biri AZURE_STORAGE_ACCOUNT ve AZURE_STORAGE_KEY ortam değişkenlerini ayarlamaktır.While there are several options for doing so, one of the easiest ways to provide them is to set AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY environment variables.

Öncelikle az storage account keys list komutunu kullanarak depolama hesabı anahtarlarınızı görüntüleyin:First, display your storage account keys by using the az storage account keys list command:

az storage account keys list \
    --account-name mystorageaccount \
    --resource-group myResourceGroup \
    --output table

Şimdi AZURE_STORAGE_ACCOUNT ve AZURE_STORAGE_KEY ortam değişkenlerini ayarlayın.Now, set the AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY environment variables. Bunu Bash kabuğunda export komutunu kullanarak gerçekleştirebilirsiniz:You can do this in the Bash shell by using the export command:

export AZURE_STORAGE_ACCOUNT="mystorageaccountname"
export AZURE_STORAGE_KEY="myStorageAccountKey"

Bir kapsayıcı oluşturmaCreate a container

Bloblar her zaman bir kapsayıcıya yüklenir.Blobs are always uploaded into a container. Bu, blob gruplarını bilgisayarınızdaki dosyaları klasörler halinde düzenlediğiniz gibi düzenleyebilmenizi sağlar.You can organize groups of blobs similar to the way you organize your files on your computer in folders.

az storage container create komutunu kullanarak blobları depolamak için bir kapsayıcı oluşturun.Create a container for storing blobs with the az storage container create command.

az storage container create --name mystoragecontainer

Blobu karşıya yüklemeUpload a blob

Blob depolama blok blobları, ekleme bloblarını ve sayfa bloblarını destekler.Blob storage supports block blobs, append blobs, and page blobs. Blob depolamada depolanan çoğu dosya blok blobu olarak depolanır.Most files stored in Blob storage are stored as block blobs. Ekleme blobları, verilerin mevcut içeriği değiştirmeden mevcut bir bloba eklenmesi gerektiğinde (örneğin günlüğe kaydetme için) kullanılır.Append blobs are used when data must be added to an existing blob without modifying its existing contents, such as for logging. Sayfa blobları IaaS sanal makinelerinin VHD dosyalarını yedekler.Page blobs back the VHD files of IaaS virtual machines.

İlk olarak blob yüklemek için bir dosya oluşturun.First, create a file to upload to a blob. Azure Cloud Shell kullanıyorsanız dosya oluşturmak için aşağıdaki adımları uygulayın: vi helloworld dosya açıldığında ekle'ye basın, "Hello world" yazın ve Esc'ye basıp :x girin ve Enter'a basın.If you're using the Azure cloud shell, use the following in order to create a file: vi helloworld when the file opens, press insert, type "Hello world" and then press Esc and enter :x and press Enter.

Bu örnekte, son adımda az storage blob upload komutuyla oluşturduğunuz kapsayıcıya bir blob yükleyeceksiniz.In this example, you upload a blob to the container you created in the last step using the az storage blob upload command.

az storage blob upload \
    --container-name mystoragecontainer \
    --name blobName \
    --file ~/path/to/local/file

Azure Cloud Shell'de dosya oluşturmak için yukarıda anlatılan yöntemi kullandıysanız bu CLI komutunu kullanabilirsiniz (dosya temel dizinde oluşturulduğu için yol belirtmeniz gerekmediğine dikkat edin, normalde yol belirtmeniz gerekir):If you used the previously described method to create a file in your Azure Cloud Shell, you can use this CLI command instead (note that you didn't need to specify a path since the file was created at the base directory, normally you'd need to specify a path):

az storage blob upload \
    --container-name mystoragecontainer \
    --name helloworld \
    --file helloworld

Bu işlemle, daha önce oluşturulmadıysa bir blob oluşturulur, aksi takdirde üzerine yazılacaktır.This operation creates the blob if it doesn't already exist, and overwrites it if it does. Devam etmeden önce istediğiniz sayıda dosyayı karşıya yükleyin.Upload as many files as you like before continuing.

Aynı anda birden fazla dosya yüklemek için az storage blob upload-batch komutunu kullanabilirsiniz.To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Blob’ları bir kapsayıcıda listelemeList the blobs in a container

az storage blob list komutuyla kapsayıcıdaki blobları listeleyin.List the blobs in the container with the az storage blob list command.

az storage blob list \
    --container-name mystoragecontainer \
    --output table

Blob indirmeDownload a blob

Önceden karşıya yüklediğiniz bir blobu indirmek için az storage blob download komutunu kullanın.Use the az storage blob download command to download the blob you uploaded earlier.

az storage blob download \
    --container-name mystoragecontainer \
    --name blobName \
    --file ~/destination/path/for/file

AzCopy ile veri aktarımıData transfer with AzCopy

AzCopy yardımcı programı, Azure Depolama’ya yüksek performanslı betik oluşturulabilir veri aktarımı için diğer bir seçenektir.The AzCopy utility is another option for high-performance scriptable data transfer for Azure Storage. Blob, Dosya ve Tablo depolamaları arasında veri aktarmak için AzCopy kullanabilirsiniz.You can use AzCopy to transfer data to and from Blob, File, and Table storage.

Hızlı bir örnek olarak, myfile.txt adlı dosyayı mystoragecontainer kapsayıcısına yüklemek için AzCopy komutu aşağıdadır.As a quick example, here is the AzCopy command for uploading a file called myfile.txt to the mystoragecontainer container.

azcopy \
    --source /mnt/myfiles \
    --destination https://mystorageaccount.blob.core.windows.net/mystoragecontainer \
    --dest-key <storage-account-access-key> \
    --include "myfile.txt"

Kaynakları temizlemeClean up resources

Bu Hızlı Başlangıç öğreticisinde oluşturduğunuz depolama hesabı dahil, kaynak grubunuzdaki hiçbir kaynağa artık ihtiyacınız yoksa az group delete komutuyla kaynak grubunu silin.If you no longer need any of the resources in your resource group, including the storage account you created in this Quickstart, delete the resource group with the az group delete command.

az group delete --name myResourceGroup

Sonraki adımlarNext steps

Bu Hızlı Başlangıç’ta, dosyaları yerel bir disk ve Azure Blob depolamadaki bir kapsayıcı arasında aktarmayı öğrendiniz.In this Quickstart, you learned how to transfer files between local disk and a container in Azure Blob storage. Azure Depolama’da bloblarla çalışma hakkında daha fazla bilgi edinmek için, Azure Blob depolamayla çalışma hakkındaki öğretici ile devam edin.To learn more about working with blobs in Azure Storage, continue to the tutorial for working with Azure Blob storage.