filedatalake Paket

  • Referensi

Paket

aio

Kelas

AccessControlChangeCounters

AccessControlChangeCounters berisi jumlah operasi yang mengubah daftar Access Control secara rekursif.
AccessControlChangeFailure

Mewakili entri yang gagal memperbarui Daftar Access Control.
AccessControlChangeResult

AccessControlChangeResult berisi hasil operasi yang mengubah daftar Access Control secara rekursif.
AccessControlChanges

AccessControlChanges berisi jumlah batch dan kumulatif operasi yang berubah Access Control Daftar secara rekursif. Selain itu, ini mengekspos entri jalur yang gagal diperbarui saat operasi ini berlangsung.
AccessPolicy

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

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

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

Pengaturan Pengelogan Azure Analytics.
ArrowDialect

bidang skema panah.

Semua parameter yang diperlukan harus diisi untuk dikirim ke Azure.
ContentSettings

Pengaturan konten file atau direktori.
CorsRule

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

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

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

Klien untuk berinteraksi dengan direktori DataLake, bahkan jika direktori mungkin belum ada.

Untuk operasi yang berkaitan dengan subdirektori atau file tertentu di bawah direktori, klien direktori atau klien file dapat diambil menggunakan get_sub_directory_client fungsi atau get_file_client .
DataLakeFileClient

Klien untuk berinteraksi dengan file DataLake, bahkan jika file mungkin belum ada.
DataLakeFileQueryError

Kesalahan terjadi selama operasi kueri cepat.
DataLakeLeaseClient

Membuat DataLakeLeaseClient baru.

Klien ini menyediakan operasi sewa pada FileSystemClient, DataLakeDirectoryClient atau DataLakeFileClient.
DataLakeServiceClient

Klien untuk berinteraksi dengan Layanan DataLake di tingkat akun.

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

Properti yang diisi untuk jalur yang dihapus.
DelimitedJsonDialect

Menentukan serialisasi JSON input atau output untuk kueri datalake.

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

'
DelimitedTextDialect

Menentukan serialisasi input atau output delimited (CSV) untuk permintaan kueri datalake.

pemisah str kata kunci: Pemisah kolom, defaultnya adalah ','.

kata kunci kutipan str: Kutipan bidang, default ke '"'.

kata kunci str lineterminator: Pemisah rekaman, default ke '

'. kata kunci str escapechar: Escape char, default ke kosong.

has_header bool kata kunci: Apakah data blob menyertakan header di baris pertama. Nilai defaultnya adalah False, yang berarti bahwa data akan dikembalikan inklusif dari baris pertama. Jika diatur ke True, data akan dikembalikan eksklusif dari baris pertama.
DirectoryProperties
DirectorySasPermissions

Kelas DirectorySasPermissions yang akan digunakan dengan generate_directory_sas fungsi .
EncryptionScopeOptions

Konfigurasi cakupan enkripsi default untuk sistem file.

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

Baru dalam versi 12.9.0.
ExponentialRetry

Percobaan ulang eksponensial.

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

Kelas FileSasPermissions yang akan digunakan dengan generate_file_sas fungsi .
FileSystemClient

Klien untuk berinteraksi dengan sistem file tertentu, bahkan jika sistem file tersebut mungkin belum ada.

Untuk operasi yang berkaitan dengan direktori atau file tertentu dalam sistem file ini, klien direktori atau klien file dapat diambil menggunakan get_directory_client fungsi atau get_file_client .
FileSystemProperties

Kelas properti Sistem File.

Instans yang dikembalikan FileSystemProperties mengekspos nilai-nilai ini melalui antarmuka kamus, misalnya: file_system_props["last_modified"]. Selain itu, nama sistem file tersedia sebagai file_system_props["name"].
FileSystemPropertiesPaged

Properti Sistem File yang Dapat Diulang.
FileSystemSasPermissions

Kelas FileSystemSasPermissions yang akan digunakan dengan generate_file_system_sas fungsi .
LeaseProperties

Properti Sewa DataLake.
LinearRetry

Coba lagi linier.

Membuat objek coba lagi Linear.
LocationMode

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

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

Properti jalur yang tercantum oleh api get_paths.
ResourceTypes

Menentukan jenis sumber daya yang dapat diakses dengan SAS akun.
RetentionPolicy

Kebijakan penyimpanan yang menentukan berapa lama data terkait harus bertahan.
StaticWebsite

Properti yang memungkinkan akun untuk menghosting situs web statis.
StorageStreamDownloader

Objek streaming untuk diunduh dari Azure Storage.
UserDelegationKey

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

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

Enum

ArrowType
PublicAccess

Menentukan apakah data dalam sistem file dapat diakses secara publik dan tingkat akses.
QuickQueryDialect

Menentukan dialek input/output kueri cepat.
StorageErrorCode

Fungsi

generate_account_sas

Menghasilkan tanda tangan akses bersama untuk layanan DataLake.

Gunakan tanda tangan yang dikembalikan sebagai parameter info masuk dari DataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient atau DataLakeFileClient.

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

Parameter

account_name
str
Diperlukan

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

account_key
str
Diperlukan

Kunci akses untuk menghasilkan tanda tangan akses bersama.

resource_types
str atau ResourceTypes
Diperlukan

Menentukan jenis sumber daya yang dapat diakses dengan SAS akun.

permission
str atau AccountSasPermissions
Diperlukan

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

expiry
datetime atau str
Diperlukan

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

start
datetime atau str

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 ip=168.1.5.65 atau ip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.

protocol
str

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

encryption_scope
str

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

Mengembalikan

Token Tanda Tangan Akses Bersama (sas).

Tipe hasil

str

generate_directory_sas

Menghasilkan tanda tangan akses bersama untuk direktori.

Gunakan tanda tangan yang dikembalikan dengan parameter info masuk dari DataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient atau DataLakeFileClient.

generate_directory_sas(account_name: str, file_system_name: str, directory_name: str, credential: str | UserDelegationKey, permission: DirectorySasPermissions | str | None = None, expiry: datetime | str | None = None, **kwargs: Any) -> str

Parameter

account_name
str
Diperlukan

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

file_system_name
str
Diperlukan

Nama sistem file.

directory_name
str
Diperlukan

Nama direktori.

credential
str atau UserDelegationKey
Diperlukan

Kredensial dapat berupa kunci akun atau kunci delegasi pengguna. Jika menggunakan kunci akun digunakan sebagai kredensial, maka jenis kredensial harus str. Alih-alih kunci akun, pengguna juga dapat meneruskan kunci delegasi pengguna. Kunci delegasi pengguna dapat diperoleh dari layanan dengan mengautentikasi dengan identitas AAD; ini dapat dicapai dengan memanggil get_user_delegation_key. Saat ada, SAS ditandatangani dengan kunci delegasi pengguna sebagai gantinya.

permission
str atau DirectorySasPermissions
nilai default: None

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

expiry
datetime atau str
nilai default: None

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

start
datetime atau str

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 ip=168.1.5.65 atau ip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.

protocol
str

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

cache_control
str

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

content_disposition
str

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

content_encoding
str

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

content_language
str

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

content_type
str

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

preauthorized_agent_object_id
str

ID objek AAD dari pengguna diasumsikan diotorisasi oleh pemilik kunci delegasi pengguna untuk melakukan tindakan yang diberikan oleh token SAS. Layanan ini akan memvalidasi token SAS dan memastikan bahwa pemilik kunci delegasi pengguna memiliki izin yang diperlukan sebelum memberikan akses tetapi tidak ada pemeriksaan izin tambahan untuk id objek agen yang akan dilakukan.

agent_object_id
str

ID objek AAD pengguna diasumsikan tidak sah oleh pemilik kunci delegasi pengguna untuk melakukan tindakan yang diberikan oleh token SAS. Layanan ini akan memvalidasi token SAS dan memastikan bahwa pemilik kunci delegasi pengguna memiliki izin yang diperlukan sebelum memberikan akses dan layanan akan melakukan pemeriksaan POSIX ACL tambahan untuk menentukan apakah pengguna ini berwenang untuk melakukan operasi yang diminta.

correlation_id
str

Id korelasi untuk menghubungkan log audit penyimpanan dengan log audit yang digunakan oleh perwakilan yang menghasilkan dan mendistribusikan SAS.

encryption_scope
str

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

Mengembalikan

Token Tanda Tangan Akses Bersama (sas).

Tipe hasil

str

generate_file_sas

Menghasilkan tanda tangan akses bersama untuk file.

Gunakan tanda tangan yang dikembalikan dengan parameter info masuk dari BDataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient atau DataLakeFileClient.

generate_file_sas(account_name: str, file_system_name: str, directory_name: str, file_name: str, credential: str | UserDelegationKey, permission: FileSasPermissions | str | None = None, expiry: datetime | str | None = None, **kwargs: Any) -> str

Parameter

account_name
str
Diperlukan

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

file_system_name
str
Diperlukan

Nama sistem file.

directory_name
str
Diperlukan

Nama direktori.

file_name
str
Diperlukan

Nama file.

credential
str atau UserDelegationKey
Diperlukan

Kredensial dapat berupa kunci akun atau kunci delegasi pengguna. Jika menggunakan kunci akun digunakan sebagai kredensial, maka jenis kredensial harus str. Alih-alih kunci akun, pengguna juga dapat meneruskan kunci delegasi pengguna. Kunci delegasi pengguna dapat diperoleh dari layanan dengan mengautentikasi dengan identitas AAD; ini dapat dicapai dengan memanggil get_user_delegation_key. Saat ada, SAS ditandatangani dengan kunci delegasi pengguna sebagai gantinya.

permission
str atau FileSasPermissions
nilai default: None

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

expiry
datetime atau str
nilai default: None

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

start
datetime atau str

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 ip=168.1.5.65 atau ip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.

protocol
str

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

cache_control
str

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

content_disposition
str

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

content_encoding
str

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

content_language
str

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

content_type
str

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

preauthorized_agent_object_id
str

ID objek AAD dari pengguna diasumsikan diotorisasi oleh pemilik kunci delegasi pengguna untuk melakukan tindakan yang diberikan oleh token SAS. Layanan ini akan memvalidasi token SAS dan memastikan bahwa pemilik kunci delegasi pengguna memiliki izin yang diperlukan sebelum memberikan akses tetapi tidak ada pemeriksaan izin tambahan untuk id objek agen yang akan dilakukan.

agent_object_id
str

ID objek AAD pengguna diasumsikan tidak sah oleh pemilik kunci delegasi pengguna untuk melakukan tindakan yang diberikan oleh token SAS. Layanan ini akan memvalidasi token SAS dan memastikan bahwa pemilik kunci delegasi pengguna memiliki izin yang diperlukan sebelum memberikan akses dan layanan akan melakukan pemeriksaan POSIX ACL tambahan untuk menentukan apakah pengguna ini berwenang untuk melakukan operasi yang diminta.

correlation_id
str

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

encryption_scope
str

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

Mengembalikan

Token Tanda Tangan Akses Bersama (sas).

Tipe hasil

str

generate_file_system_sas

Menghasilkan tanda tangan akses bersama untuk sistem file.

Gunakan tanda tangan yang dikembalikan dengan parameter info masuk dari DataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient atau DataLakeFileClient.

generate_file_system_sas(account_name: str, file_system_name: str, credential: str | UserDelegationKey, permission: FileSystemSasPermissions | str | None = None, expiry: datetime | str | None = None, **kwargs: Any) -> str

Parameter

account_name
str
Diperlukan

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

file_system_name
str
Diperlukan

Nama sistem file.

credential
str atau UserDelegationKey
Diperlukan

Kredensial dapat berupa kunci akun atau kunci delegasi pengguna. Jika menggunakan kunci akun digunakan sebagai kredensial, maka jenis kredensial harus str. Alih-alih kunci akun, pengguna juga dapat meneruskan kunci delegasi pengguna. Kunci delegasi pengguna dapat diperoleh dari layanan dengan mengautentikasi dengan identitas AAD; ini dapat dicapai dengan memanggil get_user_delegation_key. Saat ada, SAS ditandatangani dengan kunci delegasi pengguna sebagai gantinya.

permission
str atau FileSystemSasPermissions
nilai default: None

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

expiry
datetime atau str
nilai default: None

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

start
datetime atau str

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 ip=168.1.5.65 atau ip=168.1.5.60-168.1.5.70 pada SAS membatasi permintaan ke alamat IP tersebut.

protocol
str

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

cache_control
str

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

content_disposition
str

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

content_encoding
str

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

content_language
str

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

content_type
str

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

preauthorized_agent_object_id
str

ID objek AAD dari pengguna diasumsikan diotorisasi oleh pemilik kunci delegasi pengguna untuk melakukan tindakan yang diberikan oleh token SAS. Layanan ini akan memvalidasi token SAS dan memastikan bahwa pemilik kunci delegasi pengguna memiliki izin yang diperlukan sebelum memberikan akses tetapi tidak ada pemeriksaan izin tambahan untuk id objek agen yang akan dilakukan.

agent_object_id
str

ID objek AAD pengguna diasumsikan tidak sah oleh pemilik kunci delegasi pengguna untuk melakukan tindakan yang diberikan oleh token SAS. Layanan ini akan memvalidasi token SAS dan memastikan bahwa pemilik kunci delegasi pengguna memiliki izin yang diperlukan sebelum memberikan akses dan layanan akan melakukan pemeriksaan POSIX ACL tambahan untuk menentukan apakah pengguna ini berwenang untuk melakukan operasi yang diminta.

correlation_id
str

Id korelasi untuk menghubungkan log audit penyimpanan dengan log audit yang digunakan oleh perwakilan yang menghasilkan dan mendistribusikan SAS.

encryption_scope
str

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

Mengembalikan

Token Tanda Tangan Akses Bersama (sas).

Tipe hasil

str