Szybki start: Tworzenie, pobieranie i wyświetlanie listy obiektów blob za pomocą interfejsu wiersza polecenia platformy Azure
Interfejs wiersza polecenia platformy Azure to środowisko wiersza polecenia platformy Azure do zarządzania jej zasobami. 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. Ten przewodnik Szybki start zawiera opis użycia interfejsu wiersza polecenia platformy Azure do przekazywania danych do/pobierania danych z usługi Azure Blob Storage.
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 magazynu. Na potrzeby tego samouczka Szybki start utwórz konto magazynu przy użyciu witryny Azure Portal, programu Azure PowerShell lub interfejsu wiersza polecenia platformy Azure. Aby uzyskać pomoc dotyczącą tworzenia konta magazynu, zobacz Tworzenie konta magazynu.
Przygotowywanie środowiska dla interfejsu wiersza polecenia platformy Azure
Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.
Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.
Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
- 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
Dostęp do usługi Blob Storage można autoryzować za pomocą interfejsu wiersza polecenia platformy Azure przy użyciu poświadczeń usługi Microsoft Entra lub klucza dostępu do konta magazynu. Zalecane jest używanie poświadczeń firmy Microsoft Entra. W tym artykule pokazano, jak autoryzować operacje magazynu obiektów blob przy użyciu identyfikatora Entra firmy Microsoft.
Polecenia interfejsu wiersza polecenia platformy Azure dla operacji danych w usłudze Blob Storage obsługują --auth-mode parametr, który umożliwia określenie sposobu autoryzowania danej operacji. Ustaw parametr na --auth-mode wartość , aby login autoryzować przy użyciu poświadczeń firmy 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.
Parametr obsługuje --auth-mode tylko operacje na danych usługi Blob Storage. 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>
Tworzenie konta magazynu
Do utworzenia konta magazynu (ogólnego przeznaczenia) służy polecenie az storage account create. Konta magazynu można używać z wszystkimi czterema usługami: obiektami blob, plikami, tabelami i kolejkami.
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 danych na koncie magazynu. Aby uzyskać więcej informacji na temat przypisywania ról platformy Azure, zobacz Przypisywanie roli platformy Azure w celu uzyskania dostępu do danych obiektów 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
Propagowanie przypisań 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.
Przekazywanie obiektu blob
Usługa Blob Storage obsługuje blokowe, uzupełnialne i stronicowe obiekty blob. W przykładach w tym przewodniku Szybki start pokazano, jak pracować z blokowymi obiektami blob.
Najpierw utwórz plik do przekazania do blokowego obiektu blob. 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 klawisz Insert. Wpisz Hello world, a następnie naciśnij klawisz Esc. Następnie wpisz :x, a następnie naciśnij klawisz Enter.
W tym przykładzie do kontenera utworzonego w ostatnim kroku zostanie przekazany obiekt blob za pomocą 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
Jeśli obiekt blob nie istnieje, zostanie utworzony. W przeciwnym razie zostanie zastąpiony. Przed kontynuowaniem można przesłać dowolną liczbę plików.
Podczas przekazywania obiektu blob przy użyciu interfejsu wiersza polecenia platformy Azure występują odpowiednie wywołania interfejsu API REST za pośrednictwem protokołów http i https.
Aby przekazać jednocześnie wiele plików, możesz użyć polecenia az storage blob upload-batch.
Wyświetlanie listy obiektów blob w kontenerze
Do wyświetlania listy obiektów blob w kontenerze służy polecenie 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
Pobieranie obiektu blob
Użyj polecenia az storage blob download, aby pobrać przesłany 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 przy użyciu 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ę więcej o używaniu narzędzia AzCopy w wersji 10 z usługą Blob Storage, zobacz Transferowanie danych za pomocą narzędzia AzCopy i magazynu obiektów blob.
W poniższym przykładzie użyto narzędzia AzCopy do przekazania 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'
Czyszczenie zasobów
Jeśli chcesz usunąć zasoby utworzone w ramach tego przewodnika Szybki start, w tym konto magazynu, usuń grupę zasobów przy użyciu 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
Następne 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.