共用方式為

PipelineDraft 類別

  • 參考

表示可用來提交執行和建立已發佈管線的可變管線。

使用 PipelineDrafts 逐一查看 Pipelines。 PipelineDrafts 可以從頭開始建立、另一個 PipelineDraft 或現有的管線： Pipeline 、 PublishedPipeline 或 PipelineRun 。

初始化 PipelineDraft。

繼承
builtins.object
PipelineDraft

建構函式

PipelineDraft(workspace, id, name=None, description=None, experiment_name=None, tags=None, properties=None, graph_draft_id=None, parent_pipeline_id=None, parent_pipeline_run_id=None, parent_step_run_ids=None, parent_pipeline_draft_id=None, last_submitted_pipeline_run_id=None, _pipeline_draft_provider=None)

參數

workspace
Workspace
必要

這個 PipelineDraft 的工作區物件。

id
str
必要

PipelineDraft 的識別碼。

name
str
必要

PipelineDraft 的名稱。

description
str
必要

PipelineDraft 的描述。

experiment_name
str
必要

PipelineDraft 的實驗名稱。

tags
Dict[str, str]
必要

PipelineDraft 的選擇性標記字典。

properties
Dict[str, str]
必要

PipelineDraft 的選擇性屬性字典。

graph_draft_id
str
必要

與 PipelineDraft 相關聯的圖形草稿識別碼。

parent_pipeline_id
str
必要

父系 PublishedPipeline 的識別碼。

parent_pipeline_run_id
str
必要

父 PipelineRun 的識別碼。

parent_step_run_ids
list
必要

父 PipelineRun 之 StepRun 識別碼的清單。

parent_pipeline_draft_id
str
必要

父 PipelineDraft 的識別碼。

last_submitted_pipeline_run_id
str
必要

上次提交的 PipelineRun 的識別碼。

_pipeline_draft_provider
<xref:azureml.pipeline.core._aeva_provider._AevaPipelineDraftProvider>
必要

(內部僅使用。) PipelineDraft 提供者。

workspace
Workspace
必要

這個 PipelineDraft 的 Workspace 物件。

id
str
必要

PipelineDraft 的識別碼。

name
str
必要

PipelineDraft 的名稱。

description
str
必要

PipelineDraft 的描述。

experiment_name
str
必要

PipelineDraft 的實驗名稱。

tags
Dict[str, str]
必要

PipelineDraft 的標記字典。

properties
Dict[str, str]
必要

PipelineDraft 的屬性字典。

graph_draft_id
str
必要

與 PipelineDraft 相關聯的圖形草稿識別碼。

parent_pipeline_id
str
必要

父系 PublishedPipeline 的識別碼。

parent_pipeline_run_id
str
必要

父 PipelineRun 的識別碼。

parent_step_run_ids
list
必要

父 PipelineRun 之 StepRun 識別碼的清單。

parent_pipeline_draft_id
str
必要

父 PipelineDraft 的識別碼。

last_submitted_pipeline_run_id
str
必要

上次提交的 PipelineRun 的識別碼。

_pipeline_draft_provider
<xref:azureml.pipeline.core._aeva_provider._AevaPipelineDraftProvider>
必要

PipelineDraft 提供者。

備註

您可以使用 函式從 Pipelinecreate 建立 PipelineDraft。 範例如下：


   from azureml.pipeline.core import Pipeline, PipelineDraft
   from azureml.pipeline.steps import PythonScriptStep

   train_step = PythonScriptStep(name="Training_Step",
                                 script_name="train.py",
                                 compute_target=aml_compute_target,
                                 source_directory=".")
   pipeline = Pipeline(workspace=ws, steps=[train_step])
   pipeline_draft = PipelineDraft.create(workspace=ws,
                                         name="TestPipelineDraft",
                                         description="draft description",
                                         experiment_name="helloworld",
                                         pipeline=pipeline,
                                         continue_on_step_failure=True,
                                         tags={'dev': 'true'},
                                         properties={'train': 'value'})

PipelineDraft.create () 的管線參數也可以是 PublishedPipeline 、 PipelineRun 或其他 PipelineDraft 。

若要從 PipelineDraft 提交執行，請使用 submit_run 方法：


   pipeline_run = pipeline_draft.submit_run()

若要更新 PipelineDraft， update 請使用 方法。 管線草稿的 update () 函式可用來更新名稱、描述、實驗名稱、管線參數指派、繼續執行步驟失敗設定和與 PipelineDraft 相關聯的管線。


   new_train_step = PythonScriptStep(name="New_Training_Step",
                                     script_name="train.py",
                                     compute_target=aml_compute_target,
                                     source_directory=source_directory)

   new_pipeline = Pipeline(workspace=ws, steps=[new_train_step])

   pipeline_draft.update(name="UpdatedPipelineDraft",
                         description="has updated train step",
                         pipeline=new_pipeline)

方法

create

建立 PipelineDraft。
delete

刪除 PipelineDraft。
get

取得具有指定識別碼的 PipelineDraft。
get_graph

取得與 PipelineDraft 相關聯的圖表。
list

取得工作區中的所有管線草稿。
publish

從 PipelineDraft 發佈 PublishedPipeline。
save

將 PipelineDraft YAML 儲存至檔案。
submit_run

從 PipelineDraft 提交 PipelineRun。
update

更新 PipelineDraft。

提供的欄位將會更新。

create

建立 PipelineDraft。

static create(workspace, pipeline, name=None, description=None, experiment_name=None, pipeline_parameters=None, continue_on_step_failure=None, tags=None, properties=None, _workflow_provider=None, _service_endpoint=None)

參數

workspace
Workspace
必要

此 PipelineDraft 所屬的工作區物件。

pipeline
PublishedPipeline 或 Pipeline 或 PipelineRun 或 PipelineDraft
必要

已發佈的管線或管線。

name
str
預設值: None

PipelineDraft 的名稱;只有在從 Pipeline 建立 時才需要。

description
str
預設值: None

PipelineDraft 的描述;只有在從 Pipeline 建立 時才需要。

experiment_name
str
預設值: None

PipelineDraft 的實驗名稱;只有在從 Pipeline 建立 時才需要。

pipeline_parameters
Dict[str, str]
預設值: None

PipelineDraft 管線參數指派的選擇性字典;只有在從 Pipeline 建立 時才需要。

continue_on_step_failure
bool
預設值: None

指出當 PipelineDraft 的步驟執行失敗設定時，是否要繼續 PipelineRun;只有在從 Pipeline 建立 時才需要。

tags
Dict[str, str]
預設值: None

PipelineDraft 的選擇性標記字典，只有在從 Pipeline 建立時才需要。

properties
Dict[str, str]
預設值: None

只有在從 Pipeline 建立 時，才需要 PipelineDraft 的選擇性屬性字典。

_service_endpoint
str
預設值: None

服務端點。

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(內部僅使用。) 工作流程提供者。

傳回

已建立的 PipelineDraft。

傳回類型

PipelineDraft

delete

刪除 PipelineDraft。

delete(_workflow_provider=None)

參數

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(內部僅使用。) 工作流程提供者。

get

取得具有指定識別碼的 PipelineDraft。

static get(workspace, id, _workflow_provider=None, _service_endpoint=None)

參數

workspace
Workspace
必要

PipelineDraft 建立所在的工作區。

id
str
必要

PipelineDraft 的識別碼。

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(內部僅使用。) 工作流程提供者。

_service_endpoint
str
預設值: None

服務端點。

傳回

PipelineDraft 物件

傳回類型

PipelineDraft

get_graph

取得與 PipelineDraft 相關聯的圖表。

get_graph(_workflow_provider=None)

參數

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(內部僅使用。) 工作流程提供者。

傳回

Graph 物件。

傳回類型

Graph

list

取得工作區中的所有管線草稿。

static list(workspace, tags=None, _workflow_provider=None)

參數

workspace
Workspace
必要

要從中列出草稿的工作區。

tags
dict
預設值: None

如果指定，則會傳回符合指定 {「tag」： 「value」} 的草稿。

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(內部僅使用。) 工作流程提供者。

傳回

PipelineDraft 物件的清單。

傳回類型

list

publish

從 PipelineDraft 發佈 PublishedPipeline。

publish(_workflow_provider=None)

參數

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(內部僅使用。) 工作流程提供者。

傳回

已建立的 PublishedPipeline。

傳回類型

PublishedPipeline

save

將 PipelineDraft YAML 儲存至檔案。

save(path=None, _workflow_provider=None)

參數

path
str
預設值: None

要儲存 YAML 的路徑。 如果路徑是目錄，PipelineDraft YAML 檔案會儲存在 path/pipeline_name.yml。 如果 path 為 None，則會使用目前的目錄。

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(內部僅使用。) 工作流程提供者。

傳回類型

None

submit_run

從 PipelineDraft 提交 PipelineRun。

submit_run(_workflow_provider=None)

參數

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(內部僅使用。) 工作流程提供者。

傳回

提交的 PipelineRun。

傳回類型

PipelineRun

update

更新 PipelineDraft。

提供的欄位將會更新。

update(pipeline=None, name=None, description=None, experiment_name=None, tags=None, pipeline_parameters=None, continue_on_step_failure=None, _workflow_provider=None)

參數

pipeline
Pipeline
預設值: None

草稿的已更新管線。

name
str
預設值: None

PipelineDraft 的名稱。

description
str
預設值: None

PipelineDraft 的描述。

experiment_name
str
預設值: None

PipelineDraft 的實驗名稱。

tags
Dict[str, str]
預設值: None

PipelineDraft 的標記字典。

pipeline_parameters
Dict[str, str]
預設值: None

PipelineDraft 的管線參數指派。

continue_on_step_failure
bool
預設值: None

當 PipelineDraft 的步驟執行失敗設定時，是否要繼續 PipelineRun。

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>
預設值: None

(Internal only.) 工作流程提供者。

屬性

description

取得 PipelineDraft 的描述。

傳回

描述字串。

傳回類型

str

id

取得 PipelineDraft 的識別碼。

傳回

識別碼。

傳回類型

str

last_submitted_pipeline_run_id

取得 PipelineDraft 上次提交的 PipelineRun 識別碼。

傳回

PipelineRun 識別碼。

傳回類型

str

name

設定 PipelineDraft 的名稱。

傳回

名稱。

傳回類型

str

parent_pipeline_draft_id

取得 PipelineDraft 父 PipelineDraft 的識別碼。

傳回

PipelineDraft 識別碼。

傳回類型

str

parent_pipeline_id

取得 PipelineDraft 上層 PublishedPipeline 的識別碼。

傳回

PublishedPipeline 識別碼。

傳回類型

str

parent_pipeline_run_id

取得 PipelineDraft 父 PipelineRun 的識別碼。

傳回

PipelineRun 識別碼。

傳回類型

str

parent_step_run_ids

取得 PipelineDraft 上層 PipelineRun 的 StepRun 識別碼清單。

傳回

StepRun 識別碼的清單。

傳回類型

list

properties

取得 PipelineDraft 的屬性。

傳回

屬性字典。

傳回類型

dict

tags

取得 PipelineDraft 的標記。

傳回

標記字典。

傳回類型

dict