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 변수를 설정하지 않은 상태로 두면 됩니다.

참고 항목