OnlineEndpointOperations 類別

OnlineEndpointOperations。

您不應該直接具現化此類別。 相反地,您應該建立 MLClient 實例,為您具現化它,並將其附加為屬性。

繼承
azure.ai.ml._scope_dependent_operations._ScopeDependentOperations
OnlineEndpointOperations

建構函式

OnlineEndpointOperations(operation_scope: azure.ai.ml._scope_dependent_operations.OperationScope, operation_config: azure.ai.ml._scope_dependent_operations.OperationConfig, service_client_02_2022_preview: azure.ai.ml._restclient.v2022_02_01_preview._azure_machine_learning_workspaces.AzureMachineLearningWorkspaces, all_operations: azure.ai.ml._scope_dependent_operations.OperationsContainer, local_endpoint_helper: azure.ai.ml.operations._local_endpoint_helper._LocalEndpointHelper, credentials: Optional[azure.core.credentials.TokenCredential] = None, **kwargs: Dict)

參數

operation_scope
operation_config
service_client_02_2022_preview
all_operations
local_endpoint_helper
credentials
預設值: None

方法

begin_create_or_update

建立或更新端點。

begin_delete

刪除線上端點。

begin_regenerate_keys

重新產生端點的金鑰。

get

取得端點資源。

get_keys

取得驗證認證。

invoke

使用提供的承載叫用端點。

list

列出工作區的端點。

begin_create_or_update

建立或更新端點。

begin_create_or_update(endpoint: azure.ai.ml.entities._endpoint.online_endpoint.OnlineEndpoint, *, local: bool = False) -> azure.core.polling._poller.LROPoller[azure.ai.ml.entities._endpoint.online_endpoint.OnlineEndpoint]

參數

endpoint
OnlineEndpoint
必要

端點實體。

local
bool
必要

是否要在本機 Docker 環境中與端點互動。 預設為 False。

傳回

如果遠端,則為追蹤作業狀態的輪詢器,否則會傳回 None。

傳回類型

例外狀況

如果無法成功驗證 OnlineEndpoint,則引發 。 錯誤訊息中將會提供詳細資料。

如果 OnlineEndpoint 資產 (例如無法成功驗證 Data、Code、Model、Environment) ,則引發。 錯誤訊息中將會提供詳細資料。

如果無法成功驗證 OnlineEndpoint 模型,則引發 。 錯誤訊息中將會提供詳細資料。

如果提供的本機路徑指向空的目錄,則引發 。

如果本機端點資源不存在,則引發。

begin_delete

刪除線上端點。

begin_delete(name: Optional[str] = None, *, local: bool = False) -> azure.core.polling._poller.LROPoller[None]

參數

name
str
必要

端點的名稱。

local
bool
必要

是否要在本機 Docker 環境中與端點互動。 預設為 False。

傳回

如果遠端,則為追蹤作業狀態的輪詢器,否則會傳回 None。

傳回類型

例外狀況

如果本機端點資源不存在,則引發。

begin_regenerate_keys

重新產生端點的金鑰。

begin_regenerate_keys(name: str, *, key_type: str = 'primary') -> azure.core.polling._poller.LROPoller[None]

參數

name
<xref:<xref:The endpoint type. Defaults to ONLINE_ENDPOINT_TYPE.>>
必要

端點名稱。

key_type
str
必要

其中一個「主要」、「次要」。 預設為 「primary」。

傳回

用來追蹤作業狀態的輪詢器。

傳回類型

例外狀況

如果無法成功驗證 OnlineEndpoint,則引發 。 錯誤訊息中將會提供詳細資料。

如果 OnlineEndpoint 資產 (例如無法成功驗證 Data、Code、Model、Environment) ,則引發。 錯誤訊息中將會提供詳細資料。

如果無法成功驗證 OnlineEndpoint 模型,則引發 。 錯誤訊息中將會提供詳細資料。

如果提供的本機路徑指向空的目錄,則引發 。

如果本機端點資源不存在,則引發。

get

取得端點資源。

get(name: str, *, local: bool = False) -> azure.ai.ml.entities._endpoint.online_endpoint.OnlineEndpoint

參數

name
str
必要

端點的名稱。

local
<xref:Optional>[bool]
必要

指出是否要在本機 Docker 環境中與端點互動。 預設為 False。

傳回

從服務擷取的端點物件。

傳回類型

例外狀況

如果本機端點資源不存在,則引發。

get_keys

取得驗證認證。

get_keys(name: str) -> Union[azure.ai.ml.entities._endpoint.online_endpoint.EndpointAuthKeys, azure.ai.ml.entities._endpoint.online_endpoint.EndpointAuthToken]

參數

name
str
必要

端點名稱

傳回

根據端點中的驗證模式,傳回金鑰或權杖

傳回類型

例外狀況

如果無法成功驗證 OnlineEndpoint,則引發 。 錯誤訊息中將會提供詳細資料。

如果 OnlineEndpoint 資產 (例如無法成功驗證 Data、Code、Model、Environment) ,則引發。 錯誤訊息中將會提供詳細資料。

如果無法成功驗證 OnlineEndpoint 模型,則引發 。 錯誤訊息中將會提供詳細資料。

如果提供的本機路徑指向空的目錄,則引發 。

如果本機端點資源不存在,則引發。

invoke

使用提供的承載叫用端點。

invoke(endpoint_name: str, *, request_file: Optional[str] = None, deployment_name: Optional[str] = None, input_data: Optional[Union[str, azure.ai.ml.entities._assets._artifacts.data.Data]] = None, params_override=None, local: bool = False, **kwargs) -> str

參數

endpoint_name
str
必要

端點名稱

request_file
<xref:Optional>[str]
必要

包含要求承載的檔案。 這只適用于線上端點。

deployment_name
<xref:Optional>[str]
必要

要叫用的特定部署名稱。 這是選擇性的。 根據預設,要求會根據流量規則路由傳送至任何部署。

input_data
<xref:Optional>[<xref:Union>[str, Data]]
必要

若要使用預先註冊的資料資產,請以格式傳遞 str

local
<xref:Optional>[bool]
必要

指出是否要在本機 Docker 環境中與端點互動。 預設為 False。

傳回

線上端點的預測輸出。

傳回類型

str

例外狀況

如果本機端點資源不存在,則引發。

如果有多個部署且未指定任何deployment_name,則引發。

如果本機端點為 None,則引發。

list

列出工作區的端點。

list(*, local: bool = False) -> azure.core.paging.ItemPaged[azure.ai.ml.entities._endpoint.online_endpoint.OnlineEndpoint]

參數

local
bool
必要

(選擇性) 旗標,指出是否要在本機 Docker 環境中與端點互動。 預設值:False

傳回

端點清單

傳回類型

例外狀況

如果無法成功驗證 OnlineEndpoint,則引發 。 錯誤訊息中將會提供詳細資料。

如果 OnlineEndpoint 資產 (例如無法成功驗證 Data、Code、Model、Environment) ,則引發。 錯誤訊息中將會提供詳細資料。

如果無法成功驗證 OnlineEndpoint 模型,則引發 。 錯誤訊息中將會提供詳細資料。

如果提供的本機路徑指向空的目錄,則引發 。

如果本機端點資源不存在,則引發。