BlobClient Kelas
Klien untuk berinteraksi dengan blob tertentu, meskipun blob tersebut mungkin belum ada.
Untuk konfigurasi opsional lainnya, silakan klik di sini.
- Warisan
-
azure.storage.blob._shared.base_client.StorageAccountHostsMixinBlobClientazure.storage.blob._encryption.StorageEncryptionMixinBlobClient
Konstruktor
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)Parameter
- account_url
- str
URI ke akun penyimpanan. Untuk membuat klien yang diberikan URI penuh ke blob, gunakan from_blob_url classmethod.
- blob_name
- str
Nama blob yang digunakan untuk berinteraksi. Jika ditentukan, nilai ini akan menggantikan nilai blob yang ditentukan dalam URL blob.
- snapshot
- str
Rekam jepret blob opsional untuk dioperasikan. Ini bisa menjadi string ID rekam jepret atau respons yang dikembalikan dari create_snapshot.
- credential
Kredensial yang digunakan untuk mengautentikasi. Ini opsional jika URL akun 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 memunculkan ValueError. Jika menggunakan instans AzureNamedKeyCredential, "nama" harus menjadi nama akun penyimpanan, dan "kunci" harus menjadi kunci akun penyimpanan.
- api_version
- str
Versi Storage API yang akan digunakan untuk permintaan. Nilai default adalah versi layanan terbaru yang kompatibel dengan SDK saat ini. Pengaturan ke versi yang lebih lama dapat mengakibatkan berkurangnya kompatibilitas fitur.
Baru dalam versi 12.2.0.
- secondary_hostname
- str
Nama host titik akhir sekunder.
- max_block_size
- int
Ukuran gugus maksimum untuk mengunggah blob blok dalam gugus.
Default ke 4*1024*1024, atau 4MB.
- max_single_put_size
- int
Jika ukuran blob kurang dari atau sama dengan max_single_put_size, maka blob hanya akan diunggah dengan satu permintaan http PUT. Jika ukuran blob lebih besar dari max_single_put_size, blob akan diunggah dalam gugus. Default ke 64*1024*1024, atau 64MB.
- min_large_block_upload_threshold
- int
Ukuran gugus minimum yang diperlukan untuk menggunakan algoritma hemat memori saat mengunggah blob blok. Default ke 4*1024*1024+1.
- use_byte_buffer
- bool
Gunakan buffer byte untuk unggahan blob blok. Default ke False.
- max_page_size
- int
Ukuran gugus maksimum untuk mengunggah blob halaman. Default ke 4*1024*1024, atau 4MB.
- max_single_get_size
- int
Ukuran maksimum untuk blob yang akan diunduh dalam satu panggilan, bagian yang terlampaui akan diunduh dalam gugus (bisa paralel). Default ke 32*1024*1024, atau 32MB.
- max_chunk_get_size
- int
Ukuran gugus maksimum yang digunakan untuk mengunduh blob. Default ke 4*1024*1024, atau 4MB.
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob yang akan dioperasikan.
Metode
| abort_copy |
Membatalkan operasi penyalinan yang sedang berlangsung. Ini akan meninggalkan blob tujuan dengan panjang nol dan metadata penuh. Ini akan menimbulkan kesalahan jika operasi salin telah berakhir. |
| acquire_lease |
Meminta sewa baru. Jika blob tidak memiliki sewa aktif, Blob Service membuat sewa pada blob dan mengembalikan sewa baru. |
| append_block |
Menerapkan blok data baru ke akhir blob penambahan yang ada. |
| append_block_from_url |
Membuat blok baru untuk diterapkan sebagai bagian dari blob, di mana konten dibaca dari url sumber. |
| clear_page |
Menghapus rentang halaman. |
| close |
Metode ini untuk menutup soket yang dibuka oleh klien. Ini tidak perlu digunakan saat menggunakan dengan manajer konteks. |
| commit_block_list |
Operasi Daftar Blok Penerapan menulis blob dengan menentukan daftar ID blok yang membentuk blob. |
| create_append_blob |
Membuat Blob Tambahkan baru. Operasi ini membuat blob tambahan panjang 0 baru. Konten blob yang ada ditimpa dengan blob tambahan yang baru diinisialisasi. Untuk menambahkan konten ke blob penambahan, panggil append_block metode atau append_block_from_url . |
| create_page_blob |
Membuat Blob Halaman baru dengan ukuran yang ditentukan. |
| create_snapshot |
Membuat rekam jepret blob. Salinan bayangan adalah versi baca-saja dari blob yang diambil pada suatu waktu. Ini dapat dibaca, disalin, atau dihapus, tetapi tidak dimodifikasi. Rekam jepret memberikan cara untuk mencadangkan blob seperti yang muncul pada suatu saat. Rekam jepret blob memiliki nama yang sama dengan blob dasar tempat rekam jepret diambil, dengan nilai DateTime ditambahkan untuk menunjukkan waktu pengambilan rekam jepret. |
| delete_blob |
Menandai blob yang ditentukan untuk penghapusan. Blob kemudian dihapus selama pengumpulan sampah. Perhatikan bahwa untuk menghapus blob, Anda harus menghapus semua rekam jepretnya. Anda dapat menghapus keduanya secara bersamaan dengan operasi delete_blob(). Jika kebijakan penyimpanan penghapusan diaktifkan untuk layanan, maka operasi ini akan menghapus blob dan mempertahankan blob selama jumlah hari tertentu. Setelah jumlah hari yang ditentukan, data blob dihapus dari layanan selama pengumpulan sampah. Blob yang dihapus sementara dapat diakses melalui list_blobs menentukan opsi include=['deleted'] . Blob yang dihapus sementara dapat dipulihkan menggunakan <xref:azure.storage.blob.undelete> operasi. |
| delete_immutability_policy |
Operasi Hapus Kebijakan Imutabilitas menghapus kebijakan kekekalan pada blob. Baru dalam versi 12.10.0: Operasi ini diperkenalkan dalam versi API '2020-10-02'. |
| download_blob |
Mengunduh blob ke StorageStreamDownloader. Metode readall() harus digunakan untuk membaca semua konten atau readinto() harus digunakan untuk mengunduh blob ke dalam aliran. Menggunakan chunks() mengembalikan iterator yang memungkinkan pengguna untuk melakukan iterasi atas konten dalam gugus. |
| exists |
Mengembalikan True jika blob ada dengan parameter yang ditentukan, dan mengembalikan False jika tidak. |
| from_blob_url |
Buat BlobClient dari url blob. Ini tidak mendukung url blob yang disesuaikan dengan '/' dalam nama blob. |
| from_connection_string |
Buat BlobClient dari String Koneksi. |
| get_account_information |
Mendapatkan informasi yang terkait dengan akun penyimpanan tempat blob berada. Informasi juga dapat diambil jika pengguna memiliki SAS ke kontainer atau blob. Kunci dalam kamus yang dikembalikan termasuk 'sku_name' dan 'account_kind'. |
| get_blob_properties |
Mengembalikan semua metadata yang ditentukan pengguna, properti HTTP standar, dan properti sistem untuk blob. Ini tidak mengembalikan konten blob. |
| get_blob_tags |
Operasi Dapatkan Tag memungkinkan pengguna untuk mendapatkan tag pada blob atau versi blob tertentu, atau rekam jepret. Baru dalam versi 12.4.0: Operasi ini diperkenalkan dalam versi API '2019-12-12'. |
| get_block_list |
Operasi Dapatkan Daftar Blokir mengambil daftar blok yang telah diunggah sebagai bagian dari blob blok. |
| get_page_range_diff_for_managed_disk |
Mengembalikan daftar rentang halaman yang valid untuk disk atau rekam jepret terkelola. Catatan Operasi ini hanya tersedia untuk akun disk terkelola. Baru dalam versi 12.2.0: Operasi ini diperkenalkan dalam versi API '2019-07-07'. |
| get_page_ranges |
TIDAK DIGUNAKAN LAGI: Mengembalikan daftar rentang halaman yang valid untuk Blob Halaman atau rekam jepret blob halaman. |
| list_page_ranges |
Mengembalikan daftar rentang halaman yang valid untuk Blob Halaman atau rekam jepret blob halaman. Jika previous_snapshot ditentukan, hasilnya akan menjadi perbedaan perubahan antara blob target dan rekam jepret sebelumnya. |
| query_blob |
Memungkinkan pengguna untuk memilih/memproyeksikan data rekam jepret blob/atau blob dengan menyediakan ekspresi kueri sederhana. Operasi ini mengembalikan BlobQueryReader, pengguna perlu menggunakan readall() atau readinto() untuk mendapatkan data kueri. |
| resize_blob |
Mengubah ukuran blob halaman ke ukuran yang ditentukan. Jika nilai yang ditentukan kurang dari ukuran blob saat ini, semua halaman di atas nilai yang ditentukan akan dihapus. |
| seal_append_blob |
Operasi Seal menutup Append Blob untuk membuatnya baca-saja. Baru dalam versi 12.4.0. |
| set_blob_metadata |
Mengatur metadata yang ditentukan pengguna untuk blob sebagai satu atau beberapa pasangan nama-nilai. |
| set_blob_tags |
Operasi Atur Tag memungkinkan pengguna untuk mengatur tag pada blob atau versi blob tertentu, tetapi bukan rekam jepret. Setiap panggilan ke operasi ini menggantikan semua tag yang ada yang terpasang pada blob. Untuk menghapus semua tag dari blob, panggil operasi ini tanpa tag yang ditetapkan. Baru dalam versi 12.4.0: Operasi ini diperkenalkan dalam versi API '2019-12-12'. |
| set_http_headers |
Mengatur properti sistem di blob. Jika satu properti diatur untuk content_settings, semua properti akan ditimpa. |
| set_immutability_policy |
Operasi Set Immutability Policy menetapkan kebijakan kekekalan pada blob. Baru dalam versi 12.10.0: Operasi ini diperkenalkan dalam versi API '2020-10-02'. |
| set_legal_hold |
Operasi Set Legal Hold menetapkan penahanan legal pada blob. Baru dalam versi 12.10.0: Operasi ini diperkenalkan dalam versi API '2020-10-02'. |
| set_premium_page_blob_tier |
Mengatur tingkat blob halaman pada blob. API ini hanya didukung untuk blob halaman pada akun premium. |
| set_sequence_number |
Mengatur nomor urutan blob. |
| set_standard_blob_tier |
Operasi ini mengatur tingkat pada blob blok. Tingkat blob blok menentukan jenis penyimpanan Hot/Cool/Archive. Operasi ini tidak memperbarui ETag blob. |
| stage_block |
Membuat blok baru yang akan diterapkan sebagai bagian dari blob. |
| stage_block_from_url |
Membuat blok baru untuk diterapkan sebagai bagian dari blob tempat konten dibaca dari URL. |
| start_copy_from_url |
Menyalin blob dari URL yang diberikan. Operasi ini mengembalikan kamus yang berisi copy_status dan copy_id, yang dapat digunakan untuk memeriksa status atau membatalkan operasi salin. copy_status akan 'berhasil' jika salinan selesai secara sinkron atau 'tertunda' jika salinan telah dimulai secara asinkron. Untuk salinan asinkron, status dapat diperiksa dengan melakukan polling get_blob_properties metode dan memeriksa status penyalinan. Atur requires_sync ke True untuk memaksa salinan menjadi sinkron. Blob service menyalin blob berdasarkan upaya terbaik. Blob sumber untuk operasi salin mungkin berupa blob blok, blob penambahan, atau blob halaman. Jika blob tujuan sudah ada, itu harus berasal dari jenis blob yang sama dengan blob sumber. Blob tujuan yang ada akan ditimpa. Blob tujuan tidak dapat dimodifikasi saat operasi salin sedang berlangsung. Saat menyalin dari blob halaman, Blob service membuat blob halaman tujuan dengan panjang blob sumber, awalnya berisi semua nol. Kemudian rentang halaman sumber dijumlahkan, dan rentang yang tidak kosong disalin. Untuk blob blok atau blob penambahan, blob service membuat blob berkomitmen dengan panjang nol sebelum kembali dari operasi ini. Saat menyalin dari blob blok, semua blok yang diterapkan dan ID bloknya disalin. Blok yang tidak dikomit tidak disalin. Di akhir operasi salin, blob tujuan akan memiliki jumlah blok yang diterapkan yang sama dengan sumbernya. Saat menyalin dari blob penambahan, semua blok yang diterapkan disalin. Di akhir operasi salin, blob tujuan akan memiliki jumlah blok yang diterapkan yang sama dengan sumbernya. |
| undelete_blob |
Memulihkan blob atau rekam jepret yang dihapus sementara. Operasi hanya akan berhasil jika digunakan dalam jumlah hari yang ditentukan yang ditetapkan dalam kebijakan penyimpanan penghapusan. Jika penerapan versi blob diaktifkan, blob dasar tidak dapat dipulihkan menggunakan metode ini. Sebagai gantinya gunakan start_copy_from_url dengan URL versi blob yang ingin Anda promosikan ke versi saat ini. |
| upload_blob |
Membuat blob baru dari sumber data dengan penggugusan otomatis. |
| upload_blob_from_url |
Membuat Blob Blok baru tempat konten blob dibaca dari URL tertentu. Konten blob yang ada ditimpa dengan blob baru. |
| upload_page |
Operasi Unggah Halaman menulis rentang halaman ke blob halaman. |
| upload_pages_from_url |
Operasi Unggah Halaman menulis rentang halaman ke blob halaman tempat konten dibaca dari URL. |
abort_copy
Membatalkan operasi penyalinan yang sedang berlangsung.
Ini akan meninggalkan blob tujuan dengan panjang nol dan metadata penuh. Ini akan menimbulkan kesalahan jika operasi salin telah berakhir.
abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> NoneParameter
- copy_id
- str atau BlobProperties
Operasi salin untuk membatalkan. Ini dapat berupa string ID, atau instans BlobProperties.
Tipe hasil
acquire_lease
Meminta sewa baru.
Jika blob tidak memiliki sewa aktif, Blob Service membuat sewa pada blob dan mengembalikan sewa baru.
acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClientParameter
- lease_duration
- int
Menentukan durasi sewa, dalam detik, atau negatif satu (-1) untuk sewa yang tidak pernah kedaluwarsa. Sewa yang tidak terbatas bisa antara 15 dan 60 detik. Durasi sewa tidak dapat diubah menggunakan pembaruan atau perubahan. Defaultnya adalah -1 (sewa tak terbatas).
- lease_id
- str
ID sewa yang diusulkan, dalam format string GUID. Blob Service mengembalikan 400 (Permintaan tidak valid) jika ID sewa yang diusulkan tidak dalam format yang benar.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Objek BlobLeaseClient.
Tipe hasil
append_block
Menerapkan blok data baru ke akhir blob penambahan yang ada.
append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]Parameter
Konten blok. Ini bisa berupa byte, teks, objek yang dapat diulang atau seperti file.
- validate_content
- bool
Jika true, menghitung hash MD5 dari konten blok. 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.
- maxsize_condition
- int
Header bersyar opsional. Panjang maksimum dalam byte yang diizinkan untuk blob penampan. Jika operasi Tambahkan Blok akan menyebabkan blob melebihi batas tersebut atau jika ukuran blob sudah lebih besar dari nilai yang ditentukan dalam header ini, permintaan akan gagal dengan kesalahan MaxBlobSizeConditionNotMet (kode status HTTP 412 - Prasyarat Gagal).
- appendpos_condition
- int
Header kondisi opsional, hanya digunakan untuk operasi Tambahkan Blok. Angka yang menunjukkan offset byte untuk dibandingkan. Tambahkan Blok hanya akan berhasil jika posisi penambahan sama dengan angka ini. Jika tidak, permintaan akan gagal dengan kesalahan AppendPositionConditionNotMet (kode status HTTP 412 - Prasyarat Gagal).
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- encoding
- str
Default ke UTF-8.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan dimunculkan.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag, terakhir dimodifikasi, tambahkan offset, jumlah blok yang diterapkan).
Tipe hasil
append_block_from_url
Membuat blok baru untuk diterapkan sebagai bagian dari blob, di mana konten dibaca dari url sumber.
append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]Parameter
- copy_source_url
- str
URL data sumber. Ini dapat menunjuk ke Azure Blob atau File apa pun, yang bersifat publik atau memiliki tanda tangan akses bersama yang terlampir.
- source_offset
- int
Ini menunjukkan dimulainya rentang byte (inklusif) yang harus diambil dari sumber salinan.
- source_length
- int
Ini menunjukkan akhir rentang byte yang harus diambil dari sumber salinan.
- source_content_md5
- bytearray
Jika diberikan, layanan akan menghitung hash MD5 dari konten blok dan membandingkan dengan nilai ini.
- maxsize_condition
- int
Header bersyar opsional. Panjang maksimum dalam byte yang diizinkan untuk blob penampan. Jika operasi Tambahkan Blok akan menyebabkan blob melebihi batas tersebut atau jika ukuran blob sudah lebih besar dari nilai yang ditentukan dalam header ini, permintaan akan gagal dengan kesalahan MaxBlobSizeConditionNotMet (kode status HTTP 412 - Prasyarat Gagal).
- appendpos_condition
- int
Header kondisi opsional, hanya digunakan untuk operasi Tambahkan Blok. Angka yang menunjukkan offset byte untuk dibandingkan. Tambahkan Blok hanya akan berhasil jika posisi penambahan sama dengan angka ini. Jika tidak, permintaan akan gagal dengan kesalahan AppendPositionConditionNotMet (kode status HTTP 412 - Prasyarat Gagal).
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag tujuan, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan tujuan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- source_if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya sumber telah dimodifikasi sejak waktu yang ditentukan.
- source_if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya sumber belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- source_etag
- str
Nilai ETag sumber, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- source_match_condition
- MatchConditions
Kondisi kecocokan sumber untuk digunakan pada etag.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan dimunculkan.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
- source_authorization
- str
Autentikasi sebagai perwakilan layanan menggunakan rahasia klien untuk mengakses blob sumber. Pastikan "pembawa" adalah awalan dari string source_authorization.
clear_page
Menghapus rentang halaman.
clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]Parameter
- offset
- int
Mulai rentang byte yang digunakan untuk menulis ke bagian blob. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- length
- int
Jumlah byte yang digunakan untuk menulis ke bagian blob. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_sequence_number_lte
- int
Jika nomor urut blob kurang dari atau sama dengan nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_sequence_number_lt
- int
Jika nomor urut blob kurang dari nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_sequence_number_eq
- int
Jika nomor urut blob sama dengan nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir dimodifikasi).
Tipe hasil
close
Metode ini untuk menutup soket yang dibuka oleh klien. Ini tidak perlu digunakan saat menggunakan dengan manajer konteks.
close()commit_block_list
Operasi Daftar Blok Penerapan menulis blob dengan menentukan daftar ID blok yang membentuk blob.
commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]Parameter
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob. Digunakan untuk mengatur tipe konten, pengodean, bahasa, disposisi, md5, dan kontrol cache.
Pasangan nama-nilai yang terkait dengan blob sebagai tag. Tag peka huruf besar/kecil.
Kumpulan tag mungkin berisi paling banyak 10 tag. Kunci tag harus antara 1 dan 128 karakter, dan nilai tag harus antara 0 dan 256 karakter.
Karakter kunci dan nilai tag yang valid meliputi: huruf kecil dan huruf besar, digit (0-9), spasi ( >><<), plus (+), minus (-), titik (.), solidus (/), titik dua (:), sama dengan (=), garis bawah (_)
Baru dalam versi 12.4.0.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- immutability_policy
- ImmutabilityPolicy
Menentukan kebijakan kekekalan blob, rekam jepret blob, atau versi blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- legal_hold
- bool
Ditentukan jika penahanan legal harus diatur pada blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- validate_content
- bool
Jika true, menghitung hash MD5 dari konten halaman. 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.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob tujuan dengan nilai yang cocok.
Baru dalam versi 12.4.0.
- standard_blob_tier
- StandardBlobTier
Nilai tingkat blob standar untuk mengatur blob ke. Untuk versi pustaka ini, ini hanya berlaku untuk memblokir blob pada akun penyimpanan standar.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan dimunculkan.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir dimodifikasi).
Tipe hasil
create_append_blob
Membuat Blob Tambahkan baru. Operasi ini membuat blob tambahan panjang 0 baru. Konten blob yang ada ditimpa dengan blob tambahan yang baru diinisialisasi. Untuk menambahkan konten ke blob penambahan, panggil append_block metode atau append_block_from_url .
create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]Parameter
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob. Digunakan untuk mengatur tipe konten, pengodean, bahasa, disposisi, md5, dan kontrol cache.
Pasangan nama-nilai yang terkait dengan blob sebagai tag. Tag peka huruf besar/kecil.
Kumpulan tag mungkin berisi paling banyak 10 tag. Kunci tag harus antara 1 dan 128 karakter, dan nilai tag harus antara 0 dan 256 karakter.
Karakter kunci dan nilai tag yang valid meliputi: huruf kecil dan huruf besar, digit (0-9), spasi ( >><<), plus (+), minus (-), titik (.), solidus (/), titik dua (:), sama dengan (=), garis bawah (_)
Baru dalam versi 12.4.0.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- immutability_policy
- ImmutabilityPolicy
Menentukan kebijakan kekekalan blob, rekam jepret blob, atau versi blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- legal_hold
- bool
Ditentukan jika penahanan legal harus diatur pada blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan muncul.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir dimodifikasi).
Tipe hasil
create_page_blob
Membuat Blob Halaman baru dengan ukuran yang ditentukan.
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]Parameter
- size
- int
Ini menentukan ukuran maksimum untuk blob halaman, hingga 1 TB. Ukuran blob halaman harus diratakan ke batas 512 byte.
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob. Digunakan untuk mengatur tipe konten, pengodean, bahasa, disposisi, md5, dan kontrol cache.
- premium_page_blob_tier
- PremiumPageBlobTier
Nilai tingkat blob halaman untuk mengatur blob ke. Tingkat berkorelasi dengan ukuran blob dan jumlah IOPS yang diizinkan. Ini hanya berlaku untuk blob halaman pada akun penyimpanan premium.
Pasangan nama-nilai yang terkait dengan blob sebagai tag. Tag peka huruf besar/kecil.
Kumpulan tag mungkin berisi paling banyak 10 tag. Kunci tag harus antara 1 dan 128 karakter, dan nilai tag harus antara 0 dan 256 karakter.
Kunci tag dan karakter nilai yang valid meliputi: huruf kecil dan huruf besar, digit (0-9), spasi ( >><<), plus (+), minus (-), titik (.), solidus (/), titik dua (:), sama dengan (=), garis bawah (_)
Baru dalam versi 12.4.0.
- sequence_number
- int
Hanya untuk blob Halaman. Nomor urut adalah nilai yang dikontrol pengguna yang dapat Anda gunakan untuk melacak permintaan. Nilai nomor urut harus antara 0 dan 2^63 - 1.Nilai defaultnya adalah 0.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- immutability_policy
- ImmutabilityPolicy
Menentukan kebijakan kekekalan blob, rekam jepret blob, atau versi blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- legal_hold
- bool
Ditentukan jika penahanan legal harus diatur pada blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan muncul.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir dimodifikasi).
Tipe hasil
create_snapshot
Membuat rekam jepret blob.
Salinan bayangan adalah versi baca-saja dari blob yang diambil pada suatu waktu. Ini dapat dibaca, disalin, atau dihapus, tetapi tidak dimodifikasi. Rekam jepret memberikan cara untuk mencadangkan blob seperti yang muncul pada suatu saat.
Rekam jepret blob memiliki nama yang sama dengan blob dasar tempat rekam jepret diambil, dengan nilai DateTime ditambahkan untuk menunjukkan waktu pengambilan rekam jepret.
create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]Parameter
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob tujuan dengan nilai yang cocok.
Baru dalam versi 12.4.0.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan muncul.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (ID Rekam Jepret, Etag, dan terakhir dimodifikasi).
Tipe hasil
delete_blob
Menandai blob yang ditentukan untuk penghapusan.
Blob kemudian dihapus selama pengumpulan sampah. Perhatikan bahwa untuk menghapus blob, Anda harus menghapus semua rekam jepretnya. Anda dapat menghapus keduanya secara bersamaan dengan operasi delete_blob().
Jika kebijakan penyimpanan penghapusan diaktifkan untuk layanan, maka operasi ini akan menghapus blob dan mempertahankan blob selama jumlah hari tertentu. Setelah jumlah hari yang ditentukan, data blob dihapus dari layanan selama pengumpulan sampah. Blob yang dihapus sementara dapat diakses melalui list_blobs menentukan opsi include=['deleted'] . Blob yang dihapus sementara dapat dipulihkan menggunakan <xref:azure.storage.blob.undelete> operasi.
delete_blob(delete_snapshots: str = None, **kwargs: Any) -> NoneParameter
- delete_snapshots
- str
Diperlukan jika blob memiliki rekam jepret terkait. Nilai meliputi:
"only": Hanya menghapus rekam jepret blob.
"include": Menghapus blob bersama dengan semua rekam jepret.
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob yang akan dihapus.
Baru dalam versi 12.4.0.
Argumen kata kunci ini diperkenalkan dalam versi API '2019-12-12'.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Jika ditentukan, delete_blob hanya berhasil jika sewa blob aktif dan cocok dengan ID ini. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Tipe hasil
delete_immutability_policy
Operasi Hapus Kebijakan Imutabilitas menghapus kebijakan kekekalan pada blob.
Baru dalam versi 12.10.0: Operasi ini diperkenalkan dalam versi API '2020-10-02'.
delete_immutability_policy(**kwargs: Any) -> NoneParameter
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Pasangan nilai kunci tag blob.
Tipe hasil
download_blob
Mengunduh blob ke StorageStreamDownloader. Metode readall() harus digunakan untuk membaca semua konten atau readinto() harus digunakan untuk mengunduh blob ke dalam aliran. Menggunakan chunks() mengembalikan iterator yang memungkinkan pengguna untuk melakukan iterasi atas konten dalam gugus.
download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]Parameter
- 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.
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob yang akan diunduh.
Baru dalam versi 12.4.0.
Argumen kata kunci ini diperkenalkan dalam versi API '2019-12-12'.
- 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 hemat memori.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Jika ditentukan, download_blob hanya berhasil jika sewa blob aktif dan cocok dengan ID ini. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- max_concurrency
- int
Jumlah koneksi paralel yang akan diunduh.
- encoding
- str
Pengodean untuk mendekode byte yang diunduh. Defaultnya adalah Tidak Ada, yaitu tidak ada decoding.
Panggilan balik untuk melacak kemajuan unduhan yang berjalan lama. Tanda tangan adalah fungsi (saat ini: int, total: int) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran total unduhan.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini. Metode ini dapat melakukan beberapa panggilan ke layanan dan batas waktu akan berlaku untuk setiap panggilan satu per satu. beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
Mengembalikan
Objek streaming (StorageStreamDownloader)
Tipe hasil
exists
Mengembalikan True jika blob ada dengan parameter yang ditentukan, dan mengembalikan False jika tidak.
exists(**kwargs: Any) -> boolParameter
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob untuk memeriksa apakah ada.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
boolean
Tipe hasil
from_blob_url
Buat BlobClient dari url blob. Ini tidak mendukung url blob yang disesuaikan dengan '/' dalam nama blob.
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) -> SelfParameter
- blob_url
- str
URL titik akhir lengkap ke Blob, termasuk token SAS dan rekam jepret jika digunakan. Ini bisa berupa titik akhir utama, atau titik akhir sekunder tergantung pada location_mode saat ini.
- credential
- Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
Kredensial yang digunakan untuk mengautentikasi. Ini bersifat opsional jika URL akun sudah memiliki token SAS, atau string koneksi sudah memiliki nilai kunci akses bersama. 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.
- snapshot
- str
Rekam jepret blob opsional untuk dioperasikan. Ini bisa menjadi string ID rekam jepret atau respons yang dikembalikan dari create_snapshot. Jika ditentukan, ini akan mengambil alih rekam jepret di url.
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob yang akan dioperasikan.
Mengembalikan
Klien Blob.
Tipe hasil
from_connection_string
Buat BlobClient dari String Koneksi.
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) -> SelfParameter
- snapshot
- str
Rekam jepret blob opsional untuk dioperasikan. Ini bisa menjadi string ID rekam jepret atau respons yang dikembalikan dari create_snapshot.
- credential
- Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
Kredensial yang digunakan untuk mengautentikasi. Ini bersifat opsional jika URL akun sudah memiliki token SAS, atau string koneksi sudah memiliki nilai kunci akses bersama. 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. Kredensial yang disediakan di sini akan lebih diutamakan daripada yang ada di string koneksi. Jika menggunakan instans AzureNamedKeyCredential, "nama" harus menjadi nama akun penyimpanan, dan "kunci" harus menjadi kunci akun penyimpanan.
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob yang akan dioperasikan.
Mengembalikan
Klien Blob.
Tipe hasil
get_account_information
Mendapatkan informasi yang terkait dengan akun penyimpanan tempat blob berada.
Informasi juga dapat diambil jika pengguna memiliki SAS ke kontainer atau blob. Kunci dalam kamus yang dikembalikan termasuk 'sku_name' dan 'account_kind'.
get_account_information(**kwargs: Any) -> Dict[str, str]Mengembalikan
Dikta informasi akun (SKU dan jenis akun).
Tipe hasil
get_blob_properties
Mengembalikan semua metadata yang ditentukan pengguna, properti HTTP standar, dan properti sistem untuk blob. Ini tidak mengembalikan konten blob.
get_blob_properties(**kwargs: Any) -> BlobPropertiesParameter
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob untuk mendapatkan properti.
Baru dalam versi 12.4.0.
Argumen kata kunci ini diperkenalkan dalam versi API '2019-12-12'.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
BlobProperties
Tipe hasil
get_blob_tags
Operasi Dapatkan Tag memungkinkan pengguna untuk mendapatkan tag pada blob atau versi blob tertentu, atau rekam jepret.
Baru dalam versi 12.4.0: Operasi ini diperkenalkan dalam versi API '2019-12-12'.
get_blob_tags(**kwargs: Any) -> Dict[str, str]Parameter
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob untuk menambahkan tag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob tujuan dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Pasangan nilai kunci tag blob.
Tipe hasil
get_block_list
Operasi Dapatkan Daftar Blokir mengambil daftar blok yang telah diunggah sebagai bagian dari blob blok.
get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]Parameter
- block_list_type
- str
Menentukan apakah akan mengembalikan daftar blok yang diterapkan, daftar blok yang tidak dikomit, atau kedua daftar bersama-sama. Nilai yang mungkin termasuk: 'committed', 'uncommitted', 'all'
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob tujuan dengan nilai yang cocok.
Baru dalam versi 12.4.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Tuple dari dua daftar - blok yang diterapkan dan tidak dikomit
Tipe hasil
get_page_range_diff_for_managed_disk
Mengembalikan daftar rentang halaman yang valid untuk disk atau rekam jepret terkelola.
Catatan
Operasi ini hanya tersedia untuk akun disk terkelola.
Baru dalam versi 12.2.0: Operasi ini diperkenalkan dalam versi 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]]]Parameter
- previous_snapshot_url
Menentukan URL rekam jepret sebelumnya dari disk terkelola. Respons hanya akan berisi halaman yang diubah antara blob target dan rekam jepret sebelumnya.
- offset
- int
Mulai rentang byte yang digunakan untuk mendapatkan rentang halaman yang valid. Jika tidak ada panjang yang diberikan, semua byte setelah offset akan dicari. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- length
- int
Jumlah byte yang digunakan untuk mendapatkan rentang halaman yang valid. Jika panjang diberikan, offset harus disediakan. Rentang ini akan mengembalikan rentang halaman yang valid dari awal offset hingga panjang yang ditentukan. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Tupel dua daftar rentang halaman sebagai kamus dengan kunci 'mulai' dan 'akhir'. Elemen pertama adalah rentang halaman yang diisi, elemen ke-2 dibersihkan rentang halaman.
Tipe hasil
get_page_ranges
TIDAK DIGUNAKAN LAGI: Mengembalikan daftar rentang halaman yang valid untuk Blob Halaman atau rekam jepret blob halaman.
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]]]Parameter
- offset
- int
Mulai rentang byte yang digunakan untuk mendapatkan rentang halaman yang valid. Jika tidak ada panjang yang diberikan, semua byte setelah offset akan dicari. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- length
- int
Jumlah byte yang digunakan untuk mendapatkan rentang halaman yang valid. Jika panjang diberikan, offset harus disediakan. Rentang ini akan mengembalikan rentang halaman yang valid dari awal offset hingga panjang yang ditentukan. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- previous_snapshot_diff
- str
Parameter diff rekam jepret yang berisi nilai DateTime buram yang menentukan rekam jepret blob sebelumnya untuk dibandingkan dengan rekam jepret yang lebih baru atau blob saat ini.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Tupel dua daftar rentang halaman sebagai kamus dengan kunci 'mulai' dan 'akhir'. Elemen pertama adalah rentang halaman yang diisi, elemen ke-2 dibersihkan rentang halaman.
Tipe hasil
list_page_ranges
Mengembalikan daftar rentang halaman yang valid untuk Blob Halaman atau rekam jepret blob halaman. Jika previous_snapshot ditentukan, hasilnya akan menjadi perbedaan perubahan antara blob target dan rekam jepret sebelumnya.
list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]Parameter
- offset
- int
Mulai rentang byte yang digunakan untuk mendapatkan rentang halaman yang valid. Jika tidak ada panjang yang diberikan, semua byte setelah offset akan dicari. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- length
- int
Jumlah byte yang digunakan untuk mendapatkan rentang halaman yang valid. Jika panjang diberikan, offset harus disediakan. Rentang ini akan mengembalikan rentang halaman yang valid dari awal offset hingga panjang yang ditentukan. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
Nilai rekam jepret yang menentukan bahwa respons hanya akan berisi halaman yang diubah antara blob target dan rekam jepret sebelumnya. Halaman yang diubah mencakup halaman yang diperbarui dan dihapus. Blob target mungkin rekam jepret, selama rekam jepret yang ditentukan oleh previous_snapshot adalah yang lebih lama dari keduanya.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- results_per_page
- int
Jumlah maksimum rentang halaman untuk diambil per panggilan API.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
PageRange yang dapat diulang (halaman otomatis).
Tipe hasil
query_blob
Memungkinkan pengguna untuk memilih/memproyeksikan data rekam jepret blob/atau blob dengan menyediakan ekspresi kueri sederhana. Operasi ini mengembalikan BlobQueryReader, pengguna perlu menggunakan readall() atau readinto() untuk mendapatkan data kueri.
query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReaderParameter
- query_expression
- str
Wajib diisi. pernyataan kueri. Untuk detail selengkapnya, lihat https://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.
- on_error
- Callable[BlobQueryError]
Fungsi yang akan dipanggil pada kesalahan pemrosesan apa pun yang dikembalikan oleh layanan.
- blob_format
- DelimitedTextDialect atau DelimitedJsonDialect atau QuickQueryDialect atau str
Pilihan. Menentukan serialisasi data yang saat ini disimpan dalam blob. Defaultnya adalah memperlakukan data blob sebagai data CSV yang diformat dalam dialek default. Ini dapat diganti dengan DelimitedTextDialect kustom, atau DelimitedJsonDialect atau "ParquetDialect" (diteruskan sebagai string atau enum). Dialek ini dapat diteruskan melalui kelas masing-masing, enum QuickQueryDialect atau sebagai string
- output_format
- DelimitedTextDialect atau DelimitedJsonDialect atau list[ArrowDialect] atau QuickQueryDialect atau str
Pilihan. Menentukan serialisasi output untuk aliran data. Secara default data akan dikembalikan karena diwakili dalam blob (format Parquet default ke DelimitedTextDialect). Dengan menyediakan format output, data blob akan diformat ulang sesuai dengan profil tersebut. Nilai ini bisa berupa DelimitedTextDialect atau DelimitedJsonDialect atau ArrowDialect. Dialek ini dapat diteruskan melalui kelas masing-masing, enum QuickQueryDialect atau sebagai string
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Objek streaming (BlobQueryReader)
Tipe hasil
resize_blob
Mengubah ukuran blob halaman ke ukuran yang ditentukan.
Jika nilai yang ditentukan kurang dari ukuran blob saat ini, semua halaman di atas nilai yang ditentukan akan dihapus.
resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]Parameter
- size
- int
Ukuran yang digunakan untuk mengubah ukuran blob. Ukuran maksimum untuk blob halaman hingga 1 TB. Ukuran blob halaman harus diratakan ke batas 512 byte.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- premium_page_blob_tier
- PremiumPageBlobTier
Nilai tingkat blob halaman untuk mengatur blob ke. Tingkat berkorelasi dengan ukuran blob dan jumlah IOPS yang diizinkan. Ini hanya berlaku untuk blob halaman pada akun penyimpanan premium.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir dimodifikasi).
Tipe hasil
seal_append_blob
Operasi Seal menutup Append Blob untuk membuatnya baca-saja.
Baru dalam versi 12.4.0.
seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]Parameter
- appendpos_condition
- int
Header kondisi opsional, hanya digunakan untuk operasi Tambahkan Blok. Angka yang menunjukkan offset byte untuk dibandingkan. Tambahkan Blok hanya akan berhasil jika posisi penambahan sama dengan angka ini. Jika tidak, permintaan akan gagal dengan kesalahan AppendPositionConditionNotMet (kode status HTTP 412 - Prasyarat Gagal).
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag, terakhir dimodifikasi, tambahkan offset, jumlah blok yang diterapkan).
Tipe hasil
set_blob_metadata
Mengatur metadata yang ditentukan pengguna untuk blob sebagai satu atau beberapa pasangan nama-nilai.
set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]Parameter
Dict yang berisi pasangan nama dan nilai. Setiap panggilan ke operasi ini menggantikan semua metadata yang ada yang terpasang pada blob. Untuk menghapus semua metadata dari blob, panggil operasi ini tanpa header metadata.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan muncul.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir diubah)
set_blob_tags
Operasi Atur Tag memungkinkan pengguna untuk mengatur tag pada blob atau versi blob tertentu, tetapi bukan rekam jepret. Setiap panggilan ke operasi ini menggantikan semua tag yang ada yang terpasang pada blob. Untuk menghapus semua tag dari blob, panggil operasi ini tanpa tag yang ditetapkan.
Baru dalam versi 12.4.0: Operasi ini diperkenalkan dalam versi API '2019-12-12'.
set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]Parameter
Pasangan nama-nilai yang terkait dengan blob sebagai tag. Tag peka huruf besar/kecil.
Kumpulan tag mungkin berisi paling banyak 10 tag. Kunci tag harus antara 1 dan 128 karakter, dan nilai tag harus antara 0 dan 256 karakter.
Kunci tag dan karakter nilai yang valid meliputi: huruf kecil dan huruf besar, digit (0-9), spasi ( >><<), plus (+), minus (-), titik (.), solidus (/), titik dua (:), sama dengan (=), garis bawah (_)
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob untuk menambahkan tag.
- validate_content
- bool
Jika true, menghitung hash MD5 dari konten tag. 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.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob tujuan dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir diubah)
Tipe hasil
set_http_headers
Mengatur properti sistem di blob.
Jika satu properti diatur untuk content_settings, semua properti akan ditimpa.
set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> NoneParameter
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob. Digunakan untuk mengatur tipe konten, pengodean, bahasa, disposisi, md5, dan kontrol cache.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir diubah)
Tipe hasil
set_immutability_policy
Operasi Set Immutability Policy menetapkan kebijakan kekekalan pada blob.
Baru dalam versi 12.10.0: Operasi ini diperkenalkan dalam versi API '2020-10-02'.
set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]Parameter
- immutability_policy
- ImmutabilityPolicy
Menentukan kebijakan kekekalan blob, rekam jepret blob, atau versi blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Pasangan nilai kunci tag blob.
Tipe hasil
set_legal_hold
Operasi Set Legal Hold menetapkan penahanan legal pada blob.
Baru dalam versi 12.10.0: Operasi ini diperkenalkan dalam versi API '2020-10-02'.
set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]Parameter
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Pasangan nilai kunci tag blob.
Tipe hasil
set_premium_page_blob_tier
Mengatur tingkat blob halaman pada blob. API ini hanya didukung untuk blob halaman pada akun premium.
set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> NoneParameter
- premium_page_blob_tier
- PremiumPageBlobTier
Nilai tingkat blob halaman untuk mengatur blob ke. Tingkat berkorelasi dengan ukuran blob dan jumlah IOPS yang diizinkan. Ini hanya berlaku untuk blob halaman pada akun penyimpanan premium.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
Tipe hasil
set_sequence_number
Mengatur nomor urutan blob.
set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]Parameter
- sequence_number_action
- str
Properti ini menunjukkan bagaimana layanan harus memodifikasi nomor urutan blob. Lihat SequenceNumberAction untuk informasi lebih lanjut.
- sequence_number
- str
Properti ini menetapkan nomor urut blob. Nomor urut adalah properti yang dikontrol pengguna yang dapat Anda gunakan untuk melacak permintaan dan mengelola masalah konkurensi.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir dimodifikasi).
Tipe hasil
set_standard_blob_tier
Operasi ini mengatur tingkat pada blob blok.
Tingkat blob blok menentukan jenis penyimpanan Hot/Cool/Archive. Operasi ini tidak memperbarui ETag blob.
set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> NoneParameter
- standard_blob_tier
- str atau StandardBlobTier
Menunjukkan tingkat yang akan diatur pada blob. Opsinya termasuk 'Hot', 'Cool', 'Archive'. Tingkat panas dioptimalkan untuk menyimpan data yang sering diakses. Tingkat penyimpanan dingin dioptimalkan untuk menyimpan data yang jarang diakses dan disimpan setidaknya selama sebulan. Tingkat arsip dioptimalkan untuk menyimpan data yang jarang diakses dan disimpan setidaknya selama enam bulan dengan persyaratan latensi yang fleksibel.
- rehydrate_priority
- RehydratePriority
Menunjukkan prioritas untuk merehidrasi blob yang diarsipkan
- version_id
- str
Parameter id versi adalah nilai DateTime buram yang, saat ada, menentukan versi blob yang akan diunduh.
Baru dalam versi 12.4.0.
Argumen kata kunci ini diperkenalkan dalam versi API '2019-12-12'.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
Tipe hasil
stage_block
Membuat blok baru yang akan diterapkan sebagai bagian dari blob.
stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]Parameter
- block_id
- str
Nilai string yang mengidentifikasi blok. String harus berukuran kurang dari atau sama dengan 64 byte. Untuk blob tertentu, block_id harus berukuran sama untuk setiap blok.
- data
Data blob.
- 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.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- encoding
- str
Default ke UTF-8.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan muncul.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti blob.
Tipe hasil
stage_block_from_url
Membuat blok baru untuk diterapkan sebagai bagian dari blob tempat konten dibaca dari URL.
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]Parameter
- block_id
- str
Nilai string yang mengidentifikasi blok. String harus berukuran kurang dari atau sama dengan 64 byte. Untuk blob tertentu, block_id harus berukuran sama untuk setiap blok.
- source_offset
- int
Mulai rentang byte yang digunakan untuk blok. Harus diatur jika panjang sumber disediakan.
- source_content_md5
- bytearray
Tentukan md5 yang dihitung untuk rentang byte yang harus dibaca dari sumber salinan.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan dimunculkan.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
- source_authorization
- str
Autentikasi sebagai perwakilan layanan menggunakan rahasia klien untuk mengakses blob sumber. Pastikan "pembawa" adalah awalan dari string source_authorization.
Mengembalikan
Dict properti blob.
Tipe hasil
start_copy_from_url
Menyalin blob dari URL yang diberikan.
Operasi ini mengembalikan kamus yang berisi copy_status dan copy_id, yang dapat digunakan untuk memeriksa status atau membatalkan operasi salin. copy_status akan 'berhasil' jika salinan selesai secara sinkron atau 'tertunda' jika salinan telah dimulai secara asinkron. Untuk salinan asinkron, status dapat diperiksa dengan melakukan polling get_blob_properties metode dan memeriksa status penyalinan. Atur requires_sync ke True untuk memaksa salinan menjadi sinkron. Blob service menyalin blob berdasarkan upaya terbaik.
Blob sumber untuk operasi salin mungkin berupa blob blok, blob penambahan, atau blob halaman. Jika blob tujuan sudah ada, itu harus berasal dari jenis blob yang sama dengan blob sumber. Blob tujuan yang ada akan ditimpa. Blob tujuan tidak dapat dimodifikasi saat operasi salin sedang berlangsung.
Saat menyalin dari blob halaman, Blob service membuat blob halaman tujuan dengan panjang blob sumber, awalnya berisi semua nol. Kemudian rentang halaman sumber dijumlahkan, dan rentang yang tidak kosong disalin.
Untuk blob blok atau blob penambahan, blob service membuat blob berkomitmen dengan panjang nol sebelum kembali dari operasi ini. Saat menyalin dari blob blok, semua blok yang diterapkan dan ID bloknya disalin. Blok yang tidak dikomit tidak disalin. Di akhir operasi salin, blob tujuan akan memiliki jumlah blok yang diterapkan yang sama dengan sumbernya.
Saat menyalin dari blob penambahan, semua blok yang diterapkan disalin. Di akhir operasi salin, blob tujuan akan memiliki jumlah blok yang diterapkan yang sama dengan sumbernya.
start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]Parameter
- source_url
- str
URL dengan panjang hingga 2 KB yang menentukan file atau blob. Nilai harus dikodekan URL karena akan muncul dalam URI permintaan. Jika sumber berada di akun lain, sumber harus bersifat publik atau harus diautentikasi melalui tanda tangan akses bersama. Jika sumbernya bersifat publik, tidak diperlukan autentikasi. Contoh: https://myaccount.blob.core.windows.net/mycontainer/myblob
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=
https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
Pasangan nama-nilai yang terkait dengan blob sebagai metadata. Jika tidak ada pasangan nama-nilai yang ditentukan, operasi akan menyalin metadata dari blob sumber atau file ke blob tujuan. Jika satu atau beberapa pasangan nilai nama ditentukan, blob tujuan dibuat dengan metadata yang ditentukan, dan metadata tidak disalin dari blob sumber atau file.
- incremental_copy
- bool
Menyalin rekam jepret blob halaman sumber ke blob halaman tujuan. Rekam jepret disalin sedih sehingga hanya perubahan diferensial antara rekam jepret yang disalin sebelumnya yang ditransfer ke tujuan. Salinan bayangan yang disalin adalah salinan lengkap dari rekam jepret asli dan dapat dibaca atau disalin dari seperti biasa. Default ke False.
Pasangan nama-nilai yang terkait dengan blob sebagai tag. Tag peka huruf besar/kecil.
Kumpulan tag mungkin berisi paling banyak 10 tag. Kunci tag harus antara 1 dan 128 karakter, dan nilai tag harus antara 0 dan 256 karakter.
Karakter kunci dan nilai tag yang valid meliputi: huruf kecil dan huruf besar, digit (0-9), spasi ( >><<), plus (+), minus (-), titik (.), solidus (/), titik dua (:), sama dengan (=), garis bawah (_).
"COPY" harfiah (peka huruf besar/kecil) dapat diteruskan untuk menyalin tag dari blob sumber. Opsi ini hanya tersedia saat incremental_copy=False dan requires_sync=True.
Baru dalam versi 12.4.0.
- immutability_policy
- ImmutabilityPolicy
Menentukan kebijakan kekekalan blob, rekam jepret blob, atau versi blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- legal_hold
- bool
Ditentukan jika penahanan legal harus diatur pada blob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- source_if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header kondisional ini untuk menyalin blob hanya jika blob sumber telah dimodifikasi sejak tanggal/waktu yang ditentukan.
- source_if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header kondisional ini untuk menyalin blob hanya jika blob sumber belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- source_etag
- str
Nilai ETag sumber, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- source_match_condition
- MatchConditions
Kondisi kecocokan sumber untuk digunakan pada etag.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header kondisional ini untuk menyalin blob hanya jika blob tujuan telah dimodifikasi sejak tanggal/waktu yang ditentukan. Jika blob tujuan belum dimodifikasi, blob service mengembalikan kode status 412 (Prasyarat Gagal).
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header kondisional ini untuk menyalin blob hanya jika blob tujuan belum dimodifikasi sejak tanggal/waktu yang ditentukan. Jika blob tujuan telah dimodifikasi, blob service mengembalikan kode status 412 (Prasyarat Gagal).
- etag
- str
Nilai ETag tujuan, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan tujuan untuk digunakan pada etag.
- destination_lease
- BlobLeaseClient atau str
ID sewa yang ditentukan untuk header ini harus cocok dengan ID sewa blob tujuan. Jika permintaan tidak menyertakan ID sewa atau tidak valid, operasi gagal dengan kode status 412 (Prasyarat Gagal).
- source_lease
- BlobLeaseClient atau str
Tentukan ini untuk melakukan operasi Salin Blob hanya jika ID sewa yang diberikan cocok dengan ID sewa aktif dari blob sumber.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
- premium_page_blob_tier
- PremiumPageBlobTier
Nilai tingkat blob halaman untuk mengatur blob ke. Tingkat berkorelasi dengan ukuran blob dan jumlah IOPS yang diizinkan. Ini hanya berlaku untuk blob halaman pada akun penyimpanan premium.
- standard_blob_tier
- StandardBlobTier
Nilai tingkat blob standar untuk mengatur blob ke. Untuk versi pustaka ini, ini hanya berlaku untuk memblokir blob pada akun penyimpanan standar.
- rehydrate_priority
- RehydratePriority
Menunjukkan prioritas untuk merehidrasi blob yang diarsipkan
- seal_destination_blob
- bool
Segel blob tambahan tujuan. Operasi ini hanya untuk blob tambahan.
Baru dalam versi 12.4.0.
- requires_sync
- bool
Memberlakukan bahwa layanan tidak akan mengembalikan respons hingga salinan selesai.
- source_authorization
- str
Autentikasi sebagai perwakilan layanan menggunakan rahasia klien untuk mengakses blob sumber. Pastikan "pembawa" adalah awalan dari string source_authorization. Opsi ini hanya tersedia ketika incremental_copy diatur ke False dan requires_sync diatur ke True.
Baru dalam versi 12.9.0.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada blob yang disalin sinkronisasi. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan dimunculkan.
Baru dalam versi 12.10.0.
Mengembalikan
Kamus properti salinan (etag, last_modified, copy_id, copy_status).
Tipe hasil
undelete_blob
Memulihkan blob atau rekam jepret yang dihapus sementara.
Operasi hanya akan berhasil jika digunakan dalam jumlah hari yang ditentukan yang ditetapkan dalam kebijakan penyimpanan penghapusan.
Jika penerapan versi blob diaktifkan, blob dasar tidak dapat dipulihkan menggunakan metode ini. Sebagai gantinya gunakan start_copy_from_url dengan URL versi blob yang ingin Anda promosikan ke versi saat ini.
undelete_blob(**kwargs: Any) -> NoneParameter
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Tipe hasil
upload_blob
Membuat blob baru dari sumber data dengan penggugusan otomatis.
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]Parameter
- data
Data blob yang akan diunggah.
- blob_type
- BlobType
Jenis blob. Ini bisa berupa BlockBlob, PageBlob, atau AppendBlob. Nilai defaultnya adalah BlockBlob.
- length
- int
Jumlah byte yang akan dibaca dari aliran. Ini bersifat opsional, tetapi harus disediakan untuk performa yang optimal.
Pasangan nama-nilai yang terkait dengan blob sebagai tag. Tag peka huruf besar/kecil.
Kumpulan tag mungkin berisi paling banyak 10 tag. Kunci tag harus antara 1 dan 128 karakter, dan nilai tag harus antara 0 dan 256 karakter.
Kunci tag dan karakter nilai yang valid meliputi: huruf kecil dan huruf besar, digit (0-9), spasi ( >><<), plus (+), minus (-), titik (.), solidus (/), titik dua (:), sama dengan (=), garis bawah (_)
Baru dalam versi 12.4.0.
- overwrite
- bool
Apakah blob yang akan diunggah harus menimpa data saat ini. Jika True, upload_blob akan menimpa data yang ada. Jika diatur ke False, operasi akan gagal dengan ResourceExistsError. Pengecualian untuk hal di atas adalah dengan Tambahkan jenis blob: jika diatur ke False dan data sudah ada, kesalahan tidak akan dimunculkan dan data akan ditambahkan ke blob yang ada. Jika diatur overwrite=True, maka blob tambahan yang ada akan dihapus, dan yang baru dibuat. Default ke False.
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob. Digunakan untuk mengatur tipe konten, pengodean, bahasa, disposisi, md5, dan kontrol cache.
- 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.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Jika ditentukan, upload_blob hanya berhasil jika sewa blob aktif dan cocok dengan ID ini. Nilai dapat berupa objek BlobLeaseClient atau ID sewa sebagai string.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausul pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
- premium_page_blob_tier
- PremiumPageBlobTier
Nilai tingkat blob halaman untuk mengatur blob ke. Tingkat berkorelasi dengan ukuran blob dan jumlah IOPS yang diizinkan. Ini hanya berlaku untuk blob halaman pada akun penyimpanan premium.
- standard_blob_tier
- StandardBlobTier
Nilai tingkat blob standar untuk mengatur blob. Untuk versi pustaka ini, ini hanya berlaku untuk memblokir blob pada akun penyimpanan standar.
- immutability_policy
- ImmutabilityPolicy
Menentukan kebijakan kekekalan blob, rekam jepret blob, atau versi blob. Saat ini parameter API upload_blob() ini hanya untuk BlockBlob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- legal_hold
- bool
Ditentukan jika penahanan legal harus diatur pada blob. Saat ini parameter API upload_blob() ini hanya untuk BlockBlob.
Baru dalam versi 12.10.0: Ini diperkenalkan dalam versi API '2020-10-02'.
- maxsize_condition
- int
Header bersyar opsional. Panjang maksimum dalam byte yang diizinkan untuk blob tambahan. Jika operasi Tambahkan Blok akan menyebabkan blob melebihi batas tersebut atau jika ukuran blob sudah lebih besar dari nilai yang ditentukan di header ini, permintaan akan gagal dengan kesalahan MaxBlobSizeConditionNotMet (kode status HTTP 412 - Prasyarat Gagal).
- max_concurrency
- int
Jumlah maksimum koneksi paralel yang digunakan ketika ukuran blob melebihi 64MB.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan muncul.
Baru dalam versi 12.2.0.
- encoding
- str
Default ke UTF-8.
Panggilan balik untuk melacak kemajuan unggahan yang berjalan lama. Tanda tangan adalah fungsi (saat ini: int, total: Opsional[int]) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob atau Tidak Ada jika ukurannya tidak diketahui.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini. Metode ini dapat melakukan beberapa panggilan ke layanan dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir dimodifikasi)
Tipe hasil
upload_blob_from_url
Membuat Blob Blok baru tempat konten blob dibaca dari URL tertentu. Konten blob yang ada ditimpa dengan blob baru.
upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]Parameter
- source_url
- str
URL dengan panjang hingga 2 KB yang menentukan file atau blob. Nilai harus dikodekan URL karena akan muncul dalam URI permintaan. Jika sumber berada di akun lain, sumber harus bersifat publik atau harus diautentikasi melalui tanda tangan akses bersama. Jika sumbernya bersifat publik, tidak diperlukan autentikasi. Contoh: https://myaccount.blob.core.windows.net/mycontainer/myblob
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=
https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
- overwrite
- bool
Apakah blob yang akan diunggah harus menimpa data saat ini. Jika True, upload_blob akan menimpa data yang ada. Jika diatur ke False, operasi akan gagal dengan ResourceExistsError.
- include_source_blob_properties
- bool
Menunjukkan apakah properti dari blob sumber harus disalin. Default ke True.
Pasangan nama-nilai yang terkait dengan blob sebagai tag. Tag peka huruf besar/kecil.
Kumpulan tag mungkin berisi paling banyak 10 tag. Kunci tag harus antara 1 dan 128 karakter, dan nilai tag harus antara 0 dan 256 karakter.
Karakter kunci dan nilai tag yang valid meliputi: huruf kecil dan huruf besar, digit (0-9), spasi ( >><<), plus (+), minus (-), titik (.), solidus (/), titik dua (:), sama dengan (=), garis bawah (_)
- source_content_md5
- bytearray
Tentukan md5 yang digunakan untuk memverifikasi integritas byte sumber.
- source_if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya sumber telah dimodifikasi sejak waktu yang ditentukan.
- source_if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya sumber belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- source_etag
- str
Nilai ETag sumber, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- source_match_condition
- MatchConditions
Kondisi kecocokan sumber untuk digunakan pada etag.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag tujuan, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan tujuan untuk digunakan pada etag.
- destination_lease
- BlobLeaseClient atau str
ID sewa yang ditentukan untuk header ini harus cocok dengan ID sewa blob tujuan. Jika permintaan tidak menyertakan ID sewa atau tidak valid, operasi gagal dengan kode status 412 (Prasyarat Gagal).
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob. Digunakan untuk mengatur tipe konten, pengodean, bahasa, disposisi, md5, dan kontrol cache.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan dimunculkan.
- standard_blob_tier
- StandardBlobTier
Nilai tingkat blob standar untuk mengatur blob ke. Untuk versi pustaka ini, ini hanya berlaku untuk memblokir blob pada akun penyimpanan standar.
- source_authorization
- str
Autentikasi sebagai perwakilan layanan menggunakan rahasia klien untuk mengakses blob sumber. Pastikan "pembawa" adalah awalan dari string source_authorization.
upload_page
Operasi Unggah Halaman menulis rentang halaman ke blob halaman.
upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]Parameter
- offset
- int
Mulai rentang byte yang digunakan untuk menulis ke bagian blob. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- length
- int
Jumlah byte yang digunakan untuk menulis ke bagian blob. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- validate_content
- bool
Jika true, menghitung hash MD5 dari konten halaman. 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.
- if_sequence_number_lte
- int
Jika nomor urut blob kurang dari atau sama dengan nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_sequence_number_lt
- int
Jika nomor urut blob kurang dari nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_sequence_number_eq
- int
Jika nomor urut blob sama dengan nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan dimunculkan.
Baru dalam versi 12.2.0.
- encoding
- str
Default ke UTF-8.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
Mengembalikan
Dict properti yang diperbarui blob (Etag dan terakhir dimodifikasi).
Tipe hasil
upload_pages_from_url
Operasi Unggah Halaman menulis rentang halaman ke blob halaman tempat konten dibaca dari URL.
upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]Parameter
- source_url
- str
URL data sumber. Ini dapat menunjuk ke Azure Blob atau File apa pun, yang bersifat publik atau memiliki tanda tangan akses bersama yang terlampir.
- offset
- int
Mulai rentang byte yang digunakan untuk menulis ke bagian blob. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- length
- int
Jumlah byte yang digunakan untuk menulis ke bagian blob. Halaman harus diselaraskan dengan batas 512 byte, offset awal harus berupa modulus 512 dan panjangnya harus modulus 512.
- source_offset
- int
Ini menunjukkan dimulainya rentang byte (inklusif) yang harus diambil dari sumber salinan. Layanan akan membaca jumlah byte yang sama dengan rentang tujuan (offset panjang).
- source_content_md5
- bytes
Jika diberikan, layanan akan menghitung hash MD5 dari konten blok dan membandingkan dengan nilai ini.
- source_if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya sumber telah dimodifikasi sejak waktu yang ditentukan.
- source_if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya sumber belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- source_etag
- str
Nilai ETag sumber, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- source_match_condition
- MatchConditions
Kondisi kecocokan sumber untuk digunakan pada etag.
- lease
- BlobLeaseClient atau str
Diperlukan jika blob memiliki sewa aktif. Nilai dapat menjadi objek BlobLeaseClient atau ID sewa sebagai string.
- if_sequence_number_lte
- int
Jika nomor urut blob kurang dari atau sama dengan nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_sequence_number_lt
- int
Jika nomor urut blob kurang dari nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_sequence_number_eq
- int
Jika nomor urut blob sama dengan nilai yang ditentukan, permintaan akan dilanjutkan; jika tidak, itu gagal.
- if_modified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak waktu yang ditentukan.
- if_unmodified_since
- datetime
Nilai TanggalWaktu. Azure mengharapkan nilai tanggal yang diteruskan menjadi UTC. Jika zona waktu disertakan, tanggalwaktu non-UTC apa pun akan dikonversi ke UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal/waktu yang ditentukan.
- etag
- str
Nilai ETag tujuan, atau karakter kartubebas (*). Digunakan untuk memeriksa apakah sumber daya telah berubah, dan bertindak sesuai dengan kondisi yang ditentukan oleh parameter match_condition .
- match_condition
- MatchConditions
Kondisi kecocokan tujuan untuk digunakan pada etag.
- if_tags_match_condition
- str
Tentukan SQL di mana klausa pada tag blob hanya beroperasi pada blob dengan nilai yang cocok.
misalnya. "\"tagname\"='my tag'"
Baru dalam versi 12.4.0.
Mengenkripsi data di sisi layanan dengan kunci yang diberikan. Penggunaan kunci yang disediakan pelanggan harus dilakukan melalui HTTPS. Karena kunci enkripsi itu sendiri disediakan dalam permintaan, koneksi aman harus dibuat untuk mentransfer kunci.
- encryption_scope
- str
Cakupan enkripsi yang telah ditentukan sebelumnya yang digunakan untuk mengenkripsi data pada layanan. Cakupan enkripsi dapat dibuat menggunakan API Manajemen dan direferensikan di sini berdasarkan nama. Jika cakupan enkripsi default telah ditentukan di kontainer, nilai ini akan menimpanya jika cakupan tingkat kontainer dikonfigurasi untuk memungkinkan penimpaan. Jika tidak, kesalahan akan dimunculkan.
Baru dalam versi 12.2.0.
- timeout
- int
Mengatur batas waktu sisi server untuk operasi dalam hitung detik. Untuk detail selengkapnya, lihat https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Nilai ini tidak dilacak atau divalidasi pada klien. Untuk mengonfigurasi batas waktu jaringan sisi klien, lihat di sini.
- source_authorization
- str
Autentikasi sebagai perwakilan layanan menggunakan rahasia klien untuk mengakses blob sumber. Pastikan "pembawa" adalah awalan dari string source_authorization.
Atribut
api_version
Versi Api Penyimpanan yang digunakan untuk permintaan.
location_mode
Mode lokasi yang saat ini digunakan klien.
Secara default ini akan menjadi "primer". Opsi termasuk "primer" dan "sekunder".
primary_endpoint
URL titik akhir utama lengkap.
primary_hostname
Nama host titik akhir utama.
secondary_endpoint
URL titik akhir sekunder penuh jika dikonfigurasi.
Jika tidak tersedia, ValueError akan dinaikkan. Untuk menentukan nama host sekunder secara eksplisit, gunakan argumen kata kunci secondary_hostname opsional pada instansiasi.
Pengecualian
secondary_hostname
Nama host titik akhir sekunder.
Jika tidak tersedia, ini tidak akan ada. Untuk menentukan nama host sekunder secara eksplisit, gunakan argumen kata kunci secondary_hostname opsional pada instansiasi.
url
URL titik akhir lengkap untuk entitas ini, termasuk token SAS jika digunakan.
Ini bisa berupa titik akhir utama, atau titik akhir sekunder tergantung pada saat ini location_mode. :returns: URL titik akhir lengkap ke entitas ini, termasuk token SAS jika digunakan. :rtype: str
Azure SDK for Python
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk