EnvironmentOperations الفصل

عمليات البيئة.

يجب عدم إنشاء مثيل لهذه الفئة مباشرة. بدلا من ذلك، يجب إنشاء مثيل MLClient يقوم بإنشاء مثيل لك وإرفاقه كسمة.

توريث

azure.ai.ml._scope_dependent_operations._ScopeDependentOperations

EnvironmentOperations

الدالمنشئ

EnvironmentOperations(operation_scope: OperationScope, operation_config: OperationConfig, service_client: AzureMachineLearningWorkspaces | AzureMachineLearningWorkspaces, all_operations: OperationsContainer, **kwargs: Any)

المعلمات

operation_scope

<xref:azure.ai.ml._scope_dependent_operations.OperationScope>

مطلوب

متغيرات النطاق لفئات العمليات لعنصر MLClient.

operation_config

<xref:azure.ai.ml._scope_dependent_operations.OperationConfig>

مطلوب

التكوين الشائع لفئات العمليات لعنصر MLClient.

service_client

Union[ <xref:azure.ai.ml._restclient.v2023_04_01_preview._azure_machine_learning_workspaces.AzureMachineLearningWorkspaces>, <xref:azure.ai.ml._restclient.v2021_10_01_dataplanepreview._azure_machine_learning_workspaces. AzureMachineLearningWorkspaces>]

مطلوب

عميل الخدمة للسماح للمستخدمين النهائيين بالعمل على موارد مساحة عمل التعلم الآلي من Microsoft Azure (ServiceClient042023Preview أو ServiceClient102021Dataplane).

all_operations

<xref:azure.ai.ml._scope_dependent_operations.OperationsContainer>

مطلوب

جميع فئات العمليات لعنصر MLClient.

الأساليب

archive	أرشفة بيئة أو إصدار بيئة.
create_or_update	إرجاع أصل البيئة الذي تم إنشاؤه أو تحديثه.
get	إرجاع أصل البيئة المحدد.
list	سرد جميع أصول البيئة في مساحة العمل.
restore	استعادة إصدار بيئة مؤرشفة.
share	ملاحظة هذه طريقة تجريبية، وقد تتغير في أي وقت. يرجى مراجعة https://aka.ms/azuremlexperimental لمزيد من المعلومات. مشاركة أصل بيئة من مساحة العمل إلى السجل.

archive

أرشفة بيئة أو إصدار بيئة.

archive(name: str, version: str | None = None, label: str | None = None, **kwargs) -> None

المعلمات

name

str

مطلوب

اسم البيئة.

version

str

مطلوب

إصدار البيئة.

label

str

مطلوب

تسمية البيئة. (حصري بشكل متبادل مع الإصدار)

أمثلة

مثال الأرشيف.

   ml_client.environments.archive("create-environment", "2.0")

create_or_update

إرجاع أصل البيئة الذي تم إنشاؤه أو تحديثه.

create_or_update(environment: Environment) -> Environment

المعلمات

environment

<xref:azure.ai.ml.entities._assets.Environment>

مطلوب

كائن البيئة

المرتجعات

كائن البيئة الذي تم إنشاؤه أو تحديثه

نوع الإرجاع

Environment

استثناءات

ValidationException

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

EmptyDirectoryError

يرفع إذا كان المسار المحلي يوفر نقاطا إلى دليل فارغ.

أمثلة

إنشاء بيئة.

   from azure.ai.ml.entities import BuildContext, Environment

   env_docker_context = Environment(
       build=BuildContext(
           path="./sdk/ml/azure-ai-ml/tests/test_configs/environment/environment_files",
           dockerfile_path="DockerfileNonDefault",
       ),
       name="create-environment",
       version="2.0",
       description="Environment created from a Docker context.",
   )
   ml_client.environments.create_or_update(env_docker_context)

get

إرجاع أصل البيئة المحدد.

get(name: str, version: str | None = None, label: str | None = None) -> Environment

المعلمات

name

str

مطلوب

اسم البيئة.

version

str

مطلوب

إصدار البيئة.

label

str

مطلوب

تسمية البيئة. (حصري بشكل متبادل مع الإصدار)

المرتجعات

كائن البيئة

نوع الإرجاع

Environment

استثناءات

ValidationException

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

أمثلة

الحصول على مثال.

   ml_client.environments.get("create-environment", "2.0")

list

سرد جميع أصول البيئة في مساحة العمل.

list(name: str | None = None, *, list_view_type: ListViewType = ListViewType.ACTIVE_ONLY) -> Iterable[Environment]

المعلمات

name

Optional[str]

مطلوب

اسم البيئة.

list_view_type

نوع العرض لتضمين/استبعاد (على سبيل المثال) البيئات المؤرشفة. الافتراضي: ACTIVE_ONLY.

المرتجعات

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

نوع الإرجاع

ItemPaged[Environment]

أمثلة

مثال على القائمة.

   ml_client.environments.list()

restore

استعادة إصدار بيئة مؤرشفة.

restore(name: str, version: str | None = None, label: str | None = None, **kwargs) -> None

المعلمات

name

str

مطلوب

اسم البيئة.

version

str

مطلوب

إصدار البيئة.

label

str

مطلوب

تسمية البيئة. (حصري بشكل متبادل مع الإصدار)

أمثلة

مثال على الاستعادة.

   ml_client.environments.restore("create-environment", "2.0")

share

ملاحظة

هذه طريقة تجريبية، وقد تتغير في أي وقت. يرجى مراجعة https://aka.ms/azuremlexperimental لمزيد من المعلومات.

مشاركة أصل بيئة من مساحة العمل إلى السجل.

share(name: str, version: str, *, share_with_name: str, share_with_version: str, registry_name: str) -> Environment

المعلمات

name

str

مطلوب

اسم أصل البيئة.

version

str

مطلوب

إصدار أصل البيئة.

share_with_name

str

اسم أصل البيئة للمشاركة معه.

share_with_version

str

إصدار أصل البيئة للمشاركة معه.

registry_name

str

اسم السجل الوجهة.

المرتجعات

عنصر أصل البيئة.

نوع الإرجاع

Environment