SASQueryParameters class

الحزمة:

@azure/storage-blob

يمثل المكونات التي تشكل معلمات استعلام AZURE Storage SAS. لا يتم إنشاء هذا النوع مباشرة من قبل المستخدم؛ يتم إنشاؤه فقط بواسطة AccountSASSignatureValues وأنواع BlobSASSignatureValues. بمجرد إنشائه، يمكن ترميزه في toString() وإلحاقه بعنوان URL مباشرة (على الرغم من أنه يجب توخي الحذر هنا في حالة وجود معلمات استعلام، والتي قد تؤثر على الوسائل المناسبة لإلحاق معلمات الاستعلام هذه).

ملاحظة: مثيلات هذه الفئة غير قابلة للتغيير.

المنشئون

SASQueryParameters(string, string, SASQueryParametersOptions)	إنشاء مثيل SASQueryParameters.
SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, string, string, string)	إنشاء مثيل SASQueryParameters.

الخصائص

cacheControl	قيمة عنوان التحكم في ذاكرة التخزين المؤقت في Blob/File Service SAS.
contentDisposition	قيمة رأس ترتيب المحتوى في Blob/File Service SAS.
contentEncoding	قيمة عنوان ترميز المحتوى في BLOB/File Service SAS.
contentLanguage	قيمة عنوان طول المحتوى في Blob/File Service SAS.
contentType	قيمة رأس نوع المحتوى في Blob/File Service SAS.
correlationId	قيمة GUID التي سيتم تسجيلها في سجلات تشخيص التخزين ويمكن استخدامها لربط إنشاء SAS بالوصول إلى موارد التخزين. يتم استخدام هذا فقط ل SAS تفويض المستخدم.
encryptionScope	Optional. نطاق التشفير لاستخدامه عند إرسال الطلبات المعتمدة مع SAS URI هذا.
expiresOn	اختياري فقط عند توفير المعرف. وقت انتهاء صلاحية رمز SAS المميز هذا.
identifier	Optional. المعرف الموقع (فقط BlobSASSignatureValues). راجع https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy
ipRange	Optional. نطاق IP المسموح به ل SAS هذا.
permissions	اختياري فقط عند توفير المعرف. يرجى الرجوع إلى AccountSASPermissionsأو BlobSASPermissionsأو ContainerSASPermissions لمزيد من التفاصيل.
preauthorizedAgentObjectId	معرف عنصر AAD المعتمد بتنسيق GUID. معرف كائن AAD لمستخدم مخول من قبل مالك مفتاح تفويض المستخدم لتنفيذ الإجراء الممنوح من قبل SAS. ستضمن خدمة Azure Storage أن مالك مفتاح تفويض المستخدم لديه الأذونات المطلوبة قبل منح الوصول ولكن لن يتم إجراء فحص إذن إضافي للمستخدم المحدد في هذه القيمة. يتم استخدام هذا فقط ل SAS تفويض المستخدم.
protocol	Optional. بروتوكول (بروتوكولات) HTTP المسموح بها.
resource	Optional. تحديد الموارد التي يمكن الوصول إليها عبر SAS (فقط BlobSASSignatureValues). راجع https://learn.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only
resourceTypes	Optional. أنواع موارد التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى AccountSASResourceTypes لمزيد من التفاصيل.
services	Optional. خدمات التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى AccountSASServices للحصول على مزيد من التفاصيل.
signature	توقيع رمز SAS المميز.
startsOn	Optional. وقت بدء رمز SAS المميز هذا.
version	إصدار واجهة برمجة تطبيقات التخزين.

الأساليب

toString()

ترميز كافة معلمات استعلام SAS في سلسلة يمكن إلحاقها بعنوان URL.

تفاصيل المنشئ

SASQueryParameters(string, string, SASQueryParametersOptions)

إنشاء مثيل SASQueryParameters.

new SASQueryParameters(version: string, signature: string, options?: SASQueryParametersOptions)

المعلمات

version

string

تمثيل إصدار التخزين

signature

string

تمثيل توقيع رمز SAS المميز

options

SASQueryParametersOptions

Optional. خيارات لإنشاء SASQueryParameters.

SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, string, string, string)

إنشاء مثيل 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)

المعلمات

version

string

تمثيل إصدار التخزين

signature

string

تمثيل توقيع رمز SAS المميز

permissions

string

تمثيل أذونات التخزين

services

string

تمثيل خدمات التخزين التي يتم الوصول إليها (فقط لحساب SAS)

resourceTypes

string

تمثيل أنواع موارد التخزين التي يتم الوصول إليها (فقط لحساب SAS)

protocol

SASProtocol

تمثيل بروتوكول (بروتوكولات) HTTP المسموح بها

startsOn

Date

يمثل وقت البدء رمز SAS المميز هذا

expiresOn

Date

يمثل وقت انتهاء صلاحية رمز SAS المميز هذا

ipRange

SasIPRange

تمثيل نطاق عناوين IP الصالحة رمز SAS المميز هذا

identifier

string

تمثيل المعرف الموقع (فقط لخدمة SAS)

resource

string

تمثيل حاوية التخزين أو الكائن الثنائي كبير الحجم (فقط لخدمة SAS)

cacheControl

string

تمثيل عنوان التحكم في ذاكرة التخزين المؤقت (فقط ل Blob/File Service SAS)

contentDisposition

string

تمثيل رأس ترتيب المحتوى (فقط ل Blob/File Service SAS)

contentEncoding

string

تمثيل رأس ترميز المحتوى (فقط ل BLOB/File Service SAS)

contentLanguage

string

تمثيل عنوان لغة المحتوى (فقط ل Blob/File Service SAS)

contentType

string

تمثيل رأس نوع المحتوى (فقط ل Blob/File Service SAS)

userDelegationKey

UserDelegationKey

تمثيل خصائص مفتاح تفويض المستخدم

preauthorizedAgentObjectId

string

تمثيل معرف كائن AAD المعتمد (فقط لتفويض المستخدم SAS)

correlationId

string

تمثيل معرف الارتباط (فقط ل SAS لتفويض المستخدم)

encryptionScope

string

تفاصيل الخاصية

cacheControl

قيمة عنوان التحكم في ذاكرة التخزين المؤقت في Blob/File Service SAS.

cacheControl?: string

قيمة الخاصية

string

contentDisposition

قيمة رأس ترتيب المحتوى في Blob/File Service SAS.

contentDisposition?: string

قيمة الخاصية

string

contentEncoding

قيمة عنوان ترميز المحتوى في BLOB/File Service SAS.

contentEncoding?: string

قيمة الخاصية

string

contentLanguage

قيمة عنوان طول المحتوى في Blob/File Service SAS.

contentLanguage?: string

قيمة الخاصية

string

contentType

قيمة رأس نوع المحتوى في Blob/File Service SAS.

contentType?: string

قيمة الخاصية

string

correlationId

قيمة GUID التي سيتم تسجيلها في سجلات تشخيص التخزين ويمكن استخدامها لربط إنشاء SAS بالوصول إلى موارد التخزين. يتم استخدام هذا فقط ل SAS تفويض المستخدم.

correlationId?: string

قيمة الخاصية

string

encryptionScope

Optional. نطاق التشفير لاستخدامه عند إرسال الطلبات المعتمدة مع SAS URI هذا.

encryptionScope?: string

قيمة الخاصية

string

expiresOn

اختياري فقط عند توفير المعرف. وقت انتهاء صلاحية رمز SAS المميز هذا.

expiresOn?: Date

قيمة الخاصية

Date

identifier

Optional. المعرف الموقع (فقط BlobSASSignatureValues).

راجع https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy

identifier?: string

قيمة الخاصية

string

ipRange

Optional. نطاق IP المسموح به ل SAS هذا.

undefined | SasIPRange ipRange

قيمة الخاصية

undefined | SasIPRange

permissions

اختياري فقط عند توفير المعرف. يرجى الرجوع إلى AccountSASPermissionsأو BlobSASPermissionsأو ContainerSASPermissions لمزيد من التفاصيل.

permissions?: string

قيمة الخاصية

string

preauthorizedAgentObjectId

معرف عنصر AAD المعتمد بتنسيق GUID. معرف كائن AAD لمستخدم مخول من قبل مالك مفتاح تفويض المستخدم لتنفيذ الإجراء الممنوح من قبل SAS. ستضمن خدمة Azure Storage أن مالك مفتاح تفويض المستخدم لديه الأذونات المطلوبة قبل منح الوصول ولكن لن يتم إجراء فحص إذن إضافي للمستخدم المحدد في هذه القيمة. يتم استخدام هذا فقط ل SAS تفويض المستخدم.

preauthorizedAgentObjectId?: string

قيمة الخاصية

string

protocol

Optional. بروتوكول (بروتوكولات) HTTP المسموح بها.

protocol?: SASProtocol

قيمة الخاصية

SASProtocol

resource

Optional. تحديد الموارد التي يمكن الوصول إليها عبر SAS (فقط BlobSASSignatureValues).

راجع https://learn.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only

resource?: string

قيمة الخاصية

string

resourceTypes

Optional. أنواع موارد التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى AccountSASResourceTypes لمزيد من التفاصيل.

resourceTypes?: string

قيمة الخاصية

string

services

Optional. خدمات التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى AccountSASServices للحصول على مزيد من التفاصيل.

services?: string

قيمة الخاصية

string

signature

توقيع رمز SAS المميز.

signature: string

قيمة الخاصية

string

startsOn

Optional. وقت بدء رمز SAS المميز هذا.

startsOn?: Date

قيمة الخاصية

Date

version

إصدار واجهة برمجة تطبيقات التخزين.

version: string

قيمة الخاصية

string

تفاصيل الأسلوب

toString()

ترميز كافة معلمات استعلام SAS في سلسلة يمكن إلحاقها بعنوان URL.

function toString(): string

المرتجعات

string