diff --git a/sdk/resources/azure-mgmt-resourcegraph/CHANGELOG.md b/sdk/resources/azure-mgmt-resourcegraph/CHANGELOG.md index 90d7ec87d454..14dff4864935 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/CHANGELOG.md +++ b/sdk/resources/azure-mgmt-resourcegraph/CHANGELOG.md @@ -1,5 +1,35 @@ # Release History +## 8.1.0b4 (2026-05-28) + +### Features Added + + - Client `ResourceGraphClient` added parameter `cloud_setting` in method `__init__` + - Client `ResourceGraphClient` added method `send_request` + - Client `ResourceGraphClient` added operation group `graph_query` + - Added enum `CreatedByType` + - Added model `ErrorFieldContract` + - Added model `GraphQueryError` + - Added model `GraphQueryErrorError` + - Added model `GraphQueryProperties` + - Added model `GraphQueryPropertiesUpdateParameters` + - Added model `GraphQueryResource` + - Added model `GraphQueryUpdateParameters` + - Added model `ProxyResource` + - Added model `Resource` + - Added enum `ResultKind` + - Added model `SystemData` + - Added model `GraphQueryOperations` + +### Breaking Changes + + - Method `ResourceGraphClient.__init__` inserted a `positional_or_keyword` parameter `subscription_id` + - Deleted or renamed model `Column` + - Deleted or renamed model `ColumnDataType` + - Deleted or renamed model `Table` + - Deleted or renamed model `ResourceGraphClientOperationsMixin` + - Method `ResourceGraphClient.resources_history` changed return type from `JSON` to `Any` + ## 8.0.1 (2025-11-24) ### Other Changes diff --git a/sdk/resources/azure-mgmt-resourcegraph/_metadata.json b/sdk/resources/azure-mgmt-resourcegraph/_metadata.json index ba8e504a54e1..2d8ee3faec7c 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/_metadata.json +++ b/sdk/resources/azure-mgmt-resourcegraph/_metadata.json @@ -1,11 +1,12 @@ { - "commit": "e96c24570a484cff13d153fb472f812878866a39", + "apiVersions": { + "GraphQueryApi": "2024-04-01", + "ResourceChanges": "2020-09-01-preview", + "ResourceGraphApi": "2024-04-01", + "ResourceHistory": "2021-06-01-preview" + }, + "commit": "cb62053a18882dd258d9922be9770702b7ef6ac9", "repository_url": "https://github.com/Azure/azure-rest-api-specs", - "autorest": "3.10.2", - "use": [ - "@autorest/python@6.42.0", - "@autorest/modelerfour@4.27.0" - ], - "autorest_command": "autorest specification/resourcegraph/resource-manager/readme.md --generate-sample=True --generate-test=True --include-x-ms-examples-original-file=True --package-mode=azure-mgmt --python --python-sdks-folder=/mnt/vss/_work/1/azure-sdk-for-python/sdk --tag=package-2021-03 --use=@autorest/python@6.42.0 --use=@autorest/modelerfour@4.27.0 --version=3.10.2 --version-tolerant=False", - "readme": "specification/resourcegraph/resource-manager/readme.md" + "typespec_src": "specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/ResourceGraph", + "emitterVersion": "0.62.1" } \ No newline at end of file diff --git a/sdk/resources/azure-mgmt-resourcegraph/apiview-properties.json b/sdk/resources/azure-mgmt-resourcegraph/apiview-properties.json index a11ec9866887..6afe19048e81 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/apiview-properties.json +++ b/sdk/resources/azure-mgmt-resourcegraph/apiview-properties.json @@ -1,49 +1,72 @@ { - "CrossLanguagePackageId": null, + "CrossLanguagePackageId": "ResourceChanges", "CrossLanguageDefinitionId": { - "azure.mgmt.resourcegraph.models.Column": null, - "azure.mgmt.resourcegraph.models.Error": null, - "azure.mgmt.resourcegraph.models.ErrorDetails": null, - "azure.mgmt.resourcegraph.models.ErrorFieldContract": null, - "azure.mgmt.resourcegraph.models.ErrorResponse": null, - "azure.mgmt.resourcegraph.models.Facet": null, - "azure.mgmt.resourcegraph.models.FacetError": null, - "azure.mgmt.resourcegraph.models.FacetRequest": null, - "azure.mgmt.resourcegraph.models.FacetRequestOptions": null, - "azure.mgmt.resourcegraph.models.FacetResult": null, - "azure.mgmt.resourcegraph.models.GraphQueryError": null, - "azure.mgmt.resourcegraph.models.GraphQueryErrorError": null, - "azure.mgmt.resourcegraph.models.GraphQueryListResult": null, - "azure.mgmt.resourcegraph.models.Resource": null, - "azure.mgmt.resourcegraph.models.GraphQueryResource": null, - "azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters": null, - "azure.mgmt.resourcegraph.models.Operation": null, - "azure.mgmt.resourcegraph.models.OperationDisplay": null, - "azure.mgmt.resourcegraph.models.OperationListResult": null, - "azure.mgmt.resourcegraph.models.QueryRequest": null, - "azure.mgmt.resourcegraph.models.QueryRequestOptions": null, - "azure.mgmt.resourcegraph.models.QueryResponse": null, - "azure.mgmt.resourcegraph.models.Table": null, - "azure.mgmt.resourcegraph.models.FacetSortOrder": null, - "azure.mgmt.resourcegraph.models.ResultKind": null, - "azure.mgmt.resourcegraph.models.ColumnDataType": null, - "azure.mgmt.resourcegraph.models.ResultFormat": null, - "azure.mgmt.resourcegraph.models.ResultTruncated": null, - "azure.mgmt.resourcegraph.ResourceGraphClient.resources": null, - "azure.mgmt.resourcegraph.aio.ResourceGraphClient.resources": null, - "azure.mgmt.resourcegraph.operations.Operations.list": null, - "azure.mgmt.resourcegraph.aio.operations.Operations.list": null, - "azure.mgmt.resourcegraph.operations.GraphQueryOperations.list_by_subscription": null, - "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.list_by_subscription": null, - "azure.mgmt.resourcegraph.operations.GraphQueryOperations.list": null, - "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.list": null, - "azure.mgmt.resourcegraph.operations.GraphQueryOperations.get": null, - "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.get": null, - "azure.mgmt.resourcegraph.operations.GraphQueryOperations.delete": null, - "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.delete": null, - "azure.mgmt.resourcegraph.operations.GraphQueryOperations.create_or_update": null, - "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.create_or_update": null, - "azure.mgmt.resourcegraph.operations.GraphQueryOperations.update": null, - "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.update": null - } + "azure.mgmt.resourcegraph.models.DateTimeInterval": "ResourceGraphCommon.DateTimeInterval", + "azure.mgmt.resourcegraph.models.Error": "ResourceGraphCommon.Error", + "azure.mgmt.resourcegraph.models.ErrorDetails": "ResourceGraphCommon.ErrorDetails", + "azure.mgmt.resourcegraph.models.ErrorFieldContract": "GraphQueryApi.ErrorFieldContract", + "azure.mgmt.resourcegraph.models.ErrorResponse": "ResourceGraphCommon.ErrorResponse", + "azure.mgmt.resourcegraph.models.Facet": "ResourceGraphApi.Facet", + "azure.mgmt.resourcegraph.models.FacetError": "ResourceGraphApi.FacetError", + "azure.mgmt.resourcegraph.models.FacetRequest": "ResourceGraphApi.FacetRequest", + "azure.mgmt.resourcegraph.models.FacetRequestOptions": "ResourceGraphApi.FacetRequestOptions", + "azure.mgmt.resourcegraph.models.FacetResult": "ResourceGraphApi.FacetResult", + "azure.mgmt.resourcegraph.models.GraphQueryError": "GraphQueryApi.GraphQueryError", + "azure.mgmt.resourcegraph.models.GraphQueryErrorError": "GraphQueryApi.GraphQueryErrorError", + "azure.mgmt.resourcegraph.models.GraphQueryProperties": "GraphQueryApi.GraphQueryProperties", + "azure.mgmt.resourcegraph.models.GraphQueryPropertiesUpdateParameters": "GraphQueryApi.GraphQueryPropertiesUpdateParameters", + "azure.mgmt.resourcegraph.models.Resource": "Azure.ResourceManager.CommonTypes.Resource", + "azure.mgmt.resourcegraph.models.ProxyResource": "Azure.ResourceManager.CommonTypes.ProxyResource", + "azure.mgmt.resourcegraph.models.GraphQueryResource": "GraphQueryApi.GraphQueryResource", + "azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters": "GraphQueryApi.GraphQueryUpdateParameters", + "azure.mgmt.resourcegraph.models.Operation": "ResourceGraphApi.Operation", + "azure.mgmt.resourcegraph.models.OperationDisplay": "ResourceGraphApi.OperationDisplay", + "azure.mgmt.resourcegraph.models.QueryRequest": "ResourceGraphApi.QueryRequest", + "azure.mgmt.resourcegraph.models.QueryRequestOptions": "ResourceGraphApi.QueryRequestOptions", + "azure.mgmt.resourcegraph.models.QueryResponse": "ResourceGraphApi.QueryResponse", + "azure.mgmt.resourcegraph.models.ResourceChangeData": "ResourceChanges.ResourceChangeData", + "azure.mgmt.resourcegraph.models.ResourceSnapshotData": "ResourceChanges.ResourceSnapshotData", + "azure.mgmt.resourcegraph.models.ResourceChangeDataAfterSnapshot": "ResourceChanges.ResourceChangeDataAfterSnapshot", + "azure.mgmt.resourcegraph.models.ResourceChangeDataBeforeSnapshot": "ResourceChanges.ResourceChangeDataBeforeSnapshot", + "azure.mgmt.resourcegraph.models.ResourceChangeDetailsRequestParameters": "ResourceChanges.ResourceChangeDetailsRequestParameters", + "azure.mgmt.resourcegraph.models.ResourceChangeList": "ResourceChanges.ResourceChangeList", + "azure.mgmt.resourcegraph.models.ResourceChangesRequestParameters": "ResourceChanges.ResourceChangesRequestParameters", + "azure.mgmt.resourcegraph.models.ResourceChangesRequestParametersInterval": "ResourceChanges.ResourceChangesRequestParametersInterval", + "azure.mgmt.resourcegraph.models.ResourcePropertyChange": "ResourceChanges.ResourcePropertyChange", + "azure.mgmt.resourcegraph.models.ResourcesHistoryRequest": "ResourceHistory.ResourcesHistoryRequest", + "azure.mgmt.resourcegraph.models.ResourcesHistoryRequestOptions": "ResourceHistory.ResourcesHistoryRequestOptions", + "azure.mgmt.resourcegraph.models.SystemData": "Azure.ResourceManager.CommonTypes.SystemData", + "azure.mgmt.resourcegraph.models.CreatedByType": "Azure.ResourceManager.CommonTypes.createdByType", + "azure.mgmt.resourcegraph.models.ResultKind": "GraphQueryApi.ResultKind", + "azure.mgmt.resourcegraph.models.ChangeType": "ResourceChanges.ChangeType", + "azure.mgmt.resourcegraph.models.ChangeCategory": "ResourceChanges.ChangeCategory", + "azure.mgmt.resourcegraph.models.PropertyChangeType": "ResourceChanges.PropertyChangeType", + "azure.mgmt.resourcegraph.models.ResultTruncated": "ResourceGraphApi.ResultTruncated", + "azure.mgmt.resourcegraph.models.ResultFormat": "ResourceGraphCommon.ResultFormat", + "azure.mgmt.resourcegraph.models.AuthorizationScopeFilter": "ResourceGraphApi.AuthorizationScopeFilter", + "azure.mgmt.resourcegraph.models.FacetSortOrder": "ResourceGraphApi.FacetSortOrder", + "azure.mgmt.resourcegraph.operations.Operations.list": "Azure.ResourceManager.Legacy.Operations.list", + "azure.mgmt.resourcegraph.aio.operations.Operations.list": "Azure.ResourceManager.Legacy.Operations.list", + "azure.mgmt.resourcegraph.operations.GraphQueryOperations.get": "GraphQueryApi.GraphQueryResources.get", + "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.get": "GraphQueryApi.GraphQueryResources.get", + "azure.mgmt.resourcegraph.operations.GraphQueryOperations.create_or_update": "GraphQueryApi.GraphQueryResources.createOrUpdate", + "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.create_or_update": "GraphQueryApi.GraphQueryResources.createOrUpdate", + "azure.mgmt.resourcegraph.operations.GraphQueryOperations.update": "GraphQueryApi.GraphQueryResources.update", + "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.update": "GraphQueryApi.GraphQueryResources.update", + "azure.mgmt.resourcegraph.operations.GraphQueryOperations.delete": "GraphQueryApi.GraphQueryResources.delete", + "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.delete": "GraphQueryApi.GraphQueryResources.delete", + "azure.mgmt.resourcegraph.operations.GraphQueryOperations.list": "GraphQueryApi.GraphQueryResources.list", + "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.list": "GraphQueryApi.GraphQueryResources.list", + "azure.mgmt.resourcegraph.operations.GraphQueryOperations.list_by_subscription": "GraphQueryApi.GraphQueryResources.listBySubscription", + "azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations.list_by_subscription": "GraphQueryApi.GraphQueryResources.listBySubscription", + "azure.mgmt.resourcegraph.ResourceGraphClient.resource_changes": "ResourceChanges.resourceChanges", + "azure.mgmt.resourcegraph.aio.ResourceGraphClient.resource_changes": "ResourceChanges.resourceChanges", + "azure.mgmt.resourcegraph.ResourceGraphClient.resource_change_details": "ResourceChanges.resourceChangeDetails", + "azure.mgmt.resourcegraph.aio.ResourceGraphClient.resource_change_details": "ResourceChanges.resourceChangeDetails", + "azure.mgmt.resourcegraph.ResourceGraphClient.resources": "ResourceGraphApi.resources", + "azure.mgmt.resourcegraph.aio.ResourceGraphClient.resources": "ResourceGraphApi.resources", + "azure.mgmt.resourcegraph.ResourceGraphClient.resources_history": "ResourceHistory.resourcesHistory", + "azure.mgmt.resourcegraph.aio.ResourceGraphClient.resources_history": "ResourceHistory.resourcesHistory" + }, + "CrossLanguageVersion": "c38463afc85a" } \ No newline at end of file diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/__init__.py b/sdk/resources/azure-mgmt-resourcegraph/azure/__init__.py index 8db66d3d0f0f..d55ccad1f573 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/__init__.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/__init__.py @@ -1 +1 @@ -__path__ = __import__("pkgutil").extend_path(__path__, __name__) +__path__ = __import__("pkgutil").extend_path(__path__, __name__) # type: ignore diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/__init__.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/__init__.py index 8db66d3d0f0f..d55ccad1f573 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/__init__.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/__init__.py @@ -1 +1 @@ -__path__ = __import__("pkgutil").extend_path(__path__, __name__) +__path__ = __import__("pkgutil").extend_path(__path__, __name__) # type: ignore diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/__init__.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/__init__.py index 9688d95b8085..91607ad8ade8 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/__init__.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/__init__.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- # pylint: disable=wrong-import-position @@ -12,7 +12,7 @@ if TYPE_CHECKING: from ._patch import * # pylint: disable=unused-wildcard-import -from ._resource_graph_client import ResourceGraphClient # type: ignore +from ._client import ResourceGraphClient # type: ignore from ._version import VERSION __version__ = VERSION diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_resource_graph_client.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_client.py similarity index 76% rename from sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_resource_graph_client.py rename to sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_client.py index fe919c1c45e2..75e1dd357712 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_resource_graph_client.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_client.py @@ -2,13 +2,13 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- from copy import deepcopy +import sys from typing import Any, Optional, TYPE_CHECKING, cast -from typing_extensions import Self from azure.core.pipeline import policies from azure.core.rest import HttpRequest, HttpResponse @@ -17,50 +17,60 @@ from azure.mgmt.core.policies import ARMAutoResourceProviderRegistrationPolicy from azure.mgmt.core.tools import get_arm_endpoints -from . import models as _models from ._configuration import ResourceGraphClientConfiguration from ._utils.serialization import Deserializer, Serializer from .operations import GraphQueryOperations, Operations, _ResourceGraphClientOperationsMixin +if sys.version_info >= (3, 11): + from typing import Self +else: + from typing_extensions import Self # type: ignore + if TYPE_CHECKING: from azure.core import AzureClouds from azure.core.credentials import TokenCredential -class ResourceGraphClient(_ResourceGraphClientOperationsMixin): - """Azure Resource Graph API Reference. +class ResourceGraphClient(_ResourceGraphClientOperationsMixin): # pylint: disable=client-accepts-api-version-keyword + """ResourceGraphClient. :ivar operations: Operations operations :vartype operations: azure.mgmt.resourcegraph.operations.Operations :ivar graph_query: GraphQueryOperations operations :vartype graph_query: azure.mgmt.resourcegraph.operations.GraphQueryOperations - :param credential: Credential needed for the client to connect to Azure. Required. + :param credential: Credential used to authenticate requests to the service. Required. :type credential: ~azure.core.credentials.TokenCredential - :param base_url: Service URL. Default value is None. + :param subscription_id: The ID of the target subscription. The value must be an UUID. Required. + :type subscription_id: str + :param base_url: Service host. Default value is None. :type base_url: str :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is None. :paramtype cloud_setting: ~azure.core.AzureClouds - :keyword api_version: Api Version. Default value is "2021-03-01". Note that overriding this - default value may result in unsupported behavior. - :paramtype api_version: str """ def __init__( self, credential: "TokenCredential", + subscription_id: str, base_url: Optional[str] = None, *, cloud_setting: Optional["AzureClouds"] = None, **kwargs: Any ) -> None: + _endpoint = "{endpoint}" _cloud = cloud_setting or settings.current.azure_cloud # type: ignore _endpoints = get_arm_endpoints(_cloud) if not base_url: base_url = _endpoints["resource_manager"] credential_scopes = kwargs.pop("credential_scopes", _endpoints["credential_scopes"]) self._config = ResourceGraphClientConfiguration( - credential=credential, cloud_setting=cloud_setting, credential_scopes=credential_scopes, **kwargs + credential=credential, + subscription_id=subscription_id, + base_url=cast(str, base_url), + cloud_setting=cloud_setting, + credential_scopes=credential_scopes, + **kwargs ) _policies = kwargs.pop("policies", None) @@ -81,22 +91,21 @@ def __init__( policies.SensitiveHeaderCleanupPolicy(**kwargs) if self._config.redirect_policy else None, self._config.http_logging_policy, ] - self._client: ARMPipelineClient = ARMPipelineClient(base_url=cast(str, base_url), policies=_policies, **kwargs) + self._client: ARMPipelineClient = ARMPipelineClient(base_url=cast(str, _endpoint), policies=_policies, **kwargs) - client_models = {k: v for k, v in _models.__dict__.items() if isinstance(v, type)} - self._serialize = Serializer(client_models) - self._deserialize = Deserializer(client_models) + self._serialize = Serializer() + self._deserialize = Deserializer() self._serialize.client_side_validation = False self.operations = Operations(self._client, self._config, self._serialize, self._deserialize) self.graph_query = GraphQueryOperations(self._client, self._config, self._serialize, self._deserialize) - def _send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> HttpResponse: + def send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: Any) -> HttpResponse: """Runs the network request through the client's chained policies. >>> from azure.core.rest import HttpRequest >>> request = HttpRequest("GET", "https://www.example.org/") - >>> response = client._send_request(request) + >>> response = client.send_request(request) For more information on this code flow, see https://aka.ms/azsdk/dpcodegen/python/send_request @@ -109,7 +118,11 @@ def _send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs: """ request_copy = deepcopy(request) - request_copy.url = self._client.format_url(request_copy.url) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + + request_copy.url = self._client.format_url(request_copy.url, **path_format_arguments) return self._client.send_request(request_copy, stream=stream, **kwargs) # type: ignore def close(self) -> None: diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_configuration.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_configuration.py index ca2704079c98..7dba099369d8 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_configuration.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_configuration.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -24,27 +24,34 @@ class ResourceGraphClientConfiguration: # pylint: disable=too-many-instance-att Note that all parameters used to create this instance are saved as instance attributes. - :param credential: Credential needed for the client to connect to Azure. Required. + :param credential: Credential used to authenticate requests to the service. Required. :type credential: ~azure.core.credentials.TokenCredential + :param subscription_id: The ID of the target subscription. The value must be an UUID. Required. + :type subscription_id: str + :param base_url: Service host. Default value is "https://management.azure.com". + :type base_url: str :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is None. :type cloud_setting: ~azure.core.AzureClouds - :keyword api_version: Api Version. Default value is "2021-03-01". Note that overriding this - default value may result in unsupported behavior. - :paramtype api_version: str """ def __init__( - self, credential: "TokenCredential", cloud_setting: Optional["AzureClouds"] = None, **kwargs: Any + self, + credential: "TokenCredential", + subscription_id: str, + base_url: str = "https://management.azure.com", + cloud_setting: Optional["AzureClouds"] = None, + **kwargs: Any ) -> None: - api_version: str = kwargs.pop("api_version", "2021-03-01") - if credential is None: raise ValueError("Parameter 'credential' must not be None.") + if subscription_id is None: + raise ValueError("Parameter 'subscription_id' must not be None.") self.credential = credential + self.subscription_id = subscription_id + self.base_url = base_url self.cloud_setting = cloud_setting - self.api_version = api_version self.credential_scopes = kwargs.pop("credential_scopes", ["https://management.azure.com/.default"]) kwargs.setdefault("sdk_moniker", "mgmt-resourcegraph/{}".format(VERSION)) self.polling_interval = kwargs.get("polling_interval", 30) diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_patch.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_patch.py index f7dd32510333..ea765788358a 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_patch.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_patch.py @@ -1,14 +1,14 @@ -# ------------------------------------ -# Copyright (c) Microsoft Corporation. -# Licensed under the MIT License. -# ------------------------------------ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# -------------------------------------------------------------------------- """Customize generated code here. Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import List -__all__: List[str] = [] # Add all objects you want publicly available to users at this package level +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/__init__.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/__init__.py index 0af9b28f6607..8026245c2abc 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/__init__.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/__init__.py @@ -1,6 +1,6 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/model_base.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/model_base.py new file mode 100644 index 000000000000..d725c55906d3 --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/model_base.py @@ -0,0 +1,1737 @@ +# pylint: disable=line-too-long,useless-suppression,too-many-lines +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- +# pylint: disable=protected-access, broad-except + +import copy +import calendar +import decimal +import functools +import sys +import logging +import base64 +import re +import typing +import enum +import email.utils +from datetime import datetime, date, time, timedelta, timezone +from json import JSONEncoder +import xml.etree.ElementTree as ET +from collections.abc import MutableMapping +import isodate +from azure.core.exceptions import DeserializationError +from azure.core import CaseInsensitiveEnumMeta +from azure.core.pipeline import PipelineResponse +from azure.core.serialization import _Null + +from azure.core.rest import HttpResponse + +if sys.version_info >= (3, 11): + from typing import Self +else: + from typing_extensions import Self + +_LOGGER = logging.getLogger(__name__) + +__all__ = ["SdkJSONEncoder", "Model", "rest_field", "rest_discriminator"] + +TZ_UTC = timezone.utc +_T = typing.TypeVar("_T") +_NONE_TYPE = type(None) + + +def _timedelta_as_isostr(td: timedelta) -> str: + """Converts a datetime.timedelta object into an ISO 8601 formatted string, e.g. 'P4DT12H30M05S' + + Function adapted from the Tin Can Python project: https://github.com/RusticiSoftware/TinCanPython + + :param timedelta td: The timedelta to convert + :rtype: str + :return: ISO8601 version of this timedelta + """ + + # Split seconds to larger units + seconds = td.total_seconds() + minutes, seconds = divmod(seconds, 60) + hours, minutes = divmod(minutes, 60) + days, hours = divmod(hours, 24) + + days, hours, minutes = list(map(int, (days, hours, minutes))) + seconds = round(seconds, 6) + + # Build date + date_str = "" + if days: + date_str = "%sD" % days + + if hours or minutes or seconds: + # Build time + time_str = "T" + + # Hours + bigger_exists = date_str or hours + if bigger_exists: + time_str += "{:02}H".format(hours) + + # Minutes + bigger_exists = bigger_exists or minutes + if bigger_exists: + time_str += "{:02}M".format(minutes) + + # Seconds + try: + if seconds.is_integer(): + seconds_string = "{:02}".format(int(seconds)) + else: + # 9 chars long w/ leading 0, 6 digits after decimal + seconds_string = "%09.6f" % seconds + # Remove trailing zeros + seconds_string = seconds_string.rstrip("0") + except AttributeError: # int.is_integer() raises + seconds_string = "{:02}".format(seconds) + + time_str += "{}S".format(seconds_string) + else: + time_str = "" + + return "P" + date_str + time_str + + +def _serialize_bytes(o, format: typing.Optional[str] = None) -> str: + encoded = base64.b64encode(o).decode() + if format == "base64url": + return encoded.strip("=").replace("+", "-").replace("/", "_") + return encoded + + +def _serialize_datetime(o, format: typing.Optional[str] = None): + if hasattr(o, "year") and hasattr(o, "hour"): + if format == "rfc7231": + return email.utils.format_datetime(o, usegmt=True) + if format == "unix-timestamp": + return int(calendar.timegm(o.utctimetuple())) + + # astimezone() fails for naive times in Python 2.7, so make make sure o is aware (tzinfo is set) + if not o.tzinfo: + iso_formatted = o.replace(tzinfo=TZ_UTC).isoformat() + else: + iso_formatted = o.astimezone(TZ_UTC).isoformat() + # Replace the trailing "+00:00" UTC offset with "Z" (RFC 3339: https://www.ietf.org/rfc/rfc3339.txt) + return iso_formatted.replace("+00:00", "Z") + # Next try datetime.date or datetime.time + return o.isoformat() + + +def _is_readonly(p): + try: + return p._visibility == ["read"] + except AttributeError: + return False + + +class SdkJSONEncoder(JSONEncoder): + """A JSON encoder that's capable of serializing datetime objects and bytes.""" + + def __init__(self, *args, exclude_readonly: bool = False, format: typing.Optional[str] = None, **kwargs): + super().__init__(*args, **kwargs) + self.exclude_readonly = exclude_readonly + self.format = format + + def default(self, o): # pylint: disable=too-many-return-statements + if _is_model(o): + if self.exclude_readonly: + readonly_props = [p._rest_name for p in o._attr_to_rest_field.values() if _is_readonly(p)] + return {k: v for k, v in o.items() if k not in readonly_props} + return dict(o.items()) + try: + return super(SdkJSONEncoder, self).default(o) + except TypeError: + if isinstance(o, _Null): + return None + if isinstance(o, decimal.Decimal): + return float(o) + if isinstance(o, (bytes, bytearray)): + return _serialize_bytes(o, self.format) + try: + # First try datetime.datetime + return _serialize_datetime(o, self.format) + except AttributeError: + pass + # Last, try datetime.timedelta + try: + return _timedelta_as_isostr(o) + except AttributeError: + # This will be raised when it hits value.total_seconds in the method above + pass + return super(SdkJSONEncoder, self).default(o) + + +_VALID_DATE = re.compile(r"\d{4}[-]\d{2}[-]\d{2}T\d{2}:\d{2}:\d{2}" + r"\.?\d*Z?[-+]?[\d{2}]?:?[\d{2}]?") +_VALID_RFC7231 = re.compile( + r"(Mon|Tue|Wed|Thu|Fri|Sat|Sun),\s\d{2}\s" + r"(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s\d{4}\s\d{2}:\d{2}:\d{2}\sGMT" +) + +_ARRAY_ENCODE_MAPPING = { + "pipeDelimited": "|", + "spaceDelimited": " ", + "commaDelimited": ",", + "newlineDelimited": "\n", +} + + +def _deserialize_array_encoded(delimit: str, attr): + if isinstance(attr, str): + if attr == "": + return [] + return attr.split(delimit) + return attr + + +def _deserialize_datetime(attr: typing.Union[str, datetime]) -> datetime: + """Deserialize ISO-8601 formatted string into Datetime object. + + :param str attr: response string to be deserialized. + :rtype: ~datetime.datetime + :returns: The datetime object from that input + """ + if isinstance(attr, datetime): + # i'm already deserialized + return attr + attr = attr.upper() + match = _VALID_DATE.match(attr) + if not match: + raise ValueError("Invalid datetime string: " + attr) + + check_decimal = attr.split(".") + if len(check_decimal) > 1: + decimal_str = "" + for digit in check_decimal[1]: + if digit.isdigit(): + decimal_str += digit + else: + break + if len(decimal_str) > 6: + attr = attr.replace(decimal_str, decimal_str[0:6]) + + date_obj = isodate.parse_datetime(attr) + test_utc = date_obj.utctimetuple() + if test_utc.tm_year > 9999 or test_utc.tm_year < 1: + raise OverflowError("Hit max or min date") + return date_obj # type: ignore[no-any-return] + + +def _deserialize_datetime_rfc7231(attr: typing.Union[str, datetime]) -> datetime: + """Deserialize RFC7231 formatted string into Datetime object. + + :param str attr: response string to be deserialized. + :rtype: ~datetime.datetime + :returns: The datetime object from that input + """ + if isinstance(attr, datetime): + # i'm already deserialized + return attr + match = _VALID_RFC7231.match(attr) + if not match: + raise ValueError("Invalid datetime string: " + attr) + + return email.utils.parsedate_to_datetime(attr) + + +def _deserialize_datetime_unix_timestamp(attr: typing.Union[float, datetime]) -> datetime: + """Deserialize unix timestamp into Datetime object. + + :param str attr: response string to be deserialized. + :rtype: ~datetime.datetime + :returns: The datetime object from that input + """ + if isinstance(attr, datetime): + # i'm already deserialized + return attr + return datetime.fromtimestamp(attr, TZ_UTC) + + +def _deserialize_date(attr: typing.Union[str, date]) -> date: + """Deserialize ISO-8601 formatted string into Date object. + :param str attr: response string to be deserialized. + :rtype: date + :returns: The date object from that input + """ + # This must NOT use defaultmonth/defaultday. Using None ensure this raises an exception. + if isinstance(attr, date): + return attr + return isodate.parse_date(attr, defaultmonth=None, defaultday=None) # type: ignore + + +def _deserialize_time(attr: typing.Union[str, time]) -> time: + """Deserialize ISO-8601 formatted string into time object. + + :param str attr: response string to be deserialized. + :rtype: datetime.time + :returns: The time object from that input + """ + if isinstance(attr, time): + return attr + return isodate.parse_time(attr) # type: ignore[no-any-return] + + +def _deserialize_bytes(attr): + if isinstance(attr, (bytes, bytearray)): + return attr + return bytes(base64.b64decode(attr)) + + +def _deserialize_bytes_base64(attr): + if isinstance(attr, (bytes, bytearray)): + return attr + padding = "=" * (3 - (len(attr) + 3) % 4) # type: ignore + attr = attr + padding # type: ignore + encoded = attr.replace("-", "+").replace("_", "/") + return bytes(base64.b64decode(encoded)) + + +def _deserialize_duration(attr): + if isinstance(attr, timedelta): + return attr + return isodate.parse_duration(attr) + + +def _deserialize_decimal(attr): + if isinstance(attr, decimal.Decimal): + return attr + return decimal.Decimal(str(attr)) + + +def _deserialize_int_as_str(attr): + if isinstance(attr, int): + return attr + return int(attr) + + +_DESERIALIZE_MAPPING = { + datetime: _deserialize_datetime, + date: _deserialize_date, + time: _deserialize_time, + bytes: _deserialize_bytes, + bytearray: _deserialize_bytes, + timedelta: _deserialize_duration, + typing.Any: lambda x: x, + decimal.Decimal: _deserialize_decimal, +} + +_DESERIALIZE_MAPPING_WITHFORMAT = { + "rfc3339": _deserialize_datetime, + "rfc7231": _deserialize_datetime_rfc7231, + "unix-timestamp": _deserialize_datetime_unix_timestamp, + "base64": _deserialize_bytes, + "base64url": _deserialize_bytes_base64, +} + + +def get_deserializer(annotation: typing.Any, rf: typing.Optional["_RestField"] = None): + if annotation is int and rf and rf._format == "str": + return _deserialize_int_as_str + if annotation is str and rf and rf._format in _ARRAY_ENCODE_MAPPING: + return functools.partial(_deserialize_array_encoded, _ARRAY_ENCODE_MAPPING[rf._format]) + if rf and rf._format: + return _DESERIALIZE_MAPPING_WITHFORMAT.get(rf._format) + return _DESERIALIZE_MAPPING.get(annotation) # pyright: ignore + + +def _get_type_alias_type(module_name: str, alias_name: str): + types = { + k: v + for k, v in sys.modules[module_name].__dict__.items() + if isinstance(v, typing._GenericAlias) # type: ignore + } + if alias_name not in types: + return alias_name + return types[alias_name] + + +def _get_model(module_name: str, model_name: str): + models = {k: v for k, v in sys.modules[module_name].__dict__.items() if isinstance(v, type)} + module_end = module_name.rsplit(".", 1)[0] + models.update({k: v for k, v in sys.modules[module_end].__dict__.items() if isinstance(v, type)}) + if isinstance(model_name, str): + model_name = model_name.split(".")[-1] + if model_name not in models: + return model_name + return models[model_name] + + +_UNSET = object() + + +class _MyMutableMapping(MutableMapping[str, typing.Any]): + def __init__(self, data: dict[str, typing.Any]) -> None: + self._data = data + + def __contains__(self, key: typing.Any) -> bool: + return key in self._data + + def __getitem__(self, key: str) -> typing.Any: + # If this key has been deserialized (for mutable types), we need to handle serialization + if hasattr(self, "_attr_to_rest_field"): + cache_attr = f"_deserialized_{key}" + if hasattr(self, cache_attr): + rf = _get_rest_field(getattr(self, "_attr_to_rest_field"), key) + if rf: + value = self._data.get(key) + if isinstance(value, (dict, list, set)): + # For mutable types, serialize and return + # But also update _data with serialized form and clear flag + # so mutations via this returned value affect _data + serialized = _serialize(value, rf._format) + # If serialized form is same type (no transformation needed), + # return _data directly so mutations work + if isinstance(serialized, type(value)) and serialized == value: + return self._data.get(key) + # Otherwise return serialized copy and clear flag + try: + object.__delattr__(self, cache_attr) + except AttributeError: + pass + # Store serialized form back + self._data[key] = serialized + return serialized + return self._data.__getitem__(key) + + def __setitem__(self, key: str, value: typing.Any) -> None: + # Clear any cached deserialized value when setting through dictionary access + cache_attr = f"_deserialized_{key}" + try: + object.__delattr__(self, cache_attr) + except AttributeError: + pass + self._data.__setitem__(key, value) + + def __delitem__(self, key: str) -> None: + self._data.__delitem__(key) + + def __iter__(self) -> typing.Iterator[typing.Any]: + return self._data.__iter__() + + def __len__(self) -> int: + return self._data.__len__() + + def __ne__(self, other: typing.Any) -> bool: + return not self.__eq__(other) + + def keys(self) -> typing.KeysView[str]: + """ + :returns: a set-like object providing a view on D's keys + :rtype: ~typing.KeysView + """ + return self._data.keys() + + def values(self) -> typing.ValuesView[typing.Any]: + """ + :returns: an object providing a view on D's values + :rtype: ~typing.ValuesView + """ + return self._data.values() + + def items(self) -> typing.ItemsView[str, typing.Any]: + """ + :returns: set-like object providing a view on D's items + :rtype: ~typing.ItemsView + """ + return self._data.items() + + def get(self, key: str, default: typing.Any = None) -> typing.Any: + """ + Get the value for key if key is in the dictionary, else default. + :param str key: The key to look up. + :param any default: The value to return if key is not in the dictionary. Defaults to None + :returns: D[k] if k in D, else d. + :rtype: any + """ + try: + return self[key] + except KeyError: + return default + + @typing.overload + def pop(self, key: str) -> typing.Any: ... # pylint: disable=arguments-differ + + @typing.overload + def pop(self, key: str, default: _T) -> _T: ... # pylint: disable=signature-differs + + @typing.overload + def pop(self, key: str, default: typing.Any) -> typing.Any: ... # pylint: disable=signature-differs + + def pop(self, key: str, default: typing.Any = _UNSET) -> typing.Any: + """ + Removes specified key and return the corresponding value. + :param str key: The key to pop. + :param any default: The value to return if key is not in the dictionary + :returns: The value corresponding to the key. + :rtype: any + :raises KeyError: If key is not found and default is not given. + """ + if default is _UNSET: + return self._data.pop(key) + return self._data.pop(key, default) + + def popitem(self) -> tuple[str, typing.Any]: + """ + Removes and returns some (key, value) pair + :returns: The (key, value) pair. + :rtype: tuple + :raises KeyError: if D is empty. + """ + return self._data.popitem() + + def clear(self) -> None: + """ + Remove all items from D. + """ + self._data.clear() + + def update(self, *args: typing.Any, **kwargs: typing.Any) -> None: # pylint: disable=arguments-differ + """ + Updates D from mapping/iterable E and F. + :param any args: Either a mapping object or an iterable of key-value pairs. + """ + self._data.update(*args, **kwargs) + + @typing.overload + def setdefault(self, key: str, default: None = None) -> None: ... + + @typing.overload + def setdefault(self, key: str, default: typing.Any) -> typing.Any: ... # pylint: disable=signature-differs + + def setdefault(self, key: str, default: typing.Any = _UNSET) -> typing.Any: + """ + Same as calling D.get(k, d), and setting D[k]=d if k not found + :param str key: The key to look up. + :param any default: The value to set if key is not in the dictionary + :returns: D[k] if k in D, else d. + :rtype: any + """ + if default is _UNSET: + return self._data.setdefault(key) + return self._data.setdefault(key, default) + + def __eq__(self, other: typing.Any) -> bool: + if isinstance(other, _MyMutableMapping): + return self._data == other._data + try: + other_model = self.__class__(other) + except Exception: + return False + return self._data == other_model._data + + def __repr__(self) -> str: + return str(self._data) + + +def _is_model(obj: typing.Any) -> bool: + return getattr(obj, "_is_model", False) + + +def _serialize(o, format: typing.Optional[str] = None): # pylint: disable=too-many-return-statements + if isinstance(o, list): + if format in _ARRAY_ENCODE_MAPPING and all(isinstance(x, str) for x in o): + return _ARRAY_ENCODE_MAPPING[format].join(o) + return [_serialize(x, format) for x in o] + if isinstance(o, dict): + return {k: _serialize(v, format) for k, v in o.items()} + if isinstance(o, set): + return {_serialize(x, format) for x in o} + if isinstance(o, tuple): + return tuple(_serialize(x, format) for x in o) + if isinstance(o, (bytes, bytearray)): + return _serialize_bytes(o, format) + if isinstance(o, decimal.Decimal): + return float(o) + if isinstance(o, enum.Enum): + return o.value + if isinstance(o, int): + if format == "str": + return str(o) + return o + try: + # First try datetime.datetime + return _serialize_datetime(o, format) + except AttributeError: + pass + # Last, try datetime.timedelta + try: + return _timedelta_as_isostr(o) + except AttributeError: + # This will be raised when it hits value.total_seconds in the method above + pass + return o + + +def _get_rest_field(attr_to_rest_field: dict[str, "_RestField"], rest_name: str) -> typing.Optional["_RestField"]: + try: + return next(rf for rf in attr_to_rest_field.values() if rf._rest_name == rest_name) + except StopIteration: + return None + + +def _create_value(rf: typing.Optional["_RestField"], value: typing.Any) -> typing.Any: + if not rf: + return _serialize(value, None) + if rf._is_multipart_file_input: + return value + if rf._is_model: + return _deserialize(rf._type, value) + if isinstance(value, ET.Element): + value = _deserialize(rf._type, value) + return _serialize(value, rf._format) + + +# ============================================================================ +# Fast-path scalar deserializer functions for rest_field(deserializer=...) +# These are referenced from rest_field declarations to bypass the generic +# _deserialize -> _deserialize_with_callable chain. +# Only simple/primitive types — no models or container types. +# ============================================================================ + + +def _xml_deser_str(value): + if isinstance(value, ET.Element): + return value.text or "" + return str(value) if value is not None else None + + +def _xml_deser_int(value): + if isinstance(value, ET.Element): + return int(value.text) if value.text else None + return int(value) if value is not None else None + + +def _xml_deser_float(value): + if isinstance(value, ET.Element): + return float(value.text) if value.text else None + return float(value) if value is not None else None + + +def _xml_deser_bool(value): + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + if text in (True, False): + return text + return text.lower() == "true" + + +# pylint: disable=docstring-missing-param +def _xml_deser_bytes(value): + """Deserialize bytes from XML (base64).""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_bytes(text) + + +def _xml_deser_bytes_base64url(value): + """Deserialize bytes from XML (base64url).""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_bytes_base64(text) + + +def _xml_deser_datetime(value): + """Deserialize a datetime from XML (ISO 8601 / rfc3339).""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_datetime(text) + + +def _xml_deser_datetime_rfc7231(value): + """Deserialize a datetime from XML (RFC7231 format).""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_datetime_rfc7231(text) + + +def _xml_deser_datetime_unix_timestamp(value): + """Deserialize a datetime from XML (Unix timestamp).""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_datetime_unix_timestamp(float(text)) + + +def _xml_deser_date(value): + """Deserialize a date from XML (ISO 8601).""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_date(text) + + +def _xml_deser_time(value): + """Deserialize a time from XML (ISO 8601).""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_time(text) + + +def _xml_deser_duration(value): + """Deserialize a timedelta from XML (ISO 8601 duration).""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_duration(text) + + +def _xml_deser_decimal(value): + """Deserialize a Decimal from XML.""" + if isinstance(value, ET.Element): + text = value.text + else: + text = value + if text is None: + return None + return _deserialize_decimal(text) + + +def _xml_deser_enum_or_str(enum_cls, value): + """Deserialize a Union[EnumType, str] from XML.""" + text = value.text if isinstance(value, ET.Element) else value + if text is None: + return None + try: + return enum_cls(text) + except ValueError: + return text + + +def _extract_xml_model_type(rf_type): + """Extract the concrete Model class from a resolved rf._type partial chain. + + Unwraps ``Optional[Model]`` and ``_deserialize_model(Model, ...)`` + wrappers. Only handles Model and Optional[Model] — other composite + types (List, Dict, Union, etc.) return None and fall through to the + generic ``_deserialize`` path at runtime. + """ + if rf_type is None: + return None + if isinstance(rf_type, type) and _is_model(rf_type): + return rf_type + if not isinstance(rf_type, functools.partial): + return None + func = rf_type.func + args = rf_type.args + if func is _deserialize_with_optional and args: + return _extract_xml_model_type(args[0]) + if func is _deserialize_model and args: + cls = args[0] + return cls if isinstance(cls, type) and _is_model(cls) else None + return None + + +def _build_xml_field_plan( # pylint: disable=docstring-missing-return, docstring-missing-rtype, unused-variable + cls, attr_to_rest_field: dict +) -> list: + """Build a precomputed XML field plan for fast _init_from_xml iteration. + + Called once per model class in __new__. Returns a list of tuples: + (rest_name, xml_name, kind, deser, rf_type, is_optional, items_name) + + kind: 0=wrapped, 1=attribute, 2=unwrapped, 3=text + + For Model and Optional[Model] fields that lack a scalar + ``_deserializer``, this function precomputes the Model class as the + deserializer so ``_init_from_xml`` can call ``ModelClass(element)`` + directly instead of going through the expensive + ``_get_deserialize_callable_from_annotation`` chain at runtime. + """ + model_meta = getattr(cls, "_xml", {}) + model_ns = model_meta.get("ns") or model_meta.get("namespace") + plan = [] + + for rf in attr_to_rest_field.values(): + prop_meta = getattr(rf, "_xml", {}) + deser = rf._deserializer + + xml_name = prop_meta.get("name", rf._rest_name) + xml_ns = _resolve_xml_ns(prop_meta, model_meta) + if xml_ns: + xml_name = "{" + xml_ns + "}" + xml_name + + is_optional = rf._is_optional + + # For Model / Optional[Model] fields without a scalar deserializer, + # precompute the Model class as the deserializer. + if deser is None and rf._type is not None: + model_cls = _extract_xml_model_type(rf._type) + if model_cls is not None: + deser = model_cls + + if prop_meta.get("attribute", False): + plan.append((rf._rest_name, xml_name, 1, deser, rf._type, is_optional, None)) + elif prop_meta.get("unwrapped", False): + items_name = prop_meta.get("itemsName") + if items_name: + items_ns = prop_meta.get("itemsNs") + if items_ns is not None: + xml_ns = items_ns + if xml_ns: + items_name = "{" + xml_ns + "}" + items_name + else: + items_name = xml_name + plan.append((rf._rest_name, xml_name, 2, deser, rf._type, is_optional, items_name)) + elif prop_meta.get("text", False): + plan.append((rf._rest_name, xml_name, 3, deser, rf._type, is_optional, None)) + else: + plan.append((rf._rest_name, xml_name, 0, deser, rf._type, is_optional, None)) + + return plan + + +# pylint: enable=docstring-missing-param +class Model(_MyMutableMapping): + _is_model = True + # label whether current class's _attr_to_rest_field has been calculated + # could not see _attr_to_rest_field directly because subclass inherits it from parent class + _calculated: set[str] = set() + + def __init__(self, *args: typing.Any, **kwargs: typing.Any) -> None: + class_name = self.__class__.__name__ + if len(args) > 1: + raise TypeError(f"{class_name}.__init__() takes 2 positional arguments but {len(args) + 1} were given") + dict_to_pass: dict[str, typing.Any] = {} + if args: + if isinstance(args[0], ET.Element): + dict_to_pass.update(self._init_from_xml(args[0])) + else: + dict_to_pass.update( + {k: _create_value(_get_rest_field(self._attr_to_rest_field, k), v) for k, v in args[0].items()} + ) + else: + non_attr_kwargs = [k for k in kwargs if k not in self._attr_to_rest_field] + if non_attr_kwargs: + # actual type errors only throw the first wrong keyword arg they see, so following that. + raise TypeError(f"{class_name}.__init__() got an unexpected keyword argument '{non_attr_kwargs[0]}'") + dict_to_pass.update( + { + self._attr_to_rest_field[k]._rest_name: _create_value(self._attr_to_rest_field[k], v) + for k, v in kwargs.items() + if v is not None + } + ) + # Apply client default values for fields the caller didn't set so that + # defaults are part of `_data` and therefore included during serialization. + for rf in self._attr_to_rest_field.values(): + if rf._default is _UNSET: + continue + if rf._rest_name in dict_to_pass: + continue + dict_to_pass[rf._rest_name] = _create_value(rf, rf._default) + super().__init__(dict_to_pass) + + def _init_from_xml( # pylint: disable=too-many-branches, too-many-statements + self, element: ET.Element + ) -> dict[str, typing.Any]: + """Deserialize an XML element into a dict mapping rest field names to values. + + :param ET.Element element: The XML element to deserialize from. + :returns: A dictionary of rest_name to deserialized value pairs. + :rtype: dict + """ + result: dict[str, typing.Any] = {} + existed_attr_keys: list[str] = [] + + field_plan = getattr(self, "_xml_field_plan", None) + if field_plan: + for rest_name, xml_name, kind, deser, rf_type, is_optional, items_name in field_plan: + if kind == 0: # wrapped element (most common) + item = element.find(xml_name) + if item is not None: + existed_attr_keys.append(xml_name) + if deser: + result[rest_name] = deser(item) + else: + result[rest_name] = _deserialize(rf_type, item) + elif kind == 1: # attribute + attr_val = element.get(xml_name) + if attr_val is not None: + existed_attr_keys.append(xml_name) + if deser: + result[rest_name] = deser(attr_val) + else: + result[rest_name] = attr_val + elif kind == 2: # unwrapped array + items = element.findall(items_name) # pyright: ignore + if len(items) > 0: + existed_attr_keys.append(items_name) + if deser: + result[rest_name] = deser(items) + else: + result[rest_name] = _deserialize(rf_type, items) + elif not is_optional: + existed_attr_keys.append(items_name) + result[rest_name] = [] + elif kind == 3: # text + if element.text is not None: + if deser: + result[rest_name] = deser(element.text) + else: + result[rest_name] = element.text + else: + model_meta = getattr(self, "_xml", {}) + for rf in self._attr_to_rest_field.values(): + prop_meta = getattr(rf, "_xml", {}) + xml_name = prop_meta.get("name", rf._rest_name) + xml_ns = _resolve_xml_ns(prop_meta, model_meta) + if xml_ns: + xml_name = "{" + xml_ns + "}" + xml_name + + # attribute + if prop_meta.get("attribute", False) and element.get(xml_name) is not None: + existed_attr_keys.append(xml_name) + result[rf._rest_name] = _deserialize(rf._type, element.get(xml_name)) + continue + + # unwrapped element is array + if prop_meta.get("unwrapped", False): + _items_name = prop_meta.get("itemsName") + if _items_name: + xml_name = _items_name + _items_ns = prop_meta.get("itemsNs") + if _items_ns is not None: + xml_ns = _items_ns + if xml_ns: + xml_name = "{" + xml_ns + "}" + xml_name + items = element.findall(xml_name) # pyright: ignore + if len(items) > 0: + existed_attr_keys.append(xml_name) + result[rf._rest_name] = _deserialize(rf._type, items) + elif not rf._is_optional: + existed_attr_keys.append(xml_name) + result[rf._rest_name] = [] + continue + + # text element is primitive type + if prop_meta.get("text", False): + if element.text is not None: + result[rf._rest_name] = _deserialize(rf._type, element.text) + continue + + # wrapped element could be normal property or array + item = element.find(xml_name) + if item is not None: + existed_attr_keys.append(xml_name) + result[rf._rest_name] = _deserialize(rf._type, item) + + # rest thing is additional properties + for e in element: + if e.tag not in existed_attr_keys: + result[e.tag] = _convert_element(e) + + return result + + def copy(self) -> "Model": + return Model(self.__dict__) + + def __new__(cls, *args: typing.Any, **kwargs: typing.Any) -> Self: + if f"{cls.__module__}.{cls.__qualname__}" not in cls._calculated: + # we know the last nine classes in mro are going to be 'Model', '_MyMutableMapping', 'MutableMapping', + # 'Mapping', 'Collection', 'Sized', 'Iterable', 'Container' and 'object' + mros = cls.__mro__[:-9][::-1] # ignore parents, and reverse the mro order + attr_to_rest_field: dict[str, _RestField] = { # map attribute name to rest_field property + k: v for mro_class in mros for k, v in mro_class.__dict__.items() if k[0] != "_" and hasattr(v, "_type") + } + annotations = { + k: v + for mro_class in mros + if hasattr(mro_class, "__annotations__") + for k, v in mro_class.__annotations__.items() + } + for attr, rf in attr_to_rest_field.items(): + rf._module = cls.__module__ + if not rf._type: + rf._type = rf._get_deserialize_callable_from_annotation(annotations.get(attr, None)) + if not rf._rest_name_input: + rf._rest_name_input = attr + cls._attr_to_rest_field: dict[str, _RestField] = dict(attr_to_rest_field.items()) + # Build XML field plan for fast _init_from_xml (only for XML models) + if getattr(cls, "_xml", None): + cls._xml_field_plan = _build_xml_field_plan(cls, attr_to_rest_field) + cls._calculated.add(f"{cls.__module__}.{cls.__qualname__}") + + return super().__new__(cls) + + def __init_subclass__(cls, discriminator: typing.Optional[str] = None) -> None: + for base in cls.__bases__: + if hasattr(base, "__mapping__"): + base.__mapping__[discriminator or cls.__name__] = cls # type: ignore + + @classmethod + def _get_discriminator(cls, exist_discriminators) -> typing.Optional["_RestField"]: + for v in cls.__dict__.values(): + if isinstance(v, _RestField) and v._is_discriminator and v._rest_name not in exist_discriminators: + return v + return None + + @classmethod + def _deserialize(cls, data, exist_discriminators): + if not hasattr(cls, "__mapping__"): + return cls(data) + discriminator = cls._get_discriminator(exist_discriminators) + if discriminator is None: + return cls(data) + exist_discriminators.append(discriminator._rest_name) + if isinstance(data, ET.Element): + model_meta = getattr(cls, "_xml", {}) + prop_meta = getattr(discriminator, "_xml", {}) + xml_name = prop_meta.get("name", discriminator._rest_name) + xml_ns = _resolve_xml_ns(prop_meta, model_meta) + if xml_ns: + xml_name = "{" + xml_ns + "}" + xml_name + + if data.get(xml_name) is not None: + discriminator_value = data.get(xml_name) + else: + discriminator_value = data.find(xml_name).text # pyright: ignore + else: + discriminator_value = data.get(discriminator._rest_name) + mapped_cls = cls.__mapping__.get(discriminator_value, cls) # pyright: ignore # pylint: disable=no-member + return mapped_cls._deserialize(data, exist_discriminators) + + def as_dict(self, *, exclude_readonly: bool = False) -> dict[str, typing.Any]: + """Return a dict that can be turned into json using json.dump. + + :keyword bool exclude_readonly: Whether to remove the readonly properties. + :returns: A dict JSON compatible object + :rtype: dict + """ + + result = {} + readonly_props = [] + if exclude_readonly: + readonly_props = [p._rest_name for p in self._attr_to_rest_field.values() if _is_readonly(p)] + for k, v in self.items(): + if exclude_readonly and k in readonly_props: # pyright: ignore + continue + is_multipart_file_input = False + try: + is_multipart_file_input = next( + rf for rf in self._attr_to_rest_field.values() if rf._rest_name == k + )._is_multipart_file_input + except StopIteration: + pass + result[k] = v if is_multipart_file_input else Model._as_dict_value(v, exclude_readonly=exclude_readonly) + return result + + @staticmethod + def _as_dict_value(v: typing.Any, exclude_readonly: bool = False) -> typing.Any: + if v is None or isinstance(v, _Null): + return None + if isinstance(v, (list, tuple, set)): + return type(v)(Model._as_dict_value(x, exclude_readonly=exclude_readonly) for x in v) + if isinstance(v, dict): + return {dk: Model._as_dict_value(dv, exclude_readonly=exclude_readonly) for dk, dv in v.items()} + return v.as_dict(exclude_readonly=exclude_readonly) if hasattr(v, "as_dict") else v + + +def _deserialize_model(model_deserializer: typing.Optional[typing.Callable], obj): + if _is_model(obj): + return obj + return _deserialize(model_deserializer, obj) + + +def _deserialize_with_optional(if_obj_deserializer: typing.Optional[typing.Callable], obj): + if obj is None: + return obj + return _deserialize_with_callable(if_obj_deserializer, obj) + + +def _deserialize_with_union(deserializers, obj): + for deserializer in deserializers: + try: + return _deserialize(deserializer, obj) + except DeserializationError: + pass + raise DeserializationError() + + +def _deserialize_dict( + value_deserializer: typing.Optional[typing.Callable], + module: typing.Optional[str], + obj: dict[typing.Any, typing.Any], +): + if obj is None: + return obj + if isinstance(obj, ET.Element): + obj = {child.tag: child for child in obj} + return {k: _deserialize(value_deserializer, v, module) for k, v in obj.items()} + + +def _deserialize_multiple_sequence( + entry_deserializers: list[typing.Optional[typing.Callable]], + module: typing.Optional[str], + obj, +): + if obj is None: + return obj + return type(obj)(_deserialize(deserializer, entry, module) for entry, deserializer in zip(obj, entry_deserializers)) + + +def _is_array_encoded_deserializer(deserializer: functools.partial) -> bool: + return ( + isinstance(deserializer, functools.partial) + and isinstance(deserializer.args[0], functools.partial) + and deserializer.args[0].func == _deserialize_array_encoded # pylint: disable=comparison-with-callable + ) + + +def _deserialize_sequence( + deserializer: typing.Optional[typing.Callable], + module: typing.Optional[str], + obj, +): + if obj is None: + return obj + if isinstance(obj, ET.Element): + obj = list(obj) + + # encoded string may be deserialized to sequence + if isinstance(obj, str) and isinstance(deserializer, functools.partial): + # for list[str] + if _is_array_encoded_deserializer(deserializer): + return deserializer(obj) + + # for list[Union[...]] + if isinstance(deserializer.args[0], list): + for sub_deserializer in deserializer.args[0]: + if _is_array_encoded_deserializer(sub_deserializer): + return sub_deserializer(obj) + + return type(obj)(_deserialize(deserializer, entry, module) for entry in obj) + + +def _sorted_annotations(types: list[typing.Any]) -> list[typing.Any]: + return sorted( + types, + key=lambda x: hasattr(x, "__name__") and x.__name__.lower() in ("str", "float", "int", "bool"), + ) + + +def _get_deserialize_callable_from_annotation( # pylint: disable=too-many-return-statements, too-many-statements, too-many-branches + annotation: typing.Any, + module: typing.Optional[str], + rf: typing.Optional["_RestField"] = None, +) -> typing.Optional[typing.Callable[[typing.Any], typing.Any]]: + if not annotation: + return None + + # is it a type alias? + if isinstance(annotation, str): + if module is not None: + annotation = _get_type_alias_type(module, annotation) + + # is it a forward ref / in quotes? + if isinstance(annotation, (str, typing.ForwardRef)): + try: + model_name = annotation.__forward_arg__ # type: ignore + except AttributeError: + model_name = annotation + if module is not None: + annotation = _get_model(module, model_name) # type: ignore + + try: + if module and _is_model(annotation): + if rf: + rf._is_model = True + + return functools.partial(_deserialize_model, annotation) # pyright: ignore + except Exception: + pass + + # is it a literal? + try: + if annotation.__origin__ is typing.Literal: # pyright: ignore + return None + except AttributeError: + pass + + # is it optional? + try: + if any(a is _NONE_TYPE for a in annotation.__args__): # pyright: ignore + if rf: + rf._is_optional = True + if len(annotation.__args__) <= 2: # pyright: ignore + if_obj_deserializer = _get_deserialize_callable_from_annotation( + next(a for a in annotation.__args__ if a is not _NONE_TYPE), module, rf # pyright: ignore + ) + + return functools.partial(_deserialize_with_optional, if_obj_deserializer) + # the type is Optional[Union[...]], we need to remove the None type from the Union + annotation_copy = copy.copy(annotation) + annotation_copy.__args__ = [a for a in annotation_copy.__args__ if a is not _NONE_TYPE] # pyright: ignore + return _get_deserialize_callable_from_annotation(annotation_copy, module, rf) + except AttributeError: + pass + + # is it union? + if getattr(annotation, "__origin__", None) is typing.Union: + # initial ordering is we make `string` the last deserialization option, because it is often them most generic + deserializers = [ + _get_deserialize_callable_from_annotation(arg, module, rf) + for arg in _sorted_annotations(annotation.__args__) # pyright: ignore + ] + + return functools.partial(_deserialize_with_union, deserializers) + + try: + annotation_name = ( + annotation.__name__ if hasattr(annotation, "__name__") else annotation._name # pyright: ignore + ) + if annotation_name.lower() == "dict": + value_deserializer = _get_deserialize_callable_from_annotation( + annotation.__args__[1], module, rf # pyright: ignore + ) + + return functools.partial( + _deserialize_dict, + value_deserializer, + module, + ) + except (AttributeError, IndexError): + pass + try: + annotation_name = ( + annotation.__name__ if hasattr(annotation, "__name__") else annotation._name # pyright: ignore + ) + if annotation_name.lower() in ["list", "set", "tuple", "sequence"]: + if len(annotation.__args__) > 1: # pyright: ignore + entry_deserializers = [ + _get_deserialize_callable_from_annotation(dt, module, rf) + for dt in annotation.__args__ # pyright: ignore + ] + return functools.partial(_deserialize_multiple_sequence, entry_deserializers, module) + deserializer = _get_deserialize_callable_from_annotation( + annotation.__args__[0], module, rf # pyright: ignore + ) + + return functools.partial(_deserialize_sequence, deserializer, module) + except (TypeError, IndexError, AttributeError, SyntaxError): + pass + + def _deserialize_default( + deserializer, + obj, + ): + if obj is None: + return obj + try: + return _deserialize_with_callable(deserializer, obj) + except Exception: + pass + return obj + + if get_deserializer(annotation, rf): + return functools.partial(_deserialize_default, get_deserializer(annotation, rf)) + + return functools.partial(_deserialize_default, annotation) + + +def _deserialize_with_callable( + deserializer: typing.Optional[typing.Callable[[typing.Any], typing.Any]], + value: typing.Any, +): # pylint: disable=too-many-return-statements + try: + if value is None or isinstance(value, _Null): + return None + if isinstance(value, ET.Element): + if deserializer is str: + return value.text or "" + if deserializer is int: + return int(value.text) if value.text else None + if deserializer is float: + return float(value.text) if value.text else None + if deserializer is bool: + return value.text == "true" if value.text else None + if deserializer and deserializer in _DESERIALIZE_MAPPING.values(): + return deserializer(value.text) if value.text else None + if deserializer and deserializer in _DESERIALIZE_MAPPING_WITHFORMAT.values(): + return deserializer(value.text) if value.text else None + if deserializer is None: + return value + if deserializer in [int, float, bool]: + return deserializer(value) + if isinstance(deserializer, CaseInsensitiveEnumMeta): + try: + return deserializer(value.text if isinstance(value, ET.Element) else value) + except ValueError: + # for unknown value, return raw value + return value.text if isinstance(value, ET.Element) else value + if isinstance(deserializer, type) and issubclass(deserializer, Model): + return deserializer._deserialize(value, []) + return typing.cast(typing.Callable[[typing.Any], typing.Any], deserializer)(value) + except Exception as e: + raise DeserializationError() from e + + +def _deserialize( + deserializer: typing.Any, + value: typing.Any, + module: typing.Optional[str] = None, + rf: typing.Optional["_RestField"] = None, + format: typing.Optional[str] = None, +) -> typing.Any: + if isinstance(value, PipelineResponse): + value = value.http_response.json() + if rf is None and format: + rf = _RestField(format=format) + if not isinstance(deserializer, functools.partial): + deserializer = _get_deserialize_callable_from_annotation(deserializer, module, rf) + return _deserialize_with_callable(deserializer, value) + + +def _failsafe_deserialize( + deserializer: typing.Any, + response: HttpResponse, + module: typing.Optional[str] = None, + rf: typing.Optional["_RestField"] = None, + format: typing.Optional[str] = None, +) -> typing.Any: + try: + return _deserialize(deserializer, response.json(), module, rf, format) + except Exception: # pylint: disable=broad-except + _LOGGER.warning( + "Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True + ) + return None + + +def _failsafe_deserialize_xml( + deserializer: typing.Any, + response: HttpResponse, +) -> typing.Any: + try: + return _deserialize_xml(deserializer, response.text()) + except Exception: # pylint: disable=broad-except + _LOGGER.warning( + "Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True + ) + return None + + +# pylint: disable=too-many-instance-attributes +class _RestField: + def __init__( + self, + *, + name: typing.Optional[str] = None, + type: typing.Optional[typing.Callable] = None, # pylint: disable=redefined-builtin + is_discriminator: bool = False, + visibility: typing.Optional[list[str]] = None, + default: typing.Any = _UNSET, + format: typing.Optional[str] = None, + is_multipart_file_input: bool = False, + xml: typing.Optional[dict[str, typing.Any]] = None, + deserializer: typing.Optional[typing.Callable] = None, + ): + self._type = type + self._rest_name_input = name + self._module: typing.Optional[str] = None + self._is_discriminator = is_discriminator + self._visibility = visibility + self._is_model = False + self._is_optional = False + self._default = default + self._format = format + self._is_multipart_file_input = is_multipart_file_input + self._xml = xml if xml is not None else {} + self._deserializer = deserializer + + @property + def _class_type(self) -> typing.Any: + result = getattr(self._type, "args", [None])[0] + # type may be wrapped by nested functools.partial so we need to check for that + if isinstance(result, functools.partial): + return getattr(result, "args", [None])[0] + return result + + @property + def _rest_name(self) -> str: + if self._rest_name_input is None: + raise ValueError("Rest name was never set") + return self._rest_name_input + + def __get__(self, obj: Model, type=None): # pylint: disable=redefined-builtin + # by this point, type and rest_name will have a value bc we default + # them in __new__ of the Model class + # Use _data.get() directly to avoid triggering __getitem__ which clears the cache + item = obj._data.get(self._rest_name, _UNSET) + if item is _UNSET: + # Field not set by user; return the client default if one exists, otherwise None + return self._default if self._default is not _UNSET else None + if item is None: + return item + if self._is_model: + return item + + # For mutable types, we want mutations to directly affect _data + # Check if we've already deserialized this value + cache_attr = f"_deserialized_{self._rest_name}" + if hasattr(obj, cache_attr): + # Return the value from _data directly (it's been deserialized in place) + return obj._data.get(self._rest_name) + + # Fast path: use _deserializer directly (avoids _serialize/_deserialize chain) + if self._deserializer: + deserialized = self._deserializer(item) + else: + deserialized = _deserialize(self._type, _serialize(item, self._format), rf=self) + + # For mutable types, store the deserialized value back in _data + # so mutations directly affect _data + if isinstance(deserialized, (dict, list, set)): + obj._data[self._rest_name] = deserialized + object.__setattr__(obj, cache_attr, True) # Mark as deserialized + return deserialized + + return deserialized + + def __set__(self, obj: Model, value) -> None: + # Clear the cached deserialized object when setting a new value + cache_attr = f"_deserialized_{self._rest_name}" + if hasattr(obj, cache_attr): + object.__delattr__(obj, cache_attr) + + if value is None: + # we want to wipe out entries if users set attr to None + try: + obj.__delitem__(self._rest_name) + except KeyError: + pass + return + if self._is_model: + if not _is_model(value): + value = _deserialize(self._type, value) + obj.__setitem__(self._rest_name, value) + return + obj.__setitem__(self._rest_name, _serialize(value, self._format)) + + def _get_deserialize_callable_from_annotation( + self, annotation: typing.Any + ) -> typing.Optional[typing.Callable[[typing.Any], typing.Any]]: + return _get_deserialize_callable_from_annotation(annotation, self._module, self) + + +def rest_field( + *, + name: typing.Optional[str] = None, + type: typing.Optional[typing.Callable] = None, # pylint: disable=redefined-builtin + visibility: typing.Optional[list[str]] = None, + default: typing.Any = _UNSET, + format: typing.Optional[str] = None, + is_multipart_file_input: bool = False, + xml: typing.Optional[dict[str, typing.Any]] = None, + deserializer: typing.Optional[typing.Callable] = None, +) -> typing.Any: + return _RestField( + name=name, + type=type, + visibility=visibility, + default=default, + format=format, + is_multipart_file_input=is_multipart_file_input, + xml=xml, + deserializer=deserializer, + ) + + +def rest_discriminator( + *, + name: typing.Optional[str] = None, + type: typing.Optional[typing.Callable] = None, # pylint: disable=redefined-builtin + visibility: typing.Optional[list[str]] = None, + xml: typing.Optional[dict[str, typing.Any]] = None, +) -> typing.Any: + return _RestField(name=name, type=type, is_discriminator=True, visibility=visibility, xml=xml) + + +def serialize_xml(model: Model, exclude_readonly: bool = False) -> str: + """Serialize a model to XML. + + :param Model model: The model to serialize. + :param bool exclude_readonly: Whether to exclude readonly properties. + :returns: The XML representation of the model. + :rtype: str + """ + return ET.tostring(_get_element(model, exclude_readonly), encoding="unicode") # type: ignore + + +def _get_xml_ns(meta: dict[str, typing.Any]) -> typing.Optional[str]: + """Return the XML namespace from a metadata dict, checking both 'ns' (old-style) and 'namespace' (DPG) keys. + + :param dict meta: The metadata dictionary to extract namespace from. + :returns: The namespace string if 'ns' or 'namespace' key is present, None otherwise. + :rtype: str or None + """ + ns = meta.get("ns") + if ns is None: + ns = meta.get("namespace") + return ns + + +def _resolve_xml_ns( + prop_meta: dict[str, typing.Any], model_meta: typing.Optional[dict[str, typing.Any]] = None +) -> typing.Optional[str]: + """Resolve XML namespace for a property, falling back to model namespace when appropriate. + + Checks the property metadata first; if no namespace is found and the model does not declare + an explicit prefix, falls back to the model-level namespace. + + :param dict prop_meta: The property metadata dictionary. + :param dict model_meta: The model metadata dictionary, used as fallback. + :returns: The resolved namespace string, or None. + :rtype: str or None + """ + ns = _get_xml_ns(prop_meta) + if ns is None and model_meta is not None and not model_meta.get("prefix"): + ns = _get_xml_ns(model_meta) + return ns + + +def _set_xml_attribute(element: ET.Element, name: str, value: typing.Any, prop_meta: dict[str, typing.Any]) -> None: + """Set an XML attribute on an element, handling namespace prefix registration. + + :param ET.Element element: The element to set the attribute on. + :param str name: The default attribute name (wire name). + :param any value: The attribute value. + :param dict prop_meta: The property metadata dictionary. + """ + xml_name = prop_meta.get("name", name) + _attr_ns = _get_xml_ns(prop_meta) + if _attr_ns: + _attr_prefix = prop_meta.get("prefix") + if _attr_prefix: + _safe_register_namespace(_attr_prefix, _attr_ns) + xml_name = "{" + _attr_ns + "}" + xml_name + element.set(xml_name, _get_primitive_type_value(value)) + + +def _get_element( + o: typing.Any, + exclude_readonly: bool = False, + parent_meta: typing.Optional[dict[str, typing.Any]] = None, + wrapped_element: typing.Optional[ET.Element] = None, +) -> typing.Union[ET.Element, list[ET.Element]]: + if _is_model(o): + model_meta = getattr(o, "_xml", {}) + + # if prop is a model, then use the prop element directly, else generate a wrapper of model + if wrapped_element is None: + # When serializing as an array item (parent_meta is set), check if the parent has an + # explicit itemsName. This ensures correct element names for unwrapped arrays (where + # the element tag is the property/items name, not the model type name). + _items_name = parent_meta.get("itemsName") if parent_meta is not None else None + element_name = _items_name if _items_name else (model_meta.get("name") or o.__class__.__name__) + _model_ns = _get_xml_ns(model_meta) + wrapped_element = _create_xml_element( + element_name, + model_meta.get("prefix"), + _model_ns, + ) + + readonly_props = [] + if exclude_readonly: + readonly_props = [p._rest_name for p in o._attr_to_rest_field.values() if _is_readonly(p)] + + for k, v in o.items(): + # do not serialize readonly properties + if exclude_readonly and k in readonly_props: + continue + + prop_rest_field = _get_rest_field(o._attr_to_rest_field, k) + if prop_rest_field: + prop_meta = getattr(prop_rest_field, "_xml").copy() + # use the wire name as xml name if no specific name is set + if prop_meta.get("name") is None: + prop_meta["name"] = k + else: + # additional properties will not have rest field, use the wire name as xml name + prop_meta = {"name": k} + + # Propagate model namespace to properties only for old-style "ns"-keyed models. + # DPG-generated models use the "namespace" key and explicitly declare namespace on + # each property that needs it, so propagation is intentionally skipped for them. + if prop_meta.get("ns") is None and model_meta.get("ns"): + prop_meta["ns"] = model_meta.get("ns") + prop_meta["prefix"] = model_meta.get("prefix") + + if prop_meta.get("unwrapped", False): + # unwrapped could only set on array + wrapped_element.extend(_get_element(v, exclude_readonly, prop_meta)) + elif prop_meta.get("text", False): + # text could only set on primitive type + wrapped_element.text = _get_primitive_type_value(v) + elif prop_meta.get("attribute", False): + _set_xml_attribute(wrapped_element, k, v, prop_meta) + else: + # other wrapped prop element + wrapped_element.append(_get_wrapped_element(v, exclude_readonly, prop_meta)) + return wrapped_element + if isinstance(o, list): + return [_get_element(x, exclude_readonly, parent_meta) for x in o] # type: ignore + if isinstance(o, dict): + result = [] + _dict_ns = _get_xml_ns(parent_meta) if parent_meta else None + for k, v in o.items(): + result.append( + _get_wrapped_element( + v, + exclude_readonly, + { + "name": k, + "ns": _dict_ns, + "prefix": parent_meta.get("prefix") if parent_meta else None, + }, + ) + ) + return result + + # primitive case need to create element based on parent_meta + if parent_meta: + _items_ns = parent_meta.get("itemsNs") + if _items_ns is None: + _items_ns = _get_xml_ns(parent_meta) + return _get_wrapped_element( + o, + exclude_readonly, + { + "name": parent_meta.get("itemsName", parent_meta.get("name")), + "prefix": parent_meta.get("itemsPrefix", parent_meta.get("prefix")), + "ns": _items_ns, + }, + ) + + raise ValueError("Could not serialize value into xml: " + o) + + +def _get_wrapped_element( + v: typing.Any, + exclude_readonly: bool, + meta: typing.Optional[dict[str, typing.Any]], +) -> ET.Element: + _meta_ns = _get_xml_ns(meta) if meta else None + wrapped_element = _create_xml_element( + meta.get("name") if meta else None, meta.get("prefix") if meta else None, _meta_ns + ) + if isinstance(v, (dict, list)): + wrapped_element.extend(_get_element(v, exclude_readonly, meta)) + elif _is_model(v): + _get_element(v, exclude_readonly, meta, wrapped_element) + else: + wrapped_element.text = _get_primitive_type_value(v) + return wrapped_element # type: ignore[no-any-return] + + +def _get_primitive_type_value(v) -> str: + if v is True: + return "true" + if v is False: + return "false" + if isinstance(v, _Null): + return "" + return str(v) + + +def _safe_register_namespace(prefix: str, ns: str) -> None: + """Register an XML namespace prefix, handling reserved prefix patterns. + + Some prefixes (e.g. 'ns2') match Python's reserved 'ns\\d+' pattern used for + auto-generated prefixes, causing register_namespace to raise ValueError. + Falls back to directly registering in the internal namespace map. + + :param str prefix: The namespace prefix to register. + :param str ns: The namespace URI. + """ + try: + ET.register_namespace(prefix, ns) + except ValueError: + _ns_map = getattr(ET, "_namespace_map", None) + if _ns_map is not None: + _ns_map[ns] = prefix + + +def _create_xml_element( + tag: typing.Any, prefix: typing.Optional[str] = None, ns: typing.Optional[str] = None +) -> ET.Element: + if prefix and ns: + _safe_register_namespace(prefix, ns) + if ns: + return ET.Element("{" + ns + "}" + tag) + return ET.Element(tag) + + +def _deserialize_xml( + deserializer: typing.Any, + value: str, +) -> typing.Any: + element = ET.fromstring(value) # nosec + if _is_model(deserializer): + return deserializer._deserialize(element, []) + return _deserialize(deserializer, element) + + +def _convert_element(e: ET.Element): + # dict case + if len(e.attrib) > 0 or len({child.tag for child in e}) > 1: + dict_result: dict[str, typing.Any] = {} + for child in e: + if dict_result.get(child.tag) is not None: + if isinstance(dict_result[child.tag], list): + dict_result[child.tag].append(_convert_element(child)) + else: + dict_result[child.tag] = [dict_result[child.tag], _convert_element(child)] + else: + dict_result[child.tag] = _convert_element(child) + dict_result.update(e.attrib) + return dict_result + # array case + if len(e) > 0: + array_result: list[typing.Any] = [] + for child in e: + array_result.append(_convert_element(child)) + return array_result + # primitive case + return e.text diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/serialization.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/serialization.py index ff543ed937ff..a088671e9c51 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/serialization.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/serialization.py @@ -3,7 +3,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -39,11 +39,15 @@ import xml.etree.ElementTree as ET import isodate # type: ignore -from typing_extensions import Self from azure.core.exceptions import DeserializationError, SerializationError from azure.core.serialization import NULL as CoreNull +if sys.version_info >= (3, 11): + from typing import Self +else: + from typing_extensions import Self + _BOM = codecs.BOM_UTF8.decode(encoding="utf-8") JSON = MutableMapping[str, Any] @@ -821,13 +825,20 @@ def serialize_basic(cls, data, data_type, **kwargs): :param str data_type: Type of object in the iterable. :rtype: str, int, float, bool :return: serialized object + :raises TypeError: raise if data_type is not one of str, int, float, bool. """ custom_serializer = cls._get_custom_serializers(data_type, **kwargs) if custom_serializer: return custom_serializer(data) if data_type == "str": return cls.serialize_unicode(data) - return eval(data_type)(data) # nosec # pylint: disable=eval-used + if data_type == "int": + return int(data) + if data_type == "float": + return float(data) + if data_type == "bool": + return bool(data) + raise TypeError("Unknown basic data type: {}".format(data_type)) @classmethod def serialize_unicode(cls, data): @@ -1394,7 +1405,7 @@ def __init__(self, classes: Optional[Mapping[str, type]] = None) -> None: # Otherwise, result are unexpected self.additional_properties_detection = True - def __call__(self, target_obj, response_data, content_type=None): + def __call__(self, target_obj, response_data, content_type=None): # pylint: disable=too-many-return-statements """Call the deserializer to process a REST response. :param str target_obj: Target data type to deserialize to. @@ -1404,6 +1415,27 @@ def __call__(self, target_obj, response_data, content_type=None): :return: Deserialized object. :rtype: object """ + # Fast path for header deserialization: response_data is a plain str or None + # and target_obj is a simple scalar type. This avoids the expensive + # _unpack_content → _deserialize → _classify_target → deserialize_data chain. + if response_data is None: + return None + if target_obj == "str" and isinstance(response_data, str): + return response_data + if isinstance(response_data, str): + if target_obj == "int": + return int(response_data) + if target_obj == "bool": + if response_data in ("true", "1", "True"): + return True + if response_data in ("false", "0", "False"): + return False + return bool(response_data) + if target_obj == "rfc-1123": + return Deserializer.deserialize_rfc(response_data) + if target_obj == "bytearray": + return Deserializer.deserialize_bytearray(response_data) + data = self._unpack_content(response_data, content_type) return self._deserialize(target_obj, data) @@ -1757,7 +1789,7 @@ def deserialize_basic(self, attr, data_type): # pylint: disable=too-many-return :param str data_type: deserialization data type. :return: Deserialized basic type. :rtype: str, int, float or bool - :raises TypeError: if string format is not valid. + :raises TypeError: if string format is not valid or data_type is not one of str, int, float, bool. """ # If we're here, data is supposed to be a basic type. # If it's still an XML node, take the text @@ -1783,7 +1815,11 @@ def deserialize_basic(self, attr, data_type): # pylint: disable=too-many-return if data_type == "str": return self.deserialize_unicode(attr) - return eval(data_type)(attr) # nosec # pylint: disable=eval-used + if data_type == "int": + return int(attr) + if data_type == "float": + return float(attr) + raise TypeError("Unknown basic data type: {}".format(data_type)) @staticmethod def deserialize_unicode(data): diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/utils.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/utils.py index 39b612f39a9b..35c9c836f85f 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/utils.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_utils/utils.py @@ -1,7 +1,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_validation.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_validation.py new file mode 100644 index 000000000000..f5af3a4eb8a2 --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_validation.py @@ -0,0 +1,66 @@ +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- +import functools + + +def api_version_validation(**kwargs): + params_added_on = kwargs.pop("params_added_on", {}) + method_added_on = kwargs.pop("method_added_on", "") + api_versions_list = kwargs.pop("api_versions_list", []) + + def _index_with_default(value: str, default: int = -1) -> int: + """Get the index of value in lst, or return default if not found. + + :param value: The value to search for in the api_versions_list. + :type value: str + :param default: The default value to return if the value is not found. + :type default: int + :return: The index of the value in the list, or the default value if not found. + :rtype: int + """ + try: + return api_versions_list.index(value) + except ValueError: + return default + + def decorator(func): + @functools.wraps(func) + def wrapper(*args, **kwargs): + try: + # this assumes the client has an _api_version attribute + client = args[0] + client_api_version = client._config.api_version # pylint: disable=protected-access + except AttributeError: + return func(*args, **kwargs) + + if _index_with_default(method_added_on) > _index_with_default(client_api_version): + raise ValueError( + f"'{func.__name__}' is not available in API version " + f"{client_api_version}. Pass service API version {method_added_on} or newer to your client." + ) + + unsupported = { + parameter: api_version + for api_version, parameters in params_added_on.items() + for parameter in parameters + if parameter in kwargs and _index_with_default(api_version) > _index_with_default(client_api_version) + } + if unsupported: + raise ValueError( + "".join( + [ + f"'{param}' is not available in API version {client_api_version}. " + f"Use service API version {version} or newer.\n" + for param, version in unsupported.items() + ] + ) + ) + return func(*args, **kwargs) + + return wrapper + + return decorator diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_version.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_version.py index 6d005f2b2101..7b6251c09190 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_version.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/_version.py @@ -2,8 +2,8 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- -VERSION = "8.0.1" +VERSION = "8.1.0b4" diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/__init__.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/__init__.py index ff14fe358a7f..45d26a0dae91 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/__init__.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/__init__.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- # pylint: disable=wrong-import-position @@ -12,7 +12,7 @@ if TYPE_CHECKING: from ._patch import * # pylint: disable=unused-wildcard-import -from ._resource_graph_client import ResourceGraphClient # type: ignore +from ._client import ResourceGraphClient # type: ignore try: from ._patch import __all__ as _patch_all diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_resource_graph_client.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_client.py similarity index 78% rename from sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_resource_graph_client.py rename to sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_client.py index 57a31c01e20c..5c5a1de4d392 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_resource_graph_client.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_client.py @@ -2,13 +2,13 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- from copy import deepcopy +import sys from typing import Any, Awaitable, Optional, TYPE_CHECKING, cast -from typing_extensions import Self from azure.core.pipeline import policies from azure.core.rest import AsyncHttpResponse, HttpRequest @@ -17,50 +17,60 @@ from azure.mgmt.core.policies import AsyncARMAutoResourceProviderRegistrationPolicy from azure.mgmt.core.tools import get_arm_endpoints -from .. import models as _models from .._utils.serialization import Deserializer, Serializer from ._configuration import ResourceGraphClientConfiguration from .operations import GraphQueryOperations, Operations, _ResourceGraphClientOperationsMixin +if sys.version_info >= (3, 11): + from typing import Self +else: + from typing_extensions import Self # type: ignore + if TYPE_CHECKING: from azure.core import AzureClouds from azure.core.credentials_async import AsyncTokenCredential -class ResourceGraphClient(_ResourceGraphClientOperationsMixin): - """Azure Resource Graph API Reference. +class ResourceGraphClient(_ResourceGraphClientOperationsMixin): # pylint: disable=client-accepts-api-version-keyword + """ResourceGraphClient. :ivar operations: Operations operations :vartype operations: azure.mgmt.resourcegraph.aio.operations.Operations :ivar graph_query: GraphQueryOperations operations :vartype graph_query: azure.mgmt.resourcegraph.aio.operations.GraphQueryOperations - :param credential: Credential needed for the client to connect to Azure. Required. + :param credential: Credential used to authenticate requests to the service. Required. :type credential: ~azure.core.credentials_async.AsyncTokenCredential - :param base_url: Service URL. Default value is None. + :param subscription_id: The ID of the target subscription. The value must be an UUID. Required. + :type subscription_id: str + :param base_url: Service host. Default value is None. :type base_url: str :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is None. :paramtype cloud_setting: ~azure.core.AzureClouds - :keyword api_version: Api Version. Default value is "2021-03-01". Note that overriding this - default value may result in unsupported behavior. - :paramtype api_version: str """ def __init__( self, credential: "AsyncTokenCredential", + subscription_id: str, base_url: Optional[str] = None, *, cloud_setting: Optional["AzureClouds"] = None, **kwargs: Any ) -> None: + _endpoint = "{endpoint}" _cloud = cloud_setting or settings.current.azure_cloud # type: ignore _endpoints = get_arm_endpoints(_cloud) if not base_url: base_url = _endpoints["resource_manager"] credential_scopes = kwargs.pop("credential_scopes", _endpoints["credential_scopes"]) self._config = ResourceGraphClientConfiguration( - credential=credential, cloud_setting=cloud_setting, credential_scopes=credential_scopes, **kwargs + credential=credential, + subscription_id=subscription_id, + base_url=cast(str, base_url), + cloud_setting=cloud_setting, + credential_scopes=credential_scopes, + **kwargs ) _policies = kwargs.pop("policies", None) @@ -82,17 +92,16 @@ def __init__( self._config.http_logging_policy, ] self._client: AsyncARMPipelineClient = AsyncARMPipelineClient( - base_url=cast(str, base_url), policies=_policies, **kwargs + base_url=cast(str, _endpoint), policies=_policies, **kwargs ) - client_models = {k: v for k, v in _models.__dict__.items() if isinstance(v, type)} - self._serialize = Serializer(client_models) - self._deserialize = Deserializer(client_models) + self._serialize = Serializer() + self._deserialize = Deserializer() self._serialize.client_side_validation = False self.operations = Operations(self._client, self._config, self._serialize, self._deserialize) self.graph_query = GraphQueryOperations(self._client, self._config, self._serialize, self._deserialize) - def _send_request( + def send_request( self, request: HttpRequest, *, stream: bool = False, **kwargs: Any ) -> Awaitable[AsyncHttpResponse]: """Runs the network request through the client's chained policies. @@ -100,7 +109,7 @@ def _send_request( >>> from azure.core.rest import HttpRequest >>> request = HttpRequest("GET", "https://www.example.org/") - >>> response = await client._send_request(request) + >>> response = await client.send_request(request) For more information on this code flow, see https://aka.ms/azsdk/dpcodegen/python/send_request @@ -113,7 +122,11 @@ def _send_request( """ request_copy = deepcopy(request) - request_copy.url = self._client.format_url(request_copy.url) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + + request_copy.url = self._client.format_url(request_copy.url, **path_format_arguments) return self._client.send_request(request_copy, stream=stream, **kwargs) # type: ignore async def close(self) -> None: diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_configuration.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_configuration.py index 1ff5234b4ecb..6daa8becc98c 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_configuration.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_configuration.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -24,27 +24,34 @@ class ResourceGraphClientConfiguration: # pylint: disable=too-many-instance-att Note that all parameters used to create this instance are saved as instance attributes. - :param credential: Credential needed for the client to connect to Azure. Required. + :param credential: Credential used to authenticate requests to the service. Required. :type credential: ~azure.core.credentials_async.AsyncTokenCredential + :param subscription_id: The ID of the target subscription. The value must be an UUID. Required. + :type subscription_id: str + :param base_url: Service host. Default value is "https://management.azure.com". + :type base_url: str :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is None. :type cloud_setting: ~azure.core.AzureClouds - :keyword api_version: Api Version. Default value is "2021-03-01". Note that overriding this - default value may result in unsupported behavior. - :paramtype api_version: str """ def __init__( - self, credential: "AsyncTokenCredential", cloud_setting: Optional["AzureClouds"] = None, **kwargs: Any + self, + credential: "AsyncTokenCredential", + subscription_id: str, + base_url: str = "https://management.azure.com", + cloud_setting: Optional["AzureClouds"] = None, + **kwargs: Any ) -> None: - api_version: str = kwargs.pop("api_version", "2021-03-01") - if credential is None: raise ValueError("Parameter 'credential' must not be None.") + if subscription_id is None: + raise ValueError("Parameter 'subscription_id' must not be None.") self.credential = credential + self.subscription_id = subscription_id + self.base_url = base_url self.cloud_setting = cloud_setting - self.api_version = api_version self.credential_scopes = kwargs.pop("credential_scopes", ["https://management.azure.com/.default"]) kwargs.setdefault("sdk_moniker", "mgmt-resourcegraph/{}".format(VERSION)) self.polling_interval = kwargs.get("polling_interval", 30) diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_patch.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_patch.py index f7dd32510333..ea765788358a 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_patch.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/_patch.py @@ -1,14 +1,14 @@ -# ------------------------------------ -# Copyright (c) Microsoft Corporation. -# Licensed under the MIT License. -# ------------------------------------ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# -------------------------------------------------------------------------- """Customize generated code here. Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import List -__all__: List[str] = [] # Add all objects you want publicly available to users at this package level +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/__init__.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/__init__.py index 68f1119ec35f..91d96dc031d6 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/__init__.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/__init__.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- # pylint: disable=wrong-import-position @@ -13,9 +12,9 @@ if TYPE_CHECKING: from ._patch import * # pylint: disable=unused-wildcard-import -from ._resource_graph_client_operations import _ResourceGraphClientOperationsMixin # type: ignore # pylint: disable=unused-import from ._operations import Operations # type: ignore -from ._graph_query_operations import GraphQueryOperations # type: ignore +from ._operations import GraphQueryOperations # type: ignore +from ._operations import _ResourceGraphClientOperationsMixin # type: ignore # pylint: disable=unused-import from ._patch import __all__ as _patch_all from ._patch import * diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_graph_query_operations.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_graph_query_operations.py deleted file mode 100644 index ca6220284de4..000000000000 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_graph_query_operations.py +++ /dev/null @@ -1,629 +0,0 @@ -# coding=utf-8 -# -------------------------------------------------------------------------- -# Copyright (c) Microsoft Corporation. All rights reserved. -# Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. -# Changes may cause incorrect behavior and will be lost if the code is regenerated. -# -------------------------------------------------------------------------- -from collections.abc import MutableMapping -from io import IOBase -from typing import Any, Callable, IO, Optional, TypeVar, Union, overload -import urllib.parse - -from azure.core import AsyncPipelineClient -from azure.core.async_paging import AsyncItemPaged, AsyncList -from azure.core.exceptions import ( - ClientAuthenticationError, - HttpResponseError, - ResourceExistsError, - ResourceNotFoundError, - ResourceNotModifiedError, - map_error, -) -from azure.core.pipeline import PipelineResponse -from azure.core.rest import AsyncHttpResponse, HttpRequest -from azure.core.tracing.decorator import distributed_trace -from azure.core.tracing.decorator_async import distributed_trace_async -from azure.core.utils import case_insensitive_dict -from azure.mgmt.core.exceptions import ARMErrorFormat - -from ... import models as _models -from ..._utils.serialization import Deserializer, Serializer -from ...operations._graph_query_operations import ( - build_create_or_update_request, - build_delete_request, - build_get_request, - build_list_by_subscription_request, - build_list_request, - build_update_request, -) -from .._configuration import ResourceGraphClientConfiguration - -T = TypeVar("T") -ClsType = Optional[Callable[[PipelineResponse[HttpRequest, AsyncHttpResponse], T, dict[str, Any]], Any]] -List = list - - -class GraphQueryOperations: - """ - .. warning:: - **DO NOT** instantiate this class directly. - - Instead, you should access the following operations through - :class:`~azure.mgmt.resourcegraph.aio.ResourceGraphClient`'s - :attr:`graph_query` attribute. - """ - - models = _models - - def __init__(self, *args, **kwargs) -> None: - input_args = list(args) - self._client: AsyncPipelineClient = input_args.pop(0) if input_args else kwargs.pop("client") - self._config: ResourceGraphClientConfiguration = input_args.pop(0) if input_args else kwargs.pop("config") - self._serialize: Serializer = input_args.pop(0) if input_args else kwargs.pop("serializer") - self._deserialize: Deserializer = input_args.pop(0) if input_args else kwargs.pop("deserializer") - - @distributed_trace - def list_by_subscription(self, subscription_id: str, **kwargs: Any) -> AsyncItemPaged["_models.GraphQueryResource"]: - """Get all graph queries defined within a specified subscription. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :return: An iterator like instance of either GraphQueryResource or the result of cls(response) - :rtype: - ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.resourcegraph.models.GraphQueryResource] - :raises ~azure.core.exceptions.HttpResponseError: - """ - _headers = kwargs.pop("headers", {}) or {} - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[_models.GraphQueryListResult] = kwargs.pop("cls", None) - - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - def prepare_request(next_link=None): - if not next_link: - - _request = build_list_by_subscription_request( - subscription_id=subscription_id, - api_version=api_version, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - else: - # make call to next link with the client's api-version - _parsed_next_link = urllib.parse.urlparse(next_link) - _next_request_params = case_insensitive_dict( - { - key: [urllib.parse.quote(v) for v in value] - for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items() - } - ) - _next_request_params["api-version"] = self._config.api_version - _request = HttpRequest( - "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params - ) - _request.url = self._client.format_url(_request.url) - _request.method = "GET" - return _request - - async def extract_data(pipeline_response): - deserialized = self._deserialize("GraphQueryListResult", pipeline_response) - list_of_elem = deserialized.value - if cls: - list_of_elem = cls(list_of_elem) # type: ignore - return deserialized.next_link or None, AsyncList(list_of_elem) - - async def get_next(next_link=None): - _request = prepare_request(next_link) - - _stream = False - pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - return pipeline_response - - return AsyncItemPaged(get_next, extract_data) - - @distributed_trace - def list( - self, subscription_id: str, resource_group_name: str, **kwargs: Any - ) -> AsyncItemPaged["_models.GraphQueryResource"]: - """Get all graph queries defined within a specified subscription and resource group. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :return: An iterator like instance of either GraphQueryResource or the result of cls(response) - :rtype: - ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.resourcegraph.models.GraphQueryResource] - :raises ~azure.core.exceptions.HttpResponseError: - """ - _headers = kwargs.pop("headers", {}) or {} - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[_models.GraphQueryListResult] = kwargs.pop("cls", None) - - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - def prepare_request(next_link=None): - if not next_link: - - _request = build_list_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - api_version=api_version, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - else: - # make call to next link with the client's api-version - _parsed_next_link = urllib.parse.urlparse(next_link) - _next_request_params = case_insensitive_dict( - { - key: [urllib.parse.quote(v) for v in value] - for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items() - } - ) - _next_request_params["api-version"] = self._config.api_version - _request = HttpRequest( - "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params - ) - _request.url = self._client.format_url(_request.url) - _request.method = "GET" - return _request - - async def extract_data(pipeline_response): - deserialized = self._deserialize("GraphQueryListResult", pipeline_response) - list_of_elem = deserialized.value - if cls: - list_of_elem = cls(list_of_elem) # type: ignore - return deserialized.next_link or None, AsyncList(list_of_elem) - - async def get_next(next_link=None): - _request = prepare_request(next_link) - - _stream = False - pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - return pipeline_response - - return AsyncItemPaged(get_next, extract_data) - - @distributed_trace_async - async def get( - self, subscription_id: str, resource_group_name: str, resource_name: str, **kwargs: Any - ) -> _models.GraphQueryResource: - """Get a single graph query by its resourceName. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = kwargs.pop("headers", {}) or {} - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) - - _request = build_get_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - resource_name=resource_name, - api_version=api_version, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - deserialized = self._deserialize("GraphQueryResource", pipeline_response.http_response) - - if cls: - return cls(pipeline_response, deserialized, {}) # type: ignore - - return deserialized # type: ignore - - @distributed_trace_async - async def delete(self, subscription_id: str, resource_group_name: str, resource_name: str, **kwargs: Any) -> None: - """Delete a graph query. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :return: None or the result of cls(response) - :rtype: None - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = kwargs.pop("headers", {}) or {} - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[None] = kwargs.pop("cls", None) - - _request = build_delete_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - resource_name=resource_name, - api_version=api_version, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200, 204]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - if cls: - return cls(pipeline_response, None, {}) # type: ignore - - @overload - async def create_or_update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - properties: _models.GraphQueryResource, - *, - content_type: str = "application/json", - **kwargs: Any - ) -> _models.GraphQueryResource: - """Create a new graph query. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param properties: Properties that need to be specified to create a new graph query. Required. - :type properties: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. - Default value is "application/json". - :paramtype content_type: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @overload - async def create_or_update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - properties: IO[bytes], - *, - content_type: str = "application/json", - **kwargs: Any - ) -> _models.GraphQueryResource: - """Create a new graph query. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param properties: Properties that need to be specified to create a new graph query. Required. - :type properties: IO[bytes] - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/json". - :paramtype content_type: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @distributed_trace_async - async def create_or_update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - properties: Union[_models.GraphQueryResource, IO[bytes]], - **kwargs: Any - ) -> _models.GraphQueryResource: - """Create a new graph query. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param properties: Properties that need to be specified to create a new graph query. Is either - a GraphQueryResource type or a IO[bytes] type. Required. - :type properties: ~azure.mgmt.resourcegraph.models.GraphQueryResource or IO[bytes] - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) - - content_type = content_type or "application/json" - _json = None - _content = None - if isinstance(properties, (IOBase, bytes)): - _content = properties - else: - _json = self._serialize.body(properties, "GraphQueryResource") - - _request = build_create_or_update_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - resource_name=resource_name, - api_version=api_version, - content_type=content_type, - json=_json, - content=_content, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200, 201]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - deserialized = self._deserialize("GraphQueryResource", pipeline_response.http_response) - - if cls: - return cls(pipeline_response, deserialized, {}) # type: ignore - - return deserialized # type: ignore - - @overload - async def update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - body: _models.GraphQueryUpdateParameters, - *, - content_type: str = "application/json", - **kwargs: Any - ) -> _models.GraphQueryResource: - """Updates a graph query that has already been added. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param body: Properties that need to be specified to create a new graph query. Required. - :type body: ~azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters - :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. - Default value is "application/json". - :paramtype content_type: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @overload - async def update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - body: IO[bytes], - *, - content_type: str = "application/json", - **kwargs: Any - ) -> _models.GraphQueryResource: - """Updates a graph query that has already been added. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param body: Properties that need to be specified to create a new graph query. Required. - :type body: IO[bytes] - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/json". - :paramtype content_type: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @distributed_trace_async - async def update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - body: Union[_models.GraphQueryUpdateParameters, IO[bytes]], - **kwargs: Any - ) -> _models.GraphQueryResource: - """Updates a graph query that has already been added. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param body: Properties that need to be specified to create a new graph query. Is either a - GraphQueryUpdateParameters type or a IO[bytes] type. Required. - :type body: ~azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters or IO[bytes] - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) - - content_type = content_type or "application/json" - _json = None - _content = None - if isinstance(body, (IOBase, bytes)): - _content = body - else: - _json = self._serialize.body(body, "GraphQueryUpdateParameters") - - _request = build_update_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - resource_name=resource_name, - api_version=api_version, - content_type=content_type, - json=_json, - content=_content, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - deserialized = self._deserialize("GraphQueryResource", pipeline_response.http_response) - - if cls: - return cls(pipeline_response, deserialized, {}) # type: ignore - - return deserialized # type: ignore diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_operations.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_operations.py index 4f9348564773..1e4f3ce2814c 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_operations.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_operations.py @@ -1,13 +1,15 @@ +# pylint: disable=line-too-long,useless-suppression,too-many-lines # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- from collections.abc import MutableMapping -from typing import Any, Callable, Optional, TypeVar -import urllib.parse +from io import IOBase +import json +from typing import Any, Callable, IO, Optional, TypeVar, Union, overload from azure.core import AsyncPipelineClient from azure.core.async_paging import AsyncItemPaged, AsyncList @@ -17,21 +19,40 @@ ResourceExistsError, ResourceNotFoundError, ResourceNotModifiedError, + StreamClosedError, + StreamConsumedError, map_error, ) from azure.core.pipeline import PipelineResponse from azure.core.rest import AsyncHttpResponse, HttpRequest from azure.core.tracing.decorator import distributed_trace +from azure.core.tracing.decorator_async import distributed_trace_async from azure.core.utils import case_insensitive_dict from azure.mgmt.core.exceptions import ARMErrorFormat from ... import models as _models +from ..._utils.model_base import SdkJSONEncoder, _deserialize, _failsafe_deserialize from ..._utils.serialization import Deserializer, Serializer -from ...operations._operations import build_list_request +from ..._utils.utils import ClientMixinABC +from ..._validation import api_version_validation +from ...operations._operations import ( + build_graph_query_create_or_update_request, + build_graph_query_delete_request, + build_graph_query_get_request, + build_graph_query_list_by_subscription_request, + build_graph_query_list_request, + build_graph_query_update_request, + build_operations_list_request, + build_resource_graph_resource_change_details_request, + build_resource_graph_resource_changes_request, + build_resource_graph_resources_history_request, + build_resource_graph_resources_request, +) from .._configuration import ResourceGraphClientConfiguration T = TypeVar("T") ClsType = Optional[Callable[[PipelineResponse[HttpRequest, AsyncHttpResponse], T, dict[str, Any]], Any]] +JSON = MutableMapping[str, Any] List = list @@ -45,8 +66,6 @@ class Operations: :attr:`operations` attribute. """ - models = _models - def __init__(self, *args, **kwargs) -> None: input_args = list(args) self._client: AsyncPipelineClient = input_args.pop(0) if input_args else kwargs.pop("client") @@ -56,17 +75,17 @@ def __init__(self, *args, **kwargs) -> None: @distributed_trace def list(self, **kwargs: Any) -> AsyncItemPaged["_models.Operation"]: - """Lists all of the available REST API operations. + """List the operations for the provider. - :return: An iterator like instance of either Operation or the result of cls(response) + :return: An iterator like instance of Operation :rtype: ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.resourcegraph.models.Operation] :raises ~azure.core.exceptions.HttpResponseError: """ _headers = kwargs.pop("headers", {}) or {} _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[_models.OperationListResult] = kwargs.pop("cls", None) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[List[_models.Operation]] = kwargs.pop("cls", None) error_map: MutableMapping = { 401: ClientAuthenticationError, @@ -79,36 +98,612 @@ def list(self, **kwargs: Any) -> AsyncItemPaged["_models.Operation"]: def prepare_request(next_link=None): if not next_link: - _request = build_list_request( + _request = build_operations_list_request( api_version=api_version, headers=_headers, params=_params, ) - _request.url = self._client.format_url(_request.url) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) else: - # make call to next link with the client's api-version - _parsed_next_link = urllib.parse.urlparse(next_link) - _next_request_params = case_insensitive_dict( - { - key: [urllib.parse.quote(v) for v in value] - for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items() - } + _request = HttpRequest("GET", next_link, headers=_headers) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + return _request + + async def extract_data(pipeline_response): + deserialized = pipeline_response.http_response.json() + list_of_elem = _deserialize( + List[_models.Operation], + deserialized.get("value", []), + ) + if cls: + list_of_elem = cls(list_of_elem) # type: ignore + return deserialized.get("nextLink") or None, AsyncList(list_of_elem) + + async def get_next(next_link=None): + _request = prepare_request(next_link) + + _stream = False + pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + response = pipeline_response.http_response + + if response.status_code not in [200]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, ) - _next_request_params["api-version"] = self._config.api_version - _request = HttpRequest( - "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + return pipeline_response + + return AsyncItemPaged(get_next, extract_data) + + +class GraphQueryOperations: + """ + .. warning:: + **DO NOT** instantiate this class directly. + + Instead, you should access the following operations through + :class:`~azure.mgmt.resourcegraph.aio.ResourceGraphClient`'s + :attr:`graph_query` attribute. + """ + + def __init__(self, *args, **kwargs) -> None: + input_args = list(args) + self._client: AsyncPipelineClient = input_args.pop(0) if input_args else kwargs.pop("client") + self._config: ResourceGraphClientConfiguration = input_args.pop(0) if input_args else kwargs.pop("config") + self._serialize: Serializer = input_args.pop(0) if input_args else kwargs.pop("serializer") + self._deserialize: Deserializer = input_args.pop(0) if input_args else kwargs.pop("deserializer") + + @distributed_trace_async + async def get(self, resource_group_name: str, resource_name: str, **kwargs: Any) -> _models.GraphQueryResource: + """Get a single graph query by its resourceName. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) + + _request = build_graph_query_get_request( + resource_group_name=resource_group_name, + resource_name=resource_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.GraphQueryResource, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + async def create_or_update( + self, + resource_group_name: str, + resource_name: str, + properties: _models.GraphQueryResource, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Create a new graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param properties: Properties that need to be specified to create a new graph query. Required. + :type properties: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def create_or_update( + self, + resource_group_name: str, + resource_name: str, + properties: JSON, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Create a new graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param properties: Properties that need to be specified to create a new graph query. Required. + :type properties: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def create_or_update( + self, + resource_group_name: str, + resource_name: str, + properties: IO[bytes], + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Create a new graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param properties: Properties that need to be specified to create a new graph query. Required. + :type properties: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + async def create_or_update( + self, + resource_group_name: str, + resource_name: str, + properties: Union[_models.GraphQueryResource, JSON, IO[bytes]], + **kwargs: Any + ) -> _models.GraphQueryResource: + """Create a new graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param properties: Properties that need to be specified to create a new graph query. Is one of + the following types: GraphQueryResource, JSON, IO[bytes] Required. + :type properties: ~azure.mgmt.resourcegraph.models.GraphQueryResource or JSON or IO[bytes] + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(properties, (IOBase, bytes)): + _content = properties + else: + _content = json.dumps(properties, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_graph_query_create_or_update_request( + resource_group_name=resource_group_name, + resource_name=resource_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200, 201]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.GraphQueryResource, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + async def update( + self, + resource_group_name: str, + resource_name: str, + body: _models.GraphQueryUpdateParameters, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Updates a graph query that has already been added. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param body: Properties that need to be specified to create a new graph query. Required. + :type body: ~azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def update( + self, + resource_group_name: str, + resource_name: str, + body: JSON, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Updates a graph query that has already been added. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param body: Properties that need to be specified to create a new graph query. Required. + :type body: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def update( + self, + resource_group_name: str, + resource_name: str, + body: IO[bytes], + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Updates a graph query that has already been added. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param body: Properties that need to be specified to create a new graph query. Required. + :type body: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + async def update( + self, + resource_group_name: str, + resource_name: str, + body: Union[_models.GraphQueryUpdateParameters, JSON, IO[bytes]], + **kwargs: Any + ) -> _models.GraphQueryResource: + """Updates a graph query that has already been added. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param body: Properties that need to be specified to create a new graph query. Is one of the + following types: GraphQueryUpdateParameters, JSON, IO[bytes] Required. + :type body: ~azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters or JSON or IO[bytes] + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_graph_query_update_request( + resource_group_name=resource_group_name, + resource_name=resource_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.GraphQueryResource, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @distributed_trace_async + async def delete(self, resource_group_name: str, resource_name: str, **kwargs: Any) -> None: + """Delete a graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :return: None + :rtype: None + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[None] = kwargs.pop("cls", None) + + _request = build_graph_query_delete_request( + resource_group_name=resource_group_name, + resource_name=resource_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = False + pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200, 204]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if cls: + return cls(pipeline_response, None, {}) # type: ignore + + @distributed_trace + def list(self, resource_group_name: str, **kwargs: Any) -> AsyncItemPaged["_models.GraphQueryResource"]: + """Get all graph queries defined within a specified subscription and resource group. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :return: An iterator like instance of GraphQueryResource + :rtype: + ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.resourcegraph.models.GraphQueryResource] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = kwargs.pop("headers", {}) or {} + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[List[_models.GraphQueryResource]] = kwargs.pop("cls", None) + + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + def prepare_request(next_link=None): + if not next_link: + + _request = build_graph_query_list_request( + resource_group_name=resource_group_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + headers=_headers, + params=_params, ) - _request.url = self._client.format_url(_request.url) - _request.method = "GET" + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + else: + _request = HttpRequest("GET", next_link, headers=_headers) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + return _request async def extract_data(pipeline_response): - deserialized = self._deserialize("OperationListResult", pipeline_response) - list_of_elem = deserialized.value + deserialized = pipeline_response.http_response.json() + list_of_elem = _deserialize( + List[_models.GraphQueryResource], + deserialized.get("value", []), + ) if cls: list_of_elem = cls(list_of_elem) # type: ignore - return None, AsyncList(list_of_elem) + return deserialized.get("nextLink") or None, AsyncList(list_of_elem) async def get_next(next_link=None): _request = prepare_request(next_link) @@ -121,12 +716,630 @@ async def get_next(next_link=None): if response.status_code not in [200]: map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.ErrorResponse, - pipeline_response, + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + return pipeline_response + + return AsyncItemPaged(get_next, extract_data) + + @distributed_trace + def list_by_subscription(self, **kwargs: Any) -> AsyncItemPaged["_models.GraphQueryResource"]: + """Get all graph queries defined within a specified subscription. + + :return: An iterator like instance of GraphQueryResource + :rtype: + ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.resourcegraph.models.GraphQueryResource] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = kwargs.pop("headers", {}) or {} + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[List[_models.GraphQueryResource]] = kwargs.pop("cls", None) + + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + def prepare_request(next_link=None): + if not next_link: + + _request = build_graph_query_list_by_subscription_request( + subscription_id=self._config.subscription_id, + api_version=api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + else: + _request = HttpRequest("GET", next_link, headers=_headers) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + return _request + + async def extract_data(pipeline_response): + deserialized = pipeline_response.http_response.json() + list_of_elem = _deserialize( + List[_models.GraphQueryResource], + deserialized.get("value", []), + ) + if cls: + list_of_elem = cls(list_of_elem) # type: ignore + return deserialized.get("nextLink") or None, AsyncList(list_of_elem) + + async def get_next(next_link=None): + _request = prepare_request(next_link) + + _stream = False + pipeline_response: PipelineResponse = await self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + response = pipeline_response.http_response + + if response.status_code not in [200]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, ) raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) return pipeline_response return AsyncItemPaged(get_next, extract_data) + + +class _ResourceGraphClientOperationsMixin( + ClientMixinABC[AsyncPipelineClient[HttpRequest, AsyncHttpResponse], ResourceGraphClientConfiguration] +): + + @overload + async def resource_changes( + self, + parameters: _models.ResourceChangesRequestParameters, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.ResourceChangeList: + """List changes to a resource for a given time interval. + + :param parameters: The request body. Required. + :type parameters: ~azure.mgmt.resourcegraph.models.ResourceChangesRequestParameters + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: ResourceChangeList. The ResourceChangeList is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.ResourceChangeList + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def resource_changes( + self, parameters: JSON, *, content_type: str = "application/json", **kwargs: Any + ) -> _models.ResourceChangeList: + """List changes to a resource for a given time interval. + + :param parameters: The request body. Required. + :type parameters: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: ResourceChangeList. The ResourceChangeList is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.ResourceChangeList + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def resource_changes( + self, parameters: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> _models.ResourceChangeList: + """List changes to a resource for a given time interval. + + :param parameters: The request body. Required. + :type parameters: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: ResourceChangeList. The ResourceChangeList is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.ResourceChangeList + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + @api_version_validation( + method_added_on="2020-09-01-preview", + params_added_on={"2020-09-01-preview": ["api_version", "content_type", "accept"]}, + api_versions_list=["2020-09-01-preview"], + ) + async def resource_changes( + self, parameters: Union[_models.ResourceChangesRequestParameters, JSON, IO[bytes]], **kwargs: Any + ) -> _models.ResourceChangeList: + """List changes to a resource for a given time interval. + + :param parameters: The request body. Is one of the following types: + ResourceChangesRequestParameters, JSON, IO[bytes] Required. + :type parameters: ~azure.mgmt.resourcegraph.models.ResourceChangesRequestParameters or JSON or + IO[bytes] + :return: ResourceChangeList. The ResourceChangeList is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.ResourceChangeList + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2020-09-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ResourceChangeList] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(parameters, (IOBase, bytes)): + _content = parameters + else: + _content = json.dumps(parameters, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_resource_graph_resource_changes_request( + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.ResourceChangeList, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + async def resource_change_details( + self, + parameters: _models.ResourceChangeDetailsRequestParameters, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> List[_models.ResourceChangeData]: + """Get resource change details. + + :param parameters: The request body. Required. + :type parameters: ~azure.mgmt.resourcegraph.models.ResourceChangeDetailsRequestParameters + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: list of ResourceChangeData + :rtype: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def resource_change_details( + self, parameters: JSON, *, content_type: str = "application/json", **kwargs: Any + ) -> List[_models.ResourceChangeData]: + """Get resource change details. + + :param parameters: The request body. Required. + :type parameters: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: list of ResourceChangeData + :rtype: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def resource_change_details( + self, parameters: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> List[_models.ResourceChangeData]: + """Get resource change details. + + :param parameters: The request body. Required. + :type parameters: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: list of ResourceChangeData + :rtype: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + @api_version_validation( + method_added_on="2020-09-01-preview", + params_added_on={"2020-09-01-preview": ["api_version", "content_type", "accept"]}, + api_versions_list=["2020-09-01-preview"], + ) + async def resource_change_details( + self, parameters: Union[_models.ResourceChangeDetailsRequestParameters, JSON, IO[bytes]], **kwargs: Any + ) -> List[_models.ResourceChangeData]: + """Get resource change details. + + :param parameters: The request body. Is one of the following types: + ResourceChangeDetailsRequestParameters, JSON, IO[bytes] Required. + :type parameters: ~azure.mgmt.resourcegraph.models.ResourceChangeDetailsRequestParameters or + JSON or IO[bytes] + :return: list of ResourceChangeData + :rtype: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2020-09-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[List[_models.ResourceChangeData]] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(parameters, (IOBase, bytes)): + _content = parameters + else: + _content = json.dumps(parameters, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_resource_graph_resource_change_details_request( + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(List[_models.ResourceChangeData], response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + async def resources( + self, query: _models.QueryRequest, *, content_type: str = "application/json", **kwargs: Any + ) -> _models.QueryResponse: + """Queries the resources managed by Azure Resource Manager for scopes specified in the request. + + :param query: The request body. Required. + :type query: ~azure.mgmt.resourcegraph.models.QueryRequest + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: QueryResponse. The QueryResponse is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def resources( + self, query: JSON, *, content_type: str = "application/json", **kwargs: Any + ) -> _models.QueryResponse: + """Queries the resources managed by Azure Resource Manager for scopes specified in the request. + + :param query: The request body. Required. + :type query: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: QueryResponse. The QueryResponse is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def resources( + self, query: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> _models.QueryResponse: + """Queries the resources managed by Azure Resource Manager for scopes specified in the request. + + :param query: The request body. Required. + :type query: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: QueryResponse. The QueryResponse is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + @api_version_validation( + method_added_on="2024-04-01", + params_added_on={"2024-04-01": ["api_version", "content_type", "accept"]}, + api_versions_list=["2024-04-01"], + ) + async def resources( + self, query: Union[_models.QueryRequest, JSON, IO[bytes]], **kwargs: Any + ) -> _models.QueryResponse: + """Queries the resources managed by Azure Resource Manager for scopes specified in the request. + + :param query: The request body. Is one of the following types: QueryRequest, JSON, IO[bytes] + Required. + :type query: ~azure.mgmt.resourcegraph.models.QueryRequest or JSON or IO[bytes] + :return: QueryResponse. The QueryResponse is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.QueryResponse] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(query, (IOBase, bytes)): + _content = query + else: + _content = json.dumps(query, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_resource_graph_resources_request( + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.QueryResponse, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + async def resources_history( + self, request: _models.ResourcesHistoryRequest, *, content_type: str = "application/json", **kwargs: Any + ) -> Any: + """List all snapshots of a resource for a given time interval. + + :param request: The request body. Required. + :type request: ~azure.mgmt.resourcegraph.models.ResourcesHistoryRequest + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: any + :rtype: any + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def resources_history(self, request: JSON, *, content_type: str = "application/json", **kwargs: Any) -> Any: + """List all snapshots of a resource for a given time interval. + + :param request: The request body. Required. + :type request: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: any + :rtype: any + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + async def resources_history( + self, request: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> Any: + """List all snapshots of a resource for a given time interval. + + :param request: The request body. Required. + :type request: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: any + :rtype: any + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace_async + @api_version_validation( + method_added_on="2021-06-01-preview", + params_added_on={"2021-06-01-preview": ["api_version", "content_type", "accept"]}, + api_versions_list=["2021-06-01-preview"], + ) + async def resources_history( + self, request: Union[_models.ResourcesHistoryRequest, JSON, IO[bytes]], **kwargs: Any + ) -> Any: + """List all snapshots of a resource for a given time interval. + + :param request: The request body. Is one of the following types: ResourcesHistoryRequest, JSON, + IO[bytes] Required. + :type request: ~azure.mgmt.resourcegraph.models.ResourcesHistoryRequest or JSON or IO[bytes] + :return: any + :rtype: any + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-06-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[Any] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(request, (IOBase, bytes)): + _content = request + else: + _content = json.dumps(request, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_resource_graph_resources_history_request( + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + await response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(Any, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_patch.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_patch.py index f7dd32510333..ea765788358a 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_patch.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_patch.py @@ -1,14 +1,14 @@ -# ------------------------------------ -# Copyright (c) Microsoft Corporation. -# Licensed under the MIT License. -# ------------------------------------ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# -------------------------------------------------------------------------- """Customize generated code here. Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import List -__all__: List[str] = [] # Add all objects you want publicly available to users at this package level +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_resource_graph_client_operations.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_resource_graph_client_operations.py deleted file mode 100644 index f5587a6eb738..000000000000 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/aio/operations/_resource_graph_client_operations.py +++ /dev/null @@ -1,147 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression -# coding=utf-8 -# -------------------------------------------------------------------------- -# Copyright (c) Microsoft Corporation. All rights reserved. -# Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. -# Changes may cause incorrect behavior and will be lost if the code is regenerated. -# -------------------------------------------------------------------------- -from collections.abc import MutableMapping -from io import IOBase -from typing import Any, Callable, IO, Optional, TypeVar, Union, overload - -from azure.core import AsyncPipelineClient -from azure.core.exceptions import ( - ClientAuthenticationError, - HttpResponseError, - ResourceExistsError, - ResourceNotFoundError, - ResourceNotModifiedError, - map_error, -) -from azure.core.pipeline import PipelineResponse -from azure.core.rest import AsyncHttpResponse, HttpRequest -from azure.core.tracing.decorator_async import distributed_trace_async -from azure.core.utils import case_insensitive_dict -from azure.mgmt.core.exceptions import ARMErrorFormat - -from ... import models as _models -from ..._utils.utils import ClientMixinABC -from ...operations._resource_graph_client_operations import build_resources_request -from .._configuration import ResourceGraphClientConfiguration - -T = TypeVar("T") -ClsType = Optional[Callable[[PipelineResponse[HttpRequest, AsyncHttpResponse], T, dict[str, Any]], Any]] -List = list - - -class _ResourceGraphClientOperationsMixin( - ClientMixinABC[AsyncPipelineClient[HttpRequest, AsyncHttpResponse], ResourceGraphClientConfiguration] -): - - @overload - async def resources( - self, query: _models.QueryRequest, *, content_type: str = "application/json", **kwargs: Any - ) -> _models.QueryResponse: - """Queries the resources managed by Azure Resource Manager for scopes specified in the request. - - .. seealso:: - - https://aka.ms/resource-graph/learntoquery - - :param query: Request specifying query and its options. Required. - :type query: ~azure.mgmt.resourcegraph.models.QueryRequest - :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. - Default value is "application/json". - :paramtype content_type: str - :return: QueryResponse or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @overload - async def resources( - self, query: IO[bytes], *, content_type: str = "application/json", **kwargs: Any - ) -> _models.QueryResponse: - """Queries the resources managed by Azure Resource Manager for scopes specified in the request. - - .. seealso:: - - https://aka.ms/resource-graph/learntoquery - - :param query: Request specifying query and its options. Required. - :type query: IO[bytes] - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/json". - :paramtype content_type: str - :return: QueryResponse or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @distributed_trace_async - async def resources(self, query: Union[_models.QueryRequest, IO[bytes]], **kwargs: Any) -> _models.QueryResponse: - """Queries the resources managed by Azure Resource Manager for scopes specified in the request. - - .. seealso:: - - https://aka.ms/resource-graph/learntoquery - - :param query: Request specifying query and its options. Is either a QueryRequest type or a - IO[bytes] type. Required. - :type query: ~azure.mgmt.resourcegraph.models.QueryRequest or IO[bytes] - :return: QueryResponse or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - cls: ClsType[_models.QueryResponse] = kwargs.pop("cls", None) - - content_type = content_type or "application/json" - _json = None - _content = None - if isinstance(query, (IOBase, bytes)): - _content = query - else: - _json = self._serialize.body(query, "QueryRequest") - - _request = build_resources_request( - api_version=api_version, - content_type=content_type, - json=_json, - content=_content, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = await self._client._pipeline.run( # type: ignore # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.ErrorResponse, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - deserialized = self._deserialize("QueryResponse", pipeline_response.http_response) - - if cls: - return cls(pipeline_response, deserialized, {}) # type: ignore - - return deserialized # type: ignore diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/__init__.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/__init__.py index d93f359117a7..57d3884db8a0 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/__init__.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/__init__.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- # pylint: disable=wrong-import-position @@ -13,8 +13,8 @@ from ._patch import * # pylint: disable=unused-wildcard-import -from ._models_py3 import ( # type: ignore - Column, +from ._models import ( # type: ignore + DateTimeInterval, Error, ErrorDetails, ErrorFieldContract, @@ -26,22 +26,38 @@ FacetResult, GraphQueryError, GraphQueryErrorError, - GraphQueryListResult, + GraphQueryProperties, + GraphQueryPropertiesUpdateParameters, GraphQueryResource, GraphQueryUpdateParameters, Operation, OperationDisplay, - OperationListResult, + ProxyResource, QueryRequest, QueryRequestOptions, QueryResponse, Resource, - Table, + ResourceChangeData, + ResourceChangeDataAfterSnapshot, + ResourceChangeDataBeforeSnapshot, + ResourceChangeDetailsRequestParameters, + ResourceChangeList, + ResourceChangesRequestParameters, + ResourceChangesRequestParametersInterval, + ResourcePropertyChange, + ResourceSnapshotData, + ResourcesHistoryRequest, + ResourcesHistoryRequestOptions, + SystemData, ) -from ._resource_graph_client_enums import ( # type: ignore - ColumnDataType, +from ._enums import ( # type: ignore + AuthorizationScopeFilter, + ChangeCategory, + ChangeType, + CreatedByType, FacetSortOrder, + PropertyChangeType, ResultFormat, ResultKind, ResultTruncated, @@ -51,7 +67,7 @@ from ._patch import patch_sdk as _patch_sdk __all__ = [ - "Column", + "DateTimeInterval", "Error", "ErrorDetails", "ErrorFieldContract", @@ -63,19 +79,35 @@ "FacetResult", "GraphQueryError", "GraphQueryErrorError", - "GraphQueryListResult", + "GraphQueryProperties", + "GraphQueryPropertiesUpdateParameters", "GraphQueryResource", "GraphQueryUpdateParameters", "Operation", "OperationDisplay", - "OperationListResult", + "ProxyResource", "QueryRequest", "QueryRequestOptions", "QueryResponse", "Resource", - "Table", - "ColumnDataType", + "ResourceChangeData", + "ResourceChangeDataAfterSnapshot", + "ResourceChangeDataBeforeSnapshot", + "ResourceChangeDetailsRequestParameters", + "ResourceChangeList", + "ResourceChangesRequestParameters", + "ResourceChangesRequestParametersInterval", + "ResourcePropertyChange", + "ResourceSnapshotData", + "ResourcesHistoryRequest", + "ResourcesHistoryRequestOptions", + "SystemData", + "AuthorizationScopeFilter", + "ChangeCategory", + "ChangeType", + "CreatedByType", "FacetSortOrder", + "PropertyChangeType", "ResultFormat", "ResultKind", "ResultTruncated", diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_enums.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_enums.py new file mode 100644 index 000000000000..b39d36c3a12d --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_enums.py @@ -0,0 +1,103 @@ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- + +from enum import Enum +from azure.core import CaseInsensitiveEnumMeta + + +class AuthorizationScopeFilter(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Defines what level of authorization resources should be returned based on the which + subscriptions and management groups are passed as scopes. + """ + + AT_SCOPE_AND_BELOW = "AtScopeAndBelow" + """AtScopeAndBelow.""" + AT_SCOPE_AND_ABOVE = "AtScopeAndAbove" + """AtScopeAndAbove.""" + AT_SCOPE_EXACT = "AtScopeExact" + """AtScopeExact.""" + AT_SCOPE_ABOVE_AND_BELOW = "AtScopeAboveAndBelow" + """AtScopeAboveAndBelow.""" + + +class ChangeCategory(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """The change category.""" + + USER = "User" + """User.""" + SYSTEM = "System" + """System.""" + + +class ChangeType(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """The change type for snapshot. PropertyChanges will be provided in case of Update change type.""" + + CREATE = "Create" + """Create.""" + UPDATE = "Update" + """Update.""" + DELETE = "Delete" + """Delete.""" + + +class CreatedByType(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """The kind of entity that created the resource.""" + + USER = "User" + """The entity was created by a user.""" + APPLICATION = "Application" + """The entity was created by an application.""" + MANAGED_IDENTITY = "ManagedIdentity" + """The entity was created by a managed identity.""" + KEY = "Key" + """The entity was created by a key.""" + + +class FacetSortOrder(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """The sorting order by the selected column (count by default).""" + + ASC = "asc" + """asc.""" + DESC = "desc" + """desc.""" + + +class PropertyChangeType(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """The property change Type.""" + + INSERT = "Insert" + """Insert.""" + UPDATE = "Update" + """Update.""" + REMOVE = "Remove" + """Remove.""" + + +class ResultFormat(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Defines in which format query result returned.""" + + TABLE = "table" + """table.""" + OBJECT_ARRAY = "objectArray" + """objectArray.""" + + +class ResultKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Enum indicating a type of graph query.""" + + BASIC = "basic" + """basic.""" + + +class ResultTruncated(str, Enum, metaclass=CaseInsensitiveEnumMeta): + """Indicates whether the query results are truncated.""" + + TRUE = "true" + """true.""" + FALSE = "false" + """false.""" diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_models.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_models.py new file mode 100644 index 000000000000..ff4eb8ac453c --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_models.py @@ -0,0 +1,1621 @@ +# pylint: disable=line-too-long,useless-suppression,too-many-lines +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- +# pylint: disable=useless-super-delegation + +import datetime +from typing import Any, Literal, Mapping, Optional, TYPE_CHECKING, Union, overload + +from .._utils.model_base import Model as _Model, rest_discriminator, rest_field + +if TYPE_CHECKING: + from .. import models as _models + + +class DateTimeInterval(_Model): + """An interval in time specifying the date and time for the inclusive start and exclusive end, + i.e. ``[start, end)``. + + :ivar start: A datetime indicating the inclusive/closed start of the time interval, i.e. + ``[``**`start`**``, end)``. Specifying a ``start`` that occurs chronologically after ``end`` + will result in an error. Required. + :vartype start: ~datetime.datetime + :ivar end: A datetime indicating the exclusive/open end of the time interval, i.e. ``[start, + ``**`end`**``)``. Specifying an ``end`` that occurs chronologically before ``start`` will + result in an error. Required. + :vartype end: ~datetime.datetime + """ + + start: datetime.datetime = rest_field(visibility=["read", "create", "update", "delete", "query"], format="rfc3339") + """A datetime indicating the inclusive/closed start of the time interval, i.e. ``[``**`start`**``, + end)``. Specifying a ``start`` that occurs chronologically after ``end`` will result in an + error. Required.""" + end: datetime.datetime = rest_field(visibility=["read", "create", "update", "delete", "query"], format="rfc3339") + """A datetime indicating the exclusive/open end of the time interval, i.e. ``[start, + ``**`end`**``)``. Specifying an ``end`` that occurs chronologically before ``start`` will + result in an error. Required.""" + + @overload + def __init__( + self, + *, + start: datetime.datetime, + end: datetime.datetime, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class Error(_Model): + """Error info. + + :ivar code: Error code identifying the specific error. Required. + :vartype code: str + :ivar message: A human readable error message. Required. + :vartype message: str + :ivar details: Error details. + :vartype details: list[~azure.mgmt.resourcegraph.models.ErrorDetails] + """ + + code: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Error code identifying the specific error. Required.""" + message: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """A human readable error message. Required.""" + details: Optional[list["_models.ErrorDetails"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Error details.""" + + @overload + def __init__( + self, + *, + code: str, + message: str, + details: Optional[list["_models.ErrorDetails"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ErrorDetails(_Model): + """Error details. + + :ivar code: Error code identifying the specific error. Required. + :vartype code: str + :ivar message: A human readable error message. Required. + :vartype message: str + """ + + code: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Error code identifying the specific error. Required.""" + message: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """A human readable error message. Required.""" + + @overload + def __init__( + self, + *, + code: str, + message: str, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ErrorFieldContract(_Model): + """Error Field contract. + + :ivar code: Property level error code. + :vartype code: str + :ivar message: Human-readable representation of property-level error. + :vartype message: str + :ivar target: Property name. + :vartype target: str + """ + + code: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Property level error code.""" + message: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Human-readable representation of property-level error.""" + target: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Property name.""" + + @overload + def __init__( + self, + *, + code: Optional[str] = None, + message: Optional[str] = None, + target: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ErrorResponse(_Model): + """Error response. + + :ivar error: Error information. Required. + :vartype error: ~azure.mgmt.resourcegraph.models.Error + """ + + error: "_models.Error" = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Error information. Required.""" + + @overload + def __init__( + self, + *, + error: "_models.Error", + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class Facet(_Model): + """A facet containing additional statistics on the response of a query. Can be either FacetResult + or FacetError. + + You probably want to use the sub-classes and not this class directly. Known sub-classes are: + FacetError, FacetResult + + :ivar expression: Facet expression, same as in the corresponding facet request. Required. + :vartype expression: str + :ivar result_type: Result type. Required. Default value is None. + :vartype result_type: str + """ + + __mapping__: dict[str, _Model] = {} + expression: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Facet expression, same as in the corresponding facet request. Required.""" + result_type: str = rest_discriminator(name="resultType", visibility=["read", "create", "update", "delete", "query"]) + """Result type. Required. Default value is None.""" + + @overload + def __init__( + self, + *, + expression: str, + result_type: str, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class FacetError(Facet, discriminator="FacetError"): + """A facet whose execution resulted in an error. + + :ivar expression: Facet expression, same as in the corresponding facet request. Required. + :vartype expression: str + :ivar errors: An array containing detected facet errors with details. Required. + :vartype errors: list[~azure.mgmt.resourcegraph.models.ErrorDetails] + :ivar result_type: Result type. Required. Default value is "FacetError". + :vartype result_type: str + """ + + errors: list["_models.ErrorDetails"] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """An array containing detected facet errors with details. Required.""" + result_type: Literal["FacetError"] = rest_discriminator(name="resultType", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Result type. Required. Default value is \"FacetError\".""" + + @overload + def __init__( + self, + *, + expression: str, + errors: list["_models.ErrorDetails"], + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.result_type = "FacetError" # type: ignore + + +class FacetRequest(_Model): + """A request to compute additional statistics (facets) over the query results. + + :ivar expression: The column or list of columns to summarize by. Required. + :vartype expression: str + :ivar options: The options for facet evaluation. + :vartype options: ~azure.mgmt.resourcegraph.models.FacetRequestOptions + """ + + expression: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The column or list of columns to summarize by. Required.""" + options: Optional["_models.FacetRequestOptions"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The options for facet evaluation.""" + + @overload + def __init__( + self, + *, + expression: str, + options: Optional["_models.FacetRequestOptions"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class FacetRequestOptions(_Model): + """The options for facet evaluation. + + :ivar sort_by: The column name or query expression to sort on. Defaults to count if not + present. + :vartype sort_by: str + :ivar sort_order: The sorting order by the selected column (count by default). Known values + are: "asc" and "desc". + :vartype sort_order: str or ~azure.mgmt.resourcegraph.models.FacetSortOrder + :ivar filter: Specifies the filter condition for the 'where' clause which will be run on main + query's result, just before the actual faceting. + :vartype filter: str + :ivar top: The maximum number of facet rows that should be returned. + :vartype top: int + """ + + sort_by: Optional[str] = rest_field(name="sortBy", visibility=["read", "create", "update", "delete", "query"]) + """The column name or query expression to sort on. Defaults to count if not present.""" + sort_order: Optional[Union[str, "_models.FacetSortOrder"]] = rest_field( + name="sortOrder", visibility=["read", "create", "update", "delete", "query"] + ) + """The sorting order by the selected column (count by default). Known values are: \"asc\" and + \"desc\".""" + filter: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Specifies the filter condition for the 'where' clause which will be run on main query's result, + just before the actual faceting.""" + top: Optional[int] = rest_field(name="$top", visibility=["read", "create", "update", "delete", "query"]) + """The maximum number of facet rows that should be returned.""" + + @overload + def __init__( + self, + *, + sort_by: Optional[str] = None, + sort_order: Optional[Union[str, "_models.FacetSortOrder"]] = None, + filter: Optional[str] = None, # pylint: disable=redefined-builtin + top: Optional[int] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class FacetResult(Facet, discriminator="FacetResult"): + """Successfully executed facet containing additional statistics on the response of a query. + + :ivar expression: Facet expression, same as in the corresponding facet request. Required. + :vartype expression: str + :ivar total_records: Number of total records in the facet results. Required. + :vartype total_records: int + :ivar count: Number of records returned in the facet response. Required. + :vartype count: int + :ivar data: A JObject array or Table containing the desired facets. Only present if the facet + is valid. Required. + :vartype data: any + :ivar result_type: Result type. Required. Default value is "FacetResult". + :vartype result_type: str + """ + + total_records: int = rest_field(name="totalRecords", visibility=["read", "create", "update", "delete", "query"]) + """Number of total records in the facet results. Required.""" + count: int = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Number of records returned in the facet response. Required.""" + data: Any = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """A JObject array or Table containing the desired facets. Only present if the facet is valid. + Required.""" + result_type: Literal["FacetResult"] = rest_discriminator(name="resultType", visibility=["read", "create", "update", "delete", "query"]) # type: ignore + """Result type. Required. Default value is \"FacetResult\".""" + + @overload + def __init__( + self, + *, + expression: str, + total_records: int, + count: int, + data: Any, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + self.result_type = "FacetResult" # type: ignore + + +class GraphQueryError(_Model): + """Error message body that will indicate why the operation failed. + + :ivar error: The error object. + :vartype error: ~azure.mgmt.resourcegraph.models.GraphQueryErrorError + """ + + error: Optional["_models.GraphQueryErrorError"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The error object.""" + + @overload + def __init__( + self, + *, + error: Optional["_models.GraphQueryErrorError"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class GraphQueryErrorError(_Model): + """The error object. + + :ivar code: Service-defined error code. This code serves as a sub-status for the HTTP error + code specified in the response. + :vartype code: str + :ivar message: Human-readable representation of the error. + :vartype message: str + :ivar details: The list of invalid fields send in request, in case of validation error. + :vartype details: list[~azure.mgmt.resourcegraph.models.ErrorFieldContract] + """ + + code: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Service-defined error code. This code serves as a sub-status for the HTTP error code specified + in the response.""" + message: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Human-readable representation of the error.""" + details: Optional[list["_models.ErrorFieldContract"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The list of invalid fields send in request, in case of validation error.""" + + @overload + def __init__( + self, + *, + code: Optional[str] = None, + message: Optional[str] = None, + details: Optional[list["_models.ErrorFieldContract"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class GraphQueryProperties(_Model): + """Properties that contain a graph query. + + :ivar time_modified: Date and time in UTC of the last modification that was made to this graph + query definition. + :vartype time_modified: ~datetime.datetime + :ivar description: The description of a graph query. + :vartype description: str + :ivar query: KQL query that will be graph. Required. + :vartype query: str + :ivar result_kind: Enum indicating a type of graph query. "basic" + :vartype result_kind: str or ~azure.mgmt.resourcegraph.models.ResultKind + """ + + time_modified: Optional[datetime.datetime] = rest_field(name="timeModified", visibility=["read"], format="rfc3339") + """Date and time in UTC of the last modification that was made to this graph query definition.""" + description: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The description of a graph query.""" + query: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """KQL query that will be graph. Required.""" + result_kind: Optional[Union[str, "_models.ResultKind"]] = rest_field(name="resultKind", visibility=["read"]) + """Enum indicating a type of graph query. \"basic\"""" + + @overload + def __init__( + self, + *, + query: str, + description: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class GraphQueryPropertiesUpdateParameters(_Model): + """Properties that contain a workbook for PATCH operation. + + :ivar description: The description of a graph query. + :vartype description: str + :ivar query: KQL query that will be graph. + :vartype query: str + """ + + description: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The description of a graph query.""" + query: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """KQL query that will be graph.""" + + @overload + def __init__( + self, + *, + description: Optional[str] = None, + query: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class Resource(_Model): + """Resource. + + :ivar id: Fully qualified resource ID for the resource. Ex - + /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. + :vartype id: str + :ivar name: The name of the resource. + :vartype name: str + :ivar type: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or + "Microsoft.Storage/storageAccounts". + :vartype type: str + :ivar system_data: Azure Resource Manager metadata containing createdBy and modifiedBy + information. + :vartype system_data: ~azure.mgmt.resourcegraph.models.SystemData + """ + + id: Optional[str] = rest_field(visibility=["read"]) + """Fully qualified resource ID for the resource. Ex - + /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.""" + name: Optional[str] = rest_field(visibility=["read"]) + """The name of the resource.""" + type: Optional[str] = rest_field(visibility=["read"]) + """The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or + \"Microsoft.Storage/storageAccounts\".""" + system_data: Optional["_models.SystemData"] = rest_field(name="systemData", visibility=["read"]) + """Azure Resource Manager metadata containing createdBy and modifiedBy information.""" + + +class ProxyResource(Resource): + """Proxy Resource. + + :ivar id: Fully qualified resource ID for the resource. Ex - + /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. + :vartype id: str + :ivar name: The name of the resource. + :vartype name: str + :ivar type: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or + "Microsoft.Storage/storageAccounts". + :vartype type: str + :ivar system_data: Azure Resource Manager metadata containing createdBy and modifiedBy + information. + :vartype system_data: ~azure.mgmt.resourcegraph.models.SystemData + """ + + +class GraphQueryResource(ProxyResource): + """Graph Query entity definition. + + :ivar id: Fully qualified resource ID for the resource. Ex - + /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. + :vartype id: str + :ivar name: The name of the resource. + :vartype name: str + :ivar type: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or + "Microsoft.Storage/storageAccounts". + :vartype type: str + :ivar system_data: Azure Resource Manager metadata containing createdBy and modifiedBy + information. + :vartype system_data: ~azure.mgmt.resourcegraph.models.SystemData + :ivar properties: Metadata describing a graph query for an Azure resource. + :vartype properties: ~azure.mgmt.resourcegraph.models.GraphQueryProperties + :ivar tags: Resource tags. + :vartype tags: dict[str, str] + :ivar location: The location of the resource. + :vartype location: str + :ivar etag: This will be used to handle Optimistic Concurrency. If not present, it will always + overwrite the existing resource without checking conflict. + :vartype etag: str + """ + + properties: Optional["_models.GraphQueryProperties"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Metadata describing a graph query for an Azure resource.""" + tags: Optional[dict[str, str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Resource tags.""" + location: Optional[str] = rest_field(visibility=["read", "create"]) + """The location of the resource.""" + etag: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """This will be used to handle Optimistic Concurrency. If not present, it will always overwrite + the existing resource without checking conflict.""" + + __flattened_items = ["time_modified", "description", "query", "result_kind"] + + @overload + def __init__( + self, + *, + properties: Optional["_models.GraphQueryProperties"] = None, + tags: Optional[dict[str, str]] = None, + location: Optional[str] = None, + etag: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + _flattened_input = {k: kwargs.pop(k) for k in kwargs.keys() & self.__flattened_items} + super().__init__(*args, **kwargs) + for k, v in _flattened_input.items(): + setattr(self, k, v) + + def __getattr__(self, name: str) -> Any: + if name in self.__flattened_items: + if self.properties is None: + return None + return getattr(self.properties, name) + raise AttributeError(f"'{self.__class__.__name__}' object has no attribute '{name}'") + + def __setattr__(self, key: str, value: Any) -> None: + if key in self.__flattened_items: + if self.properties is None: + self.properties = self._attr_to_rest_field["properties"]._class_type() + setattr(self.properties, key, value) + else: + super().__setattr__(key, value) + + +class GraphQueryUpdateParameters(_Model): + """The parameters that can be provided when updating workbook properties properties. + + :ivar tags: Resource tags. + :vartype tags: dict[str, str] + :ivar etag: This will be used to handle Optimistic Concurrency. If not present, it will always + overwrite the existing resource without checking conflict. + :vartype etag: str + :ivar properties: Metadata describing a graph query for an Azure resource. + :vartype properties: ~azure.mgmt.resourcegraph.models.GraphQueryPropertiesUpdateParameters + """ + + tags: Optional[dict[str, str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Resource tags.""" + etag: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """This will be used to handle Optimistic Concurrency. If not present, it will always overwrite + the existing resource without checking conflict.""" + properties: Optional["_models.GraphQueryPropertiesUpdateParameters"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Metadata describing a graph query for an Azure resource.""" + + __flattened_items = ["description", "query"] + + @overload + def __init__( + self, + *, + tags: Optional[dict[str, str]] = None, + etag: Optional[str] = None, + properties: Optional["_models.GraphQueryPropertiesUpdateParameters"] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + _flattened_input = {k: kwargs.pop(k) for k in kwargs.keys() & self.__flattened_items} + super().__init__(*args, **kwargs) + for k, v in _flattened_input.items(): + setattr(self, k, v) + + def __getattr__(self, name: str) -> Any: + if name in self.__flattened_items: + if self.properties is None: + return None + return getattr(self.properties, name) + raise AttributeError(f"'{self.__class__.__name__}' object has no attribute '{name}'") + + def __setattr__(self, key: str, value: Any) -> None: + if key in self.__flattened_items: + if self.properties is None: + self.properties = self._attr_to_rest_field["properties"]._class_type() + setattr(self.properties, key, value) + else: + super().__setattr__(key, value) + + +class Operation(_Model): + """Resource Graph REST API operation definition. + + :ivar name: Operation name: {provider}/{resource}/{operation}. + :vartype name: str + :ivar display: Display metadata associated with the operation. + :vartype display: ~azure.mgmt.resourcegraph.models.OperationDisplay + :ivar origin: The origin of operations. + :vartype origin: str + """ + + name: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Operation name: {provider}/{resource}/{operation}.""" + display: Optional["_models.OperationDisplay"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Display metadata associated with the operation.""" + origin: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The origin of operations.""" + + @overload + def __init__( + self, + *, + name: Optional[str] = None, + display: Optional["_models.OperationDisplay"] = None, + origin: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class OperationDisplay(_Model): + """Display metadata associated with the operation. + + :ivar provider: Service provider: Microsoft Resource Graph. + :vartype provider: str + :ivar resource: Resource on which the operation is performed etc. + :vartype resource: str + :ivar operation: Type of operation: get, read, delete, etc. + :vartype operation: str + :ivar description: Description for the operation. + :vartype description: str + """ + + provider: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Service provider: Microsoft Resource Graph.""" + resource: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Resource on which the operation is performed etc.""" + operation: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Type of operation: get, read, delete, etc.""" + description: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Description for the operation.""" + + @overload + def __init__( + self, + *, + provider: Optional[str] = None, + resource: Optional[str] = None, + operation: Optional[str] = None, + description: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class QueryRequest(_Model): + """Describes a query to be executed. + + :ivar subscriptions: Azure subscriptions against which to execute the query. + :vartype subscriptions: list[str] + :ivar management_groups: Azure management groups against which to execute the query. Example: [ + 'mg1', 'mg2' ]. + :vartype management_groups: list[str] + :ivar query: The resources query. Required. + :vartype query: str + :ivar options: The query evaluation options. + :vartype options: ~azure.mgmt.resourcegraph.models.QueryRequestOptions + :ivar facets: An array of facet requests to be computed against the query result. + :vartype facets: list[~azure.mgmt.resourcegraph.models.FacetRequest] + """ + + subscriptions: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Azure subscriptions against which to execute the query.""" + management_groups: Optional[list[str]] = rest_field( + name="managementGroups", visibility=["read", "create", "update", "delete", "query"] + ) + """Azure management groups against which to execute the query. Example: [ 'mg1', 'mg2' ].""" + query: str = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The resources query. Required.""" + options: Optional["_models.QueryRequestOptions"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The query evaluation options.""" + facets: Optional[list["_models.FacetRequest"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """An array of facet requests to be computed against the query result.""" + + @overload + def __init__( + self, + *, + query: str, + subscriptions: Optional[list[str]] = None, + management_groups: Optional[list[str]] = None, + options: Optional["_models.QueryRequestOptions"] = None, + facets: Optional[list["_models.FacetRequest"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class QueryRequestOptions(_Model): + """The options for query evaluation. + + :ivar skip_token: Continuation token for pagination, capturing the next page size and offset, + as well as the context of the query. + :vartype skip_token: str + :ivar top: The maximum number of rows that the query should return. Overrides the page size + when ``$skipToken`` property is present. + :vartype top: int + :ivar skip: The number of rows to skip from the beginning of the results. Overrides the next + page offset when ``$skipToken`` property is present. + :vartype skip: int + :ivar result_format: Defines in which format query result returned. Known values are: "table" + and "objectArray". + :vartype result_format: str or ~azure.mgmt.resourcegraph.models.ResultFormat + :ivar allow_partial_scopes: Only applicable for tenant and management group level queries to + decide whether to allow partial scopes for result in case the number of subscriptions exceed + allowed limits. + :vartype allow_partial_scopes: bool + :ivar authorization_scope_filter: Defines what level of authorization resources should be + returned based on the which subscriptions and management groups are passed as scopes. Known + values are: "AtScopeAndBelow", "AtScopeAndAbove", "AtScopeExact", and "AtScopeAboveAndBelow". + :vartype authorization_scope_filter: str or + ~azure.mgmt.resourcegraph.models.AuthorizationScopeFilter + """ + + skip_token: Optional[str] = rest_field( + name="$skipToken", visibility=["read", "create", "update", "delete", "query"] + ) + """Continuation token for pagination, capturing the next page size and offset, as well as the + context of the query.""" + top: Optional[int] = rest_field(name="$top", visibility=["read", "create", "update", "delete", "query"]) + """The maximum number of rows that the query should return. Overrides the page size when + ``$skipToken`` property is present.""" + skip: Optional[int] = rest_field(name="$skip", visibility=["read", "create", "update", "delete", "query"]) + """The number of rows to skip from the beginning of the results. Overrides the next page offset + when ``$skipToken`` property is present.""" + result_format: Optional[Union[str, "_models.ResultFormat"]] = rest_field( + name="resultFormat", visibility=["read", "create", "update", "delete", "query"] + ) + """Defines in which format query result returned. Known values are: \"table\" and \"objectArray\".""" + allow_partial_scopes: Optional[bool] = rest_field( + name="allowPartialScopes", visibility=["read", "create", "update", "delete", "query"] + ) + """Only applicable for tenant and management group level queries to decide whether to allow + partial scopes for result in case the number of subscriptions exceed allowed limits.""" + authorization_scope_filter: Optional[Union[str, "_models.AuthorizationScopeFilter"]] = rest_field( + name="authorizationScopeFilter", visibility=["read", "create", "update", "delete", "query"] + ) + """Defines what level of authorization resources should be returned based on the which + subscriptions and management groups are passed as scopes. Known values are: + \"AtScopeAndBelow\", \"AtScopeAndAbove\", \"AtScopeExact\", and \"AtScopeAboveAndBelow\".""" + + @overload + def __init__( + self, + *, + skip_token: Optional[str] = None, + top: Optional[int] = None, + skip: Optional[int] = None, + result_format: Optional[Union[str, "_models.ResultFormat"]] = None, + allow_partial_scopes: Optional[bool] = None, + authorization_scope_filter: Optional[Union[str, "_models.AuthorizationScopeFilter"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class QueryResponse(_Model): + """Query result. + + :ivar total_records: Number of total records matching the query. Required. + :vartype total_records: int + :ivar count: Number of records returned in the current response. In the case of paging, this is + the number of records in the current page. Required. + :vartype count: int + :ivar result_truncated: Indicates whether the query results are truncated. Required. Known + values are: "true" and "false". + :vartype result_truncated: str or ~azure.mgmt.resourcegraph.models.ResultTruncated + :ivar skip_token: When present, the value can be passed to a subsequent query call (together + with the same query and scopes used in the current request) to retrieve the next page of data. + :vartype skip_token: str + :ivar data: Query output in JObject array or Table format. Required. + :vartype data: any + :ivar facets: Query facets. + :vartype facets: list[~azure.mgmt.resourcegraph.models.Facet] + """ + + total_records: int = rest_field(name="totalRecords", visibility=["read", "create", "update", "delete", "query"]) + """Number of total records matching the query. Required.""" + count: int = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Number of records returned in the current response. In the case of paging, this is the number + of records in the current page. Required.""" + result_truncated: Union[str, "_models.ResultTruncated"] = rest_field( + name="resultTruncated", visibility=["read", "create", "update", "delete", "query"] + ) + """Indicates whether the query results are truncated. Required. Known values are: \"true\" and + \"false\".""" + skip_token: Optional[str] = rest_field( + name="$skipToken", visibility=["read", "create", "update", "delete", "query"] + ) + """When present, the value can be passed to a subsequent query call (together with the same query + and scopes used in the current request) to retrieve the next page of data.""" + data: Any = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Query output in JObject array or Table format. Required.""" + facets: Optional[list["_models.Facet"]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Query facets.""" + + @overload + def __init__( + self, + *, + total_records: int, + count: int, + result_truncated: Union[str, "_models.ResultTruncated"], + data: Any, + skip_token: Optional[str] = None, + facets: Optional[list["_models.Facet"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourceChangeData(_Model): + """Data on a specific change, represented by a pair of before and after resource snapshots. + + :ivar resource_id: The resource for a change. + :vartype resource_id: str + :ivar change_id: The change ID. Valid and unique within the specified resource only. Required. + :vartype change_id: str + :ivar before_snapshot: The snapshot before the change. Required. + :vartype before_snapshot: ~azure.mgmt.resourcegraph.models.ResourceChangeDataBeforeSnapshot + :ivar after_snapshot: The snapshot after the change. Required. + :vartype after_snapshot: ~azure.mgmt.resourcegraph.models.ResourceChangeDataAfterSnapshot + :ivar change_type: The change type for snapshot. PropertyChanges will be provided in case of + Update change type. Known values are: "Create", "Update", and "Delete". + :vartype change_type: str or ~azure.mgmt.resourcegraph.models.ChangeType + :ivar property_changes: An array of resource property change. + :vartype property_changes: list[~azure.mgmt.resourcegraph.models.ResourcePropertyChange] + """ + + resource_id: Optional[str] = rest_field( + name="resourceId", visibility=["read", "create", "update", "delete", "query"] + ) + """The resource for a change.""" + change_id: str = rest_field(name="changeId", visibility=["read", "create", "update", "delete", "query"]) + """The change ID. Valid and unique within the specified resource only. Required.""" + before_snapshot: "_models.ResourceChangeDataBeforeSnapshot" = rest_field( + name="beforeSnapshot", visibility=["read", "create", "update", "delete", "query"] + ) + """The snapshot before the change. Required.""" + after_snapshot: "_models.ResourceChangeDataAfterSnapshot" = rest_field( + name="afterSnapshot", visibility=["read", "create", "update", "delete", "query"] + ) + """The snapshot after the change. Required.""" + change_type: Optional[Union[str, "_models.ChangeType"]] = rest_field( + name="changeType", visibility=["read", "create", "update", "delete", "query"] + ) + """The change type for snapshot. PropertyChanges will be provided in case of Update change type. + Known values are: \"Create\", \"Update\", and \"Delete\".""" + property_changes: Optional[list["_models.ResourcePropertyChange"]] = rest_field( + name="propertyChanges", visibility=["read", "create", "update", "delete", "query"] + ) + """An array of resource property change.""" + + @overload + def __init__( + self, + *, + change_id: str, + before_snapshot: "_models.ResourceChangeDataBeforeSnapshot", + after_snapshot: "_models.ResourceChangeDataAfterSnapshot", + resource_id: Optional[str] = None, + change_type: Optional[Union[str, "_models.ChangeType"]] = None, + property_changes: Optional[list["_models.ResourcePropertyChange"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourceSnapshotData(_Model): + """Data on a specific resource snapshot. + + :ivar snapshot_id: The ID of the snapshot. + :vartype snapshot_id: str + :ivar timestamp: The time when the snapshot was created. The snapshot timestamp provides an + approximation as to when a modification to a resource was detected. There can be a difference + between the actual modification time and the detection time. This is due to differences in how + operations that modify a resource are processed, versus how operation that record resource + snapshots are processed. Required. + :vartype timestamp: ~datetime.datetime + :ivar content: The resource snapshot content (in resourceChangeDetails response only). + :vartype content: any + """ + + snapshot_id: Optional[str] = rest_field( + name="snapshotId", visibility=["read", "create", "update", "delete", "query"] + ) + """The ID of the snapshot.""" + timestamp: datetime.datetime = rest_field( + visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """The time when the snapshot was created. The snapshot timestamp provides an approximation as to + when a modification to a resource was detected. There can be a difference between the actual + modification time and the detection time. This is due to differences in how operations that + modify a resource are processed, versus how operation that record resource snapshots are + processed. Required.""" + content: Optional[Any] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The resource snapshot content (in resourceChangeDetails response only).""" + + @overload + def __init__( + self, + *, + timestamp: datetime.datetime, + snapshot_id: Optional[str] = None, + content: Optional[Any] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourceChangeDataAfterSnapshot(ResourceSnapshotData): + """The snapshot after the change. + + :ivar snapshot_id: The ID of the snapshot. + :vartype snapshot_id: str + :ivar timestamp: The time when the snapshot was created. The snapshot timestamp provides an + approximation as to when a modification to a resource was detected. There can be a difference + between the actual modification time and the detection time. This is due to differences in how + operations that modify a resource are processed, versus how operation that record resource + snapshots are processed. Required. + :vartype timestamp: ~datetime.datetime + :ivar content: The resource snapshot content (in resourceChangeDetails response only). + :vartype content: any + """ + + @overload + def __init__( + self, + *, + timestamp: datetime.datetime, + snapshot_id: Optional[str] = None, + content: Optional[Any] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourceChangeDataBeforeSnapshot(ResourceSnapshotData): + """The snapshot before the change. + + :ivar snapshot_id: The ID of the snapshot. + :vartype snapshot_id: str + :ivar timestamp: The time when the snapshot was created. The snapshot timestamp provides an + approximation as to when a modification to a resource was detected. There can be a difference + between the actual modification time and the detection time. This is due to differences in how + operations that modify a resource are processed, versus how operation that record resource + snapshots are processed. Required. + :vartype timestamp: ~datetime.datetime + :ivar content: The resource snapshot content (in resourceChangeDetails response only). + :vartype content: any + """ + + @overload + def __init__( + self, + *, + timestamp: datetime.datetime, + snapshot_id: Optional[str] = None, + content: Optional[Any] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourceChangeDetailsRequestParameters(_Model): + """The parameters for a specific change details request. + + :ivar resource_ids: Specifies the list of resources for a change details request. Required. + :vartype resource_ids: list[str] + :ivar change_ids: Specifies the list of change IDs for a change details request. Required. + :vartype change_ids: list[str] + """ + + resource_ids: list[str] = rest_field(name="resourceIds", visibility=["read", "create", "update", "delete", "query"]) + """Specifies the list of resources for a change details request. Required.""" + change_ids: list[str] = rest_field(name="changeIds", visibility=["read", "create", "update", "delete", "query"]) + """Specifies the list of change IDs for a change details request. Required.""" + + @overload + def __init__( + self, + *, + resource_ids: list[str], + change_ids: list[str], + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourceChangeList(_Model): + """A list of changes associated with a resource over a specific time interval. + + :ivar changes: The pageable value returned by the operation, i.e. a list of changes to the + resource. + + * The list is ordered from the most recent changes to the least recent changes. + * This list will be empty if there were no changes during the requested interval. + * The `Before` snapshot timestamp value of the oldest change can be outside of the + specified time interval. + :vartype changes: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :ivar skip_token: Skip token that encodes the skip information while executing the current + request. + :vartype skip_token: any + """ + + changes: Optional[list["_models.ResourceChangeData"]] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The pageable value returned by the operation, i.e. a list of changes to the resource. + + * The list is ordered from the most recent changes to the least recent changes. + * This list will be empty if there were no changes during the requested interval. + * The `Before` snapshot timestamp value of the oldest change can be outside of the + specified time interval.""" + skip_token: Optional[Any] = rest_field( + name="$skipToken", visibility=["read", "create", "update", "delete", "query"] + ) + """Skip token that encodes the skip information while executing the current request.""" + + @overload + def __init__( + self, + *, + changes: Optional[list["_models.ResourceChangeData"]] = None, + skip_token: Optional[Any] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourceChangesRequestParameters(_Model): + """The parameters for a specific changes request. + + :ivar resource_ids: Specifies the list of resources for a changes request. + :vartype resource_ids: list[str] + :ivar subscription_id: The subscription id of resources to query the changes from. + :vartype subscription_id: str + :ivar interval: Specifies the date and time interval for a changes request. Required. + :vartype interval: ~azure.mgmt.resourcegraph.models.ResourceChangesRequestParametersInterval + :ivar skip_token: Acts as the continuation token for paged responses. + :vartype skip_token: str + :ivar top: The maximum number of changes the client can accept in a paged response. + :vartype top: int + :ivar table: The table name to query resources from. + :vartype table: str + :ivar fetch_property_changes: The flag if set to true will fetch property changes. + :vartype fetch_property_changes: bool + :ivar fetch_snapshots: The flag if set to true will fetch change snapshots. + :vartype fetch_snapshots: bool + """ + + resource_ids: Optional[list[str]] = rest_field( + name="resourceIds", visibility=["read", "create", "update", "delete", "query"] + ) + """Specifies the list of resources for a changes request.""" + subscription_id: Optional[str] = rest_field( + name="subscriptionId", visibility=["read", "create", "update", "delete", "query"] + ) + """The subscription id of resources to query the changes from.""" + interval: "_models.ResourceChangesRequestParametersInterval" = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """Specifies the date and time interval for a changes request. Required.""" + skip_token: Optional[str] = rest_field( + name="$skipToken", visibility=["read", "create", "update", "delete", "query"] + ) + """Acts as the continuation token for paged responses.""" + top: Optional[int] = rest_field(name="$top", visibility=["read", "create", "update", "delete", "query"]) + """The maximum number of changes the client can accept in a paged response.""" + table: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The table name to query resources from.""" + fetch_property_changes: Optional[bool] = rest_field( + name="fetchPropertyChanges", visibility=["read", "create", "update", "delete", "query"] + ) + """The flag if set to true will fetch property changes.""" + fetch_snapshots: Optional[bool] = rest_field( + name="fetchSnapshots", visibility=["read", "create", "update", "delete", "query"] + ) + """The flag if set to true will fetch change snapshots.""" + + @overload + def __init__( + self, + *, + interval: "_models.ResourceChangesRequestParametersInterval", + resource_ids: Optional[list[str]] = None, + subscription_id: Optional[str] = None, + skip_token: Optional[str] = None, + top: Optional[int] = None, + table: Optional[str] = None, + fetch_property_changes: Optional[bool] = None, + fetch_snapshots: Optional[bool] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourceChangesRequestParametersInterval(DateTimeInterval): + """Specifies the date and time interval for a changes request. + + :ivar start: A datetime indicating the inclusive/closed start of the time interval, i.e. + ``[``**`start`**``, end)``. Specifying a ``start`` that occurs chronologically after ``end`` + will result in an error. Required. + :vartype start: ~datetime.datetime + :ivar end: A datetime indicating the exclusive/open end of the time interval, i.e. ``[start, + ``**`end`**``)``. Specifying an ``end`` that occurs chronologically before ``start`` will + result in an error. Required. + :vartype end: ~datetime.datetime + """ + + @overload + def __init__( + self, + *, + start: datetime.datetime, + end: datetime.datetime, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourcePropertyChange(_Model): + """The resource property change. + + :ivar property_name: The property name. Required. + :vartype property_name: str + :ivar before_value: The property value in before snapshot. + :vartype before_value: str + :ivar after_value: The property value in after snapshot. + :vartype after_value: str + :ivar change_category: The change category. Required. Known values are: "User" and "System". + :vartype change_category: str or ~azure.mgmt.resourcegraph.models.ChangeCategory + :ivar property_change_type: The property change Type. Required. Known values are: "Insert", + "Update", and "Remove". + :vartype property_change_type: str or ~azure.mgmt.resourcegraph.models.PropertyChangeType + """ + + property_name: str = rest_field(name="propertyName", visibility=["read", "create", "update", "delete", "query"]) + """The property name. Required.""" + before_value: Optional[str] = rest_field( + name="beforeValue", visibility=["read", "create", "update", "delete", "query"] + ) + """The property value in before snapshot.""" + after_value: Optional[str] = rest_field( + name="afterValue", visibility=["read", "create", "update", "delete", "query"] + ) + """The property value in after snapshot.""" + change_category: Union[str, "_models.ChangeCategory"] = rest_field( + name="changeCategory", visibility=["read", "create", "update", "delete", "query"] + ) + """The change category. Required. Known values are: \"User\" and \"System\".""" + property_change_type: Union[str, "_models.PropertyChangeType"] = rest_field( + name="propertyChangeType", visibility=["read", "create", "update", "delete", "query"] + ) + """The property change Type. Required. Known values are: \"Insert\", \"Update\", and \"Remove\".""" + + @overload + def __init__( + self, + *, + property_name: str, + change_category: Union[str, "_models.ChangeCategory"], + property_change_type: Union[str, "_models.PropertyChangeType"], + before_value: Optional[str] = None, + after_value: Optional[str] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourcesHistoryRequest(_Model): + """Describes a history request to be executed. + + :ivar subscriptions: Azure subscriptions against which to execute the query. + :vartype subscriptions: list[str] + :ivar query: The resources query. + :vartype query: str + :ivar options: The history request evaluation options. + :vartype options: ~azure.mgmt.resourcegraph.models.ResourcesHistoryRequestOptions + :ivar management_groups: Azure management groups against which to execute the query. Example: [ + 'mg1', 'mg2' ]. + :vartype management_groups: list[str] + """ + + subscriptions: Optional[list[str]] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """Azure subscriptions against which to execute the query.""" + query: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"]) + """The resources query.""" + options: Optional["_models.ResourcesHistoryRequestOptions"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The history request evaluation options.""" + management_groups: Optional[list[str]] = rest_field( + name="managementGroups", visibility=["read", "create", "update", "delete", "query"] + ) + """Azure management groups against which to execute the query. Example: [ 'mg1', 'mg2' ].""" + + @overload + def __init__( + self, + *, + subscriptions: Optional[list[str]] = None, + query: Optional[str] = None, + options: Optional["_models.ResourcesHistoryRequestOptions"] = None, + management_groups: Optional[list[str]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class ResourcesHistoryRequestOptions(_Model): + """The options for history request evaluation. + + :ivar interval: The time interval used to fetch history. + :vartype interval: ~azure.mgmt.resourcegraph.models.DateTimeInterval + :ivar top: The maximum number of rows that the query should return. Overrides the page size + when ``$skipToken`` property is present. + :vartype top: int + :ivar skip: The number of rows to skip from the beginning of the results. Overrides the next + page offset when ``$skipToken`` property is present. + :vartype skip: int + :ivar skip_token: Continuation token for pagination, capturing the next page size and offset, + as well as the context of the query. + :vartype skip_token: str + :ivar result_format: Defines in which format query result returned. Known values are: "table" + and "objectArray". + :vartype result_format: str or ~azure.mgmt.resourcegraph.models.ResultFormat + """ + + interval: Optional["_models.DateTimeInterval"] = rest_field( + visibility=["read", "create", "update", "delete", "query"] + ) + """The time interval used to fetch history.""" + top: Optional[int] = rest_field(name="$top", visibility=["read", "create", "update", "delete", "query"]) + """The maximum number of rows that the query should return. Overrides the page size when + ``$skipToken`` property is present.""" + skip: Optional[int] = rest_field(name="$skip", visibility=["read", "create", "update", "delete", "query"]) + """The number of rows to skip from the beginning of the results. Overrides the next page offset + when ``$skipToken`` property is present.""" + skip_token: Optional[str] = rest_field( + name="$skipToken", visibility=["read", "create", "update", "delete", "query"] + ) + """Continuation token for pagination, capturing the next page size and offset, as well as the + context of the query.""" + result_format: Optional[Union[str, "_models.ResultFormat"]] = rest_field( + name="resultFormat", visibility=["read", "create", "update", "delete", "query"] + ) + """Defines in which format query result returned. Known values are: \"table\" and \"objectArray\".""" + + @overload + def __init__( + self, + *, + interval: Optional["_models.DateTimeInterval"] = None, + top: Optional[int] = None, + skip: Optional[int] = None, + skip_token: Optional[str] = None, + result_format: Optional[Union[str, "_models.ResultFormat"]] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + +class SystemData(_Model): + """Metadata pertaining to creation and last modification of the resource. + + :ivar created_by: The identity that created the resource. + :vartype created_by: str + :ivar created_by_type: The type of identity that created the resource. Known values are: + "User", "Application", "ManagedIdentity", and "Key". + :vartype created_by_type: str or ~azure.mgmt.resourcegraph.models.CreatedByType + :ivar created_at: The timestamp of resource creation (UTC). + :vartype created_at: ~datetime.datetime + :ivar last_modified_by: The identity that last modified the resource. + :vartype last_modified_by: str + :ivar last_modified_by_type: The type of identity that last modified the resource. Known values + are: "User", "Application", "ManagedIdentity", and "Key". + :vartype last_modified_by_type: str or ~azure.mgmt.resourcegraph.models.CreatedByType + :ivar last_modified_at: The timestamp of resource last modification (UTC). + :vartype last_modified_at: ~datetime.datetime + """ + + created_by: Optional[str] = rest_field(name="createdBy", visibility=["read", "create", "update", "delete", "query"]) + """The identity that created the resource.""" + created_by_type: Optional[Union[str, "_models.CreatedByType"]] = rest_field( + name="createdByType", visibility=["read", "create", "update", "delete", "query"] + ) + """The type of identity that created the resource. Known values are: \"User\", \"Application\", + \"ManagedIdentity\", and \"Key\".""" + created_at: Optional[datetime.datetime] = rest_field( + name="createdAt", visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """The timestamp of resource creation (UTC).""" + last_modified_by: Optional[str] = rest_field( + name="lastModifiedBy", visibility=["read", "create", "update", "delete", "query"] + ) + """The identity that last modified the resource.""" + last_modified_by_type: Optional[Union[str, "_models.CreatedByType"]] = rest_field( + name="lastModifiedByType", visibility=["read", "create", "update", "delete", "query"] + ) + """The type of identity that last modified the resource. Known values are: \"User\", + \"Application\", \"ManagedIdentity\", and \"Key\".""" + last_modified_at: Optional[datetime.datetime] = rest_field( + name="lastModifiedAt", visibility=["read", "create", "update", "delete", "query"], format="rfc3339" + ) + """The timestamp of resource last modification (UTC).""" + + @overload + def __init__( + self, + *, + created_by: Optional[str] = None, + created_by_type: Optional[Union[str, "_models.CreatedByType"]] = None, + created_at: Optional[datetime.datetime] = None, + last_modified_by: Optional[str] = None, + last_modified_by_type: Optional[Union[str, "_models.CreatedByType"]] = None, + last_modified_at: Optional[datetime.datetime] = None, + ) -> None: ... + + @overload + def __init__(self, mapping: Mapping[str, Any]) -> None: + """ + :param mapping: raw JSON to initialize the model. + :type mapping: Mapping[str, Any] + """ + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_models_py3.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_models_py3.py deleted file mode 100644 index 53d5555355ee..000000000000 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_models_py3.py +++ /dev/null @@ -1,1043 +0,0 @@ -# pylint: disable=too-many-lines -# coding=utf-8 -# -------------------------------------------------------------------------- -# Copyright (c) Microsoft Corporation. All rights reserved. -# Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. -# Changes may cause incorrect behavior and will be lost if the code is regenerated. -# -------------------------------------------------------------------------- - -from collections.abc import MutableMapping -import datetime -from typing import Any, Optional, TYPE_CHECKING, Union - -from .._utils import serialization as _serialization - -if TYPE_CHECKING: - from .. import models as _models -JSON = MutableMapping[str, Any] - - -class Column(_serialization.Model): - """Query result column descriptor. - - All required parameters must be populated in order to send to server. - - :ivar name: Column name. Required. - :vartype name: str - :ivar type: Column data type. Required. Known values are: "string", "integer", "number", - "boolean", and "object". - :vartype type: str or ~azure.mgmt.resourcegraph.models.ColumnDataType - """ - - _validation = { - "name": {"required": True}, - "type": {"required": True}, - } - - _attribute_map = { - "name": {"key": "name", "type": "str"}, - "type": {"key": "type", "type": "str"}, - } - - def __init__(self, *, name: str, type: Union[str, "_models.ColumnDataType"], **kwargs: Any) -> None: - """ - :keyword name: Column name. Required. - :paramtype name: str - :keyword type: Column data type. Required. Known values are: "string", "integer", "number", - "boolean", and "object". - :paramtype type: str or ~azure.mgmt.resourcegraph.models.ColumnDataType - """ - super().__init__(**kwargs) - self.name = name - self.type = type - - -class Error(_serialization.Model): - """Error details. - - All required parameters must be populated in order to send to server. - - :ivar code: Error code identifying the specific error. Required. - :vartype code: str - :ivar message: A human readable error message. Required. - :vartype message: str - :ivar details: Error details. - :vartype details: list[~azure.mgmt.resourcegraph.models.ErrorDetails] - """ - - _validation = { - "code": {"required": True}, - "message": {"required": True}, - } - - _attribute_map = { - "code": {"key": "code", "type": "str"}, - "message": {"key": "message", "type": "str"}, - "details": {"key": "details", "type": "[ErrorDetails]"}, - } - - def __init__( - self, *, code: str, message: str, details: Optional[list["_models.ErrorDetails"]] = None, **kwargs: Any - ) -> None: - """ - :keyword code: Error code identifying the specific error. Required. - :paramtype code: str - :keyword message: A human readable error message. Required. - :paramtype message: str - :keyword details: Error details. - :paramtype details: list[~azure.mgmt.resourcegraph.models.ErrorDetails] - """ - super().__init__(**kwargs) - self.code = code - self.message = message - self.details = details - - -class ErrorDetails(_serialization.Model): - """Error details. - - All required parameters must be populated in order to send to server. - - :ivar additional_properties: Unmatched properties from the message are deserialized to this - collection. - :vartype additional_properties: dict[str, JSON] - :ivar code: Error code identifying the specific error. Required. - :vartype code: str - :ivar message: A human readable error message. Required. - :vartype message: str - """ - - _validation = { - "code": {"required": True}, - "message": {"required": True}, - } - - _attribute_map = { - "additional_properties": {"key": "", "type": "{object}"}, - "code": {"key": "code", "type": "str"}, - "message": {"key": "message", "type": "str"}, - } - - def __init__( - self, *, code: str, message: str, additional_properties: Optional[dict[str, JSON]] = None, **kwargs: Any - ) -> None: - """ - :keyword additional_properties: Unmatched properties from the message are deserialized to this - collection. - :paramtype additional_properties: dict[str, JSON] - :keyword code: Error code identifying the specific error. Required. - :paramtype code: str - :keyword message: A human readable error message. Required. - :paramtype message: str - """ - super().__init__(**kwargs) - self.additional_properties = additional_properties - self.code = code - self.message = message - - -class ErrorFieldContract(_serialization.Model): - """Error Field contract. - - :ivar code: Property level error code. - :vartype code: str - :ivar message: Human-readable representation of property-level error. - :vartype message: str - :ivar target: Property name. - :vartype target: str - """ - - _attribute_map = { - "code": {"key": "code", "type": "str"}, - "message": {"key": "message", "type": "str"}, - "target": {"key": "target", "type": "str"}, - } - - def __init__( - self, *, code: Optional[str] = None, message: Optional[str] = None, target: Optional[str] = None, **kwargs: Any - ) -> None: - """ - :keyword code: Property level error code. - :paramtype code: str - :keyword message: Human-readable representation of property-level error. - :paramtype message: str - :keyword target: Property name. - :paramtype target: str - """ - super().__init__(**kwargs) - self.code = code - self.message = message - self.target = target - - -class ErrorResponse(_serialization.Model): - """An error response from the API. - - All required parameters must be populated in order to send to server. - - :ivar error: Error information. Required. - :vartype error: ~azure.mgmt.resourcegraph.models.Error - """ - - _validation = { - "error": {"required": True}, - } - - _attribute_map = { - "error": {"key": "error", "type": "Error"}, - } - - def __init__(self, *, error: "_models.Error", **kwargs: Any) -> None: - """ - :keyword error: Error information. Required. - :paramtype error: ~azure.mgmt.resourcegraph.models.Error - """ - super().__init__(**kwargs) - self.error = error - - -class Facet(_serialization.Model): - """A facet containing additional statistics on the response of a query. Can be either FacetResult - or FacetError. - - You probably want to use the sub-classes and not this class directly. Known sub-classes are: - FacetError, FacetResult - - All required parameters must be populated in order to send to server. - - :ivar expression: Facet expression, same as in the corresponding facet request. Required. - :vartype expression: str - :ivar result_type: Result type. Required. - :vartype result_type: str - """ - - _validation = { - "expression": {"required": True}, - "result_type": {"required": True}, - } - - _attribute_map = { - "expression": {"key": "expression", "type": "str"}, - "result_type": {"key": "resultType", "type": "str"}, - } - - _subtype_map = {"result_type": {"FacetError": "FacetError", "FacetResult": "FacetResult"}} - - def __init__(self, *, expression: str, **kwargs: Any) -> None: - """ - :keyword expression: Facet expression, same as in the corresponding facet request. Required. - :paramtype expression: str - """ - super().__init__(**kwargs) - self.expression = expression - self.result_type: Optional[str] = None - - -class FacetError(Facet): - """A facet whose execution resulted in an error. - - All required parameters must be populated in order to send to server. - - :ivar expression: Facet expression, same as in the corresponding facet request. Required. - :vartype expression: str - :ivar result_type: Result type. Required. - :vartype result_type: str - :ivar errors: An array containing detected facet errors with details. Required. - :vartype errors: list[~azure.mgmt.resourcegraph.models.ErrorDetails] - """ - - _validation = { - "expression": {"required": True}, - "result_type": {"required": True}, - "errors": {"required": True}, - } - - _attribute_map = { - "expression": {"key": "expression", "type": "str"}, - "result_type": {"key": "resultType", "type": "str"}, - "errors": {"key": "errors", "type": "[ErrorDetails]"}, - } - - def __init__(self, *, expression: str, errors: list["_models.ErrorDetails"], **kwargs: Any) -> None: - """ - :keyword expression: Facet expression, same as in the corresponding facet request. Required. - :paramtype expression: str - :keyword errors: An array containing detected facet errors with details. Required. - :paramtype errors: list[~azure.mgmt.resourcegraph.models.ErrorDetails] - """ - super().__init__(expression=expression, **kwargs) - self.result_type: str = "FacetError" - self.errors = errors - - -class FacetRequest(_serialization.Model): - """A request to compute additional statistics (facets) over the query results. - - All required parameters must be populated in order to send to server. - - :ivar expression: The column or list of columns to summarize by. Required. - :vartype expression: str - :ivar options: The options for facet evaluation. - :vartype options: ~azure.mgmt.resourcegraph.models.FacetRequestOptions - """ - - _validation = { - "expression": {"required": True}, - } - - _attribute_map = { - "expression": {"key": "expression", "type": "str"}, - "options": {"key": "options", "type": "FacetRequestOptions"}, - } - - def __init__( - self, *, expression: str, options: Optional["_models.FacetRequestOptions"] = None, **kwargs: Any - ) -> None: - """ - :keyword expression: The column or list of columns to summarize by. Required. - :paramtype expression: str - :keyword options: The options for facet evaluation. - :paramtype options: ~azure.mgmt.resourcegraph.models.FacetRequestOptions - """ - super().__init__(**kwargs) - self.expression = expression - self.options = options - - -class FacetRequestOptions(_serialization.Model): - """The options for facet evaluation. - - :ivar sort_by: The column name or query expression to sort on. Defaults to count if not - present. - :vartype sort_by: str - :ivar sort_order: The sorting order by the selected column (count by default). Known values - are: "asc" and "desc". - :vartype sort_order: str or ~azure.mgmt.resourcegraph.models.FacetSortOrder - :ivar filter: Specifies the filter condition for the 'where' clause which will be run on main - query's result, just before the actual faceting. - :vartype filter: str - :ivar top: The maximum number of facet rows that should be returned. - :vartype top: int - """ - - _validation = { - "top": {"maximum": 1000, "minimum": 1}, - } - - _attribute_map = { - "sort_by": {"key": "sortBy", "type": "str"}, - "sort_order": {"key": "sortOrder", "type": "str"}, - "filter": {"key": "filter", "type": "str"}, - "top": {"key": "$top", "type": "int"}, - } - - def __init__( - self, - *, - sort_by: Optional[str] = None, - sort_order: Union[str, "_models.FacetSortOrder"] = "desc", - filter: Optional[str] = None, # pylint: disable=redefined-builtin - top: Optional[int] = None, - **kwargs: Any - ) -> None: - """ - :keyword sort_by: The column name or query expression to sort on. Defaults to count if not - present. - :paramtype sort_by: str - :keyword sort_order: The sorting order by the selected column (count by default). Known values - are: "asc" and "desc". - :paramtype sort_order: str or ~azure.mgmt.resourcegraph.models.FacetSortOrder - :keyword filter: Specifies the filter condition for the 'where' clause which will be run on - main query's result, just before the actual faceting. - :paramtype filter: str - :keyword top: The maximum number of facet rows that should be returned. - :paramtype top: int - """ - super().__init__(**kwargs) - self.sort_by = sort_by - self.sort_order = sort_order - self.filter = filter - self.top = top - - -class FacetResult(Facet): - """Successfully executed facet containing additional statistics on the response of a query. - - All required parameters must be populated in order to send to server. - - :ivar expression: Facet expression, same as in the corresponding facet request. Required. - :vartype expression: str - :ivar result_type: Result type. Required. - :vartype result_type: str - :ivar total_records: Number of total records in the facet results. Required. - :vartype total_records: int - :ivar count: Number of records returned in the facet response. Required. - :vartype count: int - :ivar data: A JObject array or Table containing the desired facets. Only present if the facet - is valid. Required. - :vartype data: JSON - """ - - _validation = { - "expression": {"required": True}, - "result_type": {"required": True}, - "total_records": {"required": True}, - "count": {"required": True}, - "data": {"required": True}, - } - - _attribute_map = { - "expression": {"key": "expression", "type": "str"}, - "result_type": {"key": "resultType", "type": "str"}, - "total_records": {"key": "totalRecords", "type": "int"}, - "count": {"key": "count", "type": "int"}, - "data": {"key": "data", "type": "object"}, - } - - def __init__(self, *, expression: str, total_records: int, count: int, data: JSON, **kwargs: Any) -> None: - """ - :keyword expression: Facet expression, same as in the corresponding facet request. Required. - :paramtype expression: str - :keyword total_records: Number of total records in the facet results. Required. - :paramtype total_records: int - :keyword count: Number of records returned in the facet response. Required. - :paramtype count: int - :keyword data: A JObject array or Table containing the desired facets. Only present if the - facet is valid. Required. - :paramtype data: JSON - """ - super().__init__(expression=expression, **kwargs) - self.result_type: str = "FacetResult" - self.total_records = total_records - self.count = count - self.data = data - - -class GraphQueryError(_serialization.Model): - """Error message body that will indicate why the operation failed. - - :ivar error: The error object. - :vartype error: ~azure.mgmt.resourcegraph.models.GraphQueryErrorError - """ - - _attribute_map = { - "error": {"key": "error", "type": "GraphQueryErrorError"}, - } - - def __init__(self, *, error: Optional["_models.GraphQueryErrorError"] = None, **kwargs: Any) -> None: - """ - :keyword error: The error object. - :paramtype error: ~azure.mgmt.resourcegraph.models.GraphQueryErrorError - """ - super().__init__(**kwargs) - self.error = error - - -class GraphQueryErrorError(_serialization.Model): - """The error object. - - :ivar code: Service-defined error code. This code serves as a sub-status for the HTTP error - code specified in the response. - :vartype code: str - :ivar message: Human-readable representation of the error. - :vartype message: str - :ivar details: The list of invalid fields send in request, in case of validation error. - :vartype details: list[~azure.mgmt.resourcegraph.models.ErrorFieldContract] - """ - - _attribute_map = { - "code": {"key": "code", "type": "str"}, - "message": {"key": "message", "type": "str"}, - "details": {"key": "details", "type": "[ErrorFieldContract]"}, - } - - def __init__( - self, - *, - code: Optional[str] = None, - message: Optional[str] = None, - details: Optional[list["_models.ErrorFieldContract"]] = None, - **kwargs: Any - ) -> None: - """ - :keyword code: Service-defined error code. This code serves as a sub-status for the HTTP error - code specified in the response. - :paramtype code: str - :keyword message: Human-readable representation of the error. - :paramtype message: str - :keyword details: The list of invalid fields send in request, in case of validation error. - :paramtype details: list[~azure.mgmt.resourcegraph.models.ErrorFieldContract] - """ - super().__init__(**kwargs) - self.code = code - self.message = message - self.details = details - - -class GraphQueryListResult(_serialization.Model): - """Graph query list result. - - Variables are only populated by the server, and will be ignored when sending a request. - - :ivar next_link: URL to fetch the next set of queries. - :vartype next_link: str - :ivar value: An array of graph queries. - :vartype value: list[~azure.mgmt.resourcegraph.models.GraphQueryResource] - """ - - _validation = { - "value": {"readonly": True}, - } - - _attribute_map = { - "next_link": {"key": "nextLink", "type": "str"}, - "value": {"key": "value", "type": "[GraphQueryResource]"}, - } - - def __init__(self, *, next_link: Optional[str] = None, **kwargs: Any) -> None: - """ - :keyword next_link: URL to fetch the next set of queries. - :paramtype next_link: str - """ - super().__init__(**kwargs) - self.next_link = next_link - self.value: Optional[list["_models.GraphQueryResource"]] = None - - -class Resource(_serialization.Model): - """An azure resource object. - - Variables are only populated by the server, and will be ignored when sending a request. - - :ivar id: Azure resource Id. - :vartype id: str - :ivar name: Azure resource name. This is GUID value. The display name should be assigned within - properties field. - :vartype name: str - :ivar location: The location of the resource. - :vartype location: str - :ivar type: Azure resource type. - :vartype type: str - :ivar etag: This will be used to handle Optimistic Concurrency. If not present, it will always - overwrite the existing resource without checking conflict. - :vartype etag: str - :ivar tags: Resource tags. - :vartype tags: dict[str, str] - """ - - _validation = { - "id": {"readonly": True}, - "name": {"readonly": True}, - "type": {"readonly": True}, - } - - _attribute_map = { - "id": {"key": "id", "type": "str"}, - "name": {"key": "name", "type": "str"}, - "location": {"key": "location", "type": "str"}, - "type": {"key": "type", "type": "str"}, - "etag": {"key": "etag", "type": "str"}, - "tags": {"key": "tags", "type": "{str}"}, - } - - def __init__( - self, - *, - location: Optional[str] = None, - etag: Optional[str] = None, - tags: Optional[dict[str, str]] = None, - **kwargs: Any - ) -> None: - """ - :keyword location: The location of the resource. - :paramtype location: str - :keyword etag: This will be used to handle Optimistic Concurrency. If not present, it will - always overwrite the existing resource without checking conflict. - :paramtype etag: str - :keyword tags: Resource tags. - :paramtype tags: dict[str, str] - """ - super().__init__(**kwargs) - self.id: Optional[str] = None - self.name: Optional[str] = None - self.location = location - self.type: Optional[str] = None - self.etag = etag - self.tags = tags - - -class GraphQueryResource(Resource): - """Graph Query entity definition. - - Variables are only populated by the server, and will be ignored when sending a request. - - :ivar id: Azure resource Id. - :vartype id: str - :ivar name: Azure resource name. This is GUID value. The display name should be assigned within - properties field. - :vartype name: str - :ivar location: The location of the resource. - :vartype location: str - :ivar type: Azure resource type. - :vartype type: str - :ivar etag: This will be used to handle Optimistic Concurrency. If not present, it will always - overwrite the existing resource without checking conflict. - :vartype etag: str - :ivar tags: Resource tags. - :vartype tags: dict[str, str] - :ivar time_modified: Date and time in UTC of the last modification that was made to this graph - query definition. - :vartype time_modified: ~datetime.datetime - :ivar description: The description of a graph query. - :vartype description: str - :ivar query: KQL query that will be graph. - :vartype query: str - :ivar result_kind: Enum indicating a type of graph query. "basic" - :vartype result_kind: str or ~azure.mgmt.resourcegraph.models.ResultKind - """ - - _validation = { - "id": {"readonly": True}, - "name": {"readonly": True}, - "type": {"readonly": True}, - "time_modified": {"readonly": True}, - "result_kind": {"readonly": True}, - } - - _attribute_map = { - "id": {"key": "id", "type": "str"}, - "name": {"key": "name", "type": "str"}, - "location": {"key": "location", "type": "str"}, - "type": {"key": "type", "type": "str"}, - "etag": {"key": "etag", "type": "str"}, - "tags": {"key": "tags", "type": "{str}"}, - "time_modified": {"key": "properties.timeModified", "type": "iso-8601"}, - "description": {"key": "properties.description", "type": "str"}, - "query": {"key": "properties.query", "type": "str"}, - "result_kind": {"key": "properties.resultKind", "type": "str"}, - } - - def __init__( - self, - *, - location: Optional[str] = None, - etag: Optional[str] = None, - tags: Optional[dict[str, str]] = None, - description: Optional[str] = None, - query: Optional[str] = None, - **kwargs: Any - ) -> None: - """ - :keyword location: The location of the resource. - :paramtype location: str - :keyword etag: This will be used to handle Optimistic Concurrency. If not present, it will - always overwrite the existing resource without checking conflict. - :paramtype etag: str - :keyword tags: Resource tags. - :paramtype tags: dict[str, str] - :keyword description: The description of a graph query. - :paramtype description: str - :keyword query: KQL query that will be graph. - :paramtype query: str - """ - super().__init__(location=location, etag=etag, tags=tags, **kwargs) - self.time_modified: Optional[datetime.datetime] = None - self.description = description - self.query = query - self.result_kind: Optional[Union[str, "_models.ResultKind"]] = None - - -class GraphQueryUpdateParameters(_serialization.Model): - """The parameters that can be provided when updating workbook properties properties. - - :ivar tags: Resource tags. - :vartype tags: dict[str, str] - :ivar etag: This will be used to handle Optimistic Concurrency. If not present, it will always - overwrite the existing resource without checking conflict. - :vartype etag: str - :ivar description: The description of a graph query. - :vartype description: str - :ivar query: KQL query that will be graph. - :vartype query: str - """ - - _attribute_map = { - "tags": {"key": "tags", "type": "{str}"}, - "etag": {"key": "etag", "type": "str"}, - "description": {"key": "properties.description", "type": "str"}, - "query": {"key": "properties.query", "type": "str"}, - } - - def __init__( - self, - *, - tags: Optional[dict[str, str]] = None, - etag: Optional[str] = None, - description: Optional[str] = None, - query: Optional[str] = None, - **kwargs: Any - ) -> None: - """ - :keyword tags: Resource tags. - :paramtype tags: dict[str, str] - :keyword etag: This will be used to handle Optimistic Concurrency. If not present, it will - always overwrite the existing resource without checking conflict. - :paramtype etag: str - :keyword description: The description of a graph query. - :paramtype description: str - :keyword query: KQL query that will be graph. - :paramtype query: str - """ - super().__init__(**kwargs) - self.tags = tags - self.etag = etag - self.description = description - self.query = query - - -class Operation(_serialization.Model): - """Resource Graph REST API operation definition. - - :ivar name: Operation name: {provider}/{resource}/{operation}. - :vartype name: str - :ivar display: Display metadata associated with the operation. - :vartype display: ~azure.mgmt.resourcegraph.models.OperationDisplay - :ivar origin: The origin of operations. - :vartype origin: str - """ - - _attribute_map = { - "name": {"key": "name", "type": "str"}, - "display": {"key": "display", "type": "OperationDisplay"}, - "origin": {"key": "origin", "type": "str"}, - } - - def __init__( - self, - *, - name: Optional[str] = None, - display: Optional["_models.OperationDisplay"] = None, - origin: Optional[str] = None, - **kwargs: Any - ) -> None: - """ - :keyword name: Operation name: {provider}/{resource}/{operation}. - :paramtype name: str - :keyword display: Display metadata associated with the operation. - :paramtype display: ~azure.mgmt.resourcegraph.models.OperationDisplay - :keyword origin: The origin of operations. - :paramtype origin: str - """ - super().__init__(**kwargs) - self.name = name - self.display = display - self.origin = origin - - -class OperationDisplay(_serialization.Model): - """Display metadata associated with the operation. - - :ivar provider: Service provider: Microsoft Resource Graph. - :vartype provider: str - :ivar resource: Resource on which the operation is performed etc. - :vartype resource: str - :ivar operation: Type of operation: get, read, delete, etc. - :vartype operation: str - :ivar description: Description for the operation. - :vartype description: str - """ - - _attribute_map = { - "provider": {"key": "provider", "type": "str"}, - "resource": {"key": "resource", "type": "str"}, - "operation": {"key": "operation", "type": "str"}, - "description": {"key": "description", "type": "str"}, - } - - def __init__( - self, - *, - provider: Optional[str] = None, - resource: Optional[str] = None, - operation: Optional[str] = None, - description: Optional[str] = None, - **kwargs: Any - ) -> None: - """ - :keyword provider: Service provider: Microsoft Resource Graph. - :paramtype provider: str - :keyword resource: Resource on which the operation is performed etc. - :paramtype resource: str - :keyword operation: Type of operation: get, read, delete, etc. - :paramtype operation: str - :keyword description: Description for the operation. - :paramtype description: str - """ - super().__init__(**kwargs) - self.provider = provider - self.resource = resource - self.operation = operation - self.description = description - - -class OperationListResult(_serialization.Model): - """Result of the request to list Resource Graph operations. It contains a list of operations and a - URL link to get the next set of results. - - :ivar value: List of Resource Graph operations supported by the Resource Graph resource - provider. - :vartype value: list[~azure.mgmt.resourcegraph.models.Operation] - """ - - _attribute_map = { - "value": {"key": "value", "type": "[Operation]"}, - } - - def __init__(self, *, value: Optional[list["_models.Operation"]] = None, **kwargs: Any) -> None: - """ - :keyword value: List of Resource Graph operations supported by the Resource Graph resource - provider. - :paramtype value: list[~azure.mgmt.resourcegraph.models.Operation] - """ - super().__init__(**kwargs) - self.value = value - - -class QueryRequest(_serialization.Model): - """Describes a query to be executed. - - All required parameters must be populated in order to send to server. - - :ivar subscriptions: Azure subscriptions against which to execute the query. - :vartype subscriptions: list[str] - :ivar management_groups: Azure management groups against which to execute the query. Example: [ - 'mg1', 'mg2' ]. - :vartype management_groups: list[str] - :ivar query: The resources query. Required. - :vartype query: str - :ivar options: The query evaluation options. - :vartype options: ~azure.mgmt.resourcegraph.models.QueryRequestOptions - :ivar facets: An array of facet requests to be computed against the query result. - :vartype facets: list[~azure.mgmt.resourcegraph.models.FacetRequest] - """ - - _validation = { - "query": {"required": True}, - } - - _attribute_map = { - "subscriptions": {"key": "subscriptions", "type": "[str]"}, - "management_groups": {"key": "managementGroups", "type": "[str]"}, - "query": {"key": "query", "type": "str"}, - "options": {"key": "options", "type": "QueryRequestOptions"}, - "facets": {"key": "facets", "type": "[FacetRequest]"}, - } - - def __init__( - self, - *, - query: str, - subscriptions: Optional[list[str]] = None, - management_groups: Optional[list[str]] = None, - options: Optional["_models.QueryRequestOptions"] = None, - facets: Optional[list["_models.FacetRequest"]] = None, - **kwargs: Any - ) -> None: - """ - :keyword subscriptions: Azure subscriptions against which to execute the query. - :paramtype subscriptions: list[str] - :keyword management_groups: Azure management groups against which to execute the query. - Example: [ 'mg1', 'mg2' ]. - :paramtype management_groups: list[str] - :keyword query: The resources query. Required. - :paramtype query: str - :keyword options: The query evaluation options. - :paramtype options: ~azure.mgmt.resourcegraph.models.QueryRequestOptions - :keyword facets: An array of facet requests to be computed against the query result. - :paramtype facets: list[~azure.mgmt.resourcegraph.models.FacetRequest] - """ - super().__init__(**kwargs) - self.subscriptions = subscriptions - self.management_groups = management_groups - self.query = query - self.options = options - self.facets = facets - - -class QueryRequestOptions(_serialization.Model): - """The options for query evaluation. - - :ivar skip_token: Continuation token for pagination, capturing the next page size and offset, - as well as the context of the query. - :vartype skip_token: str - :ivar top: The maximum number of rows that the query should return. Overrides the page size - when ``$skipToken`` property is present. - :vartype top: int - :ivar skip: The number of rows to skip from the beginning of the results. Overrides the next - page offset when ``$skipToken`` property is present. - :vartype skip: int - :ivar result_format: Defines in which format query result returned. Known values are: "table" - and "objectArray". - :vartype result_format: str or ~azure.mgmt.resourcegraph.models.ResultFormat - :ivar allow_partial_scopes: Only applicable for tenant and management group level queries to - decide whether to allow partial scopes for result in case the number of subscriptions exceed - allowed limits. - :vartype allow_partial_scopes: bool - """ - - _validation = { - "top": {"maximum": 1000, "minimum": 1}, - "skip": {"minimum": 0}, - } - - _attribute_map = { - "skip_token": {"key": "$skipToken", "type": "str"}, - "top": {"key": "$top", "type": "int"}, - "skip": {"key": "$skip", "type": "int"}, - "result_format": {"key": "resultFormat", "type": "str"}, - "allow_partial_scopes": {"key": "allowPartialScopes", "type": "bool"}, - } - - def __init__( - self, - *, - skip_token: Optional[str] = None, - top: Optional[int] = None, - skip: Optional[int] = None, - result_format: Union[str, "_models.ResultFormat"] = "objectArray", - allow_partial_scopes: bool = False, - **kwargs: Any - ) -> None: - """ - :keyword skip_token: Continuation token for pagination, capturing the next page size and - offset, as well as the context of the query. - :paramtype skip_token: str - :keyword top: The maximum number of rows that the query should return. Overrides the page size - when ``$skipToken`` property is present. - :paramtype top: int - :keyword skip: The number of rows to skip from the beginning of the results. Overrides the next - page offset when ``$skipToken`` property is present. - :paramtype skip: int - :keyword result_format: Defines in which format query result returned. Known values are: - "table" and "objectArray". - :paramtype result_format: str or ~azure.mgmt.resourcegraph.models.ResultFormat - :keyword allow_partial_scopes: Only applicable for tenant and management group level queries to - decide whether to allow partial scopes for result in case the number of subscriptions exceed - allowed limits. - :paramtype allow_partial_scopes: bool - """ - super().__init__(**kwargs) - self.skip_token = skip_token - self.top = top - self.skip = skip - self.result_format = result_format - self.allow_partial_scopes = allow_partial_scopes - - -class QueryResponse(_serialization.Model): - """Query result. - - All required parameters must be populated in order to send to server. - - :ivar total_records: Number of total records matching the query. Required. - :vartype total_records: int - :ivar count: Number of records returned in the current response. In the case of paging, this is - the number of records in the current page. Required. - :vartype count: int - :ivar result_truncated: Indicates whether the query results are truncated. Required. Known - values are: "true" and "false". - :vartype result_truncated: str or ~azure.mgmt.resourcegraph.models.ResultTruncated - :ivar skip_token: When present, the value can be passed to a subsequent query call (together - with the same query and scopes used in the current request) to retrieve the next page of data. - :vartype skip_token: str - :ivar data: Query output in JObject array or Table format. Required. - :vartype data: JSON - :ivar facets: Query facets. - :vartype facets: list[~azure.mgmt.resourcegraph.models.Facet] - """ - - _validation = { - "total_records": {"required": True}, - "count": {"required": True}, - "result_truncated": {"required": True}, - "data": {"required": True}, - } - - _attribute_map = { - "total_records": {"key": "totalRecords", "type": "int"}, - "count": {"key": "count", "type": "int"}, - "result_truncated": {"key": "resultTruncated", "type": "str"}, - "skip_token": {"key": "$skipToken", "type": "str"}, - "data": {"key": "data", "type": "object"}, - "facets": {"key": "facets", "type": "[Facet]"}, - } - - def __init__( - self, - *, - total_records: int, - count: int, - result_truncated: Union[str, "_models.ResultTruncated"], - data: JSON, - skip_token: Optional[str] = None, - facets: Optional[list["_models.Facet"]] = None, - **kwargs: Any - ) -> None: - """ - :keyword total_records: Number of total records matching the query. Required. - :paramtype total_records: int - :keyword count: Number of records returned in the current response. In the case of paging, this - is the number of records in the current page. Required. - :paramtype count: int - :keyword result_truncated: Indicates whether the query results are truncated. Required. Known - values are: "true" and "false". - :paramtype result_truncated: str or ~azure.mgmt.resourcegraph.models.ResultTruncated - :keyword skip_token: When present, the value can be passed to a subsequent query call (together - with the same query and scopes used in the current request) to retrieve the next page of data. - :paramtype skip_token: str - :keyword data: Query output in JObject array or Table format. Required. - :paramtype data: JSON - :keyword facets: Query facets. - :paramtype facets: list[~azure.mgmt.resourcegraph.models.Facet] - """ - super().__init__(**kwargs) - self.total_records = total_records - self.count = count - self.result_truncated = result_truncated - self.skip_token = skip_token - self.data = data - self.facets = facets - - -class Table(_serialization.Model): - """Query output in tabular format. - - All required parameters must be populated in order to send to server. - - :ivar columns: Query result column descriptors. Required. - :vartype columns: list[~azure.mgmt.resourcegraph.models.Column] - :ivar rows: Query result rows. Required. - :vartype rows: list[list[JSON]] - """ - - _validation = { - "columns": {"required": True}, - "rows": {"required": True}, - } - - _attribute_map = { - "columns": {"key": "columns", "type": "[Column]"}, - "rows": {"key": "rows", "type": "[[object]]"}, - } - - def __init__(self, *, columns: list["_models.Column"], rows: list[list[JSON]], **kwargs: Any) -> None: - """ - :keyword columns: Query result column descriptors. Required. - :paramtype columns: list[~azure.mgmt.resourcegraph.models.Column] - :keyword rows: Query result rows. Required. - :paramtype rows: list[list[JSON]] - """ - super().__init__(**kwargs) - self.columns = columns - self.rows = rows diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_patch.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_patch.py index f7dd32510333..ea765788358a 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_patch.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_patch.py @@ -1,14 +1,14 @@ -# ------------------------------------ -# Copyright (c) Microsoft Corporation. -# Licensed under the MIT License. -# ------------------------------------ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# -------------------------------------------------------------------------- """Customize generated code here. Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import List -__all__: List[str] = [] # Add all objects you want publicly available to users at this package level +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_resource_graph_client_enums.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_resource_graph_client_enums.py deleted file mode 100644 index a6a1c5f90b6d..000000000000 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/models/_resource_graph_client_enums.py +++ /dev/null @@ -1,47 +0,0 @@ -# coding=utf-8 -# -------------------------------------------------------------------------- -# Copyright (c) Microsoft Corporation. All rights reserved. -# Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. -# Changes may cause incorrect behavior and will be lost if the code is regenerated. -# -------------------------------------------------------------------------- - -from enum import Enum -from azure.core import CaseInsensitiveEnumMeta - - -class ColumnDataType(str, Enum, metaclass=CaseInsensitiveEnumMeta): - """Data type of a column in a table.""" - - STRING = "string" - INTEGER = "integer" - NUMBER = "number" - BOOLEAN = "boolean" - OBJECT = "object" - - -class FacetSortOrder(str, Enum, metaclass=CaseInsensitiveEnumMeta): - """The sorting order by the selected column (count by default).""" - - ASC = "asc" - DESC = "desc" - - -class ResultFormat(str, Enum, metaclass=CaseInsensitiveEnumMeta): - """Defines in which format query result returned.""" - - TABLE = "table" - OBJECT_ARRAY = "objectArray" - - -class ResultKind(str, Enum, metaclass=CaseInsensitiveEnumMeta): - """Enum indicating a type of graph query.""" - - BASIC = "basic" - - -class ResultTruncated(str, Enum, metaclass=CaseInsensitiveEnumMeta): - """Indicates whether the query results are truncated.""" - - TRUE = "true" - FALSE = "false" diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/__init__.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/__init__.py index 68f1119ec35f..91d96dc031d6 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/__init__.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/__init__.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- # pylint: disable=wrong-import-position @@ -13,9 +12,9 @@ if TYPE_CHECKING: from ._patch import * # pylint: disable=unused-wildcard-import -from ._resource_graph_client_operations import _ResourceGraphClientOperationsMixin # type: ignore # pylint: disable=unused-import from ._operations import Operations # type: ignore -from ._graph_query_operations import GraphQueryOperations # type: ignore +from ._operations import GraphQueryOperations # type: ignore +from ._operations import _ResourceGraphClientOperationsMixin # type: ignore # pylint: disable=unused-import from ._patch import __all__ as _patch_all from ._patch import * diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_graph_query_operations.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_graph_query_operations.py deleted file mode 100644 index b309906143f7..000000000000 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_graph_query_operations.py +++ /dev/null @@ -1,804 +0,0 @@ -# pylint: disable=line-too-long,useless-suppression -# coding=utf-8 -# -------------------------------------------------------------------------- -# Copyright (c) Microsoft Corporation. All rights reserved. -# Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. -# Changes may cause incorrect behavior and will be lost if the code is regenerated. -# -------------------------------------------------------------------------- -from collections.abc import MutableMapping -from io import IOBase -from typing import Any, Callable, IO, Optional, TypeVar, Union, overload -import urllib.parse - -from azure.core import PipelineClient -from azure.core.exceptions import ( - ClientAuthenticationError, - HttpResponseError, - ResourceExistsError, - ResourceNotFoundError, - ResourceNotModifiedError, - map_error, -) -from azure.core.paging import ItemPaged -from azure.core.pipeline import PipelineResponse -from azure.core.rest import HttpRequest, HttpResponse -from azure.core.tracing.decorator import distributed_trace -from azure.core.utils import case_insensitive_dict -from azure.mgmt.core.exceptions import ARMErrorFormat - -from .. import models as _models -from .._configuration import ResourceGraphClientConfiguration -from .._utils.serialization import Deserializer, Serializer - -T = TypeVar("T") -ClsType = Optional[Callable[[PipelineResponse[HttpRequest, HttpResponse], T, dict[str, Any]], Any]] -List = list - -_SERIALIZER = Serializer() -_SERIALIZER.client_side_validation = False - - -def build_list_by_subscription_request(subscription_id: str, **kwargs: Any) -> HttpRequest: - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-03-01")) - accept = _headers.pop("Accept", "application/json") - - # Construct URL - _url = kwargs.pop("template_url", "/subscriptions/{subscriptionId}/providers/Microsoft.ResourceGraph/queries") - path_format_arguments = { - "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), - } - - _url: str = _url.format(**path_format_arguments) # type: ignore - - # Construct parameters - _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") - - # Construct headers - _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") - - return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) - - -def build_list_request(subscription_id: str, resource_group_name: str, **kwargs: Any) -> HttpRequest: - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-03-01")) - accept = _headers.pop("Accept", "application/json") - - # Construct URL - _url = kwargs.pop( - "template_url", - "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries", - ) - path_format_arguments = { - "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), - "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), - } - - _url: str = _url.format(**path_format_arguments) # type: ignore - - # Construct parameters - _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") - - # Construct headers - _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") - - return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) - - -def build_get_request(subscription_id: str, resource_group_name: str, resource_name: str, **kwargs: Any) -> HttpRequest: - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-03-01")) - accept = _headers.pop("Accept", "application/json") - - # Construct URL - _url = kwargs.pop( - "template_url", - "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}", - ) - path_format_arguments = { - "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), - "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), - "resourceName": _SERIALIZER.url("resource_name", resource_name, "str", pattern=r"^[^<>&:\?]*$"), - } - - _url: str = _url.format(**path_format_arguments) # type: ignore - - # Construct parameters - _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") - - # Construct headers - _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") - - return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) - - -def build_delete_request( - subscription_id: str, resource_group_name: str, resource_name: str, **kwargs: Any -) -> HttpRequest: - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-03-01")) - accept = _headers.pop("Accept", "application/json") - - # Construct URL - _url = kwargs.pop( - "template_url", - "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}", - ) - path_format_arguments = { - "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), - "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), - "resourceName": _SERIALIZER.url("resource_name", resource_name, "str", pattern=r"^[^<>&:\?]*$"), - } - - _url: str = _url.format(**path_format_arguments) # type: ignore - - # Construct parameters - _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") - - # Construct headers - _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") - - return HttpRequest(method="DELETE", url=_url, params=_params, headers=_headers, **kwargs) - - -def build_create_or_update_request( - subscription_id: str, resource_group_name: str, resource_name: str, **kwargs: Any -) -> HttpRequest: - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-03-01")) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - accept = _headers.pop("Accept", "application/json") - - # Construct URL - _url = kwargs.pop( - "template_url", - "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}", - ) - path_format_arguments = { - "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), - "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), - "resourceName": _SERIALIZER.url("resource_name", resource_name, "str", pattern=r"^[^<>&:\?]*$"), - } - - _url: str = _url.format(**path_format_arguments) # type: ignore - - # Construct parameters - _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") - - # Construct headers - if content_type is not None: - _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") - _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") - - return HttpRequest(method="PUT", url=_url, params=_params, headers=_headers, **kwargs) - - -def build_update_request( - subscription_id: str, resource_group_name: str, resource_name: str, **kwargs: Any -) -> HttpRequest: - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-03-01")) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - accept = _headers.pop("Accept", "application/json") - - # Construct URL - _url = kwargs.pop( - "template_url", - "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}", - ) - path_format_arguments = { - "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), - "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), - "resourceName": _SERIALIZER.url("resource_name", resource_name, "str", pattern=r"^[^<>&:\?]*$"), - } - - _url: str = _url.format(**path_format_arguments) # type: ignore - - # Construct parameters - _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") - - # Construct headers - if content_type is not None: - _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") - _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") - - return HttpRequest(method="PATCH", url=_url, params=_params, headers=_headers, **kwargs) - - -class GraphQueryOperations: - """ - .. warning:: - **DO NOT** instantiate this class directly. - - Instead, you should access the following operations through - :class:`~azure.mgmt.resourcegraph.ResourceGraphClient`'s - :attr:`graph_query` attribute. - """ - - models = _models - - def __init__(self, *args, **kwargs) -> None: - input_args = list(args) - self._client: PipelineClient = input_args.pop(0) if input_args else kwargs.pop("client") - self._config: ResourceGraphClientConfiguration = input_args.pop(0) if input_args else kwargs.pop("config") - self._serialize: Serializer = input_args.pop(0) if input_args else kwargs.pop("serializer") - self._deserialize: Deserializer = input_args.pop(0) if input_args else kwargs.pop("deserializer") - - @distributed_trace - def list_by_subscription(self, subscription_id: str, **kwargs: Any) -> ItemPaged["_models.GraphQueryResource"]: - """Get all graph queries defined within a specified subscription. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :return: An iterator like instance of either GraphQueryResource or the result of cls(response) - :rtype: ~azure.core.paging.ItemPaged[~azure.mgmt.resourcegraph.models.GraphQueryResource] - :raises ~azure.core.exceptions.HttpResponseError: - """ - _headers = kwargs.pop("headers", {}) or {} - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[_models.GraphQueryListResult] = kwargs.pop("cls", None) - - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - def prepare_request(next_link=None): - if not next_link: - - _request = build_list_by_subscription_request( - subscription_id=subscription_id, - api_version=api_version, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - else: - # make call to next link with the client's api-version - _parsed_next_link = urllib.parse.urlparse(next_link) - _next_request_params = case_insensitive_dict( - { - key: [urllib.parse.quote(v) for v in value] - for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items() - } - ) - _next_request_params["api-version"] = self._config.api_version - _request = HttpRequest( - "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params - ) - _request.url = self._client.format_url(_request.url) - _request.method = "GET" - return _request - - def extract_data(pipeline_response): - deserialized = self._deserialize("GraphQueryListResult", pipeline_response) - list_of_elem = deserialized.value - if cls: - list_of_elem = cls(list_of_elem) # type: ignore - return deserialized.next_link or None, iter(list_of_elem) - - def get_next(next_link=None): - _request = prepare_request(next_link) - - _stream = False - pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - return pipeline_response - - return ItemPaged(get_next, extract_data) - - @distributed_trace - def list( - self, subscription_id: str, resource_group_name: str, **kwargs: Any - ) -> ItemPaged["_models.GraphQueryResource"]: - """Get all graph queries defined within a specified subscription and resource group. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :return: An iterator like instance of either GraphQueryResource or the result of cls(response) - :rtype: ~azure.core.paging.ItemPaged[~azure.mgmt.resourcegraph.models.GraphQueryResource] - :raises ~azure.core.exceptions.HttpResponseError: - """ - _headers = kwargs.pop("headers", {}) or {} - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[_models.GraphQueryListResult] = kwargs.pop("cls", None) - - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - def prepare_request(next_link=None): - if not next_link: - - _request = build_list_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - api_version=api_version, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - else: - # make call to next link with the client's api-version - _parsed_next_link = urllib.parse.urlparse(next_link) - _next_request_params = case_insensitive_dict( - { - key: [urllib.parse.quote(v) for v in value] - for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items() - } - ) - _next_request_params["api-version"] = self._config.api_version - _request = HttpRequest( - "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params - ) - _request.url = self._client.format_url(_request.url) - _request.method = "GET" - return _request - - def extract_data(pipeline_response): - deserialized = self._deserialize("GraphQueryListResult", pipeline_response) - list_of_elem = deserialized.value - if cls: - list_of_elem = cls(list_of_elem) # type: ignore - return deserialized.next_link or None, iter(list_of_elem) - - def get_next(next_link=None): - _request = prepare_request(next_link) - - _stream = False - pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - return pipeline_response - - return ItemPaged(get_next, extract_data) - - @distributed_trace - def get( - self, subscription_id: str, resource_group_name: str, resource_name: str, **kwargs: Any - ) -> _models.GraphQueryResource: - """Get a single graph query by its resourceName. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = kwargs.pop("headers", {}) or {} - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) - - _request = build_get_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - resource_name=resource_name, - api_version=api_version, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - deserialized = self._deserialize("GraphQueryResource", pipeline_response.http_response) - - if cls: - return cls(pipeline_response, deserialized, {}) # type: ignore - - return deserialized # type: ignore - - @distributed_trace - def delete( # pylint: disable=inconsistent-return-statements - self, subscription_id: str, resource_group_name: str, resource_name: str, **kwargs: Any - ) -> None: - """Delete a graph query. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :return: None or the result of cls(response) - :rtype: None - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = kwargs.pop("headers", {}) or {} - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[None] = kwargs.pop("cls", None) - - _request = build_delete_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - resource_name=resource_name, - api_version=api_version, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200, 204]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - if cls: - return cls(pipeline_response, None, {}) # type: ignore - - @overload - def create_or_update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - properties: _models.GraphQueryResource, - *, - content_type: str = "application/json", - **kwargs: Any - ) -> _models.GraphQueryResource: - """Create a new graph query. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param properties: Properties that need to be specified to create a new graph query. Required. - :type properties: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. - Default value is "application/json". - :paramtype content_type: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @overload - def create_or_update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - properties: IO[bytes], - *, - content_type: str = "application/json", - **kwargs: Any - ) -> _models.GraphQueryResource: - """Create a new graph query. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param properties: Properties that need to be specified to create a new graph query. Required. - :type properties: IO[bytes] - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/json". - :paramtype content_type: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @distributed_trace - def create_or_update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - properties: Union[_models.GraphQueryResource, IO[bytes]], - **kwargs: Any - ) -> _models.GraphQueryResource: - """Create a new graph query. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param properties: Properties that need to be specified to create a new graph query. Is either - a GraphQueryResource type or a IO[bytes] type. Required. - :type properties: ~azure.mgmt.resourcegraph.models.GraphQueryResource or IO[bytes] - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) - - content_type = content_type or "application/json" - _json = None - _content = None - if isinstance(properties, (IOBase, bytes)): - _content = properties - else: - _json = self._serialize.body(properties, "GraphQueryResource") - - _request = build_create_or_update_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - resource_name=resource_name, - api_version=api_version, - content_type=content_type, - json=_json, - content=_content, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200, 201]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - deserialized = self._deserialize("GraphQueryResource", pipeline_response.http_response) - - if cls: - return cls(pipeline_response, deserialized, {}) # type: ignore - - return deserialized # type: ignore - - @overload - def update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - body: _models.GraphQueryUpdateParameters, - *, - content_type: str = "application/json", - **kwargs: Any - ) -> _models.GraphQueryResource: - """Updates a graph query that has already been added. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param body: Properties that need to be specified to create a new graph query. Required. - :type body: ~azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters - :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. - Default value is "application/json". - :paramtype content_type: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @overload - def update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - body: IO[bytes], - *, - content_type: str = "application/json", - **kwargs: Any - ) -> _models.GraphQueryResource: - """Updates a graph query that has already been added. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param body: Properties that need to be specified to create a new graph query. Required. - :type body: IO[bytes] - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/json". - :paramtype content_type: str - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @distributed_trace - def update( - self, - subscription_id: str, - resource_group_name: str, - resource_name: str, - body: Union[_models.GraphQueryUpdateParameters, IO[bytes]], - **kwargs: Any - ) -> _models.GraphQueryResource: - """Updates a graph query that has already been added. - - :param subscription_id: The Azure subscription Id. Required. - :type subscription_id: str - :param resource_group_name: The name of the resource group. Required. - :type resource_group_name: str - :param resource_name: The name of the Graph Query resource. Required. - :type resource_name: str - :param body: Properties that need to be specified to create a new graph query. Is either a - GraphQueryUpdateParameters type or a IO[bytes] type. Required. - :type body: ~azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters or IO[bytes] - :return: GraphQueryResource or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) - - content_type = content_type or "application/json" - _json = None - _content = None - if isinstance(body, (IOBase, bytes)): - _content = body - else: - _json = self._serialize.body(body, "GraphQueryUpdateParameters") - - _request = build_update_request( - subscription_id=subscription_id, - resource_group_name=resource_group_name, - resource_name=resource_name, - api_version=api_version, - content_type=content_type, - json=_json, - content=_content, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.GraphQueryError, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - deserialized = self._deserialize("GraphQueryResource", pipeline_response.http_response) - - if cls: - return cls(pipeline_response, deserialized, {}) # type: ignore - - return deserialized # type: ignore diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_operations.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_operations.py index 97a3c6cc35dc..f8f56b432c43 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_operations.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_operations.py @@ -1,13 +1,15 @@ +# pylint: disable=line-too-long,useless-suppression,too-many-lines # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- from collections.abc import MutableMapping -from typing import Any, Callable, Optional, TypeVar -import urllib.parse +from io import IOBase +import json +from typing import Any, Callable, IO, Optional, TypeVar, Union, overload from azure.core import PipelineClient from azure.core.exceptions import ( @@ -16,6 +18,8 @@ ResourceExistsError, ResourceNotFoundError, ResourceNotModifiedError, + StreamClosedError, + StreamConsumedError, map_error, ) from azure.core.paging import ItemPaged @@ -27,25 +31,29 @@ from .. import models as _models from .._configuration import ResourceGraphClientConfiguration +from .._utils.model_base import SdkJSONEncoder, _deserialize, _failsafe_deserialize from .._utils.serialization import Deserializer, Serializer +from .._utils.utils import ClientMixinABC +from .._validation import api_version_validation T = TypeVar("T") ClsType = Optional[Callable[[PipelineResponse[HttpRequest, HttpResponse], T, dict[str, Any]], Any]] +JSON = MutableMapping[str, Any] List = list _SERIALIZER = Serializer() _SERIALIZER.client_side_validation = False -def build_list_request(**kwargs: Any) -> HttpRequest: +def build_operations_list_request(**kwargs: Any) -> HttpRequest: _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-03-01")) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) accept = _headers.pop("Accept", "application/json") # Construct URL - _url = kwargs.pop("template_url", "/providers/Microsoft.ResourceGraph/operations") + _url = "/providers/Microsoft.ResourceGraph/operations" # Construct parameters _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") @@ -56,6 +64,259 @@ def build_list_request(**kwargs: Any) -> HttpRequest: return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) +def build_graph_query_get_request( + resource_group_name: str, resource_name: str, subscription_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}" + path_format_arguments = { + "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), + "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), + "resourceName": _SERIALIZER.url("resource_name", resource_name, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_graph_query_create_or_update_request( # pylint: disable=name-too-long + resource_group_name: str, resource_name: str, subscription_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}" + path_format_arguments = { + "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), + "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), + "resourceName": _SERIALIZER.url("resource_name", resource_name, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="PUT", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_graph_query_update_request( + resource_group_name: str, resource_name: str, subscription_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}" + path_format_arguments = { + "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), + "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), + "resourceName": _SERIALIZER.url("resource_name", resource_name, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="PATCH", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_graph_query_delete_request( + resource_group_name: str, resource_name: str, subscription_id: str, **kwargs: Any +) -> HttpRequest: + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + # Construct URL + _url = "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}" + path_format_arguments = { + "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), + "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), + "resourceName": _SERIALIZER.url("resource_name", resource_name, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + return HttpRequest(method="DELETE", url=_url, params=_params, **kwargs) + + +def build_graph_query_list_request(resource_group_name: str, subscription_id: str, **kwargs: Any) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = ( + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries" + ) + path_format_arguments = { + "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), + "resourceGroupName": _SERIALIZER.url("resource_group_name", resource_group_name, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_graph_query_list_by_subscription_request( # pylint: disable=name-too-long + subscription_id: str, **kwargs: Any +) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/subscriptions/{subscriptionId}/providers/Microsoft.ResourceGraph/queries" + path_format_arguments = { + "subscriptionId": _SERIALIZER.url("subscription_id", subscription_id, "str"), + } + + _url: str = _url.format(**path_format_arguments) # type: ignore + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="GET", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_resource_graph_resource_changes_request(**kwargs: Any) -> HttpRequest: # pylint: disable=name-too-long + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2020-09-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/providers/Microsoft.ResourceGraph/resourceChanges" + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_resource_graph_resource_change_details_request(**kwargs: Any) -> HttpRequest: # pylint: disable=name-too-long + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2020-09-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/providers/Microsoft.ResourceGraph/resourceChangeDetails" + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_resource_graph_resources_request(**kwargs: Any) -> HttpRequest: + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/providers/Microsoft.ResourceGraph/resources" + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) + + +def build_resource_graph_resources_history_request(**kwargs: Any) -> HttpRequest: # pylint: disable=name-too-long + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-06-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + accept = _headers.pop("Accept", "application/json") + + # Construct URL + _url = "/providers/Microsoft.ResourceGraph/resourcesHistory" + + # Construct parameters + _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") + + # Construct headers + if content_type is not None: + _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") + _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") + + return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) + + class Operations: """ .. warning:: @@ -66,8 +327,6 @@ class Operations: :attr:`operations` attribute. """ - models = _models - def __init__(self, *args, **kwargs) -> None: input_args = list(args) self._client: PipelineClient = input_args.pop(0) if input_args else kwargs.pop("client") @@ -77,17 +336,17 @@ def __init__(self, *args, **kwargs) -> None: @distributed_trace def list(self, **kwargs: Any) -> ItemPaged["_models.Operation"]: - """Lists all of the available REST API operations. + """List the operations for the provider. - :return: An iterator like instance of either Operation or the result of cls(response) + :return: An iterator like instance of Operation :rtype: ~azure.core.paging.ItemPaged[~azure.mgmt.resourcegraph.models.Operation] :raises ~azure.core.exceptions.HttpResponseError: """ _headers = kwargs.pop("headers", {}) or {} _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - cls: ClsType[_models.OperationListResult] = kwargs.pop("cls", None) + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[List[_models.Operation]] = kwargs.pop("cls", None) error_map: MutableMapping = { 401: ClientAuthenticationError, @@ -100,36 +359,38 @@ def list(self, **kwargs: Any) -> ItemPaged["_models.Operation"]: def prepare_request(next_link=None): if not next_link: - _request = build_list_request( + _request = build_operations_list_request( api_version=api_version, headers=_headers, params=_params, ) - _request.url = self._client.format_url(_request.url) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) else: - # make call to next link with the client's api-version - _parsed_next_link = urllib.parse.urlparse(next_link) - _next_request_params = case_insensitive_dict( - { - key: [urllib.parse.quote(v) for v in value] - for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items() - } - ) - _next_request_params["api-version"] = self._config.api_version - _request = HttpRequest( - "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params - ) - _request.url = self._client.format_url(_request.url) - _request.method = "GET" + _request = HttpRequest("GET", next_link, headers=_headers) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + return _request def extract_data(pipeline_response): - deserialized = self._deserialize("OperationListResult", pipeline_response) - list_of_elem = deserialized.value + deserialized = pipeline_response.http_response.json() + list_of_elem = _deserialize( + List[_models.Operation], + deserialized.get("value", []), + ) if cls: list_of_elem = cls(list_of_elem) # type: ignore - return None, iter(list_of_elem) + return deserialized.get("nextLink") or None, iter(list_of_elem) def get_next(next_link=None): _request = prepare_request(next_link) @@ -142,12 +403,1196 @@ def get_next(next_link=None): if response.status_code not in [200]: map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( + error = _failsafe_deserialize( _models.ErrorResponse, - pipeline_response, + response, ) raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) return pipeline_response return ItemPaged(get_next, extract_data) + + +class GraphQueryOperations: + """ + .. warning:: + **DO NOT** instantiate this class directly. + + Instead, you should access the following operations through + :class:`~azure.mgmt.resourcegraph.ResourceGraphClient`'s + :attr:`graph_query` attribute. + """ + + def __init__(self, *args, **kwargs) -> None: + input_args = list(args) + self._client: PipelineClient = input_args.pop(0) if input_args else kwargs.pop("client") + self._config: ResourceGraphClientConfiguration = input_args.pop(0) if input_args else kwargs.pop("config") + self._serialize: Serializer = input_args.pop(0) if input_args else kwargs.pop("serializer") + self._deserialize: Deserializer = input_args.pop(0) if input_args else kwargs.pop("deserializer") + + @distributed_trace + def get(self, resource_group_name: str, resource_name: str, **kwargs: Any) -> _models.GraphQueryResource: + """Get a single graph query by its resourceName. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) + + _request = build_graph_query_get_request( + resource_group_name=resource_group_name, + resource_name=resource_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.GraphQueryResource, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + def create_or_update( + self, + resource_group_name: str, + resource_name: str, + properties: _models.GraphQueryResource, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Create a new graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param properties: Properties that need to be specified to create a new graph query. Required. + :type properties: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def create_or_update( + self, + resource_group_name: str, + resource_name: str, + properties: JSON, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Create a new graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param properties: Properties that need to be specified to create a new graph query. Required. + :type properties: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def create_or_update( + self, + resource_group_name: str, + resource_name: str, + properties: IO[bytes], + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Create a new graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param properties: Properties that need to be specified to create a new graph query. Required. + :type properties: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + def create_or_update( + self, + resource_group_name: str, + resource_name: str, + properties: Union[_models.GraphQueryResource, JSON, IO[bytes]], + **kwargs: Any + ) -> _models.GraphQueryResource: + """Create a new graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param properties: Properties that need to be specified to create a new graph query. Is one of + the following types: GraphQueryResource, JSON, IO[bytes] Required. + :type properties: ~azure.mgmt.resourcegraph.models.GraphQueryResource or JSON or IO[bytes] + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(properties, (IOBase, bytes)): + _content = properties + else: + _content = json.dumps(properties, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_graph_query_create_or_update_request( + resource_group_name=resource_group_name, + resource_name=resource_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200, 201]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.GraphQueryResource, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + def update( + self, + resource_group_name: str, + resource_name: str, + body: _models.GraphQueryUpdateParameters, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Updates a graph query that has already been added. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param body: Properties that need to be specified to create a new graph query. Required. + :type body: ~azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def update( + self, + resource_group_name: str, + resource_name: str, + body: JSON, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Updates a graph query that has already been added. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param body: Properties that need to be specified to create a new graph query. Required. + :type body: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def update( + self, + resource_group_name: str, + resource_name: str, + body: IO[bytes], + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.GraphQueryResource: + """Updates a graph query that has already been added. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param body: Properties that need to be specified to create a new graph query. Required. + :type body: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + def update( + self, + resource_group_name: str, + resource_name: str, + body: Union[_models.GraphQueryUpdateParameters, JSON, IO[bytes]], + **kwargs: Any + ) -> _models.GraphQueryResource: + """Updates a graph query that has already been added. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :param body: Properties that need to be specified to create a new graph query. Is one of the + following types: GraphQueryUpdateParameters, JSON, IO[bytes] Required. + :type body: ~azure.mgmt.resourcegraph.models.GraphQueryUpdateParameters or JSON or IO[bytes] + :return: GraphQueryResource. The GraphQueryResource is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.GraphQueryResource + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.GraphQueryResource] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(body, (IOBase, bytes)): + _content = body + else: + _content = json.dumps(body, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_graph_query_update_request( + resource_group_name=resource_group_name, + resource_name=resource_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.GraphQueryResource, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @distributed_trace + def delete( # pylint: disable=inconsistent-return-statements + self, resource_group_name: str, resource_name: str, **kwargs: Any + ) -> None: + """Delete a graph query. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :param resource_name: The name of the Graph Query resource. Required. + :type resource_name: str + :return: None + :rtype: None + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = kwargs.pop("headers", {}) or {} + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[None] = kwargs.pop("cls", None) + + _request = build_graph_query_delete_request( + resource_group_name=resource_group_name, + resource_name=resource_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _stream = False + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200, 204]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if cls: + return cls(pipeline_response, None, {}) # type: ignore + + @distributed_trace + def list(self, resource_group_name: str, **kwargs: Any) -> ItemPaged["_models.GraphQueryResource"]: + """Get all graph queries defined within a specified subscription and resource group. + + :param resource_group_name: The name of the resource group. The name is case insensitive. + Required. + :type resource_group_name: str + :return: An iterator like instance of GraphQueryResource + :rtype: ~azure.core.paging.ItemPaged[~azure.mgmt.resourcegraph.models.GraphQueryResource] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = kwargs.pop("headers", {}) or {} + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[List[_models.GraphQueryResource]] = kwargs.pop("cls", None) + + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + def prepare_request(next_link=None): + if not next_link: + + _request = build_graph_query_list_request( + resource_group_name=resource_group_name, + subscription_id=self._config.subscription_id, + api_version=api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + else: + _request = HttpRequest("GET", next_link, headers=_headers) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + return _request + + def extract_data(pipeline_response): + deserialized = pipeline_response.http_response.json() + list_of_elem = _deserialize( + List[_models.GraphQueryResource], + deserialized.get("value", []), + ) + if cls: + list_of_elem = cls(list_of_elem) # type: ignore + return deserialized.get("nextLink") or None, iter(list_of_elem) + + def get_next(next_link=None): + _request = prepare_request(next_link) + + _stream = False + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + response = pipeline_response.http_response + + if response.status_code not in [200]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + return pipeline_response + + return ItemPaged(get_next, extract_data) + + @distributed_trace + def list_by_subscription(self, **kwargs: Any) -> ItemPaged["_models.GraphQueryResource"]: + """Get all graph queries defined within a specified subscription. + + :return: An iterator like instance of GraphQueryResource + :rtype: ~azure.core.paging.ItemPaged[~azure.mgmt.resourcegraph.models.GraphQueryResource] + :raises ~azure.core.exceptions.HttpResponseError: + """ + _headers = kwargs.pop("headers", {}) or {} + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + cls: ClsType[List[_models.GraphQueryResource]] = kwargs.pop("cls", None) + + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + def prepare_request(next_link=None): + if not next_link: + + _request = build_graph_query_list_by_subscription_request( + subscription_id=self._config.subscription_id, + api_version=api_version, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + else: + _request = HttpRequest("GET", next_link, headers=_headers) + path_format_arguments = { + "endpoint": self._serialize.url( + "self._config.base_url", self._config.base_url, "str", skip_quote=True + ), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + return _request + + def extract_data(pipeline_response): + deserialized = pipeline_response.http_response.json() + list_of_elem = _deserialize( + List[_models.GraphQueryResource], + deserialized.get("value", []), + ) + if cls: + list_of_elem = cls(list_of_elem) # type: ignore + return deserialized.get("nextLink") or None, iter(list_of_elem) + + def get_next(next_link=None): + _request = prepare_request(next_link) + + _stream = False + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + response = pipeline_response.http_response + + if response.status_code not in [200]: + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.GraphQueryError, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + return pipeline_response + + return ItemPaged(get_next, extract_data) + + +class _ResourceGraphClientOperationsMixin( + ClientMixinABC[PipelineClient[HttpRequest, HttpResponse], ResourceGraphClientConfiguration] +): + + @overload + def resource_changes( + self, + parameters: _models.ResourceChangesRequestParameters, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> _models.ResourceChangeList: + """List changes to a resource for a given time interval. + + :param parameters: The request body. Required. + :type parameters: ~azure.mgmt.resourcegraph.models.ResourceChangesRequestParameters + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: ResourceChangeList. The ResourceChangeList is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.ResourceChangeList + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def resource_changes( + self, parameters: JSON, *, content_type: str = "application/json", **kwargs: Any + ) -> _models.ResourceChangeList: + """List changes to a resource for a given time interval. + + :param parameters: The request body. Required. + :type parameters: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: ResourceChangeList. The ResourceChangeList is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.ResourceChangeList + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def resource_changes( + self, parameters: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> _models.ResourceChangeList: + """List changes to a resource for a given time interval. + + :param parameters: The request body. Required. + :type parameters: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: ResourceChangeList. The ResourceChangeList is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.ResourceChangeList + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + @api_version_validation( + method_added_on="2020-09-01-preview", + params_added_on={"2020-09-01-preview": ["api_version", "content_type", "accept"]}, + api_versions_list=["2020-09-01-preview"], + ) + def resource_changes( + self, parameters: Union[_models.ResourceChangesRequestParameters, JSON, IO[bytes]], **kwargs: Any + ) -> _models.ResourceChangeList: + """List changes to a resource for a given time interval. + + :param parameters: The request body. Is one of the following types: + ResourceChangesRequestParameters, JSON, IO[bytes] Required. + :type parameters: ~azure.mgmt.resourcegraph.models.ResourceChangesRequestParameters or JSON or + IO[bytes] + :return: ResourceChangeList. The ResourceChangeList is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.ResourceChangeList + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2020-09-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.ResourceChangeList] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(parameters, (IOBase, bytes)): + _content = parameters + else: + _content = json.dumps(parameters, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_resource_graph_resource_changes_request( + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.ResourceChangeList, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + def resource_change_details( + self, + parameters: _models.ResourceChangeDetailsRequestParameters, + *, + content_type: str = "application/json", + **kwargs: Any + ) -> List[_models.ResourceChangeData]: + """Get resource change details. + + :param parameters: The request body. Required. + :type parameters: ~azure.mgmt.resourcegraph.models.ResourceChangeDetailsRequestParameters + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: list of ResourceChangeData + :rtype: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def resource_change_details( + self, parameters: JSON, *, content_type: str = "application/json", **kwargs: Any + ) -> List[_models.ResourceChangeData]: + """Get resource change details. + + :param parameters: The request body. Required. + :type parameters: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: list of ResourceChangeData + :rtype: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def resource_change_details( + self, parameters: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> List[_models.ResourceChangeData]: + """Get resource change details. + + :param parameters: The request body. Required. + :type parameters: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: list of ResourceChangeData + :rtype: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + @api_version_validation( + method_added_on="2020-09-01-preview", + params_added_on={"2020-09-01-preview": ["api_version", "content_type", "accept"]}, + api_versions_list=["2020-09-01-preview"], + ) + def resource_change_details( + self, parameters: Union[_models.ResourceChangeDetailsRequestParameters, JSON, IO[bytes]], **kwargs: Any + ) -> List[_models.ResourceChangeData]: + """Get resource change details. + + :param parameters: The request body. Is one of the following types: + ResourceChangeDetailsRequestParameters, JSON, IO[bytes] Required. + :type parameters: ~azure.mgmt.resourcegraph.models.ResourceChangeDetailsRequestParameters or + JSON or IO[bytes] + :return: list of ResourceChangeData + :rtype: list[~azure.mgmt.resourcegraph.models.ResourceChangeData] + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2020-09-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[List[_models.ResourceChangeData]] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(parameters, (IOBase, bytes)): + _content = parameters + else: + _content = json.dumps(parameters, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_resource_graph_resource_change_details_request( + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(List[_models.ResourceChangeData], response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + def resources( + self, query: _models.QueryRequest, *, content_type: str = "application/json", **kwargs: Any + ) -> _models.QueryResponse: + """Queries the resources managed by Azure Resource Manager for scopes specified in the request. + + :param query: The request body. Required. + :type query: ~azure.mgmt.resourcegraph.models.QueryRequest + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: QueryResponse. The QueryResponse is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def resources(self, query: JSON, *, content_type: str = "application/json", **kwargs: Any) -> _models.QueryResponse: + """Queries the resources managed by Azure Resource Manager for scopes specified in the request. + + :param query: The request body. Required. + :type query: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: QueryResponse. The QueryResponse is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def resources( + self, query: IO[bytes], *, content_type: str = "application/json", **kwargs: Any + ) -> _models.QueryResponse: + """Queries the resources managed by Azure Resource Manager for scopes specified in the request. + + :param query: The request body. Required. + :type query: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: QueryResponse. The QueryResponse is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + @api_version_validation( + method_added_on="2024-04-01", + params_added_on={"2024-04-01": ["api_version", "content_type", "accept"]}, + api_versions_list=["2024-04-01"], + ) + def resources(self, query: Union[_models.QueryRequest, JSON, IO[bytes]], **kwargs: Any) -> _models.QueryResponse: + """Queries the resources managed by Azure Resource Manager for scopes specified in the request. + + :param query: The request body. Is one of the following types: QueryRequest, JSON, IO[bytes] + Required. + :type query: ~azure.mgmt.resourcegraph.models.QueryRequest or JSON or IO[bytes] + :return: QueryResponse. The QueryResponse is compatible with MutableMapping + :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2024-04-01")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[_models.QueryResponse] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(query, (IOBase, bytes)): + _content = query + else: + _content = json.dumps(query, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_resource_graph_resources_request( + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(_models.QueryResponse, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore + + @overload + def resources_history( + self, request: _models.ResourcesHistoryRequest, *, content_type: str = "application/json", **kwargs: Any + ) -> Any: + """List all snapshots of a resource for a given time interval. + + :param request: The request body. Required. + :type request: ~azure.mgmt.resourcegraph.models.ResourcesHistoryRequest + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: any + :rtype: any + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def resources_history(self, request: JSON, *, content_type: str = "application/json", **kwargs: Any) -> Any: + """List all snapshots of a resource for a given time interval. + + :param request: The request body. Required. + :type request: JSON + :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. + Default value is "application/json". + :paramtype content_type: str + :return: any + :rtype: any + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @overload + def resources_history(self, request: IO[bytes], *, content_type: str = "application/json", **kwargs: Any) -> Any: + """List all snapshots of a resource for a given time interval. + + :param request: The request body. Required. + :type request: IO[bytes] + :keyword content_type: Body Parameter content-type. Content type parameter for binary body. + Default value is "application/json". + :paramtype content_type: str + :return: any + :rtype: any + :raises ~azure.core.exceptions.HttpResponseError: + """ + + @distributed_trace + @api_version_validation( + method_added_on="2021-06-01-preview", + params_added_on={"2021-06-01-preview": ["api_version", "content_type", "accept"]}, + api_versions_list=["2021-06-01-preview"], + ) + def resources_history(self, request: Union[_models.ResourcesHistoryRequest, JSON, IO[bytes]], **kwargs: Any) -> Any: + """List all snapshots of a resource for a given time interval. + + :param request: The request body. Is one of the following types: ResourcesHistoryRequest, JSON, + IO[bytes] Required. + :type request: ~azure.mgmt.resourcegraph.models.ResourcesHistoryRequest or JSON or IO[bytes] + :return: any + :rtype: any + :raises ~azure.core.exceptions.HttpResponseError: + """ + error_map: MutableMapping = { + 401: ClientAuthenticationError, + 404: ResourceNotFoundError, + 409: ResourceExistsError, + 304: ResourceNotModifiedError, + } + error_map.update(kwargs.pop("error_map", {}) or {}) + + _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) + _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) + + api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-06-01-preview")) + content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) + cls: ClsType[Any] = kwargs.pop("cls", None) + + content_type = content_type or "application/json" + _content = None + if isinstance(request, (IOBase, bytes)): + _content = request + else: + _content = json.dumps(request, cls=SdkJSONEncoder, exclude_readonly=True) # type: ignore + + _request = build_resource_graph_resources_history_request( + api_version=api_version, + content_type=content_type, + content=_content, + headers=_headers, + params=_params, + ) + path_format_arguments = { + "endpoint": self._serialize.url("self._config.base_url", self._config.base_url, "str", skip_quote=True), + } + _request.url = self._client.format_url(_request.url, **path_format_arguments) + + _decompress = kwargs.pop("decompress", True) + _stream = kwargs.pop("stream", False) + pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access + _request, stream=_stream, **kwargs + ) + + response = pipeline_response.http_response + + if response.status_code not in [200]: + if _stream: + try: + response.read() # Load the body in memory and close the socket + except (StreamConsumedError, StreamClosedError): + pass + map_error(status_code=response.status_code, response=response, error_map=error_map) + error = _failsafe_deserialize( + _models.ErrorResponse, + response, + ) + raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) + + if _stream: + deserialized = response.iter_bytes() if _decompress else response.iter_raw() + else: + deserialized = _deserialize(Any, response.json()) + + if cls: + return cls(pipeline_response, deserialized, {}) # type: ignore + + return deserialized # type: ignore diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_patch.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_patch.py index f7dd32510333..ea765788358a 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_patch.py +++ b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_patch.py @@ -1,14 +1,14 @@ -# ------------------------------------ -# Copyright (c) Microsoft Corporation. -# Licensed under the MIT License. -# ------------------------------------ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# -------------------------------------------------------------------------- """Customize generated code here. Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize """ -from typing import List -__all__: List[str] = [] # Add all objects you want publicly available to users at this package level +__all__: list[str] = [] # Add all objects you want publicly available to users at this package level def patch_sdk(): diff --git a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_resource_graph_client_operations.py b/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_resource_graph_client_operations.py deleted file mode 100644 index 812d73829013..000000000000 --- a/sdk/resources/azure-mgmt-resourcegraph/azure/mgmt/resourcegraph/operations/_resource_graph_client_operations.py +++ /dev/null @@ -1,171 +0,0 @@ -# coding=utf-8 -# -------------------------------------------------------------------------- -# Copyright (c) Microsoft Corporation. All rights reserved. -# Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. -# Changes may cause incorrect behavior and will be lost if the code is regenerated. -# -------------------------------------------------------------------------- -from collections.abc import MutableMapping -from io import IOBase -from typing import Any, Callable, IO, Optional, TypeVar, Union, overload - -from azure.core import PipelineClient -from azure.core.exceptions import ( - ClientAuthenticationError, - HttpResponseError, - ResourceExistsError, - ResourceNotFoundError, - ResourceNotModifiedError, - map_error, -) -from azure.core.pipeline import PipelineResponse -from azure.core.rest import HttpRequest, HttpResponse -from azure.core.tracing.decorator import distributed_trace -from azure.core.utils import case_insensitive_dict -from azure.mgmt.core.exceptions import ARMErrorFormat - -from .. import models as _models -from .._configuration import ResourceGraphClientConfiguration -from .._utils.serialization import Serializer -from .._utils.utils import ClientMixinABC - -T = TypeVar("T") -ClsType = Optional[Callable[[PipelineResponse[HttpRequest, HttpResponse], T, dict[str, Any]], Any]] -List = list - -_SERIALIZER = Serializer() -_SERIALIZER.client_side_validation = False - - -def build_resources_request(**kwargs: Any) -> HttpRequest: - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2021-03-01")) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - accept = _headers.pop("Accept", "application/json") - - # Construct URL - _url = kwargs.pop("template_url", "/providers/Microsoft.ResourceGraph/resources") - - # Construct parameters - _params["api-version"] = _SERIALIZER.query("api_version", api_version, "str") - - # Construct headers - if content_type is not None: - _headers["Content-Type"] = _SERIALIZER.header("content_type", content_type, "str") - _headers["Accept"] = _SERIALIZER.header("accept", accept, "str") - - return HttpRequest(method="POST", url=_url, params=_params, headers=_headers, **kwargs) - - -class _ResourceGraphClientOperationsMixin( - ClientMixinABC[PipelineClient[HttpRequest, HttpResponse], ResourceGraphClientConfiguration] -): - - @overload - def resources( - self, query: _models.QueryRequest, *, content_type: str = "application/json", **kwargs: Any - ) -> _models.QueryResponse: - """Queries the resources managed by Azure Resource Manager for scopes specified in the request. - - .. seealso:: - - https://aka.ms/resource-graph/learntoquery - - :param query: Request specifying query and its options. Required. - :type query: ~azure.mgmt.resourcegraph.models.QueryRequest - :keyword content_type: Body Parameter content-type. Content type parameter for JSON body. - Default value is "application/json". - :paramtype content_type: str - :return: QueryResponse or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @overload - def resources( - self, query: IO[bytes], *, content_type: str = "application/json", **kwargs: Any - ) -> _models.QueryResponse: - """Queries the resources managed by Azure Resource Manager for scopes specified in the request. - - .. seealso:: - - https://aka.ms/resource-graph/learntoquery - - :param query: Request specifying query and its options. Required. - :type query: IO[bytes] - :keyword content_type: Body Parameter content-type. Content type parameter for binary body. - Default value is "application/json". - :paramtype content_type: str - :return: QueryResponse or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse - :raises ~azure.core.exceptions.HttpResponseError: - """ - - @distributed_trace - def resources(self, query: Union[_models.QueryRequest, IO[bytes]], **kwargs: Any) -> _models.QueryResponse: - """Queries the resources managed by Azure Resource Manager for scopes specified in the request. - - .. seealso:: - - https://aka.ms/resource-graph/learntoquery - - :param query: Request specifying query and its options. Is either a QueryRequest type or a - IO[bytes] type. Required. - :type query: ~azure.mgmt.resourcegraph.models.QueryRequest or IO[bytes] - :return: QueryResponse or the result of cls(response) - :rtype: ~azure.mgmt.resourcegraph.models.QueryResponse - :raises ~azure.core.exceptions.HttpResponseError: - """ - error_map: MutableMapping = { - 401: ClientAuthenticationError, - 404: ResourceNotFoundError, - 409: ResourceExistsError, - 304: ResourceNotModifiedError, - } - error_map.update(kwargs.pop("error_map", {}) or {}) - - _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {}) - _params = case_insensitive_dict(kwargs.pop("params", {}) or {}) - - api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._config.api_version)) - content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None)) - cls: ClsType[_models.QueryResponse] = kwargs.pop("cls", None) - - content_type = content_type or "application/json" - _json = None - _content = None - if isinstance(query, (IOBase, bytes)): - _content = query - else: - _json = self._serialize.body(query, "QueryRequest") - - _request = build_resources_request( - api_version=api_version, - content_type=content_type, - json=_json, - content=_content, - headers=_headers, - params=_params, - ) - _request.url = self._client.format_url(_request.url) - - _stream = False - pipeline_response: PipelineResponse = self._client._pipeline.run( # pylint: disable=protected-access - _request, stream=_stream, **kwargs - ) - - response = pipeline_response.http_response - - if response.status_code not in [200]: - map_error(status_code=response.status_code, response=response, error_map=error_map) - error = self._deserialize.failsafe_deserialize( - _models.ErrorResponse, - pipeline_response, - ) - raise HttpResponseError(response=response, model=error, error_format=ARMErrorFormat) - - deserialized = self._deserialize("QueryResponse", pipeline_response.http_response) - - if cls: - return cls(pipeline_response, deserialized, {}) # type: ignore - - return deserialized # type: ignore diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_add.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_add.py index 290436ccd2b9..cd234d060d82 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_add.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_add.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,10 +27,10 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.graph_query.create_or_update( - subscription_id="024e2271-06fa-46b6-9079-f1ed3c7b070e", resource_group_name="my-resource-group", resource_name="MyDockerVMs", properties={ @@ -45,6 +44,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/GraphQueryAdd.json +# x-ms-original-file: 2024-04-01/GraphQueryAdd.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_delete.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_delete.py index 9b6f41edab1f..44e5efe3c1cd 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_delete.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_delete.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,15 +27,15 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) client.graph_query.delete( - subscription_id="024e2271-06fa-46b6-9079-f1ed3c7b070e", resource_group_name="my-resource-group", resource_name="MyDockerVM", ) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/GraphQueryDelete.json +# x-ms-original-file: 2024-04-01/GraphQueryDelete.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_get.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_get.py index 8e5e26a135b2..5943f7d7928a 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_get.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_get.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,16 +27,16 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.graph_query.get( - subscription_id="024e2271-06fa-46b6-9079-f1ed3c7b070e", resource_group_name="my-resource-group", resource_name="MyDockerVMs", ) print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/GraphQueryGet.json +# x-ms-original-file: 2024-04-01/GraphQueryGet.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_list.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_list.py index 5a672fdf53df..8182388055fd 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_list.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_list.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,15 +27,14 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) - response = client.graph_query.list_by_subscription( - subscription_id="024e2271-06fa-46b6-9079-f1ed3c7b070e", - ) + response = client.graph_query.list_by_subscription() for item in response: print(item) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/GraphQueryList.json +# x-ms-original-file: 2024-04-01/GraphQueryList.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_list1.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_list1.py new file mode 100644 index 000000000000..1d813455807b --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_list1.py @@ -0,0 +1,42 @@ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- + +from azure.identity import DefaultAzureCredential + +from azure.mgmt.resourcegraph import ResourceGraphClient + +""" +# PREREQUISITES + pip install azure-identity + pip install azure-mgmt-resourcegraph +# USAGE + python graph_query_list1.py + + Before run the sample, please set the values of the client ID, tenant ID and client secret + of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, + AZURE_CLIENT_SECRET. For more info about how to get the value, please see: + https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal +""" + + +def main(): + client = ResourceGraphClient( + credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", + ) + + response = client.graph_query.list( + resource_group_name="my-resource-group", + ) + for item in response: + print(item) + + +# x-ms-original-file: 2024-04-01/GraphQueryList1.json +if __name__ == "__main__": + main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_update.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_update.py index 5878b9b17353..97c824e4d311 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_update.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/graph_query_update.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,10 +27,10 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.graph_query.update( - subscription_id="024e2271-06fa-46b6-9079-f1ed3c7b070e", resource_group_name="my-resource-group", resource_name="MyDockerVMs", body={ @@ -46,6 +45,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/GraphQueryUpdate.json +# x-ms-original-file: 2024-04-01/GraphQueryUpdate.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/operations_list.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/operations_list.py index 1621c9823fd6..4d2cf6ea6b44 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/operations_list.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/operations_list.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +27,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.operations.list() @@ -35,6 +35,6 @@ def main(): print(item) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/OperationsList.json +# x-ms-original-file: 2024-04-01/OperationsList.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_change_details.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_change_details.py new file mode 100644 index 000000000000..64a80adf72cb --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_change_details.py @@ -0,0 +1,47 @@ +# pylint: disable=line-too-long,useless-suppression +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- + +from azure.identity import DefaultAzureCredential + +from azure.mgmt.resourcegraph import ResourceGraphClient + +""" +# PREREQUISITES + pip install azure-identity + pip install azure-mgmt-resourcegraph +# USAGE + python resource_change_details.py + + Before run the sample, please set the values of the client ID, tenant ID and client secret + of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, + AZURE_CLIENT_SECRET. For more info about how to get the value, please see: + https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal +""" + + +def main(): + client = ResourceGraphClient( + credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", + ) + + response = client.resource_change_details( + parameters={ + "changeIds": ["53dc0515-b86b-4bc2-979b-e4694ab4a556"], + "resourceIds": [ + "/subscriptions/4d962866-1e3f-47f2-bd18-450c08f914c1/resourceGroups/MyResourceGroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount" + ], + }, + ) + print(response) + + +# x-ms-original-file: 2020-09-01-preview/ResourceChangeDetails.json +if __name__ == "__main__": + main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes.py new file mode 100644 index 000000000000..4e85760b37e4 --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes.py @@ -0,0 +1,47 @@ +# pylint: disable=line-too-long,useless-suppression +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- + +from azure.identity import DefaultAzureCredential + +from azure.mgmt.resourcegraph import ResourceGraphClient + +""" +# PREREQUISITES + pip install azure-identity + pip install azure-mgmt-resourcegraph +# USAGE + python resource_changes.py + + Before run the sample, please set the values of the client ID, tenant ID and client secret + of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, + AZURE_CLIENT_SECRET. For more info about how to get the value, please see: + https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal +""" + + +def main(): + client = ResourceGraphClient( + credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", + ) + + response = client.resource_changes( + parameters={ + "interval": {"end": "2018-10-31T12:09:03.141Z", "start": "2018-10-30T12:09:03.141Z"}, + "resourceIds": [ + "/subscriptions/4d962866-1e3f-47f2-bd18-450c08f914c1/resourceGroups/MyResourceGroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount" + ], + }, + ) + print(response) + + +# x-ms-original-file: 2020-09-01-preview/ResourceChanges.json +if __name__ == "__main__": + main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes_first_page.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes_first_page.py new file mode 100644 index 000000000000..61de2fa5ff45 --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes_first_page.py @@ -0,0 +1,48 @@ +# pylint: disable=line-too-long,useless-suppression +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- + +from azure.identity import DefaultAzureCredential + +from azure.mgmt.resourcegraph import ResourceGraphClient + +""" +# PREREQUISITES + pip install azure-identity + pip install azure-mgmt-resourcegraph +# USAGE + python resource_changes_first_page.py + + Before run the sample, please set the values of the client ID, tenant ID and client secret + of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, + AZURE_CLIENT_SECRET. For more info about how to get the value, please see: + https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal +""" + + +def main(): + client = ResourceGraphClient( + credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", + ) + + response = client.resource_changes( + parameters={ + "$top": 2, + "interval": {"end": "2018-10-31T12:09:03.141Z", "start": "2018-10-30T12:09:03.141Z"}, + "resourceIds": [ + "/subscriptions/4d962866-1e3f-47f2-bd18-450c08f914c1/resourceGroups/MyResourceGroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount" + ], + }, + ) + print(response) + + +# x-ms-original-file: 2020-09-01-preview/ResourceChangesFirstPage.json +if __name__ == "__main__": + main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes_next_page.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes_next_page.py new file mode 100644 index 000000000000..dfe4595ec5e4 --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resource_changes_next_page.py @@ -0,0 +1,49 @@ +# pylint: disable=line-too-long,useless-suppression +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- + +from azure.identity import DefaultAzureCredential + +from azure.mgmt.resourcegraph import ResourceGraphClient + +""" +# PREREQUISITES + pip install azure-identity + pip install azure-mgmt-resourcegraph +# USAGE + python resource_changes_next_page.py + + Before run the sample, please set the values of the client ID, tenant ID and client secret + of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, + AZURE_CLIENT_SECRET. For more info about how to get the value, please see: + https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal +""" + + +def main(): + client = ResourceGraphClient( + credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", + ) + + response = client.resource_changes( + parameters={ + "$skipToken": "ew0KICAiJGlkIjogIjEiLA0KICAiRW5kVGltZSI6ICJcL0RhdGUoMTU1MDc0NT", + "$top": 2, + "interval": {"end": "2018-10-31T12:09:03.141Z", "start": "2018-10-30T12:09:03.141Z"}, + "resourceIds": [ + "/subscriptions/4d962866-1e3f-47f2-bd18-450c08f914c1/resourceGroups/MyResourceGroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount" + ], + }, + ) + print(response) + + +# x-ms-original-file: 2020-09-01-preview/ResourceChangesNextPage.json +if __name__ == "__main__": + main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_basic_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_basic_query.py index b6819c6b0ea3..07d79db0565b 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_basic_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_basic_query.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +27,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -39,6 +39,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesBasicQuery.json +# x-ms-original-file: 2024-04-01/ResourcesBasicQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_complex_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_complex_query.py index eafd49384b04..494e7a771f8d 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_complex_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_complex_query.py @@ -3,7 +3,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +28,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -39,6 +40,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesComplexQuery.json +# x-ms-original-file: 2024-04-01/ResourcesComplexQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_facet_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_facet_query.py index 21387f47cf4d..214d960bf2dc 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_facet_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_facet_query.py @@ -3,7 +3,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +28,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -49,6 +50,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesFacetQuery.json +# x-ms-original-file: 2024-04-01/ResourcesFacetQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_filter_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_filter_query.py index 93d8144934c9..f1a53774a671 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_filter_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_filter_query.py @@ -3,7 +3,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +28,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -39,6 +40,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesFilterQuery.json +# x-ms-original-file: 2024-04-01/ResourcesFilterQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_first_page_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_first_page_query.py index 3a0998b7890e..ff50ed179883 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_first_page_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_first_page_query.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +27,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -40,6 +40,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesFirstPageQuery.json +# x-ms-original-file: 2024-04-01/ResourcesFirstPageQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_history_get.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_history_get.py new file mode 100644 index 000000000000..99a6e214496e --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_history_get.py @@ -0,0 +1,45 @@ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- + +from azure.identity import DefaultAzureCredential + +from azure.mgmt.resourcegraph import ResourceGraphClient + +""" +# PREREQUISITES + pip install azure-identity + pip install azure-mgmt-resourcegraph +# USAGE + python resources_history_get.py + + Before run the sample, please set the values of the client ID, tenant ID and client secret + of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, + AZURE_CLIENT_SECRET. For more info about how to get the value, please see: + https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal +""" + + +def main(): + client = ResourceGraphClient( + credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", + ) + + response = client.resources_history( + request={ + "options": {"interval": {"end": "2020-11-12T01:25:00.0000000Z", "start": "2020-11-12T01:00:00.0000000Z"}}, + "query": "where name =~ 'cpu-utilization' | project id, name, properties", + "subscriptions": ["a7f33fdb-e646-4f15-89aa-3a360210861e"], + }, + ) + print(response) + + +# x-ms-original-file: 2021-06-01-preview/ResourcesHistoryGet.json +if __name__ == "__main__": + main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_history_mgs_get.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_history_mgs_get.py new file mode 100644 index 000000000000..2bd9d036e40c --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_history_mgs_get.py @@ -0,0 +1,45 @@ +# coding=utf-8 +# -------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the MIT License. See License.txt in the project root for license information. +# Code generated by Microsoft (R) Python Code Generator. +# Changes may cause incorrect behavior and will be lost if the code is regenerated. +# -------------------------------------------------------------------------- + +from azure.identity import DefaultAzureCredential + +from azure.mgmt.resourcegraph import ResourceGraphClient + +""" +# PREREQUISITES + pip install azure-identity + pip install azure-mgmt-resourcegraph +# USAGE + python resources_history_mgs_get.py + + Before run the sample, please set the values of the client ID, tenant ID and client secret + of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, + AZURE_CLIENT_SECRET. For more info about how to get the value, please see: + https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal +""" + + +def main(): + client = ResourceGraphClient( + credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", + ) + + response = client.resources_history( + request={ + "managementGroups": ["e927f598-c1d4-4f72-8541-95d83a6a4ac8", "ProductionMG"], + "options": {"interval": {"end": "2020-11-12T01:25:00.0000000Z", "start": "2020-11-12T01:00:00.0000000Z"}}, + "query": "where name =~ 'cpu-utilization' | project id, name, properties", + }, + ) + print(response) + + +# x-ms-original-file: 2021-06-01-preview/ResourcesHistoryMgsGet.json +if __name__ == "__main__": + main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_mg_basic_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_mg_basic_query.py index abb78756547c..2a0e32b3d153 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_mg_basic_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_mg_basic_query.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +27,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -39,6 +39,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesMgBasicQuery.json +# x-ms-original-file: 2024-04-01/ResourcesMgBasicQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_next_page_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_next_page_query.py index 915815c993c0..74eb944fd88d 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_next_page_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_next_page_query.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +27,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -40,6 +40,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesNextPageQuery.json +# x-ms-original-file: 2024-04-01/ResourcesNextPageQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_properties_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_properties_query.py index 9ceb5f457db4..b5607e2b9937 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_properties_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_properties_query.py @@ -3,7 +3,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +28,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -39,6 +40,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesPropertiesQuery.json +# x-ms-original-file: 2024-04-01/ResourcesPropertiesQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_random_page_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_random_page_query.py index fa89849d2ea1..b2b0c1f92389 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_random_page_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_random_page_query.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +27,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -40,6 +40,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesRandomPageQuery.json +# x-ms-original-file: 2024-04-01/ResourcesRandomPageQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_summarize_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_summarize_query.py index 70671769359d..12b68c5de95d 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_summarize_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_summarize_query.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +27,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -39,6 +39,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesSummarizeQuery.json +# x-ms-original-file: 2024-04-01/ResourcesSummarizeQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_tenant_basic_query.py b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_tenant_basic_query.py index dc1341d3606d..95b65e2f4251 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_tenant_basic_query.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_samples/resources_tenant_basic_query.py @@ -1,9 +1,8 @@ -# pylint: disable=line-too-long,useless-suppression # coding=utf-8 # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- @@ -28,6 +27,7 @@ def main(): client = ResourceGraphClient( credential=DefaultAzureCredential(), + subscription_id="SUBSCRIPTION_ID", ) response = client.resources( @@ -36,6 +36,6 @@ def main(): print(response) -# x-ms-original-file: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/stable/2021-03-01/examples/ResourcesTenantBasicQuery.json +# x-ms-original-file: 2024-04-01/ResourcesTenantBasicQuery.json if __name__ == "__main__": main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/conftest.py b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/conftest.py index 146c04458ffc..69ffbc8d9311 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/conftest.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/conftest.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- import os diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph.py b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph.py index 378fe77f1ef1..00f2f9994b2a 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- import pytest @@ -18,6 +18,37 @@ class TestResourceGraph(AzureMgmtRecordedTestCase): def setup_method(self, method): self.client = self.create_mgmt_client(ResourceGraphClient) + @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) + @recorded_by_proxy + def test_resource_changes(self, resource_group): + response = self.client.resource_changes( + parameters={ + "interval": {"end": "2020-02-20 00:00:00", "start": "2020-02-20 00:00:00"}, + "$skipToken": "str", + "$top": 0, + "fetchPropertyChanges": bool, + "fetchSnapshots": bool, + "resourceIds": ["str"], + "subscriptionId": "str", + "table": "str", + }, + api_version="2020-09-01-preview", + ) + + # please add some check logic here by yourself + # ... + + @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) + @recorded_by_proxy + def test_resource_change_details(self, resource_group): + response = self.client.resource_change_details( + parameters={"changeIds": ["str"], "resourceIds": ["str"]}, + api_version="2020-09-01-preview", + ) + + # please add some check logic here by yourself + # ... + @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy def test_resources(self, resource_group): @@ -25,19 +56,42 @@ def test_resources(self, resource_group): query={ "query": "str", "facets": [ - {"expression": "str", "options": {"$top": 0, "filter": "str", "sortBy": "str", "sortOrder": "desc"}} + {"expression": "str", "options": {"$top": 0, "filter": "str", "sortBy": "str", "sortOrder": "str"}} ], "managementGroups": ["str"], "options": { "$skip": 0, "$skipToken": "str", "$top": 0, - "allowPartialScopes": False, - "resultFormat": "objectArray", + "allowPartialScopes": bool, + "authorizationScopeFilter": "str", + "resultFormat": "str", }, "subscriptions": ["str"], }, - api_version="2021-03-01", + api_version="2024-04-01", + ) + + # please add some check logic here by yourself + # ... + + @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) + @recorded_by_proxy + def test_resources_history(self, resource_group): + response = self.client.resources_history( + request={ + "managementGroups": ["str"], + "options": { + "$skip": 0, + "$skipToken": "str", + "$top": 0, + "interval": {"end": "2020-02-20 00:00:00", "start": "2020-02-20 00:00:00"}, + "resultFormat": "str", + }, + "query": "str", + "subscriptions": ["str"], + }, + api_version="2021-06-01-preview", ) # please add some check logic here by yourself diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_async.py b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_async.py index ccadd81539f4..deeda4e89577 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_async.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_async.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- import pytest @@ -19,6 +19,37 @@ class TestResourceGraphAsync(AzureMgmtRecordedTestCase): def setup_method(self, method): self.client = self.create_mgmt_client(ResourceGraphClient, is_async=True) + @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) + @recorded_by_proxy_async + async def test_resource_changes(self, resource_group): + response = await self.client.resource_changes( + parameters={ + "interval": {"end": "2020-02-20 00:00:00", "start": "2020-02-20 00:00:00"}, + "$skipToken": "str", + "$top": 0, + "fetchPropertyChanges": bool, + "fetchSnapshots": bool, + "resourceIds": ["str"], + "subscriptionId": "str", + "table": "str", + }, + api_version="2020-09-01-preview", + ) + + # please add some check logic here by yourself + # ... + + @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) + @recorded_by_proxy_async + async def test_resource_change_details(self, resource_group): + response = await self.client.resource_change_details( + parameters={"changeIds": ["str"], "resourceIds": ["str"]}, + api_version="2020-09-01-preview", + ) + + # please add some check logic here by yourself + # ... + @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy_async async def test_resources(self, resource_group): @@ -26,19 +57,42 @@ async def test_resources(self, resource_group): query={ "query": "str", "facets": [ - {"expression": "str", "options": {"$top": 0, "filter": "str", "sortBy": "str", "sortOrder": "desc"}} + {"expression": "str", "options": {"$top": 0, "filter": "str", "sortBy": "str", "sortOrder": "str"}} ], "managementGroups": ["str"], "options": { "$skip": 0, "$skipToken": "str", "$top": 0, - "allowPartialScopes": False, - "resultFormat": "objectArray", + "allowPartialScopes": bool, + "authorizationScopeFilter": "str", + "resultFormat": "str", }, "subscriptions": ["str"], }, - api_version="2021-03-01", + api_version="2024-04-01", + ) + + # please add some check logic here by yourself + # ... + + @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) + @recorded_by_proxy_async + async def test_resources_history(self, resource_group): + response = await self.client.resources_history( + request={ + "managementGroups": ["str"], + "options": { + "$skip": 0, + "$skipToken": "str", + "$top": 0, + "interval": {"end": "2020-02-20 00:00:00", "start": "2020-02-20 00:00:00"}, + "resultFormat": "str", + }, + "query": "str", + "subscriptions": ["str"], + }, + api_version="2021-06-01-preview", ) # please add some check logic here by yourself diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_graph_query_operations.py b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_graph_query_operations.py index 10d75f974208..af7bcc1736b4 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_graph_query_operations.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_graph_query_operations.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- import pytest @@ -20,35 +20,58 @@ def setup_method(self, method): @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy - def test_graph_query_list_by_subscription(self, resource_group): - response = self.client.graph_query.list_by_subscription( - subscription_id="str", - api_version="2021-03-01", + def test_graph_query_get(self, resource_group): + response = self.client.graph_query.get( + resource_group_name=resource_group.name, + resource_name="str", + api_version="2024-04-01", ) - result = [r for r in response] + # please add some check logic here by yourself # ... @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy - def test_graph_query_list(self, resource_group): - response = self.client.graph_query.list( - subscription_id="str", + def test_graph_query_create_or_update(self, resource_group): + response = self.client.graph_query.create_or_update( resource_group_name=resource_group.name, - api_version="2021-03-01", + resource_name="str", + properties={ + "etag": "str", + "id": "str", + "location": "str", + "name": "str", + "properties": { + "query": "str", + "description": "str", + "resultKind": "str", + "timeModified": "2020-02-20 00:00:00", + }, + "systemData": { + "createdAt": "2020-02-20 00:00:00", + "createdBy": "str", + "createdByType": "str", + "lastModifiedAt": "2020-02-20 00:00:00", + "lastModifiedBy": "str", + "lastModifiedByType": "str", + }, + "tags": {"str": "str"}, + "type": "str", + }, + api_version="2024-04-01", ) - result = [r for r in response] + # please add some check logic here by yourself # ... @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy - def test_graph_query_get(self, resource_group): - response = self.client.graph_query.get( - subscription_id="str", + def test_graph_query_update(self, resource_group): + response = self.client.graph_query.update( resource_group_name=resource_group.name, resource_name="str", - api_version="2021-03-01", + body={"etag": "str", "properties": {"description": "str", "query": "str"}, "tags": {"str": "str"}}, + api_version="2024-04-01", ) # please add some check logic here by yourself @@ -58,10 +81,9 @@ def test_graph_query_get(self, resource_group): @recorded_by_proxy def test_graph_query_delete(self, resource_group): response = self.client.graph_query.delete( - subscription_id="str", resource_group_name=resource_group.name, resource_name="str", - api_version="2021-03-01", + api_version="2024-04-01", ) # please add some check logic here by yourself @@ -69,39 +91,21 @@ def test_graph_query_delete(self, resource_group): @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy - def test_graph_query_create_or_update(self, resource_group): - response = self.client.graph_query.create_or_update( - subscription_id="str", + def test_graph_query_list(self, resource_group): + response = self.client.graph_query.list( resource_group_name=resource_group.name, - resource_name="str", - properties={ - "description": "str", - "etag": "str", - "id": "str", - "location": "str", - "name": "str", - "query": "str", - "resultKind": "str", - "tags": {"str": "str"}, - "timeModified": "2020-02-20 00:00:00", - "type": "str", - }, - api_version="2021-03-01", + api_version="2024-04-01", ) - + result = [r for r in response] # please add some check logic here by yourself # ... @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy - def test_graph_query_update(self, resource_group): - response = self.client.graph_query.update( - subscription_id="str", - resource_group_name=resource_group.name, - resource_name="str", - body={"description": "str", "etag": "str", "query": "str", "tags": {"str": "str"}}, - api_version="2021-03-01", + def test_graph_query_list_by_subscription(self, resource_group): + response = self.client.graph_query.list_by_subscription( + api_version="2024-04-01", ) - + result = [r for r in response] # please add some check logic here by yourself # ... diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_graph_query_operations_async.py b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_graph_query_operations_async.py index bb2b9d30cd68..82e584f90cd9 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_graph_query_operations_async.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_graph_query_operations_async.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- import pytest @@ -21,35 +21,58 @@ def setup_method(self, method): @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy_async - async def test_graph_query_list_by_subscription(self, resource_group): - response = self.client.graph_query.list_by_subscription( - subscription_id="str", - api_version="2021-03-01", + async def test_graph_query_get(self, resource_group): + response = await self.client.graph_query.get( + resource_group_name=resource_group.name, + resource_name="str", + api_version="2024-04-01", ) - result = [r async for r in response] + # please add some check logic here by yourself # ... @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy_async - async def test_graph_query_list(self, resource_group): - response = self.client.graph_query.list( - subscription_id="str", + async def test_graph_query_create_or_update(self, resource_group): + response = await self.client.graph_query.create_or_update( resource_group_name=resource_group.name, - api_version="2021-03-01", + resource_name="str", + properties={ + "etag": "str", + "id": "str", + "location": "str", + "name": "str", + "properties": { + "query": "str", + "description": "str", + "resultKind": "str", + "timeModified": "2020-02-20 00:00:00", + }, + "systemData": { + "createdAt": "2020-02-20 00:00:00", + "createdBy": "str", + "createdByType": "str", + "lastModifiedAt": "2020-02-20 00:00:00", + "lastModifiedBy": "str", + "lastModifiedByType": "str", + }, + "tags": {"str": "str"}, + "type": "str", + }, + api_version="2024-04-01", ) - result = [r async for r in response] + # please add some check logic here by yourself # ... @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy_async - async def test_graph_query_get(self, resource_group): - response = await self.client.graph_query.get( - subscription_id="str", + async def test_graph_query_update(self, resource_group): + response = await self.client.graph_query.update( resource_group_name=resource_group.name, resource_name="str", - api_version="2021-03-01", + body={"etag": "str", "properties": {"description": "str", "query": "str"}, "tags": {"str": "str"}}, + api_version="2024-04-01", ) # please add some check logic here by yourself @@ -59,10 +82,9 @@ async def test_graph_query_get(self, resource_group): @recorded_by_proxy_async async def test_graph_query_delete(self, resource_group): response = await self.client.graph_query.delete( - subscription_id="str", resource_group_name=resource_group.name, resource_name="str", - api_version="2021-03-01", + api_version="2024-04-01", ) # please add some check logic here by yourself @@ -70,39 +92,21 @@ async def test_graph_query_delete(self, resource_group): @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy_async - async def test_graph_query_create_or_update(self, resource_group): - response = await self.client.graph_query.create_or_update( - subscription_id="str", + async def test_graph_query_list(self, resource_group): + response = self.client.graph_query.list( resource_group_name=resource_group.name, - resource_name="str", - properties={ - "description": "str", - "etag": "str", - "id": "str", - "location": "str", - "name": "str", - "query": "str", - "resultKind": "str", - "tags": {"str": "str"}, - "timeModified": "2020-02-20 00:00:00", - "type": "str", - }, - api_version="2021-03-01", + api_version="2024-04-01", ) - + result = [r async for r in response] # please add some check logic here by yourself # ... @RandomNameResourceGroupPreparer(location=AZURE_LOCATION) @recorded_by_proxy_async - async def test_graph_query_update(self, resource_group): - response = await self.client.graph_query.update( - subscription_id="str", - resource_group_name=resource_group.name, - resource_name="str", - body={"description": "str", "etag": "str", "query": "str", "tags": {"str": "str"}}, - api_version="2021-03-01", + async def test_graph_query_list_by_subscription(self, resource_group): + response = self.client.graph_query.list_by_subscription( + api_version="2024-04-01", ) - + result = [r async for r in response] # please add some check logic here by yourself # ... diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_operations.py b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_operations.py index cdb854a41f4f..ada9267da09a 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_operations.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_operations.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- import pytest @@ -22,7 +22,7 @@ def setup_method(self, method): @recorded_by_proxy def test_operations_list(self, resource_group): response = self.client.operations.list( - api_version="2021-03-01", + api_version="2024-04-01", ) result = [r for r in response] # please add some check logic here by yourself diff --git a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_operations_async.py b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_operations_async.py index 327a136f6286..fc6f59b2a555 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_operations_async.py +++ b/sdk/resources/azure-mgmt-resourcegraph/generated_tests/test_resource_graph_operations_async.py @@ -2,7 +2,7 @@ # -------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for license information. -# Code generated by Microsoft (R) AutoRest Code Generator. +# Code generated by Microsoft (R) Python Code Generator. # Changes may cause incorrect behavior and will be lost if the code is regenerated. # -------------------------------------------------------------------------- import pytest @@ -23,7 +23,7 @@ def setup_method(self, method): @recorded_by_proxy_async async def test_operations_list(self, resource_group): response = self.client.operations.list( - api_version="2021-03-01", + api_version="2024-04-01", ) result = [r async for r in response] # please add some check logic here by yourself diff --git a/sdk/resources/azure-mgmt-resourcegraph/pyproject.toml b/sdk/resources/azure-mgmt-resourcegraph/pyproject.toml index 10b1dee0e847..6a556afd5118 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/pyproject.toml +++ b/sdk/resources/azure-mgmt-resourcegraph/pyproject.toml @@ -13,23 +13,22 @@ authors = [ description = "Microsoft Azure Resourcegraph Management Client Library for Python" license = "MIT" classifiers = [ - "Development Status :: 5 - Production/Stable", + "Development Status :: 4 - Beta", "Programming Language :: Python", "Programming Language :: Python :: 3 :: Only", "Programming Language :: Python :: 3", - "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12", "Programming Language :: Python :: 3.13", ] -requires-python = ">=3.9" +requires-python = ">=3.10" keywords = [ "azure", "azure sdk", ] dependencies = [ - "msrest>=0.7.1", + "isodate>=0.6.1", "azure-mgmt-core>=1.6.0", "typing-extensions>=4.6.0", ] @@ -78,7 +77,7 @@ verifytypes = false package_name = "azure-mgmt-resourcegraph" package_pprint_name = "Resource Graph" package_doc_id = "resource-graph" -is_stable = true +is_stable = false is_arm = true sample_link = "" title = "ResourceGraphClient" diff --git a/sdk/resources/azure-mgmt-resourcegraph/tests/test_mgmt_resourcegraph.py b/sdk/resources/azure-mgmt-resourcegraph/tests/test_mgmt_resourcegraph.py index 9118355fbe54..70fac355a686 100644 --- a/sdk/resources/azure-mgmt-resourcegraph/tests/test_mgmt_resourcegraph.py +++ b/sdk/resources/azure-mgmt-resourcegraph/tests/test_mgmt_resourcegraph.py @@ -1,10 +1,11 @@ +# pylint: disable=line-too-long,useless-suppression # coding: utf-8 -#------------------------------------------------------------------------- +# ------------------------------------------------------------------------- # Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. See License.txt in the project root for # license information. -#-------------------------------------------------------------------------- +# -------------------------------------------------------------------------- import pytest import unittest @@ -12,19 +13,17 @@ from azure.mgmt.resourcegraph.models import * from devtools_testutils import AzureMgmtRecordedTestCase + @pytest.mark.skip("The test doesn't work.") class TestMgmtResourceGraph(AzureMgmtRecordedTestCase): def setUp(self): super(TestMgmtResourceGraph, self).setUp() - self.resourcegraph_client = self.create_basic_client( - ResourceGraphClient - ) + self.resourcegraph_client = self.create_basic_client(ResourceGraphClient) def test_resources_basic_query(self): query = QueryRequest( - query='project id, tags, properties | limit 2', - subscriptions=[self.settings.SUBSCRIPTION_ID] + query="project id, tags, properties | limit 2", subscriptions=[self.settings.SUBSCRIPTION_ID] ) query_response = self.resourcegraph_client.resources(query) @@ -39,8 +38,8 @@ def test_resources_basic_query(self): self.assertEqual(len(query_response.facets), 0) # Data columns - self.assertIsNotNone(query_response.data['columns']) - self.assertEqual(len(query_response.data['columns']), 3) + self.assertIsNotNone(query_response.data["columns"]) + self.assertEqual(len(query_response.data["columns"]), 3) self.assertIsNotNone(query_response.data["columns"][0]["name"]) self.assertIsNotNone(query_response.data["columns"][1]["name"]) self.assertIsNotNone(query_response.data["columns"][2]["name"]) @@ -58,11 +57,9 @@ def test_resources_basic_query(self): def test_resources_basic_query_object_array(self): query = QueryRequest( - query='project id, tags, properties | limit 2', + query="project id, tags, properties | limit 2", subscriptions=[self.settings.SUBSCRIPTION_ID], - options=QueryRequestOptions( - result_format=ResultFormat.object_array - ) + options=QueryRequestOptions(result_format=ResultFormat.object_array), ) query_response = self.resourcegraph_client.resources(query) @@ -80,21 +77,21 @@ def test_resources_basic_query_object_array(self): self.assertIsNotNone(query_response.data) self.assertEqual(len(query_response.data), 2) self.assertEqual(len(query_response.data[0]), 3) - self.assertIsInstance(query_response.data[0]['id'], str) - if query_response.data[0]['tags']: - self.assertIsInstance(query_response.data[0]['tags'], dict) - self.assertIsInstance(query_response.data[0]['properties'], dict) + self.assertIsInstance(query_response.data[0]["id"], str) + if query_response.data[0]["tags"]: + self.assertIsInstance(query_response.data[0]["tags"], dict) + self.assertIsInstance(query_response.data[0]["properties"], dict) def test_resources_query_options(self): raise unittest.SkipTest("Skipping resources_query_options") query = QueryRequest( - query='project id', + query="project id", subscriptions=[self.settings.SUBSCRIPTION_ID], options=QueryRequestOptions( - skip_token='82aw3vQlArEastJ24LABY8oPgQLesIyAyzYs2g6/aOOOmJHSYFj39fODurJV5e2tTFFebWcfxn7n5edicA8u6HgSJe1GCEk5HjxwLkeJiye2LVZDC7TaValkJbsk9JqY4yv5c7iRiLqgO34RbHEeVfLJpa56u4RZu0K+GpQvnBRPyAhy3KbwhZWpU5Nnqnud2whGb5WKdlL8xF7wnQaUnUN2lns8WwqwM4rc0VK4BbQt/WfWWcYJivSAyB3m4Z5g73df1KiU4C+K8auvUMpLPYVxxnKC/YZz42YslVAWXXUmuGOaM2SfLHRO6o4O9DgXlUgYjeFWqIbAkmMiVEqU', + skip_token="82aw3vQlArEastJ24LABY8oPgQLesIyAyzYs2g6/aOOOmJHSYFj39fODurJV5e2tTFFebWcfxn7n5edicA8u6HgSJe1GCEk5HjxwLkeJiye2LVZDC7TaValkJbsk9JqY4yv5c7iRiLqgO34RbHEeVfLJpa56u4RZu0K+GpQvnBRPyAhy3KbwhZWpU5Nnqnud2whGb5WKdlL8xF7wnQaUnUN2lns8WwqwM4rc0VK4BbQt/WfWWcYJivSAyB3m4Z5g73df1KiU4C+K8auvUMpLPYVxxnKC/YZz42YslVAWXXUmuGOaM2SfLHRO6o4O9DgXlUgYjeFWqIbAkmMiVEqU", top=4, - skip=8 - ) + skip=8, + ), ) query_response = self.resourcegraph_client.resources(query) @@ -121,28 +118,16 @@ def test_resources_query_options(self): self.assertIsInstance(query_response.data["rows"][0][0], str) def test_resources_facet_query(self): - facet_expression0 = 'location' - facet_expression1 = 'nonExistingColumn' + facet_expression0 = "location" + facet_expression1 = "nonExistingColumn" query = QueryRequest( - query='project id, location | limit 10', + query="project id, location | limit 10", subscriptions=[self.settings.SUBSCRIPTION_ID], facets=[ - FacetRequest( - expression=facet_expression0, - options=FacetRequestOptions( - sort_order='desc', - top=1 - ) - ), - FacetRequest( - expression=facet_expression1, - options=FacetRequestOptions( - sort_order='desc', - top=1 - ) - ) - ] + FacetRequest(expression=facet_expression0, options=FacetRequestOptions(sort_order="desc", top=1)), + FacetRequest(expression=facet_expression1, options=FacetRequestOptions(sort_order="desc", top=1)), + ], ) query_response = self.resourcegraph_client.resources(query) @@ -186,10 +171,7 @@ def test_resources_facet_query(self): self.assertIsNotNone(query_response.facets[1].errors[0].message) def test_resources_malformed_query(self): - query = QueryRequest( - query='project id, location | where where', - subscriptions=[self.settings.SUBSCRIPTION_ID] - ) + query = QueryRequest(query="project id, location | where where", subscriptions=[self.settings.SUBSCRIPTION_ID]) with self.assertRaises(Exception) as cm: self.resourcegraph_client.resources(query) @@ -201,10 +183,10 @@ def test_resources_malformed_query(self): self.assertGreater(len(error.details), 0) self.assertIsNotNone(error.details[0].code) self.assertIsNotNone(error.details[0].message) - #self.assertIsNotNone(error.details[0].additional_properties) - #self.assertEqual(len(error.details[0].additional_properties), 4) + # self.assertIsNotNone(error.details[0].additional_properties) + # self.assertEqual(len(error.details[0].additional_properties), 4) -#------------------------------------------------------------------------------ -if __name__ == '__main__': +# ------------------------------------------------------------------------------ +if __name__ == "__main__": unittest.main() diff --git a/sdk/resources/azure-mgmt-resourcegraph/tsp-location.yaml b/sdk/resources/azure-mgmt-resourcegraph/tsp-location.yaml new file mode 100644 index 000000000000..502128ec684f --- /dev/null +++ b/sdk/resources/azure-mgmt-resourcegraph/tsp-location.yaml @@ -0,0 +1,4 @@ +directory: specification/resourcegraph/resource-manager/Microsoft.ResourceGraph/ResourceGraph +commit: cb62053a18882dd258d9922be9770702b7ef6ac9 +repo: Azure/azure-rest-api-specs +additionalDirectories: