BlockBlobService 클래스

블록 Blob를 사용하면 대용량 Blob를 효율적으로 업로드할 수 있습니다. 블록 Blob는 블록으로 구성되며, 각 블록은 블록 ID로 식별됩니다. 블록 집합을 쓴 다음 블록 ID로 커밋하여 블록 Blob를 만들거나 수정합니다. 각 블록의 크기는 최대 100MB까지 다를 수 있으며 블록 Blob에는 최대 50,000개의 블록이 포함될 수 있습니다. 따라서 블록 Blob의 최대 크기는 약 4.75TB(100MB X 50,000개 블록)입니다. 크기가 64MB 이하인 블록 Blob을 작성하는 경우 단일 쓰기 작업으로 전체 블록 Blob을 업로드할 수 있습니다. create_blob_from_bytes 참조하세요.

:type ~azure.storage.common.TokenCredential

상속

BaseBlobService

BlockBlobService

생성자

BlockBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)

매개 변수

account_name

str

기본값: None

스토리지 계정 이름입니다. 계정 키로 서명된 요청을 인증하고 스토리지 엔드포인트를 생성하는 데 사용됩니다. 연결 문자열 지정하지 않거나 사용자 지정 도메인이 익명 인증과 함께 사용되는 경우 필요합니다.

account_key

str

기본값: None

스토리지 계정 키입니다. 공유 키 인증에 사용됩니다. 계정 키 또는 sas 토큰을 지정하지 않으면 익명 액세스가 사용됩니다.

sas_token

str

기본값: None

계정 키 대신 요청을 인증하는 데 사용할 공유 액세스 서명 토큰입니다. 계정 키와 sas 토큰이 모두 지정된 경우 계정 키를 사용하여 서명합니다. 둘 다 지정하지 않으면 익명 액세스가 사용됩니다.

is_emulated

bool

기본값: False

에뮬레이터를 사용할지 여부입니다. 기본값은 False입니다. 지정된 경우 는 연결 문자열 및 요청 세션 외에 다른 모든 매개 변수를 재정의합니다.

protocol

str

기본값: https

요청에 사용할 프로토콜입니다. 기본값은 https입니다.

endpoint_suffix

str

기본값: core.windows.net

URL의 호스트 기본 구성 요소에서 계정 이름을 뺀 값입니다. 기본값은 Azure(core.windows.net)입니다. 중국 클라우드(core.chinacloudapi.cn)를 사용하도록 재정의합니다.

custom_domain

str

기본값: None

사용할 사용자 지정 도메인입니다. Azure Portal에서 설정할 수 있습니다. 예를 들어 'www.mydomain.com'입니다.

request_session

<xref:requests.Session>

기본값: None

http 요청에 사용할 세션 개체입니다.

connection_string

str

기본값: None

지정된 경우 요청 세션 외에 다른 모든 매개 변수를 재정의합니다. 연결 문자열 형식은 를 참조하세요http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/.

socket_timeout

int

기본값: None

지정된 경우 기본 소켓 시간 제한을 재정의합니다. 지정된 시간 제한(초)입니다. 기본값은 _constants.py DEFAULT_SOCKET_TIMEOUT 참조하세요.

token_credential

기본값: None

HTTPS 요청을 인증하는 데 사용되는 토큰 자격 증명입니다. 토큰 값은 만료 전에 업데이트해야 합니다.

변수

MAX_SINGLE_PUT_SIZE

int

단일 배치 호출에서 지원되는 가장 큰 크기 업로드입니다. 콘텐츠 길이가 알려져 있고 이 값보다 작은 경우 create_blob_from_* 메서드에서 사용됩니다.

MAX_BLOCK_SIZE

int

콘텐츠 길이가 알 수 없거나 MAX_SINGLE_PUT_SIZE보다 큰 경우 create_blob_from_* 메서드에 의해 배치된 블록의 크기입니다. 더 작은 블록을 넣을 수 있습니다. 서비스에서 지원하는 최대 블록 크기는 100MB입니다.

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

int

메모리 최적화 블록 업로드 알고리즘이 고려되는 최소 블록 크기입니다. 이 알고리즘은 create_blob_from_file 및 create_blob_from_stream 메서드에만 적용되며 블록의 전체 버퍼링을 방지합니다. 블록 크기 외에도 이러한 옵션을 사용하려면 블록을 버퍼링해야 하므로 ContentMD5 유효성 검사 및 암호화를 사용하지 않도록 설정해야 합니다.

메서드

abort_copy_blob	보류 중인 copy_blob 작업을 중단하고 길이가 0이고 메타데이터가 가득 찬 대상 Blob을 남깁니다.
acquire_blob_lease	새로운 임대를 요청합니다. blob에 활성 임대가 없으면, Blob 서비스가 blob에 대한 임대를 만들고 새로운 임대 ID를 반환합니다.
acquire_container_lease	새로운 임대를 요청합니다. 컨테이너에 활성 임대가 없으면, Blob 서비스가 컨테이너에 대한 임대를 만들고 새로운 임대 ID를 반환합니다.
batch_delete_blobs	여러 Blob 삭제 요청의 일괄 처리를 보냅니다. Blob delete 메서드는 지정된 Blob 또는 스냅샷 삭제합니다. Blob을 삭제하면 모든 스냅샷도 삭제됩니다. 자세한 내용은 https://docs.microsoft.com/rest/api/storageservices/delete-blob을 참조하세요.
batch_set_standard_blob_tier	여러 집합 블록 Blob 계층 요청의 일괄 처리를 보냅니다. 이 API는 표준 스토리지 계정의 블록 Blob에 대해서만 지원됩니다.
break_blob_lease	blob에 활성 임대가 포함된 경우 임대를 중단합니다. 임대가 중단되면 갱신할 수 없습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 중단되면 임대 중단 기간이 경과할 수 있으며, 이 기간 동안 Blob에서 중단 및 해제를 제외한 임대 작업을 수행할 수 없습니다. 임대가 성공적으로 중단되면 새로운 임대를 획득하기 위해 기다려야 하는 기간(초)이 응답에 표시됩니다. 중단된 임대도 해제할 수 있으며, 이 경우 다른 클라이언트가 해당 blob에 대한 임대를 즉시 획득할 수 있습니다.
break_container_lease	컨테이너에 활성 임대가 포함된 경우 임대를 중단합니다. 임대가 중단되면 갱신할 수 없습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 중단되면 임대 중단 기간이 경과할 수 있으며, 이 기간 동안 컨테이너에서 중단 및 해제를 제외한 임대 작업을 수행할 수 없습니다. 임대가 성공적으로 중단되면 새로운 임대를 획득하기 위해 기다려야 하는 기간(초)이 응답에 표시됩니다.
change_blob_lease	활성 임대의 임대 ID를 변경합니다. 변경 내용에는 현재 임대 ID와 새 임대 ID가 포함되어야 합니다.
change_container_lease	활성 임대의 임대 ID를 변경합니다. 변경 내용에는 현재 임대 ID와 새 임대 ID가 포함되어야 합니다.
copy_blob	Blob을 복사합니다. 이 작업은 복사 작업 속성 개체를 반환합니다. 복사 작업은 비동기, 최적 작업 또는 동기 작업으로 구성될 수 있습니다. requires_sync true인 경우 원본은 블록 Blob이어야 합니다. 기존 대상 blob는 덮어씁니다. 복사 작업이 진행 중일 때는 대상 blob를 수정할 수 없습니다. 블록 Blob에서 복사할 때 커밋된 모든 블록과 해당 블록 ID가 복사됩니다. 커밋되지 않은 블록은 복사되지 않습니다. 복사 작업이 끝나면 대상 Blob은 원본과 동일한 커밋된 블록 수를 갖게 됩니다. 대상 Blob에서 get_blob_properties 호출하여 복사 작업의 상태 검사 수 있습니다. 복사가 완료되면 최종 blob가 커밋됩니다. 대상 컨테이너의 이름입니다. 컨테이너가 있어야 합니다. :p aram str blob_name: 대상 Blob의 이름입니다. 대상 Blob이 있으면 덮어씁니다. 그렇지 않으면 생성됩니다. :p aram str copy_source: Azure 파일 또는 Blob을 지정하는 최대 2KB의 URL입니다. 값은 요청 URI에 표시되므로 URL 인코딩해야 합니다. 원본이 다른 계정에 있는 경우 원본은 공용이거나 공유 액세스 서명을 통해 인증되어야 합니다. 원본이 공용인 경우 인증이 필요하지 않습니다. 예: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?스냅샷= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram 메타데이터: Blob과 연결된 이름-값 쌍을 메타데이터로 사용합니다. 이름-값 쌍이 지정되지 않은 경우 작업은 원본 Blob 또는 파일의 메타데이터를 대상 Blob으로 복사합니다. 하나 이상의 이름-값 쌍을 지정하면 대상 Blob이 지정된 메타데이터를 사용하여 만들어지고 메타데이터는 원본 Blob 또는 파일에서 복사되지 않습니다. :type 메타데이터: dict(str, str) :p aram datetime source_if_modified_since: DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 원본 blob가 수정된 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. :p aram datetime source_if_unmodified_since: DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 원본 blob가 수정되지 않은 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. :p aram ETag source_if_match: ETag 값 또는 와일드카드 문자()입니다. ETag가 지정된 값과 일치하는 경우에만 원본 Blob을 복사하려면 이 조건부 헤더를 지정합니다. ETag 값이 일치하지 않으면 Blob 서비스는 상태 코드 412(사전 조건 실패)를 반환합니다. 원본이 Azure 파일인 경우 이 헤더를 지정할 수 없습니다. :p aram ETag source_if_none_match: ETag 값 또는 와일드카드 문자()입니다. ETag가 지정된 값과 일치하지 않는 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. 값이 동일하면 Blob 서비스가 상태 코드 412(전제 조건 실패)를 반환합니다. 원본이 Azure 파일인 경우 이 헤더를 지정할 수 없습니다. :p aram datetime destination_if_modified_since: DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 대상 blob가 수정된 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. 대상 blob이 수정되지 않은 경우 Blob service가 상태 코드 412(전제 조건 실패)를 반환합니다. :p aram datetime destination_if_unmodified_since: DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 대상 blob가 수정되지 않은 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. 대상 blob가 수정된 경우 Blob 서비스가 상태 코드 412(전제 조건 실패)를 반환합니다. :p aram ETag destination_if_match: ETag 값 또는 와일드카드 문자()입니다. 지정된 ETag 값이 기존 대상 Blob의 ETag 값과 일치하는 경우에만 Blob을 복사하려면 이 조건부 헤더에 대한 ETag 값을 지정합니다. 대상 Blob의 ETag가 If-Match에 지정된 ETag와 일치하지 않으면 Blob 서비스는 상태 코드 412(사전 조건 실패)를 반환합니다. :p aram ETag destination_if_none_match: ETag 값 또는 와일드카드 문자()입니다. 지정된 ETag 값이 대상 blob의 ETag 값과 일치하지 않는 경우에만 blob를 복사하려면 이 조건부 헤더에 대한 ETag 값을 지정합니다. 대상 blob가 존재하지 않는 경우에만 작업을 수행하려면 와일드카드 문자(*)를 지정합니다. 지정된 조건이 충족되지 않으면 Blob 서비스가 상태 코드 412(전제 조건 실패)를 반환합니다. :p aram str destination_lease_id: 이 헤더에 지정된 임대 ID가 대상 Blob의 임대 ID와 일치해야 합니다. 요청에 임대 ID가 포함되지 않거나 유효하지 않은 경우, 작업이 실패하고 상태 코드 412(전제 조건 실패)가 표시됩니다. :p aram str source_lease_id: 지정된 임대 ID가 원본 Blob의 활성 임대 ID와 일치하는 경우에만 Blob 복사 작업을 수행하도록 지정합니다. :p aram int 시간 제한: 시간 제한 매개 변수는 초 단위로 표시됩니다. :p aram bool requires_sync: 복사가 완료될 때까지 서비스에서 응답을 반환하지 않도록 적용합니다. :p aram StandardBlobTier standard_blob_tier: Blob을 설정할 표준 Blob 계층 값입니다. 이 버전의 라이브러리의 경우 표준 스토리지 계정의 블록 Blob에만 적용됩니다. :p aram RehydratePriority rehydrate_priority: 보관된 Blob :return: 복사 작업 속성(예: 상태, 원본 및 ID)을 리하이드레이션할 우선 순위를 나타냅니다. :rtype: CopyProperties
create_blob_from_bytes	바이트 배열에서 새 Blob을 만들거나 자동 청크 및 진행률 알림을 사용하여 기존 Blob의 콘텐츠를 업데이트합니다.
create_blob_from_path	파일 경로에서 새 Blob을 만들거나 자동 청크 및 진행률 알림을 사용하여 기존 Blob의 콘텐츠를 업데이트합니다.
create_blob_from_stream	파일/스트림에서 새 Blob을 만들거나 자동 청크 및 진행률 알림을 사용하여 기존 Blob의 콘텐츠를 업데이트합니다.
create_blob_from_text	str/unicode에서 새 Blob을 만들거나 자동 청크 및 진행률 알림을 사용하여 기존 Blob의 콘텐츠를 업데이트합니다.
create_container	지정된 계정 아래에 새 컨테이너를 만듭니다. 이름이 같은 컨테이너가 이미 있는 경우 fail_on_exist True이면 작업이 실패합니다.
delete_blob	삭제할 지정된 Blob 또는 스냅샷 표시합니다. 이 blob는 나중에 가비지 수집 중에 삭제됩니다. Blob을 삭제하려면 해당 스냅숏을 모두 삭제해야 합니다. Blob 삭제 작업과 동시에 둘 다 삭제할 수 있습니다. 서비스에 대해 삭제 보존 정책을 사용하도록 설정한 경우 이 작업은 Blob 또는 스냅샷 일시 삭제하고 지정된 일 수 동안 Blob 또는 스냅샷 유지합니다. 지정된 일 수가 지나면 가비지 수집 중에 Blob의 데이터가 서비스에서 제거됩니다. 일시 삭제된 Blob 또는 스냅샷 include=Include.Deleted 옵션을 지정하는 Blob 목록 API를 통해 액세스할 수 있습니다. 일시 삭제된 Blob 또는 스냅샷 삭제 취소 API를 사용하여 복원할 수 있습니다.
delete_container	삭제할 지정된 컨테이너를 표시합니다. 컨테이너 및 여기에 포함된 모든 blob는 나중에 가비지 수집 중에 삭제됩니다.
exists	컨테이너가 있는지(blob_name 없음인 경우) 또는 Blob이 있는지 여부를 나타내는 부울을 반환합니다.
extract_date_and_request_id
generate_account_shared_access_signature	Blob 서비스에 대한 공유 액세스 서명을 생성합니다. 반환된 서명을 BlobService의 sas_token 매개 변수와 함께 사용합니다.
generate_blob_shared_access_signature	Blob 또는 해당 스냅샷 중 하나에 대한 공유 액세스 서명을 생성합니다. 반환된 서명을 BlobService의 sas_token 매개 변수와 함께 사용합니다.
generate_container_shared_access_signature	컨테이너에 대한 공유 액세스 서명을 생성합니다. 반환된 서명을 BlobService의 sas_token 매개 변수와 함께 사용합니다.
get_blob_account_information	스토리지 계정과 관련된 정보를 가져옵니다. 사용자에게 컨테이너 또는 Blob에 대한 SAS가 있는 경우에도 정보를 검색할 수 있습니다.
get_blob_metadata	지정된 Blob 또는 스냅샷 대한 모든 사용자 정의 메타데이터를 반환합니다.
get_blob_properties	blob에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. blob의 콘텐츠는 반환하지 않습니다. BlobProperties 및 메타데이터 받아쓰기를 사용하여 를 반환 Blob 합니다.
get_blob_service_properties	Azure 스토리지 분석 포함하여 스토리지 계정 Blob 서비스의 속성을 가져옵니다.
get_blob_service_stats	Blob 서비스에 대한 복제와 관련된 통계를 검색합니다. 스토리지 계정에 대해 읽기 액세스 지역 중복 복제를 사용하도록 설정한 경우에만 사용할 수 있습니다. 지리적 중복 복제를 사용하여 Azure 저장소는 데이터를 두 위치에서 영구 유지 관리합니다. 두 위치 모두에서 Azure 저장소는 데이터에 대한 여러 정상 복제를 지속적으로 유지 관리합니다. 데이터를 읽거나 만들거나 업데이트하거나 삭제하는 위치는 주 저장소 계정 위치입니다. 기본 위치는 Azure Management Azure 클래식 포털(예: 미국 중북부)을 통해 계정을 만들 때 선택한 지역에 있습니다. 데이터가 복제되는 위치는 보조 위치입니다. 보조 위치는 기본 위치에 따라 자동으로 결정되며, 기본 위치와 동일한 지역에 있는 보조 데이터 센터입니다. 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우, 보조 위치에서 읽기 전용 액세스가 가능합니다.
get_blob_to_bytes	자동 청크 및 진행률 알림을 사용하여 Blob을 바이트 배열로 다운로드합니다. 속성, 메타데이터 및 콘텐츠를 사용하여 의 Blob instance 반환합니다.
get_blob_to_path	자동 청크 및 진행률 알림을 사용하여 Blob을 파일 경로에 다운로드합니다. 속성 및 메타데이터를 사용하여 의 Blob instance 반환합니다.
get_blob_to_stream	자동 청크 및 진행률 알림을 사용하여 Blob을 스트림에 다운로드합니다. 속성 및 메타데이터를 사용하여 의 Blob instance 반환합니다.
get_blob_to_text	자동 청크 및 진행률 알림을 사용하여 Blob을 유니코드 텍스트로 다운로드합니다. 속성, 메타데이터 및 콘텐츠를 사용하여 의 Blob instance 반환합니다.
get_block_list	블록 Blob의 일부로 업로드된 블록 목록을 검색합니다. blob에 대해 유지 관리되는 블록 목록은 다음 두 가지입니다. 커밋된 블록 목록: 블록 목록 배치를 사용하여 지정된 Blob에 성공적으로 커밋된 블록 목록입니다. 커밋되지 않은 블록 목록: Put Block을 사용하여 Blob에 대해 업로드되었지만 아직 커밋되지 않은 블록 목록입니다. 이러한 블록은 Azure에 blob와 연결되어 저장되지만 아직 해당 blob의 일부를 형성하지 않습니다.
get_container_acl	지정된 컨테이너에 대한 권한을 가져옵니다. 권한은 컨테이너 데이터에 공개적으로 액세스할 수 있는지 여부를 나타냅니다.
get_container_metadata	지정된 컨테이너에 대한 모든 사용자 정의 메타데이터를 반환합니다.
get_container_properties	지정된 컨테이너에 대한 모든 사용자 정의 메타데이터 및 시스템 속성을 반환합니다. 반환된 데이터에는 컨테이너의 블록 목록이 포함되지 않습니다.
get_user_delegation_key	SAS 토큰에 서명하기 위한 사용자 위임 키를 가져옵니다. 이 요청이 성공하려면 토큰 자격 증명이 서비스 개체에 있어야 합니다.
list_blob_names	지정된 컨테이너 아래에 Blob 이름을 나열하는 생성기를 반환합니다. 생성기는 서비스에서 반환된 연속 토큰을 느리게 따르고 모든 Blob이 반환되거나 num_results 도달하면 중지됩니다. num_results 지정되고 계정에 Blob 수가 그 이상인 경우 생성기는 완료되면 채워진 next_marker 필드를 갖습니다. 이 표식은 더 많은 결과가 필요한 경우 새 생성기를 만드는 데 사용할 수 있습니다.
list_blobs	지정된 컨테이너 아래의 Blob을 나열하는 생성기를 반환합니다. 생성기는 서비스에서 반환된 연속 토큰을 느리게 따르고 모든 Blob이 반환되거나 num_results 도달하면 중지됩니다. num_results 지정되고 계정에 Blob 수가 그 이상인 경우 생성기는 완료되면 채워진 next_marker 필드를 갖습니다. 이 표식은 더 많은 결과가 필요한 경우 새 생성기를 만드는 데 사용할 수 있습니다.
list_containers	지정된 계정 아래의 컨테이너를 나열하는 생성기를 반환합니다. 생성기는 서비스에서 반환된 연속 토큰을 느리게 따르고 모든 컨테이너가 반환되거나 num_results 도달하면 중지됩니다. num_results 지정되고 계정에 컨테이너 수가 그 이상인 경우 생성기는 완료되면 채워진 next_marker 필드를 갖게 됩니다. 이 표식은 더 많은 결과가 필요한 경우 새 생성기를 만드는 데 사용할 수 있습니다.
make_blob_url	Blob에 액세스할 URL을 만듭니다.
make_container_url	컨테이너에 액세스하는 URL을 만듭니다.
put_block	blob의 일부로 커밋할 새 블록을 만듭니다.
put_block_from_url	blob의 일부로 커밋할 새 블록을 만듭니다.
put_block_list	blob를 구성하는 블록 ID 목록을 지정하여 blob에 기록합니다. Blob의 일부로 작성하려면 블록이 이전 블록 배치 작업에서 서버에 성공적으로 기록되어야 합니다. 블록 목록 배치를 호출하여 변경된 블록만 업로드한 다음 새 블록과 기존 블록을 함께 커밋하여 Blob을 업데이트할 수 있습니다. 이렇게 하려면 커밋된 블록 목록에서 또는 커밋되지 않은 블록 목록에서 블록을 커밋하거나, 어느 목록에 포함되었더라도 가장 최근에 업로드된 블록 버전을 커밋할지를 지정하면 됩니다.
release_blob_lease	임대를 해제합니다. 요청에 지정된 임대 ID가 blob과 연결된 임대 ID와 일치할 경우 임대를 해제할 수 있습니다. 임대를 해제하면 해제가 완료되는 즉시 다른 클라이언트가 해당 blob에 대한 임대를 획득할 수 있습니다.
release_container_lease	임대를 해제합니다. 지정된 lease_id 컨테이너와 연결된 임대와 일치하는 경우 임대가 해제될 수 있습니다. 임대를 해제하면 해제가 완료되는 즉시 다른 클라이언트가 해당 컨테이너에 대한 임대를 획득할 수 있습니다.
renew_blob_lease	임대를 갱신합니다. 요청에 지정된 임대 ID가 blob과 연결된 임대 ID와 일치할 경우 임대를 갱신할 수 있습니다. 임대가 만료되었더라도 blob가 수정되지 않았거나 임대 만료 후 다시 임대되지 않은 경우에 한해 임대를 갱신할 수 있습니다. 임대를 갱신하면 임대 기간 시간이 재설정됩니다.
renew_container_lease	임대를 갱신합니다. 지정된 임대 ID가 컨테이너와 연결된 임대 ID와 일치하는 경우 임대를 갱신할 수 있습니다. 임대가 만료되었더라도 컨테이너가 임대 만료 후 다시 임대되지 않은 경우에 한해 임대를 갱신할 수 있습니다. 임대를 갱신하면 임대 기간 시간이 재설정됩니다.
set_blob_metadata	하나 이상의 이름 값 쌍으로 지정된 Blob에 대한 사용자 정의 메타데이터를 설정합니다.
set_blob_properties	Blob의 시스템 속성을 설정합니다. content_settings 대해 하나의 속성이 설정된 경우 모든 속성이 재정의됩니다.
set_blob_service_properties	Azure 스토리지 분석 포함하여 스토리지 계정 Blob 서비스의 속성을 설정합니다. 요소(예: 로깅)가 None으로 남아 있으면 해당 기능에 대한 서비스의 기존 설정이 유지됩니다.
set_container_acl	공유 액세스 서명과 함께 사용할 수 있는 지정된 컨테이너 또는 저장된 액세스 정책에 대한 권한을 설정합니다. 권한은 컨테이너의 blob에 공개적으로 액세스할 수 있는지 여부를 나타냅니다.
set_container_metadata	지정된 컨테이너에 대해 하나 이상의 사용자 정의 이름-값 쌍을 설정합니다. 이 작업을 호출할 때마다 컨테이너에 연결된 기존의 모든 메타데이터가 바뀝니다. 컨테이너에서 모든 메타데이터를 제거하려면 메타데이터 받아쓰기 없이 이 작업을 호출합니다.
set_proxy	HTTP CONNECT 터널링에 대한 프록시 서버 호스트 및 포트를 설정합니다.
set_standard_blob_tier	Blob에서 블록 Blob 계층을 설정합니다. 이 API는 표준 스토리지 계정의 블록 Blob에 대해서만 지원됩니다. :p aram RehydratePriority rehydrate_priority: 보관된 Blob을 리하우징할 우선 순위를 나타냅니다.
snapshot_blob	Blob의 읽기 전용 스냅숏을 만듭니다.
undelete_blob	삭제되지 않은 Blob 작업은 일시 삭제된 Blob 또는 스냅샷 내용 및 메타데이터를 복원합니다. 일시 삭제되지 않은 Blob 또는 스냅샷 삭제를 취소하려고 하면 아무 변경도 없이 성공합니다.

abort_copy_blob

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

abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)

매개 변수

container_name

str

필수

대상 컨테이너의 이름입니다.

blob_name

str

필수

대상 Blob의 이름입니다.

copy_id

str

필수

원래 copy_blob 작업의 copy.id 제공된 복사 식별자입니다.

lease_id

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

acquire_blob_lease

새로운 임대를 요청합니다. blob에 활성 임대가 없으면, Blob 서비스가 blob에 대한 임대를 만들고 새로운 임대 ID를 반환합니다.

acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

lease_duration

int

기본값: -1

임대 기간(초)을 지정하거나 만료되지 않는 임대의 경우 -1을 지정합니다. 가능한 유한 임대 기간은 15~60초 사이입니다. 갱신 또는 변경을 사용하여 임대 기간을 변경할 수 없습니다. 기본값은 -1(무한 임대)입니다.

proposed_lease_id

str

기본값: None

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 Blob 서비스는 400(잘못된 요청)을 반환합니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

str

acquire_container_lease

새로운 임대를 요청합니다. 컨테이너에 활성 임대가 없으면, Blob 서비스가 컨테이너에 대한 임대를 만들고 새로운 임대 ID를 반환합니다.

acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

lease_duration

int

기본값: -1

임대 기간(초)을 지정하거나 만료되지 않는 임대의 경우 -1을 지정합니다. 가능한 유한 임대 기간은 15~60초 사이입니다. 갱신 또는 변경을 사용하여 임대 기간을 변경할 수 없습니다. 기본값은 -1(무한 임대)입니다.

proposed_lease_id

str

기본값: None

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 Blob 서비스는 400(잘못된 요청)을 반환합니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

str

batch_delete_blobs

여러 Blob 삭제 요청의 일괄 처리를 보냅니다.

Blob delete 메서드는 지정된 Blob 또는 스냅샷 삭제합니다. Blob을 삭제하면 모든 스냅샷도 삭제됩니다. 자세한 내용은 https://docs.microsoft.com/rest/api/storageservices/delete-blob을 참조하세요.

batch_delete_blobs(batch_delete_sub_requests, timeout=None)

매개 변수

batch_delete_sub_requests

list(BatchDeleteSubRequest)

필수

Blob은 일괄 처리로 보낼 요청을 삭제합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

구문 분석된 일괄 처리 삭제 HTTP 응답

반환 형식

list <xref:of> BatchSubResponse

batch_set_standard_blob_tier

여러 집합 블록 Blob 계층 요청의 일괄 처리를 보냅니다. 이 API는 표준 스토리지 계정의 블록 Blob에 대해서만 지원됩니다.

batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)

매개 변수

batch_set_blob_tier_sub_requests

list(BatchSetBlobTierSubRequest)

필수

집합 블록 Blob 계층은 일괄 처리로 보내도록 요청합니다.

timeout

int

기본값: None

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

반환

구문 분석된 일괄 처리 집합 계층 HTTP 응답은 각 하위 요청이 성공했는지를 나타냅니다.

반환 형식

list <xref:of> BatchSubResponse

break_blob_lease

blob에 활성 임대가 포함된 경우 임대를 중단합니다. 임대가 중단되면 갱신할 수 없습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 중단되면 임대 중단 기간이 경과할 수 있으며, 이 기간 동안 Blob에서 중단 및 해제를 제외한 임대 작업을 수행할 수 없습니다. 임대가 성공적으로 중단되면 새로운 임대를 획득하기 위해 기다려야 하는 기간(초)이 응답에 표시됩니다.

중단된 임대도 해제할 수 있으며, 이 경우 다른 클라이언트가 해당 blob에 대한 임대를 즉시 획득할 수 있습니다.

break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

lease_break_period

int

기본값: None

중단 작업의 경우 임대가 중단되기 전에 0~60초 사이에 계속되어야 하는 제안된 시간(초)입니다. 이 중단 기간은 남은 임대 기간보다 짧은 경우에만 사용됩니다. 남은 임대 기간이 더 길면 이 기간이 사용됩니다. 중단 기간이 만료되기 전까지는 새로운 임대를 사용할 수 없지만 중단 기간보다 오랫동안 임대가 유지될 수 있습니다. 이 헤더가 중단 작업과 함께 표시되지 않으면 남은 임대 기간이 경과한 후 고정 기간 임대가 중단되고 무한 임대가 즉시 중단됩니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

int

break_container_lease

컨테이너에 활성 임대가 포함된 경우 임대를 중단합니다. 임대가 중단되면 갱신할 수 없습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며, 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 중단되면 임대 중단 기간이 경과할 수 있으며, 이 기간 동안 컨테이너에서 중단 및 해제를 제외한 임대 작업을 수행할 수 없습니다. 임대가 성공적으로 중단되면 새로운 임대를 획득하기 위해 기다려야 하는 기간(초)이 응답에 표시됩니다.

break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

lease_break_period

int

기본값: None

이는 임대가 끊어지기 전에 0~60초 사이에 계속되어야 하는 제안된 시간(초)입니다. 이 중단 기간은 남은 임대 기간보다 짧은 경우에만 사용됩니다. 남은 임대 기간이 더 길면 이 기간이 사용됩니다. 중단 기간이 만료되기 전까지는 새로운 임대를 사용할 수 없지만 중단 기간보다 오랫동안 임대가 유지될 수 있습니다. 이 헤더가 중단 작업과 함께 표시되지 않으면 남은 임대 기간이 경과한 후 고정 기간 임대가 중단되고 무한 임대가 즉시 중단됩니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

int

change_blob_lease

활성 임대의 임대 ID를 변경합니다. 변경 내용에는 현재 임대 ID와 새 임대 ID가 포함되어야 합니다.

change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

lease_id

str

필수

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

proposed_lease_id

str

필수

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 Blob 서비스는 400(잘못된 요청)을 반환합니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

change_container_lease

활성 임대의 임대 ID를 변경합니다. 변경 내용에는 현재 임대 ID와 새 임대 ID가 포함되어야 합니다.

change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

lease_id

str

필수

활성 임대에 대한 임대 ID입니다.

proposed_lease_id

str

필수

GUID 문자열 형식의 제안된 임대 ID입니다. 제안된 임대 ID가 올바른 형식이 아닌 경우 Blob 서비스는 400(잘못된 요청)을 반환합니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

copy_blob

Blob을 복사합니다. 이 작업은 복사 작업 속성 개체를 반환합니다. 복사 작업은 비동기, 최적 작업 또는 동기 작업으로 구성될 수 있습니다.

requires_sync true인 경우 원본은 블록 Blob이어야 합니다. 기존 대상 blob는 덮어씁니다. 복사 작업이 진행 중일 때는 대상 blob를 수정할 수 없습니다.

블록 Blob에서 복사할 때 커밋된 모든 블록과 해당 블록 ID가 복사됩니다. 커밋되지 않은 블록은 복사되지 않습니다. 복사 작업이 끝나면 대상 Blob은 원본과 동일한 커밋된 블록 수를 갖게 됩니다.

대상 Blob에서 get_blob_properties 호출하여 복사 작업의 상태 검사 수 있습니다. 복사가 완료되면 최종 blob가 커밋됩니다.

대상 컨테이너의 이름입니다. 컨테이너가 있어야 합니다. :p aram str blob_name: 대상 Blob의 이름입니다. 대상 Blob이 있으면 덮어씁니다. 그렇지 않으면 생성됩니다. :p aram str copy_source: Azure 파일 또는 Blob을 지정하는 최대 2KB의 URL입니다. 값은 요청 URI에 표시되므로 URL 인코딩해야 합니다. 원본이 다른 계정에 있는 경우 원본은 공용이거나 공유 액세스 서명을 통해 인증되어야 합니다. 원본이 공용인 경우 인증이 필요하지 않습니다. 예: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?스냅샷= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram 메타데이터: Blob과 연결된 이름-값 쌍을 메타데이터로 사용합니다. 이름-값 쌍이 지정되지 않은 경우 작업은 원본 Blob 또는 파일의 메타데이터를 대상 Blob으로 복사합니다. 하나 이상의 이름-값 쌍을 지정하면 대상 Blob이 지정된 메타데이터를 사용하여 만들어지고 메타데이터는 원본 Blob 또는 파일에서 복사되지 않습니다. :type 메타데이터: dict(str, str) :p aram datetime source_if_modified_since: DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 원본 blob가 수정된 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. :p aram datetime source_if_unmodified_since: DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 원본 blob가 수정되지 않은 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. :p aram ETag source_if_match: ETag 값 또는 와일드카드 문자()입니다. ETag가 지정된 값과 일치하는 경우에만 원본 Blob을 복사하려면 이 조건부 헤더를 지정합니다. ETag 값이 일치하지 않으면 Blob 서비스는 상태 코드 412(사전 조건 실패)를 반환합니다. 원본이 Azure 파일인 경우 이 헤더를 지정할 수 없습니다. :p aram ETag source_if_none_match: ETag 값 또는 와일드카드 문자()입니다. ETag가 지정된 값과 일치하지 않는 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. 값이 동일하면 Blob 서비스가 상태 코드 412(전제 조건 실패)를 반환합니다. 원본이 Azure 파일인 경우 이 헤더를 지정할 수 없습니다. :p aram datetime destination_if_modified_since: DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 대상 blob가 수정된 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. 대상 blob이 수정되지 않은 경우 Blob service가 상태 코드 412(전제 조건 실패)를 반환합니다. :p aram datetime destination_if_unmodified_since: DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 대상 blob가 수정되지 않은 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. 대상 blob가 수정된 경우 Blob 서비스가 상태 코드 412(전제 조건 실패)를 반환합니다. :p aram ETag destination_if_match: ETag 값 또는 와일드카드 문자()입니다. 지정된 ETag 값이 기존 대상 Blob의 ETag 값과 일치하는 경우에만 Blob을 복사하려면 이 조건부 헤더에 대한 ETag 값을 지정합니다. 대상 Blob의 ETag가 If-Match에 지정된 ETag와 일치하지 않으면 Blob 서비스는 상태 코드 412(사전 조건 실패)를 반환합니다. :p aram ETag destination_if_none_match: ETag 값 또는 와일드카드 문자()입니다. 지정된 ETag 값이 대상 blob의 ETag 값과 일치하지 않는 경우에만 blob를 복사하려면 이 조건부 헤더에 대한 ETag 값을 지정합니다. 대상 blob가 존재하지 않는 경우에만 작업을 수행하려면 와일드카드 문자(*)를 지정합니다. 지정된 조건이 충족되지 않으면 Blob 서비스가 상태 코드 412(전제 조건 실패)를 반환합니다. :p aram str destination_lease_id: 이 헤더에 지정된 임대 ID가 대상 Blob의 임대 ID와 일치해야 합니다. 요청에 임대 ID가 포함되지 않거나 유효하지 않은 경우, 작업이 실패하고 상태 코드 412(전제 조건 실패)가 표시됩니다. :p aram str source_lease_id: 지정된 임대 ID가 원본 Blob의 활성 임대 ID와 일치하는 경우에만 Blob 복사 작업을 수행하도록 지정합니다. :p aram int 시간 제한: 시간 제한 매개 변수는 초 단위로 표시됩니다. :p aram bool requires_sync: 복사가 완료될 때까지 서비스에서 응답을 반환하지 않도록 적용합니다. :p aram StandardBlobTier standard_blob_tier: Blob을 설정할 표준 Blob 계층 값입니다. 이 버전의 라이브러리의 경우 표준 스토리지 계정의 블록 Blob에만 적용됩니다. :p aram RehydratePriority rehydrate_priority: 보관된 Blob :return: 복사 작업 속성(예: 상태, 원본 및 ID)을 리하이드레이션할 우선 순위를 나타냅니다. :rtype: CopyProperties

copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)

매개 변수

container_name

str

필수

blob_name

필수

copy_source

필수

metadata

기본값: None

source_if_modified_since

기본값: None

source_if_unmodified_since

기본값: None

source_if_match

기본값: None

source_if_none_match

기본값: None

destination_if_modified_since

기본값: None

destination_if_unmodified_since

기본값: None

destination_if_match

기본값: None

destination_if_none_match

기본값: None

destination_lease_id

기본값: None

source_lease_id

기본값: None

timeout

기본값: None

requires_sync

기본값: None

standard_blob_tier

기본값: None

rehydrate_priority

기본값: None

create_blob_from_bytes

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

create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

만들거나 업데이트할 Blob의 이름입니다.

blob

bytes

필수

Blob의 콘텐츠(바이트 배열)입니다.

index

int

기본값: 0

바이트 배열에서 인덱스 시작

count

int

기본값: None

업로드할 바이트 수입니다. 인덱스에서 시작하는 모든 바이트를 업로드하려면 없음 또는 음수 값으로 설정합니다.

content_settings

ContentSettings

기본값: None

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

metadata

dict(str, str)

기본값: None

blob과 메타데이터로 연결된 이름-값 쌍입니다.

validate_content

bool

기본값: False

true이면 Blob의 각 청크에 대한 MD5 해시를 계산합니다. 스토리지 서비스는 전송된 해시와 함께 도착한 콘텐츠의 해시를 확인합니다. 이는 https 대신 https(기본값)를 사용하여 이미 유효성을 검사하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 이 MD5 해시는 blob에 저장되지 않습니다.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

기본값: None

시그니처 함수(현재, 합계)를 사용한 진행률에 대한 콜백입니다. 여기서 current는 지금까지 전송된 바이트 수이고 합계는 Blob의 크기이고 총 크기는 알 수 없는 경우 None입니다.

max_connections

int

기본값: 2

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

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

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

standard_blob_tier

StandardBlobTier

기본값: None

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

반환

블록 Blob에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

create_blob_from_path

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

create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

만들거나 업데이트할 Blob의 이름입니다.

file_path

str

필수

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

content_settings

ContentSettings

기본값: None

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

metadata

dict(str, str)

기본값: None

blob과 메타데이터로 연결된 이름-값 쌍입니다.

validate_content

bool

기본값: False

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

progress_callback

<xref:func>(<xref:current>, <xref:total>)

기본값: None

시그니처 함수(현재, 합계)를 사용한 진행률에 대한 콜백입니다. 여기서 current는 지금까지 전송된 바이트 수이고 합계는 Blob의 크기이고 총 크기는 알 수 없는 경우 None입니다.

max_connections

int

기본값: 2

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

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

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

standard_blob_tier

StandardBlobTier

기본값: None

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

반환

블록 Blob에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

create_blob_from_stream

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

create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, use_byte_buffer=False, standard_blob_tier=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

만들거나 업데이트할 Blob의 이름입니다.

stream

IOBase

필수

Blob 콘텐츠로 업로드할 파일/스트림을 열었습니다.

count

int

기본값: None

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

content_settings

ContentSettings

기본값: None

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

metadata

dict(str, str)

기본값: None

blob과 메타데이터로 연결된 이름-값 쌍입니다.

validate_content

bool

기본값: False

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

progress_callback

<xref:func>(<xref:current>, <xref:total>)

기본값: None

시그니처 함수(현재, 합계)를 사용한 진행률에 대한 콜백입니다. 여기서 current는 지금까지 전송된 바이트 수이고 합계는 Blob의 크기이고 총 크기는 알 수 없는 경우 None입니다.

max_connections

int

기본값: 2

Blob 크기가 64MB를 초과할 때 사용할 최대 병렬 연결 수입니다. 병렬 업로드를 사용하려면 스트림을 검색할 수 있어야 합니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

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

use_byte_buffer

bool

기본값: False

True이면 원래 전체 블록 버퍼링 업로드 경로를 강제로 사용합니다. 기본적으로 이 값은 False이며 제공된 스트림을 검색할 수 있고 'require_encryption'이 False이고 MAX_BLOCK_SIZE = MIN_LARGE_BLOCK_UPLOAD_THRESHOLD >조건에서 메모리 효율적인 스트리밍 업로드 알고리즘을 사용합니다. 이 방법을 사용하는 단점을 고려해야 합니다. 메모리 효율성을 달성하기 위해 IOBase 스트림 또는 파일과 같은 개체는 SubStream 래퍼를 사용하여 논리 블록으로 분할됩니다. 올바른 데이터를 읽으려면 각 SubStream이 공유 기본 스트림에서 올바른 위치를 안전하게 검색할 수 있도록 잠금을 획득해야 합니다. max_connections > 1이면 동시성으로 인해 기본 스트림에서 상당한 양의 검색이 발생합니다. 파일과 유사한 스트림 개체와 같은 가장 일반적인 입력의 경우 검색은 저렴한 작업이며 이는 별로 문제가 되지 않습니다. 그러나 다른 스트림 변형의 경우는 그렇지 않을 수 있습니다. 메모리 효율성에 대한 장부를 입력 스트림으로 검색하는 비용과 비교할 수 있어야 합니다. SubStream 클래스는 내부적으로 최대 4MB의 버퍼링을 시도하여 기본 스트림에 대한 검색 및 읽기 호출의 양을 줄입니다. 이는 더 큰 블록을 업로드할 때 특히 유용합니다.

standard_blob_tier

StandardBlobTier

기본값: None

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

반환

블록 Blob에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

create_blob_from_text

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

create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

만들거나 업데이트할 Blob의 이름입니다.

text

str

필수

Blob에 업로드할 텍스트입니다.

encoding

str

기본값: utf-8

텍스트를 바이트로 변환하는 데 사용할 Python 인코딩입니다.

content_settings

ContentSettings

기본값: None

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

metadata

dict(str, str)

기본값: None

blob과 메타데이터로 연결된 이름-값 쌍입니다.

validate_content

bool

기본값: False

true이면 Blob의 각 청크에 대한 MD5 해시를 계산합니다. 스토리지 서비스는 전송된 해시와 함께 도착한 콘텐츠의 해시를 확인합니다. 이는 https 대신 https(기본값)를 사용하여 이미 유효성을 검사하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 이 MD5 해시는 blob에 저장되지 않습니다.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

기본값: None

시그니처 함수(현재, 합계)를 사용한 진행률에 대한 콜백입니다. 여기서 current는 지금까지 전송된 바이트 수이고 합계는 Blob의 크기이고 총 크기는 알 수 없는 경우 None입니다.

max_connections

int

기본값: 2

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

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

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

standard_blob_tier

StandardBlobTier

기본값: None

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

반환

블록 Blob에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

create_container

지정된 계정 아래에 새 컨테이너를 만듭니다. 이름이 같은 컨테이너가 이미 있는 경우 fail_on_exist True이면 작업이 실패합니다.

create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)

매개 변수

container_name

str

필수

만들 컨테이너의 이름입니다. 컨테이너 이름은 소문자, 숫자 및 하이픈만 포함할 수 있으며 문자 또는 숫자로 시작해야 합니다. 각 하이픈의 앞과 뒤에는 하이픈이 아닌 문자가 있어야 합니다. 이름의 길이는 3~63자 사이여야 합니다.

metadata

dict(str, str)

기본값: None

컨테이너와 메타데이터로 연결할 name_value 쌍이 있는 받아쓰기입니다. 예:{'Category':'test'}

public_access

PublicAccess

기본값: None

가능한 값은 컨테이너, Blob입니다.

fail_on_exist

bool

기본값: False

컨테이너가 있을 때 예외를 throw할지 여부를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

컨테이너가 만들어지면 True이고, 컨테이너가 이미 있는 경우 False입니다.

반환 형식

bool

delete_blob

삭제할 지정된 Blob 또는 스냅샷 표시합니다. 이 blob는 나중에 가비지 수집 중에 삭제됩니다.

Blob을 삭제하려면 해당 스냅숏을 모두 삭제해야 합니다. Blob 삭제 작업과 동시에 둘 다 삭제할 수 있습니다.

서비스에 대해 삭제 보존 정책을 사용하도록 설정한 경우 이 작업은 Blob 또는 스냅샷 일시 삭제하고 지정된 일 수 동안 Blob 또는 스냅샷 유지합니다. 지정된 일 수가 지나면 가비지 수집 중에 Blob의 데이터가 서비스에서 제거됩니다. 일시 삭제된 Blob 또는 스냅샷 include=Include.Deleted 옵션을 지정하는 Blob 목록 API를 통해 액세스할 수 있습니다. 일시 삭제된 Blob 또는 스냅샷 삭제 취소 API를 사용하여 복원할 수 있습니다.

delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

snapshot

str

기본값: None

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

lease_id

str

기본값: None

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

delete_snapshots

DeleteSnapshot

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

delete_container

삭제할 지정된 컨테이너를 표시합니다. 컨테이너 및 여기에 포함된 모든 blob는 나중에 가비지 수집 중에 삭제됩니다.

delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

매개 변수

container_name

str

필수

삭제할 컨테이너의 이름입니다.

fail_not_exist

bool

기본값: False

컨테이너가 없을 때 예외를 throw할지 여부를 지정합니다.

lease_id

str

기본값: None

지정된 경우 delete_container 컨테이너의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 성공합니다. 컨테이너에 활성 임대가 있는 경우 필요합니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

True이면 컨테이너가 삭제되고 False 컨테이너가 없습니다.

반환 형식

bool

exists

컨테이너가 있는지(blob_name 없음인 경우) 또는 Blob이 있는지 여부를 나타내는 부울을 반환합니다.

exists(container_name, blob_name=None, snapshot=None, timeout=None)

매개 변수

container_name

str

필수

컨테이너의 이름입니다.

blob_name

str

기본값: None

Blob의 이름입니다. None이면 컨테이너가 있는지 확인합니다.

snapshot

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

리소스가 있는지 여부를 나타내는 부울입니다.

반환 형식

bool

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

매개 변수

retry_context

필수

generate_account_shared_access_signature

Blob 서비스에 대한 공유 액세스 서명을 생성합니다. 반환된 서명을 BlobService의 sas_token 매개 변수와 함께 사용합니다.

generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)

매개 변수

resource_types

<xref:ResourceTypes>

필수

계정 SAS를 사용하여 액세스할 수 있는 리소스 종류를 지정합니다.

permission

<xref:AccountPermissions>

필수

공유 액세스 서명과 연결된 권한입니다. 사용자는 이러한 권한으로 허용된 작업만 수행할 수 있도록 제한됩니다. 이 필드를 포함하는 저장된 액세스 정책을 참조하는 ID가 지정되지 않는 한 필요합니다. 이 필드는 연결된 저장된 액세스 정책에 지정된 경우 생략되어야 합니다.

expiry

datetime 또는 str

필수

공유 액세스 서명이 유효하지 않은 시간입니다. 이 필드를 포함하는 저장된 액세스 정책을 참조하는 ID가 지정되지 않는 한 필요합니다. 이 필드는 연결된 저장된 액세스 정책에 지정된 경우 생략되어야 합니다. Azure는 항상 값을 UTC로 변환합니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다.

start

datetime 또는 str

기본값: None

공유 액세스 서명이 유효한 시간입니다. 생략되는 경우 이 호출의 시작 시간은 저장소 서비스가 요청을 받는 시간으로 간주됩니다. Azure는 항상 값을 UTC로 변환합니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다.

ip

str

기본값: None

요청을 수락할 IP 주소 또는 IP 주소 범위를 지정합니다. 요청이 시작된 IP 주소가 SAS 토큰에 지정된 IP 주소 또는 주소 범위와 일치하지 않으면 요청이 인증되지 않습니다. 예를 들어 SAS에서 sip=168.1.5.65 또는 sip=168.1.5.60-168.1.5.70을 지정하면 요청이 해당 IP 주소로 제한됩니다.

protocol

str

기본값: None

요청이 허용되는 프로토콜을 지정합니다. 기본값은 https,http입니다. 가능한 값은 Protocol를 참조하십시오.

반환

sas(공유 액세스 서명) 토큰입니다.

반환 형식

str

generate_blob_shared_access_signature

Blob 또는 해당 스냅샷 중 하나에 대한 공유 액세스 서명을 생성합니다. 반환된 서명을 BlobService의 sas_token 매개 변수와 함께 사용합니다.

generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

매개 변수

container_name

str

필수

컨테이너의 이름입니다.

blob_name

str

필수

Blob의 이름입니다.

snapshot

str

기본값: None

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

permission

BlobPermissions

기본값: None

공유 액세스 서명과 연결된 권한입니다. 사용자는 이러한 권한으로 허용된 작업만 수행할 수 있도록 제한됩니다. 사용 권한은 읽기, 쓰기, 삭제, 목록 순서를 지정해야 합니다. 이 필드를 포함하는 저장된 액세스 정책을 참조하는 ID가 제공되지 않는 한 필요합니다. 이 필드는 연결된 저장된 액세스 정책에 지정된 경우 생략되어야 합니다.

expiry

datetime 또는 str

기본값: None

공유 액세스 서명이 유효하지 않은 시간입니다. 이 필드를 포함하는 저장된 액세스 정책을 참조하는 ID가 제공되지 않는 한 필요합니다. 이 필드는 연결된 저장된 액세스 정책에 지정된 경우 생략되어야 합니다. Azure는 항상 값을 UTC로 변환합니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다.

start

datetime 또는 str

기본값: None

공유 액세스 서명이 유효한 시간입니다. 생략되는 경우 이 호출의 시작 시간은 저장소 서비스가 요청을 받는 시간으로 간주됩니다. Azure는 항상 값을 UTC로 변환합니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다.

id

str

기본값: None

저장된 액세스 정책과 상관 관계가 있는 최대 64자 길이의 고유 값입니다. 저장된 액세스 정책을 만들려면 를 사용합니다 set_container_acl.

ip

str

기본값: None

요청을 수락할 IP 주소 또는 IP 주소 범위를 지정합니다. 요청이 시작된 IP 주소가 SAS 토큰에 지정된 IP 주소 또는 주소 범위와 일치하지 않으면 요청이 인증되지 않습니다. 예를 들어 SAS에서 sip=168.1.5.65 또는 sip=168.1.5.60-168.1.5.70을 지정하면 요청이 해당 IP 주소로 제한됩니다.

protocol

str

기본값: None

요청이 허용되는 프로토콜을 지정합니다. 기본값은 https,http입니다. 가능한 값은 Protocol를 참조하십시오.

cache_control

str

기본값: None

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

content_disposition

str

기본값: None

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

content_encoding

str

기본값: None

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

content_language

str

기본값: None

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

content_type

str

기본값: None

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

user_delegation_key

UserDelegationKey

기본값: None

사용자는 계정 키 대신 사용자 위임 키를 전달할 수 있습니다. AAD ID를 사용하여 인증하여 서비스에서 사용자 위임 키를 가져올 수 있습니다. 이 작업은 get_user_delegation_key 호출하여 수행할 수 있습니다. 있는 경우 SAS는 대신 사용자 위임 키로 서명됩니다.

반환

sas(공유 액세스 서명) 토큰입니다.

반환 형식

str

generate_container_shared_access_signature

컨테이너에 대한 공유 액세스 서명을 생성합니다. 반환된 서명을 BlobService의 sas_token 매개 변수와 함께 사용합니다.

generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

매개 변수

container_name

str

필수

컨테이너의 이름입니다.

permission

ContainerPermissions

기본값: None

공유 액세스 서명과 연결된 권한입니다. 사용자는 이러한 권한으로 허용된 작업만 수행할 수 있도록 제한됩니다. 사용 권한은 읽기, 쓰기, 삭제, 목록 순서를 지정해야 합니다. 이 필드를 포함하는 저장된 액세스 정책을 참조하는 ID가 제공되지 않는 한 필요합니다. 이 필드는 연결된 저장된 액세스 정책에 지정된 경우 생략되어야 합니다.

expiry

datetime 또는 str

기본값: None

공유 액세스 서명이 유효하지 않은 시간입니다. 이 필드를 포함하는 저장된 액세스 정책을 참조하는 ID가 제공되지 않는 한 필요합니다. 이 필드는 연결된 저장된 액세스 정책에 지정된 경우 생략되어야 합니다. Azure는 항상 값을 UTC로 변환합니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다.

start

datetime 또는 str

기본값: None

공유 액세스 서명이 유효한 시간입니다. 생략되는 경우 이 호출의 시작 시간은 저장소 서비스가 요청을 받는 시간으로 간주됩니다. Azure는 항상 값을 UTC로 변환합니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다.

id

str

기본값: None

저장된 액세스 정책과 상관 관계가 있는 최대 64자 길이의 고유 값입니다. 저장된 액세스 정책을 만들려면 set_blob_service_properties 사용합니다.

ip

str

기본값: None

요청을 수락할 IP 주소 또는 IP 주소 범위를 지정합니다. 요청이 시작된 IP 주소가 SAS 토큰에 지정된 IP 주소 또는 주소 범위와 일치하지 않으면 요청이 인증되지 않습니다. 예를 들어 SAS에서 sip=168.1.5.65 또는 sip=168.1.5.60-168.1.5.70을 지정하면 요청이 해당 IP 주소로 제한됩니다.

protocol

str

기본값: None

요청이 허용되는 프로토콜을 지정합니다. 기본값은 https,http입니다. 가능한 값은 Protocol를 참조하십시오.

cache_control

str

기본값: None

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

content_disposition

str

기본값: None

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

content_encoding

str

기본값: None

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

content_language

str

기본값: None

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

content_type

str

기본값: None

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

user_delegation_key

UserDelegationKey

기본값: None

사용자는 계정 키 대신 사용자 위임 키를 전달할 수 있습니다. AAD ID를 사용하여 인증하여 서비스에서 사용자 위임 키를 가져올 수 있습니다. 이 작업은 get_user_delegation_key 호출하여 수행할 수 있습니다. 있는 경우 SAS는 대신 사용자 위임 키로 서명됩니다.

반환

sas(공유 액세스 서명) 토큰입니다.

반환 형식

str

get_blob_account_information

스토리지 계정과 관련된 정보를 가져옵니다. 사용자에게 컨테이너 또는 Blob에 대한 SAS가 있는 경우에도 정보를 검색할 수 있습니다.

get_blob_account_information(container_name=None, blob_name=None, timeout=None)

매개 변수

container_name

str

기본값: None

기존 컨테이너의 이름입니다. 특정 컨테이너 또는 Blob에 SAS 토큰을 사용하지 않는 한 선택 사항입니다. 이 경우 필요합니다.

blob_name

str

기본값: None

기존 Blob의 이름입니다. 특정 Blob에 SAS 토큰을 사용하지 않는 한 선택 사항입니다. 이 경우 필요합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

AccountInformation

get_blob_metadata

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

get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

snapshot

str

기본값: None

스냅샷 매개 변수는 있을 때 검색할 blob 스냅샷 지정하는 불투명 값입니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호 해독합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

Blob 메타데이터 이름, 값 쌍을 나타내는 사전입니다.

반환 형식

dict(str, str)

get_blob_properties

blob에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. blob의 콘텐츠는 반환하지 않습니다. BlobProperties 및 메타데이터 받아쓰기를 사용하여 를 반환 Blob 합니다.

get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

snapshot

str

기본값: None

스냅샷 매개 변수는 있을 때 검색할 blob 스냅샷 지정하는 불투명 DateTime 값입니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호 해독합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

속성 및 메타데이터를 포함하는 Blob 개체입니다.

반환 형식

Blob

get_blob_service_properties

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

get_blob_service_properties(timeout=None)

매개 변수

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

연결된 target_version 속성이 있는 Blob ServiceProperties 입니다.

get_blob_service_stats

Blob 서비스에 대한 복제와 관련된 통계를 검색합니다. 스토리지 계정에 대해 읽기 액세스 지역 중복 복제를 사용하도록 설정한 경우에만 사용할 수 있습니다.

지리적 중복 복제를 사용하여 Azure 저장소는 데이터를 두 위치에서 영구 유지 관리합니다. 두 위치 모두에서 Azure 저장소는 데이터에 대한 여러 정상 복제를 지속적으로 유지 관리합니다. 데이터를 읽거나 만들거나 업데이트하거나 삭제하는 위치는 주 저장소 계정 위치입니다. 기본 위치는 Azure Management Azure 클래식 포털(예: 미국 중북부)을 통해 계정을 만들 때 선택한 지역에 있습니다. 데이터가 복제되는 위치는 보조 위치입니다. 보조 위치는 기본 위치에 따라 자동으로 결정되며, 기본 위치와 동일한 지역에 있는 보조 데이터 센터입니다. 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우, 보조 위치에서 읽기 전용 액세스가 가능합니다.

get_blob_service_stats(timeout=None)

매개 변수

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

Blob 서비스 통계입니다.

반환 형식

ServiceStats

get_blob_to_bytes

자동 청크 및 진행률 알림을 사용하여 Blob을 바이트 배열로 다운로드합니다. 속성, 메타데이터 및 콘텐츠를 사용하여 의 Blob instance 반환합니다.

get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

snapshot

str

기본값: None

스냅샷 매개 변수는 있을 때 검색할 blob 스냅샷 지정하는 불투명 DateTime 값입니다.

start_range

int

기본값: None

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

end_range

int

기본값: None

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

validate_content

bool

기본값: False

true로 설정하면 Blob에서 검색된 각 부분에 대해 MD5 해시의 유효성을 검사합니다. 이는 https 대신 https(기본값)를 사용하여 이미 유효성을 검사하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 서비스는 청크 4MB 이하의 트랜잭션 MD5만 반환하므로 첫 번째 가져오기 요청은 자체 크기가 됩니다. 자기 대신 MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. 자체인 경우. MAX_CHUNK_GET_SIZE 4MB 이상으로 설정되었으면 오류가 throw됩니다. MD5를 컴퓨팅하는 데 처리 시간이 걸리고 청크 크기 감소로 인해 더 많은 요청을 수행해야 하므로 대기 시간이 약간 증가할 수 있습니다.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

기본값: None

시그니처 함수(현재, 합계)를 사용한 진행률에 대한 콜백입니다. 여기서 current는 지금까지 전송된 바이트 수이고 total은 알려진 경우 Blob의 크기입니다.

max_connections

int

기본값: 2

2 이상으로 설정하면 첫 번째 자체에 대해 초기 가져오기가 수행됩니다. blob의 MAX_SINGLE_GET_SIZE 바이트입니다. 전체 Blob인 경우 메서드는 이 시점에서 를 반환합니다. 그렇지 않은 경우 max_connections 동일한 스레드 수를 사용하여 나머지 데이터를 병렬로 다운로드합니다. 각 청크는 자체 크기입니다. MAX_CHUNK_GET_SIZE. 1로 설정하면 단일 대규모 가져오기 요청이 수행됩니다. 일반적으로 권장되지는 않지만, 스레드가 거의 사용되지 않거나, 네트워크 요청이 매우 비싸거나, 검색할 수 없는 스트림이 병렬 다운로드를 방지하는 경우 사용할 수 있습니다. max_connections 1보다 큰 경우 빈 Blob에 추가 요청이 필요하기 때문에 많은 Blob이 비어 있어야 하는 경우에도 유용할 수 있습니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호 해독합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

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

반환

속성 및 메타데이터가 있는 Blob입니다. max_connections 1보다 크면 blob에 설정된 경우 content_md5 반환되지 않습니다. 이 값이 필요한 경우 get_blob_properties 사용하거나 max_connections 1로 설정합니다.

반환 형식

Blob

get_blob_to_path

자동 청크 및 진행률 알림을 사용하여 Blob을 파일 경로에 다운로드합니다. 속성 및 메타데이터를 사용하여 의 Blob instance 반환합니다.

get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

file_path

str

필수

쓸 파일의 경로입니다.

open_mode

str

기본값: wb

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

snapshot

str

기본값: None

스냅샷 매개 변수는 있을 때 검색할 blob 스냅샷 지정하는 불투명 DateTime 값입니다.

start_range

int

기본값: None

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

end_range

int

기본값: None

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

validate_content

bool

기본값: False

true로 설정하면 Blob에서 검색된 각 부분에 대해 MD5 해시의 유효성을 검사합니다. 이는 https 대신 https(기본값)를 사용하여 이미 유효성을 검사하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 서비스는 청크 4MB 이하의 트랜잭션 MD5만 반환하므로 첫 번째 가져오기 요청은 자체 크기가 됩니다. 자기 대신 MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. 자체인 경우. MAX_CHUNK_GET_SIZE 4MB 이상으로 설정되었으면 오류가 throw됩니다. MD5를 컴퓨팅하는 데 처리 시간이 걸리고 청크 크기 감소로 인해 더 많은 요청을 수행해야 하므로 대기 시간이 약간 증가할 수 있습니다.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

기본값: None

시그니처 함수(현재, 합계)를 사용한 진행률에 대한 콜백입니다. 여기서 current는 지금까지 전송된 바이트 수이고 total은 알려진 경우 Blob의 크기입니다.

max_connections

int

기본값: 2

2 이상으로 설정하면 첫 번째 자체에 대해 초기 가져오기가 수행됩니다. blob의 MAX_SINGLE_GET_SIZE 바이트입니다. 전체 Blob인 경우 메서드는 이 시점에서 를 반환합니다. 그렇지 않은 경우 max_connections 동일한 스레드 수를 사용하여 나머지 데이터를 병렬로 다운로드합니다. 각 청크는 자체 크기입니다. MAX_CHUNK_GET_SIZE. 1로 설정하면 단일 대규모 가져오기 요청이 수행됩니다. 일반적으로 권장되지는 않지만, 스레드가 거의 사용되지 않거나, 네트워크 요청이 매우 비싸거나, 검색할 수 없는 스트림이 병렬 다운로드를 방지하는 경우 사용할 수 있습니다. max_connections 1보다 큰 경우 빈 Blob에 추가 요청이 필요하기 때문에 많은 Blob이 비어 있어야 하는 경우에도 유용할 수 있습니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호 해독합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

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

반환

속성 및 메타데이터가 있는 Blob입니다. max_connections 1보다 크면 blob에 설정된 경우 content_md5 반환되지 않습니다. 이 값이 필요한 경우 get_blob_properties 사용하거나 max_connections 1로 설정합니다.

반환 형식

Blob

get_blob_to_stream

자동 청크 및 진행률 알림을 사용하여 Blob을 스트림에 다운로드합니다. 속성 및 메타데이터를 사용하여 의 Blob instance 반환합니다.

get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

stream

IOBase

필수

쓸 스트림을 열었습니다.

snapshot

str

기본값: None

스냅샷 매개 변수는 있을 때 검색할 blob 스냅샷 지정하는 불투명 DateTime 값입니다.

start_range

int

기본값: None

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

end_range

int

기본값: None

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

validate_content

bool

기본값: False

true로 설정하면 Blob에서 검색된 각 부분에 대해 MD5 해시의 유효성을 검사합니다. 이는 https 대신 https(기본값)를 사용하여 이미 유효성을 검사하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 서비스는 청크 4MB 이하의 트랜잭션 MD5만 반환하므로 첫 번째 가져오기 요청은 자체 크기가 됩니다. 자기 대신 MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. 자체인 경우. MAX_CHUNK_GET_SIZE 4MB 이상으로 설정되었으면 오류가 throw됩니다. MD5를 컴퓨팅하는 데 처리 시간이 걸리고 청크 크기 감소로 인해 더 많은 요청을 수행해야 하므로 대기 시간이 약간 증가할 수 있습니다.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

기본값: None

시그니처 함수(현재, 합계)를 사용한 진행률에 대한 콜백입니다. 여기서 current는 지금까지 전송된 바이트 수이고 total은 알려진 경우 Blob의 크기입니다.

max_connections

int

기본값: 2

2 이상으로 설정하면 첫 번째 자체에 대해 초기 가져오기가 수행됩니다. blob의 MAX_SINGLE_GET_SIZE 바이트입니다. 전체 Blob인 경우 메서드는 이 시점에서 를 반환합니다. 그렇지 않은 경우 max_connections 동일한 스레드 수를 사용하여 나머지 데이터를 병렬로 다운로드합니다. 각 청크는 자체 크기입니다. MAX_CHUNK_GET_SIZE. 1로 설정하면 단일 대규모 가져오기 요청이 수행됩니다. 일반적으로 권장되지는 않지만, 스레드가 거의 사용되지 않거나, 네트워크 요청이 매우 비싸거나, 검색할 수 없는 스트림이 병렬 다운로드를 방지하는 경우 사용할 수 있습니다. max_connections 1보다 큰 경우 빈 Blob에 추가 요청이 필요하기 때문에 많은 Blob이 비어 있어야 하는 경우에도 유용할 수 있습니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호 해독합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

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

반환

속성 및 메타데이터가 있는 Blob입니다. max_connections 1보다 크면 blob에 설정된 경우 content_md5 반환되지 않습니다. 이 값이 필요한 경우 get_blob_properties 사용하거나 max_connections 1로 설정합니다.

반환 형식

Blob

get_blob_to_text

자동 청크 및 진행률 알림을 사용하여 Blob을 유니코드 텍스트로 다운로드합니다. 속성, 메타데이터 및 콘텐츠를 사용하여 의 Blob instance 반환합니다.

get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

encoding

str

기본값: utf-8

Blob 데이터를 디코딩할 때 사용할 Python 인코딩입니다.

snapshot

str

기본값: None

스냅샷 매개 변수는 있을 때 검색할 blob 스냅샷 지정하는 불투명 DateTime 값입니다.

start_range

int

기본값: None

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

end_range

int

기본값: None

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

validate_content

bool

기본값: False

true로 설정하면 Blob에서 검색된 각 부분에 대해 MD5 해시의 유효성을 검사합니다. 이는 https 대신 https(기본값)를 사용하여 이미 유효성을 검사하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 서비스는 청크 4MB 이하의 트랜잭션 MD5만 반환하므로 첫 번째 가져오기 요청은 자체 크기가 됩니다. 자기 대신 MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. 자체인 경우. MAX_CHUNK_GET_SIZE 4MB 이상으로 설정되었으면 오류가 throw됩니다. MD5를 컴퓨팅하는 데 처리 시간이 걸리고 청크 크기 감소로 인해 더 많은 요청을 수행해야 하므로 대기 시간이 약간 증가할 수 있습니다.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

기본값: None

시그니처 함수(현재, 합계)를 사용한 진행률에 대한 콜백입니다. 여기서 current는 지금까지 전송된 바이트 수이고 total은 알려진 경우 Blob의 크기입니다.

max_connections

int

기본값: 2

2 이상으로 설정하면 첫 번째 자체에 대해 초기 가져오기가 수행됩니다. blob의 MAX_SINGLE_GET_SIZE 바이트입니다. 전체 Blob인 경우 메서드는 이 시점에서 를 반환합니다. 그렇지 않은 경우 max_connections 동일한 스레드 수를 사용하여 나머지 데이터를 병렬로 다운로드합니다. 각 청크는 자체 크기입니다. MAX_CHUNK_GET_SIZE. 1로 설정하면 단일 대규모 가져오기 요청이 수행됩니다. 일반적으로 권장되지는 않지만, 스레드가 거의 사용되지 않거나, 네트워크 요청이 매우 비싸거나, 검색할 수 없는 스트림이 병렬 다운로드를 방지하는 경우 사용할 수 있습니다. max_connections 1보다 큰 경우 빈 Blob에 추가 요청이 필요하기 때문에 많은 Blob이 비어 있어야 하는 경우에도 유용할 수 있습니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호 해독합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

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

반환

속성 및 메타데이터가 있는 Blob입니다. max_connections 1보다 크면 blob에 설정된 경우 content_md5 반환되지 않습니다. 이 값이 필요한 경우 get_blob_properties 사용하거나 max_connections 1로 설정합니다.

반환 형식

Blob

get_block_list

블록 Blob의 일부로 업로드된 블록 목록을 검색합니다. blob에 대해 유지 관리되는 블록 목록은 다음 두 가지입니다.

커밋된 블록 목록: 블록 목록 배치를 사용하여 지정된 Blob에 성공적으로 커밋된 블록 목록입니다.

커밋되지 않은 블록 목록: Put Block을 사용하여 Blob에 대해 업로드되었지만 아직 커밋되지 않은 블록 목록입니다. 이러한 블록은 Azure에 blob와 연결되어 저장되지만 아직 해당 blob의 일부를 형성하지 않습니다.

get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

snapshot

str

기본값: None

블록을 검색하는 시간을 결정하는 날짜/시간입니다.

block_list_type

str

기본값: None

커밋된 블록 목록, 커밋되지 않은 블록 목록 또는 두 목록을 함께 반환할지 여부를 지정합니다. 유효한 값은 커밋됨, 커밋되지 않은 값 또는 모두입니다.

lease_id

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

블록 Blob에 대해 커밋된 블록 및/또는 커밋되지 않은 블록 나열

반환 형식

BlobBlockList

get_container_acl

지정된 컨테이너에 대한 권한을 가져옵니다. 권한은 컨테이너 데이터에 공개적으로 액세스할 수 있는지 여부를 나타냅니다.

get_container_acl(container_name, lease_id=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

lease_id

기본값: None

지정된 경우 컨테이너의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 get_container_acl 성공합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

컨테이너와 연결된 액세스 정책 사전입니다. 공용 액세스가 켜져 있는 경우 str to AccessPolicy 및 public_access 속성의 받아쓰기

get_container_metadata

지정된 컨테이너에 대한 모든 사용자 정의 메타데이터를 반환합니다.

get_container_metadata(container_name, lease_id=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

lease_id

str

기본값: None

지정된 경우 get_container_metadata 컨테이너의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 성공합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

컨테이너 메타데이터 이름, 값 쌍을 나타내는 사전입니다.

반환 형식

dict(str, str)

get_container_properties

지정된 컨테이너에 대한 모든 사용자 정의 메타데이터 및 시스템 속성을 반환합니다. 반환된 데이터에는 컨테이너의 블록 목록이 포함되지 않습니다.

get_container_properties(container_name, lease_id=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

lease_id

str

기본값: None

지정된 경우 컨테이너의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 get_container_properties 성공합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

컨테이너 개체 내의 지정된 컨테이너에 대한 속성입니다.

반환 형식

Container

get_user_delegation_key

SAS 토큰에 서명하기 위한 사용자 위임 키를 가져옵니다. 이 요청이 성공하려면 토큰 자격 증명이 서비스 개체에 있어야 합니다.

get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)

매개 변수

key_start_time

datetime

필수

DateTime 값입니다. 키가 유효한 시기를 나타냅니다.

key_expiry_time

datetime

필수

DateTime 값입니다. 키가 유효하지 않을 때를 나타냅니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

사용자 위임 키입니다.

반환 형식

UserDelegationKey

list_blob_names

지정된 컨테이너 아래에 Blob 이름을 나열하는 생성기를 반환합니다. 생성기는 서비스에서 반환된 연속 토큰을 느리게 따르고 모든 Blob이 반환되거나 num_results 도달하면 중지됩니다.

num_results 지정되고 계정에 Blob 수가 그 이상인 경우 생성기는 완료되면 채워진 next_marker 필드를 갖습니다. 이 표식은 더 많은 결과가 필요한 경우 새 생성기를 만드는 데 사용할 수 있습니다.

list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

prefix

str

기본값: None

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

num_results

int

기본값: None

모든 <xref:azure.storage.blob.blockblobservice.BlobPrefix> 요소를 포함하여 반환할 최대 Blob 수를 지정합니다. 요청이 num_results 지정하지 않거나 5,000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다. num_results 0보다 작거나 같은 값으로 설정하면 오류 응답 코드 400(잘못된 요청)이 발생합니다.

include

Include

기본값: None

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

delimiter

str

기본값: None

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

marker

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

list_blobs

지정된 컨테이너 아래의 Blob을 나열하는 생성기를 반환합니다. 생성기는 서비스에서 반환된 연속 토큰을 느리게 따르고 모든 Blob이 반환되거나 num_results 도달하면 중지됩니다.

num_results 지정되고 계정에 Blob 수가 그 이상인 경우 생성기는 완료되면 채워진 next_marker 필드를 갖습니다. 이 표식은 더 많은 결과가 필요한 경우 새 생성기를 만드는 데 사용할 수 있습니다.

list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

prefix

str

기본값: None

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

num_results

int

기본값: None

모든 <xref:azure.storage.blob.blockblobservice.BlobPrefix> 요소를 포함하여 반환할 최대 Blob 수를 지정합니다. 요청이 num_results 지정하지 않거나 5,000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다. num_results 0보다 작거나 같은 값으로 설정하면 오류 응답 코드 400(잘못된 요청)이 발생합니다.

include

Include

기본값: None

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

delimiter

str

기본값: None

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

marker

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

list_containers

지정된 계정 아래의 컨테이너를 나열하는 생성기를 반환합니다. 생성기는 서비스에서 반환된 연속 토큰을 느리게 따르고 모든 컨테이너가 반환되거나 num_results 도달하면 중지됩니다.

num_results 지정되고 계정에 컨테이너 수가 그 이상인 경우 생성기는 완료되면 채워진 next_marker 필드를 갖게 됩니다. 이 표식은 더 많은 결과가 필요한 경우 새 생성기를 만드는 데 사용할 수 있습니다.

list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)

매개 변수

prefix

str

기본값: None

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

num_results

int

기본값: None

반환할 최대 컨테이너 수를 지정합니다. 단일 목록 요청은 최대 1,000명의 contianers 및 잠재적으로 후속 토큰을 반환하여 추가 다시 요청을 가져올 수 있습니다.

include_metadata

bool

기본값: False

컨테이너 메타데이터가 응답에 반환되도록 지정합니다.

marker

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

make_blob_url

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

make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)

매개 변수

container_name

str

필수

컨테이너의 이름입니다.

blob_name

str

필수

Blob의 이름입니다.

protocol

str

기본값: None

사용할 프로토콜: 'http' 또는 'https'. 지정하지 않으면 는 BaseBlobService가 초기화될 때 지정된 프로토콜을 사용합니다.

sas_token

str

기본값: None

generate_shared_access_signature 사용하여 만든 공유 액세스 서명 토큰입니다.

snapshot

str

기본값: None

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

반환

Blob 액세스 URL입니다.

반환 형식

str

make_container_url

컨테이너에 액세스하는 URL을 만듭니다.

make_container_url(container_name, protocol=None, sas_token=None)

매개 변수

container_name

str

필수

컨테이너의 이름입니다.

protocol

str

기본값: None

사용할 프로토콜: 'http' 또는 'https'. 지정하지 않으면 는 BaseBlobService가 초기화될 때 지정된 프로토콜을 사용합니다.

sas_token

str

기본값: None

generate_shared_access_signature 사용하여 만든 공유 액세스 서명 토큰입니다.

반환

컨테이너 액세스 URL입니다.

반환 형식

str

put_block

blob의 일부로 커밋할 새 블록을 만듭니다.

put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

Blob의 이름입니다.

block

IOBase 또는 <xref:<xref:bytes Content> of <xref:the block.>>

필수

블록의 내용입니다.

block_id

str

필수

블록을 식별하는 문자열 값입니다. 문자열 크기는 64바이트보다 작거나 같아야 합니다. 지정된 Blob의 경우 block_id 각 블록의 크기가 같아야 합니다.

validate_content

bool

기본값: False

true이면 블록 콘텐츠의 MD5 해시를 계산합니다. 스토리지 서비스는 전송된 해시와 함께 도착한 콘텐츠의 해시를 확인합니다. 이는 https 대신 https(기본값)를 사용하여 이미 유효성을 검사하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 이 MD5 해시는 blob에 저장되지 않습니다.

lease_id

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

put_block_from_url

blob의 일부로 커밋할 새 블록을 만듭니다.

put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

Blob의 이름입니다.

copy_source_url

str

필수

원본 데이터의 URL입니다. 공용이거나 공유 액세스 서명이 연결된 모든 Azure Blob 또는 파일을 가리킬 수 있습니다.

source_range_start

int

기본값: None

이는 복사 원본에서 가져와야 하는 바이트(포함) 범위의 시작을 나타냅니다.

source_range_end

int

기본값: None

복사 원본에서 가져와야 하는 바이트(포함) 범위의 끝을 나타냅니다.

block_id

str

필수

블록을 식별하는 문자열 값입니다. 문자열 크기는 64바이트보다 작거나 같아야 합니다. 지정된 Blob의 경우 block_id 각 블록의 크기가 같아야 합니다.

source_content_md5

str

기본값: None

지정된 경우 서비스는 블록 콘텐츠의 MD5 해시를 계산하고 이 값과 비교합니다.

lease_id

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

put_block_list

blob를 구성하는 블록 ID 목록을 지정하여 blob에 기록합니다. Blob의 일부로 작성하려면 블록이 이전 블록 배치 작업에서 서버에 성공적으로 기록되어야 합니다.

블록 목록 배치를 호출하여 변경된 블록만 업로드한 다음 새 블록과 기존 블록을 함께 커밋하여 Blob을 업데이트할 수 있습니다. 이렇게 하려면 커밋된 블록 목록에서 또는 커밋되지 않은 블록 목록에서 블록을 커밋하거나, 어느 목록에 포함되었더라도 가장 최근에 업로드된 블록 버전을 커밋할지를 지정하면 됩니다.

put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

block_list

list(BlobBlock)

필수

블록 ID 및 블록 상태를 포함하는 목록 <xref:azure.storeage.blob.models.BlobBlock> 입니다.

content_settings

ContentSettings

기본값: None

Blob에서 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

metadata

dict(str, str)

기본값: None

blob과 메타데이터로 연결된 이름-값 쌍입니다.

validate_content

bool

기본값: False

true이면 블록 목록 콘텐츠의 MD5 해시를 계산합니다. 스토리지 서비스는 전송된 해시와 함께 도착한 블록 목록 콘텐츠의 해시를 확인합니다. 이는 https 대신 https(기본값)를 사용하여 이미 유효성을 검사하는 경우 와이어에서 비트플립을 검색하는 데 주로 유용합니다. 이 검사 Blob 자체의 콘텐츠가 아니라 블록 목록 콘텐츠와 연결됩니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

standard_blob_tier

StandardBlobTier

기본값: None

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

반환

업데이트된 블록 Blob에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

release_blob_lease

임대를 해제합니다. 요청에 지정된 임대 ID가 blob과 연결된 임대 ID와 일치할 경우 임대를 해제할 수 있습니다. 임대를 해제하면 해제가 완료되는 즉시 다른 클라이언트가 해당 blob에 대한 임대를 획득할 수 있습니다.

release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

lease_id

str

필수

활성 임대에 대한 임대 ID입니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

release_container_lease

임대를 해제합니다. 지정된 lease_id 컨테이너와 연결된 임대와 일치하는 경우 임대가 해제될 수 있습니다. 임대를 해제하면 해제가 완료되는 즉시 다른 클라이언트가 해당 컨테이너에 대한 임대를 획득할 수 있습니다.

release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

lease_id

str

필수

활성 임대에 대한 임대 ID입니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

renew_blob_lease

임대를 갱신합니다. 요청에 지정된 임대 ID가 blob과 연결된 임대 ID와 일치할 경우 임대를 갱신할 수 있습니다. 임대가 만료되었더라도 blob가 수정되지 않았거나 임대 만료 후 다시 임대되지 않은 경우에 한해 임대를 갱신할 수 있습니다. 임대를 갱신하면 임대 기간 시간이 재설정됩니다.

renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

lease_id

str

필수

활성 임대에 대한 임대 ID입니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

str

renew_container_lease

임대를 갱신합니다. 지정된 임대 ID가 컨테이너와 연결된 임대 ID와 일치하는 경우 임대를 갱신할 수 있습니다. 임대가 만료되었더라도 컨테이너가 임대 만료 후 다시 임대되지 않은 경우에 한해 임대를 갱신할 수 있습니다. 임대를 갱신하면 임대 기간 시간이 재설정됩니다.

renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

lease_id

str

필수

활성 임대에 대한 임대 ID입니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

str

set_blob_metadata

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

set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

metadata

dict(str, str)

기본값: None

이름 및 값 쌍을 포함하는 Dict입니다. 이 작업을 호출할 때마다 blob에 연결된 기존의 모든 메타데이터가 바뀝니다. blob에서 모든 메타데이터를 제거하려면 메타데이터 헤더 없이 이 작업을 호출하세요.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

업데이트된 Blob에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

set_blob_properties

Blob의 시스템 속성을 설정합니다. content_settings 대해 하나의 속성이 설정된 경우 모든 속성이 재정의됩니다.

set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

content_settings

ContentSettings

기본값: None

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다.

lease_id

str

기본값: None

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

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

업데이트된 Blob에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

set_blob_service_properties

Azure 스토리지 분석 포함하여 스토리지 계정 Blob 서비스의 속성을 설정합니다. 요소(예: 로깅)가 None으로 남아 있으면 해당 기능에 대한 서비스의 기존 설정이 유지됩니다.

set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)

매개 변수

logging

Logging

기본값: None

Azure 분석 Logging 설정을 그룹화합니다.

hour_metrics

Metrics

기본값: None

시간 메트릭 설정은 Blob에 대한 시간별 집계에서 API별로 그룹화된 요청 통계의 요약을 제공합니다.

minute_metrics

Metrics

기본값: None

분 메트릭 설정은 Blob의 각 분에 대한 요청 통계를 제공합니다.

cors

list(CorsRule)

기본값: None

목록에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 빈 목록을 지정하면 모든 CORS 규칙이 삭제되고 서비스에 대해 CORS가 비활성화됩니다.

target_version

str

기본값: None

들어오는 요청의 버전이 지정되지 않은 경우 요청에 사용할 기본 버전을 나타냅니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

delete_retention_policy

DeleteRetentionPolicy

기본값: None

삭제 보존 정책은 삭제된 Blob을 유지할지 여부를 지정합니다. 또한 유지할 Blob의 일 수와 버전을 지정합니다.

static_website

StaticWebsite

기본값: None

정적 웹 사이트 기능을 사용할지 여부를 지정하고, 그렇다면 사용할 인덱스 문서와 404 오류 문서를 나타냅니다.

set_container_acl

공유 액세스 서명과 함께 사용할 수 있는 지정된 컨테이너 또는 저장된 액세스 정책에 대한 권한을 설정합니다. 권한은 컨테이너의 blob에 공개적으로 액세스할 수 있는지 여부를 나타냅니다.

set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

signed_identifiers

dict(str, AccessPolicy)

기본값: None

컨테이너와 연결할 액세스 정책 사전입니다. 사전에는 최대 5개의 요소가 포함될 수 있습니다. 빈 사전은 서비스에 설정된 액세스 정책을 지웁히게 됩니다.

public_access

PublicAccess

기본값: None

가능한 값은 컨테이너, Blob입니다.

lease_id

str

기본값: None

지정된 경우 set_container_acl 컨테이너의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 성공합니다.

if_modified_since

datetime

기본값: None

datetime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

datetime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

업데이트된 컨테이너에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

set_container_metadata

지정된 컨테이너에 대해 하나 이상의 사용자 정의 이름-값 쌍을 설정합니다. 이 작업을 호출할 때마다 컨테이너에 연결된 기존의 모든 메타데이터가 바뀝니다. 컨테이너에서 모든 메타데이터를 제거하려면 메타데이터 받아쓰기 없이 이 작업을 호출합니다.

set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

metadata

dict(str, str)

기본값: None

컨테이너와 메타데이터로 연결할 이름-값 쌍을 포함하는 받아쓰기입니다. 예: {'category':'test'}

lease_id

str

기본값: None

지정된 경우 set_container_metadata 컨테이너의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 성공합니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

업데이트된 컨테이너에 대한 ETag 및 마지막으로 수정된 속성

반환 형식

ResourceProperties

set_proxy

HTTP CONNECT 터널링에 대한 프록시 서버 호스트 및 포트를 설정합니다.

set_proxy(host, port, user=None, password=None)

매개 변수

host

str

필수

프록시의 주소입니다. 예: '192.168.0.100'

port

int

필수

프록시의 포트입니다. 예: 6000

user

str

기본값: None

프록시 권한 부여를 위한 사용자입니다.

password

str

기본값: None

프록시 권한 부여에 대한 암호입니다.

set_standard_blob_tier

Blob에서 블록 Blob 계층을 설정합니다. 이 API는 표준 스토리지 계정의 블록 Blob에 대해서만 지원됩니다.

:p aram RehydratePriority rehydrate_priority: 보관된 Blob을 리하우징할 우선 순위를 나타냅니다.

set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

업데이트할 Blob의 이름입니다.

standard_blob_tier

StandardBlobTier

필수

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

timeout

int

기본값: None

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

rehydrate_priority

기본값: None

snapshot_blob

Blob의 읽기 전용 스냅숏을 만듭니다.

snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

metadata

dict(str, str)

기본값: None

blob와 연결된 사용자 정의 이름-값 쌍을 지정합니다. 이름-값 쌍이 지정되지 않은 경우 기본 blob 메타데이터를 스냅숏으로 복사합니다. 이름-값 쌍이 하나 이상 지정되었으면 지정된 메타데이터를 사용해서 스냅숏이 생성되고, 기본 blob에서 메타데이터가 복사되지 않습니다.

if_modified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

기본값: None

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_match

str

기본값: None

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

if_none_match

str

기본값: None

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

lease_id

str

기본값: None

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

cpk

CustomerProvidedEncryptionKey

기본값: None

지정된 키를 사용하여 서비스 쪽의 데이터를 암호화합니다. 고객이 제공한 키의 사용은 HTTPS를 통해 수행해야 합니다. 암호화 키 자체가 요청에 제공되므로 키를 전송하려면 보안 연결을 설정해야 합니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

반환

스냅샷 속성

반환 형식

Blob

undelete_blob

삭제되지 않은 Blob 작업은 일시 삭제된 Blob 또는 스냅샷 내용 및 메타데이터를 복원합니다. 일시 삭제되지 않은 Blob 또는 스냅샷 삭제를 취소하려고 하면 아무 변경도 없이 성공합니다.

undelete_blob(container_name, blob_name, timeout=None)

매개 변수

container_name

str

필수

기존 컨테이너의 이름입니다.

blob_name

str

필수

기존 Blob의 이름입니다.

timeout

int

기본값: None

시간 초과 매개 변수는 초 단위로 표현됩니다.

특성

protocol

request_session

socket_timeout

MAX_BLOCK_SIZE

MAX_BLOCK_SIZE = 4194304

MAX_CHUNK_GET_SIZE

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE

MAX_SINGLE_GET_SIZE = 33554432

MAX_SINGLE_PUT_SIZE

MAX_SINGLE_PUT_SIZE = 67108864

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305