az storage blob

비정형 데이터(Blob)용 개체 스토리지를 관리합니다.

명령에 대해 --auth-mode, --account-key, --connection-string, --sas-token 중 하나를 지정하세요. 해당 환경 변수를 사용하여 인증 자격 증명(예: AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING 및 AZURE_STORAGE_SAS_TOKEN)을 저장할 수도 있습니다.

명령

az storage blob access

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

az storage blob access set

Blob의 액세스 제어 속성을 설정합니다.

az storage blob access show

Blob의 액세스 제어 속성을 표시합니다.

az storage blob access update

Blob의 액세스 제어 속성을 업데이트합니다.

az storage blob copy

Blob 복사 작업을 관리합니다. Blob의 상태를 확인하는 데 사용합니다 az storage blob show .

az storage blob copy cancel

진행 중인 복사 작업을 중단합니다.

az storage blob copy start

Blob을 비동기적으로 복사합니다. Blob의 상태를 확인하는 데 사용합니다 az storage blob show .

az storage blob copy start-batch

여러 Blob을 Blob 컨테이너에 복사합니다. Blob의 상태를 확인하는 데 사용합니다 az storage blob show .

az storage blob delete

삭제할 Blob 또는 스냅샷을 표시합니다.

az storage blob delete-batch

Blob 컨테이너에서 Blob을 재귀적으로 삭제합니다.

az storage blob directory

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

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 download

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

az storage blob download-batch

Blob 컨테이너에서 Blob을 재귀적으로 다운로드합니다.

az storage blob exists

컨테이너에 Blob이 있는지 확인합니다.

az storage blob filter

태그가 지정된 검색 식과 일치하는 모든 컨테이너에 Blob을 나열합니다.

az storage blob generate-sas

Blob에 대한 공유 액세스 서명을 생성합니다.

az storage blob immutability-policy

Blob 불변성 정책을 관리합니다.

az storage blob immutability-policy delete

Blob의 불변성 정책을 삭제합니다.

az storage blob immutability-policy set

Blob의 불변성 정책을 설정합니다.

az storage blob incremental-copy

Blob 증분 복사 작업을 관리합니다.

az storage blob incremental-copy cancel

보류 중인 copy_blob 작업을 중단하고 길이가 0인 대상 Blob과 전체 메타데이터를 남깁니다.

az storage blob incremental-copy start

Blob의 증분 복사본을 비동기적으로 복사합니다.

az storage blob lease

스토리지 Blob 임대를 관리합니다.

az storage blob lease acquire

새 임대를 요청합니다.

az storage blob lease break

컨테이너 또는 Blob에 활성 임대가 있는 경우 임대를 중단합니다.

az storage blob lease change

활성 임대의 임대 ID를 변경합니다.

az storage blob lease release

임대를 해제합니다.

az storage blob lease renew

임대를 갱신합니다.

az storage blob list

지정된 컨테이너에 Blob을 나열합니다.

az storage blob metadata

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

az storage blob metadata show

지정된 Blob 또는 스냅샷에 대한 모든 사용자 정의 메타데이터를 반환합니다.

az storage blob metadata update

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

az storage blob move

스토리지 컨테이너에서 Blob을 이동합니다.

az storage blob restore

지정된 Blob 범위에서 Blob을 복원합니다.

az storage blob rewrite

지정된 URL에서 Blob의 콘텐츠를 읽는 새 블록 Blob을 만듭니다.

az storage blob service-properties

스토리지 Blob 서비스 속성을 관리합니다.

az storage blob service-properties delete-policy

스토리지 Blob 삭제 정책 서비스 속성을 관리합니다.

az storage blob service-properties delete-policy show

스토리지 Blob 삭제 정책을 표시합니다.

az storage blob service-properties delete-policy update

스토리지 Blob 삭제 정책을 업데이트합니다.

az storage blob service-properties show

Azure 스토리지 분석 포함하여 스토리지 계정 Blob Service의 속성을 가져옵니다.

az storage blob service-properties update

스토리지 Blob 서비스 속성을 업데이트합니다.

az storage blob set-legal-hold

Blob 법적 보존을 설정합니다.

az storage blob set-tier

Blob에서 블록 또는 페이지 계층을 설정합니다.

az storage blob show

Blob의 세부 정보를 가져옵니다.

az storage blob snapshot

Blob의 스냅숏을 만듭니다.

az storage blob sync

Blob을 스토리지 Blob 컨테이너에 재귀적으로 동기화합니다.

az storage blob tag

Blob 태그를 관리합니다.

az storage blob tag list

Blob 또는 특정 Blob 버전 또는 스냅샷에서 태그를 가져옵니다.

az storage blob tag set

Blob 또는 특정 Blob 버전에서 태그를 설정하지만 스냅샷은 설정하지 않습니다.

az storage blob undelete

일시 삭제된 Blob 또는 스냅샷을 복원합니다.

az storage blob update

Blob의 시스템 속성을 설정합니다.

az storage blob upload

스토리지 Blob에 파일을 업로드합니다.

az storage blob upload-batch

로컬 디렉터리에서 Blob 컨테이너로 파일을 업로드합니다.

az storage blob url

Blob에 액세스할 URL을 만듭니다.

az storage blob delete

삭제할 Blob 또는 스냅샷을 표시합니다.

Blob은 가비지 수집 중에 나중에 삭제하기 위해 표시됩니다. Blob을 삭제하려면 모든 스냅샷도 삭제해야 합니다. 둘 다 동시에 제거할 수 있습니다.

az storage blob delete --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--connection-string]
                       [--delete-snapshots {include, only}]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--sas-token]
                       [--snapshot]
                       [--tags-condition]
                       [--timeout]

예제

Blob을 삭제합니다.

az storage blob delete -c mycontainer -n MyBlob

로그인 자격 증명을 사용하여 Blob을 삭제합니다.

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--delete-snapshots

blob에 연결된 스냅숏이 포함된 경우 필수입니다. 값은 다음과 같습니다. "only": Blob 스냅샷만 삭제합니다. "include": 모든 스냅샷과 함께 Blob을 삭제합니다.

허용되는 값: include, only
--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.

--snapshot

스냅샷 매개 변수는 불투명 DateTime 값으로, 있을 때 삭제할 Blob 스냅샷을 지정합니다.

--tags-condition

일치하는 값을 가진 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다.

--timeout

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

az storage blob delete-batch

Blob 컨테이너에서 Blob을 재귀적으로 삭제합니다.

az storage blob delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--delete-snapshots {include, only}]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

예제

10일 동안 수정되지 않은 컨테이너에서 ".py"로 끝나는 모든 Blob을 삭제합니다.

date=`date -d "10 days ago" '+%Y-%m-%dT%H:%MZ'`
az storage blob delete-batch -s mycontainer --account-name mystorageaccount --pattern *.py --if-unmodified-since $date --auth-mode login

"mycontainer"라는 컨테이너에서 "dir"이라는 디렉터리의 모든 Blob을 삭제합니다.

az storage blob delete-batch -s mycontainer --pattern dir/*

컨테이너에서 'cli-2018-xx-xx.txt' 또는 'cli-2019-xx-xx.txt' 형식의 Blob을 삭제합니다.

az storage blob delete-batch -s mycontainer --pattern cli-201[89]-??-??.txt

컨테이너에서 'cli-2018-xx-xx.txt' 및 'cli-2019-xx-xx.txt'을 제외한 'cli-201x-xx-xx.txt' 형식의 모든 Blob을 삭제합니다.

az storage blob delete-batch -s mycontainer --pattern cli-201[!89]-??-??.txt

필수 매개 변수

--source -s

파일을 삭제할 Blob 컨테이너입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--delete-snapshots

blob에 연결된 스냅숏이 포함된 경우 필수입니다.

허용되는 값: include, only
--dryrun

파일을 실제로 삭제하는 대신 수행할 작업의 요약을 표시합니다.

--if-match

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

--if-modified-since

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

--if-none-match

ETag 값 또는 와일드카드 문자(*)입니다.

--if-unmodified-since

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

--lease-id

Blob의 활성 임대 ID입니다.

--pattern

소스에서 파일 또는 Blob을 globbing하는 데 사용되는 패턴입니다. 지원되는 패턴은 '*', '?', '[seq]' 및 '[!seq]'입니다. 자세한 내용은 을 참조하세요 https://docs.python.org/3.7/library/fnmatch.html.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

az storage blob download

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

az storage blob download [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--end-range]
                         [--file]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--max-connections]
                         [--name]
                         [--no-progress]
                         [--open-mode]
                         [--overwrite {false, true}]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--tags-condition]
                         [--timeout]
                         [--validate-content]
                         [--version-id]

예제

Blob을 다운로드합니다.

az storage blob download -f /path/to/file -c mycontainer -n MyBlob

blob 콘텐츠를 stdout(파이프 지원)에 다운로드합니다.

az storage blob download -c mycontainer -n myblob --account-name mystorageaccount --account-key myaccountkey

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

사용되는 경우 SAS 토큰 및 스냅샷을 포함하여 Blob에 대한 전체 엔드포인트 URL입니다. 기본 엔드포인트이거나 현재 location_mode엔드포인트에 따라 보조 엔드포인트일 수 있습니다.

--connection-string

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

--container-name -c

컨테이너 이름

--end-range

Blob의 섹션을 다운로드하는 데 사용할 바이트 범위의 끝입니다. end_range 지정되면 start_range 제공해야 합니다. start_range 및 end_range 매개 변수는 포함됩니다. 예: start_range=0, end_range=511은 처음 512바이트의 Blob을 다운로드합니다.

--file -f

쓸 파일의 경로입니다. 지정하지 않으면 stdout이 사용되고 max_connections 1로 설정됩니다.

--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에 활성 임대가 포함된 경우 필수입니다.

--max-connections

다운로드할 병렬 연결 수입니다.

기본값: 2
--name -n

Blob 이름입니다.

--no-progress

명령에 대한 진행률 보고를 사용하지 않도록 설정하려면 이 플래그를 포함합니다.

--open-mode

파일을 열 때 사용할 모드입니다. open_mode 추가만 지정하면 병렬 다운로드가 방지됩니다. 따라서 이 open_mode 사용되는 경우 max_connections 1로 설정해야 합니다.

기본값: wb
--overwrite

지정한 경우 기존 파일을 덮어씁 수 있습니다. 기본값은 true입니다.

허용되는 값: false, true
기본값: 1
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--snapshot

스냅샷 매개 변수는 불투명 DateTime 값으로, 있을 때 검색할 Blob 스냅샷을 지정합니다.

--start-range

Blob 섹션을 다운로드하는 데 사용할 바이트 범위의 시작입니다. end_range 지정되지 않으면 start_range 이후의 모든 바이트가 다운로드됩니다. start_range 및 end_range 매개 변수는 포함됩니다. 예: start_range=0, end_range=511은 처음 512바이트의 Blob을 다운로드합니다.

--tags-condition

일치하는 값을 가진 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다.

--timeout

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

--validate-content

true이면 Blob의 각 청크에 대한 MD5 해시를 계산합니다. 스토리지 서비스는 전송된 해시와 함께 도착한 콘텐츠의 해시를 확인합니다. https(기본값)가 이미 유효성을 검사하므로 https 대신 http를 사용하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 이 MD5 해시는 blob에 저장되지 않습니다. 또한 사용하도록 설정하면 MD5 해시를 계산하려면 전체 블록을 버퍼링해야 하므로 메모리 효율적인 알고리즘이 사용되지 않습니다.

--version-id

선택적 Blob 버전 ID입니다. 이 매개 변수는 버전 관리가 설정된 계정에만 해당됩니다.

az storage blob download-batch

Blob 컨테이너에서 Blob을 재귀적으로 다운로드합니다.

az storage blob download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--overwrite {false, true}]
                               [--pattern]
                               [--sas-token]

예제

.py 끝나는 모든 Blob 다운로드

az storage blob download-batch -d . --pattern *.py -s mycontainer --account-name mystorageaccount --account-key 00000000

"mycontainer"라는 컨테이너에서 "dir"이라는 디렉터리의 모든 Blob을 다운로드합니다.

az storage blob download-batch -d . -s mycontainer --pattern dir/*

컨테이너의 'cli-2018-xx-xx.txt' 또는 'cli-2019-xx-xx.txt' 형식의 모든 Blob을 현재 경로로 다운로드합니다.

az storage blob download-batch -d . -s mycontainer --pattern cli-201[89]-??-??.txt

컨테이너의 'cli-2018-xx-xx.txt' 및 'cli-2019-xx-xx.txt' 형식을 제외한 'cli-201x-xx-xx.txt' 형식의 모든 Blob을 현재 경로로 다운로드합니다.

az storage blob download-batch -d . -s mycontainer --pattern cli-201[!89]-??-??.txt

필수 매개 변수

--destination -d

이 다운로드 작업의 기존 대상 폴더입니다.

--source -s

파일을 다운로드할 Blob 컨테이너입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--dryrun

파일을 실제로 다운로드하는 대신 수행할 작업의 요약을 표시합니다.

--max-connections

다운로드할 병렬 연결 수입니다.

기본값: 2
--no-progress

명령에 대한 진행률 보고를 사용하지 않도록 설정하려면 이 플래그를 포함합니다.

--overwrite

지정한 경우 기존 파일을 덮어씁 수 있습니다. 기본값은 false입니다.

허용되는 값: false, true
--pattern

소스에서 파일 또는 Blob을 globbing하는 데 사용되는 패턴입니다. 지원되는 패턴은 '*', '?', '[seq]' 및 '[!seq]'입니다. 자세한 내용은 을 참조하세요 https://docs.python.org/3.7/library/fnmatch.html.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

az storage blob exists

컨테이너에 Blob이 있는지 확인합니다.

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

예제

컨테이너에 Blob이 있는지 확인합니다. (자동 생성됨)

az storage blob exists --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--snapshot

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

--timeout

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

az storage blob filter

태그가 지정된 검색 식과 일치하는 모든 컨테이너에 Blob을 나열합니다.

Blob 필터링은 스토리지 계정 내의 모든 컨테이너에서 검색되지만 식 내에서 단일 컨테이너로 범위를 지정할 수 있습니다.

az storage blob filter --tag-filter
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--sas-token]

필수 매개 변수

--tag-filter

태그가 지정된 조건과 일치하는 Blob을 찾는 식입니다. 예: ""yourtagname"='firsttag' 및 "yourtagname2"='secondtag'" 컨테이너를 지정하려면 예를 들면 다음과 같습니다. "@container='containerName' 및 "Name"='C'".

선택적 매개 변수

--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.

az storage blob generate-sas

Blob에 대한 공유 액세스 서명을 생성합니다.

az storage blob generate-sas [--account-key]
                             [--account-name]
                             [--as-user]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--blob-url]
                             [--cache-control]
                             [--connection-string]
                             [--container-name]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--encryption-scope]
                             [--expiry]
                             [--full-uri]
                             [--https-only]
                             [--ip]
                             [--name]
                             [--permissions]
                             [--policy-name]
                             [--snapshot]
                             [--start]
                             [--timeout]

예제

읽기 전용 권한이 있는 Blob에 대한 sas 토큰을 생성합니다.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

IP 범위가 지정된 Blob에 대한 sas 토큰을 생성합니다.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Blob에 대한 공유 액세스 서명을 생성합니다. (자동 생성됨)

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--as-user

이 명령은 사용자 위임 키로 서명된 SAS를 반환한다는 것을 나타냅니다. 이 인수를 지정하는 경우 만료 매개 변수 및 '--auth-mode login'이 필요합니다.

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

사용되는 경우 SAS 토큰 및 스냅샷을 포함하여 Blob에 대한 전체 엔드포인트 URL입니다. 이 엔드포인트는 기본 엔드포인트이거나 현재 location_mode엔드포인트에 따라 보조 엔드포인트일 수 있습니다.

--cache-control

이 공유 액세스 서명을 사용하여 리소스에 액세스할 때 Cache-Control 대한 응답 헤더 값입니다.

--connection-string

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

--container-name -c

컨테이너 이름

--content-disposition

이 공유 액세스 서명을 사용하여 리소스에 액세스할 때 Content-Disposition에 대한 응답 헤더 값입니다.

--content-encoding

이 공유 액세스 서명을 사용하여 리소스에 액세스할 때 Content-Encoding에 대한 응답 헤더 값입니다.

--content-language

이 공유 액세스 서명을 사용하여 리소스에 액세스할 때 Content-Language에 대한 응답 헤더 값입니다.

--content-type

이 공유 액세스 서명을 사용하여 리소스에 액세스할 때 Content-Type에 대한 응답 헤더 값입니다.

--encryption-scope

서비스의 데이터를 암호화하는 데 사용되는 미리 정의된 암호화 범위입니다.

--expiry

SAS가 유효하지 않은 UTC 날짜/시간(Y-m-d'T'H:M'Z')을 지정합니다. 저장된 액세스 정책이 이 값을 지정하는 --policy-name으로 참조되는 경우 사용하지 마세요.

--full-uri

이 명령은 전체 Blob URI 및 공유 액세스 서명 토큰을 반환한다는 것을 나타냅니다.

--https-only

HTTPS 프로토콜을 사용한 요청만 허용합니다. 생략하면 HTTP 및 HTTPS 프로토콜의 요청이 모두 허용됩니다.

--ip

요청을 수락할 IP 주소 또는 IP 주소 범위를 지정합니다. IPv4 스타일 주소만 지원합니다.

--name -n

Blob 이름입니다.

--permissions

SAS에서 부여하는 권한입니다. 허용되는 값: (a)dd (c)reate (d)elete (e)xecute (i)set_immutability_policy (m)ove (r)ead (t)ag (w)rite (x)delete_previous_version (y)permanent_delete. 저장된 액세스 정책이 이 값을 지정하는 --id로 참조되는 경우에는 사용하지 마세요. 결합할 수 있습니다.

--policy-name

컨테이너의 ACL 내에 저장된 액세스 정책의 이름입니다.

--snapshot

선택적 Blob 스냅샷 ID입니다. 불투명 DateTime 값으로, 있을 때 권한을 부여할 Blob 스냅샷을 지정합니다.

--start

SAS가 유효한 UTC 날짜/시간(Y-m-d'T'H:M'Z')을 지정합니다. 저장된 액세스 정책이 이 값을 지정하는 --policy-name으로 참조되는 경우 사용하지 마세요. 기본적으로 요청 시간으로 설정됩니다.

--timeout

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

az storage blob list

지정된 컨테이너에 Blob을 나열합니다.

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

예제

이름이 'foo'로 시작하는 컨테이너의 모든 스토리지 Blob을 나열합니다. 는 'foo', 'foobar', 'foo/bar'와 같은 이름과 일치합니다.

az storage blob list -c mycontainer --prefix foo

필수 매개 변수

--container-name -c

컨테이너 이름

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--delimiter

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

--include

응답에 포함할 하나 이상의 추가 데이터 세트를 지정합니다. 옵션은 다음과 같습니다: (c)opy, (d)eleted, (m)etadata, (s)napshots, (v)ersions, (t)ags, (i)mmutabilitypolicy, (l)egalhold, (d)eletedwithversions. 결합할 수 있습니다.

--marker

다음 목록 작업과 함께 반환될 컨테이너 목록의 부분을 식별하는 문자열 값입니다. 목록 작업이 현재 페이지와 함께 나열될 모든 컨테이너를 반환하지 않는 경우 작업은 응답 본문 내에서 NextMarker 값을 반환합니다. 이 생성기를 지정하면 이전 생성기가 중지된 지점에서 결과를 반환하기 시작합니다.

--num-results

반환할 최대 수를 지정합니다. 요청이 num_results 지정하지 않거나 5000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다. 목록 작업이 파티션 경계를 넘으면 서비스는 나머지 결과를 검색하기 위한 연속 토큰을 반환합니다. 모두 반환하려면 "*"를 입력합니다.

기본값: 5000
--prefix

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

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--show-next-marker

지정된 경우 결과에 nextMarker를 표시합니다.

--timeout

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

az storage blob move

스토리지 컨테이너에서 Blob을 이동합니다.

az storage blob move --container-name
                     --destination-blob
                     --source-blob
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--lease-id]
                     [--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 move -c MyContainer -d DestinationBlobPath -s SourceBlobPath --account-name MyStorageAccount

필수 매개 변수

--container-name -c

컨테이너 이름

--destination-blob -d

대상 Blob 이름입니다. 컨테이너 아래의 절대 경로여야 합니다. 예: 'topdir1/dirbar'.

--source-blob -s

원본 Blob 이름입니다. 컨테이너 아래의 절대 경로여야 합니다. 예: 'topdir1/dirsubfoo'.

선택적 매개 변수

--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

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

--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 restore

지정된 Blob 범위에서 Blob을 복원합니다.

az storage blob restore --account-name
                        --time-to-restore
                        [--blob-range]
                        [--no-wait]
                        [--resource-group]

예제

지정된 두 Blob 범위에서 Blob을 복원합니다. 예를 들어(container1/blob1, container2/blob2) 및 (container2/blob3.) container2/blob4).

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r container1/blob1 container2/blob2 -r container2/blob3 container2/blob4

계정 시작부터 계정 끝까지 지정된 Blob 범위의 Blob을 복원합니다.

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r "" ""

지정된 Blob 범위에서 Blob을 복원합니다.

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2

대기하지 않고 지정된 Blob 범위에서 Blob을 복원하고 'az storage account show'를 사용하여 Blob 복원 상태를 쿼리합니다.

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2 --no-wait

필수 매개 변수

--account-name -n

스토리지 계정 이름입니다.

--time-to-restore -t

지정된 시간으로 Blob을 복원합니다. 이 시간은 UTC 날짜/시간(Y-m-d'T'H:M:S'Z')이어야 합니다.

선택적 매개 변수

--blob-range -r

복원할 Blob 범위입니다. 각 Blob 범위에 대해 start_range 및 end_range 지정하려면 두 개의 값(예: -r blob1 blob2)이 필요합니다. 참고: 비어 있는 것은 계정이 시작 범위 값으로 시작되고 끝 범위에 대한 계정 끝을 의미합니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az storage blob rewrite

지정된 URL에서 Blob의 콘텐츠를 읽는 새 블록 Blob을 만듭니다.

기존 Blob의 콘텐츠를 새 Blob으로 덮어씁니다.

az storage blob rewrite --container-name
                        --name
                        --source-uri
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--encryption-scope]
                        [--if-match]
                        [--if-modified-since]
                        [--if-none-match]
                        [--if-unmodified-since]
                        [--lease-id]
                        [--sas-token]
                        [--tags-condition]
                        [--tier {Archive, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80}]
                        [--timeout]

예제

기존 Blob에 대한 암호화 범위를 업데이트합니다.

az storage blob rewrite --source-uri https://srcaccount.blob.core.windows.net/mycontainer/myblob?<sastoken> --encryption-scope newscope -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

--source-uri -u

파일 또는 Blob을 지정하는 최대 2KB 길이의 URL입니다. 값은 요청 URI에 표시되므로 URL 인코딩해야 합니다. 원본이 다른 계정에 있는 경우 원본은 공용이거나 공유 액세스 서명을 통해 인증되어야 합니다. 원본이 공용인 경우 인증이 필요하지 않습니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--encryption-scope

서비스의 데이터를 암호화하는 데 사용되는 미리 정의된 암호화 범위입니다. 암호화 범위는 관리 API를 사용하여 만들 수 있으며 여기에서 이름으로 참조할 수 있습니다. 컨테이너에서 기본 암호화 범위가 정의된 경우 컨테이너 수준 범위가 재정의를 허용하도록 구성된 경우 이 값이 재정의됩니다. 그렇지 않으면 오류가 발생합니다.

--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에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체 또는 임대 ID를 문자열로 사용할 수 있습니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

일치하는 값을 가진 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다.

--tier

Blob을 설정할 표준 Blob 계층 값입니다. 이 버전의 라이브러리의 경우 표준 스토리지 계정의 블록 Blob에만 적용됩니다.

허용되는 값: Archive, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80
--timeout

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

Blob 법적 보존을 설정합니다.

az storage blob set-legal-hold --container-name
                               --legal-hold {false, true}
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--sas-token]
                               [--timeout]

Blob 법적 보존을 구성합니다.

az storage blob set-legal-hold --legal-hold -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Blob 법적 보존을 지웁 수 있습니다.

az storage blob set-legal-hold --legal-hold false -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
--container-name -c

컨테이너 이름

--legal-hold

Blob에 법적 보존을 설정해야 하는지 지정합니다.

허용되는 값: false, true
--name -n

Blob 이름입니다.

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

az storage blob set-tier

Blob에서 블록 또는 페이지 계층을 설정합니다.

블록 Blob의 경우 이 명령은 표준 스토리지 계정의 블록 Blob만 지원합니다. 페이지 Blob의 경우 이 명령은 프리미엄 계정의 페이지 Blob만 지원합니다.

az storage blob set-tier --container-name
                         --name
                         --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--connection-string]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--timeout]
                         [--type {block, page}]

예제

Blob에서 블록 또는 페이지 계층을 설정합니다. (자동 생성됨)

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

--tier

Blob을 설정할 계층 값입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--rehydrate-priority -r

보관된 Blob을 리하드할 우선 순위를 나타냅니다. 우선 순위는 Blob에서 한 번만 설정할 수 있으며 기본값은 Standard입니다.

허용되는 값: High, Standard
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

시간 초과 매개 변수는 초 단위로 표현됩니다. 이 메서드는 Azure 서비스를 여러 번 호출할 수 있으며 시간 제한은 각 호출에 개별적으로 적용됩니다.

--type -t

blob 유형입니다.

허용되는 값: block, page
기본값: block

az storage blob show

Blob의 세부 정보를 가져옵니다.

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

예제

Blob의 모든 속성을 표시합니다.

az storage blob show -c mycontainer -n MyBlob

Blob의 세부 정보 가져오기(자동 생성됨)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--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.

--snapshot

스냅샷 매개 변수는 불투명한 DateTime 값으로, 있는 경우 검색할 Blob 스냅샷을 지정합니다.

--tags-condition

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다.

--timeout

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

az storage blob snapshot

Blob의 스냅숏을 만듭니다.

스냅샷은 특정 시점에 생성된 Blob의 읽기 전용 버전입니다. 읽기, 복사 또는 삭제할 수 있지만 수정할 수는 없습니다. 스냅샷을 사용하면 특정 시점에서 표시된 대로 Blob을 백업할 수 있습니다. Blob의 스냅샷은 스냅샷이 생성되는 기본 Blob과 이름이 같으며 스냅샷이 생성된 시간을 나타내는 DateTime 값이 추가됩니다.

az storage blob snapshot --container-name
                         --name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--connection-string]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--metadata]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--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에 활성 임대가 포함된 경우 필수입니다.

--metadata

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

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다.

--timeout

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

az storage blob sync

Blob을 스토리지 Blob 컨테이너에 재귀적으로 동기화합니다.

az storage blob sync --container
                     --source
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--delete-destination {false, prompt, true}]
                     [--destination]
                     [--exclude-path]
                     [--exclude-pattern]
                     [--include-pattern]
                     [--sas-token]

예제

단일 Blob을 컨테이너에 동기화합니다.

az storage blob sync -c mycontainer -s "path/to/file" -d NewBlob

컨테이너에 디렉터리를 동기화합니다.

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory"

필수 매개 변수

--container -c

동기화 대상 컨테이너입니다.

--source -s

동기화할 원본 파일 경로입니다.

선택적 매개 변수

--account-key

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

--account-name

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

--connection-string

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

--delete-destination

원본에 없는 대상에서 추가 파일을 삭제할지 여부를 정의합니다. true, false 또는 prompt로 설정할 수 있습니다. prompt로 설정하면 삭제할 파일 및 Blob을 예약하기 전에 사용자에게 질문이 표시됩니다.

허용되는 값: false, prompt, true
기본값: true
--destination -d

Blob 이름 앞에 추가될 대상 경로입니다.

--exclude-path

이러한 경로를 제외합니다. 이 옵션은 와일드카드 문자(*)를 지원하지 않습니다. 상대 경로 접두사를 확인하세요. 예: myFolder;myFolder/subDirName/file.pdf.

--exclude-pattern

이름이 패턴 목록과 일치하는 경우 이러한 파일을 제외합니다. 예: *.jpg;*.pdf;exactName. 이 옵션은 와일드카드 문자(*)를 지원합니다.

--include-pattern

이름이 패턴 목록과 일치하는 이러한 파일만 포함합니다. 예: *.jpg;*.pdf;exactName. 이 옵션은 와일드카드 문자(*)를 지원합니다.

--sas-token

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

az storage blob undelete

일시 삭제된 Blob 또는 스냅샷을 복원합니다.

삭제 보존 정책에 설정된 지정된 일 수 내에 사용되는 경우에만 작업이 성공합니다. 일시 삭제되지 않은 Blob 또는 스냅샷의 삭제를 취소하려고 하면 아무 변경도 없이 성공합니다.

az storage blob undelete --container-name
                         --name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--connection-string]
                         [--sas-token]
                         [--timeout]

예제

Blob 삭제를 취소합니다.

az storage blob undelete -c mycontainer -n MyBlob

로그인 자격 증명을 사용하여 Blob 삭제를 취소합니다.

az storage blob undelete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

az storage blob update

Blob의 시스템 속성을 설정합니다.

content_settings 대해 하나의 속성이 설정된 경우 모든 속성이 재정의됩니다.

az storage blob update --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--sas-token]
                       [--tags-condition]
                       [--timeout]

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--clear-content-settings

이 플래그가 설정된 경우 다음 속성(--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-md5, --content-type)이 하나 이상 설정되면 이러한 모든 속성이 함께 설정됩니다. 아래에 나열된 속성 중 하나 이상이 설정된 경우 지정된 속성에 대한 값이 제공되지 않으면 해당 속성이 지워집니다.

허용되는 값: false, true
--connection-string

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

--content-cache --content-cache-control

캐시 제어 문자열입니다.

--content-disposition

응답 페이로드를 처리하는 방법에 대한 추가 정보를 전달하며 추가 메타데이터를 연결하는 데 사용할 수도 있습니다.

--content-encoding

콘텐츠 인코딩 형식입니다.

--content-language

콘텐츠 언어입니다.

--content-md5

콘텐츠의 MD5 해시입니다.

--content-type

콘텐츠 MIME 형식입니다.

--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.

--tags-condition

일치하는 값을 가진 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다.

--timeout

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

az storage blob upload

스토리지 Blob에 파일을 업로드합니다.

파일 경로에서 새 Blob을 만들거나 자동 청크 및 진행률 알림을 사용하여 기존 Blob의 콘텐츠를 업데이트합니다.

az storage blob upload [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--data]
                       [--encryption-scope]
                       [--file]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--length]
                       [--max-connections]
                       [--maxsize-condition]
                       [--metadata]
                       [--name]
                       [--no-progress]
                       [--overwrite {false, true}]
                       [--sas-token]
                       [--socket-timeout]
                       [--tags]
                       [--tags-condition]
                       [--tier]
                       [--timeout]
                       [--type {append, block, page}]
                       [--validate-content]

예제

Blob에 업로드합니다.

az storage blob upload -f /path/to/file -c mycontainer -n MyBlob

Blob sas URL을 사용하여 Blob에 업로드합니다.

az storage blob upload -f /path/to/file --blob-url https://mystorageaccount.blob.core.windows.net/mycontainer/myblob?sv=2019-02-02&st=2020-12-22T07%3A07%3A29Z&se=2020-12-23T07%3A07%3A29Z&sr=b&sp=racw&sig=redacted

스토리지 Blob에 파일을 업로드합니다. (자동 생성됨)

az storage blob upload --account-name mystorageaccount --account-key 0000-0000 --container-name mycontainer --file /path/to/file --name myblob

Blob에 문자열을 업로드합니다.

az storage blob upload --data "teststring" -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

통과 파이프에 업로드합니다.

echo $data | az storage blob upload --data @- -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

사용되는 경우 SAS 토큰 및 스냅샷을 포함하여 Blob에 대한 전체 엔드포인트 URL입니다. 기본 엔드포인트이거나 현재 location_mode엔드포인트에 따라 보조 엔드포인트일 수 있습니다.

--connection-string

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

--container-name -c

컨테이너 이름

--content-cache --content-cache-control

캐시 제어 문자열입니다.

--content-disposition

응답 페이로드를 처리하는 방법에 대한 추가 정보를 전달하며 추가 메타데이터를 연결하는 데 사용할 수도 있습니다.

--content-encoding

콘텐츠 인코딩 형식입니다.

--content-language

콘텐츠 언어입니다.

--content-md5

콘텐츠의 MD5 해시입니다.

--content-type

콘텐츠 MIME 형식입니다.

--data

업로드할 Blob 데이터입니다.

--encryption-scope

서비스의 데이터를 암호화하는 데 사용되는 미리 정의된 암호화 범위입니다.

--file -f

Blob 콘텐츠로 업로드할 파일의 경로입니다.

--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에 활성 임대가 포함된 경우 필수입니다.

--length

스트림에서 읽을 바이트 수입니다. 선택 사항이지만 최적의 성능을 위해 제공해야 합니다. --data와 협력합니다.

--max-connections

Blob 크기가 64MB를 초과할 때 사용할 최대 병렬 연결 수입니다.

기본값: 2
--maxsize-condition

추가 Blob에 허용되는 최대 길이(바이트)입니다.

--metadata

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

--name -n

Blob 이름입니다.

--no-progress

명령에 대한 진행률 보고를 사용하지 않도록 설정하려면 이 플래그를 포함합니다.

--overwrite

업로드할 Blob이 현재 데이터를 덮어쓸지 여부입니다. True이면 Blob 업로드 작업이 기존 데이터를 덮어씁 수 있습니다. False로 설정하면 ResourceExistsError로 작업이 실패합니다. 위의 예외는 추가 Blob 형식입니다. False로 설정되고 데이터가 이미 있는 경우 오류가 발생하지 않고 데이터가 기존 Blob에 추가됩니다. overwrite=True로 설정하면 기존 추가 Blob이 삭제되고 새 Blob이 만들어집니다. 기본값은 False입니다.

허용되는 값: false, true
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--socket-timeout

서비스에서 데이터 흐름을 제어하는 데 사용하는 소켓 시간 제한(초)입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--tags-condition

일치하는 값을 가진 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다.

--tier

Blob을 설정할 계층 값입니다. 페이지 Blob의 경우 계층은 Blob의 크기 및 허용되는 IOPS 수와 상관 관계가 있습니다. 가능한 값은 P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80이며 Premium Storage 계정의 페이지 Blob에만 적용됩니다. 블록 Blob의 경우 가능한 값은 보관, 쿨 및 핫입니다. 표준 스토리지 계정의 블록 Blob에만 적용됩니다.

--timeout

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

--type -t

*.vhd 파일의 경우 기본값이 'page'이고, 그렇지 않으면 'block'입니다.

허용되는 값: append, block, page
--validate-content

BLOB의 각 청크에 대해 MD5 해시를 계산하고 청크가 도착했을 때 서비스에서 확인되도록 지정합니다.

az storage blob upload-batch

로컬 디렉터리에서 Blob 컨테이너로 파일을 업로드합니다.

az storage blob upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--max-connections]
                             [--maxsize-condition]
                             [--metadata]
                             [--no-progress]
                             [--overwrite {false, true}]
                             [--pattern]
                             [--sas-token]
                             [--socket-timeout]
                             [--tags-condition]
                             [--tier]
                             [--timeout]
                             [--type {append, block, page}]
                             [--validate-content]

예제

Blob이 존재하고 지정된 날짜 이후에 수정되지 않는 한 .py 끝나는 모든 파일을 업로드합니다.

az storage blob upload-batch -d mycontainer --account-name mystorageaccount --account-key 00000000 -s <path-to-directory> --pattern *.py --if-unmodified-since 2018-08-27T20:51Z

로컬 경로 디렉터리의 모든 파일을 "mycontainer"라는 컨테이너에 업로드합니다.

az storage blob upload-batch -d mycontainer -s <path-to-directory>

로컬 경로 디렉터리에서 'cli-2018-xx-xx.txt' 또는 'cli-2019-xx-xx.txt' 형식의 모든 파일을 업로드합니다.

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern cli-201[89]-??-??.txt

컨테이너에서 'cli-2018-xx-xx.txt' 및 'cli-2019-xx-xx.txt'을 제외한 'cli-201x-xx-xx.txt' 형식의 모든 파일을 업로드합니다.

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern cli-201[!89]-??-??.txt

필수 매개 변수

--destination -d

파일을 업로드할 Blob 컨테이너입니다.

--source -s

업로드할 파일이 있는 디렉터리입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--content-cache --content-cache-control

캐시 제어 문자열입니다.

--content-disposition

응답 페이로드를 처리하는 방법에 대한 추가 정보를 전달하며 추가 메타데이터를 연결하는 데 사용할 수도 있습니다.

--content-encoding

콘텐츠 인코딩 형식입니다.

--content-language

콘텐츠 언어입니다.

--content-md5

콘텐츠의 MD5 해시입니다.

--content-type

콘텐츠 MIME 형식입니다.

--destination-path

Blob 이름 앞에 추가될 대상 경로입니다.

--dryrun

파일을 실제로 업로드하는 대신 수행할 작업의 요약을 표시합니다.

--if-match

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

--if-modified-since

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

--if-none-match

ETag 값 또는 와일드카드 문자(*)입니다.

--if-unmodified-since

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

--lease-id

Blob의 활성 임대 ID입니다.

--max-connections

Blob 크기가 64MB를 초과할 때 사용할 최대 병렬 연결 수입니다.

기본값: 2
--maxsize-condition

추가 Blob에 허용되는 최대 길이(바이트)입니다.

--metadata

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

--no-progress

명령에 대한 진행률 보고를 사용하지 않도록 설정하려면 이 플래그를 포함합니다.

--overwrite

업로드할 Blob이 현재 데이터를 덮어쓸지 여부입니다. True이면 Blob 업로드 작업이 기존 데이터를 덮어씁 수 있습니다. False로 설정하면 ResourceExistsError로 작업이 실패합니다. 위의 예외는 추가 Blob 형식입니다. False로 설정되고 데이터가 이미 있는 경우 오류가 발생하지 않고 데이터가 기존 Blob에 추가됩니다. overwrite=True로 설정하면 기존 추가 Blob이 삭제되고 새 Blob이 만들어집니다. 기본값은 False입니다.

허용되는 값: false, true
--pattern

소스에서 파일 또는 Blob을 globbing하는 데 사용되는 패턴입니다. 지원되는 패턴은 '*', '?', '[seq]' 및 '[!seq]'입니다. 자세한 내용은 을 참조하세요 https://docs.python.org/3.7/library/fnmatch.html.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--socket-timeout

서비스에서 데이터 흐름을 제어하는 데 사용하는 소켓 시간 제한(초)입니다.

--tags-condition

일치하는 값을 가진 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다.

--tier

Blob을 설정할 계층 값입니다. 페이지 Blob의 경우 계층은 Blob의 크기 및 허용되는 IOPS 수와 상관 관계가 있습니다. 가능한 값은 P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80이며 Premium Storage 계정의 페이지 Blob에만 적용됩니다. 블록 Blob의 경우 가능한 값은 보관, 쿨 및 핫입니다. 표준 스토리지 계정의 블록 Blob에만 적용됩니다.

--timeout

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

--type -t

*.vhd 파일의 경우 기본값이 'page'이고, 그렇지 않으면 'block'입니다. 설정은 모든 파일에 대한 Blob 형식을 재정의합니다.

허용되는 값: append, block, page
--validate-content

BLOB의 각 청크에 대해 MD5 해시를 계산하고 청크가 도착했을 때 서비스에서 확인되도록 지정합니다.

az storage blob url

Blob에 액세스할 URL을 만듭니다.

az storage blob url --container-name
                    --name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--blob-endpoint]
                    [--connection-string]
                    [--protocol {http, https}]
                    [--sas-token]
                    [--snapshot]

예제

Blob에 액세스하는 URL 만들기(자동 생성됨)

az storage blob url --connection-string $connectionString --container-name container1 --name blob1

Blob에 액세스하는 URL 만들기(자동 생성됨)

az storage blob url --account-name storageacct --account-key 00000000 --container-name container1 --name blob1

필수 매개 변수

--container-name -c

컨테이너 이름

--name -n

Blob 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

허용되는 값: key, login
--blob-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

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

--protocol

사용할 프로토콜입니다.

허용되는 값: http, https
기본값: https
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--snapshot

스냅샷을 고유하게 식별하는 문자열 값입니다. 이 쿼리 매개 변수의 값은 스냅샷 버전을 나타냅니다.