blob 패키지

패키지

aio

클래스

AccessPolicy	집합에서 사용하는 액세스 정책 클래스 및 각 서비스에서 액세스 정책 메서드를 가져옵니다. 저장된 액세스 정책은 연관된 공유 액세스 서명에 대한 시작 시간, 만료 시간 및 권한을 지정할 수 있습니다. 리소스에 대한 액세스를 제어하는 방법에 따라 저장된 액세스 정책 내에서 이러한 매개 변수를 모두 지정하고 공유 액세스 서명의 URL에서 생략할 수 있습니다. 언제든지 연결된 서명의 동작을 수정하고 서명을 해제할 수 있습니다. 또는 저장된 액세스 정책 내에서 하나 이상의 액세스 정책 매개 변수를 지정하고 URL에 나머지를 지정할 수 있습니다. 마지막으로 URL에 모든 매개 변수를 지정할 수 있습니다. 이 경우 저장된 액세스 정책을 사용하여 서명을 취소할 수 있지만 해당 동작을 수정할 수는 없습니다. 공유 액세스 서명과 저장된 액세스 정책 모두 서명을 인증하는 데 필요한 모든 필드를 포함해야 합니다. 필수 필드가 하나라도 누락될 경우 요청에 실패합니다. 마찬가지로 필드가 공유 액세스 서명 URL 및 저장된 액세스 정책에서 모두 지정될 경우 요청은 상태 코드 400(잘못된 요청)의 오류가 발생합니다.
AccountSasPermissions	ResourceTypes generate_account_sas 함수 및 set_*_acl 사용되는 AccessPolicies에 사용할 클래스입니다. 리소스 액세스 권한을 부여하는 데 사용할 수 있는 두 가지 유형의 SAS가 있습니다. 하나는 특정 리소스(리소스별)에 대한 액세스 권한을 부여하는 것입니다. 또 다른 방법은 특정 계정에 대한 전체 서비스에 대한 액세스 권한을 부여하고 여기에 있는 퍼마에 따라 특정 작업을 허용하는 것입니다.
ArrowDialect	화살표 스키마의 필드입니다. Azure로 보내려면 모든 필수 매개 변수를 채워야 합니다.
BlobAnalyticsLogging	Azure Analytics 로깅 설정.
BlobBlock	BlockBlob Block 클래스입니다.
BlobClient	특정 Blob과 상호 작용하는 클라이언트이지만 해당 Blob은 아직 존재하지 않을 수 있습니다. 추가 선택적 구성을 보려면 여기를 클릭하세요.
BlobLeaseClient	새 BlobLeaseClient를 만듭니다. 이 클라이언트는 BlobClient 또는 ContainerClient에서 임대 작업을 제공합니다.
BlobPrefix	Blob 속성의 반복 가능입니다. 구분 기호를 사용할 때 walk_blobs 반환됩니다. 가상 Blob 디렉터리로 간주할 수 있습니다.
BlobProperties	Blob 속성입니다.
BlobQueryError	빠른 쿼리 작업 중에 오류가 발생했습니다.
BlobQueryReader	쿼리 결과를 읽을 스트리밍 개체입니다.
BlobSasPermissions	함수와 함께 사용할 BlobSasPermissions 클래스입니다 generate_blob_sas .
BlobServiceClient	계정 수준에서 Blob 서비스와 상호 작용할 클라이언트입니다. 이 클라이언트는 계정 속성을 검색 및 구성하고 계정 내에서 컨테이너를 나열, 만들기 및 삭제하는 작업을 제공합니다. 특정 컨테이너 또는 Blob과 관련된 작업의 경우 get_client 함수를 사용하여 해당 엔터티에 대한 클라이언트를 검색할 수도 있습니다. 추가 선택적 구성을 보려면 여기를 클릭하세요.
ContainerClient	특정 컨테이너와 상호 작용하는 클라이언트이지만 해당 컨테이너는 아직 존재하지 않을 수 있습니다. 이 컨테이너 내의 특정 Blob과 관련된 작업의 경우 함수를 사용하여 Blob 클라이언트를 get_blob_client 검색할 수 있습니다. 추가 선택적 구성을 보려면 여기를 클릭하세요.
ContainerEncryptionScope	컨테이너에 대한 기본 암호화 scope 구성입니다. 이 scope 컨테이너 내의 모든 이후 쓰기에 암시적으로 사용되지만 Blob 작업당 재정의될 수 있습니다. 버전 12.2.0의 새로운 기능
ContainerProperties	Blob 컨테이너의 속성 클래스입니다. 반환된 ContainerProperties 인스턴스는 사전 인터페이스(예: container_props["last_modified"])를 통해 이러한 값을 노출합니다. 또한 컨테이너 이름은 로 container_props["name"]사용할 수 있습니다.
ContainerSasPermissions	함수 및 와 함께 generate_container_sas 사용되는 AccessPolicies에 사용할 set_container_access_policyContainerSasPermissions 클래스입니다.
ContentSettings	Blob의 콘텐츠 설정입니다.
CopyProperties	Blob 복사 속성입니다. 이러한 속성은 Blob 복사 작업에서 이 Blob이 대상이 되지 않았거나 Blob 속성 설정, Blob 업로드 또는 커밋 블록 목록을 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우 없음 이 됩니다.
CorsRule	CORS는 특정 도메인에서 실행되는 웹 애플리케이션이 다른 도메인의 자원에 액세스할 수 있도록 하는 HTTP 기능입니다. 웹 브라우저는 웹 페이지에서 다른 도메인의 API를 호출하는 것을 방지하는 동일 원본 정책이라는 보안 제한을 구현합니다. CORS는 한 도메인(원본 도메인)에서 다른 도메인의 API를 호출할 수 있도록 하는 안전한 방법을 제공합니다.
CustomerProvidedEncryptionKey	Azure Storage의 모든 데이터는 계정 수준 암호화 키를 사용하여 미사용 시 암호화됩니다. 버전 2018-06-17 이상에서는 스토리지 서비스에 대한 요청에서 AES-256 암호화 키를 제공하여 Blob 콘텐츠 및 Blob당 애플리케이션 메타데이터를 암호화하는 데 사용되는 키를 관리할 수 있습니다. 고객이 제공한 키를 사용하는 경우 Azure Storage는 키를 관리하거나 유지하지 않습니다. Blob에 데이터를 쓸 때 제공된 키는 데이터를 디스크에 쓰기 전에 암호화하는 데 사용됩니다. 암호화 키의 SHA-256 해시는 Blob 콘텐츠와 함께 작성되며 Blob에 대한 모든 후속 작업이 동일한 암호화 키를 사용하는지 확인하는 데 사용됩니다. 이 해시는 암호화 키를 검색하거나 Blob의 내용을 해독하는 데 사용할 수 없습니다. Blob을 읽을 때 제공된 키를 사용하여 디스크에서 데이터를 읽은 후 암호를 해독합니다. 두 경우 모두 제공된 암호화 키는 암호화 또는 암호 해독 프로세스가 완료되는 즉시 안전하게 삭제됩니다.
DelimitedJsonDialect	Blob 데이터 쿼리에 대한 입력 또는 출력 JSON serialization을 정의합니다. 키워드(keyword) str 구분 기호: 줄 구분 기호 문자, 기본값은 ' '
DelimitedTextDialect	Blob 쿼리 요청에 대한 CSV(입력 또는 출력 구분) 직렬화를 정의합니다.
ExponentialRetry	지수 재시도. 지수 재시도 개체를 생성합니다. initial_backoff 첫 번째 재시도에 사용됩니다. 후속 재시도는 initial_backoff + increment_power^retry_count 초 후에 다시 시도됩니다.
FilteredBlob	Blob 필터링 API 호출의 Blob 정보입니다.
ImmutabilityPolicy	Blob, Blob 스냅샷 또는 Blob 버전의 불변성 정책을 설정하기 위한 선택적 매개 변수입니다. 버전 12.10.0의 새로운 기능: API 버전 '2020-10-02'에서 도입되었습니다.
LeaseProperties	Blob 임대 속성입니다.
LinearRetry	선형 재시도. 선형 재시도 개체를 생성합니다.
LocationMode	요청을 보내야 하는 위치를 지정합니다. 이 모드는 보조 읽기 액세스를 허용하는 RA-GRS 계정에만 적용됩니다. 다른 모든 계정 유형은 PRIMARY를 사용해야 합니다.
Metrics	Blob에 대한 시간 또는 분 집계에서 API별로 그룹화된 요청 통계의 요약입니다.
ObjectReplicationPolicy	Blob에 적용된 정책 ID 및 규칙 ID입니다.
ObjectReplicationRule	Blob에 적용된 정책 ID 및 규칙 ID입니다.
PageRange	페이지 Blob의 페이지 범위입니다.
PartialBatchErrorException	일괄 작업에서 부분 오류가 발생합니다.
ResourceTypes	계정 SAS를 사용하여 액세스할 수 있는 리소스 유형을 지정합니다.
RetentionPolicy	연결된 데이터를 유지할 기간을 결정하는 보존 정책입니다.
StaticWebsite	계정이 정적 웹 사이트를 호스트할 수 있도록 하는 속성입니다.
StorageStreamDownloader	Azure Storage에서 다운로드할 스트리밍 개체입니다.
UserDelegationKey	Azure Active Directory 액세스 토큰을 기반으로 Azure Storage에서 사용자에게 제공하는 사용자 위임 키를 나타냅니다. 필드는 사용자가 이 개체와 상호 작용할 필요가 없으므로 단순 문자열로 저장됩니다. 식별 SAS를 생성하기 위해 사용자는 단순히 올바른 API에 전달할 수 있습니다.

열거형

ArrowType
BlobImmutabilityPolicyMode	Blob에서 설정할 불변성 정책 모드를 지정합니다. "변경 가능"은 서비스에서만 반환할 수 있으며 "변경 가능"으로 설정되지 않습니다.
BlobType
BlockState	블록 Blob 블록 형식입니다.
PremiumPageBlobTier	Blob을 설정할 페이지 Blob 계층을 지정합니다. 이는 Premium Storage 계정의 페이지 Blob에만 적용됩니다. 해당 IOPS 및 PageBlobTier당 처리량에 대한 자세한 내용은 다음을 참조 https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets 하세요.
PublicAccess	컨테이너의 데이터를 공개적으로 액세스할 수 있는지 여부 및 액세스 수준을 지정합니다.
QuickQueryDialect	빠른 쿼리 입력/출력 방언을 지정합니다.
RehydratePriority	개체가 리하일레이트 보류 상태인 경우 이 헤더는 리하이드레이션 우선 순위로 반환됩니다. 유효한 값은 높음 및 표준입니다.
SequenceNumberAction	시퀀스 번호 작업.
StandardBlobTier	Blob을 설정할 Blob 계층을 지정합니다. 표준 스토리지 계정의 블록 Blob에만 적용됩니다.
StorageErrorCode

함수

download_blob_from_url

Blob의 콘텐츠를 로컬 파일 또는 스트림에 다운로드합니다.

download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

매개 변수

blob_url

str

필수

Blob에 대한 전체 URI입니다. 여기에는 SAS 토큰도 포함될 수 있습니다.

output

str 또는 <xref:<xref:writable stream.>>

필수

데이터를 다운로드해야 하는 위치입니다. 쓸 파일 경로 또는 쓸 열린 IO 핸들일 수 있습니다.

credential

기본값: None

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

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

overwrite

bool

이미 있는 경우 로컬 파일을 덮어쓸지 여부입니다. 기본값은 False 입니다. 이 경우 파일이 이미 있는 경우 ValueError가 발생합니다. True로 설정하면 기존 파일에 쓰려고 시도합니다. 스트림 핸들이 전달되면 이 값은 무시됩니다.

max_concurrency

int

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

offset

int

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

length

int

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

validate_content

bool

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

반환 형식

None

generate_account_sas

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

반환된 서명을 BlobServiceClient, ContainerClient 또는 BlobClient의 자격 증명 매개 변수와 함께 사용합니다.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, start: datetime | str | None = None, ip: str | None = None, **kwargs: Any) -> str

매개 변수

account_name

str

필수

공유 액세스 서명을 생성하는 데 사용되는 스토리지 계정 이름입니다.

account_key

str

필수

공유 액세스 서명을 생성하기 위해 공유 키 또는 액세스 키라고도 하는 계정 키입니다.

resource_types

str 또는 ResourceTypes

필수

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

permission

str 또는 AccountSasPermissions

필수

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

expiry

datetime 또는 str

필수

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

start

datetime 또는 str

기본값: None

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

ip

str

기본값: None

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

protocol

str

요청이 허용되는 프로토콜을 지정합니다. 기본값은 https입니다.

encryption_scope

str

모든 쓰기 작업이 서비스 암호화되도록 요청의 암호화 scope 지정합니다.

반환

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

반환 형식

str

generate_blob_sas

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

반환된 서명을 BlobServiceClient, ContainerClient 또는 BlobClient의 자격 증명 매개 변수와 함께 사용합니다.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

매개 변수

account_name

str

필수

공유 액세스 서명을 생성하는 데 사용되는 스토리지 계정 이름입니다.

container_name

str

필수

컨테이너의 이름입니다.

blob_name

str

필수

blob의 이름입니다.

snapshot

str

기본값: None

선택적 Blob 스냅샷 ID입니다.

account_key

str

기본값: None

공유 액세스 서명을 생성하기 위해 공유 키 또는 액세스 키라고도 하는 계정 키입니다. account_key 또는 user_delegation_key 지정해야 합니다.

user_delegation_key

UserDelegationKey

기본값: None

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

permission

str 또는 BlobSasPermissions

기본값: None

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

expiry

datetime 또는 str

기본값: None

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

start

datetime 또는 str

기본값: None

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

policy_id

str

기본값: None

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

ip

str

기본값: None

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

version_id

str

선택적 Blob 버전 ID입니다. 이 매개 변수는 버전 관리 지원 Storage 계정에만 적용됩니다. 'versionid' 쿼리 매개 변수는 출력 SAS에 포함되지 않습니다. 따라서 출력 SAS를 사용하여 특정 버전에서 작동할 때 모든 API에 'version_id' 매개 변수를 제공하세요.

버전 12.4.0의 새로운 기능: 이 키워드(keyword) 인수는 API 버전 '2019-12-12'에서 도입되었습니다.

protocol

str

요청이 허용되는 프로토콜을 지정합니다. 기본값은 https입니다.

cache_control

str

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

content_disposition

str

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

content_encoding

str

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

content_language

str

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

content_type

str

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

encryption_scope

str

모든 쓰기 작업이 서비스 암호화되도록 요청의 암호화 scope 지정합니다.

correlation_id

str

스토리지 감사 로그와 SAS를 생성하고 배포하는 주체가 사용하는 감사 로그의 상관 관계를 지정하는 상관 관계 ID입니다. 위임 키를 사용하여 SAS를 생성할 때만 사용할 수 있습니다.

반환

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

반환 형식

str

generate_container_sas

컨테이너에 대한 공유 액세스 서명을 생성합니다.

반환된 서명을 BlobServiceClient, ContainerClient 또는 BlobClient의 자격 증명 매개 변수와 함께 사용합니다.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

매개 변수

account_name

str

필수

공유 액세스 서명을 생성하는 데 사용되는 스토리지 계정 이름입니다.

container_name

str

필수

컨테이너의 이름입니다.

account_key

str

기본값: None

공유 액세스 서명을 생성하기 위해 공유 키 또는 액세스 키라고도 하는 계정 키입니다. account_key 또는 user_delegation_key 지정해야 합니다.

user_delegation_key

UserDelegationKey

기본값: None

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

permission

str 또는 ContainerSasPermissions

기본값: None

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

expiry

datetime 또는 str

기본값: None

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

start

datetime 또는 str

기본값: None

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

policy_id

str

기본값: None

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

ip

str

기본값: None

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

protocol

str

요청이 허용되는 프로토콜을 지정합니다. 기본값은 https입니다.

cache_control

str

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

content_disposition

str

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

content_encoding

str

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

content_language

str

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

content_type

str

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

encryption_scope

str

모든 쓰기 작업이 서비스 암호화되도록 요청의 암호화 scope 지정합니다.

correlation_id

str

스토리지 감사 로그를 SAS를 생성하고 배포하는 보안 주체가 사용하는 감사 로그와 상관 관계를 지정하는 상관 관계 ID입니다. 위임 키를 사용하여 SAS를 생성할 때만 사용할 수 있습니다.

반환

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

반환 형식

str

upload_blob_to_url

지정된 URL에 데이터 업로드

데이터는 블록 Blob으로 업로드됩니다.

upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> Dict[str, Any]

매개 변수

blob_url

str

필수

Blob에 대한 전체 URI입니다. 여기에는 SAS 토큰도 포함될 수 있습니다.

data

bytes 또는 str 또는 Iterable

필수

업로드할 데이터입니다. 바이트, 텍스트, 반복 가능 개체 또는 파일과 같은 개체일 수 있습니다.

credential

기본값: None

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

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

overwrite

bool

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

max_concurrency

int

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

length

int

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

metadata

dict(str,str)

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

validate_content

bool

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

encoding

str

텍스트가 입력으로 제공되는 경우 사용할 인코딩입니다. 기본값은 UTF-8입니다.

반환

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

반환 형식

dict(str, Any)