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

Merge 8e069352d3006fdab04af5527670aa9c49b4cff1 into 28c5aaa5810448fce57da7e47427259a0c8850bf

Author: SDKAuto

sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/CHANGELOG.md

@@ -1,6 +1,8 @@
 # Release History
 
-## 1.0.0-beta.5 (Unreleased)
+## 1.0.0-beta.1 (2023-10-23)
+
+- Azure Resource Manager MySql client library for Java. This package contains Microsoft Azure SDK for MySql Management SDK. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure MySQL resources including servers, databases, firewall rules, VNET rules, log files and configurations with new business model. Package tag package-flexibleserver-2023-06-30. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
 
 ### Features Added
 

sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/README.md

@@ -2,7 +2,7 @@
 
 Azure Resource Manager MySql client library for Java.
 
-This package contains Microsoft Azure SDK for MySql Management SDK. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure MySQL resources including servers, databases, firewall rules, VNET rules, log files and configurations with new business model. Package tag package-flexibleserver-2022-09-30-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
+This package contains Microsoft Azure SDK for MySql Management SDK. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure MySQL resources including servers, databases, firewall rules, VNET rules, log files and configurations with new business model. Package tag package-flexibleserver-2023-06-30. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
 
 ## We'd love to hear your feedback
 
@@ -32,7 +32,7 @@ Various documentation is available to help you get started
 <dependency>
     <groupId>com.azure.resourcemanager</groupId>
     <artifactId>azure-resourcemanager-mysqlflexibleserver</artifactId>
-    <version>1.0.0-beta.4</version>
+    <version>1.0.0-beta.5</version>
 </dependency>
 ```
 [//]: # ({x-version-update-end})
@@ -45,7 +45,7 @@ Azure Management Libraries require a `TokenCredential` implementation for authen
 
 ### Authentication
 
-By default, Azure Active Directory token authentication depends on correct configuration of the following environment variables.
+By default, Microsoft Entra ID token authentication depends on correct configuration of the following environment variables.
 
 - `AZURE_CLIENT_ID` for Azure client ID.
 - `AZURE_TENANT_ID` for Azure tenant ID.
@@ -74,6 +74,15 @@ See [API design][design] for general introduction on design and key concepts on
 
 ## Examples
 
+```java
+server = mysqlManager.servers()
+    .define(serverName)
+    .withRegion(REGION)
+    .withExistingResourceGroup(resourceGroupName)
+    .withAdministratorLogin(adminName)
+    .withAdministratorLoginPassword(adminPwd)
+    .create();
+```
 [Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/SAMPLE.md)
 
 
@@ -94,7 +103,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m
 <!-- LINKS -->
 [survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS
 [docs]: https://azure.github.io/azure-sdk-for-java/
-[jdk]: https://docs.microsoft.com/java/azure/jdk/
+[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/
 [azure_subscription]: https://azure.microsoft.com/free/
 [azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
 [azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty
@@ -103,3 +112,5 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m
 [cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md
 [coc]: https://opensource.microsoft.com/codeofconduct/
 [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
+
+![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fmysqlflexibleserver%2Fazure-resourcemanager-mysqlflexibleserver%2FREADME.png)

sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/SAMPLE.md

@@ -18,7 +18,7 @@
   <packaging>jar</packaging>
 
   <name>Microsoft Azure SDK for MySql Management</name>
-  <description>This package contains Microsoft Azure SDK for MySql Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure MySQL resources including servers, databases, firewall rules, VNET rules, log files and configurations with new business model. Package tag package-flexibleserver-2022-09-30-preview.</description>
+  <description>This package contains Microsoft Azure SDK for MySql Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure MySQL resources including servers, databases, firewall rules, VNET rules, log files and configurations with new business model. Package tag package-flexibleserver-2023-06-30.</description>
   <url>https://github.com/Azure/azure-sdk-for-java</url>
 
   <licenses>
@@ -45,6 +45,7 @@
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <jacoco.min.linecoverage>0</jacoco.min.linecoverage>
     <jacoco.min.branchcoverage>0</jacoco.min.branchcoverage>
+    <revapi.skip>true</revapi.skip>
   </properties>
   <dependencies>
     <dependency>

sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/pom.xml

@@ -35,11 +35,14 @@
 import com.azure.resourcemanager.mysqlflexibleserver.implementation.FirewallRulesImpl;
 import com.azure.resourcemanager.mysqlflexibleserver.implementation.GetPrivateDnsZoneSuffixesImpl;
 import com.azure.resourcemanager.mysqlflexibleserver.implementation.LocationBasedCapabilitiesImpl;
+import com.azure.resourcemanager.mysqlflexibleserver.implementation.LocationBasedCapabilitySetsImpl;
 import com.azure.resourcemanager.mysqlflexibleserver.implementation.LogFilesImpl;
 import com.azure.resourcemanager.mysqlflexibleserver.implementation.MySqlManagementClientBuilder;
+import com.azure.resourcemanager.mysqlflexibleserver.implementation.OperationResultsImpl;
 import com.azure.resourcemanager.mysqlflexibleserver.implementation.OperationsImpl;
 import com.azure.resourcemanager.mysqlflexibleserver.implementation.ReplicasImpl;
 import com.azure.resourcemanager.mysqlflexibleserver.implementation.ServersImpl;
+import com.azure.resourcemanager.mysqlflexibleserver.implementation.ServersMigrationsImpl;
 import com.azure.resourcemanager.mysqlflexibleserver.models.AzureADAdministrators;
 import com.azure.resourcemanager.mysqlflexibleserver.models.BackupAndExports;
 import com.azure.resourcemanager.mysqlflexibleserver.models.Backups;
@@ -51,10 +54,13 @@
 import com.azure.resourcemanager.mysqlflexibleserver.models.FirewallRules;
 import com.azure.resourcemanager.mysqlflexibleserver.models.GetPrivateDnsZoneSuffixes;
 import com.azure.resourcemanager.mysqlflexibleserver.models.LocationBasedCapabilities;
+import com.azure.resourcemanager.mysqlflexibleserver.models.LocationBasedCapabilitySets;
 import com.azure.resourcemanager.mysqlflexibleserver.models.LogFiles;
+import com.azure.resourcemanager.mysqlflexibleserver.models.OperationResults;
 import com.azure.resourcemanager.mysqlflexibleserver.models.Operations;
 import com.azure.resourcemanager.mysqlflexibleserver.models.Replicas;
 import com.azure.resourcemanager.mysqlflexibleserver.models.Servers;
+import com.azure.resourcemanager.mysqlflexibleserver.models.ServersMigrations;
 import java.time.Duration;
 import java.time.temporal.ChronoUnit;
 import java.util.ArrayList;
@@ -84,16 +90,22 @@ public final class MySqlManager {
 
     private Replicas replicas;
 
+    private ServersMigrations serversMigrations;
+
     private LogFiles logFiles;
 
     private LocationBasedCapabilities locationBasedCapabilities;
 
+    private LocationBasedCapabilitySets locationBasedCapabilitySets;
+
     private CheckVirtualNetworkSubnetUsages checkVirtualNetworkSubnetUsages;
 
     private CheckNameAvailabilities checkNameAvailabilities;
 
     private CheckNameAvailabilityWithoutLocations checkNameAvailabilityWithoutLocations;
 
+    private OperationResults operationResults;
+
     private GetPrivateDnsZoneSuffixes getPrivateDnsZoneSuffixes;
 
     private Operations operations;
@@ -263,7 +275,7 @@ public MySqlManager authenticate(TokenCredential credential, AzureProfile profil
                 .append("-")
                 .append("com.azure.resourcemanager.mysqlflexibleserver")
                 .append("/")
-                .append("1.0.0-beta.4");
+                .append("1.0.0-beta.1");
             if (!Configuration.getGlobalConfiguration().get("AZURE_TELEMETRY_DISABLED", false)) {
                 userAgentBuilder
                     .append(" (")
@@ -416,6 +428,18 @@ public Replicas replicas() {
         return replicas;
     }
 
+    /**
+     * Gets the resource collection API of ServersMigrations.
+     *
+     * @return Resource collection API of ServersMigrations.
+     */
+    public ServersMigrations serversMigrations() {
+        if (this.serversMigrations == null) {
+            this.serversMigrations = new ServersMigrationsImpl(clientObject.getServersMigrations(), this);
+        }
+        return serversMigrations;
+    }
+
     /**
      * Gets the resource collection API of LogFiles.
      *
@@ -441,6 +465,19 @@ public LocationBasedCapabilities locationBasedCapabilities() {
         return locationBasedCapabilities;
     }
 
+    /**
+     * Gets the resource collection API of LocationBasedCapabilitySets.
+     *
+     * @return Resource collection API of LocationBasedCapabilitySets.
+     */
+    public LocationBasedCapabilitySets locationBasedCapabilitySets() {
+        if (this.locationBasedCapabilitySets == null) {
+            this.locationBasedCapabilitySets =
+                new LocationBasedCapabilitySetsImpl(clientObject.getLocationBasedCapabilitySets(), this);
+        }
+        return locationBasedCapabilitySets;
+    }
+
     /**
      * Gets the resource collection API of CheckVirtualNetworkSubnetUsages.
      *
@@ -481,6 +518,18 @@ public CheckNameAvailabilityWithoutLocations checkNameAvailabilityWithoutLocatio
         return checkNameAvailabilityWithoutLocations;
     }
 
+    /**
+     * Gets the resource collection API of OperationResults.
+     *
+     * @return Resource collection API of OperationResults.
+     */
+    public OperationResults operationResults() {
+        if (this.operationResults == null) {
+            this.operationResults = new OperationResultsImpl(clientObject.getOperationResults(), this);
+        }
+        return operationResults;
+    }
+
     /**
      * Gets the resource collection API of GetPrivateDnsZoneSuffixes.
      *
@@ -507,8 +556,10 @@ public Operations operations() {
     }
 
     /**
-     * @return Wrapped service client MySqlManagementClient providing direct access to the underlying auto-generated API
-     *     implementation, based on Azure REST API.
+     * Gets wrapped service client MySqlManagementClient providing direct access to the underlying auto-generated API
+     * implementation, based on Azure REST API.
+     *
+     * @return Wrapped service client MySqlManagementClient.
      */
     public MySqlManagementClient serviceClient() {
         return this.clientObject;

sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/src/main/java/com/azure/resourcemanager/mysqlflexibleserver/MySqlManager.java

@@ -0,0 +1,69 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.resourcemanager.mysqlflexibleserver.fluent;
+
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.http.rest.PagedIterable;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.Context;
+import com.azure.resourcemanager.mysqlflexibleserver.fluent.models.CapabilityInner;
+
+/** An instance of this class provides access to all the operations defined in LocationBasedCapabilitySetsClient. */
+public interface LocationBasedCapabilitySetsClient {
+    /**
+     * Get capabilities at specified location in a given subscription.
+     *
+     * @param locationName The name of the location.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return capabilities at specified location in a given subscription as paginated response with {@link
+     *     PagedIterable}.
+     */
+    @ServiceMethod(returns = ReturnType.COLLECTION)
+    PagedIterable<CapabilityInner> list(String locationName);
+
+    /**
+     * Get capabilities at specified location in a given subscription.
+     *
+     * @param locationName The name of the location.
+     * @param context The context to associate with this operation.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return capabilities at specified location in a given subscription as paginated response with {@link
+     *     PagedIterable}.
+     */
+    @ServiceMethod(returns = ReturnType.COLLECTION)
+    PagedIterable<CapabilityInner> list(String locationName, Context context);
+
+    /**
+     * Get capabilities at specified location in a given subscription.
+     *
+     * @param locationName The name of the location.
+     * @param capabilitySetName Name of capability set.
+     * @param context The context to associate with this operation.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return capabilities at specified location in a given subscription along with {@link Response}.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    Response<CapabilityInner> getWithResponse(String locationName, String capabilitySetName, Context context);
+
+    /**
+     * Get capabilities at specified location in a given subscription.
+     *
+     * @param locationName The name of the location.
+     * @param capabilitySetName Name of capability set.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return capabilities at specified location in a given subscription.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    CapabilityInner get(String locationName, String capabilitySetName);
+}

sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/src/main/java/com/azure/resourcemanager/mysqlflexibleserver/fluent/LocationBasedCapabilitySetsClient.java

@@ -10,7 +10,7 @@
 /** The interface for MySqlManagementClient class. */
 public interface MySqlManagementClient {
     /**
-     * Gets The ID of the target subscription.
+     * Gets The ID of the target subscription. The value must be an UUID.
      *
      * @return the subscriptionId value.
      */
@@ -23,6 +23,13 @@ public interface MySqlManagementClient {
      */
     String getEndpoint();
 
+    /**
+     * Gets Api Version.
+     *
+     * @return the apiVersion value.
+     */
+    String getApiVersion();
+
     /**
      * Gets The HTTP pipeline to send requests through.
      *
@@ -93,6 +100,13 @@ public interface MySqlManagementClient {
      */
     ReplicasClient getReplicas();
 
+    /**
+     * Gets the ServersMigrationsClient object to access its operations.
+     *
+     * @return the ServersMigrationsClient object.
+     */
+    ServersMigrationsClient getServersMigrations();
+
     /**
      * Gets the LogFilesClient object to access its operations.
      *
@@ -107,6 +121,13 @@ public interface MySqlManagementClient {
      */
     LocationBasedCapabilitiesClient getLocationBasedCapabilities();
 
+    /**
+     * Gets the LocationBasedCapabilitySetsClient object to access its operations.
+     *
+     * @return the LocationBasedCapabilitySetsClient object.
+     */
+    LocationBasedCapabilitySetsClient getLocationBasedCapabilitySets();
+
     /**
      * Gets the CheckVirtualNetworkSubnetUsagesClient object to access its operations.
      *
@@ -128,6 +149,13 @@ public interface MySqlManagementClient {
      */
     CheckNameAvailabilityWithoutLocationsClient getCheckNameAvailabilityWithoutLocations();
 
+    /**
+     * Gets the OperationResultsClient object to access its operations.
+     *
+     * @return the OperationResultsClient object.
+     */
+    OperationResultsClient getOperationResults();
+
     /**
      * Gets the GetPrivateDnsZoneSuffixesClient object to access its operations.
      *

sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/src/main/java/com/azure/resourcemanager/mysqlflexibleserver/fluent/MySqlManagementClient.java

@@ -0,0 +1,42 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.resourcemanager.mysqlflexibleserver.fluent;
+
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.Context;
+import com.azure.resourcemanager.mysqlflexibleserver.fluent.models.OperationStatusExtendedResultInner;
+
+/** An instance of this class provides access to all the operations defined in OperationResultsClient. */
+public interface OperationResultsClient {
+    /**
+     * Get the operation result for a long running operation.
+     *
+     * @param locationName The name of the location.
+     * @param operationId The operation Id.
+     * @param context The context to associate with this operation.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return the operation result for a long running operation along with {@link Response}.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    Response<OperationStatusExtendedResultInner> getWithResponse(
+        String locationName, String operationId, Context context);
+
+    /**
+     * Get the operation result for a long running operation.
+     *
+     * @param locationName The name of the location.
+     * @param operationId The operation Id.
+     * @throws IllegalArgumentException thrown if parameters fail the validation.
+     * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
+     * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
+     * @return the operation result for a long running operation.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    OperationStatusExtendedResultInner get(String locationName, String operationId);
+}