BlockBlobService Kelas
Blob blok memungkinkan Anda mengunggah blob besar secara efisien. Blob blok terdiri dari blok, yang masing-masing diidentifikasi oleh ID blok. Anda membuat atau memodifikasi blob blok dengan menulis satu set blok dan menerapkannya dengan ID bloknya. Setiap blok dapat berukuran berbeda, hingga maksimum 100 MB, dan blob blok dapat mencakup hingga 50.000 blok. Oleh karena itu, ukuran maksimum blob blok adalah sekitar 4,75 TB (100 MB X 50.000 blok). Jika Anda menulis blob blok yang ukurannya tidak lebih dari 64 MB, Anda dapat mengunggahnya secara keseluruhan dengan satu operasi tulis; lihat create_blob_from_bytes.
:type ~azure.storage.common.TokenCredential
- Warisan
-
BlockBlobService
Konstruktor
BlockBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)
Parameter
- account_name
- str
Nama akun penyimpanan. Ini digunakan untuk mengautentikasi permintaan yang ditandatangani dengan kunci akun dan untuk membangun titik akhir penyimpanan. Diperlukan kecuali string koneksi diberikan, atau jika domain kustom digunakan dengan autentikasi anonim.
- account_key
- str
Kunci akun penyimpanan. Ini digunakan untuk autentikasi kunci bersama. Jika tidak ada kunci akun atau token sas yang ditentukan, akses anonim akan digunakan.
- sas_token
- str
Token tanda tangan akses bersama yang digunakan untuk mengautentikasi permintaan alih-alih kunci akun. Jika kunci akun dan token sas ditentukan, kunci akun akan digunakan untuk menandatangani. Jika tidak ditentukan, akses anonim akan digunakan.
- is_emulated
- bool
Apakah akan menggunakan emulator. Default ke False. Jika ditentukan, akan mengambil alih semua parameter lain selain string koneksi dan sesi permintaan.
- endpoint_suffix
- str
Komponen dasar host url, dikurangi nama akun. Default ke Azure (core.windows.net). Ambil alih ini untuk menggunakan cloud Tiongkok (core.chinacloudapi.cn).
- custom_domain
- str
Domain kustom yang akan digunakan. Ini dapat diatur di Portal Microsoft Azure. Misalnya, 'www.mydomain.com'.
- request_session
- <xref:requests.Session>
objek sesi yang akan digunakan untuk permintaan http.
- connection_string
- str
Jika ditentukan, ini akan mengambil alih semua parameter lain selain sesi permintaan. Lihat http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ untuk format string koneksi.
- socket_timeout
- int
Jika ditentukan, ini akan menggantikan batas waktu soket default. Batas waktu yang ditentukan dalam detik. Lihat DEFAULT_SOCKET_TIMEOUT di _constants.py untuk nilai default.
- token_credential
Kredensial token yang digunakan untuk mengautentikasi permintaan HTTPS. Nilai token harus diperbarui sebelum kedaluwarsa.
Variabel
- MAX_SINGLE_PUT_SIZE
- int
Unggahan ukuran terbesar yang didukung dalam satu panggilan put. Ini digunakan oleh metode create_blob_from_* jika panjang konten diketahui dan kurang dari nilai ini.
- MAX_BLOCK_SIZE
- int
Ukuran blok diletakkan dengan metode create_blob_from_* jika panjang konten tidak diketahui atau lebih besar dari MAX_SINGLE_PUT_SIZE. Blok yang lebih kecil dapat diletakkan. Ukuran blok maksimum yang didukung layanan adalah 100MB.
- MIN_LARGE_BLOCK_UPLOAD_THRESHOLD
- int
Ukuran blok minimum di mana algoritma unggahan blok yang dioptimalkan memori dipertimbangkan. Algoritma ini hanya berlaku untuk metode create_blob_from_file dan create_blob_from_stream dan akan mencegah buffering blok penuh. Selain ukuran blok, validasi ContentMD5 dan Enkripsi harus dinonaktifkan karena opsi ini mengharuskan blok di-buffer.
Metode
abort_copy_blob |
Membatalkan operasi copy_blob yang tertunda, dan meninggalkan blob tujuan dengan panjang nol dan metadata penuh. |
acquire_blob_lease |
Meminta sewa baru. Jika blob tidak memiliki sewa aktif, Blob service membuat sewa pada blob dan mengembalikan ID sewa baru. |
acquire_container_lease |
Meminta sewa baru. Jika kontainer tidak memiliki sewa aktif, Blob service membuat sewa pada kontainer dan mengembalikan ID sewa baru. |
batch_delete_blobs |
Mengirim batch beberapa permintaan penghapusan blob. Metode penghapusan blob menghapus blob atau rekam jepret yang ditentukan. Perhatikan bahwa menghapus blob juga menghapus semua rekam jepretnya. Untuk informasi selengkapnya, lihat https://docs.microsoft.com/rest/api/storageservices/delete-blob |
batch_set_standard_blob_tier |
Mengirim batch beberapa permintaan tingkat blob blok yang ditetapkan. API ini hanya didukung untuk blob blok pada akun penyimpanan standar. |
break_blob_lease |
Memutuskan sewa, jika blob memiliki sewa aktif. Setelah sewa rusak, sewa tidak dapat diperpanjang. Setiap permintaan yang diotorisasi dapat memutus sewa; permintaan tidak diperlukan untuk menentukan ID sewa yang cocok. Ketika sewa rusak, periode istirahat sewa diizinkan untuk berlalu, selama waktu itu tidak ada operasi sewa kecuali istirahat dan pelepasan dapat dilakukan pada blob. Ketika sewa berhasil rusak, respons menunjukkan interval dalam hitungan detik sampai sewa baru dapat diperoleh. Sewa yang telah rusak juga dapat dirilis, dalam hal ini klien lain dapat segera memperoleh sewa pada blob. |
break_container_lease |
Putuskan sewa, jika kontainer memiliki sewa aktif. Setelah sewa rusak, sewa tidak dapat diperpanjang. Setiap permintaan yang diotorisasi dapat memutus sewa; permintaan tidak diperlukan untuk menentukan ID sewa yang cocok. Ketika sewa rusak, periode jeda sewa diizinkan untuk berlalu, selama waktu tersebut tidak ada operasi sewa kecuali pemutusan dan pelepasan dapat dilakukan pada kontainer. Ketika sewa berhasil rusak, respons menunjukkan interval dalam hitungan detik sampai sewa baru dapat diperoleh. |
change_blob_lease |
Mengubah ID sewa sewa aktif. Perubahan harus mencakup ID sewa saat ini dan ID sewa baru. |
change_container_lease |
Ubah ID sewa sewa aktif. Perubahan harus mencakup ID sewa saat ini dan ID sewa baru. |
copy_blob |
Menyalin blob. Operasi ini mengembalikan objek properti operasi salin. Operasi salin dapat dikonfigurasi untuk menjadi operasi asinkron, upaya terbaik, atau operasi sinkron. Sumber harus berupa blob blok jika requires_sync benar. Blob tujuan yang ada akan ditimpa. Blob tujuan tidak dapat dimodifikasi saat operasi salin sedang berlangsung. 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. Anda dapat memanggil get_blob_properties pada blob tujuan untuk memeriksa status operasi salin. Blob terakhir akan dilakukan ketika salinan selesai. Nama kontainer tujuan. Kontainer harus ada. :p blob_name str: Nama blob tujuan. Jika blob tujuan ada, blob tersebut akan ditimpa. Jika tidak, itu akan dibuat. :p aram str copy_source: URL dengan panjang hingga 2 KB yang menentukan file atau blob Azure. Nilai harus dikodekan URL seperti yang 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/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram metadata: 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. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: Nilai DateTime. 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. :p waktu tanggalwaktu source_if_unmodified_since: Nilai DateTime. 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. :p aram ETag source_if_match: Nilai ETag, atau karakter kartubebas (). Tentukan header kondisional ini untuk menyalin blob sumber hanya jika ETag-nya cocok dengan nilai yang ditentukan. Jika nilai ETag tidak cocok, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). Header ini tidak dapat ditentukan jika sumbernya adalah File Azure. :p aram ETag source_if_none_match: Nilai ETag, atau karakter kartubebas (). Tentukan header kondisional ini untuk menyalin blob hanya jika ETag-nya tidak cocok dengan nilai yang ditentukan. Jika nilainya identik, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). Header ini tidak dapat ditentukan jika sumbernya adalah File Azure. :p waktu tanggalwaktu destination_if_modified_since: Nilai DateTime. 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, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). :p waktu destination_if_unmodified_since: Nilai DateTime. 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, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). :p aram ETag destination_if_match: Nilai ETag, atau karakter kartubebas (). Tentukan nilai ETag untuk header kondisional ini untuk menyalin blob hanya jika nilai ETag yang ditentukan cocok dengan nilai ETag untuk blob tujuan yang ada. Jika ETag untuk blob tujuan tidak cocok dengan ETag yang ditentukan untuk If-Match, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). :p aram ETag destination_if_none_match: Nilai ETag, atau karakter kartubebas (). Tentukan nilai ETag untuk header kondisional ini untuk menyalin blob hanya jika nilai ETag yang ditentukan tidak cocok dengan nilai ETag untuk blob tujuan. Tentukan karakter kartubebas (*) untuk melakukan operasi hanya jika blob tujuan tidak ada. Jika kondisi yang ditentukan tidak terpenuhi, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). :p aram str destination_lease_id: 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). :p aram str source_lease_id: Tentukan ini untuk melakukan operasi Salin Blob hanya jika ID sewa yang diberikan cocok dengan ID sewa aktif dari blob sumber. :p waktu habis: Parameter batas waktu dinyatakan dalam hitungan detik. :p aram bool requires_sync: Memberlakukan bahwa layanan tidak akan mengembalikan respons sampai salinan selesai. :p aram StandardBlobTier standard_blob_tier: Nilai tingkat blob standar untuk mengatur blob ke. Untuk versi pustaka ini, ini hanya berlaku untuk memblokir blob pada akun penyimpanan standar. :p aram RehydratePriority rehydrate_priority: Menunjukkan prioritas untuk merehidrasi blob yang diarsipkan :return: Salin properti operasi seperti status, sumber, dan ID. :rtype: CopyProperties |
create_blob_from_bytes |
Membuat blob baru dari array byte, atau memperbarui konten blob yang ada, dengan pemberitahuan penggugusan dan kemajuan otomatis. |
create_blob_from_path |
Membuat blob baru dari jalur file, atau memperbarui konten blob yang ada, dengan pemberitahuan penggugusan dan kemajuan otomatis. |
create_blob_from_stream |
Membuat blob baru dari file/aliran, atau memperbarui konten blob yang ada, dengan pemberitahuan penggugusan dan kemajuan otomatis. |
create_blob_from_text |
Membuat blob baru dari str/unicode, atau memperbarui konten blob yang ada, dengan pemberitahuan penggugusan dan kemajuan otomatis. |
create_container |
Membuat kontainer baru di bawah akun yang ditentukan. Jika kontainer dengan nama yang sama sudah ada, operasi gagal jika fail_on_exist True. |
delete_blob |
Menandai blob atau rekam jepret yang ditentukan untuk dihapus. 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 Hapus Blob. Jika kebijakan penyimpanan penghapusan diaktifkan untuk layanan, maka operasi ini akan menghapus blob atau rekam jepret dan mempertahankan blob atau rekam jepret untuk jumlah hari yang ditentukan. Setelah jumlah hari yang ditentukan, data blob dihapus dari layanan selama pengumpulan sampah. Blob atau rekam jepret yang dihapus sementara dapat diakses melalui List Blobs API yang menentukan opsi include=Include.Deleted. Blob atau rekam jepret yang dihapus sementara dapat dipulihkan menggunakan API BatalKan Penghapusan. |
delete_container |
Menandai kontainer yang ditentukan untuk penghapusan. Kontainer dan blob apa pun yang terkandung di dalamnya kemudian dihapus selama pengumpulan sampah. |
exists |
Mengembalikan boolean yang menunjukkan apakah kontainer ada (jika blob_name Tidak Ada), atau boolean yang menunjukkan apakah blob ada. |
extract_date_and_request_id | |
generate_account_shared_access_signature |
Menghasilkan tanda tangan akses bersama untuk layanan blob. Gunakan tanda tangan yang dikembalikan dengan parameter sas_token blobService apa pun. |
generate_blob_shared_access_signature |
Menghasilkan tanda tangan akses bersama untuk blob atau salah satu rekam jepretnya. Gunakan tanda tangan yang dikembalikan dengan parameter sas_token blobService apa pun. |
generate_container_shared_access_signature |
Menghasilkan tanda tangan akses bersama untuk kontainer. Gunakan tanda tangan yang dikembalikan dengan parameter sas_token blobService apa pun. |
get_blob_account_information |
Mendapatkan informasi yang terkait dengan akun penyimpanan. Informasi juga dapat diambil jika pengguna memiliki SAS ke kontainer atau blob. |
get_blob_metadata |
Mengembalikan semua metadata yang ditentukan pengguna untuk blob atau rekam jepret yang ditentukan. |
get_blob_properties |
Mengembalikan semua metadata yang ditentukan pengguna, properti HTTP standar, dan properti sistem untuk blob. Ini tidak mengembalikan konten blob. Mengembalikan Blob dengan BlobProperties dan dict metadata. |
get_blob_service_properties |
Mendapatkan properti blob service akun penyimpanan, termasuk Azure Storage Analytics. |
get_blob_service_stats |
Mengambil statistik yang terkait dengan replikasi untuk Blob service. Ini hanya tersedia ketika replikasi geo-redundan akses baca diaktifkan untuk akun penyimpanan. Dengan replikasi geo-redundan, Azure Storage mempertahankan data Anda tetap tahan lama di dua lokasi. Di kedua lokasi, Azure Storage terus mempertahankan beberapa replika data Anda yang sehat. Lokasi tempat Anda membaca, membuat, memperbarui, atau menghapus data adalah lokasi akun penyimpanan utama. Lokasi utama ada di wilayah yang Anda pilih pada saat Anda membuat akun melalui portal klasik Azure Management Azure, misalnya, US Tengah Utara. Lokasi tempat data Anda direplikasi adalah lokasi sekunder. Lokasi sekunder secara otomatis ditentukan berdasarkan lokasi primer; berada di pusat data kedua yang berada di wilayah yang sama dengan lokasi utama. Akses baca-saja tersedia dari lokasi sekunder, jika replikasi geo-redundan akses baca diaktifkan untuk akun penyimpanan Anda. |
get_blob_to_bytes |
Mengunduh blob sebagai array byte, dengan potongan otomatis dan pemberitahuan kemajuan. Mengembalikan instans Blob dengan properti, metadata, dan konten. |
get_blob_to_path |
Mengunduh blob ke jalur file, dengan potongan otomatis dan pemberitahuan kemajuan. Mengembalikan instans Blob dengan properti dan metadata. |
get_blob_to_stream |
Mengunduh blob ke aliran, dengan potongan otomatis dan pemberitahuan kemajuan. Mengembalikan instans Blob dengan properti dan metadata. |
get_blob_to_text |
Mengunduh blob sebagai teks unicode, dengan pemberitahuan penggugusan dan kemajuan otomatis. Mengembalikan instans Blob dengan properti, metadata, dan konten. |
get_block_list |
Mengambil daftar blok yang telah diunggah sebagai bagian dari blob blok. Ada dua daftar blok yang dipertahankan untuk blob: Daftar Blok berkomitmen: Daftar blok yang telah berhasil diterapkan ke blob tertentu dengan Put Block List. Daftar Blokir yang Tidak Dikomit: Daftar blok yang telah diunggah untuk blob menggunakan Put Block, tetapi belum diterapkan. Blok-blok ini disimpan di Azure dalam kaitannya dengan blob, tetapi belum membentuk bagian dari blob. |
get_container_acl |
Mendapatkan izin untuk kontainer yang ditentukan. Izin menunjukkan apakah data kontainer dapat diakses secara publik. |
get_container_metadata |
Mengembalikan semua metadata yang ditentukan pengguna untuk kontainer yang ditentukan. |
get_container_properties |
Mengembalikan semua metadata dan properti sistem yang ditentukan pengguna untuk kontainer yang ditentukan. Data yang dikembalikan tidak menyertakan daftar blob kontainer. |
get_user_delegation_key |
Dapatkan kunci delegasi pengguna untuk tujuan menandatangani token SAS. Kredensial token harus ada pada objek layanan agar permintaan ini berhasil. |
list_blob_names |
Mengembalikan generator untuk mencantumkan nama blob di bawah kontainer yang ditentukan. Generator akan dengan malas mengikuti token kelanjutan yang dikembalikan oleh layanan dan berhenti ketika semua blob telah dikembalikan atau num_results tercapai. Jika num_results ditentukan dan akun memiliki lebih dari jumlah blob tersebut, generator akan memiliki bidang next_marker yang diisi setelah selesai. Penanda ini dapat digunakan untuk membuat generator baru jika lebih banyak hasil diinginkan. |
list_blobs |
Mengembalikan generator untuk mencantumkan blob di bawah kontainer yang ditentukan. Generator akan dengan malas mengikuti token kelanjutan yang dikembalikan oleh layanan dan berhenti ketika semua blob telah dikembalikan atau num_results tercapai. Jika num_results ditentukan dan akun memiliki lebih dari jumlah blob tersebut, generator akan memiliki bidang next_marker yang diisi setelah selesai. Penanda ini dapat digunakan untuk membuat generator baru jika lebih banyak hasil diinginkan. |
list_containers |
Mengembalikan generator untuk mencantumkan kontainer di bawah akun yang ditentukan. Generator akan dengan malas mengikuti token kelanjutan yang dikembalikan oleh layanan dan berhenti ketika semua kontainer telah dikembalikan atau num_results tercapai. Jika num_results ditentukan dan akun memiliki lebih dari jumlah kontainer tersebut, generator akan memiliki bidang next_marker yang diisi setelah selesai. Penanda ini dapat digunakan untuk membuat generator baru jika lebih banyak hasil diinginkan. |
make_blob_url |
Membuat url untuk mengakses blob. |
make_container_url |
Membuat url untuk mengakses kontainer. |
put_block |
Membuat blok baru yang akan diterapkan sebagai bagian dari blob. |
put_block_from_url |
Membuat blok baru yang akan diterapkan sebagai bagian dari blob. |
put_block_list |
Menulis blob dengan menentukan daftar ID blok yang membentuk blob. Untuk ditulis sebagai bagian dari blob, blok harus telah berhasil ditulis ke server dalam operasi Put Block sebelumnya. Anda dapat memanggil Put Block List untuk memperbarui blob dengan mengunggah hanya blok yang telah berubah, lalu menerapkan blok baru dan yang sudah ada bersama-sama. Anda dapat melakukan ini dengan menentukan apakah akan melakukan blok dari daftar blokir yang diterapkan atau dari daftar blokir yang tidak dikomit, atau untuk menerapkan versi blok yang terakhir diunggah, daftar mana pun yang mungkin dimilikinya. |
release_blob_lease |
Melepaskan sewa. Sewa dapat dirilis jika ID sewa yang ditentukan pada permintaan cocok dengan yang terkait dengan blob. Melepaskan sewa memungkinkan klien lain untuk segera memperoleh sewa untuk blob segera setelah rilis selesai. |
release_container_lease |
Lepaskan sewanya. Sewa dapat dirilis jika lease_id ditentukan cocok dengan yang terkait dengan kontainer. Melepaskan sewa memungkinkan klien lain untuk segera memperoleh sewa untuk kontainer segera setelah rilis selesai. |
renew_blob_lease |
Memperbarui sewa. Sewa dapat diperbarui jika ID sewa yang ditentukan pada permintaan cocok dengan yang terkait dengan blob. Perhatikan bahwa sewa dapat diperpanjang bahkan jika telah kedaluwarsa selama blob belum dimodifikasi atau disewakan lagi sejak kedaluwarsa sewa tersebut. Saat Anda memperbarui sewa, jam durasi sewa direset. |
renew_container_lease |
Memperbarui sewa. Sewa dapat diperbarui jika ID sewa yang ditentukan cocok dengan yang terkait dengan kontainer. Perhatikan bahwa sewa dapat diperpanjang bahkan jika telah kedaluwarsa selama kontainer belum disewa lagi sejak kedaluwarsa sewa tersebut. Saat Anda memperbarui sewa, jam durasi sewa direset. |
set_blob_metadata |
Mengatur metadata yang ditentukan pengguna untuk blob yang ditentukan sebagai satu atau beberapa pasangan nama-nilai. |
set_blob_properties |
Mengatur properti sistem di blob. Jika satu properti diatur untuk content_settings, semua properti akan ditimpa. |
set_blob_service_properties |
Mengatur properti blob service akun penyimpanan, termasuk Azure Storage Analytics. Jika elemen (ex Logging) dibiarkan sebagai Tidak Ada, pengaturan yang ada pada layanan untuk fungsi tersebut dipertahankan. |
set_container_acl |
Mengatur izin untuk kontainer yang ditentukan atau kebijakan akses tersimpan yang dapat digunakan dengan Tanda Tangan Akses Bersama. Izin menunjukkan apakah blob dalam kontainer dapat diakses secara publik. |
set_container_metadata |
Mengatur satu atau beberapa pasangan nilai nama yang ditentukan pengguna untuk kontainer yang ditentukan. Setiap panggilan ke operasi ini menggantikan semua metadata yang ada yang terpasang pada kontainer. Untuk menghapus semua metadata dari kontainer, panggil operasi ini tanpa dikte metadata. |
set_proxy |
Mengatur host dan port server proksi untuk Penerowongan HTTP CONNECT. |
set_standard_blob_tier |
Mengatur tingkat blob blok pada blob. API ini hanya didukung untuk blob blok pada akun penyimpanan standar. :p aram RehydratePriority rehydrate_priority: Menunjukkan prioritas untuk merehidrasi blob yang diarsipkan |
snapshot_blob |
Membuat rekam jepret baca-saja dari blob. |
undelete_blob |
Operasi Batal hapus Blob memulihkan konten dan metadata blob atau rekam jepret yang dihapus sementara. Mencoba membatalkan penghapusan blob atau rekam jepret yang tidak dihapus sementara akan berhasil tanpa perubahan apa pun. |
abort_copy_blob
Membatalkan operasi copy_blob yang tertunda, dan meninggalkan blob tujuan dengan panjang nol dan metadata penuh.
abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)
Parameter
acquire_blob_lease
Meminta sewa baru. Jika blob tidak memiliki sewa aktif, Blob service membuat sewa pada blob dan mengembalikan ID sewa baru.
acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)
Parameter
- 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).
- proposed_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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mengembalikan
str
acquire_container_lease
Meminta sewa baru. Jika kontainer tidak memiliki sewa aktif, Blob service membuat sewa pada kontainer dan mengembalikan ID sewa baru.
acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)
Parameter
- 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).
- proposed_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.
Mengembalikan
str
batch_delete_blobs
Mengirim batch beberapa permintaan penghapusan blob.
Metode penghapusan blob menghapus blob atau rekam jepret yang ditentukan. Perhatikan bahwa menghapus blob juga menghapus semua rekam jepretnya. Untuk informasi selengkapnya, lihat https://docs.microsoft.com/rest/api/storageservices/delete-blob
batch_delete_blobs(batch_delete_sub_requests, timeout=None)
Parameter
- batch_delete_sub_requests
- list(BatchDeleteSubRequest)
Blob menghapus permintaan untuk dikirim sebagai batch.
Mengembalikan
respons HTTP penghapusan batch yang diurai
Tipe hasil
batch_set_standard_blob_tier
Mengirim batch beberapa permintaan tingkat blob blok yang ditetapkan. API ini hanya didukung untuk blob blok pada akun penyimpanan standar.
batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)
Parameter
- batch_set_blob_tier_sub_requests
- list(BatchSetBlobTierSubRequest)
Set permintaan tingkat blob blok untuk dikirim sebagai batch.
- timeout
- int
Parameter batas waktu dinyatakan dalam hitung detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
Mengembalikan
Respons HTTP tingkat set batch terurai yang menunjukkan apakah setiap sub-permintaan berhasil.
Tipe hasil
break_blob_lease
Memutuskan sewa, jika blob memiliki sewa aktif. Setelah sewa rusak, sewa tidak dapat diperpanjang. Setiap permintaan yang diotorisasi dapat memutus sewa; permintaan tidak diperlukan untuk menentukan ID sewa yang cocok. Ketika sewa rusak, periode istirahat sewa diizinkan untuk berlalu, selama waktu itu tidak ada operasi sewa kecuali istirahat dan pelepasan dapat dilakukan pada blob. Ketika sewa berhasil rusak, respons menunjukkan interval dalam hitungan detik sampai sewa baru dapat diperoleh.
Sewa yang telah rusak juga dapat dirilis, dalam hal ini klien lain dapat segera memperoleh sewa pada blob.
break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)
Parameter
- lease_break_period
- int
Untuk operasi jeda, ini adalah durasi detik yang diusulkan bahwa sewa harus dilanjutkan sebelum rusak, antara 0 dan 60 detik. Periode istirahat ini hanya digunakan jika lebih pendek dari waktu yang tersisa pada sewa. Jika lebih lama, waktu yang tersisa pada sewa digunakan. Sewa baru tidak akan tersedia sebelum periode istirahat berakhir, tetapi sewa dapat ditahan lebih lama dari periode istirahat. Jika header ini tidak muncul dengan operasi pemutusan, sewa durasi tetap berhenti setelah periode sewa yang tersisa berlalu, dan sewa tak terbatas segera berhenti.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mengembalikan
int
break_container_lease
Putuskan sewa, jika kontainer memiliki sewa aktif. Setelah sewa rusak, sewa tidak dapat diperpanjang. Setiap permintaan yang diotorisasi dapat memutus sewa; permintaan tidak diperlukan untuk menentukan ID sewa yang cocok. Ketika sewa rusak, periode jeda sewa diizinkan untuk berlalu, selama waktu tersebut tidak ada operasi sewa kecuali pemutusan dan pelepasan dapat dilakukan pada kontainer. Ketika sewa berhasil rusak, respons menunjukkan interval dalam hitungan detik sampai sewa baru dapat diperoleh.
break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)
Parameter
- lease_break_period
- int
Ini adalah durasi detik yang diusulkan bahwa sewa harus dilanjutkan sebelum rusak, antara 0 dan 60 detik. Periode istirahat ini hanya digunakan jika lebih pendek dari waktu yang tersisa pada sewa. Jika lebih lama, waktu yang tersisa pada sewa digunakan. Sewa baru tidak akan tersedia sebelum periode istirahat berakhir, tetapi sewa dapat ditahan lebih lama dari periode istirahat. Jika header ini tidak muncul dengan operasi pemutusan, sewa durasi tetap berhenti setelah periode sewa yang tersisa berlalu, dan sewa tak terbatas segera berhenti.
- 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.
Mengembalikan
int
change_blob_lease
Mengubah ID sewa sewa aktif. Perubahan harus mencakup ID sewa saat ini dan ID sewa baru.
change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)
Parameter
- proposed_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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
change_container_lease
Ubah ID sewa sewa aktif. Perubahan harus mencakup ID sewa saat ini dan ID sewa baru.
change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)
Parameter
- proposed_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.
copy_blob
Menyalin blob. Operasi ini mengembalikan objek properti operasi salin. Operasi salin dapat dikonfigurasi untuk menjadi operasi asinkron, upaya terbaik, atau operasi sinkron.
Sumber harus berupa blob blok jika requires_sync benar. Blob tujuan yang ada akan ditimpa. Blob tujuan tidak dapat dimodifikasi saat operasi salin sedang berlangsung.
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.
Anda dapat memanggil get_blob_properties pada blob tujuan untuk memeriksa status operasi salin. Blob terakhir akan dilakukan ketika salinan selesai.
Nama kontainer tujuan. Kontainer harus ada. :p blob_name str: Nama blob tujuan. Jika blob tujuan ada, blob tersebut akan ditimpa. Jika tidak, itu akan dibuat. :p aram str copy_source: URL dengan panjang hingga 2 KB yang menentukan file atau blob Azure. Nilai harus dikodekan URL seperti yang 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/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram metadata: 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. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: Nilai DateTime. 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. :p waktu tanggalwaktu source_if_unmodified_since: Nilai DateTime. 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. :p aram ETag source_if_match: Nilai ETag, atau karakter kartubebas (). Tentukan header kondisional ini untuk menyalin blob sumber hanya jika ETag-nya cocok dengan nilai yang ditentukan. Jika nilai ETag tidak cocok, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). Header ini tidak dapat ditentukan jika sumbernya adalah File Azure. :p aram ETag source_if_none_match: Nilai ETag, atau karakter kartubebas (). Tentukan header kondisional ini untuk menyalin blob hanya jika ETag-nya tidak cocok dengan nilai yang ditentukan. Jika nilainya identik, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). Header ini tidak dapat ditentukan jika sumbernya adalah File Azure. :p waktu tanggalwaktu destination_if_modified_since: Nilai DateTime. 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, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). :p waktu destination_if_unmodified_since: Nilai DateTime. 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, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). :p aram ETag destination_if_match: Nilai ETag, atau karakter kartubebas (). Tentukan nilai ETag untuk header kondisional ini untuk menyalin blob hanya jika nilai ETag yang ditentukan cocok dengan nilai ETag untuk blob tujuan yang ada. Jika ETag untuk blob tujuan tidak cocok dengan ETag yang ditentukan untuk If-Match, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). :p aram ETag destination_if_none_match: Nilai ETag, atau karakter kartubebas (). Tentukan nilai ETag untuk header kondisional ini untuk menyalin blob hanya jika nilai ETag yang ditentukan tidak cocok dengan nilai ETag untuk blob tujuan. Tentukan karakter kartubebas (*) untuk melakukan operasi hanya jika blob tujuan tidak ada. Jika kondisi yang ditentukan tidak terpenuhi, layanan Blob mengembalikan kode status 412 (Prasyarat Gagal). :p aram str destination_lease_id: 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). :p aram str source_lease_id: Tentukan ini untuk melakukan operasi Salin Blob hanya jika ID sewa yang diberikan cocok dengan ID sewa aktif dari blob sumber. :p waktu habis: Parameter batas waktu dinyatakan dalam hitungan detik. :p aram bool requires_sync: Memberlakukan bahwa layanan tidak akan mengembalikan respons sampai salinan selesai. :p aram StandardBlobTier standard_blob_tier: Nilai tingkat blob standar untuk mengatur blob ke. Untuk versi pustaka ini, ini hanya berlaku untuk memblokir blob pada akun penyimpanan standar. :p aram RehydratePriority rehydrate_priority: Menunjukkan prioritas untuk merehidrasi blob yang diarsipkan :return: Salin properti operasi seperti status, sumber, dan ID. :rtype: CopyProperties
copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)
Parameter
- container_name
- str
- blob_name
- copy_source
- metadata
- source_if_modified_since
- source_if_unmodified_since
- source_if_match
- source_if_none_match
- destination_if_modified_since
- destination_if_unmodified_since
- destination_if_match
- destination_if_none_match
- destination_lease_id
- source_lease_id
- timeout
- requires_sync
- standard_blob_tier
- rehydrate_priority
create_blob_from_bytes
Membuat blob baru dari array byte, atau memperbarui konten blob yang ada, dengan pemberitahuan penggugusan dan kemajuan otomatis.
create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)
Parameter
- count
- int
Jumlah byte yang akan diunggah. Atur ke Tidak Ada atau nilai negatif untuk mengunggah semua byte mulai dari indeks.
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob.
Pasangan nama-nilai yang terkait dengan blob sebagai metadata.
- validate_content
- bool
Jika true, menghitung hash MD5 untuk setiap gugus blob. Layanan penyimpanan memeriksa hash konten yang telah tiba dengan hash yang dikirim. Ini terutama berharga untuk mendeteksi bitflips pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa hash MD5 ini tidak disimpan dengan blob.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Panggilan balik untuk kemajuan dengan fungsi tanda tangan (saat ini, total) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob, atau Tidak Ada jika ukuran total tidak diketahui.
- max_connections
- int
Jumlah maksimum koneksi paralel yang digunakan ketika ukuran blob melebihi 64MB.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
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
Parameter batas waktu dinyatakan dalam detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
- 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.
Mengembalikan
ETag dan properti terakhir yang dimodifikasi untuk Blob Blok
Tipe hasil
create_blob_from_path
Membuat blob baru dari jalur file, atau memperbarui konten blob yang ada, dengan pemberitahuan penggugusan dan kemajuan otomatis.
create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)
Parameter
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob.
Pasangan nama-nilai yang terkait dengan blob sebagai metadata.
- validate_content
- bool
Jika true, menghitung hash MD5 untuk setiap gugus blob. Layanan penyimpanan memeriksa hash konten yang telah tiba dengan hash yang dikirim. Ini terutama berharga untuk mendeteksi bitflip pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa hash MD5 ini tidak disimpan dengan blob. Perhatikan juga bahwa jika diaktifkan, algoritma pengunggahan yang hemat memori tidak akan digunakan, karena komputasi hash MD5 memerlukan buffering seluruh blok, dan melakukannya mengalahkan tujuan algoritma yang hemat memori.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Panggilan balik untuk kemajuan dengan fungsi tanda tangan (saat ini, total) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob, atau Tidak Ada jika ukuran total tidak diketahui.
- max_connections
- int
Jumlah maksimum koneksi paralel yang akan digunakan ketika ukuran blob melebihi 64MB.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
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
Parameter batas waktu dinyatakan dalam hitung detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
- 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.
Mengembalikan
ETag dan properti terakhir yang dimodifikasi untuk Blob Blok
Tipe hasil
create_blob_from_stream
Membuat blob baru dari file/aliran, atau memperbarui konten blob yang ada, dengan pemberitahuan penggugusan dan kemajuan otomatis.
create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, use_byte_buffer=False, standard_blob_tier=None, cpk=None)
Parameter
- count
- int
Jumlah byte yang akan dibaca dari aliran. Ini opsional, tetapi harus disediakan untuk performa optimal.
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob.
Pasangan nama-nilai yang terkait dengan blob sebagai metadata.
- validate_content
- bool
Jika true, menghitung hash MD5 untuk setiap gugus blob. Layanan penyimpanan memeriksa hash konten yang telah tiba dengan hash yang dikirim. Ini terutama berharga untuk mendeteksi bitflip pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa hash MD5 ini tidak disimpan dengan blob. Perhatikan juga bahwa jika diaktifkan, algoritma pengunggahan yang hemat memori tidak akan digunakan, karena komputasi hash MD5 memerlukan buffering seluruh blok, dan melakukannya mengalahkan tujuan algoritma yang hemat memori.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Panggilan balik untuk kemajuan dengan fungsi tanda tangan (saat ini, total) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob, atau Tidak Ada jika ukuran total tidak diketahui.
- max_connections
- int
Jumlah maksimum koneksi paralel yang akan digunakan ketika ukuran blob melebihi 64MB. Perhatikan bahwa pengunggahan paralel mengharuskan aliran dapat dicari.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
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
Parameter batas waktu dinyatakan dalam hitung detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
- use_byte_buffer
- bool
Jika True, ini akan memaksa penggunaan jalur unggahan buffering blok penuh asli. Secara default, nilai ini adalah False dan akan menggunakan algoritma pengunggahan streaming yang hemat memori dalam kondisi berikut: Aliran yang disediakan dapat dicari, 'require_encryption' adalah False, dan MAX_BLOCK_SIZE >= MIN_LARGE_BLOCK_UPLOAD_THRESHOLD. Seseorang harus mempertimbangkan kelemahan menggunakan pendekatan ini. Untuk mencapai efisiensi memori, aliran IOBase atau objek seperti file disegmentasi ke dalam blok logis menggunakan pembungkus SubStream. Untuk membaca data yang benar, setiap SubStream harus memperoleh kunci sehingga dapat dengan aman mencari ke posisi yang tepat pada aliran bersama yang mendasar. Jika max_connections > 1, konkurensi akan menghasilkan sejumlah besar pencarian pada aliran yang mendasar. Untuk input yang paling umum seperti objek aliran seperti file, mencari adalah operasi yang murah dan ini tidak terlalu menjadi perhatian. Namun, untuk varian aliran lainnya, ini mungkin tidak terjadi. Trade-off untuk efisiensi memori harus ditimbang terhadap biaya pencarian dengan aliran input Anda. Kelas SubStream akan mencoba buffer hingga 4 MB secara internal untuk mengurangi jumlah panggilan pencarian dan baca ke aliran yang mendasar. Ini sangat bermanfaat saat mengunggah blok yang lebih besar.
- 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.
Mengembalikan
ETag dan properti terakhir yang dimodifikasi untuk Blob Blok
Tipe hasil
create_blob_from_text
Membuat blob baru dari str/unicode, atau memperbarui konten blob yang ada, dengan pemberitahuan penggugusan dan kemajuan otomatis.
create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)
Parameter
- encoding
- str
Pengodean Python yang digunakan untuk mengonversi teks menjadi byte.
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti blob.
Pasangan nama-nilai yang terkait dengan blob sebagai metadata.
- validate_content
- bool
Jika true, menghitung hash MD5 untuk setiap gugus blob. Layanan penyimpanan memeriksa hash konten yang telah tiba dengan hash yang dikirim. Ini terutama berharga untuk mendeteksi bitflip pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa hash MD5 ini tidak disimpan dengan blob.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Panggilan balik untuk kemajuan dengan fungsi tanda tangan (saat ini, total) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob, atau Tidak Ada jika ukuran total tidak diketahui.
- max_connections
- int
Jumlah maksimum koneksi paralel yang akan digunakan ketika ukuran blob melebihi 64MB.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
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
Parameter batas waktu dinyatakan dalam hitung detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
- 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.
Mengembalikan
ETag dan properti terakhir yang dimodifikasi untuk Blob Blok
Tipe hasil
create_container
Membuat kontainer baru di bawah akun yang ditentukan. Jika kontainer dengan nama yang sama sudah ada, operasi gagal jika fail_on_exist True.
create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)
Parameter
- container_name
- str
Nama kontainer yang akan dibuat. Nama kontainer hanya boleh berisi huruf kecil, angka, dan tanda hubung, dan harus dimulai dengan huruf atau angka. Setiap tanda hubung harus diawali dan diikuti dengan karakter non-tanda hubung. Panjang nama harus antara 3 hingga 63 karakter.
Dict dengan pasangan name_value untuk dikaitkan dengan kontainer sebagai metadata. Contoh:{'Category':'test'}
- fail_on_exist
- bool
Tentukan apakah akan melemparkan pengecualian ketika kontainer ada.
Mengembalikan
True jika kontainer dibuat, False jika kontainer sudah ada.
Tipe hasil
delete_blob
Menandai blob atau rekam jepret yang ditentukan untuk dihapus. 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 Hapus Blob.
Jika kebijakan penyimpanan penghapusan diaktifkan untuk layanan, maka operasi ini akan menghapus blob atau rekam jepret dan mempertahankan blob atau rekam jepret untuk jumlah hari yang ditentukan. Setelah jumlah hari yang ditentukan, data blob dihapus dari layanan selama pengumpulan sampah. Blob atau rekam jepret yang dihapus sementara dapat diakses melalui List Blobs API yang menentukan opsi include=Include.Deleted. Blob atau rekam jepret yang dihapus sementara dapat dipulihkan menggunakan API BatalKan Penghapusan.
delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)
Parameter
- snapshot
- str
Parameter rekam jepret adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret blob yang akan dihapus.
- delete_snapshots
- DeleteSnapshot
Diperlukan jika blob memiliki rekam jepret terkait.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
delete_container
Menandai kontainer yang ditentukan untuk penghapusan. Kontainer dan blob apa pun yang terkandung di dalamnya kemudian dihapus selama pengumpulan sampah.
delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)
Parameter
- fail_not_exist
- bool
Tentukan apakah akan melemparkan pengecualian saat kontainer tidak ada.
- lease_id
- str
Jika ditentukan, delete_container hanya berhasil jika sewa kontainer aktif dan cocok dengan ID ini. Diperlukan jika kontainer memiliki sewa aktif.
- 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.
Mengembalikan
True jika kontainer dihapus, kontainer False tidak ada.
Tipe hasil
exists
Mengembalikan boolean yang menunjukkan apakah kontainer ada (jika blob_name Tidak Ada), atau boolean yang menunjukkan apakah blob ada.
exists(container_name, blob_name=None, snapshot=None, timeout=None)
Parameter
- blob_name
- str
Nama blob. Jika Tidak Ada, kontainer akan diperiksa keberadaannya.
- snapshot
- str
Parameter rekam jepret adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret.
Mengembalikan
Boolean yang menunjukkan apakah sumber daya ada.
Tipe hasil
extract_date_and_request_id
static extract_date_and_request_id(retry_context)
Parameter
- retry_context
generate_account_shared_access_signature
Menghasilkan tanda tangan akses bersama untuk layanan blob. Gunakan tanda tangan yang dikembalikan dengan parameter sas_token blobService apa pun.
generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)
Parameter
- resource_types
- <xref:ResourceTypes>
Menentukan jenis sumber daya yang dapat diakses dengan SAS akun.
- permission
- <xref:AccountPermissions>
Izin yang terkait dengan tanda tangan akses bersama. Pengguna dibatasi untuk operasi yang diizinkan oleh izin. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait.
Waktu saat tanda tangan akses bersama menjadi tidak valid. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.
Waktu di mana tanda tangan akses bersama menjadi valid. Jika dihilangkan, waktu mulai untuk panggilan ini diasumsikan sebagai waktu ketika layanan penyimpanan menerima permintaan. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.
- ip
- str
Menentukan alamat IP atau rentang alamat IP untuk menerima permintaan. Jika alamat IP tempat permintaan berasal tidak cocok dengan alamat IP atau rentang alamat yang ditentukan pada token SAS, permintaan tidak diautentikasi. Misalnya, menentukan sip=168.1.5.65 atau sip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.
- protocol
- str
Menentukan protokol yang diizinkan untuk permintaan yang dibuat. Nilai defaultnya adalah https,http. Lihat Protocol untuk nilai yang mungkin.
Mengembalikan
Token Tanda Tangan Akses Bersama (sas).
Tipe hasil
generate_blob_shared_access_signature
Menghasilkan tanda tangan akses bersama untuk blob atau salah satu rekam jepretnya. Gunakan tanda tangan yang dikembalikan dengan parameter sas_token blobService apa pun.
generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)
Parameter
- snapshot
- str
Parameter rekam jepret adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret blob untuk memberikan izin.
- permission
- BlobPermissions
Izin yang terkait dengan tanda tangan akses bersama. Pengguna dibatasi untuk operasi yang diizinkan oleh izin. Izin harus diurutkan baca, tulis, hapus, daftar. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait.
Waktu tanda tangan akses bersama menjadi tidak valid. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.
Waktu di mana tanda tangan akses bersama menjadi valid. Jika dihilangkan, waktu mulai untuk panggilan ini diasumsikan sebagai waktu ketika layanan penyimpanan menerima permintaan. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.
- id
- str
Panjang nilai unik hingga 64 karakter yang berkorelasi dengan kebijakan akses tersimpan. Untuk membuat kebijakan akses tersimpan, gunakan set_container_acl.
- ip
- str
Menentukan alamat IP atau rentang alamat IP untuk menerima permintaan. Jika alamat IP tempat permintaan berasal tidak cocok dengan alamat IP atau rentang alamat yang ditentukan pada token SAS, permintaan tidak diautentikasi. Misalnya, menentukan sip=168.1.5.65 atau sip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.
- protocol
- str
Menentukan protokol yang diizinkan untuk permintaan yang dibuat. Nilai defaultnya adalah https,http. Lihat Protocol untuk nilai yang mungkin.
- cache_control
- str
Nilai header respons untuk Cache-Control saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- content_disposition
- str
Nilai header respons untuk Content-Disposition saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- content_encoding
- str
Nilai header respons untuk Pengodean Konten saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- content_language
- str
Nilai header respons untuk Content-Language saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- content_type
- str
Nilai header respons untuk Content-Type saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- user_delegation_key
- UserDelegationKey
Alih-alih kunci akun, pengguna dapat meneruskan kunci delegasi pengguna. Kunci delegasi pengguna dapat diperoleh dari layanan dengan mengautentikasi dengan identitas AAD; ini dapat dicapai dengan memanggil get_user_delegation_key. Saat ada, SAS ditandatangani dengan kunci delegasi pengguna sebagai gantinya.
Mengembalikan
Token Tanda Tangan Akses Bersama (sas).
Tipe hasil
generate_container_shared_access_signature
Menghasilkan tanda tangan akses bersama untuk kontainer. Gunakan tanda tangan yang dikembalikan dengan parameter sas_token blobService apa pun.
generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)
Parameter
- permission
- ContainerPermissions
Izin yang terkait dengan tanda tangan akses bersama. Pengguna dibatasi untuk operasi yang diizinkan oleh izin. Izin harus diurutkan baca, tulis, hapus, daftar. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait.
Waktu tanda tangan akses bersama menjadi tidak valid. Diperlukan kecuali id diberikan mereferensikan kebijakan akses tersimpan yang berisi bidang ini. Bidang ini harus dihilangkan jika telah ditentukan dalam kebijakan akses tersimpan terkait. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.
Waktu di mana tanda tangan akses bersama menjadi valid. Jika dihilangkan, waktu mulai untuk panggilan ini diasumsikan sebagai waktu ketika layanan penyimpanan menerima permintaan. Azure akan selalu mengonversi nilai menjadi UTC. Jika tanggal diteruskan tanpa info zona waktu, diasumsikan sebagai UTC.
- id
- str
Panjang nilai unik hingga 64 karakter yang berkorelasi dengan kebijakan akses tersimpan. Untuk membuat kebijakan akses tersimpan, gunakan set_blob_service_properties.
- ip
- str
Menentukan alamat IP atau rentang alamat IP untuk menerima permintaan. Jika alamat IP tempat permintaan berasal tidak cocok dengan alamat IP atau rentang alamat yang ditentukan pada token SAS, permintaan tidak diautentikasi. Misalnya, menentukan sip=168.1.5.65 atau sip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.
- protocol
- str
Menentukan protokol yang diizinkan untuk permintaan yang dibuat. Nilai defaultnya adalah https,http. Lihat Protocol untuk nilai yang mungkin.
- cache_control
- str
Nilai header respons untuk Cache-Control saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- content_disposition
- str
Nilai header respons untuk Content-Disposition saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- content_encoding
- str
Nilai header respons untuk Pengodean Konten saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- content_language
- str
Nilai header respons untuk Content-Language saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- content_type
- str
Nilai header respons untuk Content-Type saat sumber daya diakses menggunakan tanda tangan akses bersama ini.
- user_delegation_key
- UserDelegationKey
Alih-alih kunci akun, pengguna dapat meneruskan kunci delegasi pengguna. Kunci delegasi pengguna dapat diperoleh dari layanan dengan mengautentikasi dengan identitas AAD; ini dapat dicapai dengan memanggil get_user_delegation_key. Saat ada, SAS ditandatangani dengan kunci delegasi pengguna sebagai gantinya.
Mengembalikan
Token Tanda Tangan Akses Bersama (sas).
Tipe hasil
get_blob_account_information
Mendapatkan informasi yang terkait dengan akun penyimpanan. Informasi juga dapat diambil jika pengguna memiliki SAS ke kontainer atau blob.
get_blob_account_information(container_name=None, blob_name=None, timeout=None)
Parameter
- container_name
- str
Nama kontainer yang ada. Opsional, kecuali menggunakan token SAS ke kontainer atau blob tertentu, dalam hal ini diperlukan.
- blob_name
- str
Nama blob yang ada. Opsional, kecuali menggunakan token SAS ke blob tertentu, dalam hal ini diperlukan.
Mengembalikan
get_blob_metadata
Mengembalikan semua metadata yang ditentukan pengguna untuk blob atau rekam jepret yang ditentukan.
get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)
Parameter
- snapshot
- str
Parameter rekam jepret adalah nilai buram yang, saat ada, menentukan rekam jepret blob yang akan diambil.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mendekripsi 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.
Mengembalikan
Kamus yang mewakili nama metadata blob, pasangan nilai.
Tipe hasil
get_blob_properties
Mengembalikan semua metadata yang ditentukan pengguna, properti HTTP standar, dan properti sistem untuk blob. Ini tidak mengembalikan konten blob. Mengembalikan Blob dengan BlobProperties dan dict metadata.
get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)
Parameter
- snapshot
- str
Parameter rekam jepret adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret blob untuk diambil.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mendekripsi 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.
Mengembalikan
objek blob termasuk properti dan metadata.
Tipe hasil
get_blob_service_properties
Mendapatkan properti blob service akun penyimpanan, termasuk Azure Storage Analytics.
get_blob_service_properties(timeout=None)
Parameter
Mengembalikan
Blob ServiceProperties dengan properti target_version terlampir.
get_blob_service_stats
Mengambil statistik yang terkait dengan replikasi untuk Blob service. Ini hanya tersedia ketika replikasi geo-redundan akses baca diaktifkan untuk akun penyimpanan.
Dengan replikasi geo-redundan, Azure Storage mempertahankan data Anda tetap tahan lama di dua lokasi. Di kedua lokasi, Azure Storage terus mempertahankan beberapa replika data Anda yang sehat. Lokasi tempat Anda membaca, membuat, memperbarui, atau menghapus data adalah lokasi akun penyimpanan utama. Lokasi utama ada di wilayah yang Anda pilih pada saat Anda membuat akun melalui portal klasik Azure Management Azure, misalnya, US Tengah Utara. Lokasi tempat data Anda direplikasi adalah lokasi sekunder. Lokasi sekunder secara otomatis ditentukan berdasarkan lokasi primer; berada di pusat data kedua yang berada di wilayah yang sama dengan lokasi utama. Akses baca-saja tersedia dari lokasi sekunder, jika replikasi geo-redundan akses baca diaktifkan untuk akun penyimpanan Anda.
get_blob_service_stats(timeout=None)
Parameter
Mengembalikan
Statistik layanan blob.
Tipe hasil
get_blob_to_bytes
Mengunduh blob sebagai array byte, dengan potongan otomatis dan pemberitahuan kemajuan. Mengembalikan instans Blob dengan properti, metadata, dan konten.
get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)
Parameter
- snapshot
- str
Parameter rekam jepret adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret blob untuk diambil.
- start_range
- int
Mulai rentang byte yang digunakan untuk mengunduh bagian blob. Jika tidak ada end_range yang diberikan, semua byte setelah start_range akan diunduh. Param start_range dan end_range inklusif. Misalnya: start_range=0, end_range=511 akan mengunduh 512 byte blob pertama.
- end_range
- int
Akhir rentang byte yang digunakan untuk mengunduh bagian blob. Jika end_range diberikan, start_range harus disediakan. Param start_range dan end_range inklusif. Misalnya: start_range=0, end_range=511 akan mengunduh 512 byte blob pertama.
- validate_content
- bool
Jika diatur ke true, memvalidasi hash MD5 untuk setiap bagian blob yang diambil. Ini terutama berharga untuk mendeteksi bitflips pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa layanan hanya akan mengembalikan MD5 transaksional untuk potongan 4MB atau kurang sehingga permintaan get pertama akan berukuran sendiri. MAX_CHUNK_GET_SIZE bukan diri sendiri. MAX_SINGLE_GET_SIZE. Jika diri sendiri. MAX_CHUNK_GET_SIZE diatur ke lebih besar dari 4MB, kesalahan akan dilemparkan. Karena komputasi MD5 membutuhkan waktu pemrosesan dan lebih banyak permintaan perlu dilakukan karena berkurangnya ukuran gugus mungkin ada beberapa peningkatan latensi.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Panggilan balik untuk kemajuan dengan fungsi tanda tangan (saat ini, total) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob jika diketahui.
- max_connections
- int
Jika diatur ke 2 atau lebih besar, get awal akan dilakukan untuk diri pertama. MAX_SINGLE_GET_SIZE byte blob. Jika ini adalah seluruh blob, metode akan kembali pada saat ini. Jika tidak, itu akan mengunduh paralel data yang tersisa menggunakan jumlah utas yang sama dengan max_connections. Setiap gugus akan berukuran sendiri. MAX_CHUNK_GET_SIZE. Jika diatur ke 1, satu permintaan get besar akan dilakukan. Ini umumnya tidak direkomendasikan tetapi tersedia jika sangat sedikit utas yang harus digunakan, permintaan jaringan sangat mahal, atau aliran yang tidak dapat dicari mencegah unduhan paralel. Ini mungkin juga berguna jika banyak blob diperkirakan kosong karena permintaan tambahan diperlukan untuk blob kosong jika max_connections lebih besar dari 1.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mendekripsi 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
Parameter batas waktu dinyatakan dalam detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
Mengembalikan
Blob dengan properti dan metadata. Jika max_connections lebih besar dari 1, content_md5 (jika diatur pada blob) tidak akan dikembalikan. Jika Anda memerlukan nilai ini, gunakan get_blob_properties atau atur max_connections ke 1.
Tipe hasil
get_blob_to_path
Mengunduh blob ke jalur file, dengan potongan otomatis dan pemberitahuan kemajuan. Mengembalikan instans Blob dengan properti dan metadata.
get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)
Parameter
- open_mode
- str
Mode yang digunakan saat membuka file. Perhatikan bahwa menentukan tambahkan hanya open_mode mencegah pengunduhan paralel. Jadi, max_connections harus diatur ke 1 jika open_mode ini digunakan.
- snapshot
- str
Parameter rekam jepret adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret blob untuk diambil.
- start_range
- int
Mulai rentang byte yang digunakan untuk mengunduh bagian blob. Jika tidak ada end_range yang diberikan, semua byte setelah start_range akan diunduh. Param start_range dan end_range inklusif. Misalnya: start_range=0, end_range=511 akan mengunduh 512 byte blob pertama.
- end_range
- int
Akhir rentang byte yang digunakan untuk mengunduh bagian blob. Jika end_range diberikan, start_range harus disediakan. Param start_range dan end_range inklusif. Misalnya: start_range=0, end_range=511 akan mengunduh 512 byte blob pertama.
- validate_content
- bool
Jika diatur ke true, memvalidasi hash MD5 untuk setiap bagian blob yang diambil. Ini terutama berharga untuk mendeteksi bitflips pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa layanan hanya akan mengembalikan MD5 transaksional untuk potongan 4MB atau kurang sehingga permintaan get pertama akan berukuran sendiri. MAX_CHUNK_GET_SIZE bukan diri sendiri. MAX_SINGLE_GET_SIZE. Jika diri sendiri. MAX_CHUNK_GET_SIZE diatur ke lebih besar dari 4MB, kesalahan akan dilemparkan. Karena komputasi MD5 membutuhkan waktu pemrosesan dan lebih banyak permintaan perlu dilakukan karena berkurangnya ukuran gugus mungkin ada beberapa peningkatan latensi.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Panggilan balik untuk kemajuan dengan fungsi tanda tangan (saat ini, total) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob jika diketahui.
- max_connections
- int
Jika diatur ke 2 atau lebih besar, get awal akan dilakukan untuk diri pertama. MAX_SINGLE_GET_SIZE byte blob. Jika ini adalah seluruh blob, metode akan kembali pada saat ini. Jika tidak, itu akan mengunduh paralel data yang tersisa menggunakan jumlah utas yang sama dengan max_connections. Setiap gugus akan berukuran sendiri. MAX_CHUNK_GET_SIZE. Jika diatur ke 1, satu permintaan get besar akan dilakukan. Ini umumnya tidak direkomendasikan tetapi tersedia jika sangat sedikit utas yang harus digunakan, permintaan jaringan sangat mahal, atau aliran yang tidak dapat dicari mencegah unduhan paralel. Ini mungkin juga berguna jika banyak blob diperkirakan kosong karena permintaan tambahan diperlukan untuk blob kosong jika max_connections lebih besar dari 1.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mendekripsi 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
Parameter batas waktu dinyatakan dalam detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
Mengembalikan
Blob dengan properti dan metadata. Jika max_connections lebih besar dari 1, content_md5 (jika diatur pada blob) tidak akan dikembalikan. Jika Anda memerlukan nilai ini, gunakan get_blob_properties atau atur max_connections ke 1.
Tipe hasil
get_blob_to_stream
Mengunduh blob ke aliran, dengan potongan otomatis dan pemberitahuan kemajuan. Mengembalikan instans Blob dengan properti dan metadata.
get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)
Parameter
- snapshot
- str
Parameter rekam jepret adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret blob untuk diambil.
- start_range
- int
Mulai rentang byte yang digunakan untuk mengunduh bagian blob. Jika tidak ada end_range yang diberikan, semua byte setelah start_range akan diunduh. Param start_range dan end_range inklusif. Misalnya: start_range=0, end_range=511 akan mengunduh 512 byte blob pertama.
- end_range
- int
Akhir rentang byte yang digunakan untuk mengunduh bagian blob. Jika end_range diberikan, start_range harus disediakan. Param start_range dan end_range inklusif. Misalnya: start_range=0, end_range=511 akan mengunduh 512 byte blob pertama.
- validate_content
- bool
Jika diatur ke true, memvalidasi hash MD5 untuk setiap bagian blob yang diambil. Ini terutama berharga untuk mendeteksi bitflips pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa layanan hanya akan mengembalikan MD5 transaksional untuk potongan 4MB atau kurang sehingga permintaan get pertama akan berukuran sendiri. MAX_CHUNK_GET_SIZE bukan diri sendiri. MAX_SINGLE_GET_SIZE. Jika diri sendiri. MAX_CHUNK_GET_SIZE diatur ke lebih besar dari 4MB, kesalahan akan dilemparkan. Karena komputasi MD5 membutuhkan waktu pemrosesan dan lebih banyak permintaan perlu dilakukan karena berkurangnya ukuran gugus mungkin ada beberapa peningkatan latensi.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Panggilan balik untuk kemajuan dengan fungsi tanda tangan (saat ini, total) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob jika diketahui.
- max_connections
- int
Jika diatur ke 2 atau lebih besar, get awal akan dilakukan untuk diri pertama. MAX_SINGLE_GET_SIZE byte blob. Jika ini adalah seluruh blob, metode akan kembali pada saat ini. Jika tidak, itu akan mengunduh paralel data yang tersisa menggunakan jumlah utas yang sama dengan max_connections. Setiap gugus akan berukuran sendiri. MAX_CHUNK_GET_SIZE. Jika diatur ke 1, satu permintaan get besar akan dilakukan. Ini umumnya tidak direkomendasikan tetapi tersedia jika sangat sedikit utas yang harus digunakan, permintaan jaringan sangat mahal, atau aliran yang tidak dapat dicari mencegah unduhan paralel. Ini mungkin juga berguna jika banyak blob diperkirakan kosong karena permintaan tambahan diperlukan untuk blob kosong jika max_connections lebih besar dari 1.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mendekripsi 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
Parameter batas waktu dinyatakan dalam detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
Mengembalikan
Blob dengan properti dan metadata. Jika max_connections lebih besar dari 1, content_md5 (jika diatur pada blob) tidak akan dikembalikan. Jika Anda memerlukan nilai ini, gunakan get_blob_properties atau atur max_connections ke 1.
Tipe hasil
get_blob_to_text
Mengunduh blob sebagai teks unicode, dengan pemberitahuan penggugusan dan kemajuan otomatis. Mengembalikan instans Blob dengan properti, metadata, dan konten.
get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)
Parameter
- snapshot
- str
Parameter rekam jepret adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret blob untuk diambil.
- start_range
- int
Mulai rentang byte yang digunakan untuk mengunduh bagian blob. Jika tidak ada end_range yang diberikan, semua byte setelah start_range akan diunduh. Param start_range dan end_range inklusif. Misalnya: start_range=0, end_range=511 akan mengunduh 512 byte blob pertama.
- end_range
- int
Akhir rentang byte yang digunakan untuk mengunduh bagian blob. Jika end_range diberikan, start_range harus disediakan. Param start_range dan end_range inklusif. Misalnya: start_range=0, end_range=511 akan mengunduh 512 byte blob pertama.
- validate_content
- bool
Jika diatur ke true, memvalidasi hash MD5 untuk setiap bagian blob yang diambil. Ini terutama berharga untuk mendeteksi bitflip pada kawat jika menggunakan http alih-alih https sebagai https (default) sudah akan memvalidasi. Perhatikan bahwa layanan hanya akan mengembalikan MD5 transaksional untuk potongan 4MB atau kurang sehingga permintaan get pertama akan berukuran sendiri. MAX_CHUNK_GET_SIZE bukan diri sendiri. MAX_SINGLE_GET_SIZE. Jika diri sendiri. MAX_CHUNK_GET_SIZE diatur ke lebih besar dari 4MB, kesalahan akan dilemparkan. Karena komputasi MD5 membutuhkan waktu pemrosesan dan lebih banyak permintaan perlu dilakukan karena ukuran gugus yang berkurang mungkin ada beberapa peningkatan latensi.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Panggilan balik untuk kemajuan dengan fungsi tanda tangan (saat ini, total) di mana saat ini adalah jumlah byte yang ditransfer sejauh ini, dan total adalah ukuran blob jika diketahui.
- max_connections
- int
Jika diatur ke 2 atau lebih besar, get awal akan dilakukan untuk diri pertama. MAX_SINGLE_GET_SIZE byte blob. Jika ini adalah seluruh blob, metode akan kembali pada titik ini. Jika tidak, itu akan mengunduh paralel data yang tersisa menggunakan jumlah utas yang sama dengan max_connections. Setiap gugus akan berukuran sendiri. MAX_CHUNK_GET_SIZE. Jika diatur ke 1, satu permintaan get besar akan dilakukan. Ini umumnya tidak direkomendasikan tetapi tersedia jika sangat sedikit utas yang harus digunakan, permintaan jaringan sangat mahal, atau aliran yang tidak dapat dicari mencegah unduhan paralel. Ini mungkin juga berguna jika banyak blob diharapkan kosong karena permintaan tambahan diperlukan untuk blob kosong jika max_connections lebih besar dari 1.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mendekripsi 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
Parameter batas waktu dinyatakan dalam hitung detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
Mengembalikan
Blob dengan properti dan metadata. Jika max_connections lebih besar dari 1, content_md5 (jika diatur pada blob) tidak akan dikembalikan. Jika Anda memerlukan nilai ini, gunakan get_blob_properties atau atur max_connections ke 1.
Tipe hasil
get_block_list
Mengambil daftar blok yang telah diunggah sebagai bagian dari blob blok. Ada dua daftar blok yang dipertahankan untuk blob:
Daftar Blok berkomitmen: Daftar blok yang telah berhasil diterapkan ke blob tertentu dengan Put Block List.
Daftar Blokir yang Tidak Dikomit: Daftar blok yang telah diunggah untuk blob menggunakan Put Block, tetapi belum diterapkan. Blok-blok ini disimpan di Azure dalam kaitannya dengan blob, tetapi belum membentuk bagian dari blob.
get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=None, timeout=None)
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 valid adalah: berkomitmen, tidak dikomit, atau semua.
Mengembalikan
mencantumkan blok yang berkomitmen dan/atau tidak dikomit untuk Blob Blok
Tipe hasil
get_container_acl
Mendapatkan izin untuk kontainer yang ditentukan. Izin menunjukkan apakah data kontainer dapat diakses secara publik.
get_container_acl(container_name, lease_id=None, timeout=None)
Parameter
- lease_id
Jika ditentukan, get_container_acl hanya berhasil jika sewa kontainer aktif dan cocok dengan ID ini.
Mengembalikan
Kamus kebijakan akses yang terkait dengan kontainer. dict str ke AccessPolicy dan properti public_access jika akses publik diaktifkan
get_container_metadata
Mengembalikan semua metadata yang ditentukan pengguna untuk kontainer yang ditentukan.
get_container_metadata(container_name, lease_id=None, timeout=None)
Parameter
- lease_id
- str
Jika ditentukan, get_container_metadata hanya berhasil jika sewa kontainer aktif dan cocok dengan ID ini.
Mengembalikan
Kamus yang mewakili nama metadata kontainer, pasangan nilai.
Tipe hasil
get_container_properties
Mengembalikan semua metadata dan properti sistem yang ditentukan pengguna untuk kontainer yang ditentukan. Data yang dikembalikan tidak menyertakan daftar blob kontainer.
get_container_properties(container_name, lease_id=None, timeout=None)
Parameter
- lease_id
- str
Jika ditentukan, get_container_properties hanya berhasil jika sewa kontainer aktif dan cocok dengan ID ini.
Mengembalikan
properti untuk kontainer yang ditentukan dalam objek kontainer.
Tipe hasil
get_user_delegation_key
Dapatkan kunci delegasi pengguna untuk tujuan menandatangani token SAS. Kredensial token harus ada pada objek layanan agar permintaan ini berhasil.
get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)
Parameter
Mengembalikan
Kunci delegasi pengguna.
Tipe hasil
list_blob_names
Mengembalikan generator untuk mencantumkan nama blob di bawah kontainer yang ditentukan. Generator akan dengan malas mengikuti token kelanjutan yang dikembalikan oleh layanan dan berhenti ketika semua blob telah dikembalikan atau num_results tercapai.
Jika num_results ditentukan dan akun memiliki lebih dari jumlah blob tersebut, generator akan memiliki bidang next_marker yang diisi setelah selesai. Penanda ini dapat digunakan untuk membuat generator baru jika lebih banyak hasil diinginkan.
list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)
Parameter
- prefix
- str
Memfilter hasil untuk mengembalikan hanya blob yang namanya dimulai dengan awalan yang ditentukan.
- num_results
- int
Menentukan jumlah maksimum blob yang akan dikembalikan, termasuk semua <xref:azure.storage.blob.blockblobservice.BlobPrefix> elemen. Jika permintaan tidak menentukan num_results atau menentukan nilai yang lebih besar dari 5.000, server akan mengembalikan hingga 5.000 item. Mengatur num_results ke nilai yang kurang dari atau sama dengan nol menghasilkan kode respons kesalahan 400 (Permintaan Buruk).
- include
- Include
Menentukan satu atau beberapa himpunan data tambahan untuk disertakan dalam respons.
- delimiter
- str
Ketika permintaan menyertakan parameter ini, operasi mengembalikan BlobPrefix elemen dalam daftar hasil yang bertindak sebagai tempat penampung untuk semua blob yang namanya dimulai dengan substring yang sama hingga tampilan karakter pemisah. Pemisah mungkin satu karakter atau string.
- marker
- str
Token kelanjutan buram. Nilai ini dapat diambil dari bidang next_marker objek generator sebelumnya jika num_results ditentukan dan generator tersebut telah selesai menghitung hasil. Jika ditentukan, generator ini akan mulai mengembalikan hasil dari titik di mana generator sebelumnya berhenti.
list_blobs
Mengembalikan generator untuk mencantumkan blob di bawah kontainer yang ditentukan. Generator akan dengan malas mengikuti token kelanjutan yang dikembalikan oleh layanan dan berhenti ketika semua blob telah dikembalikan atau num_results tercapai.
Jika num_results ditentukan dan akun memiliki lebih dari jumlah blob tersebut, generator akan memiliki bidang next_marker yang diisi setelah selesai. Penanda ini dapat digunakan untuk membuat generator baru jika lebih banyak hasil diinginkan.
list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)
Parameter
- prefix
- str
Memfilter hasil untuk mengembalikan hanya blob yang namanya dimulai dengan awalan yang ditentukan.
- num_results
- int
Menentukan jumlah maksimum blob yang akan dikembalikan, termasuk semua <xref:azure.storage.blob.blockblobservice.BlobPrefix> elemen. Jika permintaan tidak menentukan num_results atau menentukan nilai yang lebih besar dari 5.000, server akan mengembalikan hingga 5.000 item. Mengatur num_results ke nilai yang kurang dari atau sama dengan nol menghasilkan kode respons kesalahan 400 (Permintaan Buruk).
- include
- Include
Menentukan satu atau beberapa himpunan data tambahan untuk disertakan dalam respons.
- delimiter
- str
Ketika permintaan menyertakan parameter ini, operasi mengembalikan BlobPrefix elemen dalam daftar hasil yang bertindak sebagai tempat penampung untuk semua blob yang namanya dimulai dengan substring yang sama hingga tampilan karakter pemisah. Pemisah mungkin satu karakter atau string.
- marker
- str
Token kelanjutan buram. Nilai ini dapat diambil dari bidang next_marker objek generator sebelumnya jika num_results ditentukan dan generator tersebut telah selesai menghitung hasil. Jika ditentukan, generator ini akan mulai mengembalikan hasil dari titik di mana generator sebelumnya berhenti.
list_containers
Mengembalikan generator untuk mencantumkan kontainer di bawah akun yang ditentukan. Generator akan dengan malas mengikuti token kelanjutan yang dikembalikan oleh layanan dan berhenti ketika semua kontainer telah dikembalikan atau num_results tercapai.
Jika num_results ditentukan dan akun memiliki lebih dari jumlah kontainer tersebut, generator akan memiliki bidang next_marker yang diisi setelah selesai. Penanda ini dapat digunakan untuk membuat generator baru jika lebih banyak hasil diinginkan.
list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)
Parameter
- prefix
- str
Memfilter hasil untuk mengembalikan hanya kontainer yang namanya dimulai dengan awalan yang ditentukan.
- num_results
- int
Menentukan jumlah maksimum kontainer yang akan dikembalikan. Satu permintaan daftar dapat mengembalikan hingga 1000 kontianer dan berpotensi token kelanjutan yang harus diikuti untuk mendapatkan resutls tambahan.
- include_metadata
- bool
Menentukan bahwa metadata kontainer dikembalikan dalam respons.
- marker
- str
Token kelanjutan buram. Nilai ini dapat diambil dari bidang next_marker objek generator sebelumnya jika num_results ditentukan dan generator tersebut telah selesai menghitung hasil. Jika ditentukan, generator ini akan mulai mengembalikan hasil dari titik di mana generator sebelumnya berhenti.
make_blob_url
Membuat url untuk mengakses blob.
make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)
Parameter
- protocol
- str
Protokol yang akan digunakan: 'http' atau 'https'. Jika tidak ditentukan, gunakan protokol yang ditentukan ketika BaseBlobService diinisialisasi.
- sas_token
- str
Token tanda tangan akses bersama dibuat dengan generate_shared_access_signature.
- snapshot
- str
Nilai string yang secara unik mengidentifikasi rekam jepret. Nilai parameter kueri ini menunjukkan versi rekam jepret.
Mengembalikan
URL akses blob.
Tipe hasil
make_container_url
Membuat url untuk mengakses kontainer.
make_container_url(container_name, protocol=None, sas_token=None)
Parameter
- protocol
- str
Protokol yang akan digunakan: 'http' atau 'https'. Jika tidak ditentukan, gunakan protokol yang ditentukan ketika BaseBlobService diinisialisasi.
- sas_token
- str
Token tanda tangan akses bersama dibuat dengan generate_shared_access_signature.
Mengembalikan
URL akses kontainer.
Tipe hasil
put_block
Membuat blok baru yang akan diterapkan sebagai bagian dari blob.
put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)
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.
- 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.
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.
put_block_from_url
Membuat blok baru yang akan diterapkan sebagai bagian dari blob.
put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)
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_range_start
- int
Ini menunjukkan dimulainya rentang byte (inklusif) yang harus diambil dari sumber salinan.
- source_range_end
- int
Ini menunjukkan akhir rentang byte (inklusif) yang harus diambil dari sumber salinan.
- 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_content_md5
- str
Jika diberikan, layanan akan menghitung hash MD5 dari konten blok dan membandingkan dengan nilai ini.
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.
put_block_list
Menulis blob dengan menentukan daftar ID blok yang membentuk blob. Untuk ditulis sebagai bagian dari blob, blok harus telah berhasil ditulis ke server dalam operasi Put Block sebelumnya.
Anda dapat memanggil Put Block List untuk memperbarui blob dengan mengunggah hanya blok yang telah berubah, lalu menerapkan blok baru dan yang sudah ada bersama-sama. Anda dapat melakukan ini dengan menentukan apakah akan melakukan blok dari daftar blokir yang diterapkan atau dari daftar blokir yang tidak dikomit, atau untuk menerapkan versi blok yang terakhir diunggah, daftar mana pun yang mungkin dimilikinya.
put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)
Parameter
- block_list
- list(BlobBlock)
Daftar <xref:azure.storeage.blob.models.BlobBlock> yang berisi id blok dan status blok.
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti pada blob.
Pasangan nama-nilai yang terkait dengan blob sebagai metadata.
- validate_content
- bool
Jika true, menghitung hash MD5 dari konten daftar blokir. Layanan penyimpanan memeriksa hash konten daftar blokir 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 pemeriksaan ini dikaitkan dengan konten daftar blokir, dan bukan dengan konten blob itu sendiri.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
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.
- 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.
Mengembalikan
ETag dan properti terakhir diubah untuk Blob Blok yang diperbarui
Tipe hasil
release_blob_lease
Melepaskan sewa. Sewa dapat dirilis jika ID sewa yang ditentukan pada permintaan cocok dengan yang terkait dengan blob. Melepaskan sewa memungkinkan klien lain untuk segera memperoleh sewa untuk blob segera setelah rilis selesai.
release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)
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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
release_container_lease
Lepaskan sewanya. Sewa dapat dirilis jika lease_id ditentukan cocok dengan yang terkait dengan kontainer. Melepaskan sewa memungkinkan klien lain untuk segera memperoleh sewa untuk kontainer segera setelah rilis selesai.
release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)
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.
renew_blob_lease
Memperbarui sewa. Sewa dapat diperbarui jika ID sewa yang ditentukan pada permintaan cocok dengan yang terkait dengan blob. Perhatikan bahwa sewa dapat diperpanjang bahkan jika telah kedaluwarsa selama blob belum dimodifikasi atau disewakan lagi sejak kedaluwarsa sewa tersebut. Saat Anda memperbarui sewa, jam durasi sewa direset.
renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)
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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
Mengembalikan
str
renew_container_lease
Memperbarui sewa. Sewa dapat diperbarui jika ID sewa yang ditentukan cocok dengan yang terkait dengan kontainer. Perhatikan bahwa sewa dapat diperpanjang bahkan jika telah kedaluwarsa selama kontainer belum disewa lagi sejak kedaluwarsa sewa tersebut. Saat Anda memperbarui sewa, jam durasi sewa direset.
renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)
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.
Mengembalikan
str
set_blob_metadata
Mengatur metadata yang ditentukan pengguna untuk blob yang ditentukan sebagai satu atau beberapa pasangan nama-nilai.
set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)
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.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
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.
Mengembalikan
ETag dan properti terakhir yang dimodifikasi untuk Blob yang diperbarui
Tipe hasil
set_blob_properties
Mengatur properti sistem di blob. Jika satu properti diatur untuk content_settings, semua properti akan ditimpa.
set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)
Parameter
- content_settings
- ContentSettings
Objek ContentSettings yang digunakan untuk mengatur properti 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
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.
Mengembalikan
ETag dan properti terakhir yang dimodifikasi untuk Blob yang diperbarui
Tipe hasil
set_blob_service_properties
Mengatur properti blob service akun penyimpanan, termasuk Azure Storage Analytics. Jika elemen (ex Logging) dibiarkan sebagai Tidak Ada, pengaturan yang ada pada layanan untuk fungsi tersebut dipertahankan.
set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)
Parameter
- hour_metrics
- Metrics
Pengaturan metrik jam menyediakan ringkasan statistik permintaan yang dikelompokkan menurut API dalam agregat per jam untuk blob.
- minute_metrics
- Metrics
Pengaturan metrik menit menyediakan statistik permintaan untuk setiap menit untuk blob.
- cors
- list(CorsRule)
Anda dapat menyertakan hingga lima elemen CorsRule dalam daftar. Jika daftar kosong ditentukan, semua aturan CORS akan dihapus, dan CORS akan dinonaktifkan untuk layanan.
- target_version
- str
Menunjukkan versi default yang akan digunakan untuk permintaan jika versi permintaan masuk tidak ditentukan.
- delete_retention_policy
- DeleteRetentionPolicy
Kebijakan penyimpanan penghapusan menentukan apakah akan mempertahankan blob yang dihapus. Ini juga menentukan jumlah hari dan versi blob yang akan disimpan.
- static_website
- StaticWebsite
Menentukan apakah fitur situs web statis diaktifkan, dan jika ya, menunjukkan dokumen indeks dan dokumen kesalahan 404 yang akan digunakan.
set_container_acl
Mengatur izin untuk kontainer yang ditentukan atau kebijakan akses tersimpan yang dapat digunakan dengan Tanda Tangan Akses Bersama. Izin menunjukkan apakah blob dalam kontainer dapat diakses secara publik.
set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)
Parameter
- signed_identifiers
- dict(str, AccessPolicy)
Kamus kebijakan akses untuk dikaitkan dengan kontainer. Kamus mungkin berisi hingga 5 elemen. Kamus kosong akan menghapus kebijakan akses yang ditetapkan pada layanan.
- lease_id
- str
Jika ditentukan, set_container_acl hanya berhasil jika sewa kontainer aktif dan cocok dengan ID ini.
- 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 tanggal/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.
Mengembalikan
ETag dan properti terakhir diubah untuk Kontainer yang diperbarui
Tipe hasil
set_container_metadata
Mengatur satu atau beberapa pasangan nilai nama yang ditentukan pengguna untuk kontainer yang ditentukan. Setiap panggilan ke operasi ini menggantikan semua metadata yang ada yang terpasang pada kontainer. Untuk menghapus semua metadata dari kontainer, panggil operasi ini tanpa dikte metadata.
set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)
Parameter
Dict yang berisi pasangan nama-nilai untuk dikaitkan dengan kontainer sebagai metadata. Contoh: {'category':'test'}
- lease_id
- str
Jika ditentukan, set_container_metadata hanya berhasil jika sewa kontainer aktif dan cocok dengan ID ini.
- 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.
Mengembalikan
ETag dan properti terakhir diubah untuk Kontainer yang diperbarui
Tipe hasil
set_proxy
Mengatur host dan port server proksi untuk Penerowongan HTTP CONNECT.
set_proxy(host, port, user=None, password=None)
Parameter
set_standard_blob_tier
Mengatur tingkat blob blok pada blob. API ini hanya didukung untuk blob blok pada akun penyimpanan standar.
:p aram RehydratePriority rehydrate_priority: Menunjukkan prioritas untuk merehidrasi blob yang diarsipkan
set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)
Parameter
- 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.
- timeout
- int
Parameter batas waktu dinyatakan dalam hitung detik. Metode ini dapat melakukan beberapa panggilan ke layanan Azure dan batas waktu akan berlaku untuk setiap panggilan satu per satu.
- rehydrate_priority
snapshot_blob
Membuat rekam jepret baca-saja dari blob.
snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)
Parameter
Menentukan pasangan nilai nama yang ditentukan pengguna yang terkait dengan blob. Jika tidak ada pasangan nama-nilai yang ditentukan, operasi akan menyalin metadata blob dasar ke rekam jepret. Jika satu atau beberapa pasangan nilai nama ditentukan, rekam jepret dibuat dengan metadata yang ditentukan, dan metadata tidak disalin dari blob dasar.
- 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.
- if_match
- str
Nilai ETag, atau karakter kartubebas (*). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan.
- if_none_match
- str
Nilai ETag, atau karakter kartubebas (). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika sumber daya tidak ada, dan gagalkan operasi jika memang ada.
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.
Mengembalikan
properti rekam jepret
Tipe hasil
undelete_blob
Operasi Batal hapus Blob memulihkan konten dan metadata blob atau rekam jepret yang dihapus sementara. Mencoba membatalkan penghapusan blob atau rekam jepret yang tidak dihapus sementara akan berhasil tanpa perubahan apa pun.
undelete_blob(container_name, blob_name, timeout=None)
Parameter
Atribut
protocol
request_session
socket_timeout
MAX_BLOCK_SIZE
MAX_BLOCK_SIZE = 4194304
MAX_CHUNK_GET_SIZE
MAX_CHUNK_GET_SIZE = 4194304
MAX_SINGLE_GET_SIZE
MAX_SINGLE_GET_SIZE = 33554432
MAX_SINGLE_PUT_SIZE
MAX_SINGLE_PUT_SIZE = 67108864
MIN_LARGE_BLOCK_UPLOAD_THRESHOLD
MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305
Azure SDK for Python
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk