CodeGen from PR 14696 in Azure/azure-rest-api-specs

Merge d979edd5eb4ddfb24498f9f081f0f91655a9595c into c059fb4

Author: SDKAuto

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

@@ -1,11 +1,11 @@
 {
   "autorest": "3.4.2",
   "use": [
-    "@autorest/python@5.8.0",
+    "@autorest/python@5.8.1",
     "@autorest/modelerfour@4.19.2"
   ],
-  "commit": "1f0bb3f63b1664ace42cfdf646d8b2382d7b7b22",
+  "commit": "577fb86e4e22d3d58d20b3f2a4dc6200f0c49000",
   "repository_url": "https://github.com/Azure/azure-rest-api-specs",
-  "autorest_command": "autorest specification/containerservice/resource-manager/readme.md --multiapi --python --python-mode=update --python-sdks-folder=/home/vsts/work/1/s/azure-sdk-for-python/sdk --track2 --use=@autorest/python@5.8.0 --use=@autorest/modelerfour@4.19.2 --version=3.4.2",
+  "autorest_command": "autorest specification/containerservice/resource-manager/readme.md --multiapi --python --python-mode=update --python-sdks-folder=/home/vsts/work/1/s/azure-sdk-for-python/sdk --track2 --use=@autorest/python@5.8.1 --use=@autorest/modelerfour@4.19.2 --version=3.4.2",
   "readme": "specification/containerservice/resource-manager/readme.md"
 }

sdk/containerservice/azure-mgmt-containerservice/azure/mgmt/containerservice/v2021_05_01/aio/operations/_agent_pools_operations.py

@@ -51,8 +51,7 @@ def list(
     ) -> AsyncIterable["_models.AgentPoolListResult"]:
         """Gets a list of agent pools in the specified managed cluster.
 
-        Gets a list of agent pools in the specified managed cluster. The operation returns properties
-        of each agent pool.
+        Gets a list of agent pools in the specified managed cluster.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str
@@ -127,9 +126,9 @@ async def get(
         agent_pool_name: str,
         **kwargs: Any
     ) -> "_models.AgentPool":
-        """Gets the agent pool.
+        """Gets the specified managed cluster agent pool.
 
-        Gets the details of the agent pool by managed cluster and resource group.
+        Gets the specified managed cluster agent pool.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str
@@ -251,7 +250,7 @@ async def begin_create_or_update(
         parameters: "_models.AgentPool",
         **kwargs: Any
     ) -> AsyncLROPoller["_models.AgentPool"]:
-        """Creates or updates an agent pool.
+        """Creates or updates an agent pool in the specified managed cluster.
 
         Creates or updates an agent pool in the specified managed cluster.
 
@@ -261,7 +260,7 @@ async def begin_create_or_update(
         :type resource_name: str
         :param agent_pool_name: The name of the agent pool.
         :type agent_pool_name: str
-        :param parameters: Parameters supplied to the Create or Update an agent pool operation.
+        :param parameters: The agent pool to create or update.
         :type parameters: ~azure.mgmt.containerservice.v2021_05_01.models.AgentPool
         :keyword callable cls: A custom type or function that will be passed the direct response
         :keyword str continuation_token: A continuation token to restart a poller from a saved state.
@@ -374,9 +373,9 @@ async def begin_delete(
         agent_pool_name: str,
         **kwargs: Any
     ) -> AsyncLROPoller[None]:
-        """Deletes an agent pool.
+        """Deletes an agent pool in the specified managed cluster.
 
-        Deletes the agent pool in the specified managed cluster.
+        Deletes an agent pool in the specified managed cluster.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str
@@ -445,10 +444,9 @@ async def get_upgrade_profile(
         agent_pool_name: str,
         **kwargs: Any
     ) -> "_models.AgentPoolUpgradeProfile":
-        """Gets upgrade profile for an agent pool.
+        """Gets the upgrade profile for an agent pool.
 
-        Gets the details of the upgrade profile for an agent pool with a specified resource group and
-        managed cluster name.
+        Gets the upgrade profile for an agent pool.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str
@@ -509,9 +507,11 @@ async def get_available_agent_pool_versions(
         resource_name: str,
         **kwargs: Any
     ) -> "_models.AgentPoolAvailableVersions":
-        """Gets a list of supported versions for the specified agent pool.
+        """Gets a list of supported Kubernetes versions for the specified agent pool.
 
-        Gets a list of supported versions for the specified agent pool.
+        See `supported Kubernetes versions
+        <https://docs.microsoft.com/azure/aks/supported-kubernetes-versions>`_ for more details about
+        the version lifecycle.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str
@@ -621,9 +621,11 @@ async def begin_upgrade_node_image_version(
         agent_pool_name: str,
         **kwargs: Any
     ) -> AsyncLROPoller["_models.AgentPool"]:
-        """Upgrade node image version of an agent pool to the latest.
+        """Upgrades the node image version of an agent pool to the latest.
 
-        Upgrade node image version of an agent pool to the latest.
+        Upgrading the node image version of an agent pool applies the newest OS and runtime updates to
+        the nodes. AKS provides one new image per week with the latest updates. For more details on
+        node image versions, see: https://docs.microsoft.com/azure/aks/node-image-upgrade.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str

sdk/containerservice/azure-mgmt-containerservice/azure/mgmt/containerservice/v2021_05_01/aio/operations/_maintenance_configurations_operations.py

@@ -49,8 +49,7 @@ def list_by_managed_cluster(
     ) -> AsyncIterable["_models.MaintenanceConfigurationListResult"]:
         """Gets a list of maintenance configurations in the specified managed cluster.
 
-        Gets a list of maintenance configurations in the specified managed cluster. The operation
-        returns properties of each maintenance configuration.
+        Gets a list of maintenance configurations in the specified managed cluster.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str
@@ -125,9 +124,9 @@ async def get(
         config_name: str,
         **kwargs: Any
     ) -> "_models.MaintenanceConfiguration":
-        """Gets the maintenance configuration.
+        """Gets the specified maintenance configuration of a managed cluster.
 
-        Gets the details of maintenance configurations by managed cluster and resource group.
+        Gets the specified maintenance configuration of a managed cluster.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str
@@ -190,7 +189,7 @@ async def create_or_update(
         parameters: "_models.MaintenanceConfiguration",
         **kwargs: Any
     ) -> "_models.MaintenanceConfiguration":
-        """Creates or updates a maintenance configurations.
+        """Creates or updates a maintenance configuration in the specified managed cluster.
 
         Creates or updates a maintenance configuration in the specified managed cluster.
 
@@ -200,8 +199,7 @@ async def create_or_update(
         :type resource_name: str
         :param config_name: The name of the maintenance configuration.
         :type config_name: str
-        :param parameters: Parameters supplied to the Create or Update a default maintenance
-         configuration.
+        :param parameters: The maintenance configuration to create or update.
         :type parameters: ~azure.mgmt.containerservice.v2021_05_01.models.MaintenanceConfiguration
         :keyword callable cls: A custom type or function that will be passed the direct response
         :return: MaintenanceConfiguration, or the result of cls(response)
@@ -264,7 +262,7 @@ async def delete(
     ) -> None:
         """Deletes a maintenance configuration.
 
-        Deletes the maintenance configuration in the specified managed cluster.
+        Deletes a maintenance configuration.
 
         :param resource_group_name: The name of the resource group.
         :type resource_group_name: str