Zastępowanie właściwości obiektów blob i metadanych przy użyciu narzędzia AzCopy w wersji 10
Za pomocą narzędzia AzCopy można zmienić warstwę dostępu co najmniej jednego obiektu blob i zastąpić (zastąpić) metadane oraz tagi indeksu co najmniej jednego obiektu blob.
Rozpocznij
Zapoznaj się z artykułem Wprowadzenie do narzędzia AzCopy, aby pobrać narzędzie AzCopy i dowiedzieć się więcej o sposobach udostępniania poświadczeń autoryzacji do usługi magazynu.
Uwaga
W przykładach w tym artykule przyjęto założenie, że podano poświadczenia autoryzacji przy użyciu identyfikatora Entra firmy Microsoft.
Jeśli wolisz użyć tokenu SAS do autoryzowania dostępu do danych obiektów blob, możesz dołączyć ten token do adresu URL zasobu w każdym poleceniu narzędzia AzCopy. Na przykład: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'
.
Zmienianie warstwy dostępu
Aby zmienić warstwę dostępu obiektu blob, użyj polecenia azcopy set-properties i ustaw -block-blob-tier
parametr na nazwę warstwy dostępu.
Napiwek
W tym przykładzie argumenty ścieżki są ujęte w apostrofy (''). Używaj pojedynczych cudzysłowów we wszystkich powłokach poleceń z wyjątkiem powłoki poleceń systemu Windows (cmd.exe). Jeśli używasz powłoki poleceń systemu Windows (cmd.exe), ujęć argumenty ścieżki z podwójnymi cudzysłowami ("") zamiast pojedynczych cudzysłowów ('').
Składnia
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=<access-tier>
Przykład
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot
Aby zmienić warstwę dostępu dla wszystkich obiektów blob w katalogu wirtualnym, zapoznaj się z nazwą katalogu wirtualnego zamiast nazwy obiektu blob, a następnie dołącz --recursive=true
do polecenia .
Przykład
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true
Aby przywrócić obiekt blob z warstwy Archiwum do warstwy online, ustaw wartość --rehydrate-priority
na standard
lub high
. Domyślnie ten parametr ma wartość standard
. Aby dowiedzieć się więcej o kompromisach każdej opcji, zobacz Temat Priorytet ponownego wypełniania.
Przykład
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high
Zastępowanie metadanych
Aby zastąpić metadane obiektu blob, użyj polecenia azcopy set-properties i ustaw --metadata
parametr na co najmniej jedną parę klucz-wartość.
Napiwek
W tym przykładzie argumenty ścieżki są ujęte w apostrofy (''). Używaj pojedynczych cudzysłowów we wszystkich powłokach poleceń z wyjątkiem powłoki poleceń systemu Windows (cmd.exe). Jeśli używasz powłoki poleceń systemu Windows (cmd.exe), ujęć argumenty ścieżki z podwójnymi cudzysłowami ("") zamiast pojedynczych cudzysłowów ('').
Składnia
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>
Przykład
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2
Aby zastąpić metadane dla wszystkich obiektów blob w katalogu wirtualnym, zapoznaj się z nazwą katalogu wirtualnego zamiast nazwy obiektu blob, a następnie dołącz --recursive=true
do polecenia .
Przykład
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true
Aby wyczyścić metadane, pomiń tagi i dołącz --metadata=clear
je na końcu polecenia.
Przykład
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear
Zastępowanie tagów indeksu
Aby zastąpić tagi indeksu obiektu blob, użyj polecenia azcopy set-properties i ustaw --blob-tags
parametr na co najmniej jedną parę klucz-wartość. Ustawienie tagów indeksu obiektów blob może być wykonywane przez właściciela danych obiektu blob usługi Storage i przez każdego, kto ma sygnaturę dostępu współdzielonego z uprawnieniami dostępu do tagów obiektu blob ( t
uprawnienia sygnatury dostępu współdzielonego). Ponadto użytkownicy RBAC z uprawnieniami Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write
mogą wykonać tę operację.
Napiwek
W tym przykładzie argumenty ścieżki są ujęte w apostrofy (''). Używaj pojedynczych cudzysłowów we wszystkich powłokach poleceń z wyjątkiem powłoki poleceń systemu Windows (cmd.exe). Jeśli używasz powłoki poleceń systemu Windows (cmd.exe), ujęć argumenty ścieżki z podwójnymi cudzysłowami ("") zamiast pojedynczych cudzysłowów ('').
Składnia
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>
Przykład
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
Aby zastąpić tagi indeksu dla wszystkich obiektów blob w katalogu wirtualnym, zapoznaj się z nazwą katalogu wirtualnego zamiast nazwy obiektu blob, a następnie dołącz --recursive=true
do polecenia .
Przykład
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
Następne kroki
Więcej przykładów można znaleźć w następujących artykułach:
- Przykłady: przekazywanie
- Przykłady: pobieranie
- Przykłady: kopiowanie między kontami
- Przykłady: Synchronizacja
- Przykłady: zasobniki usługi Amazon S3
- Przykłady: Google Cloud Storage
- Przykłady: Azure Files
- Samouczek: migrowanie danych lokalnych do magazynu w chmurze przy użyciu narzędzia AzCopy
Zobacz następujące artykuły, aby skonfigurować ustawienia, zoptymalizować wydajność i rozwiązać problemy: