|
| 1 | +# coding=utf-8 |
| 2 | +# -------------------------------------------------------------------------- |
| 3 | +# Copyright (c) Microsoft Corporation. All rights reserved. |
| 4 | +# Licensed under the MIT License. See License.txt in the project root for license information. |
| 5 | +# Code generated by Microsoft (R) Python Code Generator. |
| 6 | +# Changes may cause incorrect behavior and will be lost if the code is regenerated. |
| 7 | +# -------------------------------------------------------------------------- |
| 8 | + |
| 9 | +from copy import deepcopy |
| 10 | +from typing import Any, TYPE_CHECKING |
| 11 | +from typing_extensions import Self |
| 12 | + |
| 13 | +from azure.core import PipelineClient |
| 14 | +from azure.core.pipeline import policies |
| 15 | +from azure.core.rest import HttpRequest, HttpResponse |
| 16 | + |
| 17 | +from ._configuration import AIProjectClientConfiguration |
| 18 | +from ._serialization import Deserializer, Serializer |
| 19 | +from .operations import AgentsOperations, ConnectionsOperations, EvaluationsOperations, TelemetryOperations |
| 20 | + |
| 21 | +if TYPE_CHECKING: |
| 22 | + from azure.core.credentials import TokenCredential |
| 23 | + |
| 24 | + |
| 25 | +class AIProjectClient: |
| 26 | + """AIProjectClient. |
| 27 | +
|
| 28 | + :ivar agents: AgentsOperations operations |
| 29 | + :vartype agents: azure.ai.projects.operations.AgentsOperations |
| 30 | + :ivar connections: ConnectionsOperations operations |
| 31 | + :vartype connections: azure.ai.projects.operations.ConnectionsOperations |
| 32 | + :ivar telemetry: TelemetryOperations operations |
| 33 | + :vartype telemetry: azure.ai.projects.operations.TelemetryOperations |
| 34 | + :ivar evaluations: EvaluationsOperations operations |
| 35 | + :vartype evaluations: azure.ai.projects.operations.EvaluationsOperations |
| 36 | + :param endpoint: The Azure AI Studio project endpoint, in the form |
| 37 | + ``https://<azure-region>.api.azureml.ms`` or |
| 38 | + ``https://<private-link-guid>.<azure-region>.api.azureml.ms``\\\\ , where |
| 39 | + :code:`<azure-region>` is the Azure region where the project is deployed (e.g. westus) and |
| 40 | + :code:`<private-link-guid>` is the GUID of the Enterprise private link. Required. |
| 41 | + :type endpoint: str |
| 42 | + :param subscription_id: The Azure subscription ID. Required. |
| 43 | + :type subscription_id: str |
| 44 | + :param resource_group_name: The name of the Azure Resource Group. Required. |
| 45 | + :type resource_group_name: str |
| 46 | + :param project_name: The Azure AI Studio project name. Required. |
| 47 | + :type project_name: str |
| 48 | + :param credential: Credential used to authenticate requests to the service. Required. |
| 49 | + :type credential: ~azure.core.credentials.TokenCredential |
| 50 | + :keyword api_version: The API version to use for this operation. Default value is |
| 51 | + "2024-07-01-preview". Note that overriding this default value may result in unsupported |
| 52 | + behavior. |
| 53 | + :paramtype api_version: str |
| 54 | + """ |
| 55 | + |
| 56 | + def __init__( |
| 57 | + self, |
| 58 | + endpoint: str, |
| 59 | + subscription_id: str, |
| 60 | + resource_group_name: str, |
| 61 | + project_name: str, |
| 62 | + credential: "TokenCredential", |
| 63 | + **kwargs: Any |
| 64 | + ) -> None: |
| 65 | + _endpoint = "{endpoint}/agents/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{projectName}" # pylint: disable=line-too-long |
| 66 | + self._config = AIProjectClientConfiguration( |
| 67 | + endpoint=endpoint, |
| 68 | + subscription_id=subscription_id, |
| 69 | + resource_group_name=resource_group_name, |
| 70 | + project_name=project_name, |
| 71 | + credential=credential, |
| 72 | + **kwargs |
| 73 | + ) |
| 74 | + _policies = kwargs.pop("policies", None) |
| 75 | + if _policies is None: |
| 76 | + _policies = [ |
| 77 | + policies.RequestIdPolicy(**kwargs), |
| 78 | + self._config.headers_policy, |
| 79 | + self._config.user_agent_policy, |
| 80 | + self._config.proxy_policy, |
| 81 | + policies.ContentDecodePolicy(**kwargs), |
| 82 | + self._config.redirect_policy, |
| 83 | + self._config.retry_policy, |
| 84 | + self._config.authentication_policy, |
| 85 | + self._config.custom_hook_policy, |
| 86 | + self._config.logging_policy, |
| 87 | + policies.DistributedTracingPolicy(**kwargs), |
| 88 | + policies.SensitiveHeaderCleanupPolicy(**kwargs) if self._config.redirect_policy else None, |
| 89 | + self._config.http_logging_policy, |
| 90 | + ] |
| 91 | + self._client: PipelineClient = PipelineClient(base_url=_endpoint, policies=_policies, **kwargs) |
| 92 | + |
| 93 | + self._serialize = Serializer() |
| 94 | + self._deserialize = Deserializer() |
| 95 | + self._serialize.client_side_validation = False |
| 96 | + self.agents = AgentsOperations(self._client, self._config, self._serialize, self._deserialize) |
| 97 | + self.connections = ConnectionsOperations(self._client, self._config, self._serialize, self._deserialize) |
| 98 | + self.telemetry = TelemetryOperations(self._client, self._config, self._serialize, self._deserialize) |
| 99 | + self.evaluations = EvaluationsOperations(self._client, self._config, self._serialize, self._deserialize) |
| 100 | + |
| 101 | + def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> HttpResponse: |
| 102 | + """Runs the network request through the client's chained policies. |
| 103 | +
|
| 104 | + >>> from azure.core.rest import HttpRequest |
| 105 | + >>> request = HttpRequest("GET", "https://www.example.org/") |
| 106 | + <HttpRequest [GET], url: 'https://www.example.org/'> |
| 107 | + >>> response = client.send_request(request) |
| 108 | + <HttpResponse: 200 OK> |
| 109 | +
|
| 110 | + For more information on this code flow, see https://aka.ms/azsdk/dpcodegen/python/send_request |
| 111 | +
|
| 112 | + :param request: The network request you want to make. Required. |
| 113 | + :type request: ~azure.core.rest.HttpRequest |
| 114 | + :keyword bool stream: Whether the response payload will be streamed. Defaults to False. |
| 115 | + :return: The response of your network call. Does not do error handling on your response. |
| 116 | + :rtype: ~azure.core.rest.HttpResponse |
| 117 | + """ |
| 118 | + |
| 119 | + request_copy = deepcopy(request) |
| 120 | + path_format_arguments = { |
| 121 | + "endpoint": self._serialize.url("self._config.endpoint", self._config.endpoint, "str"), |
| 122 | + "subscriptionId": self._serialize.url("self._config.subscription_id", self._config.subscription_id, "str"), |
| 123 | + "resourceGroupName": self._serialize.url( |
| 124 | + "self._config.resource_group_name", self._config.resource_group_name, "str" |
| 125 | + ), |
| 126 | + "projectName": self._serialize.url("self._config.project_name", self._config.project_name, "str"), |
| 127 | + } |
| 128 | + |
| 129 | + request_copy.url = self._client.format_url(request_copy.url, **path_format_arguments) |
| 130 | + return self._client.send_request(request_copy, stream=stream, **kwargs) # type: ignore |
| 131 | + |
| 132 | + def close(self) -> None: |
| 133 | + self._client.close() |
| 134 | + |
| 135 | + def __enter__(self) -> Self: |
| 136 | + self._client.__enter__() |
| 137 | + return self |
| 138 | + |
| 139 | + def __exit__(self, *exc_details: Any) -> None: |
| 140 | + self._client.__exit__(*exc_details) |
0 commit comments