Udostępnij za pośrednictwem

Zastępowanie właściwości obiektów blob i metadanych przy użyciu narzędzia AzCopy w wersji 10

  • Artykuł

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:

Zobacz następujące artykuły, aby skonfigurować ustawienia, zoptymalizować wydajność i rozwiązać problemy: