SASQueryParameters class
Mewakili komponen yang membentuk parameter kueri Azure Storage SAS. Jenis ini tidak dibangun langsung oleh pengguna; ini hanya dihasilkan oleh jenis AccountSASSignatureValues dan BlobSASSignatureValues . Setelah dibuat, itu dapat dikodekan ke dalam toString() dan ditambahkan ke URL secara langsung (meskipun hati-hati harus diambil di sini jika ada parameter kueri yang ada, yang mungkin memengaruhi cara yang sesuai untuk menambahkan parameter kueri ini).
CATATAN: Instans kelas ini tidak dapat diubah.
Konstruktor
SASQuery |
Membuat instans SASQueryParameters. |
SASQuery |
Membuat instans SASQueryParameters. |
Properti
cache |
Nilai untuk header cache-control di Blob/File Service SAS. |
content |
Nilai untuk header disposisi konten di Blob/File Service SAS. |
content |
Nilai untuk header pengodean konten di Blob/File Service SAS. |
content |
Nilai untuk header panjang konten di SaS Blob/File Service. |
content |
Nilai untuk header jenis konten di SaS Blob/File Service. |
correlation |
Nilai GUID yang akan dicatat dalam log diagnostik penyimpanan dan dapat digunakan untuk menghubungkan pembuatan SAS dengan akses sumber daya penyimpanan. Ini hanya digunakan untuk Delegasi Pengguna SAS. |
encryption |
Pilihan. Cakupan enkripsi untuk digunakan saat mengirim permintaan yang diotorisasi dengan URI SAS ini. |
expires |
Opsional hanya ketika pengidentifikasi disediakan. Waktu kedaluwarsa untuk token SAS ini. |
identifier | Pilihan. Pengidentifikasi yang ditandatangani (hanya untuk BlobSASSignatureValues). Lihat https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy |
ip |
Pilihan. Rentang IP diperbolehkan untuk SAS ini. |
permissions | Opsional hanya ketika pengidentifikasi disediakan. Silakan merujuk ke AccountSASPermissions, BlobSASPermissions, atau ContainerSASPermissions untuk detail selengkapnya. |
preauthorized |
ID Objek AAD resmi dalam format GUID. ID Objek AAD pengguna yang diotorisasi oleh pemilik Kunci Delegasi Pengguna untuk melakukan tindakan yang diberikan oleh SAS. Layanan Azure Storage akan memastikan bahwa pemilik kunci delegasi pengguna memiliki izin yang diperlukan sebelum memberikan akses tetapi tidak ada pemeriksaan izin tambahan untuk pengguna yang ditentukan dalam nilai ini yang akan dilakukan. Ini hanya digunakan untuk Delegasi Pengguna SAS. |
protocol | Pilihan. Protokol HTTP yang diizinkan. |
resource | Pilihan. Menentukan sumber daya mana yang dapat diakses melalui SAS (hanya untuk BlobSASSSignatureValues). |
resource |
Opsional. Jenis sumber daya penyimpanan yang diakses (hanya untuk SAS Akun). Silakan merujuk ke AccountSASResourceTypes untuk detail selengkapnya. |
services | Pilihan. Layanan penyimpanan sedang diakses (hanya untuk AKUN SAS). Silakan merujuk ke AccountSASServices untuk detail selengkapnya. |
signature | Tanda tangan untuk token SAS. |
starts |
Opsional. Waktu mulai untuk token SAS ini. |
version | Versi API penyimpanan. |
Metode
to |
Mengodekan semua parameter kueri SAS ke dalam string yang dapat ditambahkan ke URL. |
Detail Konstruktor
SASQueryParameters(string, string, SASQueryParametersOptions)
Membuat instans SASQueryParameters.
new SASQueryParameters(version: string, signature: string, options?: SASQueryParametersOptions)
Parameter
- version
-
string
Mewakili versi penyimpanan
- signature
-
string
Mewakili tanda tangan untuk token SAS
- options
- SASQueryParametersOptions
Pilihan. Opsi untuk membuat SASQueryParameters.
SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, string, string, string)
Membuat instans SASQueryParameters.
new SASQueryParameters(version: string, signature: string, permissions?: string, services?: string, resourceTypes?: string, protocol?: SASProtocol, startsOn?: Date, expiresOn?: Date, ipRange?: SasIPRange, identifier?: string, resource?: string, cacheControl?: string, contentDisposition?: string, contentEncoding?: string, contentLanguage?: string, contentType?: string, userDelegationKey?: UserDelegationKey, preauthorizedAgentObjectId?: string, correlationId?: string, encryptionScope?: string)
Parameter
- version
-
string
Mewakili versi penyimpanan
- signature
-
string
Mewakili tanda tangan untuk token SAS
- permissions
-
string
Mewakili izin penyimpanan
- services
-
string
Mewakili layanan penyimpanan yang diakses (hanya untuk SAS Akun)
- resourceTypes
-
string
Mewakili jenis sumber daya penyimpanan yang sedang diakses (hanya untuk SAS Akun)
- protocol
- SASProtocol
Mewakili protokol HTTP yang diizinkan
- startsOn
-
Date
Mewakili waktu mulai untuk token SAS ini
- expiresOn
-
Date
Mewakili waktu kedaluwarsa untuk token SAS ini
- ipRange
- SasIPRange
Mewakili rentang alamat IP yang valid untuk token SAS ini
- identifier
-
string
Mewakili pengidentifikasi yang ditandatangani (hanya untuk SaS Layanan)
- resource
-
string
Mewakili kontainer penyimpanan atau blob (hanya untuk SaS Layanan)
- cacheControl
-
string
Mewakili header kontrol cache (hanya untuk SAS Blob/File Service)
- contentDisposition
-
string
Mewakili header disposisi konten (hanya untuk SaS Blob/File Service)
- contentEncoding
-
string
Mewakili header pengodean konten (hanya untuk SAS Blob/File Service)
- contentLanguage
-
string
Mewakili header bahasa konten (hanya untuk SaS Blob/File Service)
- contentType
-
string
Mewakili header jenis konten (hanya untuk SaS Blob/File Service)
- userDelegationKey
- UserDelegationKey
Mewakili properti kunci delegasi pengguna
- preauthorizedAgentObjectId
-
string
Mewakili ID Objek AAD resmi (hanya untuk SAS Delegasi Pengguna)
- correlationId
-
string
Mewakili ID korelasi (hanya untuk Delegasi Pengguna SAS)
- encryptionScope
-
string
Detail Properti
cacheControl
Nilai untuk header cache-control di Blob/File Service SAS.
cacheControl?: string
Nilai Properti
string
contentDisposition
Nilai untuk header disposisi konten di Blob/File Service SAS.
contentDisposition?: string
Nilai Properti
string
contentEncoding
Nilai untuk header pengodean konten di Blob/File Service SAS.
contentEncoding?: string
Nilai Properti
string
contentLanguage
Nilai untuk header panjang konten di SaS Blob/File Service.
contentLanguage?: string
Nilai Properti
string
contentType
Nilai untuk header jenis konten di SaS Blob/File Service.
contentType?: string
Nilai Properti
string
correlationId
Nilai GUID yang akan dicatat dalam log diagnostik penyimpanan dan dapat digunakan untuk menghubungkan pembuatan SAS dengan akses sumber daya penyimpanan. Ini hanya digunakan untuk Delegasi Pengguna SAS.
correlationId?: string
Nilai Properti
string
encryptionScope
Pilihan. Cakupan enkripsi untuk digunakan saat mengirim permintaan yang diotorisasi dengan URI SAS ini.
encryptionScope?: string
Nilai Properti
string
expiresOn
Opsional hanya ketika pengidentifikasi disediakan. Waktu kedaluwarsa untuk token SAS ini.
expiresOn?: Date
Nilai Properti
Date
identifier
Pilihan. Pengidentifikasi yang ditandatangani (hanya untuk BlobSASSignatureValues).
Lihat https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy
identifier?: string
Nilai Properti
string
ipRange
Pilihan. Rentang IP diperbolehkan untuk SAS ini.
undefined | SasIPRange ipRange
Nilai Properti
undefined | SasIPRange
permissions
Opsional hanya ketika pengidentifikasi disediakan. Silakan merujuk ke AccountSASPermissions, BlobSASPermissions, atau ContainerSASPermissions untuk detail selengkapnya.
permissions?: string
Nilai Properti
string
preauthorizedAgentObjectId
ID Objek AAD resmi dalam format GUID. ID Objek AAD pengguna yang diotorisasi oleh pemilik Kunci Delegasi Pengguna untuk melakukan tindakan yang diberikan oleh SAS. Layanan Azure Storage akan memastikan bahwa pemilik kunci delegasi pengguna memiliki izin yang diperlukan sebelum memberikan akses tetapi tidak ada pemeriksaan izin tambahan untuk pengguna yang ditentukan dalam nilai ini yang akan dilakukan. Ini hanya digunakan untuk Delegasi Pengguna SAS.
preauthorizedAgentObjectId?: string
Nilai Properti
string
protocol
resource
Pilihan. Menentukan sumber daya mana yang dapat diakses melalui SAS (hanya untuk BlobSASSSignatureValues).
resource?: string
Nilai Properti
string
resourceTypes
Opsional. Jenis sumber daya penyimpanan yang diakses (hanya untuk SAS Akun). Silakan merujuk ke AccountSASResourceTypes untuk detail selengkapnya.
resourceTypes?: string
Nilai Properti
string
services
Pilihan. Layanan penyimpanan sedang diakses (hanya untuk AKUN SAS). Silakan merujuk ke AccountSASServices untuk detail selengkapnya.
services?: string
Nilai Properti
string
signature
Tanda tangan untuk token SAS.
signature: string
Nilai Properti
string
startsOn
Opsional. Waktu mulai untuk token SAS ini.
startsOn?: Date
Nilai Properti
Date
version
Versi API penyimpanan.
version: string
Nilai Properti
string
Detail Metode
toString()
Mengodekan semua parameter kueri SAS ke dalam string yang dapat ditambahkan ke URL.
function toString(): string
Mengembalikan
string