test-repo-billy · azure-sdk · Apr 26, 2024
@@ -1,6 +1,8 @@
 # Release History
 
-## 1.0.0-beta.3 (Unreleased)
+## 1.0.0-beta.1 (2024-04-26)
+
+- Azure Resource Manager ServiceLinker client library for Java. This package contains Microsoft Azure SDK for ServiceLinker Management SDK. Microsoft.ServiceLinker provider. Package tag package-2022-05-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
 
 ### Features Added
 

@@ -32,7 +32,7 @@ Various documentation is available to help you get started
 <dependency>
     <groupId>com.azure.resourcemanager</groupId>
     <artifactId>azure-resourcemanager-servicelinker</artifactId>
-    <version>1.0.0-beta.2</version>
+    <version>1.0.0-beta.3</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, 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.
 - `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,20 +83,25 @@ 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
 [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
 [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/
+
+![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fservicelinker%2Fazure-resourcemanager-servicelinker%2FREADME.png)
@@ -3,297 +3,102 @@
 
 ## Linker
 
-- [CreateOrUpdate](#linker_createorupdate)
-- [Delete](#linker_delete)
-- [Get](#linker_get)
 - [List](#linker_list)
 - [ListConfigurations](#linker_listconfigurations)
-- [Update](#linker_update)
 - [Validate](#linker_validate)
 
 ## Operations
 
 - [List](#operations_list)
-### Linker_CreateOrUpdate
-
-```java
-import com.azure.resourcemanager.servicelinker.models.AzureResource;
-import com.azure.resourcemanager.servicelinker.models.KeyVaultSecretUriSecretInfo;
-import com.azure.resourcemanager.servicelinker.models.SecretAuthInfo;
-import com.azure.resourcemanager.servicelinker.models.SecretStore;
-import com.azure.resourcemanager.servicelinker.models.VNetSolution;
-import com.azure.resourcemanager.servicelinker.models.VNetSolutionType;
-import com.azure.resourcemanager.servicelinker.models.ValueSecretInfo;
-
-/** Samples for Linker CreateOrUpdate. */
-public final class LinkerCreateOrUpdateSamples {
-    /*
-     * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/PutLinkWithSecretStore.json
-     */
-    /**
-     * Sample code: PutLinkWithSecretStore.
-     *
-     * @param manager Entry point to ServiceLinkerManager.
-     */
-    public static void putLinkWithSecretStore(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager
-            .linkers()
-            .define("linkName")
-            .withExistingResourceUri(
-                "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app")
-            .withTargetService(
-                new AzureResource()
-                    .withId(
-                        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db"))
-            .withAuthInfo(new SecretAuthInfo())
-            .withSecretStore(
-                new SecretStore()
-                    .withKeyVaultId(
-                        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.KeyVault/vaults/test-kv"))
-            .create();
-    }
-
-    /*
-     * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/PutLinkWithServiceEndpoint.json
-     */
-    /**
-     * Sample code: PutLinkWithServiceEndpoint.
-     *
-     * @param manager Entry point to ServiceLinkerManager.
-     */
-    public static void putLinkWithServiceEndpoint(
-        com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager
-            .linkers()
-            .define("linkName")
-            .withExistingResourceUri(
-                "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app")
-            .withTargetService(
-                new AzureResource()
-                    .withId(
-                        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DBforPostgreSQL/servers/test-pg/databases/test-db"))
-            .withAuthInfo(
-                new SecretAuthInfo()
-                    .withName("name")
-                    .withSecretInfo(
-                        new KeyVaultSecretUriSecretInfo()
-                            .withValue(
-                                "https://vault-name.vault.azure.net/secrets/secret-name/00000000000000000000000000000000")))
-            .withVNetSolution(new VNetSolution().withType(VNetSolutionType.SERVICE_ENDPOINT))
-            .create();
-    }
-
-    /*
-     * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/PutLink.json
-     */
-    /**
-     * Sample code: PutLink.
-     *
-     * @param manager Entry point to ServiceLinkerManager.
-     */
-    public static void putLink(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager
-            .linkers()
-            .define("linkName")
-            .withExistingResourceUri(
-                "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app")
-            .withTargetService(
-                new AzureResource()
-                    .withId(
-                        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DBforPostgreSQL/servers/test-pg/databases/test-db"))
-            .withAuthInfo(
-                new SecretAuthInfo().withName("name").withSecretInfo(new ValueSecretInfo().withValue("secret")))
-            .create();
-    }
-}
-```
-
-### Linker_Delete
-
-```java
-import com.azure.core.util.Context;
-
-/** Samples for Linker Delete. */
-public final class LinkerDeleteSamples {
-    /*
-     * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/DeleteLink.json
-     */
-    /**
-     * Sample code: DeleteLink.
-     *
-     * @param manager Entry point to ServiceLinkerManager.
-     */
-    public static void deleteLink(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager
-            .linkers()
-            .delete(
-                "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app",
-                "linkName",
-                Context.NONE);
-    }
-}
-```
-
-### Linker_Get
-
-```java
-import com.azure.core.util.Context;
-
-/** Samples for Linker Get. */
-public final class LinkerGetSamples {
-    /*
-     * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/Link.json
-     */
-    /**
-     * Sample code: Link.
-     *
-     * @param manager Entry point to ServiceLinkerManager.
-     */
-    public static void link(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager
-            .linkers()
-            .getWithResponse(
-                "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app",
-                "linkName",
-                Context.NONE);
-    }
-}
-```
-
 ### Linker_List
 
 ```java
-import com.azure.core.util.Context;
-
-/** Samples for Linker List. */
+/**
+ * Samples for Linker List.
+ */
 public final class LinkerListSamples {
     /*
      * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/LinkList.json
      */
     /**
      * Sample code: LinkList.
-     *
+     * 
      * @param manager Entry point to ServiceLinkerManager.
      */
     public static void linkList(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager
-            .linkers()
+        manager.linkers()
             .list(
                 "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app",
-                Context.NONE);
+                com.azure.core.util.Context.NONE);
     }
 }
 ```
 
 ### Linker_ListConfigurations
 
 ```java
-import com.azure.core.util.Context;
-
-/** Samples for Linker ListConfigurations. */
+/**
+ * Samples for Linker ListConfigurations.
+ */
 public final class LinkerListConfigurationsSamples {
     /*
      * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/GetConfigurations.json
      */
     /**
      * Sample code: GetConfiguration.
-     *
+     * 
      * @param manager Entry point to ServiceLinkerManager.
      */
     public static void getConfiguration(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager
-            .linkers()
+        manager.linkers()
             .listConfigurationsWithResponse(
                 "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app",
-                "linkName",
-                Context.NONE);
-    }
-}
-```
-
-### Linker_Update
-
-```java
-import com.azure.core.util.Context;
-import com.azure.resourcemanager.servicelinker.models.AzureResource;
-import com.azure.resourcemanager.servicelinker.models.LinkerResource;
-import com.azure.resourcemanager.servicelinker.models.ServicePrincipalSecretAuthInfo;
-
-/** Samples for Linker Update. */
-public final class LinkerUpdateSamples {
-    /*
-     * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/PatchLink.json
-     */
-    /**
-     * Sample code: PatchLink.
-     *
-     * @param manager Entry point to ServiceLinkerManager.
-     */
-    public static void patchLink(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        LinkerResource resource =
-            manager
-                .linkers()
-                .getWithResponse(
-                    "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app",
-                    "linkName",
-                    Context.NONE)
-                .getValue();
-        resource
-            .update()
-            .withTargetService(
-                new AzureResource()
-                    .withId(
-                        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db"))
-            .withAuthInfo(
-                new ServicePrincipalSecretAuthInfo().withClientId("name").withPrincipalId("id").withSecret("secret"))
-            .apply();
+                "linkName", com.azure.core.util.Context.NONE);
     }
 }
 ```
 
 ### Linker_Validate
 
 ```java
-import com.azure.core.util.Context;
-
-/** Samples for Linker Validate. */
+/**
+ * Samples for Linker Validate.
+ */
 public final class LinkerValidateSamples {
     /*
      * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/ValidateLinkSuccess.json
      */
     /**
      * Sample code: ValidateLinkSuccess.
-     *
+     * 
      * @param manager Entry point to ServiceLinkerManager.
      */
     public static void validateLinkSuccess(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager
-            .linkers()
+        manager.linkers()
             .validate(
                 "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app",
-                "linkName",
-                Context.NONE);
+                "linkName", com.azure.core.util.Context.NONE);
     }
 }
 ```
 
 ### Operations_List
 
 ```java
-import com.azure.core.util.Context;
-
-/** Samples for Operations List. */
+/**
+ * Samples for Operations List.
+ */
 public final class OperationsListSamples {
     /*
      * x-ms-original-file: specification/servicelinker/resource-manager/Microsoft.ServiceLinker/stable/2022-05-01/examples/OperationsList.json
      */
     /**
      * Sample code: GetConfiguration.
-     *
+     * 
      * @param manager Entry point to ServiceLinkerManager.
      */
     public static void getConfiguration(com.azure.resourcemanager.servicelinker.ServiceLinkerManager manager) {
-        manager.operations().list(Context.NONE);
+        manager.operations().list(com.azure.core.util.Context.NONE);
     }
 }
 ```