SASQueryParametersOptions interface
خيارات لإنشاء SASQueryParameters.
الخصائص
| agent |
معرف كائن AAD غير مصرح به بتنسيق GUID. معرف عنصر AAD لمستخدم يفترض أنه غير مصرح به من قبل مالك مفتاح تفويض المستخدم. ستقوم خدمة تخزين Azure بإجراء فحص POSIX ACL إضافي لتحديد ما إذا كان المستخدم مخولا لتنفيذ العملية المطلوبة. لا يمكن استخدام هذا في conjuction مع <xref:signedAuthorizedUserObjectId>. يتم استخدام هذا فقط ل SAS تفويض المستخدم. |
| 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 تفويض المستخدم. |
| delegated |
Optional. بدءا من الإصدار 2025-07-05، تحدد هذه القيمة معرف إنترا للمستخدم المخول لاستخدام رابط SAS الناتج. يجب استخدام رابط SAS الناتج مع رمز Entra ID الذي تم إصداره للمستخدم المحدد في هذه القيمة. |
| directory |
الإشارة إلى عمق الدليل المحدد في حقل canonicalizedresource من سلسلة إلى توقيع. عمق الدليل هو عدد الدلائل أسفل المجلد الجذر. |
| encryption |
Optional. نطاق التشفير لاستخدامه عند إرسال الطلبات المعتمدة مع SAS URI هذا. |
| expires |
اختياري فقط عند توفير المعرف. وقت انتهاء صلاحية رمز SAS المميز هذا. |
| identifier | Optional. المعرف الموقع (فقط <xref:BlobSASSignatureValues>). راجع https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy |
| ip |
Optional. نطاقات IP المسموح بها في SAS هذا. |
| permissions | اختياري فقط عند توفير المعرف. يرجى الرجوع إلى AccountSASPermissionsأو <xref:BlobSASPermissions>أو <xref:ContainerSASPermissions> لمزيد من التفاصيل. |
| preauthorized |
معرف عنصر AAD المعتمد بتنسيق GUID. معرف كائن AAD لمستخدم مخول من قبل مالك مفتاح تفويض المستخدم لتنفيذ الإجراء الممنوح من قبل SAS. ستضمن خدمة Azure Storage أن مالك مفتاح تفويض المستخدم لديه الأذونات المطلوبة قبل منح الوصول ولكن لن يتم إجراء فحص إذن إضافي للمستخدم المحدد في هذه القيمة. لا يمكن استخدام هذا في conjuction مع <xref:signedUnauthorizedUserObjectId>. يتم استخدام هذا فقط ل SAS تفويض المستخدم. |
| protocol | Optional. بروتوكول (بروتوكولات) HTTP المسموح بها. |
| resource | Optional. تحديد الموارد التي يمكن الوصول إليها عبر SAS (فقط <xref:BlobSASSignatureValues>). |
| resource |
Optional. أنواع موارد التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى AccountSASResourceTypes لمزيد من التفاصيل. |
| services | Optional. خدمات التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى AccountSASServices للحصول على مزيد من التفاصيل. |
| starts |
Optional. وقت بدء رمز SAS المميز هذا. |
| user |
خصائص مفتاح تفويض المستخدم. |
تفاصيل الخاصية
agentObjectId
معرف كائن AAD غير مصرح به بتنسيق GUID. معرف عنصر AAD لمستخدم يفترض أنه غير مصرح به من قبل مالك مفتاح تفويض المستخدم. ستقوم خدمة تخزين Azure بإجراء فحص POSIX ACL إضافي لتحديد ما إذا كان المستخدم مخولا لتنفيذ العملية المطلوبة. لا يمكن استخدام هذا في conjuction مع <xref:signedAuthorizedUserObjectId>. يتم استخدام هذا فقط ل SAS تفويض المستخدم.
agentObjectId?: string
قيمة الخاصية
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
delegatedUserObjectId
Optional. بدءا من الإصدار 2025-07-05، تحدد هذه القيمة معرف إنترا للمستخدم المخول لاستخدام رابط SAS الناتج. يجب استخدام رابط SAS الناتج مع رمز Entra ID الذي تم إصداره للمستخدم المحدد في هذه القيمة.
delegatedUserObjectId?: string
قيمة الخاصية
string
directoryDepth
الإشارة إلى عمق الدليل المحدد في حقل canonicalizedresource من سلسلة إلى توقيع. عمق الدليل هو عدد الدلائل أسفل المجلد الجذر.
directoryDepth?: number
قيمة الخاصية
number
encryptionScope
Optional. نطاق التشفير لاستخدامه عند إرسال الطلبات المعتمدة مع SAS URI هذا.
encryptionScope?: string
قيمة الخاصية
string
expiresOn
اختياري فقط عند توفير المعرف. وقت انتهاء صلاحية رمز SAS المميز هذا.
expiresOn?: Date
قيمة الخاصية
Date
identifier
Optional. المعرف الموقع (فقط <xref:BlobSASSignatureValues>).
راجع https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy
identifier?: string
قيمة الخاصية
string
ipRange
permissions
اختياري فقط عند توفير المعرف. يرجى الرجوع إلى AccountSASPermissionsأو <xref:BlobSASPermissions>أو <xref:ContainerSASPermissions> لمزيد من التفاصيل.
permissions?: string
قيمة الخاصية
string
preauthorizedAgentObjectId
معرف عنصر AAD المعتمد بتنسيق GUID. معرف كائن AAD لمستخدم مخول من قبل مالك مفتاح تفويض المستخدم لتنفيذ الإجراء الممنوح من قبل SAS. ستضمن خدمة Azure Storage أن مالك مفتاح تفويض المستخدم لديه الأذونات المطلوبة قبل منح الوصول ولكن لن يتم إجراء فحص إذن إضافي للمستخدم المحدد في هذه القيمة. لا يمكن استخدام هذا في conjuction مع <xref:signedUnauthorizedUserObjectId>. يتم استخدام هذا فقط ل SAS تفويض المستخدم.
preauthorizedAgentObjectId?: string
قيمة الخاصية
string
protocol
resource
Optional. تحديد الموارد التي يمكن الوصول إليها عبر SAS (فقط <xref:BlobSASSignatureValues>).
resource?: string
قيمة الخاصية
string
resourceTypes
Optional. أنواع موارد التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى AccountSASResourceTypes لمزيد من التفاصيل.
resourceTypes?: string
قيمة الخاصية
string
services
Optional. خدمات التخزين التي يتم الوصول إليها (فقط لحساب SAS). يرجى الرجوع إلى AccountSASServices للحصول على مزيد من التفاصيل.
services?: string
قيمة الخاصية
string
startsOn
Optional. وقت بدء رمز SAS المميز هذا.
startsOn?: Date
قيمة الخاصية
Date