PipelineEndpoint Třída

Reference

Pipeline Představuje pracovní postup, který lze aktivovat z jedinečné adresy URL koncového bodu.

Body PipelineEndpoints se dají použít k vytváření nových verzí produktu při zachování stejného koncového PublishedPipeline bodu. PipelineEndpoints jsou v rámci pracovního prostoru jedinečně pojmenované.

Pomocí atributu koncového bodu objektu PipelineEndpoint můžete aktivovat nová spuštění kanálu z externích aplikací pomocí volání REST. Informace o ověřování při volání koncových bodů REST najdete v tématu https://aka.ms/pl-restep-auth.

Další informace o vytváření a spouštění kanálů strojového učení najdete v tématu https://aka.ms/pl-first-pipeline.

Inicializujte PipelineEndpoint.

Dědičnost: builtins.object

PipelineEndpoint

Konstruktor

PipelineEndpoint(workspace, id, name, description, status, default_version, endpoint, pipeline_version_list, _pipeline_endpoint_provider=None, _published_pipeline_provider=None, _swaggerurl=None)

Parametry

Name	Description
workspace Vyžadováno	Workspace Pracovní prostor, ve který je definovaný koncový bod kanálu.
id Vyžadováno	str ID koncového bodu kanálu.
name Vyžadováno	str Název koncového bodu kanálu.
description Vyžadováno	str Popis koncového bodu kanálu.
status Vyžadováno	str Nový stav koncového bodu kanálu: Aktivní nebo Zakázáno.
default_version Vyžadováno	str Výchozí verze kanálu v koncovém bodu kanálu s automatickými přírůstky začíná hodnotou 0.
endpoint Vyžadováno	str Adresa URL koncového bodu REST pro koncový bod kanálu, kterou je možné použít k odeslání spuštění kanálu.
pipeline_version_list Vyžadováno	list Seznam PipelineIdVersion objektů.
_pipeline_endpoint_provider Vyžadováno	<xref:azureml.pipeline.core._aeva_provider._AevaPublishedPipelineProvider> Poskytovatel PipelineEndpoint.
_pipeline_endpoint_provider Vyžadováno	Poskytovatel PublishedPipeline.
workspace Vyžadováno	Workspace Objekt pracovního prostoru, do který bude tento koncový bod kanálu patřit.
id Vyžadováno	str ID koncového bodu kanálu.
name Vyžadováno	str Název koncového bodu kanálu.
description Vyžadováno	str Popis koncového bodu kanálu.
status Vyžadováno	str Nový stav koncového bodu kanálu: Aktivní nebo Zakázáno.
default_version Vyžadováno	str Výchozí verze kanálu v Koncovém bodu kanálu s automatickými přírůstky začíná hodnotou 0.
endpoint Vyžadováno	str Adresa URL koncového bodu REST pro PipelineEndpoint pro odesílání spuštění kanálu
pipeline_version_list Vyžadováno	list Seznam PipelineIdVersion
_pipeline_endpoint_provider Vyžadováno	<xref:azureml.pipeline.core._aeva_provider._AevaPublishedPipelineProvider> Poskytovatel PipelineEndpoint.
_pipeline_endpoint_provider Vyžadováno	Poskytovatel PublishedPipeline.
swaggerendpoint Vyžadováno	Adresa URL koncového bodu REST Swaggeru pro PipelineEndpoint pro odesílání spuštění kanálu.

Poznámky

Koncový bod kanálu lze vytvořit z objektu Pipeline PublishedPipelinenebo .

Příklad publikování z kanálu nebo PublishedPipeline je následující:


   from azureml.pipeline.core import PipelineEndpoint

   # The pipeline argument can be either a Pipeline or a PublishedPipeline
   pipeline_endpoint = PipelineEndpoint.publish(workspace=ws,
                                                name="PipelineEndpointName",
                                                pipeline=pipeline,
                                                description="New Pipeline Endpoint")

Odešlete koncový bod kanálu pomocí submit. Při volání odeslání se vytvoří objekt, PipelineRun který následně vytvoří StepRun objekty pro každý krok v pracovním postupu.

Příklad, jak odeslat PipelineEndpoint, je následující:


   from azureml.pipeline.core import PipelineEndpoint

   pipeline_endpoint = PipelineEndpoint.get(workspace=ws, name="PipelineEndpointName")
   pipeline_run = experiment.submit(pipeline_endpoint)

Při odesílání koncového bodu kanálu je možné zadat řadu volitelných nastavení. Tady jsou některé z nich:

pipeline_parameters: Parametry spuštění kanálu, slovník {name: value}. Další podrobnosti najdete PipelineParameter v tématu.
parent_run_id: Můžete zadat ID spuštění pro nastavení nadřazeného spuštění tohoto spuštění kanálu, které se projeví v runHistory. Nadřazené spuštění musí patřit do stejného experimentu jako ten, do kterého se tento kanál odesílá.
pipeline_version: Verze kanálu, která se má spustit.

Příklad odeslání pipelineEndpointu pomocí těchto nastavení je následující:


   from azureml.pipeline.core import PipelineEndpoint

   pipeline_endpoint = PipelineEndpoint.get(workspace=ws, name="PipelineEndpointName")
   pipeline_run = experiment.submit(pipeline_endpoint,
                                    pipeline_parameters={"param1": "value1"},
                                    parent_run_id="<run_id>",
                                    pipeline_version="0")

Pokud chcete přidat novou verzi pipelineEndpointu, použijte:


   from azureml.pipeline.core import PipelineEndpoint

   pipeline_endpoint = PipelineEndpoint.get(workspace=ws, name="PipelineEndpointName")
   pipeline_endpoint.add(published_pipeline)

Další informace o vytváření a používání bodů PipelineEndpoints najdete v následujícím poznámkovém bloku: https://aka.ms/pl-ver-endpoint.

Metody

add	Přidejte zadaný kanál do pipelineEndpoint.
add_default	Přidejte zadaný kanál na PipelineEndpoint a nastavte výchozí verzi na přidanou verzi kanálu.
archive	Archivujte koncový bod kanálu.
disable	Nastavte Parametr PipelineEndpoint na Zakázáno a není k dispozici ke spuštění.
enable	Nastavte Koncový bod kanálu na Aktivní a je k dispozici ke spuštění.
get	Získejte koncový bod kanálu podle názvu nebo ID. Pokud některý z těchto bodů není zadaný, vyvolá výjimku.
get_all	Získejte všechny aktivní koncové body kanálu v aktuálním pracovním prostoru. Získejte všechny aktivní koncové body kanálu. POZNÁMKA: Tato metoda je zastaralá ve prospěch PipelineEndpoint.list().
get_all_pipelines	Získejte seznam kanálů v koncovém bodu kanálu. POZNÁMKA: Tato metoda je zastaralá ve prospěch list_pipelines()
get_all_versions	Získejte seznam kanálů a odpovídajících verzí v koncovém bodu kanálu. POZNÁMKA: Tato metoda je zastaralá ve prospěch list_versions()
get_default_version	Získejte výchozí verzi PipelineEndpoint.
get_pipeline	Získat kanál zadané verze nebo výchozí; vyvolá výjimku, pokud není nalezena verze.
list	Vypíše aktivní koncové body kanálu v aktuálním pracovním prostoru.
list_pipelines	Získejte seznam kanálů přidružených k bodu PipelineEndpoint.
list_versions	Získejte seznam kanálů a odpovídající verze pipelineEndpointu.
publish	Vytvořte pipelineEndpoint se zadaným názvem a kanálem nebo publikovaným kanálem. Koncový bod kanálu je rozhraní REST API, které je možné použít z externích aplikací. Informace o ověřování při volání koncových bodů REST najdete v tématu https://aka.ms/pl-restep-auth. Další informace o práci s koncovými body kanálu najdete v tématu https://aka.ms/pl-first-pipeline. Vyvolá výjimku, pokud již existuje koncový bod kanálu s daným názvem.
reactivate	Opětovná aktivace koncového bodu kanálu, který byl archivován.
set_default	Nastavte výchozí verzi PipelineEndpoint, vyvolá výjimku, pokud zadaný kanál není nalezen.
set_default_version	Nastavení výchozí verze PipelineEndpoint vyvolá výjimku, pokud se zadaná verze nenajde.
set_name	Nastavte název PipelineEndpoint.
submit	Odeslat experiment kanálu dané verze; Pokud verze není žádná, aktivuje výchozí verzi kanálu.

add

Přidejte zadaný kanál do pipelineEndpoint.

add(pipeline)

Parametry

Name	Description
pipeline Vyžadováno	PublishedPipeline Publikovaný kanál, který chcete přidat.

add_default

Přidejte zadaný kanál na PipelineEndpoint a nastavte výchozí verzi na přidanou verzi kanálu.

add_default(pipeline)

Parametry

Name	Description
pipeline Vyžadováno	PublishedPipeline Publikovaný kanál, který se přidá jako výchozí verze.

disable

Nastavte Parametr PipelineEndpoint na Zakázáno a není k dispozici ke spuštění.

disable()

enable

Nastavte Koncový bod kanálu na Aktivní a je k dispozici ke spuštění.

enable()

get

Získejte koncový bod kanálu podle názvu nebo ID. Pokud některý z těchto bodů není zadaný, vyvolá výjimku.

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

Parametry

Name	Description
workspace Vyžadováno	Workspace Pracovní prostor, ve které byl vytvořen Koncový bod kanálu.
id	str ID koncového bodu kanálu. Default value: None
name	str Název koncového bodu kanálu. Default value: None
_workflow_provider	<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider> Zprostředkovatel pracovního postupu. Default value: None
_service_endpoint	str Koncový bod služby. Default value: None

Návraty

Typ	Description
PipelineEndpoint	Objekt PipelineEndpoint.

get_all

Získejte všechny aktivní koncové body kanálu v aktuálním pracovním prostoru.

Získejte všechny aktivní koncové body kanálu. POZNÁMKA: Tato metoda je zastaralá ve prospěch PipelineEndpoint.list().

static get_all(workspace, active_only=True, _workflow_provider=None, _service_endpoint=None)

Parametry

Name	Description
workspace Vyžadováno	Workspace Pracovní prostor.
active_only	bool Pokud má hodnotu true, vrátí pouze koncové body kanálu, které jsou aktuálně aktivní. Default value: True
_workflow_provider	<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider> Zprostředkovatel pracovního postupu. Default value: None
_service_endpoint	str Koncový bod služby. Default value: None

Návraty

Typ	Description
list	Seznam PipelineEndpoint objektů.

get_all_pipelines

Získejte seznam kanálů v koncovém bodu kanálu.

POZNÁMKA: Tato metoda je zastaralá ve prospěch list_pipelines()

get_all_pipelines(active_only=True, _workflow_provider=None, _service_endpoint=None)

Parametry

Name	Description
active_only	bool Příznak pro vrácení pouze aktivních kanálů. Default value: True
_workflow_provider	<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider> Zprostředkovatel pracovního postupu. Default value: None
_service_endpoint	str Koncový bod služby. Default value: None

Návraty

Typ	Description
list	Seznam PublishedPipeline objektů.

get_all_versions

Získejte seznam kanálů a odpovídajících verzí v koncovém bodu kanálu.

POZNÁMKA: Tato metoda je zastaralá ve prospěch list_versions()

get_all_versions(_workflow_provider=None, _service_endpoint=None)

Parametry

Name	Description
_workflow_provider	<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider> Zprostředkovatel pracovního postupu. Default value: None
_service_endpoint	str Koncový bod služby. Default value: None

Návraty

Typ	Description
list	Seznam PipelineVersion objektů.

get_default_version

Získejte výchozí verzi PipelineEndpoint.

get_default_version()

Návraty

Typ	Description
str	Výchozí verze koncového bodu kanálu.

get_pipeline

Získat kanál zadané verze nebo výchozí; vyvolá výjimku, pokud není nalezena verze.

get_pipeline(version=None)

Parametry

Name	Description
version	str Verze kanálu, která se má vrátit. Default value: None

Návraty

Typ	Description
PublishedPipeline	Publikovaný kanál.

list

Vypíše aktivní koncové body kanálu v aktuálním pracovním prostoru.

static list(workspace, active_only=True, max_results=100, _workflow_provider=None, _service_endpoint=None)

Parametry

Name	Description
workspace Vyžadováno	Workspace Pracovní prostor.
active_only	bool Pokud má hodnotu true, vrátí pouze koncové body kanálu, které jsou aktuálně aktivní. Default value: True
max_results	int maximální počet řádků vrácených koncových bodů kanálu Default value: 100
_workflow_provider	<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider> Zprostředkovatel pracovního postupu. Default value: None
_service_endpoint	str Koncový bod služby. Default value: None

Návraty

Typ	Description
list	Seznam PipelineEndpoint objektů.

list_pipelines

Získejte seznam kanálů přidružených k bodu PipelineEndpoint.

list_pipelines(active_only=True, _workflow_provider=None, _service_endpoint=None)

Parametry

Name	Description
active_only	bool Určuje, jestli se mají vrátit pouze aktivní kanály. Default value: True
_workflow_provider	<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider> Poskytovatel pracovního postupu. Default value: None
_service_endpoint	str Koncový bod služby. Default value: None

Návraty

Typ	Description
list	Seznam PublishedPipeline objektů.

list_versions

Získejte seznam kanálů a odpovídající verze pipelineEndpointu.

list_versions(_workflow_provider=None, _service_endpoint=None)

Parametry

Name	Description
_workflow_provider	<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider> Poskytovatel pracovního postupu. Default value: None
_service_endpoint	str Koncový bod služby. Default value: None

Návraty

Typ	Description
list	Seznam PipelineVersion objektů.

publish

Vytvořte pipelineEndpoint se zadaným názvem a kanálem nebo publikovaným kanálem.

Koncový bod kanálu je rozhraní REST API, které je možné použít z externích aplikací. Informace o ověřování při volání koncových bodů REST najdete v tématu https://aka.ms/pl-restep-auth.

Další informace o práci s koncovými body kanálu najdete v tématu https://aka.ms/pl-first-pipeline.

Vyvolá výjimku, pokud již existuje koncový bod kanálu s daným názvem.

static publish(workspace, name, description, pipeline, _workflow_provider=None, _service_endpoint=None)

Parametry

Name	Description
workspace Vyžadováno	Workspace Pracovní prostor, ve který chcete vytvořit PipelineEndpoint.
name Vyžadováno	str Název koncového bodu kanálu.
description Vyžadováno	str Popis koncového bodu kanálu.
pipeline Vyžadováno	PublishedPipeline nebo Pipeline Publikovaný kanál nebo kanál.
_service_endpoint	str Koncový bod služby. Default value: None
_workflow_provider	<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider> Poskytovatel pracovního postupu. Default value: None

Návraty

Typ	Description
PipelineEndpoint	Nový koncový bod kanálu.

Výjimky

Typ	Description
ValueError

reactivate

Opětovná aktivace koncového bodu kanálu, který byl archivován.

reactivate(name)

Parametry

Name	Description
name Vyžadováno	str Název, který se má nastavit.

Návraty

Typ	Description
PipelineEndpoint	Objekt PipelineEndpoint.

set_default

Nastavte výchozí verzi PipelineEndpoint, vyvolá výjimku, pokud zadaný kanál není nalezen.

set_default(pipeline)

Parametry

Name	Description
pipeline Vyžadováno	PublishedPipeline Publikovaný kanál, který se má nastavit jako výchozí.

Výjimky

Typ	Description
ValueError

set_default_version

Nastavení výchozí verze PipelineEndpoint vyvolá výjimku, pokud se zadaná verze nenajde.

set_default_version(version)

Parametry

Name	Description
version Vyžadováno	str Verze, která se má nastavit jako výchozí verze v PipelineEndpointu.

Výjimky

Typ	Description
ValueError

set_name

Nastavte název PipelineEndpoint.

set_name(name)

Parametry

Name	Description
name Vyžadováno	str Název, který se má nastavit.

submit

Odeslat experiment kanálu dané verze; Pokud verze není žádná, aktivuje výchozí verzi kanálu.

submit(experiment_name, pipeline_parameters=None, parent_run_id=None, pipeline_version=None)

Parametry

Name	Description
experiment_name Vyžadováno	str Název experimentu, do který se má kanál odeslat.
pipeline_parameters	dict Parametry, které se mají použít při provádění kanálu, se předávají jako slovník {name: value}. Další podrobnosti najdete PipelineParameter v tématu. Default value: None
parent_run_id	str Můžete zadat ID spuštění, které nastaví nadřazené spuštění tohoto spuštění kanálu, což se projeví v nástroji RunHistory. Nadřazené spuštění musí patřit do stejného experimentu, do kterého se tento kanál odesílá. Default value: None
pipeline_version	str Verze kanálu, která se má spustit. Default value: None

Návraty

Typ	Description
PipelineRun	Odeslaný kanál se spustí.

Výjimky

Typ	Description
ValueError

Atributy

default_version

Získejte výchozí verzi koncového bodu kanálu.

Návraty

Typ	Description
str	Výchozí verze.

description

Získejte popis koncového bodu kanálu.

Návraty

Typ	Description
str	Popis.

endpoint

Získejte adresu URL koncového bodu REST koncového bodu kanálu.

Koncový bod je možné použít k aktivaci spuštění kanálu.

Návraty

Typ	Description
str	Koncový bod REST pro spuštění kanálu PipelineEndpoint.

id

Získejte ID koncového bodu kanálu.

Návraty

Typ	Description
str	ID koncového bodu kanálu.

name

Získejte název koncového bodu kanálu.

Návraty

Typ	Description
str	Název

pipeline_version_list

Získejte seznam verzí kanálu.

Návraty

Typ	Description
list	Seznam PipelineIdVersion objektů.

status

Získejte stav koncového bodu kanálu.

Návraty

Typ	Description
str	Stav.

swaggerurl

Získejte adresu URL REST Swaggeru koncového bodu kanálu.

Adresa URL Swaggeru může být zobrazení schématu koncového bodu kanálu.

Návraty

Typ	Description
str	REST Swagger pro PipelineEndpoint ke spuštění kanálu.

Sdílet prostřednictvím

PipelineEndpoint Třída

Konstruktor

Parametry

Poznámky

Metody

add

Parametry

add_default

Parametry

archive

disable

enable

get

Parametry

Návraty

get_all

Parametry

Návraty

get_all_pipelines

Parametry

Návraty

get_all_versions

Parametry

Návraty

get_default_version

Návraty

get_pipeline

Parametry

Návraty

list

Parametry

Návraty

list_pipelines

Parametry

Návraty

list_versions

Parametry

Návraty

publish

Parametry

Návraty

Výjimky

reactivate

Parametry

Návraty

set_default

Parametry

Výjimky

set_default_version

Parametry

Výjimky

set_name

Parametry

submit

Parametry

Návraty

Výjimky

Atributy

default_version

Návraty

description

Návraty

endpoint

Návraty

id

Návraty

name

Návraty

pipeline_version_list

Návraty

status

Návraty

swaggerurl

Návraty

Váš názor

Další materiály