Share via

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

  • 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.

Ważne

Ta funkcja jest obecnie dostępna w wersji zapoznawczej. Zobacz Dodatkowe warunki użytkowania wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta lub wersji zapoznawczej albo w inny sposób nie zostały jeszcze wydane jako ogólnie dostępne.

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), zamiast cudzysłowów ("") zamiast cudzysłowów pojedynczych ('').

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), zamiast cudzysłowów ("") zamiast cudzysłowów pojedynczych ('').

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), zamiast cudzysłowów ("") zamiast cudzysłowów pojedynczych ('').

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: