Share via

BlobClient 클래스

  • 참조

특정 Blob과 상호 작용하는 클라이언트이지만 해당 Blob은 아직 존재하지 않을 수 있습니다.

추가 선택적 구성을 보려면 여기를 클릭하세요.

상속
azure.storage.blob._shared.base_client.StorageAccountHostsMixin
BlobClient
azure.storage.blob._encryption.StorageEncryptionMixin
BlobClient

생성자

BlobClient(account_url: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)

매개 변수

account_url
str
필수

스토리지 계정에 대한 URI입니다. Blob에 대한 전체 URI가 지정된 클라이언트를 만들려면 classmethod를 from_blob_url 사용합니다.

container_name
str
필수

Blob의 컨테이너 이름입니다.

blob_name
str
필수

상호 작용할 Blob의 이름입니다. 지정한 경우 이 값은 Blob URL에 지정된 Blob 값을 재정의합니다.

snapshot
str
기본값: None

작동할 선택적 Blob 스냅샷. 스냅샷 ID 문자열 또는 에서 create_snapshot반환된 응답일 수 있습니다.

credential
기본값: None

인증할 자격 증명입니다. 계정 URL에 이미 SAS 토큰이 있는 경우 선택 사항입니다. 값은 SAS 토큰 문자열, azure.core.credentials의 AzureSasCredential 또는 AzureNamedKeyCredential의 instance, 계정 공유 액세스 키 또는 azure.identity에서 TokenCredentials 클래스의 instance 수 있습니다. 리소스 URI에 이미 SAS 토큰이 포함된 경우 명시적 자격 증명을 위해 무시됩니다.

  • 충돌하는 SAS 토큰이 ValueError를 발생시키는 AzureSasCredential의 경우를 제외하고 AzureNamedKeyCredential의 instance 사용하는 경우 "name"은 스토리지 계정 이름이고 "키"는 스토리지 계정 키여야 합니다.
api_version
str

요청에 사용할 Storage API 버전입니다. 기본값은 현재 SDK와 호환되는 최신 서비스 버전입니다. 이전 버전으로 설정하면 기능 호환성이 저하될 수 있습니다.

버전 12.2.0의 새로운 기능

secondary_hostname
str

보조 엔드포인트의 호스트 이름입니다.

max_block_size
int

블록 Blob을 청크로 업로드하기 위한 최대 청크 크기입니다. 기본값은 4*1024*1024 또는 4MB입니다.

max_single_put_size
int

blob 크기가 max_single_put_size 작거나 같으면 blob은 하나의 http PUT 요청으로만 업로드됩니다. Blob 크기가 max_single_put_size보다 크면 Blob이 청크로 업로드됩니다. 기본값은 64*1024*1024 또는 64MB입니다.

min_large_block_upload_threshold
int

블록 Blob을 업로드할 때 메모리 효율적인 알고리즘을 사용하는 데 필요한 최소 청크 크기입니다. 기본값은 4*1024*1024+1입니다.

use_byte_buffer
bool

블록 Blob 업로드에 바이트 버퍼를 사용합니다. 기본값은 False입니다.

max_page_size
int

페이지 Blob을 업로드하기 위한 최대 청크 크기입니다. 기본값은 4*1024*1024 또는 4MB입니다.

max_single_get_size
int

단일 호출에서 다운로드할 Blob의 최대 크기이며, 초과된 부분은 청크로 다운로드됩니다(병렬일 수 있음). 기본값은 32*1024*1024 또는 32MB입니다.

max_chunk_get_size
int

Blob 다운로드에 사용되는 최대 청크 크기입니다. 기본값은 4*1024*1024 또는 4MB입니다.

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있을 때 작동할 Blob의 버전을 지정합니다.

메서드

abort_copy

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

이렇게 하면 길이가 0이고 전체 메타데이터가 있는 대상 Blob이 남습니다. 복사 작업이 이미 종료된 경우 오류가 발생합니다.
acquire_lease

새로운 임대를 요청합니다.

Blob에 활성 임대가 없는 경우 Blob Service는 Blob에 임대를 만들고 새 임대를 반환합니다.
append_block

기존 추가 Blob의 끝에 새 데이터 블록을 커밋합니다.
append_block_from_url

원본 URL에서 내용을 읽는 Blob의 일부로 커밋할 새 블록을 만듭니다.
clear_page

페이지 범위를 지웁니다.
close

이 방법은 클라이언트가 연 소켓을 닫는 것입니다. 컨텍스트 관리자와 함께 사용할 때 사용할 필요가 없습니다.
commit_block_list

블록 목록 커밋 작업은 Blob을 구성하는 블록 ID 목록을 지정하여 Blob을 작성합니다.
create_append_blob

새 추가 Blob을 만듭니다. 이 작업은 새 0 길이 추가 Blob을 만듭니다. 기존 Blob의 콘텐츠는 새로 초기화된 추가 Blob으로 덮어씁니다. 추가 Blob에 콘텐츠를 추가하려면 또는 append_block_from_url 메서드를 append_block 호출합니다.
create_page_blob

지정된 크기의 새 페이지 Blob을 만듭니다.
create_snapshot

Blob의 스냅숏을 만듭니다.

스냅샷은 특정 시점에 생성된 Blob의 읽기 전용 버전입니다. 읽기, 복사 또는 삭제할 수 있지만 수정할 수는 없습니다. 스냅샷을 사용하면 특정 시점에서 표시된 대로 Blob을 백업할 수 있습니다.

blob의 스냅샷 스냅샷 가져온 기본 Blob과 이름이 같으며 DateTime 값이 추가되어 스냅샷 수행된 시간을 나타냅니다.
delete_blob

지정한 blob에 삭제를 표시합니다.

이 blob는 나중에 가비지 수집 중에 삭제됩니다. Blob을 삭제하려면 해당 스냅숏을 모두 삭제해야 합니다. delete_blob() 작업과 동시에 둘 다 삭제할 수 있습니다.

서비스에 대해 삭제 보존 정책을 사용하도록 설정한 경우 이 작업은 Blob을 일시 삭제하고 지정된 일 수 동안 Blob을 유지합니다. 지정된 일 수 후에는 가비지 수집 중에 Blob의 데이터가 서비스에서 제거됩니다. 일시 삭제된 Blob은 include=['deleted'] 옵션을 지정하여 list_blobs 액세스할 수 있습니다. 일시 삭제된 Blob은 작업을 사용하여 <xref:azure.storage.blob.undelete> 복원할 수 있습니다.
delete_immutability_policy

불변성 정책 삭제 작업은 Blob에서 불변성 정책을 삭제합니다.

버전 12.10.0의 새로운 기능: 이 작업은 API 버전 '2020-10-02'에서 도입되었습니다.
download_blob

Blob을 StorageStreamDownloader에 다운로드합니다. readall() 메서드를 사용하여 모든 콘텐츠를 읽어야 합니다. 그렇지 않은 경우 Blob을 스트림으로 다운로드하는 데 readinto()를 사용해야 합니다. chunks()를 사용하면 사용자가 청크의 콘텐츠를 반복할 수 있는 반복기가 반환됩니다.
exists

정의된 매개 변수가 있는 Blob이 있으면 True를 반환하고, 그렇지 않으면 False를 반환합니다.
from_blob_url

Blob URL에서 BlobClient를 만듭니다. 이 기능은 Blob 이름에 '/'가 있는 사용자 지정된 Blob URL을 지원하지 않습니다.
from_connection_string

연결 문자열에서 BlobClient를 만듭니다.
get_account_information

Blob이 있는 스토리지 계정과 관련된 정보를 가져옵니다.

사용자에게 컨테이너 또는 Blob에 대한 SAS가 있는 경우에도 정보를 검색할 수 있습니다. 반환된 사전의 키에는 'sku_name' 및 'account_kind'이 포함됩니다.
get_blob_properties

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

태그 가져오기 작업을 사용하면 사용자가 Blob 또는 특정 Blob 버전 또는 스냅샷 태그를 가져올 수 있습니다.

버전 12.4.0의 새로운 기능: 이 작업은 API 버전 '2019-12-12'에서 도입되었습니다.
get_block_list

블록 목록 가져오기 작업은 블록 Blob의 일부로 업로드된 블록 목록을 검색합니다.
get_page_range_diff_for_managed_disk

관리 디스크 또는 스냅샷 유효한 페이지 범위 목록을 반환합니다.

참고

이 작업은 관리 디스크 계정에만 사용할 수 있습니다.

버전 12.2.0의 새로운 기능: 이 작업은 API 버전 '2019-07-07'에서 도입되었습니다.
get_page_ranges

사용되지 않음: 페이지 Blob 또는 페이지 Blob의 스냅샷 유효한 페이지 범위 목록을 반환합니다.
list_page_ranges

페이지 Blob 또는 페이지 Blob의 스냅샷 유효한 페이지 범위 목록을 반환합니다. previous_snapshot 지정하면 결과는 대상 Blob과 이전 스냅샷 간의 변경 내용 diff 됩니다.
query_blob

사용자가 간단한 쿼리 식을 제공하여 Blob/또는 Blob 스냅샷 데이터를 선택/프로젝트할 수 있습니다. 이 작업은 BlobQueryReader를 반환합니다. 사용자는 readall() 또는 readinto()를 사용하여 쿼리 데이터를 가져와야 합니다.
resize_blob

페이지 blob 크기를 지정된 크기로 조정합니다.

지정된 값이 현재 blob 크기보다 작으면 지정된 값을 넘는 모든 페이지가 지워집니다.
seal_append_blob

Seal 작업은 추가 Blob을 봉인하여 읽기 전용으로 만듭니다.

버전 12.4.0의 새로운 기능
set_blob_metadata

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

태그 설정 작업을 사용하면 사용자가 Blob 또는 특정 Blob 버전에서 태그를 설정할 수 있지만 스냅샷 설정할 수 없습니다. 이 작업에 대한 각 호출은 Blob에 연결된 모든 기존 태그를 대체합니다. Blob에서 모든 태그를 제거하려면 태그가 설정되지 않은 상태에서 이 작업을 호출합니다.

버전 12.4.0의 새로운 기능: 이 작업은 API 버전 '2019-12-12'에서 도입되었습니다.
set_http_headers

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

content_settings 대해 하나의 속성이 설정되면 모든 속성이 재정의됩니다.
set_immutability_policy

불변성 정책 설정 작업은 Blob에서 불변성 정책을 설정합니다.

버전 12.10.0의 새로운 기능: 이 작업은 API 버전 '2020-10-02'에서 도입되었습니다.
set_legal_hold

법적 보존 설정 작업은 Blob에 대한 법적 보존을 설정합니다.

버전 12.10.0의 새로운 기능: 이 작업은 API 버전 '2020-10-02'에서 도입되었습니다.
set_premium_page_blob_tier

Blob에서 페이지 Blob 계층을 설정합니다. 이 API는 프리미엄 계정의 페이지 Blob에 대해서만 지원됩니다.
set_sequence_number

Blob 시퀀스 번호를 설정합니다.
set_standard_blob_tier

이 작업은 블록 Blob에서 계층을 설정합니다.

블록 Blob의 계층은 핫/쿨/보관 스토리지 유형을 결정합니다. 이 작업은 Blob의 ETag를 업데이트하지 않습니다.
stage_block

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

URL에서 콘텐츠를 읽는 Blob의 일부로 커밋할 새 블록을 만듭니다.
start_copy_from_url

지정된 URL에서 Blob을 복사합니다.

이 작업은 복사 작업의 상태 검사 또는 중단하는 데 사용할 수 있는 copy_status 및 copy_id 포함하는 사전을 반환합니다. copy_status 복사가 동기적으로 완료된 경우 '성공'이 되고, 복사본이 비동기적으로 시작된 경우 '보류 중'이 됩니다. 비동기 복사본의 경우 메서드를 폴링 get_blob_properties 하고 복사 상태 확인하여 상태 확인할 수 있습니다. 복사를 강제로 동기로 설정하려면 requires_sync True로 설정합니다. Blob 서비스는 최상의 노력으로 blob를 복사합니다.

복사 작업의 원본 Blob은 블록 Blob, 추가 Blob 또는 페이지 Blob일 수 있습니다. 대상 blob가 이미 있으면 원본 blob와 동일한 blob 유형이어야 합니다. 기존 대상 blob는 덮어씁니다. 복사 작업이 진행 중일 때는 대상 blob를 수정할 수 없습니다.

페이지 Blob에서 복사할 때 Blob 서비스는 처음에 모든 0을 포함하는 원본 Blob 길이의 대상 페이지 Blob을 만듭니다. 그런 후 원본 페이지 범위가 열거되고 비어 있지 않은 범위가 복사됩니다.

블록 Blob 또는 추가 Blob의 경우 Blob 서비스는 이 작업에서 반환하기 전에 길이가 0인 커밋된 Blob을 만듭니다. 블록 Blob에서 복사할 때 커밋된 모든 블록과 해당 블록 ID가 복사됩니다. 커밋되지 않은 블록은 복사되지 않습니다. 복사 작업이 끝나면 대상 Blob은 원본과 동일한 커밋된 블록 수를 갖게 됩니다.

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

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

삭제 보존 정책에 설정된 지정된 일 수 내에 사용하는 경우에만 작업이 성공합니다.

Blob 버전 관리를 사용하는 경우 이 메서드를 사용하여 기본 Blob을 복원할 수 없습니다. 대신 현재 버전으로 승격하려는 Blob 버전의 URL과 함께 를 사용합니다 start_copy_from_url .
upload_blob

자동 청크를 사용하여 데이터 원본에서 새 Blob을 만듭니다.
upload_blob_from_url

지정된 URL에서 Blob의 콘텐츠를 읽는 새 블록 Blob을 만듭니다. 기존 Blob의 콘텐츠는 새 Blob으로 덮어씁니다.
upload_page

페이지 업로드 작업은 페이지 Blob에 페이지 범위를 씁니다.
upload_pages_from_url

페이지 업로드 작업은 URL에서 콘텐츠를 읽는 페이지 Blob에 페이지 범위를 씁니다.

abort_copy

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

이렇게 하면 길이가 0이고 전체 메타데이터가 있는 대상 Blob이 남습니다. 복사 작업이 이미 종료된 경우 오류가 발생합니다.

abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> None

매개 변수

copy_id
str 또는 BlobProperties
필수

중단할 복사 작업입니다. ID 문자열 또는 BlobProperties의 instance 수 있습니다.

반환 형식

None

acquire_lease

새로운 임대를 요청합니다.

Blob에 활성 임대가 없는 경우 Blob Service는 Blob에 임대를 만들고 새 임대를 반환합니다.

acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClient

매개 변수

lease_duration
int
필수

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

lease_id
str
필수

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

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

BlobLeaseClient 개체입니다.

반환 형식

BlobLeaseClient

append_block

기존 추가 Blob의 끝에 새 데이터 블록을 커밋합니다.

append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

매개 변수

data
bytes 또는 str 또는 Iterable
필수

블록의 콘텐츠입니다. 바이트, 텍스트, 반복 가능 개체 또는 파일과 같은 개체일 수 있습니다.

length
int
필수

블록의 크기(바이트)입니다.

validate_content
bool

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

maxsize_condition
int

선택적 조건부 헤더입니다. 추가 Blob에 허용되는 최대 길이(바이트)입니다. 블록 추가 작업으로 인해 Blob이 해당 제한을 초과하거나 Blob 크기가 이 헤더에 지정된 값보다 큰 경우 MaxBlobSizeConditionNotMet 오류(HTTP 상태 코드 412 - 사전 조건 실패)로 인해 요청이 실패합니다.

appendpos_condition
int

추가 블록 작업에만 사용되는 선택적 조건부 헤더입니다. 비교할 바이트 오프셋을 나타내는 숫자입니다. 추가 블록은 추가 위치가 이 숫자와 같은 경우에만 성공합니다. 그렇지 않은 경우 AppendPositionConditionNotMet 오류(HTTP 상태 코드 412 - 사전 조건 실패)로 요청이 실패합니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

encoding
str

기본값은 UTF-8입니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 dict(Etag, 마지막으로 수정됨, 추가 오프셋, 커밋된 블록 수).

반환 형식

dict(str, Any)

append_block_from_url

원본 URL에서 내용을 읽는 Blob의 일부로 커밋할 새 블록을 만듭니다.

append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

매개 변수

copy_source_url
str
필수

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

source_offset
int
필수

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

source_length
int
필수

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

source_content_md5
bytearray

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

maxsize_condition
int

선택적 조건부 헤더입니다. 추가 Blob에 허용되는 최대 길이(바이트)입니다. 블록 추가 작업으로 인해 Blob이 해당 제한을 초과하거나 Blob 크기가 이 헤더에 지정된 값보다 큰 경우 MaxBlobSizeConditionNotMet 오류(HTTP 상태 코드 412 - 사전 조건 실패)로 인해 요청이 실패합니다.

appendpos_condition
int

추가 블록 작업에만 사용되는 선택적 조건부 헤더입니다. 비교할 바이트 오프셋을 나타내는 숫자입니다. 추가 블록은 추가 위치가 이 숫자와 같은 경우에만 성공합니다. 그렇지 않은 경우 AppendPositionConditionNotMet 오류(HTTP 상태 코드 412 - 사전 조건 실패)로 요청이 실패합니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

대상 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 대상 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

source_if_modified_since
datetime

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

source_if_unmodified_since
datetime

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

source_etag
str

원본 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

source_match_condition
MatchConditions

etag에 사용할 원본 일치 조건입니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

source_authorization
str

원본 Blob에 액세스하기 위해 클라이언트 암호를 사용하여 서비스 주체로 인증합니다. "전달자"가 source_authorization 문자열의 접두사인지 확인합니다.

clear_page

페이지 범위를 지웁니다.

clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]

매개 변수

offset
int
필수

Blob의 섹션에 쓰는 데 사용할 바이트 범위의 시작입니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

length
int
필수

Blob의 섹션에 쓰는 데 사용할 바이트 수입니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_sequence_number_lte
int

Blob의 시퀀스 번호가 지정된 값보다 작거나 같으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_sequence_number_lt
int

Blob의 시퀀스 번호가 지정된 값보다 작으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_sequence_number_eq
int

Blob의 시퀀스 번호가 지정된 값과 같으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

cpk
CustomerProvidedEncryptionKey

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

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 dict(Etag 및 마지막으로 수정됨).

반환 형식

dict(str, Any)

close

이 방법은 클라이언트가 연 소켓을 닫는 것입니다. 컨텍스트 관리자와 함께 사용할 때 사용할 필요가 없습니다.

close()

commit_block_list

블록 목록 커밋 작업은 Blob을 구성하는 블록 ID 목록을 지정하여 Blob을 작성합니다.

commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]

매개 변수

block_list
list
필수

Blockblobs 목록입니다.

content_settings
ContentSettings
필수

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다. 콘텐츠 형식, 인코딩, 언어, 처리, md5 및 캐시 제어를 설정하는 데 사용됩니다.

metadata
dict[str, str]
필수

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

tags
dict(str, str)

Blob과 연결된 이름-값 쌍을 태그로 사용합니다. 태그는 대/소문자를 구분합니다. 태그 집합에는 최대 10개의 태그가 포함될 수 있습니다. 태그 키는 1자에서 128자 사이여야 하며 태그 값은 0~256자여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(), 더하기( >><<+), 빼기(-), 마침표(.), solidus(/), 콜론(:), 등호(=), 밑줄(_)이 포함됩니다.

버전 12.4.0의 새로운 기능

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

immutability_policy
ImmutabilityPolicy

Blob, Blob 스냅샷 또는 Blob 버전의 불변성 정책을 지정합니다.

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에서 도입되었습니다.

legal_hold
bool

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

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에서 도입되었습니다.

validate_content
bool

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

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

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

버전 12.4.0의 새로운 기능

standard_blob_tier
StandardBlobTier

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

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 dict(Etag 및 마지막으로 수정됨).

반환 형식

dict(str, Any)

create_append_blob

새 추가 Blob을 만듭니다. 이 작업은 새 0 길이 추가 Blob을 만듭니다. 기존 Blob의 콘텐츠는 새로 초기화된 추가 Blob으로 덮어씁니다. 추가 Blob에 콘텐츠를 추가하려면 또는 append_block_from_url 메서드를 append_block 호출합니다.

create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

매개 변수

content_settings
ContentSettings
필수

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다. 콘텐츠 형식, 인코딩, 언어, 처리, md5 및 캐시 제어를 설정하는 데 사용됩니다.

metadata
dict(str, str)
필수

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

tags
dict(str, str)

Blob과 연결된 이름-값 쌍을 태그로 사용합니다. 태그는 대/소문자를 구분합니다. 태그 집합에는 최대 10개의 태그가 포함될 수 있습니다. 태그 키는 1자에서 128자 사이여야 하며 태그 값은 0~256자여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(), 더하기( >><<+), 빼기(-), 마침표(.), solidus(/), 콜론(:), 등호(=), 밑줄(_)이 포함됩니다.

버전 12.4.0의 새로운 기능

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

immutability_policy
ImmutabilityPolicy

Blob, Blob 스냅샷 또는 Blob 버전의 불변성 정책을 지정합니다.

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에서 도입되었습니다.

legal_hold
bool

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

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에서 도입되었습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 dict(Etag 및 마지막으로 수정됨).

반환 형식

dict[str, Any]

create_page_blob

지정된 크기의 새 페이지 Blob을 만듭니다.

create_page_blob(size: int, content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, premium_page_blob_tier: str | PremiumPageBlobTier | None = None, **kwargs) -> Dict[str, str | datetime]

매개 변수

size
int
필수

페이지 Blob의 최대 크기(최대 1TB)를 지정합니다. 페이지 blob 크기는 512바이트 경계로 정렬되어야 합니다.

content_settings
ContentSettings
필수

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다. 콘텐츠 형식, 인코딩, 언어, 처리, md5 및 캐시 제어를 설정하는 데 사용됩니다.

metadata
dict(str, str)
필수

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

premium_page_blob_tier
PremiumPageBlobTier
필수

Blob을 설정할 페이지 Blob 계층 값입니다. 계층은 Blob의 크기 및 허용되는 IOPS 수와 관련이 있습니다. 이는 Premium Storage 계정의 페이지 Blob에만 적용됩니다.

tags
dict(str, str)

Blob과 연결된 이름-값 쌍을 태그로 사용합니다. 태그는 대/소문자를 구분합니다. 태그 집합에는 최대 10개의 태그가 포함될 수 있습니다. 태그 키는 1~128자 사이여야 하며 태그 값은 0~256자 사이여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(), 더하기( >><<+), 빼기(-), 마침표(.), solidus(/), 콜론(:), 등호(=), 밑줄(_)이 포함됩니다.

버전 12.4.0의 새로운 기능입니다.

sequence_number
int

페이지 Blob에만 해당합니다. 시퀀스 번호는 요청 추적을 위해 사용할 수 있는 사용자 제어 값입니다. 시퀀스 번호 값은 0에서 2^63 - 1 사이여야 합니다. 기본값은 0입니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

immutability_policy
ImmutabilityPolicy

Blob, Blob 스냅샷 또는 Blob 버전의 불변성 정책을 지정합니다.

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에 도입되었습니다.

legal_hold
bool

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

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에 도입되었습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 dict(Etag 및 마지막으로 수정됨).

반환 형식

dict[str, Any]

create_snapshot

Blob의 스냅숏을 만듭니다.

스냅샷은 특정 시점에 생성된 Blob의 읽기 전용 버전입니다. 읽기, 복사 또는 삭제할 수 있지만 수정할 수는 없습니다. 스냅샷을 사용하면 특정 시점에서 표시된 대로 Blob을 백업할 수 있습니다.

blob의 스냅샷 스냅샷 가져온 기본 Blob과 이름이 같으며 DateTime 값이 추가되어 스냅샷 수행된 시간을 나타냅니다.

create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

매개 변수

metadata
dict(str, str)
필수

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

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

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

버전 12.4.0의 새로운 기능입니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 받아쓰기(스냅샷 ID, Etag 및 마지막으로 수정됨).

반환 형식

dict[str, Any]

delete_blob

지정한 blob에 삭제를 표시합니다.

이 blob는 나중에 가비지 수집 중에 삭제됩니다. Blob을 삭제하려면 해당 스냅숏을 모두 삭제해야 합니다. delete_blob() 작업과 동시에 둘 다 삭제할 수 있습니다.

서비스에 대해 삭제 보존 정책을 사용하도록 설정한 경우 이 작업은 Blob을 일시 삭제하고 지정된 일 수 동안 Blob을 유지합니다. 지정된 일 수 후에는 가비지 수집 중에 Blob의 데이터가 서비스에서 제거됩니다. 일시 삭제된 Blob은 include=['deleted'] 옵션을 지정하여 list_blobs 액세스할 수 있습니다. 일시 삭제된 Blob은 작업을 사용하여 <xref:azure.storage.blob.undelete> 복원할 수 있습니다.

delete_blob(delete_snapshots: str = None, **kwargs: Any) -> None

매개 변수

delete_snapshots
str
필수

blob에 연결된 스냅숏이 포함된 경우 필수입니다. 값은 다음과 같습니다.

  • "only": Blob 스냅샷만 삭제합니다.

  • "include": 모든 스냅샷과 함께 Blob을 삭제합니다.

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있는 경우 삭제할 Blob의 버전을 지정합니다.

버전 12.4.0의 새로운 기능

이 키워드(keyword) 인수는 API 버전 '2019-12-12'에서 도입되었습니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 지정한 경우 blob의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 delete_blob 성공합니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환 형식

None

delete_immutability_policy

불변성 정책 삭제 작업은 Blob에서 불변성 정책을 삭제합니다.

버전 12.10.0의 새로운 기능: 이 작업은 API 버전 '2020-10-02'에서 도입되었습니다.

delete_immutability_policy(**kwargs: Any) -> None

매개 변수

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 태그의 키 값 쌍입니다.

반환 형식

Dict[str, str]

download_blob

Blob을 StorageStreamDownloader에 다운로드합니다. readall() 메서드를 사용하여 모든 콘텐츠를 읽어야 합니다. 그렇지 않은 경우 Blob을 스트림으로 다운로드하는 데 readinto()를 사용해야 합니다. chunks()를 사용하면 사용자가 청크의 콘텐츠를 반복할 수 있는 반복기가 반환됩니다.

download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]

매개 변수

offset
int
필수

Blob의 섹션을 다운로드하는 데 사용할 바이트 범위의 시작입니다. 길이가 제공되면 설정해야 합니다.

length
int
필수

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

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있는 경우 다운로드할 Blob 버전을 지정합니다.

버전 12.4.0의 새로운 기능

이 키워드(keyword) 인수는 API 버전 '2019-12-12'에서 도입되었습니다.

validate_content
bool

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

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 지정한 경우 blob의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 download_blob 성공합니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

cpk
CustomerProvidedEncryptionKey

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

max_concurrency
int

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

encoding
str

다운로드한 바이트를 디코딩하는 인코딩 기본값은 None입니다. 즉, 디코딩이 없습니다.

progress_hook
Callable[[int, int], None]

장기 실행 다운로드의 진행률을 추적하는 콜백입니다. 서명은 function(current: int, total: int)이며, 여기서 current는 지금까지 전송된 바이트 수이고 합계는 다운로드의 총 크기입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요. 이 메서드는 서비스를 여러 번 호출할 수 있으며 시간 제한은 각 호출에 개별적으로 적용됩니다. Azure 서비스에 대한 여러 호출 및 시간 제한은 각 호출에 개별적으로 적용됩니다.

반환

스트리밍 개체(StorageStreamDownloader)

반환 형식

StorageStreamDownloader

exists

정의된 매개 변수가 있는 Blob이 있으면 True를 반환하고, 그렇지 않으면 False를 반환합니다.

exists(**kwargs: Any) -> bool

매개 변수

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 존재할 경우 검사 Blob의 버전을 지정합니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

boolean

반환 형식

bool

from_blob_url

Blob URL에서 BlobClient를 만듭니다. 이 기능은 Blob 이름에 '/'가 있는 사용자 지정된 Blob URL을 지원하지 않습니다.

from_blob_url(blob_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> Self

매개 변수

blob_url
str
필수

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

credential
Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
기본값: None

인증할 자격 증명입니다. 계정 URL에 이미 SAS 토큰이 있거나 연결 문자열 공유 액세스 키 값이 이미 있는 경우 선택 사항입니다. 값은 SAS 토큰 문자열, azure.core.credentials에서 AzureSasCredential 또는 AzureNamedKeyCredential의 instance, 계정 공유 액세스 키 또는 azure.identity에서 TokenCredentials 클래스의 instance 수 있습니다. 리소스 URI에 이미 SAS 토큰이 포함된 경우 명시적 자격 증명을 위해 무시됩니다.

  • 충돌하는 SAS 토큰이 ValueError를 발생시키는 AzureSasCredential의 경우를 제외하고. AzureNamedKeyCredential의 instance 사용하는 경우 "name"은 스토리지 계정 이름이고 "키"는 스토리지 계정 키여야 합니다.
snapshot
str
기본값: None

작동할 선택적 Blob 스냅샷. 스냅샷 ID 문자열 또는 에서 create_snapshot반환된 응답일 수 있습니다. 지정된 경우 URL의 스냅샷 재정의합니다.

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있을 때 작동할 Blob의 버전을 지정합니다.

반환

Blob 클라이언트입니다.

반환 형식

BlobClient

from_connection_string

연결 문자열에서 BlobClient를 만듭니다.

from_connection_string(conn_str: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

매개 변수

conn_str
str
필수

Azure Storage 계정에 대한 연결 문자열.

container_name
str
필수

Blob의 컨테이너 이름입니다.

blob_name
str
필수

상호 작용할 Blob의 이름입니다.

snapshot
str
기본값: None

작동할 선택적 Blob 스냅샷. 스냅샷 ID 문자열 또는 에서 create_snapshot반환된 응답일 수 있습니다.

credential
Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
기본값: None

인증할 자격 증명입니다. 계정 URL에 이미 SAS 토큰이 있거나 연결 문자열 공유 액세스 키 값이 이미 있는 경우 선택 사항입니다. 값은 SAS 토큰 문자열, azure.core.credentials에서 AzureSasCredential 또는 AzureNamedKeyCredential의 instance, 계정 공유 액세스 키 또는 azure.identity에서 TokenCredentials 클래스의 instance 수 있습니다. 여기에 제공된 자격 증명이 연결 문자열 자격 증명보다 우선합니다. AzureNamedKeyCredential의 instance 사용하는 경우 "name"은 스토리지 계정 이름이고 "키"는 스토리지 계정 키여야 합니다.

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있을 때 작동할 Blob의 버전을 지정합니다.

반환

Blob 클라이언트입니다.

반환 형식

BlobClient

get_account_information

Blob이 있는 스토리지 계정과 관련된 정보를 가져옵니다.

사용자에게 컨테이너 또는 Blob에 대한 SAS가 있는 경우에도 정보를 검색할 수 있습니다. 반환된 사전의 키에는 'sku_name' 및 'account_kind'이 포함됩니다.

get_account_information(**kwargs: Any) -> Dict[str, str]

반환

계정 정보(SKU 및 계정 유형)의 받아쓰기입니다.

반환 형식

dict(str, str)

get_blob_properties

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

get_blob_properties(**kwargs: Any) -> BlobProperties

매개 변수

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있을 때 속성을 가져올 Blob의 버전을 지정합니다.

버전 12.4.0의 새로운 기능입니다.

이 키워드(keyword) 인수는 API 버전 '2019-12-12'에서 도입되었습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능입니다.

cpk
CustomerProvidedEncryptionKey

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

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

BlobProperties

반환 형식

BlobProperties

get_blob_tags

태그 가져오기 작업을 사용하면 사용자가 Blob 또는 특정 Blob 버전 또는 스냅샷 태그를 가져올 수 있습니다.

버전 12.4.0의 새로운 기능: 이 작업은 API 버전 '2019-12-12'에서 도입되었습니다.

get_blob_tags(**kwargs: Any) -> Dict[str, str]

매개 변수

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있을 때 태그를 추가할 Blob 버전을 지정합니다.

if_tags_match_condition
str

일치하는 값이 있는 대상 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 태그의 키 값 쌍입니다.

반환 형식

Dict[str, str]

get_block_list

블록 목록 가져오기 작업은 블록 Blob의 일부로 업로드된 블록 목록을 검색합니다.

get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]

매개 변수

block_list_type
str
필수

커밋된 블록 목록, 커밋되지 않은 블록 목록 또는 두 목록을 함께 반환할지 여부를 지정합니다. 가능한 값은 'committed', 'uncommitted', 'all'입니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_tags_match_condition
str

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

버전 12.4.0의 새로운 기능입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

커밋된 블록과 커밋되지 않은 블록의 두 목록 튜플

반환 형식

tuple(list(BlobBlock), list(BlobBlock))

get_page_range_diff_for_managed_disk

관리 디스크 또는 스냅샷 유효한 페이지 범위 목록을 반환합니다.

참고

이 작업은 관리 디스크 계정에만 사용할 수 있습니다.

버전 12.2.0의 새로운 기능: 이 작업은 API 버전 '2019-07-07'에서 도입되었습니다.

get_page_range_diff_for_managed_disk(previous_snapshot_url: str, offset: int | None = None, length: int | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

매개 변수

previous_snapshot_url
필수

관리 디스크의 이전 스냅샷 URL을 지정합니다. 응답에는 대상 Blob과 이전 스냅샷 간에 변경된 페이지만 포함됩니다.

offset
int
필수

유효한 페이지 범위를 가져오는 데 사용할 바이트 범위의 시작입니다. 길이가 지정되지 않으면 오프셋 이후의 모든 바이트가 검색됩니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

length
int
필수

유효한 페이지 범위를 가져오는 데 사용할 바이트 수입니다. 길이가 지정되면 오프셋을 제공해야 합니다. 이 범위는 오프셋 시작부터 지정된 길이까지 유효한 페이지 범위를 반환합니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

페이지 범위의 두 목록으로 구성된 튜플은 'start' 및 'end' 키가 있는 사전입니다. 첫 번째 요소는 채워진 페이지 범위이고, 두 번째 요소는 페이지 범위를 지웁니다.

반환 형식

tuple(list(dict(str, str), list(dict(str, str))

get_page_ranges

사용되지 않음: 페이지 Blob 또는 페이지 Blob의 스냅샷 유효한 페이지 범위 목록을 반환합니다.

get_page_ranges(offset: int | None = None, length: int | None = None, previous_snapshot_diff: str | Dict[str, Any] | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

매개 변수

offset
int
필수

유효한 페이지 범위를 가져오는 데 사용할 바이트 범위의 시작입니다. 길이가 지정되지 않으면 오프셋 이후의 모든 바이트가 검색됩니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

length
int
필수

유효한 페이지 범위를 가져오는 데 사용할 바이트 수입니다. 길이가 지정되면 오프셋을 제공해야 합니다. 이 범위는 오프셋 시작부터 지정된 길이까지 유효한 페이지 범위를 반환합니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

previous_snapshot_diff
str
필수

최신 스냅샷 또는 현재 Blob과 비교할 이전 Blob 스냅샷 지정하는 불투명 DateTime 값이 포함된 스냅샷 diff 매개 변수입니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

페이지 범위의 두 목록으로 구성된 튜플은 'start' 및 'end' 키가 있는 사전입니다. 첫 번째 요소는 채워진 페이지 범위이고, 두 번째 요소는 페이지 범위를 지웁니다.

반환 형식

tuple(list(dict(str, str), list(dict(str, str))

list_page_ranges

페이지 Blob 또는 페이지 Blob의 스냅샷 유효한 페이지 범위 목록을 반환합니다. previous_snapshot 지정하면 결과는 대상 Blob과 이전 스냅샷 간의 변경 내용 diff 됩니다.

list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]

매개 변수

offset
int

유효한 페이지 범위를 가져오는 데 사용할 바이트 범위의 시작입니다. 길이가 지정되지 않으면 오프셋 이후의 모든 바이트가 검색됩니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

length
int

유효한 페이지 범위를 가져오는 데 사용할 바이트 수입니다. 길이가 지정되면 오프셋을 제공해야 합니다. 이 범위는 오프셋 시작부터 지정된 길이까지 유효한 페이지 범위를 반환합니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

previous_snapshot
str 또는 Dict[str, Any]

응답에 대상 Blob과 이전 스냅샷 간에 변경된 페이지만 포함되도록 지정하는 스냅샷 값입니다. 변경된 페이지에는 업데이트된 페이지와 지워진 페이지가 모두 포함됩니다. previous_snapshot 지정한 스냅샷 둘 중 더 오래된 경우 대상 Blob은 스냅샷 될 수 있습니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

results_per_page
int

API 호출당 검색할 최대 페이지 범위 수입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

PageRange의 반복 가능(자동 페이징)입니다.

반환 형식

ItemPaged[PageRange]

query_blob

사용자가 간단한 쿼리 식을 제공하여 Blob/또는 Blob 스냅샷 데이터를 선택/프로젝트할 수 있습니다. 이 작업은 BlobQueryReader를 반환합니다. 사용자는 readall() 또는 readinto()를 사용하여 쿼리 데이터를 가져와야 합니다.

query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReader

매개 변수

query_expression
str
필수

필수 사항입니다. 쿼리 문입니다. 자세한 내용은 https://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference 를 참조하세요.

on_error
Callable[BlobQueryError]

서비스에서 반환된 처리 오류에 대해 호출할 함수입니다.

blob_format
DelimitedTextDialect 또는 DelimitedJsonDialect 또는 QuickQueryDialect 또는 str

선택 사항입니다. 현재 Blob에 저장된 데이터의 serialization을 정의합니다. 기본값은 Blob 데이터를 기본 언어로 서식이 지정된 CSV 데이터로 처리하는 것입니다. 사용자 지정 DelimitedTextDialect 또는 DelimitedJsonDialect 또는 "ParquetDialect"(문자열 또는 열거형으로 전달됨)로 재정의할 수 있습니다. 이러한 방언은 해당 클래스인 QuickQueryDialect 열거형 또는 문자열로 전달할 수 있습니다.

output_format
DelimitedTextDialect 또는 DelimitedJsonDialect 또는 list[ArrowDialect] 또는 QuickQueryDialect 또는 str

선택 사항입니다. 데이터 스트림에 대한 출력 serialization을 정의합니다. 기본적으로 데이터는 Blob에 표시될 때 반환됩니다(Parquet 형식은 기본적으로 DelimitedTextDialect로 지정됨). 출력 형식을 제공하면 해당 프로필에 따라 Blob 데이터가 다시 포맷됩니다. 이 값은 DelimitedTextDialect 또는 DelimitedJsonDialect 또는 ArrowDialect일 수 있습니다. 이러한 방언은 해당 클래스인 QuickQueryDialect 열거형 또는 문자열로 전달할 수 있습니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능입니다.

cpk
CustomerProvidedEncryptionKey

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

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

스트리밍 개체(BlobQueryReader)

반환 형식

BlobQueryReader

resize_blob

페이지 blob 크기를 지정된 크기로 조정합니다.

지정된 값이 현재 blob 크기보다 작으면 지정된 값을 넘는 모든 페이지가 지워집니다.

resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]

매개 변수

size
int
필수

Blob 크기를 조정하는 데 사용되는 크기입니다. 페이지 Blob의 최대 크기는 최대 1TB입니다. 페이지 blob 크기는 512바이트 경계로 정렬되어야 합니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능입니다.

premium_page_blob_tier
PremiumPageBlobTier

Blob을 설정할 페이지 Blob 계층 값입니다. 계층은 Blob의 크기 및 허용되는 IOPS 수와 관련이 있습니다. 이는 Premium Storage 계정의 페이지 Blob에만 적용됩니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 dict(Etag 및 마지막으로 수정됨).

반환 형식

dict(str, Any)

seal_append_blob

Seal 작업은 추가 Blob을 봉인하여 읽기 전용으로 만듭니다.

버전 12.4.0의 새로운 기능

seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]

매개 변수

appendpos_condition
int

선택적 조건부 헤더로, 블록 추가 작업에만 사용됩니다. 비교할 바이트 오프셋을 나타내는 숫자입니다. 추가 블록은 추가 위치가 이 숫자와 같은 경우에만 성공합니다. 그렇지 않으면 AppendPositionConditionNotMet 오류(HTTP 상태 코드 412 - 사전 조건 실패)로 요청이 실패합니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 받아쓰기(Etag, 마지막으로 수정됨, 추가 오프셋, 커밋된 블록 수).

반환 형식

dict(str, Any)

set_blob_metadata

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

set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

매개 변수

metadata
dict(str, str)
필수

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

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 받아쓰기(Etag 및 마지막으로 수정됨)

set_blob_tags

태그 설정 작업을 사용하면 사용자가 Blob 또는 특정 Blob 버전에서 태그를 설정할 수 있지만 스냅샷 설정할 수 없습니다. 이 작업에 대한 각 호출은 Blob에 연결된 모든 기존 태그를 대체합니다. Blob에서 모든 태그를 제거하려면 태그가 설정되지 않은 상태에서 이 작업을 호출합니다.

버전 12.4.0의 새로운 기능: 이 작업은 API 버전 '2019-12-12'에서 도입되었습니다.

set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]

매개 변수

tags
dict(str, str)
필수

Blob과 연결된 이름-값 쌍을 태그로 사용합니다. 태그는 대/소문자를 구분합니다. 태그 집합에는 최대 10개의 태그가 포함될 수 있습니다. 태그 키는 1자에서 128자 사이여야 하며 태그 값은 0~256자여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(), 더하기( >><<+), 빼기(-), 마침표(.), solidus(/), 콜론(:), 등호(=), 밑줄(_)이 포함됩니다.

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있을 때 태그를 추가할 Blob 버전을 지정합니다.

validate_content
bool

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

if_tags_match_condition
str

일치하는 값이 있는 대상 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 받아쓰기(Etag 및 마지막으로 수정됨)

반환 형식

Dict[str, Any]

set_http_headers

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

content_settings 대해 하나의 속성이 설정되면 모든 속성이 재정의됩니다.

set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> None

매개 변수

content_settings
ContentSettings
필수

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다. 콘텐츠 형식, 인코딩, 언어, 처리, md5 및 캐시 제어를 설정하는 데 사용됩니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 받아쓰기(Etag 및 마지막으로 수정됨)

반환 형식

Dict[str, Any]

set_immutability_policy

불변성 정책 설정 작업은 Blob에서 불변성 정책을 설정합니다.

버전 12.10.0의 새로운 기능: 이 작업은 API 버전 '2020-10-02'에서 도입되었습니다.

set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]

매개 변수

immutability_policy
ImmutabilityPolicy
필수

Blob, Blob 스냅샷 또는 Blob 버전의 불변성 정책을 지정합니다.

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에서 도입되었습니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 태그의 키 값 쌍입니다.

반환 형식

Dict[str, str]

법적 보존 설정 작업은 Blob에 대한 법적 보존을 설정합니다.

버전 12.10.0의 새로운 기능: 이 작업은 API 버전 '2020-10-02'에서 도입되었습니다.

set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]

매개 변수

legal_hold
bool
필수

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

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 태그의 키 값 쌍입니다.

반환 형식

Dict[str, Union[str, datetime, bool]]

set_premium_page_blob_tier

Blob에서 페이지 Blob 계층을 설정합니다. 이 API는 프리미엄 계정의 페이지 Blob에 대해서만 지원됩니다.

set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> None

매개 변수

premium_page_blob_tier
PremiumPageBlobTier
필수

Blob을 설정할 페이지 Blob 계층 값입니다. 계층은 Blob의 크기 및 허용되는 IOPS 수와 상관 관계가 있습니다. 이는 Premium Storage 계정의 페이지 Blob에만 적용됩니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

반환 형식

None

set_sequence_number

Blob 시퀀스 번호를 설정합니다.

set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]

매개 변수

sequence_number_action
str
필수

이 속성은 서비스가 blob의 시퀀스 번호를 수정하는 방법을 나타냅니다. 자세한 내용은 SequenceNumberAction 을 참조하세요.

sequence_number
str
필수

이 속성은 blob의 시퀀스 번호를 설정합니다. 시퀀스 번호는 요청을 추적하고 동시성 문제를 관리하는 데 사용할 수 있는 사용자 제어 속성입니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 dict(Etag 및 마지막으로 수정됨).

반환 형식

dict(str, Any)

set_standard_blob_tier

이 작업은 블록 Blob에서 계층을 설정합니다.

블록 Blob의 계층은 핫/쿨/보관 스토리지 유형을 결정합니다. 이 작업은 Blob의 ETag를 업데이트하지 않습니다.

set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> None

매개 변수

standard_blob_tier
str 또는 StandardBlobTier
필수

Blob에 설정할 계층을 나타냅니다. 옵션으로는 '핫', '쿨', '보관'이 있습니다. 핫 계층은 자주 액세스되는 데이터를 저장하기 위해 최적화되어 있습니다. 쿨 스토리지 계층은 자주 액세스하지 않고 한 달 이상 저장된 데이터를 저장하기 위해 최적화되어 있습니다. 보관 계층은 거의 액세스하지 않고 유연한 대기 시간 요구 사항으로 최소 6개월 동안 저장되는 데이터를 저장하는 데 최적화되어 있습니다.

rehydrate_priority
RehydratePriority

보관된 Blob을 리하레이트할 우선 순위를 나타냅니다.

version_id
str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있는 경우 다운로드할 Blob 버전을 지정합니다.

버전 12.4.0의 새로운 기능

이 키워드(keyword) 인수는 API 버전 '2019-12-12'에서 도입되었습니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

반환 형식

None

stage_block

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

stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]

매개 변수

block_id
str
필수

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

data
필수

Blob 데이터입니다.

length
int
필수

블록의 크기입니다.

validate_content
bool

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

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

encoding
str

기본값은 UTF-8입니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 속성 받아쓰기.

반환 형식

dict[str, Any]

stage_block_from_url

URL에서 콘텐츠를 읽는 Blob의 일부로 커밋할 새 블록을 만듭니다.

stage_block_from_url(block_id: str | int, source_url: str, source_offset: int | None = None, source_length: int | None = None, source_content_md5: bytes | bytearray | None = None, **kwargs) -> Dict[str, Any]

매개 변수

block_id
str
필수

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

source_url
str
필수

URL입니다.

source_offset
int
필수

블록에 사용할 바이트 범위의 시작입니다. 원본 길이가 제공되면 설정해야 합니다.

source_length
int
필수

블록의 크기(바이트)입니다.

source_content_md5
bytearray
필수

복사 원본에서 읽어야 하는 바이트 범위에 대해 계산된 md5를 지정합니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

source_authorization
str

원본 Blob에 액세스하기 위해 클라이언트 암호를 사용하여 서비스 주체로 인증합니다. "전달자"가 source_authorization 문자열의 접두사인지 확인합니다.

반환

Blob 속성 받아쓰기.

반환 형식

dict[str, Any]

start_copy_from_url

지정된 URL에서 Blob을 복사합니다.

이 작업은 복사 작업의 상태 검사 또는 중단하는 데 사용할 수 있는 copy_status 및 copy_id 포함하는 사전을 반환합니다. copy_status 복사가 동기적으로 완료된 경우 '성공'이 되고, 복사본이 비동기적으로 시작된 경우 '보류 중'이 됩니다. 비동기 복사본의 경우 메서드를 폴링 get_blob_properties 하고 복사 상태 확인하여 상태 확인할 수 있습니다. 복사를 강제로 동기로 설정하려면 requires_sync True로 설정합니다. Blob 서비스는 최상의 노력으로 blob를 복사합니다.

복사 작업의 원본 Blob은 블록 Blob, 추가 Blob 또는 페이지 Blob일 수 있습니다. 대상 blob가 이미 있으면 원본 blob와 동일한 blob 유형이어야 합니다. 기존 대상 blob는 덮어씁니다. 복사 작업이 진행 중일 때는 대상 blob를 수정할 수 없습니다.

페이지 Blob에서 복사할 때 Blob 서비스는 처음에 모든 0을 포함하는 원본 Blob 길이의 대상 페이지 Blob을 만듭니다. 그런 후 원본 페이지 범위가 열거되고 비어 있지 않은 범위가 복사됩니다.

블록 Blob 또는 추가 Blob의 경우 Blob 서비스는 이 작업에서 반환하기 전에 길이가 0인 커밋된 Blob을 만듭니다. 블록 Blob에서 복사할 때 커밋된 모든 블록과 해당 블록 ID가 복사됩니다. 커밋되지 않은 블록은 복사되지 않습니다. 복사 작업이 끝나면 대상 Blob은 원본과 동일한 커밋된 블록 수를 갖게 됩니다.

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

start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]

매개 변수

source_url
str
필수

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

https://myaccount.blob.core.windows.net/mycontainer/myblob? 스냅샷=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

metadata
dict(str, str)
필수

blob과 메타데이터로 연결된 이름-값 쌍입니다. 이름-값 쌍을 지정하지 않으면 작업은 원본 Blob 또는 파일의 메타데이터를 대상 Blob으로 복사합니다. 하나 이상의 이름-값 쌍을 지정하면 대상 Blob이 지정된 메타데이터를 사용하여 만들어지고 메타데이터는 원본 Blob 또는 파일에서 복사되지 않습니다.

incremental_copy
bool
필수

원본 페이지 Blob의 스냅샷 대상 페이지 Blob에 복사합니다. 이전에 복사한 스냅샷 간의 차등 변경 내용만 대상으로 전송되도록 스냅샷 복사됩니다. 복사된 스냅샷은 원래 스냅샷 전체 복사본이며 평소와 같이 읽거나 복사할 수 있습니다. 기본값은 False입니다.

tags
dict(str, str) 또는 Literal["COPY"]

Blob과 연결된 이름-값 쌍을 태그로 사용합니다. 태그는 대/소문자를 구분합니다. 태그 집합에는 최대 10개의 태그가 포함될 수 있습니다. 태그 키는 1자에서 128자 사이여야 하며 태그 값은 0~256자여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(), 더하기( >><<+), 빼기(-), 마침표(.), solidus(/), 콜론(:), 등호(=), 밑줄(_)이 포함됩니다.

대신 (대/소문자를 구분하는) 리터럴 "COPY"를 전달하여 원본 Blob에서 태그를 복사할 수 있습니다. 이 옵션은 incremental_copy=False 및 requires_sync=True인 경우에만 사용할 수 있습니다.

버전 12.4.0의 새로운 기능

immutability_policy
ImmutabilityPolicy

Blob, Blob 스냅샷 또는 Blob 버전의 불변성 정책을 지정합니다.

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에서 도입되었습니다.

legal_hold
bool

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

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에서 도입되었습니다.

source_if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 원본 blob가 수정된 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다.

source_if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 원본 blob가 수정되지 않은 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다.

source_etag
str

원본 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

source_match_condition
MatchConditions

etag에 사용할 원본 일치 조건입니다.

if_modified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 대상 blob가 수정된 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. 대상 blob이 수정되지 않은 경우 Blob service가 상태 코드 412(전제 조건 실패)를 반환합니다.

if_unmodified_since
datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함된 경우 UTC가 아닌 날짜/시간은 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 대상 blob가 수정되지 않은 경우에만 blob를 복사하려면 이 조건부 헤더를 지정합니다. 대상 blob가 수정된 경우 Blob 서비스가 상태 코드 412(전제 조건 실패)를 반환합니다.

etag
str

대상 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 대상 일치 조건입니다.

destination_lease
BlobLeaseClient 또는 str

이 헤더에 지정된 임대 ID는 대상 blob의 임대 ID와 일치해야 합니다. 요청에 임대 ID가 포함되지 않거나 유효하지 않은 경우, 작업이 실패하고 상태 코드 412(전제 조건 실패)가 표시됩니다.

source_lease
BlobLeaseClient 또는 str

지정된 임대 ID가 원본 Blob의 활성 임대 ID와 일치하는 경우에만 Blob 복사 작업을 수행하도록 지정합니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

premium_page_blob_tier
PremiumPageBlobTier

Blob을 설정할 페이지 Blob 계층 값입니다. 계층은 Blob의 크기 및 허용되는 IOPS 수와 상관 관계가 있습니다. 이는 Premium Storage 계정의 페이지 Blob에만 적용됩니다.

standard_blob_tier
StandardBlobTier

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

rehydrate_priority
RehydratePriority

보관된 Blob을 리하레이트할 우선 순위를 나타냅니다.

seal_destination_blob
bool

대상 추가 Blob을 봉인합니다. 이 작업은 추가 Blob에 대해서만 수행됩니다.

버전 12.4.0의 새로운 기능

requires_sync
bool

복사가 완료될 때까지 서비스에서 응답을 반환하지 않도록 합니다.

source_authorization
str

원본 Blob에 액세스하기 위해 클라이언트 암호를 사용하여 서비스 주체로 인증합니다. "전달자"가 source_authorization 문자열의 접두사인지 확인합니다. 이 옵션은 incremental_copy False로 설정되고 requires_sync True로 설정된 경우에만 사용할 수 있습니다.

버전 12.9.0의 새로운 기능

encryption_scope
str

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

버전 12.10.0의 새로운 기능

반환

복사 속성 사전(etag, last_modified, copy_id, copy_status)입니다.

반환 형식

dict[str, Union[str, datetime]]

undelete_blob

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

삭제 보존 정책에 설정된 지정된 일 수 내에 사용하는 경우에만 작업이 성공합니다.

Blob 버전 관리를 사용하는 경우 이 메서드를 사용하여 기본 Blob을 복원할 수 없습니다. 대신 현재 버전으로 승격하려는 Blob 버전의 URL과 함께 를 사용합니다 start_copy_from_url .

undelete_blob(**kwargs: Any) -> None

매개 변수

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환 형식

None

upload_blob

자동 청크를 사용하여 데이터 원본에서 새 Blob을 만듭니다.

upload_blob(data: bytes | str | Iterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, Any]

매개 변수

data
필수

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

blob_type
BlobType
필수

Blob의 형식입니다. BlockBlob, PageBlob 또는 AppendBlob일 수 있습니다. 기본값은 BlockBlob입니다.

length
int
필수

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

metadata
dict(str, str)
필수

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

tags
dict(str, str)

Blob과 연결된 이름-값 쌍을 태그로 사용합니다. 태그는 대/소문자를 구분합니다. 태그 집합에는 최대 10개의 태그가 포함될 수 있습니다. 태그 키는 1~128자 사이여야 하며 태그 값은 0~256자 사이여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(), 더하기( >><<+), 빼기(-), 마침표(.), solidus(/), 콜론(:), 등호(=), 밑줄(_)이 포함됩니다.

버전 12.4.0의 새로운 기능입니다.

overwrite
bool

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

content_settings
ContentSettings

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다. 콘텐츠 형식, 인코딩, 언어, 처리, md5 및 캐시 제어를 설정하는 데 사용됩니다.

validate_content
bool

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

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 지정된 경우 blob의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 upload_blob 성공합니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능입니다.

premium_page_blob_tier
PremiumPageBlobTier

Blob을 설정할 페이지 Blob 계층 값입니다. 계층은 Blob의 크기 및 허용되는 IOPS 수와 관련이 있습니다. 이는 Premium Storage 계정의 페이지 Blob에만 적용됩니다.

standard_blob_tier
StandardBlobTier

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

immutability_policy
ImmutabilityPolicy

Blob, Blob 스냅샷 또는 Blob 버전의 불변성 정책을 지정합니다. 현재 upload_blob() API의 이 매개 변수는 BlockBlob 전용입니다.

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에 도입되었습니다.

legal_hold
bool

Blob에서 법적 보존을 설정해야 하는지 지정합니다. 현재 upload_blob() API의 이 매개 변수는 BlockBlob 전용입니다.

버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에 도입되었습니다.

maxsize_condition
int

선택적 조건부 헤더입니다. 추가 Blob에 허용되는 최대 길이(바이트)입니다. 블록 추가 작업으로 인해 Blob이 해당 제한을 초과하거나 Blob 크기가 이 헤더에 지정된 값보다 이미 크면 MaxBlobSizeConditionNotMet 오류(HTTP 상태 코드 412 - 사전 조건 실패)로 인해 요청이 실패합니다.

max_concurrency
int

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

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능입니다.

encoding
str

기본값은 UTF-8입니다.

progress_hook
Callable[[int, Optional[int]], None]

장기 실행 업로드의 진행률을 추적하는 콜백입니다. 서명은 function(current: int, total: Optional[int])입니다. 여기서 current는 지금까지 전송된 바이트 수이고 크기가 알 수 없는 경우 합계는 Blob의 크기이거나 없음입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요. 이 메서드는 서비스에 여러 번 호출할 수 있으며 시간 제한은 각 호출에 개별적으로 적용됩니다.

반환

Blob 업데이트 속성 받아쓰기(Etag 및 마지막으로 수정됨)

반환 형식

dict[str, Any]

upload_blob_from_url

지정된 URL에서 Blob의 콘텐츠를 읽는 새 블록 Blob을 만듭니다. 기존 Blob의 콘텐츠는 새 Blob으로 덮어씁니다.

upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]

매개 변수

source_url
str
필수

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

https://myaccount.blob.core.windows.net/mycontainer/myblob? 스냅샷=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

overwrite
bool

업로드할 Blob이 현재 데이터를 덮어쓸지 여부입니다. True이면 upload_blob 기존 데이터를 덮어씁 수 있습니다. False로 설정하면 ResourceExistsError로 작업이 실패합니다.

include_source_blob_properties
bool

원본 Blob의 속성을 복사해야 하는지를 나타냅니다. 기본값은 True입니다.

tags
dict(str, str)

Blob과 연결된 이름-값 쌍을 태그로 사용합니다. 태그는 대/소문자를 구분합니다. 태그 집합에는 최대 10개의 태그가 포함될 수 있습니다. 태그 키는 1~128자 사이여야 하며 태그 값은 0~256자 사이여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(), 더하기( >><<+), 빼기(-), 마침표(.), solidus(/), 콜론(:), 등호(=), 밑줄(_)이 포함됩니다.

source_content_md5
bytearray

원본 바이트의 무결성을 확인하는 데 사용되는 md5를 지정합니다.

source_if_modified_since
datetime

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

source_if_unmodified_since
datetime

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

source_etag
str

원본 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

source_match_condition
MatchConditions

etag에 사용할 원본 일치 조건입니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

대상 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 대상 일치 조건입니다.

destination_lease
BlobLeaseClient 또는 str

이 헤더에 지정된 임대 ID는 대상 blob의 임대 ID와 일치해야 합니다. 요청에 임대 ID가 포함되지 않거나 유효하지 않은 경우, 작업이 실패하고 상태 코드 412(전제 조건 실패)가 표시됩니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

content_settings
ContentSettings

Blob 속성을 설정하는 데 사용되는 ContentSettings 개체입니다. 콘텐츠 형식, 인코딩, 언어, 처리, md5 및 캐시 제어를 설정하는 데 사용됩니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

standard_blob_tier
StandardBlobTier

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

source_authorization
str

원본 Blob에 액세스하기 위해 클라이언트 암호를 사용하여 서비스 주체로 인증합니다. "전달자"가 source_authorization 문자열의 접두사인지 확인합니다.

upload_page

페이지 업로드 작업은 페이지 Blob에 페이지 범위를 씁니다.

upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]

매개 변수

page
bytes
필수

페이지의 콘텐츠입니다.

offset
int
필수

Blob의 섹션에 쓰는 데 사용할 바이트 범위의 시작입니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

length
int
필수

Blob의 섹션에 쓰는 데 사용할 바이트 수입니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

validate_content
bool

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

if_sequence_number_lte
int

Blob의 시퀀스 번호가 지정된 값보다 작거나 같으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_sequence_number_lt
int

Blob의 시퀀스 번호가 지정된 값보다 작으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_sequence_number_eq
int

Blob의 시퀀스 번호가 지정된 값과 같으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition
MatchConditions

etag에 사용할 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 SQL where 절을 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능입니다.

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

encoding
str

기본값은 UTF-8입니다.

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 업데이트 속성 dict(Etag 및 마지막으로 수정됨).

반환 형식

dict(str, Any)

upload_pages_from_url

페이지 업로드 작업은 URL에서 콘텐츠를 읽는 페이지 Blob에 페이지 범위를 씁니다.

upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]

매개 변수

source_url
str
필수

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

offset
int
필수

Blob의 섹션에 쓰는 데 사용할 바이트 범위의 시작입니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

length
int
필수

Blob의 섹션에 쓰는 데 사용할 바이트 수입니다. 페이지는 512바이트 경계에 맞춰야 하고 시작 오프셋은 512의 모듈러스여야 하며 길이는 512의 모듈러스여야 합니다.

source_offset
int
필수

이는 복사 원본에서 가져와야 하는 바이트(포함) 범위의 시작을 나타냅니다. 서비스는 대상 범위(길이 오프셋)와 동일한 바이트 수를 읽습니다.

source_content_md5
bytes

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

source_if_modified_since
datetime

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

source_if_unmodified_since
datetime

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

source_etag
str

원본 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

source_match_condition
MatchConditions

etag에 사용할 원본 일치 조건입니다.

lease
BlobLeaseClient 또는 str

blob에 활성 임대가 포함된 경우 필수입니다. 값은 BlobLeaseClient 개체이거나 임대 ID를 문자열로 사용할 수 있습니다.

if_sequence_number_lte
int

Blob의 시퀀스 번호가 지정된 값보다 작거나 같으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_sequence_number_lt
int

Blob의 시퀀스 번호가 지정된 값보다 작으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_sequence_number_eq
int

Blob의 시퀀스 번호가 지정된 값과 같으면 요청이 진행됩니다. 그렇지 않으면 실패합니다.

if_modified_since
datetime

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

if_unmodified_since
datetime

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

etag
str

대상 ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동합니다.

match_condition
MatchConditions

etag에 사용할 대상 일치 조건입니다.

if_tags_match_condition
str

일치하는 값이 있는 Blob에서만 작동하도록 Blob 태그의 절을 SQL로 지정합니다. 예: "\"tagname\"='my tag'"

버전 12.4.0의 새로운 기능

cpk
CustomerProvidedEncryptionKey

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

encryption_scope
str

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

버전 12.2.0의 새로운 기능

timeout
int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

source_authorization
str

원본 Blob에 액세스하기 위해 클라이언트 암호를 사용하여 서비스 주체로 인증합니다. "전달자"가 source_authorization 문자열의 접두사인지 확인합니다.

특성

api_version

요청에 사용되는 Storage API의 버전입니다.

location_mode

클라이언트가 현재 사용하고 있는 위치 모드입니다.

기본적으로 "기본"입니다. 옵션에는 "기본" 및 "보조"가 포함됩니다.

primary_endpoint

전체 기본 엔드포인트 URL입니다.

primary_hostname

기본 엔드포인트의 호스트 이름입니다.

secondary_endpoint

구성된 경우 전체 보조 엔드포인트 URL입니다.

사용할 수 없는 경우 ValueError가 발생합니다. 보조 호스트 이름을 명시적으로 지정하려면 인스턴스화에 선택적 secondary_hostname 키워드(keyword) 인수를 사용합니다.

예외

ValueError

secondary_hostname

보조 엔드포인트의 호스트 이름입니다.

사용할 수 없는 경우 없음이 됩니다. 보조 호스트 이름을 명시적으로 지정하려면 인스턴스화에 선택적 secondary_hostname 키워드(keyword) 인수를 사용합니다.

url

사용되는 경우 SAS 토큰을 포함하여 이 엔터티에 대한 전체 엔드포인트 URL입니다.

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