az storage blob directory

참고

이 참조는 Azure CLI(버전 2.25.0 이상)에 대한 스토리지 미리 보기 확장의 일부입니다. az storage blob directory 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

스토리지 계정 컨테이너에서 Blob 디렉터리를 관리합니다.

디렉터리 명령을 사용하려면 스토리지 계정 유형이 StorageV2인지 확인하세요.

명령

az storage blob directory access

계층 구조 네임스페이스를 사용하는 경우 디렉터리의 액세스 제어 속성을 관리합니다.

az storage blob directory access set

디렉터리의 액세스 제어 속성을 설정합니다.

az storage blob directory access show

디렉터리의 액세스 제어 속성을 표시합니다.

az storage blob directory access update

디렉터리의 액세스 제어 속성을 업데이트합니다.

az storage blob directory create

스토리지 컨테이너에 스토리지 Blob 디렉터리를 만듭니다.

az storage blob directory delete

스토리지 컨테이너에서 스토리지 Blob 디렉터리를 삭제합니다.

az storage blob directory download

로컬 파일 경로에 Blob을 다운로드합니다.

az storage blob directory exists

스토리지 컨테이너에 Blob 디렉터리가 있는지 확인합니다.

az storage blob directory list

스토리지 디렉터리에 Blob 및 Blob 하위 디렉터리를 나열합니다.

az storage blob directory metadata

디렉터리 메타데이터를 관리합니다.

az storage blob directory metadata show

지정된 Blob 디렉터리에 대한 모든 사용자 정의 메타데이터를 표시합니다.

az storage blob directory metadata update

지정된 Blob 디렉터리에 대한 사용자 정의 메타데이터를 하나 이상의 이름-값 쌍으로 설정합니다.

az storage blob directory move

스토리지 디렉터리를 스토리지 컨테이너의 다른 스토리지 Blob 디렉터리로 이동합니다.

az storage blob directory show

스토리지 컨테이너에 스토리지 Blob 디렉터리 속성을 표시합니다.

az storage blob directory upload

Blob 또는 하위 디렉터리를 스토리지 Blob 디렉터리에 업로드합니다.

az storage blob directory create

스토리지 컨테이너에 스토리지 Blob 디렉터리를 만듭니다.

스토리지 컨테이너에 다른 디렉터리 또는 Blob을 포함할 수 있는 스토리지 Blob 디렉터리를 만듭니다.

az storage blob directory create --container-name
                                 --directory-path
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--connection-string]
                                 [--lease-id]
                                 [--metadata]
                                 [--permissions]
                                 [--sas-token]
                                 [--timeout]
                                 [--umask]

예제

스토리지 컨테이너에 스토리지 Blob 디렉터리를 만듭니다.

az storage blob directory create -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

권한 및 umask를 사용하여 스토리지 Blob 디렉터리를 만듭니다.

az storage blob directory create -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount --permissions rwxrwxrwx --umask 0000

필수 매개 변수

--container-name -c

컨테이너 이름

--directory-path -d

디렉터리 경로 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 계정에 대한 인증 매개 변수가 제공되지 않으면 레거시 "키" 모드에서 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

덮어쓸 디렉터리에 활성 임대가 있는 경우 필요합니다.

--metadata

공백으로 구분된 키=값 쌍의 메타데이터입니다. 기존 메타데이터를 덮어씁니다.

--permissions

선택 사항이며 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. 파일 소유자, 파일 소유 그룹 등에 대한 POSIX 액세스 권한을 설정합니다. 각 클래스에는 읽기, 쓰기 또는 실행 권한이 부여될 수 있습니다. 고정 비트도 지원됩니다. 기호(rwxrw-rw-) 및 4자리 8진수 표기법(예: 0766)이 모두 지원됩니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

--umask

선택 사항이며 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 유효합니다. umask는 파일 및 디렉터리에 대한 사용 권한 설정을 제한하며 기본 Acl이 부모 디렉터리에 없는 경우에만 적용됩니다. umask 비트가 설정된 경우 해당 사용 권한이 비활성화됨을 의미합니다. 이러한 방식으로 결과 사용 권한은 p & ^u에 의해 부여됩니다. 여기서 p는 사용 권한이며 사용자는 umask입니다. 여기서는 4자리 8진수 표기법(예: 0022)만 지원됩니다.

기본값: 0027

az storage blob directory delete

스토리지 컨테이너에서 스토리지 Blob 디렉터리를 삭제합니다.

이 작업의 동작은 계층 구조 네임스페이스를 사용할 수 있는지 여부에 따라 다릅니다. 그렇다면 삭제 작업은 원자성 및 순간적일 수 있습니다. 그렇지 않으면 작업이 일괄 처리로 수행되고 연속 토큰이 반환될 수 있습니다.

az storage blob directory delete --container-name
                                 --directory-path
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--connection-string]
                                 [--fail-not-exist]
                                 [--if-match]
                                 [--if-modified-since]
                                 [--if-none-match]
                                 [--if-unmodified-since]
                                 [--lease-id]
                                 [--marker]
                                 [--recursive]
                                 [--sas-token]
                                 [--timeout]

예제

스토리지 컨테이너에서 스토리지 Blob 디렉터리를 삭제합니다.

az storage blob directory delete -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

필수 매개 변수

--container-name -c

컨테이너 이름

--directory-path -d

디렉터리 경로 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 계정에 대한 인증 매개 변수가 제공되지 않으면 레거시 "키" 모드에서 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--fail-not-exist

디렉터리가 없을 때 예외를 throw할지 여부를 지정합니다.

--if-match

ETag 값 또는 와일드카드 문자(*)입니다. 리소스의 ETag가 지정된 값과 일치하는 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

--if-modified-since

제공된 UTC 날짜/시간(Y-m-d'T'H:M'Z') 이후 수정된 경우에만 변경합니다.

--if-none-match

ETag 값 또는 와일드카드 문자(*)입니다. 리소스의 ETag가 지정된 값과 일치하지 않는 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

--if-unmodified-since

제공된 UTC 날짜/시간(Y-m-d'T'H:M'Z') 이후 수정되지 않은 경우에만 변경합니다.

--lease-id

디렉터리에 활성 임대가 있는 경우 필요합니다.

--marker

(선택 사항) 계층 구조 네임스페이스 없이 디렉터리를 삭제하는 경우 각 호출에서 삭제되는 경로 수가 제한됩니다. 삭제할 경로 수가 이 제한을 초과하면 연속 토큰이 반환됩니다. 연속 토큰이 반환되면 디렉터리를 계속 삭제하려면 삭제 작업의 후속 호출에서 지정해야 합니다.

--recursive

"true"이면 디렉터리 아래의 모든 경로가 삭제됩니다. "false"이고 디렉터리가 비어 있지 않으면 오류가 발생합니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

az storage blob directory download

로컬 파일 경로에 Blob을 다운로드합니다.

az storage blob directory download --container
                                   --destination-path
                                   --source-path
                                   [--account-key]
                                   [--account-name]
                                   [--auth-mode {key, login}]
                                   [--connection-string]
                                   [--recursive]
                                   [--sas-token]

예제

스토리지 Blob 디렉터리에서 단일 Blob을 다운로드합니다.

az storage blob directory download -c MyContainer --account-name MyStorageAccount -s "path/to/blob" -d "<local-path>"

스토리지 컨테이너에서 전체 디렉터리를 다운로드합니다.

az storage blob directory download -c MyContainer --account-name MyStorageAccount -s SourceDirectoryPath -d "<local-path>" --recursive

스토리지 Blob 디렉터리의 전체 하위 디렉터리를 다운로드합니다.

az storage blob directory download -c MyContainer --account-name MyStorageAccount -s "path/to/subdirectory" -d "<local-path>" --recursive

필수 매개 변수

--container -c

다운로드 원본 컨테이너입니다.

--destination-path -d

다운로드할 대상 로컬 디렉터리 경로입니다.

--source-path -s

다운로드 원본 디렉터리 경로입니다. 컨테이너에 대한 절대 경로여야 합니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--recursive -r

Blob을 재귀적으로 다운로드합니다. 사용하도록 설정하면 하위 디렉터리의 Blob을 포함한 모든 Blob이 다운로드됩니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

az storage blob directory exists

스토리지 컨테이너에 Blob 디렉터리가 있는지 확인합니다.

az storage blob directory exists --container-name
                                 --directory-path
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--connection-string]
                                 [--sas-token]
                                 [--snapshot]
                                 [--timeout]

예제

스토리지 컨테이너에 Blob 디렉터리가 있는지 확인합니다.

az storage blob directory exists -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

필수 매개 변수

--container-name -c

컨테이너 이름

--directory-path -d

디렉터리 경로 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--snapshot

스냅샷 매개 변수는 있는 경우 스냅샷을 지정하는 불투명 DateTime 값입니다.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

az storage blob directory list

스토리지 디렉터리에 Blob 및 Blob 하위 디렉터리를 나열합니다.

az storage blob directory list --container-name
                               --directory-path
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--delimiter]
                               [--include]
                               [--marker]
                               [--num-results]
                               [--prefix]
                               [--sas-token]
                               [--timeout]

예제

스토리지 디렉터리에 Blob 및 Blob 하위 디렉터리를 나열합니다.

az storage blob directory list -c MyContainer -d DestinationDirectoryPath --account-name MyStorageAccount

필수 매개 변수

--container-name -c

컨테이너 이름

--directory-path -d

디렉터리 경로 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--delimiter

요청에 이 매개 변수가 포함된 경우 작업은 이름이 구분 기호 문자의 모양까지 동일한 부분 문자열로 시작하는 모든 Blob에 대한 자리 표시자 역할을 하는 BlobPrefix 요소를 결과 목록에 반환합니다. 이 구분 기호는 단일 문자이거나 문자열일 수 있습니다.

--include

응답에 포함할 하나 이상의 추가 데이터 세트를 지정합니다.

기본값: mc
--marker

불투명 연속 토큰입니다. 이 값은 num_results 지정하고 해당 생성기가 결과 열거를 완료한 경우 이전 생성기 개체의 next_marker 필드에서 검색할 수 있습니다. 이 생성기를 지정하면 이전 생성기가 중지된 지점에서 결과를 반환하기 시작합니다.

--num-results

반환할 결과의 최대 수를 지정합니다. 모두 반환하려면 "*"를 입력합니다.

기본값: 5000
--prefix

이름이 지정한 접두사로 시작하는 Blob만 반환하도록 결과를 필터링합니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

az storage blob directory move

스토리지 디렉터리를 스토리지 컨테이너의 다른 스토리지 Blob 디렉터리로 이동합니다.

스토리지 디렉터리와 모든 콘텐츠(다른 디렉터리 또는 Blob을 포함할 수 있음)를 스토리지 컨테이너의 다른 스토리지 Blob 디렉터리로 이동합니다. 이 작업의 동작은 계층 구조 네임스페이스의 사용 여부에 따라 다릅니다. 그렇다면 이동 작업은 원자성이며 표식이 반환되지 않습니다. 그렇지 않으면 작업이 일괄 처리로 수행되고 연속 토큰이 반환될 수 있습니다.

az storage blob directory move --container-name
                               --destination-path
                               --source-path
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--lease-id]
                               [--move-mode {legacy, posix}]
                               [--sas-token]
                               [--source-if-match]
                               [--source-if-modified-since]
                               [--source-if-none-match]
                               [--source-if-unmodified-since]
                               [--source-lease-id]
                               [--timeout]

예제

스토리지 디렉터리를 스토리지 컨테이너의 다른 스토리지 Blob 디렉터리로 이동합니다.

az storage blob directory move -c MyContainer -d my-new-directory -s dir --account-name MyStorageAccount

스토리지 하위 디렉터리를 스토리지 컨테이너의 다른 스토리지 Blob 디렉터리로 이동합니다.

az storage blob directory move -c MyContainer -d my-new-directory -s dir/subdirectory --account-name MyStorageAccount

필수 매개 변수

--container-name -c

컨테이너 이름

--destination-path -d

대상 Blob 디렉터리 경로입니다. 디렉터리 또는 하위 디렉터리 이름(예: dir, dir/subdir)일 수 있습니다. 대상 경로가 있고 비어 있으면 원본이 대상 경로로 이동됩니다. 대상 경로가 없으면 원본에서 대상 경로를 만들고 덮어씁니다. 비어 있지 않은 경로에 대한 이동 작업을 제어하려면 --move 모드를 사용하여 동작을 확인할 수 있습니다.

--source-path -s

원본 Blob 디렉터리 경로입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

대상 directory_path 대한 임대 ID입니다. 대상 directory_path 활성 임대가 있어야 하며 임대 ID가 일치해야 합니다.

--move-mode

네임스페이스를 사용하는 경우에만 유효합니다. 이 매개 변수는 이동 작업의 동작을 결정합니다. 대상 디렉터리가 비어 있는 경우 두 모드 모두에 대해 대상 디렉터리를 덮어씁니다. 그러나 대상 디렉터리가 비어 있지 않으면 레거시 모드에서 이동 작업이 실패하고 posix 모드에서 원본 디렉터리가 대상 디렉터리로 이동됩니다.

허용되는 값: legacy, posix
기본값: posix
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--source-if-match

선택 사항입니다. ETag 값입니다. 원본의 ETag가 지정된 값과 일치하는 경우에만 이동 작업을 수행하도록 이 헤더를 지정합니다.

--source-if-modified-since

선택 사항입니다. 날짜 및 시간 값입니다. 지정된 날짜 및 시간 이후 원본이 수정된 경우에만 이동 작업을 수행하려면 이 헤더를 지정합니다.

--source-if-none-match

(선택 사항) ETag 값 또는 특수 와일드카드("*") 값입니다. 원본의 ETag가 지정된 값과 일치하지 않는 경우에만 이동 작업을 수행하도록 이 헤더를 지정합니다.

--source-if-unmodified-since

선택 사항입니다. 날짜 및 시간 값입니다. 지정된 날짜 및 시간 이후 원본이 수정되지 않은 경우에만 이동 작업을 수행하도록 이 헤더를 지정합니다.

--source-lease-id

(선택 사항) source_path 임대 ID입니다. source_path 활성 임대가 있어야 하며 임대 ID가 일치해야 합니다.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

az storage blob directory show

스토리지 컨테이너에 스토리지 Blob 디렉터리 속성을 표시합니다.

az storage blob directory show --container-name
                               --directory-path
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--if-match]
                               [--if-modified-since]
                               [--if-none-match]
                               [--if-unmodified-since]
                               [--lease-id]
                               [--sas-token]
                               [--timeout]

예제

스토리지 컨테이너에 스토리지 Blob 디렉터리 속성을 표시합니다.

az storage blob directory show -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

필수 매개 변수

--container-name -c

컨테이너 이름

--directory-path -d

디렉터리 경로 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--if-match

ETag 값 또는 와일드카드 문자(*)입니다. 리소스의 ETag가 지정된 값과 일치하는 경우에만 이 헤더를 지정하여 작업 수행을 수행합니다.

--if-modified-since

제공된 UTC 날짜/시간(Y-m-d'T'H:M'Z') 이후 수정된 경우에만 변경합니다.

--if-none-match

ETag 값 또는 와일드카드 문자(*)입니다. 이 헤더를 지정하여 리소스의 ETag가 지정된 값과 일치하지 않는 경우에만 작업을 수행합니다. 리소스가 없는 경우에만 작업을 수행하도록 와일드카드 문자(*)를 지정하고 해당 리소스가 존재하는 연산에 실패합니다.

--if-unmodified-since

제공된 UTC 날짜/시간(Y-m-d'T'H:M'Z') 이후 수정되지 않은 경우에만 변경합니다.

--lease-id

blob에 활성 임대가 포함된 경우 필수입니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

az storage blob directory upload

스토리지 Blob 디렉터리에 Blob 또는 하위 디렉터리를 업로드합니다.

az storage blob directory upload --container
                                 --destination-path
                                 --source
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--connection-string]
                                 [--recursive]
                                 [--sas-token]

예제

스토리지 Blob 디렉터리에 단일 Blob을 업로드합니다.

az storage blob directory upload -c MyContainer --account-name MyStorageAccount -s "path/to/file" -d directory

스토리지 Blob 디렉터리에 로컬 디렉터리를 업로드합니다.

az storage blob directory upload -c MyContainer --account-name MyStorageAccount -s "path/to/directory" -d directory --recursive

로컬 디렉터리의 파일 집합을 스토리지 Blob 디렉터리에 업로드합니다.

az storage blob directory upload -c MyContainer --account-name MyStorageAccount -s "path/to/file*" -d directory --recursive

필수 매개 변수

--container -c

업로드 대상 컨테이너입니다.

--destination-path -d

업로드 대상 디렉터리 경로입니다. 컨테이너에 대한 절대 경로여야 합니다. 지정된 대상 경로가 없으면 새 디렉터리 경로가 만들어집니다.

--source -s

업로드할 원본 파일 경로입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--recursive -r

Blob을 재귀적으로 업로드합니다. 사용하도록 설정하면 하위 디렉터리의 Blob을 포함한 모든 Blob이 업로드됩니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.