Udostępnij za pomocą

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 i tagi indeksu co najmniej jednego obiektu blob.

Wprowadzenie

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 założono, że podasz poświadczenia autoryzacji przy użyciu identyfikatora Entra firmy Microsoft.

Jeśli chcesz użyć tokenu SAS do autoryzowania dostępu do danych obiektów blob, dołącz 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ść. Rola Właściciel danych obiektu blob usługi Storage i każda osoba posiadająca sygnaturę dostępu współdzielonego, która ma uprawnienia SAS do tagów obiektów blob, może ustawić tagi indeksujące obiektów blob. 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:

  • Last updated on