[AutoRelease] t2-powerbiembedded-2024-06-24-82297(can only be merged by SDK owner) (#36215)

* code and test

* Update CHANGELOG.md

* update-testcase

---------

Co-authored-by: azure-sdk <PythonSdkPipelines>
Co-authored-by: Yuchao Yan <[email protected]>
Co-authored-by: ChenxiJiang333 <[email protected]>

Author: 3 people

sdk/powerbiembedded/azure-mgmt-powerbiembedded/CHANGELOG.md

@@ -1,5 +1,64 @@
 # Release History
 
+## 3.0.0 (2024-06-24)
+
+This version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentication and async programming).
+
+**General breaking changes**
+
+- Credential system has been completly revamped:
+
+  - `azure.common.credentials` or `msrestazure.azure_active_directory` instances are no longer supported, use the `azure-identity` classes instead: https://pypi.org/project/azure-identity/
+  - `credentials` parameter has been renamed `credential`
+
+- The `config` attribute no longer exists on a client, configuration should be passed as kwarg. Example: `MyClient(credential, subscription_id, enable_logging=True)`. For a complete set of
+  supported options, see the [parameters accept in init documentation of azure-core](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)
+- You can't import a `version` module anymore, use `__version__` instead
+- Operations that used to return a `msrest.polling.LROPoller` now returns a `azure.core.polling.LROPoller` and are prefixed with `begin_`.
+- Exceptions tree have been simplified and most exceptions are now `azure.core.exceptions.HttpResponseError` (`CloudError` has been removed).
+- Most of the operation kwarg have changed. Some of the most noticeable:
+
+  - `raw` has been removed. Equivalent feature can be found using `cls`, a callback that will give access to internal HTTP response for advanced user
+  - For a complete set of
+  supported options, see the [parameters accept in Request documentation of azure-core](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)
+
+**General new features**
+
+- Type annotations support using `typing`. SDKs are mypy ready.
+- This client has now stable and official support for async. Check the `aio` namespace of your package to find the async client.
+- This client now support natively tracing library like OpenCensus or OpenTelemetry. See this [tracing quickstart](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry) for an overview.
+
+### Features Added
+
+  - Added operation group PowerBIEmbeddedManagementClientOperationsMixin
+
+### Breaking Changes
+
+  - Operation WorkspaceCollectionsOperations.check_name_availability has a new required parameter body
+  - Operation WorkspaceCollectionsOperations.check_name_availability has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.check_name_availability no longer has parameter name
+  - Operation WorkspaceCollectionsOperations.check_name_availability no longer has parameter type
+  - Operation WorkspaceCollectionsOperations.create has a new required parameter body
+  - Operation WorkspaceCollectionsOperations.create has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.create no longer has parameter location
+  - Operation WorkspaceCollectionsOperations.create no longer has parameter tags
+  - Operation WorkspaceCollectionsOperations.get_access_keys has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.get_by_name has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.list_by_resource_group has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.list_by_subscription has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.migrate has a new required parameter body
+  - Operation WorkspaceCollectionsOperations.migrate has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.migrate no longer has parameter resources
+  - Operation WorkspaceCollectionsOperations.migrate no longer has parameter target_resource_group
+  - Operation WorkspaceCollectionsOperations.regenerate_key has a new required parameter body
+  - Operation WorkspaceCollectionsOperations.regenerate_key has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.regenerate_key no longer has parameter key_name
+  - Operation WorkspaceCollectionsOperations.update has a new required parameter body
+  - Operation WorkspaceCollectionsOperations.update has a new required parameter kwargs
+  - Operation WorkspaceCollectionsOperations.update no longer has parameter tags
+  - Operation WorkspacesOperations.list has a new required parameter kwargs
+  - Renamed operation WorkspaceCollectionsOperations.delete to WorkspaceCollectionsOperations.begin_delete
+
 ## 2.0.0 (2018-05-25)
 
 **Features**

sdk/powerbiembedded/azure-mgmt-powerbiembedded/MANIFEST.in

@@ -1,6 +1,8 @@
 include _meta.json
-recursive-include tests *.py *.yaml
+recursive-include tests *.py *.json
+recursive-include samples *.py *.md
 include *.md
 include azure/__init__.py
 include azure/mgmt/__init__.py
 include LICENSE
+include azure/mgmt/powerbiembedded/py.typed

sdk/powerbiembedded/azure-mgmt-powerbiembedded/README.md

@@ -1,30 +1,61 @@
 # Microsoft Azure SDK for Python
 
 This is the Microsoft Azure Power BI Embedded Management Client Library.
-This package has been tested with Python 3.6+.
+This package has been tested with Python 3.8+.
 For a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all).
 
 ## _Disclaimer_
 
 _Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691_
 
-# Usage
+## Getting started
 
+### Prerequisites
 
-To learn how to use this package, see the [quickstart guide](https://aka.ms/azsdk/python/mgmt)
+- Python 3.8+ is required to use this package.
+- [Azure subscription](https://azure.microsoft.com/free/)
 
+### Install the package
 
- 
-For docs and references, see [Python SDK References](https://docs.microsoft.com/python/api/overview/azure/power-bi)
-Code samples for this package can be found at [Power BI Embedded Management](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing&terms=Getting%20started%20-%20Managing) on docs.microsoft.com.
-Additional code samples for different Azure services are available at [Samples Repo](https://aka.ms/azsdk/python/mgmt/samples)
+```bash
+pip install azure-mgmt-powerbiembedded
+pip install azure-identity
+```
 
+### Authentication
 
-# Provide Feedback
+By default, [Azure Active Directory](https://aka.ms/awps/aad) token authentication depends on correct configure of following environment variables.
+
+- `AZURE_CLIENT_ID` for Azure client ID.
+- `AZURE_TENANT_ID` for Azure tenant ID.
+- `AZURE_CLIENT_SECRET` for Azure client secret.
+
+In addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`.
+
+With above configuration, client can be authenticated by following code:
+
+```python
+from azure.identity import DefaultAzureCredential
+from azure.mgmt.powerbiembedded import PowerBIEmbeddedManagementClient
+import os
+
+sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
+client = PowerBIEmbeddedManagementClient(credential=DefaultAzureCredential(), subscription_id=sub_id)
+```
+
+## Examples
+
+Code samples for this package can be found at:
+- [Search Power BI Embedded Management](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing&terms=Getting%20started%20-%20Managing) on docs.microsoft.com
+- [Azure Python Mgmt SDK Samples Repo](https://aka.ms/azsdk/python/mgmt/samples)
+
+
+## Troubleshooting
+
+## Next steps
+
+## Provide Feedback
 
 If you encounter any bugs or have suggestions, please file an issue in the
 [Issues](https://github.com/Azure/azure-sdk-for-python/issues)
 section of the project. 
-
-
-![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-python%2Fazure-mgmt-powerbiembedded%2FREADME.png)

sdk/powerbiembedded/azure-mgmt-powerbiembedded/_meta.json

@@ -0,0 +1,11 @@
+{
+  "commit": "9f9d14b5db982b1d554651348adc9bef4b098bdb",
+  "repository_url": "https://github.com/Azure/azure-rest-api-specs",
+  "autorest": "3.10.2",
+  "use": [
+    "@autorest/[email protected]",
+    "@autorest/[email protected]"
+  ],
+  "autorest_command": "autorest specification/powerbiembedded/resource-manager/readme.md --generate-sample=True --include-x-ms-examples-original-file=True --python --python-sdks-folder=/home/vsts/work/1/azure-sdk-for-python/sdk --use=@autorest/[email protected] --use=@autorest/[email protected] --version=3.10.2 --version-tolerant=False",
+  "readme": "specification/powerbiembedded/resource-manager/readme.md"
+}

sdk/powerbiembedded/azure-mgmt-powerbiembedded/assets.json

@@ -0,0 +1,6 @@
+{
+    "AssetsRepo": "Azure/azure-sdk-assets",
+    "AssetsRepoPrefixPath": "python",
+    "TagPrefix": "python/powerbiembedded/azure-mgmt-powerbiembedded",
+    "Tag": "python/powerbiembedded/azure-mgmt-powerbiembedded_3a0f8a6592"
+}

sdk/powerbiembedded/azure-mgmt-powerbiembedded/azure/mgmt/powerbiembedded/__init__.py

@@ -1,18 +1,26 @@
 # 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.
-#
+# 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.
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
-from .power_bi_embedded_management_client import PowerBIEmbeddedManagementClient
-from .version import VERSION
-
-__all__ = ['PowerBIEmbeddedManagementClient']
+from ._power_bi_embedded_management_client import PowerBIEmbeddedManagementClient
+from ._version import VERSION
 
 __version__ = VERSION
 
+try:
+    from ._patch import __all__ as _patch_all
+    from ._patch import *  # pylint: disable=unused-wildcard-import
+except ImportError:
+    _patch_all = []
+from ._patch import patch_sdk as _patch_sdk
+
+__all__ = [
+    "PowerBIEmbeddedManagementClient",
+]
+__all__.extend([p for p in _patch_all if p not in __all__])
+
+_patch_sdk()

sdk/powerbiembedded/azure-mgmt-powerbiembedded/azure/mgmt/powerbiembedded/_configuration.py

@@ -0,0 +1,66 @@
+# 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 typing import Any, TYPE_CHECKING
+
+from azure.core.pipeline import policies
+from azure.mgmt.core.policies import ARMChallengeAuthenticationPolicy, ARMHttpLoggingPolicy
+
+from ._version import VERSION
+
+if TYPE_CHECKING:
+    # pylint: disable=unused-import,ungrouped-imports
+    from azure.core.credentials import TokenCredential
+
+
+class PowerBIEmbeddedManagementClientConfiguration:  # pylint: disable=too-many-instance-attributes,name-too-long
+    """Configuration for PowerBIEmbeddedManagementClient.
+
+    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.
+    :type credential: ~azure.core.credentials.TokenCredential
+    :param subscription_id: Gets subscription credentials which uniquely identify a Microsoft Azure
+     subscription. The subscription ID forms part of the URI for every service call. Required.
+    :type subscription_id: str
+    :keyword api_version: Api Version. Default value is "2016-01-29". Note that overriding this
+     default value may result in unsupported behavior.
+    :paramtype api_version: str
+    """
+
+    def __init__(self, credential: "TokenCredential", subscription_id: str, **kwargs: Any) -> None:
+        api_version: str = kwargs.pop("api_version", "2016-01-29")
+
+        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.api_version = api_version
+        self.credential_scopes = kwargs.pop("credential_scopes", ["https://management.azure.com/.default"])
+        kwargs.setdefault("sdk_moniker", "mgmt-powerbiembedded/{}".format(VERSION))
+        self.polling_interval = kwargs.get("polling_interval", 30)
+        self._configure(**kwargs)
+
+    def _configure(self, **kwargs: Any) -> None:
+        self.user_agent_policy = kwargs.get("user_agent_policy") or policies.UserAgentPolicy(**kwargs)
+        self.headers_policy = kwargs.get("headers_policy") or policies.HeadersPolicy(**kwargs)
+        self.proxy_policy = kwargs.get("proxy_policy") or policies.ProxyPolicy(**kwargs)
+        self.logging_policy = kwargs.get("logging_policy") or policies.NetworkTraceLoggingPolicy(**kwargs)
+        self.http_logging_policy = kwargs.get("http_logging_policy") or ARMHttpLoggingPolicy(**kwargs)
+        self.custom_hook_policy = kwargs.get("custom_hook_policy") or policies.CustomHookPolicy(**kwargs)
+        self.redirect_policy = kwargs.get("redirect_policy") or policies.RedirectPolicy(**kwargs)
+        self.retry_policy = kwargs.get("retry_policy") or policies.RetryPolicy(**kwargs)
+        self.authentication_policy = kwargs.get("authentication_policy")
+        if self.credential and not self.authentication_policy:
+            self.authentication_policy = ARMChallengeAuthenticationPolicy(
+                self.credential, *self.credential_scopes, **kwargs
+            )

sdk/powerbiembedded/azure-mgmt-powerbiembedded/azure/mgmt/powerbiembedded/_patch.py

@@ -0,0 +1,20 @@
+# ------------------------------------
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+# ------------------------------------
+"""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
+
+
+def patch_sdk():
+    """Do not remove from this file.
+
+    `patch_sdk` is a last resort escape hatch that allows you to do customizations
+    you can't accomplish using the techniques described in
+    https://aka.ms/azsdk/python/dpcodegen/python/customize
+    """