[AutoPR azure-resourcemanager-iothub] [Hub Generated] Review request for Microsoft.Devices to add version stable/2023-06-30

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

@@ -1,6 +1,8 @@
 # Release History
 
-## 1.2.0-beta.4 (Unreleased)
+## 1.0.0-beta.1 (2023-08-16)
+
+- Azure Resource Manager IotHub client library for Java. This package contains Microsoft Azure SDK for IotHub Management SDK. Use this API to manage the IoT hubs in your Azure subscription. Package tag package-2023-06. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
 
 ### Features Added
 

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

@@ -2,7 +2,7 @@
 
 Azure Resource Manager IotHub client library for Java.
 
-This package contains Microsoft Azure SDK for IotHub Management SDK. Use this API to manage the IoT hubs in your Azure subscription. Package tag package-preview-2022-11. 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 IotHub Management SDK. Use this API to manage the IoT hubs in your Azure subscription. Package tag package-2023-06. 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-iothub</artifactId>
-    <version>1.2.0-beta.3</version>
+    <version>1.2.0-beta.4</version>
 </dependency>
 ```
 [//]: # ({x-version-update-end})
@@ -103,3 +103,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%2Fiothub%2Fazure-resourcemanager-iothub%2FREADME.png)

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

@@ -18,7 +18,7 @@
   <packaging>jar</packaging>
 
   <name>Microsoft Azure SDK for IotHub Management</name>
-  <description>This package contains Microsoft Azure SDK for IotHub Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. Use this API to manage the IoT hubs in your Azure subscription. Package tag package-preview-2022-11.</description>
+  <description>This package contains Microsoft Azure SDK for IotHub Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. Use this API to manage the IoT hubs in your Azure subscription. Package tag package-2023-06.</description>
   <url>https://github.com/Azure/azure-sdk-for-java</url>
 
   <licenses>
@@ -45,7 +45,6 @@
     <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/iothub/azure-resourcemanager-iothub/src/main/java/com/azure/resourcemanager/iothub/IotHubManager.java

@@ -227,7 +227,7 @@ public IotHubManager authenticate(TokenCredential credential, AzureProfile profi
                 .append("-")
                 .append("com.azure.resourcemanager.iothub")
                 .append("/")
-                .append("1.2.0-beta.3");
+                .append("1.0.0-beta.1");
             if (!Configuration.getGlobalConfiguration().get("AZURE_TELEMETRY_DISABLED", false)) {
                 userAgentBuilder
                     .append(" (")

sdk/iothub/azure-resourcemanager-iothub/src/main/java/com/azure/resourcemanager/iothub/fluent/IotHubResourcesClient.java

@@ -71,7 +71,8 @@ Response<IotHubDescriptionInner> getByResourceGroupWithResponse(
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -91,7 +92,8 @@ SyncPoller<PollResult<IotHubDescriptionInner>, IotHubDescriptionInner> beginCrea
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -118,7 +120,8 @@ SyncPoller<PollResult<IotHubDescriptionInner>, IotHubDescriptionInner> beginCrea
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -138,7 +141,8 @@ IotHubDescriptionInner createOrUpdate(
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.

sdk/iothub/azure-resourcemanager-iothub/src/main/java/com/azure/resourcemanager/iothub/implementation/IotHubClientImpl.java

@@ -220,7 +220,7 @@ public PrivateEndpointConnectionsClient getPrivateEndpointConnections() {
         this.defaultPollInterval = defaultPollInterval;
         this.subscriptionId = subscriptionId;
         this.endpoint = endpoint;
-        this.apiVersion = "2022-11-15-preview";
+        this.apiVersion = "2023-06-30";
         this.operations = new OperationsClientImpl(this);
         this.iotHubResources = new IotHubResourcesClientImpl(this);
         this.resourceProviderCommons = new ResourceProviderCommonsClientImpl(this);

sdk/iothub/azure-resourcemanager-iothub/src/main/java/com/azure/resourcemanager/iothub/implementation/IotHubResourcesClientImpl.java

@@ -662,7 +662,8 @@ public IotHubDescriptionInner getByResourceGroup(String resourceGroupName, Strin
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -725,7 +726,8 @@ private Mono<Response<Flux<ByteBuffer>>> createOrUpdateWithResponseAsync(
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -790,7 +792,8 @@ private Mono<Response<Flux<ByteBuffer>>> createOrUpdateWithResponseAsync(
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -822,7 +825,8 @@ private PollerFlux<PollResult<IotHubDescriptionInner>, IotHubDescriptionInner> b
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -853,7 +857,8 @@ private PollerFlux<PollResult<IotHubDescriptionInner>, IotHubDescriptionInner> b
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -891,7 +896,8 @@ private PollerFlux<PollResult<IotHubDescriptionInner>, IotHubDescriptionInner> b
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -915,7 +921,8 @@ public SyncPoller<PollResult<IotHubDescriptionInner>, IotHubDescriptionInner> be
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -945,7 +952,8 @@ public SyncPoller<PollResult<IotHubDescriptionInner>, IotHubDescriptionInner> be
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -970,7 +978,8 @@ private Mono<IotHubDescriptionInner> createOrUpdateAsync(
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -994,7 +1003,8 @@ private Mono<IotHubDescriptionInner> createOrUpdateAsync(
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -1024,7 +1034,8 @@ private Mono<IotHubDescriptionInner> createOrUpdateAsync(
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.
@@ -1046,7 +1057,8 @@ public IotHubDescriptionInner createOrUpdate(
      *
      * <p>Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub
      * metadata and security metadata, and then combine them with the modified values in a new body to update the IoT
-     * hub.
+     * hub. If certain properties are missing in the JSON, updating IoT Hub may cause these values to fallback to
+     * default, which may lead to unexpected behavior.
      *
      * @param resourceGroupName The name of the resource group that contains the IoT hub.
      * @param resourceName The name of the IoT hub.

sdk/iothub/azure-resourcemanager-iothub/src/main/java/com/azure/resourcemanager/iothub/models/ArmIdentity.java

@@ -25,7 +25,7 @@ public final class ArmIdentity {
     private String tenantId;
 
     /*
-     * The type of identity used for the resource. The type 'SystemAssigned,UserAssigned' includes both an implicitly
+     * The type of identity used for the resource. The type 'SystemAssigned, UserAssigned' includes both an implicitly
      * created identity and a set of user assigned identities. The type 'None' will remove any identities from the
      * service.
      */
@@ -62,7 +62,7 @@ public String tenantId() {
     }
 
     /**
-     * Get the type property: The type of identity used for the resource. The type 'SystemAssigned,UserAssigned'
+     * Get the type property: The type of identity used for the resource. The type 'SystemAssigned, UserAssigned'
      * includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove
      * any identities from the service.
      *
@@ -73,7 +73,7 @@ public ResourceIdentityType type() {
     }
 
     /**
-     * Set the type property: The type of identity used for the resource. The type 'SystemAssigned,UserAssigned'
+     * Set the type property: The type of identity used for the resource. The type 'SystemAssigned, UserAssigned'
      * includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove
      * any identities from the service.
      *

sdk/iothub/azure-resourcemanager-iothub/src/main/java/com/azure/resourcemanager/iothub/models/CertificateDescription.java

@@ -62,11 +62,13 @@ public interface CertificateDescription {
     interface Definition
         extends DefinitionStages.Blank, DefinitionStages.WithParentResource, DefinitionStages.WithCreate {
     }
+
     /** The CertificateDescription definition stages. */
     interface DefinitionStages {
         /** The first stage of the CertificateDescription definition. */
         interface Blank extends WithParentResource {
         }
+
         /** The stage of the CertificateDescription definition allowing to specify parent resource. */
         interface WithParentResource {
             /**
@@ -78,6 +80,7 @@ interface WithParentResource {
              */
             WithCreate withExistingIotHub(String resourceGroupName, String resourceName);
         }
+
         /**
          * The stage of the CertificateDescription definition which contains all the minimum required properties for the
          * resource to be created, but also allows for any other optional properties to be specified.
@@ -98,6 +101,7 @@ interface WithCreate extends DefinitionStages.WithProperties, DefinitionStages.W
              */
             CertificateDescription create(Context context);
         }
+
         /** The stage of the CertificateDescription definition allowing to specify properties. */
         interface WithProperties {
             /**
@@ -108,6 +112,7 @@ interface WithProperties {
              */
             WithCreate withProperties(CertificateProperties properties);
         }
+
         /** The stage of the CertificateDescription definition allowing to specify ifMatch. */
         interface WithIfMatch {
             /**
@@ -121,6 +126,7 @@ interface WithIfMatch {
             WithCreate withIfMatch(String ifMatch);
         }
     }
+
     /**
      * Begins update for the CertificateDescription resource.
      *
@@ -145,6 +151,7 @@ interface Update extends UpdateStages.WithProperties, UpdateStages.WithIfMatch {
          */
         CertificateDescription apply(Context context);
     }
+
     /** The CertificateDescription update stages. */
     interface UpdateStages {
         /** The stage of the CertificateDescription update allowing to specify properties. */
@@ -157,6 +164,7 @@ interface WithProperties {
              */
             Update withProperties(CertificateProperties properties);
         }
+
         /** The stage of the CertificateDescription update allowing to specify ifMatch. */
         interface WithIfMatch {
             /**
@@ -170,6 +178,7 @@ interface WithIfMatch {
             Update withIfMatch(String ifMatch);
         }
     }
+
     /**
      * Refreshes the resource to sync with Azure.
      *