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

Migrate to net track2 for some resource-manager readmes (Azure#18996) * migrate to net track2 for some mgmt RPs * Update readme.md
azure-sdk · May 13, 2022 · 5c16949 · 5c16949
1 parent ecb9fbd
commit 5c16949
Show file tree

Hide file tree

Showing 56 changed files with 5,921 additions and 0 deletions.
diff --git a/eng/versioning/version_client.txt b/eng/versioning/version_client.txt
@@ -340,6 +340,7 @@ com.azure.resourcemanager:azure-resourcemanager-servicelinker;1.0.0-beta.1;1.0.0
 com.azure.resourcemanager:azure-resourcemanager-appcontainers;1.0.0-beta.2;1.0.0-beta.3
 com.azure.resourcemanager:azure-resourcemanager-scvmm;1.0.0-beta.1;1.0.0-beta.2
 com.azure.resourcemanager:azure-resourcemanager-hardwaresecuritymodules;1.0.0-beta.1;1.0.0-beta.2
+com.azure.resourcemanager:azure-resourcemanager-hybridconnectivity;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.2
 

diff --git a/pom.xml b/pom.xml
@@ -906,6 +906,7 @@
         <module>sdk/healthbot</module>
         <module>sdk/healthcareapis</module>
         <module>sdk/hybridcompute</module>
+        <module>sdk/hybridconnectivity</module>
         <module>sdk/hybridkubernetes</module>
         <module>sdk/hybridnetwork</module>
         <module>sdk/identity</module>

diff --git a/sdk/hybridconnectivity/azure-resourcemanager-hybridconnectivity/CHANGELOG.md b/sdk/hybridconnectivity/azure-resourcemanager-hybridconnectivity/CHANGELOG.md
@@ -0,0 +1,5 @@
+# Release History
+
+## 1.0.0-beta.1 (2022-05-13)
+
+- Azure Resource Manager HybridConnectivity client library for Java. This package contains Microsoft Azure SDK for HybridConnectivity Management SDK. REST API for Hybrid Connectivity. Package tag package-2022-05-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
diff --git a/sdk/hybridconnectivity/azure-resourcemanager-hybridconnectivity/README.md b/sdk/hybridconnectivity/azure-resourcemanager-hybridconnectivity/README.md
@@ -0,0 +1,102 @@
+# Azure Resource Manager HybridConnectivity client library for Java
+
+Azure Resource Manager HybridConnectivity client library for Java.
+
+This package contains Microsoft Azure SDK for HybridConnectivity Management SDK. REST API for Hybrid Connectivity. Package tag package-2022-05-01-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-hybridconnectivity;current})
+```xml
+<dependency>
+    <groupId>com.azure.resourcemanager</groupId>
+    <artifactId>azure-resourcemanager-hybridconnectivity</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();
+HybridConnectivityManager manager = HybridConnectivityManager
+    .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/hybridconnectivity/azure-resourcemanager-hybridconnectivity/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
diff --git a/sdk/hybridconnectivity/azure-resourcemanager-hybridconnectivity/SAMPLE.md b/sdk/hybridconnectivity/azure-resourcemanager-hybridconnectivity/SAMPLE.md
@@ -0,0 +1,274 @@
+# Code snippets and samples
+
+
+## Endpoints
+
+- [CreateOrUpdate](#endpoints_createorupdate)
+- [Delete](#endpoints_delete)
+- [Get](#endpoints_get)
+- [List](#endpoints_list)
+- [ListCredentials](#endpoints_listcredentials)
+- [ListManagedProxyDetails](#endpoints_listmanagedproxydetails)
+- [Update](#endpoints_update)
+
+## Operations
+
+- [List](#operations_list)
+### Endpoints_CreateOrUpdate
+
+```java
+import com.azure.resourcemanager.hybridconnectivity.models.Type;
+
+/** Samples for Endpoints CreateOrUpdate. */
+public final class EndpointsCreateOrUpdateSamples {
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsPutCustom.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsPutCustom.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsPutCustom(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager
+            .endpoints()
+            .define("custom")
+            .withExistingResourceUri(
+                "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.HybridCompute/machines/testMachine")
+            .withTypePropertiesType(Type.CUSTOM)
+            .withResourceId(
+                "/subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.Relay/namespaces/custom-relay-namespace")
+            .create();
+    }
+
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsPutDefault.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsPutDefault.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsPutDefault(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager
+            .endpoints()
+            .define("default")
+            .withExistingResourceUri(
+                "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.HybridCompute/machines/testMachine")
+            .withTypePropertiesType(Type.DEFAULT)
+            .create();
+    }
+}
+```
+
+### Endpoints_Delete
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Endpoints Delete. */
+public final class EndpointsDeleteSamples {
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsDeleteDefault.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsDeleteDefault.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsDeleteDefault(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager
+            .endpoints()
+            .deleteWithResponse(
+                "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.HybridCompute/machines/testMachine",
+                "default",
+                Context.NONE);
+    }
+}
+```
+
+### Endpoints_Get
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Endpoints Get. */
+public final class EndpointsGetSamples {
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsGetDefault.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsGetDefault.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsGetDefault(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager
+            .endpoints()
+            .getWithResponse(
+                "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.HybridCompute/machines/testMachine",
+                "default",
+                Context.NONE);
+    }
+
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsGetCustom.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsGetCustom.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsGetCustom(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager
+            .endpoints()
+            .getWithResponse(
+                "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.HybridCompute/machines/testMachine",
+                "custom",
+                Context.NONE);
+    }
+}
+```
+
+### Endpoints_List
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Endpoints List. */
+public final class EndpointsListSamples {
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsList.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsGet.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsGet(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager
+            .endpoints()
+            .list(
+                "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.HybridCompute/machines/testMachine",
+                Context.NONE);
+    }
+}
+```
+
+### Endpoints_ListCredentials
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Endpoints ListCredentials. */
+public final class EndpointsListCredentialsSamples {
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsPostListCredentials.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsPostListCredentials.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsPostListCredentials(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager
+            .endpoints()
+            .listCredentialsWithResponse(
+                "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.HybridCompute/machines/testMachine",
+                "default",
+                10800L,
+                Context.NONE);
+    }
+}
+```
+
+### Endpoints_ListManagedProxyDetails
+
+```java
+import com.azure.core.util.Context;
+import com.azure.resourcemanager.hybridconnectivity.models.ManagedProxyRequest;
+
+/** Samples for Endpoints ListManagedProxyDetails. */
+public final class EndpointsListManagedProxyDetailsSamples {
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsPostListManagedProxyDetails.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsPostListManagedProxyDetails.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsPostListManagedProxyDetails(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager
+            .endpoints()
+            .listManagedProxyDetailsWithResponse(
+                "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/arcGroup/providers/Microsoft.Compute/virtualMachines/vm00006",
+                "default",
+                new ManagedProxyRequest().withService("127.0.0.1:65035").withHostname("r.proxy.arc.com"),
+                Context.NONE);
+    }
+}
+```
+
+### Endpoints_Update
+
+```java
+import com.azure.core.util.Context;
+import com.azure.resourcemanager.hybridconnectivity.models.EndpointResource;
+import com.azure.resourcemanager.hybridconnectivity.models.Type;
+
+/** Samples for Endpoints Update. */
+public final class EndpointsUpdateSamples {
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/EndpointsPatchDefault.json
+     */
+    /**
+     * Sample code: HybridConnectivityEndpointsPatchDefault.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityEndpointsPatchDefault(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        EndpointResource resource =
+            manager
+                .endpoints()
+                .getWithResponse(
+                    "subscriptions/f5bcc1d9-23af-4ae9-aca1-041d0f593a63/resourceGroups/hybridRG/providers/Microsoft.HybridCompute/machines/testMachine",
+                    "default",
+                    Context.NONE)
+                .getValue();
+        resource.update().withTypePropertiesType(Type.DEFAULT).apply();
+    }
+}
+```
+
+### Operations_List
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Operations List. */
+public final class OperationsListSamples {
+    /*
+     * x-ms-original-file: specification/hybridconnectivity/resource-manager/Microsoft.HybridConnectivity/preview/2022-05-01-preview/examples/OperationsList.json
+     */
+    /**
+     * Sample code: HybridConnectivityOperationsList.
+     *
+     * @param manager Entry point to HybridConnectivityManager.
+     */
+    public static void hybridConnectivityOperationsList(
+        com.azure.resourcemanager.hybridconnectivity.HybridConnectivityManager manager) {
+        manager.operations().list(Context.NONE);
+    }
+}
+```
+