AzCopy v10 구성 설정(Azure Storage)
AzCopy는 스토리지 계정에서 또는 스토리지 계정으로 Blob 또는 파일을 복사하는 데 사용할 수 있는 명령줄 유틸리티입니다. 이 문서에는 AzCopy v10을 구성하는 데 사용할 수 있는 환경 변수 목록이 포함되어 있습니다.
참고 항목
AzCopy를 시작하는 데 도움이 되는 콘텐츠를 찾고 있다면 AzCopy 시작을 참조하세요.
AzCopy v10 환경 변수
다음 표에서는 각 환경 변수에 대해 설명하고 변수를 사용하는 데 도움이 되는 콘텐츠에 대한 링크를 제공합니다.
| 환경 변수 | 설명 |
|---|---|
| AWS_ACCESS_KEY_ID | Amazon Web Services 액세스 키. Amazon Web Services를 사용하여 권한을 부여할 키를 제공합니다. AzCopy를 사용하여 Amazon S3에서 Azure Storage로 데이터 복사 |
| AWS_SECRET_ACCESS_KEY | Amazon Web Services 비밀 액세스 키는 Amazon Web Services로 권한을 부여하는 비밀 키를 제공합니다. AzCopy를 사용하여 Amazon S3에서 Azure Storage로 데이터 복사 |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | 사용할 Microsoft Entra 엔드포인트입니다. 이 변수는 자동 로그인에만 사용됩니다. 로그인 명령을 호출할 때 대신 명령줄 플래그를 사용하세요. |
| AZCOPY_AUTO_LOGIN_TYPE | 이 변수를 , , MSISPNAZCLI및 PSCRED.로 DEVICE설정합니다. 이 변수는 명령을 사용하지 azcopy login 않고 권한을 부여하는 기능을 제공합니다. AzCopy 및 Microsoft Entra ID를 사용하여 Blob에 대한 액세스 권한 부여를 참조하세요. |
| AZCOPY_BUFFER_GB | 파일을 다운로드하고 업로드할 때 AzCopy에서 사용할 시스템 메모리의 최대 양을 지정합니다. 이 값을 기가바이트(GB) 단위로 표시합니다. 메모리 사용 최적화 참조 |
| AZCOPY_CACHE_PROXY_LOOKUP | 기본적으로 Windows의 AzCopy는 호스트 이름 수준에서 프록시 서버 조회를 캐시합니다(URL 경로를 고려하지 않음). 캐시를 사용하지 않도록 설정하려면 'true'가 아닌 다른 값으로 설정합니다. |
| AZCOPY_CONCURRENCY_VALUE | 발생할 수 있는 동시 요청 수를 지정합니다. 이 변수를 사용하여 처리량을 늘릴 수 있습니다. 컴퓨터에 CPU가 5개 미만인 경우 이 변수의 값이 .로 32설정됩니다. 그렇지 않으면 기본값은 16에 CPU 수를 곱한 값과 같습니다. 이 변수의 최대 기본값은 3000이지만 수동으로 이 값을 더 높거나 낮게 설정할 수 있습니다. 동시성 증가 참조 |
| AZCOPY_CONCURRENT_FILES | 동시에 전송을 시작하는 파일 수를 제어하여 한 번에 진행 중인 파일의 (근사치) 수를 재정의합니다. |
| AZCOPY_CONCURRENT_SCAN | 스캔하는 동안 사용되는 (최대) 병렬 처리 수준을 제어합니다. Azure Files/Blob 및 로컬 파일 시스템을 포함하는 병렬화된 열거자에만 영향을 줍니다. |
| AZCOPY_CONTENT_TYPE_MAP | 운영 체제에서 정의한 하나 이상의 기본 MIME 형식 매핑을 재정의합니다. 매핑을 정의하는 JSON 파일의 경로로 이 변수를 설정합니다. 예제 JSON 파일의 내용은 다음과 같습니다. { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | AzCopy가 Azure Stack과 같은 사용자 지정 환경을 수용할 수 있도록 서비스 API 버전을 재정의합니다. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Azure Blob이 원본인 경우에만 적용됩니다. 동시 검색은 더 빠르지만 계층적 목록 API를 사용하므로 더 많은 IO/비용이 발생할 수 있습니다. 성능을 희생하지만 비용을 절감하려면 'true'를 지정합니다. |
| AZCOPY_DISABLE_SYSLOG | Syslog 또는 Windows 이벤트 로거에서 로깅을 사용하지 않도록 설정합니다. 기본적으로 AzCopy는 이러한 채널에 로그를 보냅니다. Syslog 또는 Windows 이벤트 로그에서 노이즈를 줄이려면 이 변수를 true로 설정할 수 있습니다. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | 실제 다운로드 전에 임시 경로로 다운로드하도록 AzCopy를 구성합니다. 허용되는 값은 true 또는 false입니다. |
| AZCOPY_JOB_PLAN_LOCATION | 디스크를 채우지 않도록 작업 계획 파일(진행률 추적 및 재개에 사용됨)이 저장되는 위치를 재정의합니다. |
| AZCOPY_LOG_LOCATION | 디스크를 채우지 않도록 로그 파일이 저장되는 위치를 재정의합니다. |
| AZCOPY_MSI_CLIENT_ID | 사용자가 할당한 관리 ID의 클라이언트 ID입니다. AZCOPY_AUTO_LOGIN_TYPE이 MSI으로 설정된 경우 사용합니다. 비밀 저장소 없이 권한 부여를 참조하세요. |
| AZCOPY_MSI_OBJECT_ID | 사용자 할당 관리 ID의 개체 ID입니다. AZCOPY_AUTO_LOGIN_TYPE이 MSI으로 설정된 경우 사용합니다. 비밀 저장소 없이 권한 부여를 참조하세요. |
| AZCOPY_MSI_RESOURCE_STRING | 사용자 할당 관리 ID의 리소스 ID입니다. 비밀 저장소 없이 권한 부여를 참조하세요. |
| AZCOPY_PACE_PAGE_BLOBS | 페이지 Blob의 처리량을 서비스 한도에 맞게 자동으로 조정해야 하나요? 기본값은 true입니다. 사용하지 않도록 설정하려면 'false'로 설정 |
| AZCOPY_PARALLEL_STAT_FILES | 로컬 파일 시스템을 검사할 때 AzCopy가 병렬 ‘스레드’에서 파일 속성을 조회하도록 합니다. 스레드는 AZCOPY_CONCURRENT_SCAN 정의된 풀에서 가져옵니다. 이를 true로 설정하면 Linux의 검색 성능이 향상될 수 있습니다. Windows에서는 필요하지 않거나 권장되지 않습니다. |
| AZCOPY_REQUEST_TRY_TIMEOUT | AzCopy 시간이 초과되기 전에 AzCopy가 각 요청에 대한 파일을 업로드하려고 시도하는 시간(분)을 설정합니다. |
| AZCOPY_SHOW_PERF_STATES | 설정하면 화면 출력에 상태별 청크 수가 포함됩니다. |
| AZCOPY_SPA_APPLICATION_ID | 서비스 주체의 앱 등록 애플리케이션 ID입니다. AZCOPY_AUTO_LOGIN_TYPE이 SPN으로 설정된 경우 사용합니다. 비밀 저장소 없이 권한 부여를 참조하세요. |
| AZCOPY_SPA_CERT_PASSWORD | 인증서의 암호입니다. AZCOPY_AUTO_LOGIN_TYPE이 SPN으로 설정된 경우 사용합니다. 비밀 저장소 없이 권한 부여를 참조하세요. |
| AZCOPY_SPA_CERT_PATH | 인증서 파일의 상대 경로 또는 정규화된 경로입니다. AZCOPY_AUTO_LOGIN_TYPE이 SPN으로 설정된 경우 사용합니다. 비밀 저장소 없이 권한 부여를 참조하세요. |
| AZCOPY_SPA_CLIENT_SECRET | 클라이언트 암호 AZCOPY_AUTO_LOGIN_TYPE이 SPN으로 설정된 경우 사용합니다. 비밀 저장소 없이 권한 부여를 참조하세요. |
| AZCOPY_TENANT_ID | OAuth 디바이스 대화형 로그인에 사용할 Microsoft Entra 테넌트 ID입니다. 이 변수는 자동 로그인에만 사용됩니다. 로그인 명령을 호출할 때 대신 명령줄 플래그를 사용하세요. |
| AZCOPY_TUNE_TO_CPU | 동시성 수준을 자동으로 튜닝할 때(예: 벤치마크 명령에서) AzCopy가 CPU 사용량을 고려하지 않도록 하려면 false로 설정합니다. |
| AZCOPY_USER_AGENT_PREFIX | 원격 분석 용도로 사용되는 기본 AzCopy 사용자 에이전트에 접두사를 추가합니다. 공백이 자동으로 삽입됩니다. |
| CPK_ENCRYPTION_KEY | Base 64로 인코딩된 AES-256 암호화 키 값입니다. 이 변수는 고객 제공 키를 사용하여 Blob Storage 작업에서 데이터를 암호화하고 암호 해독할 때 읽기 및 쓰기 요청 모두에 필요합니다. --cpk-by-value=true 플래그를 설정하여 고객 제공 키를 사용할 수 있습니다. |
| CPK_ENCRYPTION_KEY_SHA256 | 암호화 키의 Base64로 인코딩된 SHA256입니다. 이 변수는 고객 제공 키를 사용하여 Blob Storage 작업에서 데이터를 암호화하고 암호 해독할 때 읽기 및 쓰기 요청 모두에 필요합니다. --cpk-by-value=true 플래그를 설정하여 고객 제공 키를 사용할 수 있습니다. |
| GOOGLE_APPLICATION_CREDENTIALS | 서비스 계정 키 파일의 절대 경로는 Google Cloud Storage에 권한을 부여하는 키를 제공합니다. AzCopy(미리 보기)를 사용하여 Google Cloud Storage에서 Azure Storage로 데이터 복사 |
| GOOGLE_CLOUD_PROJECT | Google Cloud Storage의 서비스 수준 순회에 필요한 프로젝트 ID입니다. |
| HTTPS_PROXY | AzCopy에 대한 프록시 설정을 구성합니다. 이 변수를 프록시 IP 주소 및 프록시 포트 번호로 설정합니다. 예: xx.xxx.xx.xxx:xx. Windows에서 AzCopy를 실행하는 경우 AzCopy가 프록시 설정을 자동으로 검색하므로 Windows에서 이 설정을 사용할 필요가 없습니다. Windows에서 이 설정을 사용하도록 선택하면 자동 검색이 재정의됩니다. 프록시 설정 구성 참조 |
프록시 설정 구성
AzCopy에 대한 프록시 설정을 구성하려면 HTTPS_PROXY 환경 변수를 설정합니다. Windows에서 AzCopy를 실행하는 경우 AzCopy가 프록시 설정을 자동으로 검색하므로 Windows에서 이 설정을 사용할 필요가 없습니다. Windows에서 이 설정을 사용하도록 선택하면 자동 검색이 재정의됩니다.
| 운영 체제 | 명령 |
|---|---|
| Windows | 명령 프롬프트에서 set HTTPS_PROXY=<proxy IP>:<proxy port>를 사용합니다.PowerShell에서 다음을 사용합니다. $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
현재 AzCopy는 NTLM 또는 Kerberos로 인증해야 하는 프록시를 지원하지 않습니다.
프록시 무시
Windows에서 AzCopy를 실행하고 있으며 설정을 자동으로 검색하는 대신 프록시를 전혀 사용하지 않도록 지시하려는 경우 다음 명령을 사용합니다. 이러한 설정을 사용하면 AzCopy는 프록시를 조회하거나 사용하지 않습니다.
| 운영 체제 | Environment | 명령 |
|---|---|---|
| Windows | 명령 프롬프트(CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
다른 운영 체제에서는 프록시를 사용하지 않으려면 HTTPS_PROXY 변수를 설정하지 않은 상태로 두면 됩니다.