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

  • Artykuł
  • Czas czytania: 6 min

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

  • Ten artykuł wymaga wersji 2.0.46 lub nowszej interfejsu wiersza polecenia platformy Azure. Jeśli korzystasz 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ń Azure AD lub klucza dostępu do konta magazynu. Zaleca się używanie poświadczeń Azure AD. W tym artykule pokazano, jak autoryzować operacje magazynu obiektów blob przy użyciu Azure AD.

Polecenia interfejsu wiersza polecenia platformy Azure dla operacji na danych w usłudze Blob Storage obsługują --auth-mode parametr , który umożliwia określenie sposobu autoryzowania danej operacji. --auth-mode Ustaw parametr na wartość , aby login autoryzować przy użyciu poświadczeń Azure AD. 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 usługi Blob Storage obsługują --auth-mode parametr . Operacje zarządzania, takie jak tworzenie grupy zasobów lub konta magazynu, automatycznie używają poświadczeń Azure AD 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 Azure AD, 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 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

Propagacja 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 na 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 ciąg :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.

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 wydajny, skryptowy transfer danych dla usługi Azure Storage. Za pomocą narzędzia AzCopy można przesyłać dane do i z usługi Blob Storage i Azure Files. Aby uzyskać więcej informacji na temat narzędzia AzCopy w wersji 10, najnowszej wersji narzędzia AzCopy, zobacz Get started with AzCopy (Rozpoczynanie pracy z narzędziem AzCopy). Aby dowiedzieć się więcej o korzystaniu z narzędzia AzCopy w wersji 10 z usługą Blob Storage, zobacz Transfer 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 transferu plików między lokalnym systemem plików i 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 poniżej opcję.

Zarządzanie blokowymi obiektami blob za pomocą interfejsu wiersza polecenia platformy Azure

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