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

Updated agfood.json for privatelinks (Azure#21293) * updating common-types to v4 * resolved modelValidation for idFormat & apiVersion * modelValidation for extensions * modelValidation resolved for operationList Co-authored-by: IshitaAsthana <iasthana@microsoft.com>
azure-sdk · Nov 17, 2022 · 3bba10c · 3bba10c
1 parent 9a5bde7
commit 3bba10c
Show file tree

Hide file tree

Showing 112 changed files with 1,339 additions and 2,392 deletions.
diff --git a/sdk/agrifood/azure-resourcemanager-agrifood/CHANGELOG.md b/sdk/agrifood/azure-resourcemanager-agrifood/CHANGELOG.md
@@ -1,6 +1,8 @@
 # Release History
 
-## 1.0.0-beta.2 (Unreleased)
+## 1.0.0-beta.1 (2022-11-17)
+
+- Azure Resource Manager AgriFood client library for Java. This package contains Microsoft Azure SDK for AgriFood Management SDK. APIs documentation for Azure AgFoodPlatform Resource Provider Service. Package tag package-preview-2021-09. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
 
 ### Features Added
 

diff --git a/sdk/agrifood/azure-resourcemanager-agrifood/README.md b/sdk/agrifood/azure-resourcemanager-agrifood/README.md
@@ -32,7 +32,7 @@ Various documentation is available to help you get started
 <dependency>
     <groupId>com.azure.resourcemanager</groupId>
     <artifactId>azure-resourcemanager-agrifood</artifactId>
-    <version>1.0.0-beta.1</version>
+    <version>1.0.0-beta.2</version>
 </dependency>
 ```
 [//]: # ({x-version-update-end})
@@ -41,19 +41,19 @@ Various documentation is available to help you get started
 
 Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client.
 
-[Azure Identity][azure_identity] package and [Azure Core Netty HTTP][azure_core_http_netty] package provide the default implementation.
+[Azure Identity][azure_identity] and [Azure Core Netty HTTP][azure_core_http_netty] packages provide the default implementation.
 
 ### Authentication
 
-By default, Azure Active Directory token authentication depends on correct configure of following environment variables.
+By default, Azure Active Directory 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.
 - `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate.
 
-In addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`.
+In addition, Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable.
 
-With above configuration, `azure` client can be authenticated by following code:
+With above configuration, `azure` client can be authenticated using the following code:
 
 ```java
 AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
@@ -83,13 +83,13 @@ See [API design][design] for general introduction on design and key concepts on
 
 ## Contributing
 
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide][cg].
 
-1. Fork it
-1. Create your feature branch (`git checkout -b my-new-feature`)
-1. Commit your changes (`git commit -am 'Add some feature'`)
-1. Push to the branch (`git push origin my-new-feature`)
-1. Create new Pull Request
+This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit <https://cla.microsoft.com>.
+
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information see the [Code of Conduct FAQ][coc_faq] or contact <opencode@microsoft.com> with any additional questions or comments.
 
 <!-- LINKS -->
 [survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS
@@ -100,3 +100,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 [azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty
 [authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md
 [design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md
+[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/
diff --git a/sdk/agrifood/azure-resourcemanager-agrifood/SAMPLE.md b/sdk/agrifood/azure-resourcemanager-agrifood/SAMPLE.md
@@ -3,11 +3,10 @@
 
 ## Extensions
 
-- [Create](#extensions_create)
+- [CreateOrUpdate](#extensions_createorupdate)
 - [Delete](#extensions_delete)
 - [Get](#extensions_get)
 - [ListByFarmBeats](#extensions_listbyfarmbeats)
-- [Update](#extensions_update)
 
 ## FarmBeatsExtensions
 
@@ -43,25 +42,25 @@
 
 - [Get](#privatelinkresources_get)
 - [ListByResource](#privatelinkresources_listbyresource)
-### Extensions_Create
+### Extensions_CreateOrUpdate
 
 ```java
-import com.azure.core.util.Context;
-
-/** Samples for Extensions Create. */
-public final class ExtensionsCreateSamples {
+/** Samples for Extensions CreateOrUpdate. */
+public final class ExtensionsCreateOrUpdateSamples {
     /*
-     * x-ms-original-file: specification/agrifood/resource-manager/Microsoft.AgFoodPlatform/preview/2021-09-01-preview/examples/Extensions_Create.json
+     * x-ms-original-file: specification/agrifood/resource-manager/Microsoft.AgFoodPlatform/preview/2021-09-01-preview/examples/Extensions_CreateOrUpdate.json
      */
     /**
-     * Sample code: Extensions_Create.
+     * Sample code: Extensions_CreateOrUpdate.
      *
      * @param manager Entry point to AgriFoodManager.
      */
-    public static void extensionsCreate(com.azure.resourcemanager.agrifood.AgriFoodManager manager) {
+    public static void extensionsCreateOrUpdate(com.azure.resourcemanager.agrifood.AgriFoodManager manager) {
         manager
             .extensions()
-            .createWithResponse("examples-rg", "examples-farmbeatsResourceName", "provider.extension", Context.NONE);
+            .define("provider.extension")
+            .withExistingFarmBeat("examples-rg", "examples-farmbeatsResourceName")
+            .create();
     }
 }
 ```
@@ -135,29 +134,6 @@ public final class ExtensionsListByFarmBeatsSamples {
 }
 ```
 
-### Extensions_Update
-
-```java
-import com.azure.core.util.Context;
-
-/** Samples for Extensions Update. */
-public final class ExtensionsUpdateSamples {
-    /*
-     * x-ms-original-file: specification/agrifood/resource-manager/Microsoft.AgFoodPlatform/preview/2021-09-01-preview/examples/Extensions_Update.json
-     */
-    /**
-     * Sample code: Extensions_Update.
-     *
-     * @param manager Entry point to AgriFoodManager.
-     */
-    public static void extensionsUpdate(com.azure.resourcemanager.agrifood.AgriFoodManager manager) {
-        manager
-            .extensions()
-            .updateWithResponse("examples-rg", "examples-farmbeatsResourceName", "provider.extension", Context.NONE);
-    }
-}
-```
-
 ### FarmBeatsExtensions_Get
 
 ```java
@@ -255,7 +231,9 @@ public final class FarmBeatsModelsDeleteSamples {
      * @param manager Entry point to AgriFoodManager.
      */
     public static void farmBeatsModelsDelete(com.azure.resourcemanager.agrifood.AgriFoodManager manager) {
-        manager.farmBeatsModels().deleteWithResponse("examples-rg", "examples-farmBeatsResourceName", Context.NONE);
+        manager
+            .farmBeatsModels()
+            .deleteByResourceGroupWithResponse("examples-rg", "examples-farmBeatsResourceName", Context.NONE);
     }
 }
 ```

diff --git a/...rcemanager-agrifood/src/main/java/com/azure/resourcemanager/agrifood/AgriFoodManager.java b/...rcemanager-agrifood/src/main/java/com/azure/resourcemanager/agrifood/AgriFoodManager.java
@@ -44,6 +44,7 @@
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
+import java.util.UUID;
 import java.util.stream.Collectors;
 
 /** Entry point to AgriFoodManager. APIs documentation for Azure AgFoodPlatform Resource Provider Service. */
@@ -71,7 +72,7 @@ private AgriFoodManager(HttpPipeline httpPipeline, AzureProfile profile, Duratio
             new AgriFoodManagementClientBuilder()
                 .pipeline(httpPipeline)
                 .endpoint(profile.getEnvironment().getResourceManagerEndpoint())
-                .subscriptionId(profile.getSubscriptionId())
+                .subscriptionId(UUID.fromString(profile.getSubscriptionId()))
                 .defaultPollInterval(defaultPollInterval)
                 .buildClient();
     }
@@ -285,7 +286,7 @@ public AgriFoodManager authenticate(TokenCredential credential, AzureProfile pro
     }
 
     /**
-     * Gets the resource collection API of Extensions.
+     * Gets the resource collection API of Extensions. It manages Extension.
      *
      * @return Resource collection API of Extensions.
      */

diff --git a/...ood/src/main/java/com/azure/resourcemanager/agrifood/fluent/AgriFoodManagementClient.java b/...ood/src/main/java/com/azure/resourcemanager/agrifood/fluent/AgriFoodManagementClient.java
@@ -6,15 +6,16 @@
 
 import com.azure.core.http.HttpPipeline;
 import java.time.Duration;
+import java.util.UUID;
 
 /** The interface for AgriFoodManagementClient class. */
 public interface AgriFoodManagementClient {
     /**
-     * Gets The ID of the target subscription.
+     * Gets The ID of the target subscription. The value must be an UUID.
      *
      * @return the subscriptionId value.
      */
-    String getSubscriptionId();
+    UUID getSubscriptionId();
 
     /**
      * Gets server parameter.

diff --git a/...er-agrifood/src/main/java/com/azure/resourcemanager/agrifood/fluent/ExtensionsClient.java b/...er-agrifood/src/main/java/com/azure/resourcemanager/agrifood/fluent/ExtensionsClient.java
@@ -10,53 +10,47 @@
 import com.azure.core.http.rest.Response;
 import com.azure.core.util.Context;
 import com.azure.resourcemanager.agrifood.fluent.models.ExtensionInner;
+import com.azure.resourcemanager.agrifood.models.ExtensionInstallationRequest;
 import java.util.List;
 
 /** An instance of this class provides access to all the operations defined in ExtensionsClient. */
 public interface ExtensionsClient {
     /**
-     * Install extension.
-     *
-     * @param resourceGroupName The name of the resource group. The name is case insensitive.
-     * @param farmBeatsResourceName FarmBeats resource name.
-     * @param extensionId Id of extension resource.
-     * @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 extension resource.
-     */
-    @ServiceMethod(returns = ReturnType.SINGLE)
-    ExtensionInner create(String resourceGroupName, String farmBeatsResourceName, String extensionId);
-
-    /**
-     * Install extension.
+     * Install or Update extension. AdditionalApiProperties are merged patch and if the extension is updated to a new
+     * version then the obsolete entries will be auto deleted from AdditionalApiProperties.
      *
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param farmBeatsResourceName FarmBeats resource name.
      * @param extensionId Id of extension resource.
+     * @param requestBody Extension resource request body.
      * @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 extension resource along with {@link Response}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Response<ExtensionInner> createWithResponse(
-        String resourceGroupName, String farmBeatsResourceName, String extensionId, Context context);
+    Response<ExtensionInner> createOrUpdateWithResponse(
+        String resourceGroupName,
+        String farmBeatsResourceName,
+        String extensionId,
+        ExtensionInstallationRequest requestBody,
+        Context context);
 
     /**
-     * Get installed extension details by extension id.
+     * Install or Update extension. AdditionalApiProperties are merged patch and if the extension is updated to a new
+     * version then the obsolete entries will be auto deleted from AdditionalApiProperties.
      *
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param farmBeatsResourceName FarmBeats resource name.
      * @param extensionId Id of extension resource.
      * @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 installed extension details by extension id.
+     * @return extension resource.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    ExtensionInner get(String resourceGroupName, String farmBeatsResourceName, String extensionId);
+    ExtensionInner createOrUpdate(String resourceGroupName, String farmBeatsResourceName, String extensionId);
 
     /**
      * Get installed extension details by extension id.
@@ -75,21 +69,21 @@ Response<ExtensionInner> getWithResponse(
         String resourceGroupName, String farmBeatsResourceName, String extensionId, Context context);
 
     /**
-     * Upgrade to latest extension.
+     * Get installed extension details by extension id.
      *
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param farmBeatsResourceName FarmBeats resource name.
      * @param extensionId Id of extension resource.
      * @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 extension resource.
+     * @return installed extension details by extension id.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    ExtensionInner update(String resourceGroupName, String farmBeatsResourceName, String extensionId);
+    ExtensionInner get(String resourceGroupName, String farmBeatsResourceName, String extensionId);
 
     /**
-     * Upgrade to latest extension.
+     * Uninstall extension.
      *
      * @param resourceGroupName The name of the resource group. The name is case insensitive.
      * @param farmBeatsResourceName FarmBeats resource name.
@@ -98,10 +92,10 @@ Response<ExtensionInner> getWithResponse(
      * @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 extension resource along with {@link Response}.
+     * @return the {@link Response}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Response<ExtensionInner> updateWithResponse(
+    Response<Void> deleteWithResponse(
         String resourceGroupName, String farmBeatsResourceName, String extensionId, Context context);
 
     /**
@@ -117,22 +111,6 @@ Response<ExtensionInner> updateWithResponse(
     @ServiceMethod(returns = ReturnType.SINGLE)
     void delete(String resourceGroupName, String farmBeatsResourceName, String extensionId);
 
-    /**
-     * Uninstall extension.
-     *
-     * @param resourceGroupName The name of the resource group. The name is case insensitive.
-     * @param farmBeatsResourceName FarmBeats resource name.
-     * @param extensionId Id of extension resource.
-     * @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 {@link Response}.
-     */
-    @ServiceMethod(returns = ReturnType.SINGLE)
-    Response<Void> deleteWithResponse(
-        String resourceGroupName, String farmBeatsResourceName, String extensionId, Context context);
-
     /**
      * Get installed extensions details.
      *

diff --git a/...od/src/main/java/com/azure/resourcemanager/agrifood/fluent/FarmBeatsExtensionsClient.java b/...od/src/main/java/com/azure/resourcemanager/agrifood/fluent/FarmBeatsExtensionsClient.java
@@ -51,24 +51,24 @@ PagedIterable<FarmBeatsExtensionInner> list(
      * Get farmBeats extension.
      *
      * @param farmBeatsExtensionId farmBeatsExtensionId to be queried.
+     * @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 farmBeats extension.
+     * @return farmBeats extension along with {@link Response}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    FarmBeatsExtensionInner get(String farmBeatsExtensionId);
+    Response<FarmBeatsExtensionInner> getWithResponse(String farmBeatsExtensionId, Context context);
 
     /**
      * Get farmBeats extension.
      *
      * @param farmBeatsExtensionId farmBeatsExtensionId to be queried.
-     * @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 farmBeats extension along with {@link Response}.
+     * @return farmBeats extension.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Response<FarmBeatsExtensionInner> getWithResponse(String farmBeatsExtensionId, Context context);
+    FarmBeatsExtensionInner get(String farmBeatsExtensionId);
 }