Udostępnij za pomocą

Szybki start: tworzenie, pobieranie i wyświetlanie listy obiektów blob za pomocą interfejsu wiersza polecenia platformy Azure

Interfejs wiersza polecenia Azure to narzędzie do zarządzania zasobami Azure. Można używać go w przeglądarce za pośrednictwem usługi Azure Cloud Shell. Istnieje także możliwość zainstalowania go w systemach macOS, Linux lub Windows, a następnie uruchomienia z poziomu wiersza polecenia. Z tego przewodnika Szybki start dowiesz się, jak przekazywać i pobierać dane z usługi Azure Blob Storage za pomocą interfejsu wiersza polecenia platformy Azure.

Wymagania wstępne

Aby uzyskać dostęp do usługi Azure Storage, potrzebujesz subskrypcji platformy Azure. Jeśli nie masz jeszcze subskrypcji, przed rozpoczęciem utwórz bezpłatne konto .

Cały dostęp do usługi Azure Storage odbywa się za pośrednictwem konta magazynowania. Na potrzeby tego szybkiego startu utwórz konto magazynu w portalu Azure, programie Azure PowerShell lub interfejsie wiersza polecenia platformy Azure. Aby uzyskać pomoc dotyczącą tworzenia konta magazynowego, zobacz Tworzenie konta magazynowego.

Przygotuj swoje środowisko dla Azure CLI

  • Ten artykuł wymaga wersji 2.0.46 lub nowszej interfejsu wiersza polecenia platformy Azure. W przypadku korzystania z usługi Azure Cloud Shell najnowsza wersja jest już zainstalowana.

Autoryzowanie dostępu do usługi Blob Storage

Możesz autoryzować dostęp do Blob storage z poziomu interfejsu wiersza polecenia Azure, korzystając z poświadczeń Microsoft Entra lub klucza dostępu do konta magazynowego. Zalecane jest używanie poświadczeń firmy Microsoft Entra. W tym artykule pokazano, jak autoryzować operacje magazynu Blob przy użyciu Microsoft Entra ID.

Polecenia Azure CLI dla operacji danych w usłudze Blob Storage obsługują parametr --auth-mode, który umożliwia określenie sposobu autoryzowania danej operacji. Ustaw parametr --auth-mode na login, aby autoryzować przy użyciu poświadczeń Microsoft Entra. Aby uzyskać więcej informacji, zobacz Autoryzowanie dostępu do danych obiektów blob lub kolejek za pomocą interfejsu wiersza polecenia platformy Azure.

Tylko operacje na danych w Blob Storage obsługują parametr --auth-mode. Operacje zarządzania, takie jak tworzenie grupy zasobów lub konta magazynu, automatycznie używają poświadczeń firmy Microsoft Entra do autoryzacji.

Aby rozpocząć, zaloguj się do konta platformy Azure przy użyciu polecenia az login.

az login

Tworzenie grupy zasobów

Grupę zasobów platformy Azure można utworzyć za pomocą polecenia az group create. Grupa zasobów to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi.

Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach kątowych własnymi wartościami:

az group create \
    --name <resource-group> \
    --location <location>

Utwórz konto przechowywania

Utwórz konto magazynu ogólnego przeznaczenia za pomocą polecenia az storage account create . Konto przechowywania ogólnego przeznaczenia może być używane dla wszystkich czterech usług: obiektów blob, plików, tabel i kolejek.

Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach kątowych własnymi wartościami:

az storage account create \
    --name <storage-account> \
    --resource-group <resource-group> \
    --location <location> \
    --sku Standard_ZRS \
    --encryption-services blob

Tworzenie kontenera

Obiekty blob są zawsze przesyłane do kontenera. Grupy obiektów blob można organizować w kontenerach podobnie jak w przypadku organizowania plików na komputerze w folderach. Do tworzenia kontenera do przechowywania obiektów blob służy polecenie az storage container create.

W poniższym przykładzie użyto konta Microsoft Entra, aby autoryzować operację do utworzenia kontenera. Przed utworzeniem kontenera przypisz rolę Współautor danych obiektu blob usługi Storage do siebie. Nawet jeśli jesteś właścicielem konta, potrzebujesz jawnych uprawnień do wykonywania operacji na danych na koncie magazynowym. Aby uzyskać więcej informacji na temat przypisywania ról platformy Azure, zobacz Przypisywanie roli Azure w celu uzyskania dostępu do danych blob.

Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach kątowych własnymi wartościami:

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

Ważne

Rozpropagowanie przydziałów ról platformy Azure może potrwać kilka minut.

Możesz również użyć klucza konta magazynu, aby autoryzować operację do utworzenia kontenera. Aby uzyskać więcej informacji na temat autoryzowania operacji danych za pomocą interfejsu wiersza polecenia platformy Azure, zobacz Autoryzowanie dostępu do danych obiektów blob lub kolejek za pomocą interfejsu wiersza polecenia platformy Azure.

Załaduj obiekt blob

Usługa Blob Storage obsługuje obiekty blob blokowe, obiekty blob dołączane i obiekty blob stronicowe. Przykłady w tym przewodniku Quickstart pokazują, jak pracować z blokowymi blobami.

Najpierw utwórz plik do przesłania do blokowego bloba. Jeśli używasz usługi Azure Cloud Shell, użyj następującego polecenia, aby utworzyć plik:

vi helloworld

Po otwarciu pliku naciśnij Insert. Wpisz Hello world, a następnie naciśnij Esc. Następnie wpisz :x, a następnie naciśnij Enter.

W tym przykładzie przekażesz obiekt blob do kontenera utworzonego w ostatnim kroku przy użyciu polecenia az storage blob upload . Nie trzeba określać ścieżki pliku, ponieważ plik został utworzony w katalogu głównym. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach kątowych własnymi wartościami:

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --name myFile.txt \
    --file myFile.txt \
    --auth-mode login

Ta operacja tworzy blob, jeśli jeszcze nie istnieje, i nadpisuje go, jeśli tak. Przed kontynuowaniem prześlij tyle plików, ile chcesz.

Podczas przekazywania obiektu blob przy użyciu Azure CLI występują odpowiednie wywołania interfejsu API REST przez protokoły HTTP i HTTPS.

Aby przekazać wiele plików jednocześnie, możesz użyć polecenia az storage blob upload-batch .

Wyświetlanie listy obiektów blob w kontenerze

Wyświetl listę obiektów blob w kontenerze za pomocą polecenia az storage blob list . Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach kątowych własnymi wartościami:

az storage blob list \
    --account-name <storage-account> \
    --container-name <container> \
    --output table \
    --auth-mode login

Pobranie bloba

Użyj polecenia az storage blob download , aby pobrać przekazany wcześniej obiekt blob. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach kątowych własnymi wartościami:

az storage blob download \
    --account-name <storage-account> \
    --container-name <container> \
    --name myFile.txt \
    --file <~/destination/path/for/file> \
    --auth-mode login

Transfer danych za pomocą narzędzia AzCopy

Narzędzie wiersza polecenia AzCopy oferuje wysokiej wydajności, skryptowy transfer danych dla usługi Azure Storage. Za pomocą narzędzia AzCopy można przesyłać dane do i z usług Blob Storage i Azure Files. Aby uzyskać więcej informacji na temat narzędzia AzCopy w wersji 10, najnowszej wersji narzędzia AzCopy, zobacz Wprowadzenie do narzędzia AzCopy. Aby dowiedzieć się, jak używać narzędzia AzCopy w wersji 10 z magazynem obiektów blob, zobacz Transferowanie danych za pomocą narzędzia AzCopy i magazynu obiektów blob.

W poniższym przykładzie użyto narzędzia AzCopy do przesłania pliku lokalnego do obiektu blob. Pamiętaj, aby zastąpić przykładowe wartości własnymi wartościami:

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

Uprzątnij zasoby

Jeśli chcesz usunąć zasoby utworzone w ramach tego przewodnika szybkiego startu, w tym konto magazynowe, usuń grupę zasobów, korzystając z polecenia az group delete. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach kątowych własnymi wartościami:

az group delete \
    --name <resource-group> \
    --no-wait

Dalsze kroki

W tym przewodniku Szybki start przedstawiono sposób przesyłania plików między lokalnym systemem plików a kontenerem w usłudze Azure Blob Storage. Aby dowiedzieć się więcej na temat pracy z usługą Blob Storage przy użyciu interfejsu wiersza polecenia platformy Azure, wybierz opcję poniżej.

Zarządzanie blokowymi obiektami blob za pomocą Azure CLI

Przykłady interfejsu wiersza polecenia platformy Azure dla usługi Blob Storage

  • Last updated on