msgraph-sdk 1.51.0__py3-none-any.whl → 1.52.0__py3-none-any.whl

msgraph/generated/device_management/virtual_endpoint/report/report_request_builder.py

@@ -0,0 +1,198 @@
+from __future__ import annotations
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from kiota_abstractions.base_request_builder import BaseRequestBuilder
+from kiota_abstractions.base_request_configuration import RequestConfiguration
+from kiota_abstractions.default_query_parameters import QueryParameters
+from kiota_abstractions.get_path_parameters import get_path_parameters
+from kiota_abstractions.method import Method
+from kiota_abstractions.request_adapter import RequestAdapter
+from kiota_abstractions.request_information import RequestInformation
+from kiota_abstractions.request_option import RequestOption
+from kiota_abstractions.serialization import Parsable, ParsableFactory
+from typing import Any, Optional, TYPE_CHECKING, Union
+from warnings import warn
+
+if TYPE_CHECKING:
+    from ....models.cloud_pc_report import CloudPcReport
+    from ....models.o_data_errors.o_data_error import ODataError
+    from .retrieve_cloud_pc_recommendation_reports.retrieve_cloud_pc_recommendation_reports_request_builder import RetrieveCloudPcRecommendationReportsRequestBuilder
+
+class ReportRequestBuilder(BaseRequestBuilder):
+    """
+    Provides operations to manage the report property of the microsoft.graph.virtualEndpoint entity.
+    """
+    def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, dict[str, Any]]) -> None:
+        """
+        Instantiates a new ReportRequestBuilder and sets the default values.
+        param path_parameters: The raw url or the url-template parameters for the request.
+        param request_adapter: The request adapter to use to execute the requests.
+        Returns: None
+        """
+        super().__init__(request_adapter, "{+baseurl}/deviceManagement/virtualEndpoint/report{?%24expand,%24select}", path_parameters)
+    
+    async def delete(self,request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> None:
+        """
+        Delete navigation property report for deviceManagement
+        param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
+        Returns: None
+        """
+        request_info = self.to_delete_request_information(
+            request_configuration
+        )
+        from ....models.o_data_errors.o_data_error import ODataError
+
+        error_mapping: dict[str, type[ParsableFactory]] = {
+            "XXX": ODataError,
+        }
+        if not self.request_adapter:
+            raise Exception("Http core is null") 
+        return await self.request_adapter.send_no_response_content_async(request_info, error_mapping)
+    
+    async def get(self,request_configuration: Optional[RequestConfiguration[ReportRequestBuilderGetQueryParameters]] = None) -> Optional[CloudPcReport]:
+        """
+        Cloud PC-related reports. Read-only.
+        param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
+        Returns: Optional[CloudPcReport]
+        """
+        request_info = self.to_get_request_information(
+            request_configuration
+        )
+        from ....models.o_data_errors.o_data_error import ODataError
+
+        error_mapping: dict[str, type[ParsableFactory]] = {
+            "XXX": ODataError,
+        }
+        if not self.request_adapter:
+            raise Exception("Http core is null") 
+        from ....models.cloud_pc_report import CloudPcReport
+
+        return await self.request_adapter.send_async(request_info, CloudPcReport, error_mapping)
+    
+    async def patch(self,body: CloudPcReport, request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> Optional[CloudPcReport]:
+        """
+        Update the navigation property report in deviceManagement
+        param body: The request body
+        param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
+        Returns: Optional[CloudPcReport]
+        """
+        if body is None:
+            raise TypeError("body cannot be null.")
+        request_info = self.to_patch_request_information(
+            body, request_configuration
+        )
+        from ....models.o_data_errors.o_data_error import ODataError
+
+        error_mapping: dict[str, type[ParsableFactory]] = {
+            "XXX": ODataError,
+        }
+        if not self.request_adapter:
+            raise Exception("Http core is null") 
+        from ....models.cloud_pc_report import CloudPcReport
+
+        return await self.request_adapter.send_async(request_info, CloudPcReport, error_mapping)
+    
+    def to_delete_request_information(self,request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> RequestInformation:
+        """
+        Delete navigation property report for deviceManagement
+        param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
+        Returns: RequestInformation
+        """
+        request_info = RequestInformation(Method.DELETE, self.url_template, self.path_parameters)
+        request_info.configure(request_configuration)
+        request_info.headers.try_add("Accept", "application/json")
+        return request_info
+    
+    def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[ReportRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
+        """
+        Cloud PC-related reports. Read-only.
+        param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
+        Returns: RequestInformation
+        """
+        request_info = RequestInformation(Method.GET, self.url_template, self.path_parameters)
+        request_info.configure(request_configuration)
+        request_info.headers.try_add("Accept", "application/json")
+        return request_info
+    
+    def to_patch_request_information(self,body: CloudPcReport, request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> RequestInformation:
+        """
+        Update the navigation property report in deviceManagement
+        param body: The request body
+        param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
+        Returns: RequestInformation
+        """
+        if body is None:
+            raise TypeError("body cannot be null.")
+        request_info = RequestInformation(Method.PATCH, self.url_template, self.path_parameters)
+        request_info.configure(request_configuration)
+        request_info.headers.try_add("Accept", "application/json")
+        request_info.set_content_from_parsable(self.request_adapter, "application/json", body)
+        return request_info
+    
+    def with_url(self,raw_url: str) -> ReportRequestBuilder:
+        """
+        Returns a request builder with the provided arbitrary URL. Using this method means any other path or query parameters are ignored.
+        param raw_url: The raw URL to use for the request builder.
+        Returns: ReportRequestBuilder
+        """
+        if raw_url is None:
+            raise TypeError("raw_url cannot be null.")
+        return ReportRequestBuilder(self.request_adapter, raw_url)
+    
+    @property
+    def retrieve_cloud_pc_recommendation_reports(self) -> RetrieveCloudPcRecommendationReportsRequestBuilder:
+        """
+        Provides operations to call the retrieveCloudPcRecommendationReports method.
+        """
+        from .retrieve_cloud_pc_recommendation_reports.retrieve_cloud_pc_recommendation_reports_request_builder import RetrieveCloudPcRecommendationReportsRequestBuilder
+
+        return RetrieveCloudPcRecommendationReportsRequestBuilder(self.request_adapter, self.path_parameters)
+    
+    @dataclass
+    class ReportRequestBuilderDeleteRequestConfiguration(RequestConfiguration[QueryParameters]):
+        """
+        Configuration for the request such as headers, query parameters, and middleware options.
+        """
+        warn("This class is deprecated. Please use the generic RequestConfiguration class generated by the generator.", DeprecationWarning)
+    
+    @dataclass
+    class ReportRequestBuilderGetQueryParameters():
+        """
+        Cloud PC-related reports. Read-only.
+        """
+        def get_query_parameter(self,original_name: str) -> str:
+            """
+            Maps the query parameters names to their encoded names for the URI template parsing.
+            param original_name: The original query parameter name in the class.
+            Returns: str
+            """
+            if original_name is None:
+                raise TypeError("original_name cannot be null.")
+            if original_name == "expand":
+                return "%24expand"
+            if original_name == "select":
+                return "%24select"
+            return original_name
+        
+        # Expand related entities
+        expand: Optional[list[str]] = None
+
+        # Select properties to be returned
+        select: Optional[list[str]] = None
+
+    
+    @dataclass
+    class ReportRequestBuilderGetRequestConfiguration(RequestConfiguration[ReportRequestBuilderGetQueryParameters]):
+        """
+        Configuration for the request such as headers, query parameters, and middleware options.
+        """
+        warn("This class is deprecated. Please use the generic RequestConfiguration class generated by the generator.", DeprecationWarning)
+    
+    @dataclass
+    class ReportRequestBuilderPatchRequestConfiguration(RequestConfiguration[QueryParameters]):
+        """
+        Configuration for the request such as headers, query parameters, and middleware options.
+        """
+        warn("This class is deprecated. Please use the generic RequestConfiguration class generated by the generator.", DeprecationWarning)
+    
+

msgraph/generated/device_management/virtual_endpoint/report/retrieve_cloud_pc_recommendation_reports/retrieve_cloud_pc_recommendation_reports_post_request_body.py

@@ -0,0 +1,85 @@
+from __future__ import annotations
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from kiota_abstractions.serialization import AdditionalDataHolder, Parsable, ParseNode, SerializationWriter
+from kiota_abstractions.store import BackedModel, BackingStore, BackingStoreFactorySingleton
+from typing import Any, Optional, TYPE_CHECKING, Union
+
+if TYPE_CHECKING:
+    from .....models.cloud_pc_recommendation_report_type import CloudPcRecommendationReportType
+
+@dataclass
+class RetrieveCloudPcRecommendationReportsPostRequestBody(AdditionalDataHolder, BackedModel, Parsable):
+    # Stores model information.
+    backing_store: BackingStore = field(default_factory=BackingStoreFactorySingleton(backing_store_factory=None).backing_store_factory.create_backing_store, repr=False)
+
+    # Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well.
+    additional_data: dict[str, Any] = field(default_factory=dict)
+    # The filter property
+    filter: Optional[str] = None
+    # The groupBy property
+    group_by: Optional[list[str]] = None
+    # The orderBy property
+    order_by: Optional[list[str]] = None
+    # The reportType property
+    report_type: Optional[CloudPcRecommendationReportType] = None
+    # The search property
+    search: Optional[str] = None
+    # The select property
+    select: Optional[list[str]] = None
+    # The skip property
+    skip: Optional[int] = None
+    # The top property
+    top: Optional[int] = None
+    
+    @staticmethod
+    def create_from_discriminator_value(parse_node: ParseNode) -> RetrieveCloudPcRecommendationReportsPostRequestBody:
+        """
+        Creates a new instance of the appropriate class based on discriminator value
+        param parse_node: The parse node to use to read the discriminator value and create the object
+        Returns: RetrieveCloudPcRecommendationReportsPostRequestBody
+        """
+        if parse_node is None:
+            raise TypeError("parse_node cannot be null.")
+        return RetrieveCloudPcRecommendationReportsPostRequestBody()
+    
+    def get_field_deserializers(self,) -> dict[str, Callable[[ParseNode], None]]:
+        """
+        The deserialization information for the current model
+        Returns: dict[str, Callable[[ParseNode], None]]
+        """
+        from .....models.cloud_pc_recommendation_report_type import CloudPcRecommendationReportType
+
+        from .....models.cloud_pc_recommendation_report_type import CloudPcRecommendationReportType
+
+        fields: dict[str, Callable[[Any], None]] = {
+            "filter": lambda n : setattr(self, 'filter', n.get_str_value()),
+            "groupBy": lambda n : setattr(self, 'group_by', n.get_collection_of_primitive_values(str)),
+            "orderBy": lambda n : setattr(self, 'order_by', n.get_collection_of_primitive_values(str)),
+            "reportType": lambda n : setattr(self, 'report_type', n.get_enum_value(CloudPcRecommendationReportType)),
+            "search": lambda n : setattr(self, 'search', n.get_str_value()),
+            "select": lambda n : setattr(self, 'select', n.get_collection_of_primitive_values(str)),
+            "skip": lambda n : setattr(self, 'skip', n.get_int_value()),
+            "top": lambda n : setattr(self, 'top', n.get_int_value()),
+        }
+        return fields
+    
+    def serialize(self,writer: SerializationWriter) -> None:
+        """
+        Serializes information the current object
+        param writer: Serialization writer to use to serialize this model
+        Returns: None
+        """
+        if writer is None:
+            raise TypeError("writer cannot be null.")
+        writer.write_str_value("filter", self.filter)
+        writer.write_collection_of_primitive_values("groupBy", self.group_by)
+        writer.write_collection_of_primitive_values("orderBy", self.order_by)
+        writer.write_enum_value("reportType", self.report_type)
+        writer.write_str_value("search", self.search)
+        writer.write_collection_of_primitive_values("select", self.select)
+        writer.write_int_value("skip", self.skip)
+        writer.write_int_value("top", self.top)
+        writer.write_additional_data_value(self.additional_data)
+    
+

msgraph/generated/device_management/virtual_endpoint/report/retrieve_cloud_pc_recommendation_reports/retrieve_cloud_pc_recommendation_reports_request_builder.py

@@ -0,0 +1,87 @@
+from __future__ import annotations
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from kiota_abstractions.base_request_builder import BaseRequestBuilder
+from kiota_abstractions.base_request_configuration import RequestConfiguration
+from kiota_abstractions.default_query_parameters import QueryParameters
+from kiota_abstractions.get_path_parameters import get_path_parameters
+from kiota_abstractions.method import Method
+from kiota_abstractions.request_adapter import RequestAdapter
+from kiota_abstractions.request_information import RequestInformation
+from kiota_abstractions.request_option import RequestOption
+from kiota_abstractions.serialization import Parsable, ParsableFactory
+from typing import Any, Optional, TYPE_CHECKING, Union
+from warnings import warn
+
+if TYPE_CHECKING:
+    from .....models.o_data_errors.o_data_error import ODataError
+    from .retrieve_cloud_pc_recommendation_reports_post_request_body import RetrieveCloudPcRecommendationReportsPostRequestBody
+
+class RetrieveCloudPcRecommendationReportsRequestBuilder(BaseRequestBuilder):
+    """
+    Provides operations to call the retrieveCloudPcRecommendationReports method.
+    """
+    def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, dict[str, Any]]) -> None:
+        """
+        Instantiates a new RetrieveCloudPcRecommendationReportsRequestBuilder and sets the default values.
+        param path_parameters: The raw url or the url-template parameters for the request.
+        param request_adapter: The request adapter to use to execute the requests.
+        Returns: None
+        """
+        super().__init__(request_adapter, "{+baseurl}/deviceManagement/virtualEndpoint/report/retrieveCloudPcRecommendationReports", path_parameters)
+    
+    async def post(self,body: RetrieveCloudPcRecommendationReportsPostRequestBody, request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> Optional[bytes]:
+        """
+        Retrieve Cloud PC recommendation reports for usage optimization and cost savings. The usage category report categorizes a Cloud PC as Undersized, Oversized, Rightsized, or Underutilized, and also provides the recommended SKU when the Cloud PC isn't Rightsized.
+        param body: The request body
+        param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
+        Returns: bytes
+        Find more info here: https://learn.microsoft.com/graph/api/cloudpcreport-retrievecloudpcrecommendationreports?view=graph-rest-1.0
+        """
+        if body is None:
+            raise TypeError("body cannot be null.")
+        request_info = self.to_post_request_information(
+            body, request_configuration
+        )
+        from .....models.o_data_errors.o_data_error import ODataError
+
+        error_mapping: dict[str, type[ParsableFactory]] = {
+            "XXX": ODataError,
+        }
+        if not self.request_adapter:
+            raise Exception("Http core is null") 
+        return await self.request_adapter.send_primitive_async(request_info, "bytes", error_mapping)
+    
+    def to_post_request_information(self,body: RetrieveCloudPcRecommendationReportsPostRequestBody, request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> RequestInformation:
+        """
+        Retrieve Cloud PC recommendation reports for usage optimization and cost savings. The usage category report categorizes a Cloud PC as Undersized, Oversized, Rightsized, or Underutilized, and also provides the recommended SKU when the Cloud PC isn't Rightsized.
+        param body: The request body
+        param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
+        Returns: RequestInformation
+        """
+        if body is None:
+            raise TypeError("body cannot be null.")
+        request_info = RequestInformation(Method.POST, self.url_template, self.path_parameters)
+        request_info.configure(request_configuration)
+        request_info.headers.try_add("Accept", "application/octet-stream, application/json")
+        request_info.set_content_from_parsable(self.request_adapter, "application/json", body)
+        return request_info
+    
+    def with_url(self,raw_url: str) -> RetrieveCloudPcRecommendationReportsRequestBuilder:
+        """
+        Returns a request builder with the provided arbitrary URL. Using this method means any other path or query parameters are ignored.
+        param raw_url: The raw URL to use for the request builder.
+        Returns: RetrieveCloudPcRecommendationReportsRequestBuilder
+        """
+        if raw_url is None:
+            raise TypeError("raw_url cannot be null.")
+        return RetrieveCloudPcRecommendationReportsRequestBuilder(self.request_adapter, raw_url)
+    
+    @dataclass
+    class RetrieveCloudPcRecommendationReportsRequestBuilderPostRequestConfiguration(RequestConfiguration[QueryParameters]):
+        """
+        Configuration for the request such as headers, query parameters, and middleware options.
+        """
+        warn("This class is deprecated. Please use the generic RequestConfiguration class generated by the generator.", DeprecationWarning)
+    
+

msgraph/generated/device_management/virtual_endpoint/virtual_endpoint_request_builder.py

@@ -22,6 +22,7 @@ if TYPE_CHECKING:
     from .gallery_images.gallery_images_request_builder import GalleryImagesRequestBuilder
     from .on_premises_connections.on_premises_connections_request_builder import OnPremisesConnectionsRequestBuilder
     from .provisioning_policies.provisioning_policies_request_builder import ProvisioningPoliciesRequestBuilder
+    from .report.report_request_builder import ReportRequestBuilder
     from .user_settings.user_settings_request_builder import UserSettingsRequestBuilder
 
 class VirtualEndpointRequestBuilder(BaseRequestBuilder):
@@ -199,6 +200,15 @@ class VirtualEndpointRequestBuilder(BaseRequestBuilder):
 
         return ProvisioningPoliciesRequestBuilder(self.request_adapter, self.path_parameters)
     
+    @property
+    def report(self) -> ReportRequestBuilder:
+        """
+        Provides operations to manage the report property of the microsoft.graph.virtualEndpoint entity.
+        """
+        from .report.report_request_builder import ReportRequestBuilder
+
+        return ReportRequestBuilder(self.request_adapter, self.path_parameters)
+    
     @property
     def user_settings(self) -> UserSettingsRequestBuilder:
         """

msgraph/generated/drives/item/recent/recent_request_builder.py

@@ -37,6 +37,7 @@ class RecentRequestBuilder(BaseRequestBuilder):
         Returns: Optional[RecentGetResponse]
         Find more info here: https://learn.microsoft.com/graph/api/drive-recent?view=graph-rest-1.0
         """
+        warn("This API is deprecated and will stop returning data after November, 2027. as of 2025-11/Removal on 2025-11-13 and will be removed 2027-11-01", DeprecationWarning)
         request_info = self.to_get_request_information(
             request_configuration
         )
@@ -57,6 +58,7 @@ class RecentRequestBuilder(BaseRequestBuilder):
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
+        warn("This API is deprecated and will stop returning data after November, 2027. as of 2025-11/Removal on 2025-11-13 and will be removed 2027-11-01", DeprecationWarning)
         request_info = RequestInformation(Method.GET, self.url_template, self.path_parameters)
         request_info.configure(request_configuration)
         request_info.headers.try_add("Accept", "application/json")
@@ -68,6 +70,7 @@ class RecentRequestBuilder(BaseRequestBuilder):
         param raw_url: The raw URL to use for the request builder.
         Returns: RecentRequestBuilder
         """
+        warn("This API is deprecated and will stop returning data after November, 2027. as of 2025-11/Removal on 2025-11-13 and will be removed 2027-11-01", DeprecationWarning)
         if raw_url is None:
             raise TypeError("raw_url cannot be null.")
         return RecentRequestBuilder(self.request_adapter, raw_url)

msgraph/generated/drives/item/shared_with_me/shared_with_me_request_builder.py

@@ -37,6 +37,7 @@ class SharedWithMeRequestBuilder(BaseRequestBuilder):
         Returns: Optional[SharedWithMeGetResponse]
         Find more info here: https://learn.microsoft.com/graph/api/drive-sharedwithme?view=graph-rest-1.0
         """
+        warn("This API is deprecated and will stop returning data after November, 2027. as of 2025-11/Removal on 2025-11-13 and will be removed 2027-11-01", DeprecationWarning)
         request_info = self.to_get_request_information(
             request_configuration
         )
@@ -57,6 +58,7 @@ class SharedWithMeRequestBuilder(BaseRequestBuilder):
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
+        warn("This API is deprecated and will stop returning data after November, 2027. as of 2025-11/Removal on 2025-11-13 and will be removed 2027-11-01", DeprecationWarning)
         request_info = RequestInformation(Method.GET, self.url_template, self.path_parameters)
         request_info.configure(request_configuration)
         request_info.headers.try_add("Accept", "application/json")
@@ -68,6 +70,7 @@ class SharedWithMeRequestBuilder(BaseRequestBuilder):
         param raw_url: The raw URL to use for the request builder.
         Returns: SharedWithMeRequestBuilder
         """
+        warn("This API is deprecated and will stop returning data after November, 2027. as of 2025-11/Removal on 2025-11-13 and will be removed 2027-11-01", DeprecationWarning)
         if raw_url is None:
             raise TypeError("raw_url cannot be null.")
         return SharedWithMeRequestBuilder(self.request_adapter, raw_url)