다음을 통해 공유


AzCopy v10을 사용하여 Blob 속성 및 메타데이터 바꾸기

AzCopy를 사용하여 하나 이상의 Blob의 액세스 계층을 변경하고 하나 이상의 Blob의 메타데이터 및 인덱스 태그를 대체(덮어쓰기)할 수 있습니다.

시작하기

AzCopy를 다운로드하고 스토리지 서비스에 인증 자격 증명을 제공하는 방법에 관해 알아보려면 AzCopy 시작 문서를 참조하세요.

참고 항목

이 문서의 예제에서는 Microsoft Entra ID를 사용하여 권한 부여 자격 증명을 제공했다고 가정합니다.

SAS 토큰을 사용하여 blob 데이터에 대한 액세스 권한을 부여하려면 각 AzCopy 명령에서 해당 토큰을 리소스 URL에 추가할 수 있습니다. 예: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'

액세스 계층 변경

Blob의 액세스 계층을 변경하려면 azcopy set-properties 명령을 사용하고 -block-blob-tier 매개 변수를 액세스 계층의 이름으로 설정합니다.

이 예에서는 경로 인수를 작은따옴표(‘’)로 묶습니다. Windows 명령 셸(cmd.exe)을 제외하고 모든 명령 셸에서 작은따옴표를 사용합니다. Windows 명령 셸(cmd.exe)을 사용하는 경우 작은따옴표(‘’) 대신 큰따옴표(“”)로 경로 인수를 묶습니다.

Syntax

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=<access-tier>

예제

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot

가상 디렉터리의 모든 Blob에 대한 액세스 계층을 변경하려면 Blob 이름 대신 가상 디렉터리 이름을 참조한 다음, --recursive=true를 명령에 추가합니다.

예제

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true

보관 계층에서 온라인 계층으로 Blob을 리하이드레이션하려면 Blob을 설정 --rehydrate-prioritystandard 또는 high로 설정합니다. 이 매개 변수는 기본적으로 standard로 설정됩니다. 각 옵션의 장단점에 대한 자세한 내용은 리하이드레이션 우선 순위를 참조하세요.

예제

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high

메타데이터 바꾸기

Blob의 메타데이터를 바꾸려면 azcopy set-properties 명령을 사용하고 --metadata 매개 변수를 하나 이상의 키-값 쌍으로 설정합니다.

이 예에서는 경로 인수를 작은따옴표(‘’)로 묶습니다. Windows 명령 셸(cmd.exe)을 제외하고 모든 명령 셸에서 작은따옴표를 사용합니다. Windows 명령 셸(cmd.exe)을 사용하는 경우 작은따옴표(‘’) 대신 큰따옴표(“”)로 경로 인수를 묶습니다.

Syntax

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>

예제

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2

가상 디렉터리의 모든 Blob에 대한 메타데이터를 바꾸려면 Blob 이름 대신 가상 디렉터리 이름을 참조한 다음, --recursive=true를 명령에 추가합니다.

예제

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true

메타데이터를 지우려면 태그를 생략하고 명령의 끝에 --metadata=clear를 추가합니다.

예제

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear

인덱스 태그 바꾸기

Blob의 인덱스 태그를 바꾸려면 azcopy set-properties 명령을 사용하고 --blob-tags 매개 변수를 하나 이상의 키-값 쌍으로 설정합니다. Blob 인덱스 태그 설정은 Storage Blob 데이터 소유자 및 Blob의 태그에 액세스할 수 있는 권한(t SAS 권한)이 있는 공유 액세스 서명이 있는 모든 사용자가 수행할 수 있습니다. Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write 권한이 있는 RBAC 사용자도 이 작업을 수행할 수 있습니다.

이 예에서는 경로 인수를 작은따옴표(‘’)로 묶습니다. Windows 명령 셸(cmd.exe)을 제외하고 모든 명령 셸에서 작은따옴표를 사용합니다. Windows 명령 셸(cmd.exe)을 사용하는 경우 작은따옴표(‘’) 대신 큰따옴표(“”)로 경로 인수를 묶습니다.

Syntax

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>

예제

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value

가상 디렉터리의 모든 Blob에 대한 인덱스 태그를 바꾸려면 Blob 이름 대신 가상 디렉터리 이름을 참조한 다음, --recursive=true를 명령에 추가합니다.

예제

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value

다음 단계

다음 문서에서 더 많은 예제를 찾아보세요.

이러한 문서를 참조하여 설정을 구성하고, 성능을 최적화하고, 문제를 해결하세요.