Bagikan melalui


blob Paket

Paket

aio

Kelas

AccessPolicy

Kelas Kebijakan Akses yang digunakan oleh set dan mendapatkan metode kebijakan akses di setiap layanan.

Kebijakan akses tersimpan dapat menentukan waktu mulai, waktu kedaluwarsa, dan izin untuk Tanda Tangan Akses Bersama yang terkait dengannya. Bergantung pada bagaimana Anda ingin mengontrol akses ke sumber daya, Anda dapat menentukan semua parameter ini dalam kebijakan akses tersimpan, dan menghilangkannya dari URL untuk Tanda Tangan Akses Bersama. Melakukannya memungkinkan Anda untuk memodifikasi perilaku tanda tangan terkait kapan saja, serta mencabutnya. Atau Anda dapat menentukan satu atau beberapa parameter kebijakan akses dalam kebijakan akses tersimpan, dan yang lainnya di URL. Terakhir, Anda dapat menentukan semua parameter pada URL. Dalam hal ini, Anda dapat menggunakan kebijakan akses tersimpan untuk mencabut tanda tangan, tetapi tidak mengubah perilakunya.

Bersama-sama Tanda Tangan Akses Bersama dan kebijakan akses tersimpan harus menyertakan semua bidang yang diperlukan untuk mengautentikasi tanda tangan. Jika ada bidang yang diperlukan yang hilang, permintaan akan gagal. Demikian juga, jika bidang ditentukan baik di URL Tanda Tangan Akses Bersama maupun dalam kebijakan akses tersimpan, permintaan akan gagal dengan kode status 400 (Permintaan Buruk).

AccountSasPermissions

ResourceTypes kelas yang akan digunakan dengan fungsi generate_account_sas dan untuk AccessPolicies yang digunakan dengan set_*_acl. Ada dua jenis SAS yang dapat digunakan untuk memberikan akses sumber daya. Salah satunya adalah memberikan akses ke sumber daya tertentu (khusus sumber daya). Yang lain adalah memberikan akses ke seluruh layanan untuk akun tertentu dan memungkinkan operasi tertentu berdasarkan perm yang ditemukan di sini.

ArrowDialect

bidang skema panah.

Semua parameter yang diperlukan harus diisi untuk dikirim ke Azure.

BlobAnalyticsLogging

Pengaturan Pengelogan Azure Analytics.

BlobBlock

Kelas Blok BlokBlob.

BlobClient

Klien untuk berinteraksi dengan blob tertentu, meskipun blob tersebut mungkin belum ada.

Untuk konfigurasi opsional lainnya, silakan klik di sini.

BlobLeaseClient

Membuat BlobLeaseClient baru.

Klien ini menyediakan operasi sewa pada BlobClient atau ContainerClient.

BlobPrefix

Properti Blob yang Dapat Diulang.

Dikembalikan dari walk_blobs saat pemisah digunakan. Dapat dianggap sebagai direktori blob virtual.

BlobProperties

Properti Blob.

BlobQueryError

Kesalahan terjadi selama operasi kueri cepat.

BlobQueryReader

Objek streaming untuk membaca hasil kueri.

BlobSasPermissions

Kelas BlobSasPermissions yang akan digunakan dengan generate_blob_sas fungsi .

BlobServiceClient

Klien untuk berinteraksi dengan Blob Service di tingkat akun.

Klien ini menyediakan operasi untuk mengambil dan mengonfigurasi properti akun serta mencantumkan, membuat dan menghapus kontainer dalam akun. Untuk operasi yang berkaitan dengan kontainer atau blob tertentu, klien untuk entitas tersebut juga dapat diambil menggunakan fungsi get_client .

Untuk konfigurasi opsional lainnya, silakan klik di sini.

ContainerClient

Klien untuk berinteraksi dengan kontainer tertentu, meskipun kontainer tersebut mungkin belum ada.

Untuk operasi yang berkaitan dengan blob tertentu dalam kontainer ini, klien blob dapat diambil menggunakan fungsi .get_blob_client

Untuk konfigurasi opsional lainnya, silakan klik di sini.

ContainerEncryptionScope

Konfigurasi cakupan enkripsi default untuk kontainer.

Cakupan ini digunakan secara implisit untuk semua penulisan di masa mendatang dalam kontainer, tetapi dapat ditimpa per operasi blob.

Baru dalam versi 12.2.0.

ContainerProperties

Kelas properti kontainer blob.

Instans yang dikembalikan ContainerProperties mengekspos nilai-nilai ini melalui antarmuka kamus, misalnya: container_props["last_modified"]. Selain itu, nama kontainer tersedia sebagai container_props["name"].

ContainerSasPermissions

Kelas ContainerSasPermissions yang akan digunakan dengan generate_container_sas fungsi dan untuk AccessPolicies yang digunakan dengan set_container_access_policy.

ContentSettings

Pengaturan konten blob.

CopyProperties

Properti Salinan Blob.

Properti ini tidak akan ada jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan, misalnya, menggunakan Atur Properti Blob, Unggah Blob, atau Terapkan Daftar Blokir.

CorsRule

CORS adalah fitur HTTP yang memungkinkan aplikasi web berjalan di bawah satu domain untuk mengakses sumber daya di domain lain. Browser web menerapkan pembatasan keamanan yang dikenal sebagai kebijakan asal yang sama yang mencegah halaman web memanggil API di domain yang berbeda; CORS menyediakan cara yang aman untuk memungkinkan satu domain (domain asal) untuk memanggil API di domain lain.

CustomerProvidedEncryptionKey

Semua data di Azure Storage dienkripsi saat tidak aktif menggunakan kunci enkripsi tingkat akun. Dalam versi 2018-06-17 dan yang lebih baru, Anda dapat mengelola kunci yang digunakan untuk mengenkripsi konten blob dan metadata aplikasi per blob dengan menyediakan kunci enkripsi AES-256 dalam permintaan ke layanan penyimpanan.

Saat Anda menggunakan kunci yang disediakan pelanggan, Azure Storage tidak mengelola atau mempertahankan kunci Anda. Saat menulis data ke blob, kunci yang disediakan digunakan untuk mengenkripsi data Anda sebelum menulisnya ke disk. Hash SHA-256 dari kunci enkripsi ditulis bersama konten blob, dan digunakan untuk memverifikasi bahwa semua operasi berikutnya terhadap blob menggunakan kunci enkripsi yang sama. Hash ini tidak dapat digunakan untuk mengambil kunci enkripsi atau mendekripsi konten blob. Saat membaca blob, kunci yang disediakan digunakan untuk mendekripsi data Anda setelah membacanya dari disk. Dalam kedua kasus, kunci enkripsi yang disediakan dibuang dengan aman segera setelah proses enkripsi atau dekripsi selesai.

DelimitedJsonDialect

Menentukan serialisasi JSON input atau output untuk kueri data blob.

pemisah str kata kunci: Karakter pemisah baris, nilai defaultnya adalah '

'

DelimitedTextDialect

Menentukan serialisasi input atau output yang dibatasi (CSV) untuk permintaan kueri blob.

ExponentialRetry

Percobaan ulang eksponensial.

Membuat objek percobaan ulang Eksponensial. initial_backoff digunakan untuk percobaan ulang pertama. Percobaan ulang berikutnya dicoba kembali setelah initial_backoff + increment_power^retry_count detik.

FilteredBlob

Info blob dari panggilan API Filter Blobs.

ImmutabilityPolicy

Parameter opsional untuk mengatur kebijakan kekekalan blob, rekam jepret blob, atau versi blob.

Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.

LeaseProperties

Properti Sewa Blob.

LinearRetry

Coba lagi linier.

Membuat objek coba lagi Linear.

LocationMode

Menentukan lokasi tempat permintaan harus dikirim. Mode ini hanya berlaku untuk akun RA-GRS yang memungkinkan akses baca sekunder. Semua jenis akun lainnya harus menggunakan PRIMARY.

Metrics

Ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat jam atau menit untuk blob.

ObjectReplicationPolicy

Id kebijakan dan id aturan diterapkan ke blob.

ObjectReplicationRule

Id kebijakan dan id aturan diterapkan ke blob.

PageRange

Rentang Halaman untuk blob halaman.

PartialBatchErrorException

Ada kegagalan parsial dalam operasi batch.

ResourceTypes

Menentukan jenis sumber daya yang dapat diakses dengan SAS akun.

RetentionPolicy

Kebijakan penyimpanan yang menentukan berapa lama data terkait harus bertahan.

StaticWebsite

Properti yang memungkinkan akun untuk menghosting situs web statis.

StorageStreamDownloader

Objek streaming untuk diunduh dari Azure Storage.

UserDelegationKey

Mewakili kunci delegasi pengguna, yang diberikan kepada pengguna oleh Azure Storage berdasarkan token akses Azure Active Directory mereka.

Bidang disimpan sebagai string sederhana karena pengguna tidak harus berinteraksi dengan objek ini; untuk menghasilkan SAS identifikasi, pengguna cukup meneruskannya ke API yang tepat.

Enum

ArrowType
BlobImmutabilityPolicyMode

Menentukan mode kebijakan imutabilitas yang akan diatur pada blob. "Dapat diubah" hanya dapat dikembalikan oleh layanan, jangan atur ke "Dapat Diubah".

BlobType
BlockState

Jenis blok blob blok blok.

PremiumPageBlobTier

Menentukan tingkat blob halaman untuk mengatur blob. Ini hanya berlaku untuk blob halaman pada akun penyimpanan premium. Silakan lihat: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets untuk informasi terperinci tentang IOPS dan throughput yang sesuai per PageBlobTier.

PublicAccess

Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.

QuickQueryDialect

Menentukan dialek input/output kueri cepat.

RehydratePriority

Jika objek dalam status tertunda rehidrasi, header ini dikembalikan dengan prioritas rehidrasi. Nilai yang valid adalah Tinggi dan Standar.

SequenceNumberAction

Tindakan nomor urut.

StandardBlobTier

Menentukan tingkat blob untuk mengatur blob. Ini hanya berlaku untuk blob blok pada akun penyimpanan standar.

StorageErrorCode

Fungsi

download_blob_from_url

Unduh konten blob ke file atau streaming lokal.

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

Parameter

blob_url
str
Diperlukan

URI penuh ke blob. Ini juga dapat mencakup token SAS.

output
str atau <xref:<xref:writable stream.>>
Diperlukan

Tempat data harus diunduh. Ini bisa berupa jalur file untuk ditulis, atau handel IO terbuka untuk ditulis.

credential
nilai default: None

Kredensial yang digunakan untuk mengautentikasi. Ini opsional jika URL blob sudah memiliki token SAS atau blob bersifat publik. Nilainya dapat berupa string token SAS, instans AzureSasCredential atau AzureNamedKeyCredential dari azure.core.credentials, kunci akses bersama akun, atau instans kelas TokenCredentials dari azure.identity. Jika URI sumber daya sudah berisi token SAS, ini akan diabaikan demi kredensial eksplisit

  • kecuali dalam kasus AzureSasCredential, di mana token SAS yang bertentangan akan memunculkan ValueError. Jika menggunakan instans AzureNamedKeyCredential, "nama" harus menjadi nama akun penyimpanan, dan "kunci" harus menjadi kunci akun penyimpanan.
overwrite
bool

Apakah file lokal harus ditimpa jika sudah ada. Nilai defaultnya adalah False - dalam hal ini ValueError akan dinaikkan jika file sudah ada. Jika diatur ke True, upaya akan dilakukan untuk menulis ke file yang ada. Jika handel stream diteruskan, nilai ini diabaikan.

max_concurrency
int

Jumlah koneksi paralel yang akan diunduh.

offset
int

Mulai rentang byte yang digunakan untuk mengunduh bagian blob. Harus diatur jika panjang disediakan.

length
int

Jumlah byte yang akan dibaca dari aliran. Ini opsional, tetapi harus disediakan untuk performa optimal.

validate_content
bool

Jika true, menghitung hash MD5 untuk setiap gugus blob. Layanan penyimpanan memeriksa hash konten yang telah tiba dengan hash yang dikirim. Ini terutama berharga untuk mendeteksi bitflip pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa hash MD5 ini tidak disimpan dengan blob. Perhatikan juga bahwa jika diaktifkan, algoritma pengunggahan yang hemat memori tidak akan digunakan, karena komputasi hash MD5 memerlukan buffering seluruh blok, dan melakukannya mengalahkan tujuan algoritma yang hemat memori.

Tipe hasil

generate_account_sas

Menghasilkan tanda tangan akses bersama untuk layanan blob.

Gunakan tanda tangan yang dikembalikan dengan parameter kredensial blobServiceClient, ContainerClient, atau BlobClient apa pun.

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

Parameter

account_name
str
Diperlukan

Nama akun penyimpanan yang digunakan untuk menghasilkan tanda tangan akses bersama.

account_key
str
Diperlukan

Kunci akun, juga disebut kunci bersama atau kunci akses, untuk menghasilkan tanda tangan akses bersama.

resource_types
str atau ResourceTypes
Diperlukan

Menentukan jenis sumber daya yang dapat diakses dengan SAS akun.

permission
str atau AccountSasPermissions
Diperlukan

Izin yang terkait dengan tanda tangan akses bersama. Pengguna dibatasi untuk operasi yang diizinkan oleh izin. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait.

expiry
datetime atau str
Diperlukan

Waktu saat tanda tangan akses bersama menjadi tidak valid. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.

start
datetime atau str
nilai default: None

Waktu di mana tanda tangan akses bersama menjadi valid. Jika dihilangkan, waktu mulai untuk panggilan ini diasumsikan sebagai waktu ketika layanan penyimpanan menerima permintaan. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.

ip
str
nilai default: None

Menentukan alamat IP atau rentang alamat IP untuk menerima permintaan. Jika alamat IP tempat permintaan berasal tidak cocok dengan alamat IP atau rentang alamat yang ditentukan pada token SAS, permintaan tidak diautentikasi. Misalnya, menentukan ip=168.1.5.65 atau ip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.

protocol
str

Menentukan protokol yang diizinkan untuk permintaan yang dibuat. Nilai defaultnya adalah https.

encryption_scope
str

Menentukan cakupan enkripsi untuk permintaan yang dibuat sehingga semua operasi tulis akan dienkripsi layanan.

Mengembalikan

Token Tanda Tangan Akses Bersama (sas).

Tipe hasil

str

generate_blob_sas

Menghasilkan tanda tangan akses bersama untuk blob.

Gunakan tanda tangan yang dikembalikan dengan parameter kredensial blobServiceClient, ContainerClient, atau BlobClient apa pun.

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

Parameter

account_name
str
Diperlukan

Nama akun penyimpanan yang digunakan untuk menghasilkan tanda tangan akses bersama.

container_name
str
Diperlukan

Nama kontainer.

blob_name
str
Diperlukan

Nama blob.

snapshot
str
nilai default: None

ID rekam jepret blob opsional.

account_key
str
nilai default: None

Kunci akun, juga disebut kunci bersama atau kunci akses, untuk menghasilkan tanda tangan akses bersama. Baik account_key atau user_delegation_key harus ditentukan.

user_delegation_key
UserDelegationKey
nilai default: None

Alih-alih kunci bersama akun, pengguna dapat meneruskan kunci delegasi pengguna. Kunci delegasi pengguna dapat diperoleh dari layanan dengan mengautentikasi dengan identitas AAD; ini dapat dicapai dengan memanggil get_user_delegation_key. Saat ada, SAS ditandatangani dengan kunci delegasi pengguna sebagai gantinya.

permission
str atau BlobSasPermissions
nilai default: None

Izin yang terkait dengan tanda tangan akses bersama. Pengguna dibatasi untuk operasi yang diizinkan oleh izin. Izin harus diurutkan racwdxytmei. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait.

expiry
datetime atau str
nilai default: None

Waktu saat tanda tangan akses bersama menjadi tidak valid. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.

start
datetime atau str
nilai default: None

Waktu di mana tanda tangan akses bersama menjadi valid. Jika dihilangkan, waktu mulai untuk panggilan ini diasumsikan sebagai waktu ketika layanan penyimpanan menerima permintaan. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.

policy_id
str
nilai default: None

Panjang nilai unik hingga 64 karakter yang berkorelasi dengan kebijakan akses tersimpan. Untuk membuat kebijakan akses tersimpan, gunakan set_container_access_policy.

ip
str
nilai default: None

Menentukan alamat IP atau rentang alamat IP untuk menerima permintaan. Jika alamat IP tempat permintaan berasal tidak cocok dengan alamat IP atau rentang alamat yang ditentukan pada token SAS, permintaan tidak diautentikasi. Misalnya, menentukan ip=168.1.5.65 atau ip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.

version_id
str

ID versi blob opsional. Parameter ini hanya berlaku untuk akun Storage yang mendukung penerapan versi. Perhatikan bahwa parameter kueri 'versionid' tidak disertakan dalam SAS output. Oleh karena itu, berikan parameter 'version_id' ke API apa pun saat menggunakan SAS output untuk beroperasi pada versi tertentu.

Baru dalam versi 12.4.0: Argumen kata kunci ini diperkenalkan dalam versi API '2019-12-12'.

protocol
str

Menentukan protokol yang diizinkan untuk permintaan yang dibuat. Nilai defaultnya adalah https.

cache_control
str

Nilai header respons untuk Cache-Control saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

content_disposition
str

Nilai header respons untuk Content-Disposition saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

content_encoding
str

Nilai header respons untuk Pengodean Konten saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

content_language
str

Nilai header respons untuk Content-Language saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

content_type
str

Nilai header respons untuk Jenis Konten saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

encryption_scope
str

Menentukan cakupan enkripsi untuk permintaan yang dibuat sehingga semua operasi tulis akan dienkripsi layanan.

correlation_id
str

Id korelasi untuk menghubungkan log audit penyimpanan dengan log audit yang digunakan oleh perwakilan yang menghasilkan dan mendistribusikan SAS. Ini hanya dapat digunakan saat menghasilkan SAS dengan kunci delegasi.

Mengembalikan

Token Tanda Tangan Akses Bersama (sas).

Tipe hasil

str

generate_container_sas

Menghasilkan tanda tangan akses bersama untuk kontainer.

Gunakan tanda tangan yang dikembalikan dengan parameter info masuk blobServiceClient, ContainerClient, atau BlobClient apa pun.

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

Parameter

account_name
str
Diperlukan

Nama akun penyimpanan yang digunakan untuk menghasilkan tanda tangan akses bersama.

container_name
str
Diperlukan

Nama kontainer.

account_key
str
nilai default: None

Kunci akun, juga disebut kunci bersama atau kunci akses, untuk menghasilkan tanda tangan akses bersama. Baik account_key atau user_delegation_key harus ditentukan.

user_delegation_key
UserDelegationKey
nilai default: None

Alih-alih kunci bersama akun, pengguna dapat meneruskan kunci delegasi pengguna. Kunci delegasi pengguna dapat diperoleh dari layanan dengan mengautentikasi dengan identitas AAD; ini dapat dicapai dengan memanggil get_user_delegation_key. Saat ada, SAS ditandatangani dengan kunci delegasi pengguna sebagai gantinya.

permission
str atau ContainerSasPermissions
nilai default: None

Izin yang terkait dengan tanda tangan akses bersama. Pengguna dibatasi untuk operasi yang diizinkan oleh izin. Izin harus diurutkan racwdxyltfmei. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait.

expiry
datetime atau str
nilai default: None

Waktu tanda tangan akses bersama menjadi tidak valid. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.

start
datetime atau str
nilai default: None

Waktu di mana tanda tangan akses bersama menjadi valid. Jika dihilangkan, waktu mulai untuk panggilan ini diasumsikan sebagai waktu ketika layanan penyimpanan menerima permintaan. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.

policy_id
str
nilai default: None

Panjang nilai unik hingga 64 karakter yang berkorelasi dengan kebijakan akses tersimpan. Untuk membuat kebijakan akses tersimpan, gunakan set_container_access_policy.

ip
str
nilai default: None

Menentukan alamat IP atau rentang alamat IP untuk menerima permintaan. Jika alamat IP tempat permintaan berasal tidak cocok dengan alamat IP atau rentang alamat yang ditentukan pada token SAS, permintaan tidak diautentikasi. Misalnya, menentukan ip=168.1.5.65 atau ip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.

protocol
str

Menentukan protokol yang diizinkan untuk permintaan yang dibuat. Nilai defaultnya adalah https.

cache_control
str

Nilai header respons untuk Cache-Control saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

content_disposition
str

Nilai header respons untuk Content-Disposition saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

content_encoding
str

Nilai header respons untuk Pengodean Konten saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

content_language
str

Nilai header respons untuk Content-Language saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

content_type
str

Nilai header respons untuk Content-Type saat sumber daya diakses menggunakan tanda tangan akses bersama ini.

encryption_scope
str

Menentukan cakupan enkripsi untuk permintaan yang dibuat sehingga semua operasi tulis akan dienkripsi layanan.

correlation_id
str

Id korelasi untuk menghubungkan log audit penyimpanan dengan log audit yang digunakan oleh perwakilan yang menghasilkan dan mendistribusikan SAS. Ini hanya dapat digunakan saat membuat SAS dengan kunci delegasi.

Mengembalikan

Token Tanda Tangan Akses Bersama (sas).

Tipe hasil

str

upload_blob_to_url

Mengunggah data ke URL tertentu

Data akan diunggah sebagai blob blok.

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]

Parameter

blob_url
str
Diperlukan

URI penuh ke blob. Ini juga dapat mencakup token SAS.

data
bytes atau str atau Iterable
Diperlukan

Data yang akan diunggah. Ini bisa berupa byte, teks, objek yang dapat diulang atau seperti file.

credential
nilai default: None

Kredensial yang digunakan untuk mengautentikasi. Ini bersifat opsional jika URL blob sudah memiliki token SAS. Nilainya dapat berupa string token SAS, instans AzureSasCredential atau AzureNamedKeyCredential dari azure.core.credentials, kunci akses bersama akun, atau instans kelas TokenCredentials dari azure.identity. Jika URI sumber daya sudah berisi token SAS, ini akan diabaikan demi kredensial eksplisit

  • kecuali dalam kasus AzureSasCredential, di mana token SAS yang bertentangan akan menaikkan ValueError. Jika menggunakan instans AzureNamedKeyCredential, "nama" harus menjadi nama akun penyimpanan, dan "kunci" harus menjadi kunci akun penyimpanan.
overwrite
bool

Apakah blob yang akan diunggah harus menimpa data saat ini. Jika True, upload_blob_to_url akan menimpa data yang ada. Jika diatur ke False, operasi akan gagal dengan ResourceExistsError.

max_concurrency
int

Jumlah koneksi paralel yang akan diunduh.

length
int

Jumlah byte yang akan dibaca dari aliran. Ini bersifat opsional, tetapi harus disediakan untuk performa yang optimal.

metadata
dict(str,str)

Pasangan nama-nilai yang terkait dengan blob sebagai metadata.

validate_content
bool

Jika true, menghitung hash MD5 untuk setiap gugus blob. Layanan penyimpanan memeriksa hash konten yang telah tiba dengan hash yang dikirim. Ini terutama berharga untuk mendeteksi bitflips pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa hash MD5 ini tidak disimpan dengan blob. Perhatikan juga bahwa jika diaktifkan, algoritma pengunggahan yang hemat memori tidak akan digunakan, karena komputasi hash MD5 memerlukan buffering seluruh blok, dan melakukannya mengalahkan tujuan algoritma yang hemat memori.

encoding
str

Pengodean untuk digunakan jika teks disediakan sebagai input. Default ke UTF-8.

Mengembalikan

Dict properti yang diperbarui blob (Etag dan terakhir diubah)

Tipe hasil