azcopy set-properties
위치가 지정되면 해당 스토리지(Blob 또는 파일)의 모든 유효한 시스템 속성을 변경합니다.
개요
azcopy set-properties [resourceURL] [flags]
Blob 및 File 스토리지의 속성을 설정합니다. 현재 이 명령에서 지원하는 속성은 다음과 같습니다.
- Blob -> 계층, 메타데이터, 태그
- Data Lake Storage -> 계층, 메타데이터, 태그
- Files -> 메타데이터
참고 항목
Data Lake Storage 엔드포인트는 Blob Storage 엔드포인트로 대체됩니다.
자세한 내용은 예제를 참조하세요.
관련 개념 문서
예제
Blob 계층을 hot으로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot
Blob 계층을 콜드로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cold
Blob 계층을 핫에서 보관으로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive
리하이드레이션 우선 순위를 high로 설정한 상태에서 Blob 계층을 archive에서 cool로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
리하이드레이트 우선 순위가 표준으로 설정된 Blob 계층을 쿨에서 핫으로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard
디렉터리에 있는 모든 파일의 계층을 archive로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true
페이지 Blob의 계층 변경:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --page-blob-tier=[P10/P15/P20/P30/P4/P40/P50/P6]--rehydrate-priority=[Standard/High]
Blob의 메타데이터를 {key = "abc", val = "def"} 및 {key = "ghi", val = "jkl"}로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl
디렉터리에 있는 모든 파일의 메타데이터를 {key = "abc", val = "def"} 및 {key = "ghi", val = "jkl"}로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true
Blob의 기존 메타데이터를 모두 지웁니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear
모든 파일에서 모든 기존 메타데이터의 지우기:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --metadata=clear
Blob의 Blob 태그를 {key = "abc", val = "def"} 및 {key = "ghi", val = "jkl"}로 변경합니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl
Blob에 대한 태그를 설정하는 동안 SAS를 사용하는 권한(태그에 대한 't')이 있습니다. 이러한 태그가 없으면 서비스에서 권한 부여 오류를 반환합니다.
Blob의 모든 기존 Blob 태그를 지웁니다.
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
Blob에 대한 태그를 설정하는 동안 SAS를 사용하는 권한(태그에 대한 't')이 있습니다. 이러한 태그가 없으면 서비스에서 권한 부여 오류를 반환합니다.
옵션
--blob-tags 문자열 스토리지 계정의 데이터를 분류하도록 Blob에 태그 설정('&'으로 구분)
--block-blob-tier 문자열 - Blob의 액세스 계층을 지정된 계층으로 변경합니다(기본값 "None").
--dry-run - 이 명령의 영향을 받는 파일 경로를 출력합니다. 이 플래그는 실제 파일에 영향을 주지 않습니다.
--exclude-path 문자열 - 제거할 때 이러한 경로를 제외합니다. 이 옵션은 와일드카드 문자(*)를 지원하지 않습니다. 상대 경로 접두사를 확인하세요. 예: myFolder;myFolder/subDirName/file.pdf
--exclude-pattern 문자열 - 이름이 패턴 목록과 일치하는 파일을 제외합니다. 예: .jpg;.pdf;exactName
--from-to 문자열 - 필요에 따라 원본 대상 조합을 지정합니다. 유효한 값: BlobNone, FileNone, BlobFSNone
-h, --help - set-properties에 대한 도움말
--include-path 문자열 - 속성을 설정할 때 이러한 경로만 포함합니다. 이 옵션은 와일드카드 문자(*)를 지원하지 않습니다. 상대 경로 접두사를 확인하세요. 예: myFolder;myFolder/subDirName/file.pdf
--include-pattern 문자열 - 이름이 패턴 목록과 일치하는 파일만 포함합니다. 예: .jpg;.pdf;exactName
--list-of-files 문자열 - 복사할 파일 목록이 있는 텍스트 파일의 위치를 정의합니다.
--metadata 문자열 - 이러한 키-값 쌍(';'으로 구분)을 메타데이터로 사용하여 지정된 위치를 설정합니다.
--page-blob-tier 문자열 - 이 Blob 계층을 사용하여 페이지 Blob을 Azure Storage에 업로드합니다. (기본값 ‘None’) (기본값 "None")
--recursive 로컬 파일 시스템에서 업로드할 때 하위 디렉터리를 재귀적으로 살펴봅니다.
--rehydrate-priority 문자열 - 리하이드레이션에 대한 리하이드레이션 우선 순위를 설정하는 선택적 플래그입니다. 유효한 값: Standard, High. 기본값: standard(기본값 "Standard")
부모 명령에서 상속된 옵션
--cap-mbps float 전송 속도(Mbps)의 한도를 지정합니다. 순간별 처리량은 한도와 약간 다를 수 있습니다. 이 옵션이 0으로 설정되거나 생략되는 경우 처리량이 제한되지 않습니다.
--log-level(문자열) 로그 파일의 로그 세부 정보 표시 수준을 정의합니다. 사용할 수 있는 수준으로는 INFO(모든 요청/응답), WARNING(느린 응답), ERROR(실패한 요청만), NONE(출력 로그 없음)이 있습니다. (기본값: ‘INFO’) (기본값 "INFO")
--output-type (string) 명령 출력의 형식입니다. text, json 등을 선택할 수 있습니다. 기본값은 'text'입니다. (기본 "text")
--output-level(문자열) 출력 세부 정보 표시를 정의합니다. 사용 가능한 수준: essential, quiet. (기본값 "default")
--trusted-microsoft-suffixes (string) Microsoft Entra ID 로그인 토큰을 보낼 수 있는 다른 도메인 접미사를 지정합니다. 기본값은 ‘.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net’입니다. 여기에 나열된 모든 항목이 기본값에 추가됩니다. 보안을 위해 Microsoft Azure 도메인만 여기에 배치해야 합니다. 여러 항목을 세미콜론으로 구분합니다.