次の方法で共有


blob パッケージ

パッケージ

aio

クラス

AccessPolicy

各サービスの set メソッドと get アクセス ポリシー メソッドによって使用されるアクセス ポリシー クラス。

保存されているアクセス ポリシーでは、関連付けられている共有アクセス署名の開始時刻、有効期限、およびアクセス許可を指定できます。 リソースへのアクセスを制御する方法に応じて、格納されているアクセス ポリシー内でこれらのパラメーターをすべて指定し、Shared Access Signature の URL からそれらを省略できます。 これにより、関連付けられた署名の動作をいつでも変更または取り消しできます。 また、保存されているアクセス ポリシー内で 1 つ以上のアクセス ポリシー パラメーターを指定し、残りのパラメーターを URL で指定することもできます。 すべてのパラメーターを URL で指定することもできます。 この場合、保存されているアクセス ポリシーを使用して署名を取り消すことができますが、署名の動作を変更することはできません。

共有アクセス署名と保存されているアクセス ポリシーの組み合わせには、署名を認証するために必要なすべてのフィールドが含まれている必要があります。 必須フィールドが欠落している場合、要求は失敗します。 同様に、共有アクセス署名の URL と保存されているアクセス ポリシーの両方で同じフィールドが指定されている場合、ステータス コード 400 (Bad Request) が返されて要求は失敗します。

AccountSasPermissions

ResourceTypes set_*_aclで使用される accessPolicies に対して、generate_account_sas関数と共に使用される クラス。 リソース へのアクセスを許可するために使用できる SAS には 2 種類があります。 1 つは、特定のリソース (リソース固有) へのアクセスを許可することです。 もう 1 つは、特定のアカウントのサービス全体へのアクセス権を付与し、ここで見つかったパームに基づいて特定の操作を許可することです。

ArrowDialect

矢印スキーマのフィールド。

Azure に送信するには、必要なすべてのパラメーターを設定する必要があります。

BlobAnalyticsLogging

Azure Analytics のログ設定。

BlobBlock

BlockBlob Block クラス。

BlobClient

特定の BLOB と対話するクライアント。ただし、その BLOB はまだ存在しない可能性があります。

その他のオプションの構成については、 ここをクリックしてください。

BlobLeaseClient

新しい BlobLeaseClient を作成します。

このクライアントは、BlobClient または ContainerClient に対するリース操作を提供します。

BlobPrefix

BLOB プロパティの Iterable。

区切り記号が使用されている場合にwalk_blobsから返されます。 仮想 BLOB ディレクトリと考えることができます。

BlobProperties

BLOB のプロパティ。

BlobQueryError

このエラーは、クイック クエリ操作中に発生しました。

BlobQueryReader

クエリ結果を読み取るストリーミング オブジェクト。

BlobSasPermissions

関数で generate_blob_sas 使用する BlobSasPermissions クラス。

BlobServiceClient

アカウント レベルで BLOB サービスと対話するクライアント。

このクライアントは、アカウントのプロパティの取得と構成、およびアカウント内のコンテナーの一覧表示、作成、削除を行う操作を提供します。 特定のコンテナーまたは BLOB に関連する操作の場合、これらのエンティティのクライアントは 、get_client 関数を使用して取得することもできます。

その他のオプションの構成については、 ここをクリックしてください。

ContainerClient

特定のコンテナーと対話するクライアント。ただし、そのコンテナーはまだ存在しない可能性があります。

このコンテナー内の特定の BLOB に関連する操作では、 関数を使用して BLOB クライアントを get_blob_client 取得できます。

その他のオプションの構成については、 ここをクリックしてください。

ContainerEncryptionScope

コンテナーの既定の暗号化スコープ構成。

このスコープは、コンテナー内の今後のすべての書き込みに暗黙的に使用されますが、BLOB 操作ごとにオーバーライドできます。

バージョン 12.2.0 の新機能。

ContainerProperties

BLOB コンテナーのプロパティ クラス。

返される ContainerProperties インスタンスは、ディクショナリ インターフェイスを介してこれらの値を公開します (例: container_props["last_modified"])。 さらに、コンテナー名は として container_props["name"]使用できます。

ContainerSasPermissions

ContainerSasPermissions クラスは、 関数で使用され、 で generate_container_sas 使用される AccessPolicies に対して set_container_access_policy使用されます。

ContentSettings

BLOB のコンテンツ設定。

CopyProperties

BLOB コピーのプロパティ。

これらのプロパティは、BLOB のコピー操作でこの BLOB がコピー先になっていない場合、または BLOB のコピー操作が終了した後にこの BLOB が変更された場合 (たとえば、[BLOB のプロパティの設定]、[BLOB のアップロード]、または [コミット ブロック リスト] の使用) の場合は None になります。

CorsRule

CORS は、あるドメインで実行されている Web アプリケーションが別のドメイン内にあるリソースにアクセスできるようにする HTTP 機能です。 Web ブラウザーには、Web ページで別のドメインの 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 シリアル化を定義します。

キーワード (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

線形再試行。

Linear 再試行オブジェクトを構築します。

LocationMode

要求の送信先の場所を指定します。 このモードは、セカンダリ読み取りアクセスを許可する RA-GRS アカウントにのみ適用されます。 他のすべてのアカウントの種類では PRIMARY を使用する必要があります。

Metrics

BLOB の時間または分単位の集計で API ごとにグループ化された要求統計の概要。

ObjectReplicationPolicy

BLOB に適用されるポリシー ID とルール ID。

ObjectReplicationRule

BLOB に適用されるポリシー ID とルール ID。

PageRange

ページ BLOB のページ範囲。

PartialBatchErrorException

バッチ操作で部分的なエラーが発生しました。

ResourceTypes

アカウント SAS でアクセスできるリソースの種類を指定します。

RetentionPolicy

関連付けられているデータを保持する期間を決定するアイテム保持ポリシー。

StaticWebsite

アカウントが静的 Web サイトをホストできるようにするプロパティ。

StorageStreamDownloader

Azure Storage からダウンロードするストリーミング オブジェクト。

UserDelegationKey

Azure Active Directory アクセス トークンに基づいて Azure Storage によってユーザーに提供されるユーザー委任キーを表します。

ユーザーはこのオブジェクトを操作する必要がないため、フィールドは単純な文字列として保存されます。識別 SAS を生成するために、ユーザーは単純に適切な API に渡すことができます。

列挙型

ArrowType
BlobImmutabilityPolicyMode

BLOB に設定する不変ポリシー モードを指定します。 "Mutable" はサービスによってのみ返すことができます。"Mutable" に設定しないでください。

BlobType
BlockState

ブロック BLOB ブロックの種類。

PremiumPageBlobTier

BLOB を設定するページ BLOB 層を指定します。 これは、Premium Storage アカウントのページ BLOB にのみ適用されます。 PageBlobTier ごとの対応する IOPS とスループットの詳細については、次を参照 https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets してください。

PublicAccess

コンテナー内のデータがパブリックにアクセス可能かどうかと、アクセスのレベルを指定します。

QuickQueryDialect

クイック クエリの入出力言語を指定します。

RehydratePriority

オブジェクトがリハイドレート保留中の状態の場合、このヘッダーはリハイドレートの優先順位で返されます。 有効な値は High と Standard です。

SequenceNumberAction

シーケンス番号アクション。

StandardBlobTier

BLOB を設定する BLOB 層を指定します。 これは、Standard ストレージ アカウントのブロック 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 のインスタンス、アカウント共有アクセス キー、または azure.identity からの TokenCredentials クラスのインスタンスを指定できます。 リソース URI に SAS トークンが既に含まれている場合、明示的な資格情報を優先して無視されます

  • ただし、競合する SAS トークンによって ValueError が発生する AzureSasCredential の場合を除きます。 AzureNamedKeyCredential のインスタンスを使用する場合は、"name" をストレージ アカウント名に、"key" をストレージ アカウント キーにする必要があります。
overwrite
bool

ローカル ファイルが既に存在する場合に上書きする必要があるかどうか。 既定値は False です。この場合、ファイルが既に存在する場合は ValueError が発生します。 True に設定すると、既存のファイルへの書き込みが試行されます。 ストリーム ハンドルが渡された場合、この値は無視されます。

max_concurrency
int

ダウンロードする並列接続の数。

offset
int

BLOB のセクションのダウンロードに使用するバイト範囲の先頭。 length が指定されている場合は、 を設定する必要があります。

length
int

ストリームから読み取るバイト数。 これは省略可能ですが、最適なパフォーマンスを得るには指定する必要があります。

validate_content
bool

true の場合、BLOB の各チャンクの MD5 ハッシュが計算されます。 ストレージ サービスは、送信されたハッシュで到着したコンテンツのハッシュをチェックします。 これは主に、https として https (既定値) ではなく https を使用して既に検証する場合に、ネットワーク上のビットフラグを検出する場合に重要です。 この MD5 ハッシュは BLOB と共に保存されません。 また、MD5 ハッシュを計算するにはブロック全体をバッファリングする必要があり、これによりメモリ効率の高いアルゴリズムの目的が無効になるため、有効にすると、メモリ効率の高いアップロード アルゴリズムは使用されないことに注意してください。

の戻り値の型 :

generate_account_sas

BLOB サービスの共有アクセス署名を生成します。

返された署名は、BlobServiceClient、ContainerClient、または BlobClient の credential パラメーターと共に使用します。

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

すべての書き込み操作がサービスで暗号化されるように、要求の暗号化スコープを指定します。

戻り値

Shared Access Signature (sas) トークン。

の戻り値の型 :

str

generate_blob_sas

BLOB の共有アクセス署名を生成します。

返された署名は、BlobServiceClient、ContainerClient、または BlobClient の credential パラメーターと共に使用します。

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。 このパラメーターは、バージョン管理が有効なストレージ アカウントにのみ適用されます。 '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

すべての書き込み操作がサービスで暗号化されるように、要求の暗号化スコープを指定します。

correlation_id
str

ストレージ監査ログと、SAS を生成して配布するプリンシパルによって使用される監査ログを関連付ける関連付け ID。 これは、委任キーを使用して SAS を生成する場合にのみ使用できます。

戻り値

Shared Access Signature (sas) トークン。

の戻り値の型 :

str

generate_container_sas

コンテナーの共有アクセス署名を生成します。

返された署名は、BlobServiceClient、ContainerClient、または BlobClient の credential パラメーターと共に使用します。

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

すべての書き込み操作がサービスで暗号化されるように、要求の暗号化スコープを指定します。

correlation_id
str

ストレージ監査ログと、SAS を生成して配布するプリンシパルによって使用される監査ログを関連付ける関連付け ID。 これは、委任キーを使用して SAS を生成する場合にのみ使用できます。

戻り値

Shared Access Signature (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
必須

アップロードするデータ。 これには、バイト、テキスト、iterable オブジェクト、またはファイルに似たオブジェクトを指定できます。

credential
既定値: None

認証に使用する資格情報。 BLOB URL に SAS トークンが既に含まれている場合、これは省略可能です。 値には、SAS トークン文字列、azure.core.credentials の AzureSasCredential または AzureNamedKeyCredential のインスタンス、アカウント共有アクセス キー、または azure.identity からの TokenCredentials クラスのインスタンスを指定できます。 リソース URI に SAS トークンが既に含まれている場合、明示的な資格情報を優先して無視されます

  • ただし、競合する SAS トークンによって ValueError が発生する AzureSasCredential の場合を除きます。 AzureNamedKeyCredential のインスタンスを使用する場合は、"name" をストレージ アカウント名に、"key" をストレージ アカウント キーにする必要があります。
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 (既定値) ではなく https を使用して既に検証する場合に、ネットワーク上のビットフラグを検出する場合に重要です。 この MD5 ハッシュは BLOB と共に保存されません。 また、MD5 ハッシュを計算するにはブロック全体をバッファリングする必要があり、これによりメモリ効率の高いアルゴリズムの目的が無効になるため、有効にすると、メモリ効率の高いアップロード アルゴリズムは使用されないことに注意してください。

encoding
str

テキストが入力として指定されている場合に使用するエンコード。 既定値は UTF-8 です。

戻り値

BLOB で更新されたプロパティの dict (Etag と最終更新日)

の戻り値の型 :