SASQueryParameters class
يمثل المكونات التي تشكل معلمات استعلام AZURE Storage SAS. لا يتم إنشاء هذا النوع مباشرة من قبل المستخدم؛ يتم إنشاؤه فقط بواسطة <xref:AccountSASSignatureValues> الأنواع و <xref:BlobSASSignatureValues> . بمجرد إنشائه، يمكن ترميزه في <xref:String> وإلحاقه بعنوان URL مباشرة (على الرغم من أنه يجب توخي الحذر هنا في حالة وجود معلمات استعلام موجودة، والتي قد تؤثر على الوسائل المناسبة لإلحاق معلمات الاستعلام هذه). ملاحظة: مثيلات هذه الفئة غير قابلة للتغيير.
المنشئون
SASQuery |
إنشاء مثيل SASQueryParameters. |
SASQuery |
إنشاء مثيل SASQueryParameters. |
الخصائص
cache |
قيمة عنوان التحكم في ذاكرة التخزين المؤقت في Blob/File Service SAS. |
content |
قيمة عنوان ترتيب المحتوى في BLOB/File Service SAS. |
content |
قيمة عنوان ترميز المحتوى في Blob/File Service SAS. |
content |
قيمة عنوان طول المحتوى في Blob/File Service SAS. |
content |
قيمة عنوان نوع المحتوى في Blob/File Service SAS. |
correlation |
قيمة GUID التي سيتم تسجيلها في سجلات تشخيص التخزين ويمكن استخدامها لربط إنشاء SAS بالوصول إلى موارد التخزين. يتم استخدام هذا فقط لتفويض المستخدم SAS. |
expires |
اختياري فقط عند توفير المعرف. وقت انتهاء صلاحية رمز SAS المميز هذا. |
identifier | اختياري. المعرف الموقع (فقط ل <xref:BlobSASSignatureValues>). |
ip |
اختياري. نطاق IP المسموح به ل SAS هذا. |
permissions | اختياري فقط عند توفير المعرف. يرجى الرجوع إلى <xref:AccountSASPermissions>أو <xref:BlobSASPermissions>أو <xref:ContainerSASPermissions> لمزيد من التفاصيل. |
preauthorized |
معرف عنصر AAD المعتمد بتنسيق GUID. معرف عنصر AAD لمستخدم مصرح به من قبل مالك مفتاح تفويض المستخدم لتنفيذ الإجراء الممنوح من قبل SAS. ستضمن خدمة Azure Storage أن مالك مفتاح تفويض المستخدم لديه الأذونات المطلوبة قبل منح حق الوصول ولكن لن يتم إجراء فحص إذن إضافي للمستخدم المحدد في هذه القيمة. يتم استخدام هذا فقط لتفويض المستخدم SAS. |
protocol | اختياري. بروتوكول (بروتوكولات) HTTP المسموح بها. |
resource | اختياري. يحدد الموارد التي يمكن الوصول إليها عبر SAS (فقط ل <xref:BlobSASSignatureValues>). |
resource |
اختياري. أنواع موارد التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى <xref:AccountSASResourceTypes> لمزيد من التفاصيل. |
services | اختياري. خدمات التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى <xref:AccountSASServices> لمزيد من التفاصيل. |
signature | توقيع رمز SAS المميز. |
starts |
اختياري. وقت بدء رمز SAS المميز هذا. |
version | إصدار واجهة برمجة تطبيقات التخزين. |
الأساليب
to |
ترميز جميع معلمات استعلام SAS في سلسلة يمكن إلحاقها بعنوان URL. |
تفاصيل المنشئ
SASQueryParameters(string, string, SASQueryParametersOptions)
إنشاء مثيل SASQueryParameters.
new SASQueryParameters(version: string, signature: string, options?: SASQueryParametersOptions)
المعلمات
- version
-
string
تمثيل إصدار التخزين
- signature
-
string
تمثيل توقيع رمز SAS المميز
- options
- SASQueryParametersOptions
اختياري. خيارات لإنشاء SASQueryParameters.
SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, 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)
المعلمات
- 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)
تفاصيل الخاصية
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
expiresOn
اختياري فقط عند توفير المعرف. وقت انتهاء صلاحية رمز SAS المميز هذا.
expiresOn?: Date
قيمة الخاصية
Date
identifier
اختياري. المعرف الموقع (فقط ل <xref:BlobSASSignatureValues>).
identifier?: string
قيمة الخاصية
string
ipRange
اختياري. نطاق IP المسموح به ل SAS هذا.
SasIPRange | undefined ipRange
قيمة الخاصية
SasIPRange | undefined
permissions
اختياري فقط عند توفير المعرف. يرجى الرجوع إلى <xref:AccountSASPermissions>أو <xref:BlobSASPermissions>أو <xref:ContainerSASPermissions> لمزيد من التفاصيل.
permissions?: string
قيمة الخاصية
string
preauthorizedAgentObjectId
معرف عنصر AAD المعتمد بتنسيق GUID. معرف عنصر AAD لمستخدم مصرح به من قبل مالك مفتاح تفويض المستخدم لتنفيذ الإجراء الممنوح من قبل SAS. ستضمن خدمة Azure Storage أن مالك مفتاح تفويض المستخدم لديه الأذونات المطلوبة قبل منح حق الوصول ولكن لن يتم إجراء فحص إذن إضافي للمستخدم المحدد في هذه القيمة. يتم استخدام هذا فقط لتفويض المستخدم SAS.
preauthorizedAgentObjectId?: string
قيمة الخاصية
string
protocol
resource
اختياري. يحدد الموارد التي يمكن الوصول إليها عبر SAS (فقط ل <xref:BlobSASSignatureValues>).
resource?: string
قيمة الخاصية
string
resourceTypes
اختياري. أنواع موارد التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى <xref:AccountSASResourceTypes> لمزيد من التفاصيل.
resourceTypes?: string
قيمة الخاصية
string
services
اختياري. خدمات التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى <xref:AccountSASServices> لمزيد من التفاصيل.
services?: string
قيمة الخاصية
string
signature
توقيع رمز SAS المميز.
signature: string
قيمة الخاصية
string
startsOn
اختياري. وقت بدء رمز SAS المميز هذا.
startsOn?: Date
قيمة الخاصية
Date
version
إصدار واجهة برمجة تطبيقات التخزين.
version: string
قيمة الخاصية
string
تفاصيل الأسلوب
toString()
ترميز جميع معلمات استعلام SAS في سلسلة يمكن إلحاقها بعنوان URL.
function toString()
المرتجعات
string
Azure SDK for JavaScript
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ