[AutoPR azure-resourcemanager-fluidrelay] Merge from main, update to feature branch Compute 2022-01-03

eng/versioning/version_client.txt

@@ -340,6 +340,7 @@ com.azure.resourcemanager:azure-resourcemanager-securityinsights;1.0.0-beta.1;1.
 com.azure.resourcemanager:azure-resourcemanager-oep;1.0.0-beta.1;1.0.0-beta.2
 com.azure.resourcemanager:azure-resourcemanager-dnsresolver;1.0.0-beta.1;1.0.0-beta.2
 com.azure.resourcemanager:azure-resourcemanager-mobilenetwork;1.0.0-beta.1;1.0.0-beta.2
+com.azure.resourcemanager:azure-resourcemanager-fluidrelay;1.0.0-beta.1;1.0.0-beta.1
 com.azure.tools:azure-sdk-archetype;1.0.0;1.0.0
 com.azure.tools:azure-sdk-build-tool;1.0.0-beta.1;1.0.0-beta.1
 

pom.xml

@@ -894,6 +894,7 @@
         <module>sdk/eventgrid</module>
         <module>sdk/eventhubs</module>
         <module>sdk/extendedlocation</module>
+        <module>sdk/fluidrelay</module>
         <module>sdk/formrecognizer</module>
         <module>sdk/frontdoor</module>
         <module>sdk/hanaonazure</module>

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

@@ -0,0 +1,5 @@
+# Release History
+
+## 1.0.0-beta.1 (2022-03-14)
+
+- Azure Resource Manager FluidRelay client library for Java. This package contains Microsoft Azure SDK for FluidRelay Management SDK.  Package tag package-2021-06-15-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).

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

@@ -0,0 +1,102 @@
+# Azure Resource Manager FluidRelay client library for Java
+
+Azure Resource Manager FluidRelay client library for Java.
+
+This package contains Microsoft Azure SDK for FluidRelay Management SDK.  Package tag package-2021-06-15-preview. 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
+
+We're always working on improving our products and the way we communicate with our users. So we'd love to learn what's working and how we can do better.
+
+If you haven't already, please take a few minutes to [complete this short survey][survey] we have put together.
+
+Thank you in advance for your collaboration. We really appreciate your time!
+
+## Documentation
+
+Various documentation is available to help you get started
+
+- [API reference documentation][docs]
+
+## Getting started
+
+### Prerequisites
+
+- [Java Development Kit (JDK)][jdk] with version 8 or above
+- [Azure Subscription][azure_subscription]
+
+### Adding the package to your product
+
+[//]: # ({x-version-update-start;com.azure.resourcemanager:azure-resourcemanager-fluidrelay;current})
+```xml
+<dependency>
+    <groupId>com.azure.resourcemanager</groupId>
+    <artifactId>azure-resourcemanager-fluidrelay</artifactId>
+    <version>1.0.0-beta.1</version>
+</dependency>
+```
+[//]: # ({x-version-update-end})
+
+### Include the recommended packages
+
+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.
+
+### Authentication
+
+By default, Azure Active Directory 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` 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`.
+
+With above configuration, `azure` client can be authenticated by following code:
+
+```java
+AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
+TokenCredential credential = new DefaultAzureCredentialBuilder()
+    .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
+    .build();
+FluidRelayManager manager = FluidRelayManager
+    .authenticate(credential, profile);
+```
+
+The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise.
+
+See [Authentication][authenticate] for more options.
+
+## Key concepts
+
+See [API design][design] for general introduction on design and key concepts on Azure Management Libraries.
+
+## Examples
+
+[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/fluidrelay/azure-resourcemanager-fluidrelay/SAMPLE.md)
+
+
+## Troubleshooting
+
+## Next steps
+
+## Contributing
+
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
+
+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
+
+<!-- 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/
+[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
+[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

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

@@ -0,0 +1,259 @@
+# Code snippets and samples
+
+
+## FluidRelayOperations
+
+- [List](#fluidrelayoperations_list)
+
+## FluidRelayServers
+
+- [CreateOrUpdate](#fluidrelayservers_createorupdate)
+- [Delete](#fluidrelayservers_delete)
+- [GetByResourceGroup](#fluidrelayservers_getbyresourcegroup)
+- [GetKeys](#fluidrelayservers_getkeys)
+- [List](#fluidrelayservers_list)
+- [ListByResourceGroup](#fluidrelayservers_listbyresourcegroup)
+- [RegenerateKey](#fluidrelayservers_regeneratekey)
+- [Update](#fluidrelayservers_update)
+### FluidRelayOperations_List
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for FluidRelayOperations List. */
+public final class FluidRelayOperationsListSamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServerOperations.json
+     */
+    /**
+     * Sample code: List Fluid Relay server operations.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void listFluidRelayServerOperations(com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        manager.fluidRelayOperations().list(Context.NONE);
+    }
+}
+```
+
+### FluidRelayServers_CreateOrUpdate
+
+```java
+import com.azure.resourcemanager.fluidrelay.models.Identity;
+import com.azure.resourcemanager.fluidrelay.models.ResourceIdentityType;
+import java.util.HashMap;
+import java.util.Map;
+
+/** Samples for FluidRelayServers CreateOrUpdate. */
+public final class FluidRelayServersCreateOrUpdateSamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServers_CreateOrUpdate.json
+     */
+    /**
+     * Sample code: Create a Fluid Relay server.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void createAFluidRelayServer(com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        manager
+            .fluidRelayServers()
+            .define("myFluidRelayServer")
+            .withRegion("west-us")
+            .withExistingResourceGroup("myResourceGroup")
+            .withTags(mapOf("Category", "sales"))
+            .withIdentity(new Identity().withType(ResourceIdentityType.SYSTEM_ASSIGNED))
+            .create();
+    }
+
+    @SuppressWarnings("unchecked")
+    private static <T> Map<String, T> mapOf(Object... inputs) {
+        Map<String, T> map = new HashMap<>();
+        for (int i = 0; i < inputs.length; i += 2) {
+            String key = (String) inputs[i];
+            T value = (T) inputs[i + 1];
+            map.put(key, value);
+        }
+        return map;
+    }
+}
+```
+
+### FluidRelayServers_Delete
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for FluidRelayServers Delete. */
+public final class FluidRelayServersDeleteSamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServers_Delete.json
+     */
+    /**
+     * Sample code: Delete a Fluid Relay server.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void deleteAFluidRelayServer(com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        manager.fluidRelayServers().deleteWithResponse("myResourceGroup", "myFluidRelayServer", Context.NONE);
+    }
+}
+```
+
+### FluidRelayServers_GetByResourceGroup
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for FluidRelayServers GetByResourceGroup. */
+public final class FluidRelayServersGetByResourceGroupSamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServers_Get.json
+     */
+    /**
+     * Sample code: Get Fluid Relay server details.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void getFluidRelayServerDetails(com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        manager
+            .fluidRelayServers()
+            .getByResourceGroupWithResponse("myResourceGroup", "myFluidRelayServer", Context.NONE);
+    }
+}
+```
+
+### FluidRelayServers_GetKeys
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for FluidRelayServers GetKeys. */
+public final class FluidRelayServersGetKeysSamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServers_GetKeys.json
+     */
+    /**
+     * Sample code: Get keys for a Fluid Relay server.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void getKeysForAFluidRelayServer(com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        manager.fluidRelayServers().getKeysWithResponse("myResourceGroup", "myFluidRelayServer", Context.NONE);
+    }
+}
+```
+
+### FluidRelayServers_List
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for FluidRelayServers List. */
+public final class FluidRelayServersListSamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServers_ListBySubscription.json
+     */
+    /**
+     * Sample code: List all Fluid Relay servers in a subscription.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void listAllFluidRelayServersInASubscription(
+        com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        manager.fluidRelayServers().list(Context.NONE);
+    }
+}
+```
+
+### FluidRelayServers_ListByResourceGroup
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for FluidRelayServers ListByResourceGroup. */
+public final class FluidRelayServersListByResourceGroupSamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServers_ListByResourceGroup.json
+     */
+    /**
+     * Sample code: List all Fluid Relay servers in a resource group.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void listAllFluidRelayServersInAResourceGroup(
+        com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        manager.fluidRelayServers().listByResourceGroup("myResourceGroup", Context.NONE);
+    }
+}
+```
+
+### FluidRelayServers_RegenerateKey
+
+```java
+import com.azure.core.util.Context;
+import com.azure.resourcemanager.fluidrelay.models.KeyName;
+import com.azure.resourcemanager.fluidrelay.models.RegenerateKeyRequest;
+
+/** Samples for FluidRelayServers RegenerateKey. */
+public final class FluidRelayServersRegenerateKeySamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServers_RegenerateKeys.json
+     */
+    /**
+     * Sample code: Regenerate keys for a Fluid Relay server.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void regenerateKeysForAFluidRelayServer(
+        com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        manager
+            .fluidRelayServers()
+            .regenerateKeyWithResponse(
+                "myResourceGroup",
+                "myFluidRelayServer",
+                new RegenerateKeyRequest().withKeyName(KeyName.KEY1),
+                Context.NONE);
+    }
+}
+```
+
+### FluidRelayServers_Update
+
+```java
+import com.azure.core.util.Context;
+import com.azure.resourcemanager.fluidrelay.models.FluidRelayServer;
+import java.util.HashMap;
+import java.util.Map;
+
+/** Samples for FluidRelayServers Update. */
+public final class FluidRelayServersUpdateSamples {
+    /*
+     * x-ms-original-file: specification/fluidrelay/resource-manager/Microsoft.FluidRelay/preview/2021-06-15-preview/examples/FluidRelayServers_Update.json
+     */
+    /**
+     * Sample code: Create a Fluid Relay server.
+     *
+     * @param manager Entry point to FluidRelayManager.
+     */
+    public static void createAFluidRelayServer(com.azure.resourcemanager.fluidrelay.FluidRelayManager manager) {
+        FluidRelayServer resource =
+            manager
+                .fluidRelayServers()
+                .getByResourceGroupWithResponse("myResourceGroup", "myFluidRelayServer", Context.NONE)
+                .getValue();
+        resource.update().withTags(mapOf("Category", "sales")).apply();
+    }
+
+    @SuppressWarnings("unchecked")
+    private static <T> Map<String, T> mapOf(Object... inputs) {
+        Map<String, T> map = new HashMap<>();
+        for (int i = 0; i < inputs.length; i += 2) {
+            String key = (String) inputs[i];
+            T value = (T) inputs[i + 1];
+            map.put(key, value);
+        }
+        return map;
+    }
+}
+```
+