ResourceFile الفصل

ملف واحد أو ملفات متعددة ليتم تنزيلها إلى عقدة حساب.

توريث

Model

ResourceFile

الدالمنشئ

ResourceFile(*, auto_storage_container_name: str = None, storage_container_url: str = None, http_url: str = None, blob_prefix: str = None, file_path: str = None, file_mode: str = None, identity_reference=None, **kwargs)

المعلمات

auto_storage_container_name

str

مطلوب

تعد خصائص autoStorageContainerName وstorageContainerUrl وhttpUrl حصرية بشكل متبادل ويجب تحديد أحدها.

storage_container_url

str

مطلوب

تعد خصائص autoStorageContainerName وstorageContainerUrl وhttpUrl حصرية بشكل متبادل ويجب تحديد أحدها. يجب أن يكون عنوان URL هذا قابلا للقراءة وقابلا للسرد من عقد الحساب. هناك ثلاث طرق للحصول على عنوان URL هذا لحاوية في تخزين Azure: تضمين توقيع الوصول المشترك (SAS) الذي يمنح أذونات القراءة والسرد على الحاوية، أو استخدام هوية مدارة مع أذونات القراءة والقائمة، أو تعيين قائمة التحكم بالوصول للحاوية للسماح بالوصول العام.

http_url

str

مطلوب

تعد خصائص autoStorageContainerName وstorageContainerUrl وhttpUrl حصرية بشكل متبادل ويجب تحديد أحدها. إذا كان عنوان URL يشير إلى Azure Blob Storage، فيجب أن يكون قابلا للقراءة من عقد الحساب. هناك ثلاث طرق للحصول على عنوان URL هذا لكائن ثنائي كبير الحجم في تخزين Azure: تضمين توقيع الوصول المشترك (SAS) الذي يمنح أذونات القراءة على الكائن الثنائي كبير الحجم، أو استخدام هوية مدارة بإذن القراءة، أو تعيين قائمة التحكم بالوصول للكائن الثنائي كبير الحجم أو الحاوية الخاصة به للسماح بالوصول العام.

blob_prefix

str

مطلوب

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

file_path

str

مطلوب

إذا تم تحديد الخاصية httpUrl، فإن filePath مطلوب ويصف المسار الذي سيتم تنزيل الملف إليه، بما في ذلك اسم الملف. وإلا، إذا تم تحديد الخاصية autoStorageContainerName أو storageContainerUrl، فإن filePath اختياري وهو الدليل الذي يجب تنزيل الملفات إليه. في حالة استخدام filePath كدليل، سيتم الاحتفاظ بأي بنية دليل مقترنة بالفعل ببيانات الإدخال بالكامل وإلحاقها بدليل filePath المحدد. لا يمكن للمسار النسبي المحدد الخروج من دليل عمل المهمة (على سبيل المثال باستخدام '..').

file_mode

str

مطلوب

تنطبق هذه الخاصية فقط على الملفات التي يتم تنزيلها إلى عقد حساب Linux. سيتم تجاهله إذا تم تحديده ل resourceFile الذي سيتم تنزيله إلى عقدة حساب Windows. إذا لم يتم تحديد هذه الخاصية لعقدة حساب Linux، فسيتم تطبيق قيمة افتراضية 0770 على الملف.

identity_reference

ComputeNodeIdentityReference

مطلوب

المرجع إلى الهوية المعينة من قبل المستخدم لاستخدامها للوصول إلى Azure Blob Storage المحدد بواسطة storageContainerUrl أو httpUrl.

الأساليب

as_dict	إرجاع إملاء يمكن أن يكون JSONify باستخدام json.dump. قد يستخدم الاستخدام المتقدم رد اتصال كمعلمة اختياريا: المفتاح هو اسم السمة المستخدم في Python. Attr_desc هو قالب من بيانات التعريف. يحتوي حاليا على "type" مع نوع msrest و"المفتاح" مع المفتاح المشفرة RestAPI. القيمة هي القيمة الحالية في هذا الكائن. سيتم استخدام السلسلة التي تم إرجاعها لتسلسل المفتاح. إذا كان نوع الإرجاع عبارة عن قائمة، يعتبر هذا إملاءا للنتيجة الهرمية. راجع الأمثلة الثلاثة في هذا الملف: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.
deserialize	تحليل سلسلة باستخدام بناء جملة RestAPI وإرجاع نموذج.
enable_additional_properties_sending
from_dict	تحليل الإملاء باستخدام مستخرج مفتاح معين يرجع نموذجا. بشكل افتراضي، ضع في اعتبارك المستخرجات الرئيسية (rest_key_case_insensitive_extractor attribute_key_case_insensitive_extractor last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	إرجاع JSON الذي سيتم إرساله إلى azure من هذا النموذج. هذا اسم مستعار as_dict(full_restapi_key_transformer, keep_readonly=False). إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.
validate	تحقق من صحة هذا النموذج بشكل متكرر وأعد قائمة ValidationError.

as_dict

إرجاع إملاء يمكن أن يكون JSONify باستخدام json.dump.

قد يستخدم الاستخدام المتقدم رد اتصال كمعلمة اختياريا:

المفتاح هو اسم السمة المستخدم في Python. Attr_desc هو قالب من بيانات التعريف. يحتوي حاليا على "type" مع نوع msrest و"المفتاح" مع المفتاح المشفرة RestAPI. القيمة هي القيمة الحالية في هذا الكائن.

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

راجع الأمثلة الثلاثة في هذا الملف:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

المعلمات

key_transformer

<xref:function>

دالة محول مفاتيح.

keep_readonly

القيمة الافتراضية: True

المرتجعات

كائن متوافق مع JSON

نوع الإرجاع

dict

deserialize

تحليل سلسلة باستخدام بناء جملة RestAPI وإرجاع نموذج.

deserialize(data, content_type=None)

المعلمات

data

str

مطلوب

سلسلة باستخدام بنية RestAPI. JSON بشكل افتراضي.

content_type

str

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

JSON بشكل افتراضي، قم بتعيين application/xml إذا XML.

المرتجعات

مثيل لهذا النموذج

استثناءات

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

تحليل الإملاء باستخدام مستخرج مفتاح معين يرجع نموذجا.

بشكل افتراضي، ضع في اعتبارك المستخرجات الرئيسية (rest_key_case_insensitive_extractor attribute_key_case_insensitive_extractor last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

المعلمات

data

dict

مطلوب

إملاء باستخدام بنية RestAPI

content_type

str

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

JSON بشكل افتراضي، قم بتعيين application/xml إذا XML.

key_extractors

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

المرتجعات

مثيل لهذا النموذج

استثناءات

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

إرجاع JSON الذي سيتم إرساله إلى azure من هذا النموذج.

هذا اسم مستعار as_dict(full_restapi_key_transformer, keep_readonly=False).

إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

المعلمات

keep_readonly

bool

القيمة الافتراضية: False

إذا كنت تريد تسلسل السمات للقراءة فقط

المرتجعات

كائن متوافق مع JSON

نوع الإرجاع

dict

validate

تحقق من صحة هذا النموذج بشكل متكرر وأعد قائمة ValidationError.

validate()

المرتجعات

قائمة بخطأ التحقق من الصحة

نوع الإرجاع

list