blob الحزمة

  • ‏‏المرجع

الحِزم

aio

الفصول

AccessPolicy

فئة نهج الوصول المستخدمة من قبل المجموعة والحصول على أساليب نهج الوصول في كل خدمة.

يمكن لنهج الوصول المخزن تحديد وقت البدء ووقت انتهاء الصلاحية والأذونات لتوقيعات الوصول المشترك المقترنة به. اعتمادا على الطريقة التي تريد بها التحكم في الوصول إلى المورد الخاص بك، يمكنك تحديد جميع هذه المعلمات ضمن نهج الوصول المخزن، وحذفها من عنوان URL لتوقيع الوصول المشترك. يسمح لك القيام بذلك بتعديل سلوك التوقيع المقترن في أي وقت، بالإضافة إلى إبطاله. أو يمكنك تحديد معلمة واحدة أو أكثر من معلمات نهج الوصول داخل نهج الوصول المخزن، والأخرى على عنوان URL. وأخيرا، يمكنك تحديد جميع المعلمات على عنوان URL. في هذه الحالة، يمكنك استخدام نهج الوصول المخزن لإبطال التوقيع، ولكن ليس لتعديل سلوكه.

يجب أن يتضمن كل من توقيع الوصول المشترك ونهج الوصول المخزن جميع الحقول المطلوبة لمصادقة التوقيع. إذا كانت هناك أي حقول مطلوبة مفقودة، فسيفشل الطلب. وبالمثل، إذا تم تحديد حقل في عنوان URL توقيع الوصول المشترك وفي نهج الوصول المخزن، فسيفشل الطلب مع رمز الحالة 400 (طلب غير صحيح).
AccountSasPermissions

ResourceTypes الفئة التي سيتم استخدامها مع دالة generate_account_sas و AccessPolicies المستخدمة مع set_*_acl. هناك نوعان من SAS التي يمكن استخدامها لمنح الوصول إلى الموارد. الأول هو منح حق الوصول إلى مورد معين (خاص بالموارد). آخر هو منح حق الوصول إلى الخدمة بأكملها لحساب معين والسماح بعمليات معينة استنادا إلى perms الموجودة هنا.
ArrowDialect

حقل مخطط سهم.

يجب ملء جميع المعلمات المطلوبة لإرسالها إلى Azure.
BlobAnalyticsLogging

إعدادات تسجيل Azure Analytics.
BlobBlock

فئة BlockBlob Block.
BlobClient

عميل للتفاعل مع كائن ثنائي كبير الحجم معين، على الرغم من أن هذا الكائن الثنائي كبير الحجم قد لا يكون موجودا بعد.

لمزيد من التكوين الاختياري، يرجى النقر هنا.
BlobLeaseClient

إنشاء BlobLeaseClient جديد.

يوفر هذا العميل عمليات التأجير على BlobClient أو ContainerClient.
BlobPrefix

قابل للتكبير من خصائص كائن ثنائي كبير الحجم.

يتم إرجاعه من walk_blobs عند استخدام محدد. يمكن اعتباره دليلا ظاهريا لكائن ثنائي كبير الحجم.
BlobProperties

خصائص الكائن الثنائي كبير الحجم.
BlobQueryError

حدث الخطأ أثناء عملية الاستعلام السريع.
BlobQueryReader

كائن دفق لقراءة نتائج الاستعلام.
BlobSasPermissions

فئة BlobSasPermissions لاستخدامها مع الدالة generate_blob_sas .
BlobServiceClient

عميل للتفاعل مع خدمة Blob على مستوى الحساب.

يوفر هذا العميل عمليات لاسترداد وتكوين خصائص الحساب بالإضافة إلى قائمة وإنشاء حاويات وحذفها داخل الحساب. بالنسبة للعمليات المتعلقة بحاوية أو كائن ثنائي كبير الحجم محدد، يمكن أيضا استرداد العملاء لهذه الكيانات باستخدام وظائف get_client .

لمزيد من التكوين الاختياري، يرجى النقر هنا.
ContainerClient

عميل للتفاعل مع حاوية معينة، على الرغم من أن هذه الحاوية قد لا تكون موجودة بعد.

بالنسبة للعمليات المتعلقة بكائن ثنائي كبير الحجم محدد داخل هذه الحاوية، يمكن استرداد عميل كائن ثنائي كبير الحجم باستخدام الدالة get_blob_client .

لمزيد من التكوين الاختياري، يرجى النقر هنا.
ContainerEncryptionScope

تكوين نطاق التشفير الافتراضي للحاوية.

يتم استخدام هذا النطاق ضمنيا لجميع عمليات الكتابة المستقبلية داخل الحاوية، ولكن يمكن تجاوزها لكل عملية كائن ثنائي كبير الحجم.

جديد في الإصدار 12.2.0.
ContainerProperties

فئة خصائص حاوية كائن ثنائي كبير الحجم.

تعرض المثيلات التي تم إرجاعها ContainerProperties هذه القيم من خلال واجهة قاموس، على سبيل المثال: container_props["last_modified"]. بالإضافة إلى ذلك، يتوفر اسم الحاوية ك container_props["name"].
ContainerSasPermissions

فئة ContainerSasPermissions لاستخدامها مع الدالة generate_container_sas و ل AccessPolicies المستخدمة مع set_container_access_policy.
ContentSettings

إعدادات المحتوى لكائن ثنائي كبير الحجم.
CopyProperties

خصائص نسخ كائن ثنائي كبير الحجم.

ستكون هذه الخصائص بلا إذا لم تكن هذه الكائن الثنائي كبير الحجم أبدا الوجهة في عملية نسخ كائن ثنائي كبير الحجم، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ كائن ثنائي كبير الحجم مختتمة، على سبيل المثال، باستخدام تعيين خصائص كائن ثنائي كبير الحجم أو تحميل كائن ثنائي كبير الحجم أو قائمة حظر التثبيت.
CorsRule

تُعد مشاركة الموارد عبر المنشأ (CORS) إحدى ميزات HTTP التي تمكّن تطبيق ويب يعمل ضمن مجال واحد للوصول إلى الموارد في مجال آخر. تعمل مستعرضات الويب على تطبيق قيود أمان تُعرف باسم نهج المنشأ ذاته الذي يمنع صفحة ويب من استدعاء واجهات برمجة التطبيقات في مجال آخر؛ وتوفر CORS طريقة آمنة للسماح لمجال واحد (مجال المنشأ) باستدعاء واجهات برمجة التطبيقات في مجال آخر.
CustomerProvidedEncryptionKey

يتم تشفير جميع البيانات في Azure Storage الثابتة باستخدام مفتاح تشفير على مستوى الحساب. في الإصدارات 2018-06-17 والإصدارات الأحدث، يمكنك إدارة المفتاح المستخدم لتشفير محتويات الكائن الثنائي كبير الحجم وبيانات تعريف التطبيق لكل كائن ثنائي كبير الحجم من خلال توفير مفتاح تشفير AES-256 في طلبات خدمة التخزين.

عند استخدام مفتاح يوفره العميل، لا يقوم Azure Storage بإدارة مفتاحك أو الاحتفاظ به. عند كتابة البيانات إلى كائن ثنائي كبير الحجم، يتم استخدام المفتاح المتوفر لتشفير بياناتك قبل كتابتها على القرص. تتم كتابة تجزئة SHA-256 لمفتاح التشفير جنبا إلى جنب مع محتويات الكائن الثنائي كبير الحجم، ويتم استخدامها للتحقق من أن جميع العمليات اللاحقة مقابل الكائن الثنائي كبير الحجم تستخدم نفس مفتاح التشفير. لا يمكن استخدام هذه التجزئة لاسترداد مفتاح التشفير أو فك تشفير محتويات الكائن الثنائي كبير الحجم. عند قراءة كائن ثنائي كبير الحجم، يتم استخدام المفتاح المتوفر لفك تشفير بياناتك بعد قراءتها من القرص. في كلتا الحالتين، يتم تجاهل مفتاح التشفير المقدم بشكل آمن بمجرد اكتمال عملية التشفير أو فك التشفير.
DelimitedJsonDialect

يحدد تسلسل JSON للإدخال أو الإخراج لاستعلام بيانات كائن ثنائي كبير الحجم.

محدد str للكلمة الأساسية: حرف فاصل السطر، القيمة الافتراضية هي '

'
DelimitedTextDialect

يحدد تسلسل الإدخال أو الإخراج المحدد (CSV) لطلب استعلام كائن ثنائي كبير الحجم.
ExponentialRetry

إعادة المحاولة الأسية.

إنشاء كائن إعادة محاولة أسي. يتم استخدام initial_backoff لإعادة المحاولة الأولى. تتم إعادة محاولة عمليات إعادة المحاولة اللاحقة بعد initial_backoff + increment_power^retry_count ثانية.
FilteredBlob

معلومات كائن ثنائي كبير الحجم من استدعاء واجهة برمجة تطبيقات Filter Blobs.
ImmutabilityPolicy

معلمات اختيارية لتعيين نهج الثبات للكائن الثنائي كبير الحجم أو لقطة كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم.

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
LeaseProperties

خصائص تأجير كائن ثنائي كبير الحجم.
LinearRetry

إعادة المحاولة الخطية.

إنشاء كائن إعادة محاولة خطي.
LocationMode

يحدد الموقع الذي يجب إرسال الطلب إليه. ينطبق هذا الوضع فقط على حسابات RA-GRS التي تسمح بالوصول الثانوي للقراءة. يجب أن تستخدم جميع أنواع الحسابات الأخرى PRIMARY.
Metrics

ملخص لإحصائيات الطلب التي تم تجميعها بواسطة واجهة برمجة التطبيقات في تجميعات الساعة أو الدقيقة للكائنات الثنائية كبيرة الحجم.
ObjectReplicationPolicy

معرف النهج ومعرف القاعدة المطبق على كائن ثنائي كبير الحجم.
ObjectReplicationRule

معرف النهج ومعرف القاعدة المطبق على كائن ثنائي كبير الحجم.
PageRange

نطاق الصفحة لكائن ثنائي كبير الحجم للصفحة.
PartialBatchErrorException

هناك فشل جزئي في عمليات الدفعة.
ResourceTypes

يحدد أنواع الموارد التي يمكن الوصول إليها باستخدام SAS للحساب.
RetentionPolicy

نهج الاستبقاء الذي يحدد المدة التي يجب أن تستمر فيها البيانات المقترنة.
StaticWebsite

الخصائص التي تمكن الحساب من استضافة موقع ويب ثابت.
StorageStreamDownloader

كائن دفق لتنزيله من Azure Storage.
UserDelegationKey

يمثل مفتاح تفويض مستخدم، يتم توفيره للمستخدم بواسطة Azure Storage استنادا إلى الرمز المميز للوصول إلى Azure Active Directory الخاص به.

يتم حفظ الحقول كسلاسل بسيطة حيث لا يتعين على المستخدم التفاعل مع هذا الكائن؛ لإنشاء SAS تعريف، يمكن للمستخدم ببساطة تمريره إلى واجهة برمجة التطبيقات الصحيحة.

التعدادات

ArrowType
BlobImmutabilityPolicyMode

يحدد وضع نهج الثبات لتعيينه على الكائن الثنائي كبير الحجم. يمكن إرجاع "قابل للتغيير" فقط بواسطة الخدمة، ولا يتم تعيينه إلى "قابل للتغيير".
BlobType
BlockState

أنواع كتلة كائن ثنائي كبير الحجم للكتلة.
PremiumPageBlobTier

يحدد طبقة كائن ثنائي كبير الحجم للصفحة لتعيين الكائن الثنائي كبير الحجم إلى. ينطبق هذا فقط على الكائنات الثنائية كبيرة الحجم للصفحة على حسابات التخزين المتميزة. يرجى إلقاء نظرة على: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets للحصول على معلومات مفصلة حول IOPS المقابلة ومعدل النقل لكل PageBlobTier.
PublicAccess

يحدد ما إذا كان يمكن الوصول إلى البيانات الموجودة في الحاوية بشكل عام ومستوى الوصول.
QuickQueryDialect

يحدد لهجة إدخال/إخراج الاستعلام السريع.
RehydratePriority

إذا كان كائن في حالة إعادة تحميل معلق، فسيتم إرجاع هذا العنوان مع أولوية إعادة التنشيق. القيم الصالحة عالية وقياسية.
SequenceNumberAction

إجراءات رقم التسلسل.
StandardBlobTier

يحدد طبقة الكائن الثنائي كبير الحجم لتعيين الكائن الثنائي كبير الحجم إلى. ينطبق هذا فقط على الكائنات الثنائية كبيرة الحجم للكتلة على حسابات التخزين القياسية.
StorageErrorCode

الوظائف

download_blob_from_url

قم بتنزيل محتويات كائن ثنائي كبير الحجم إلى ملف محلي أو دفق.

download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

المعلمات

blob_url
str
مطلوب

URI الكامل للكائن الثنائي كبير الحجم. يمكن أن يتضمن هذا أيضا رمز SAS المميز.

output
str أو <xref:<xref:writable stream.>>
مطلوب

حيث يجب تنزيل البيانات إليه. قد يكون هذا إما مسار ملف للكتابة إليه، أو مؤشر IO مفتوحا للكتابة إليه.

credential
القيمة الافتراضية: None

بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للكائن الثنائي كبير الحجم يحتوي بالفعل على رمز SAS المميز أو كان الكائن الثنائي كبير الحجم عاما. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل لفئة TokenCredentials من azure.identity. إذا كان عنوان URI للمورد يحتوي بالفعل على رمز SAS المميز، فسيتم تجاهل هذا لصالح بيانات اعتماد صريحة

  • باستثناء حالة AzureSasCredential، حيث سترفع رموز SAS المميزة المتعارضة ValueError. في حالة استخدام مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.
overwrite
bool

ما إذا كان يجب الكتابة فوق الملف المحلي إذا كان موجودا بالفعل. القيمة الافتراضية هي False - وفي هذه الحالة سيتم رفع ValueError إذا كان الملف موجودا بالفعل. إذا تم تعيينه إلى True، فسيتم إجراء محاولة للكتابة إلى الملف الموجود. إذا تم تمرير مقبض دفق، يتم تجاهل هذه القيمة.

max_concurrency
int

عدد الاتصالات المتوازية التي يجب تنزيلها.

offset
int

بداية نطاق البايت لاستخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. يجب تعيين إذا تم توفير الطول.

length
int

عدد وحدات البايت المراد قراءتها من الدفق. هذا اختياري، ولكن يجب توفيره للأداء الأمثل.

validate_content
bool

إذا كان صحيحا، تحسب تجزئة MD5 لكل جزء من الكائن الثنائي كبير الحجم. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https ك https (الافتراضي) سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم. لاحظ أيضا أنه إذا تم تمكينها، فلن يتم استخدام خوارزمية التحميل الفعالة للذاكرة، لأن حساب تجزئة MD5 يتطلب تخزين كتل كاملة مؤقتا، وبذلك يهزم الغرض من الخوارزمية الفعالة للذاكرة.

نوع الإرجاع

None

generate_account_sas

إنشاء توقيع وصول مشترك لخدمة الكائن الثنائي كبير الحجم.

استخدم التوقيع الذي تم إرجاعه مع معلمة بيانات الاعتماد لأي BlobServiceClient أو ContainerClient أو BlobClient.

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

المعلمات

account_name
str
مطلوب

اسم حساب التخزين المستخدم لإنشاء توقيع الوصول المشترك.

account_key
str
مطلوب

مفتاح الحساب، الذي يسمى أيضا المفتاح المشترك أو مفتاح الوصول، لإنشاء توقيع الوصول المشترك.

resource_types
str أو ResourceTypes
مطلوب

يحدد أنواع الموارد التي يمكن الوصول إليها باستخدام SAS للحساب.

permission
str أو AccountSasPermissions
مطلوب

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

expiry
datetime أو str
مطلوب

الوقت الذي يصبح فيه توقيع الوصول المشترك غير صالح. مطلوب ما لم يتم إعطاء معرف يشير إلى نهج وصول مخزن يحتوي على هذا الحقل. يجب حذف هذا الحقل إذا تم تحديده في نهج وصول مخزن مقترن. سيقوم Azure دائما بتحويل القيم إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC.

start
datetime أو str
القيمة الافتراضية: None

الوقت الذي يصبح فيه توقيع الوصول المشترك صالحا. إذا تم حذفه، يفترض أن يكون وقت بدء هذه المكالمة هو الوقت الذي تتلقى فيه خدمة التخزين الطلب. سيقوم Azure دائما بتحويل القيم إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC.

ip
str
القيمة الافتراضية: None

تحديد عنوان IP أو نطاق من عناوين IP التي يمكن قبول الطلبات منها. إذا كان عنوان IP الذي ينشأ منه الطلب لا يتطابق مع عنوان IP أو نطاق العنوان المحدد على رمز SAS المميز، فلن تتم مصادقة الطلب. على سبيل المثال، يؤدي تحديد ip=168.1.5.65 أو ip=168.1.5.60-168.1.5.70 على SAS إلى تقييد الطلب إلى عناوين IP هذه.

protocol
str

يحدد البروتوكول المسموح به لطلب تم إجراؤه. القيمة الافتراضية هي https.

encryption_scope
str

يحدد نطاق التشفير لطلب تم إجراؤه بحيث يتم تشفير جميع عمليات الكتابة.

المرتجعات

رمز مميز لتوقيع الوصول المشترك (sas).

نوع الإرجاع

str

generate_blob_sas

إنشاء توقيع وصول مشترك لكائن ثنائي كبير الحجم.

استخدم التوقيع الذي تم إرجاعه مع معلمة بيانات الاعتماد لأي BlobServiceClient أو ContainerClient أو BlobClient.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

المعلمات

account_name
str
مطلوب

اسم حساب التخزين المستخدم لإنشاء توقيع الوصول المشترك.

container_name
str
مطلوب

اسم الحاوية.

blob_name
str
مطلوب

اسم الكائن الثنائي كبير الحجم.

snapshot
str
القيمة الافتراضية: None

معرف لقطة كائن ثنائي كبير الحجم اختياري.

account_key
str
القيمة الافتراضية: None

مفتاح الحساب، الذي يسمى أيضا المفتاح المشترك أو مفتاح الوصول، لإنشاء توقيع الوصول المشترك. يجب تحديد إما account_key أو user_delegation_key .

user_delegation_key
UserDelegationKey
القيمة الافتراضية: None

بدلا من مفتاح مشترك للحساب، يمكن للمستخدم تمرير مفتاح تفويض المستخدم. يمكن الحصول على مفتاح تفويض المستخدم من الخدمة عن طريق المصادقة باستخدام هوية AAD؛ يمكن تحقيق ذلك عن طريق استدعاء get_user_delegation_key. عند الحضور، يتم توقيع SAS باستخدام مفتاح تفويض المستخدم بدلا من ذلك.

permission
str أو BlobSasPermissions
القيمة الافتراضية: None

الأذونات المقترنة بتوقيع الوصول المشترك. يقتصر المستخدم على العمليات المسموح بها بواسطة الأذونات. يجب طلب الأذونات racwdxytmei. مطلوب ما لم يتم إعطاء معرف يشير إلى نهج وصول مخزن يحتوي على هذا الحقل. يجب حذف هذا الحقل إذا تم تحديده في نهج وصول مخزن مقترن.

expiry
datetime أو str
القيمة الافتراضية: None

الوقت الذي يصبح فيه توقيع الوصول المشترك غير صالح. مطلوب ما لم يتم إعطاء معرف يشير إلى نهج وصول مخزن يحتوي على هذا الحقل. يجب حذف هذا الحقل إذا تم تحديده في نهج وصول مخزن مقترن. سيقوم Azure دائما بتحويل القيم إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC.

start
datetime أو str
القيمة الافتراضية: None

الوقت الذي يصبح فيه توقيع الوصول المشترك صالحا. إذا تم حذفه، يفترض أن يكون وقت بدء هذه المكالمة هو الوقت الذي تتلقى فيه خدمة التخزين الطلب. سيقوم Azure دائما بتحويل القيم إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC.

policy_id
str
القيمة الافتراضية: None

قيمة فريدة يصل طولها إلى 64 حرفا ترتبط بنهج وصول مخزن. لإنشاء نهج وصول مخزن، استخدم set_container_access_policy.

ip
str
القيمة الافتراضية: None

تحديد عنوان IP أو نطاق من عناوين IP التي يمكن قبول الطلبات منها. إذا كان عنوان IP الذي ينشأ منه الطلب لا يتطابق مع عنوان IP أو نطاق العنوان المحدد على رمز SAS المميز، فلن تتم مصادقة الطلب. على سبيل المثال، يؤدي تحديد ip=168.1.5.65 أو ip=168.1.5.60-168.1.5.70 على SAS إلى تقييد الطلب إلى عناوين IP هذه.

version_id
str

معرف إصدار كائن ثنائي كبير الحجم اختياري. تنطبق هذه المعلمة فقط على حسابات التخزين الممكنة للإصدار. لاحظ أن معلمة الاستعلام 'versionid' غير مضمنة في SAS الإخراج. لذلك، يرجى توفير المعلمة "version_id" لأي واجهات برمجة تطبيقات عند استخدام SAS الإخراج للعمل على إصدار معين.

جديد في الإصدار 12.4.0: تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات "2019-12-12".

protocol
str

يحدد البروتوكول المسموح به لطلب تم إجراؤه. القيمة الافتراضية هي https.

cache_control
str

قيمة عنوان الاستجابة Cache-Control عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_disposition
str

قيمة عنوان الاستجابة ل Content-Disposition عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_encoding
str

قيمة رأس الاستجابة لترميز المحتوى عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_language
str

قيمة عنوان الاستجابة ل Content-Language عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_type
str

قيمة عنوان الاستجابة لنوع المحتوى عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

encryption_scope
str

يحدد نطاق التشفير لطلب تم إجراؤه بحيث يتم تشفير جميع عمليات الكتابة.

correlation_id
str

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

المرتجعات

رمز مميز لتوقيع الوصول المشترك (sas).

نوع الإرجاع

str

generate_container_sas

إنشاء توقيع وصول مشترك لحاوية.

استخدم التوقيع الذي تم إرجاعه مع معلمة بيانات الاعتماد لأي BlobServiceClient أو ContainerClient أو BlobClient.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

المعلمات

account_name
str
مطلوب

اسم حساب التخزين المستخدم لإنشاء توقيع الوصول المشترك.

container_name
str
مطلوب

اسم الحاوية.

account_key
str
القيمة الافتراضية: None

مفتاح الحساب، الذي يسمى أيضا المفتاح المشترك أو مفتاح الوصول، لإنشاء توقيع الوصول المشترك. يجب تحديد إما account_key أو user_delegation_key .

user_delegation_key
UserDelegationKey
القيمة الافتراضية: None

بدلا من مفتاح مشترك للحساب، يمكن للمستخدم تمرير مفتاح تفويض المستخدم. يمكن الحصول على مفتاح تفويض المستخدم من الخدمة عن طريق المصادقة باستخدام هوية AAD؛ يمكن تحقيق ذلك عن طريق استدعاء get_user_delegation_key. عند الحضور، يتم توقيع SAS باستخدام مفتاح تفويض المستخدم بدلا من ذلك.

permission
str أو ContainerSasPermissions
القيمة الافتراضية: None

الأذونات المقترنة بتوقيع الوصول المشترك. يقتصر المستخدم على العمليات المسموح بها بواسطة الأذونات. يجب ترتيب الأذونات racwdxyltfmei. مطلوب ما لم يتم إعطاء معرف يشير إلى نهج وصول مخزن يحتوي على هذا الحقل. يجب حذف هذا الحقل إذا تم تحديده في نهج وصول مخزن مقترن.

expiry
datetime أو str
القيمة الافتراضية: None

الوقت الذي يصبح فيه توقيع الوصول المشترك غير صالح. مطلوب ما لم يتم إعطاء معرف يشير إلى نهج وصول مخزن يحتوي على هذا الحقل. يجب حذف هذا الحقل إذا تم تحديده في نهج وصول مخزن مقترن. سيقوم Azure دائما بتحويل القيم إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC.

start
datetime أو str
القيمة الافتراضية: None

الوقت الذي يصبح فيه توقيع الوصول المشترك صالحا. إذا تم حذفه، يفترض أن يكون وقت بدء هذه المكالمة هو الوقت الذي تتلقى فيه خدمة التخزين الطلب. سيقوم Azure دائما بتحويل القيم إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC.

policy_id
str
القيمة الافتراضية: None

قيمة فريدة يصل طولها إلى 64 حرفا ترتبط بنهج وصول مخزن. لإنشاء نهج وصول مخزن، استخدم set_container_access_policy.

ip
str
القيمة الافتراضية: None

تحديد عنوان IP أو نطاق من عناوين IP التي يمكن قبول الطلبات منها. إذا كان عنوان IP الذي ينشأ منه الطلب لا يتطابق مع عنوان IP أو نطاق العنوان المحدد على رمز SAS المميز، فلن تتم مصادقة الطلب. على سبيل المثال، يؤدي تحديد ip=168.1.5.65 أو ip=168.1.5.60-168.1.5.70 على SAS إلى تقييد الطلب إلى عناوين IP هذه.

protocol
str

يحدد البروتوكول المسموح به لطلب تم إجراؤه. القيمة الافتراضية هي https.

cache_control
str

قيمة عنوان الاستجابة Cache-Control عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_disposition
str

قيمة عنوان الاستجابة ل Content-Disposition عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_encoding
str

قيمة رأس الاستجابة لترميز المحتوى عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_language
str

قيمة عنوان الاستجابة ل Content-Language عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_type
str

قيمة عنوان الاستجابة لنوع المحتوى عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

encryption_scope
str

يحدد نطاق التشفير لطلب تم إجراؤه بحيث يتم تشفير جميع عمليات الكتابة.

correlation_id
str

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

المرتجعات

رمز مميز لتوقيع الوصول المشترك (sas).

نوع الإرجاع

str

upload_blob_to_url

تحميل البيانات إلى عنوان URL معين

سيتم تحميل البيانات ككائن ثنائي كبير الحجم للكتلة.

upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> Dict[str, Any]

المعلمات

blob_url
str
مطلوب

URI الكامل للكائن الثنائي كبير الحجم. يمكن أن يتضمن هذا أيضا رمز SAS المميز.

data
bytes أو str أو Iterable
مطلوب

البيانات المراد تحميلها. يمكن أن يكون هذا وحدات البايت أو النص أو عنصر قابلا للتكسير أو كائنا يشبه الملف.

credential
القيمة الافتراضية: None

بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للكائن الثنائي كبير الحجم يحتوي بالفعل على رمز SAS المميز. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل لفئة TokenCredentials من azure.identity. إذا كان عنوان URI للمورد يحتوي بالفعل على رمز SAS المميز، فسيتم تجاهل هذا لصالح بيانات اعتماد صريحة

  • باستثناء حالة AzureSasCredential، حيث سترفع رموز SAS المميزة المتعارضة ValueError. في حالة استخدام مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.
overwrite
bool

ما إذا كان يجب أن يقوم الكائن الثنائي كبير الحجم الذي سيتم تحميله بالكتابة فوق البيانات الحالية. إذا كان True، فسيستبدل upload_blob_to_url أي بيانات موجودة. إذا تم تعيينها إلى False، فستفشل العملية باستخدام ResourceExistsError.

max_concurrency
int

عدد الاتصالات المتوازية التي يجب تنزيلها.

length
int

عدد وحدات البايت المراد قراءتها من الدفق. هذا اختياري، ولكن يجب توفيره للأداء الأمثل.

metadata
dict(str,str)

أزواج الاسم والقيمة المقترنة بالكائنات الثنائية كبيرة الحجم كبيانات تعريف.

validate_content
bool

إذا كان صحيحا، تحسب تجزئة MD5 لكل جزء من الكائن الثنائي كبير الحجم. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https ك https (الافتراضي) سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم. لاحظ أيضا أنه إذا تم تمكينها، فلن يتم استخدام خوارزمية التحميل الفعالة للذاكرة، لأن حساب تجزئة MD5 يتطلب تخزين كتل كاملة مؤقتا، وبذلك يهزم الغرض من الخوارزمية الفعالة للذاكرة.

encoding
str

الترميز لاستخدامه إذا تم توفير النص كإدخال. الإعدادات الافتراضية ل UTF-8.

المرتجعات

إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag وآخر تعديل)

نوع الإرجاع

dict(str, Any)