[AutoPR azure-resourcemanager-digitaltwins] [Hub Generated] Review request for Microsoft.DigitalTwins to add version stable/2022-05-31

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

@@ -1,6 +1,8 @@
 # Release History
 
-## 1.1.0-beta.1 (Unreleased)
+## 1.0.0-beta.1 (2022-09-09)
+
+- Azure Resource Manager AzureDigitalTwins client library for Java. This package contains Microsoft Azure SDK for AzureDigitalTwins Management SDK. Azure Digital Twins Client for managing DigitalTwinsInstance. Package tag package-2022-05. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
 
 ### Features Added
 

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

@@ -32,7 +32,7 @@ Various documentation is available to help you get started
 <dependency>
     <groupId>com.azure.resourcemanager</groupId>
     <artifactId>azure-resourcemanager-digitaltwins</artifactId>
-    <version>1.0.0</version>
+    <version>1.1.0-beta.1</version>
 </dependency>
 ```
 [//]: # ({x-version-update-end})

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/AzureDigitalTwinsManager.java

@@ -223,7 +223,7 @@ public AzureDigitalTwinsManager authenticate(TokenCredential credential, AzurePr
                 .append("-")
                 .append("com.azure.resourcemanager.digitaltwins")
                 .append("/")
-                .append("1.0.0");
+                .append("1.0.0-beta.1");
             if (!Configuration.getGlobalConfiguration().get("AZURE_TELEMETRY_DISABLED", false)) {
                 userAgentBuilder
                     .append(" (")

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/fluent/models/CheckNameResultInner.java

@@ -18,8 +18,8 @@ public final class CheckNameResultInner {
     private Boolean nameAvailable;
 
     /*
-     * Message indicating an unavailable name due to a conflict, or a
-     * description of the naming rules that are violated.
+     * Message indicating an unavailable name due to a conflict, or a description of the naming rules that are
+     * violated.
      */
     @JsonProperty(value = "message")
     private String message;

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/fluent/models/PrivateEndpointConnectionInner.java

@@ -21,8 +21,7 @@ public final class PrivateEndpointConnectionInner extends ProxyResource {
     private ConnectionProperties properties;
 
     /*
-     * Metadata pertaining to creation and last modification of the private
-     * endpoint connection.
+     * Metadata pertaining to creation and last modification of the private endpoint connection.
      */
     @JsonProperty(value = "systemData", access = JsonProperty.Access.WRITE_ONLY)
     private SystemData systemData;

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/implementation/AzureDigitalTwinsManagementClientBuilder.java

@@ -119,24 +119,26 @@ public AzureDigitalTwinsManagementClientBuilder serializerAdapter(SerializerAdap
      * @return an instance of AzureDigitalTwinsManagementClientImpl.
      */
     public AzureDigitalTwinsManagementClientImpl buildClient() {
-        if (endpoint == null) {
-            this.endpoint = "https://management.azure.com";
-        }
-        if (environment == null) {
-            this.environment = AzureEnvironment.AZURE;
-        }
-        if (pipeline == null) {
-            this.pipeline = new HttpPipelineBuilder().policies(new UserAgentPolicy(), new RetryPolicy()).build();
-        }
-        if (defaultPollInterval == null) {
-            this.defaultPollInterval = Duration.ofSeconds(30);
-        }
-        if (serializerAdapter == null) {
-            this.serializerAdapter = SerializerFactory.createDefaultManagementSerializerAdapter();
-        }
+        String localEndpoint = (endpoint != null) ? endpoint : "https://management.azure.com";
+        AzureEnvironment localEnvironment = (environment != null) ? environment : AzureEnvironment.AZURE;
+        HttpPipeline localPipeline =
+            (pipeline != null)
+                ? pipeline
+                : new HttpPipelineBuilder().policies(new UserAgentPolicy(), new RetryPolicy()).build();
+        Duration localDefaultPollInterval =
+            (defaultPollInterval != null) ? defaultPollInterval : Duration.ofSeconds(30);
+        SerializerAdapter localSerializerAdapter =
+            (serializerAdapter != null)
+                ? serializerAdapter
+                : SerializerFactory.createDefaultManagementSerializerAdapter();
         AzureDigitalTwinsManagementClientImpl client =
             new AzureDigitalTwinsManagementClientImpl(
-                pipeline, serializerAdapter, defaultPollInterval, environment, subscriptionId, endpoint);
+                localPipeline,
+                localSerializerAdapter,
+                localDefaultPollInterval,
+                localEnvironment,
+                subscriptionId,
+                localEndpoint);
         return client;
     }
 }

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/implementation/DigitalTwinsClientImpl.java

@@ -1651,7 +1651,8 @@ public Response<CheckNameResultInner> checkNameAvailabilityWithResponse(
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
@@ -1687,7 +1688,8 @@ private Mono<PagedResponse<DigitalTwinsDescriptionInner>> listNextSinglePageAsyn
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @param context The context to associate with this operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.
@@ -1725,7 +1727,8 @@ private Mono<PagedResponse<DigitalTwinsDescriptionInner>> listNextSinglePageAsyn
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
@@ -1762,7 +1765,8 @@ private Mono<PagedResponse<DigitalTwinsDescriptionInner>> listByResourceGroupNex
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @param context The context to associate with this operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/implementation/DigitalTwinsEndpointsClientImpl.java

@@ -1081,7 +1081,8 @@ public DigitalTwinsEndpointResourceInner delete(
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
@@ -1117,7 +1118,8 @@ private Mono<PagedResponse<DigitalTwinsEndpointResourceInner>> listNextSinglePag
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @param context The context to associate with this operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/implementation/OperationsClientImpl.java

@@ -198,7 +198,8 @@ public PagedIterable<OperationInner> list(Context context) {
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
@@ -234,7 +235,8 @@ private Mono<PagedResponse<OperationInner>> listNextSinglePageAsync(String nextL
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @param context The context to associate with this operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/implementation/TimeSeriesDatabaseConnectionsClientImpl.java

@@ -1158,7 +1158,8 @@ public TimeSeriesDatabaseConnectionInner delete(
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
@@ -1194,7 +1195,8 @@ private Mono<PagedResponse<TimeSeriesDatabaseConnectionInner>> listNextSinglePag
     /**
      * Get the next page of items.
      *
-     * @param nextLink The nextLink parameter.
+     * @param nextLink The URL to get the next list of items
+     *     <p>The nextLink parameter.
      * @param context The context to associate with this operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws ManagementException thrown if the request is rejected by server.

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/AuthenticationType.java

@@ -8,7 +8,11 @@
 import com.fasterxml.jackson.annotation.JsonCreator;
 import java.util.Collection;
 
-/** Defines values for AuthenticationType. */
+/**
+ * Specifies the authentication type being used for connecting to the endpoint. Defaults to 'KeyBased'. If 'KeyBased' is
+ * selected, a connection string must be specified (at least the primary connection string). If 'IdentityBased' is
+ * select, the endpointUri and entityPath properties must be specified.
+ */
 public final class AuthenticationType extends ExpandableStringEnum<AuthenticationType> {
     /** Static value KeyBased for AuthenticationType. */
     public static final AuthenticationType KEY_BASED = fromString("KeyBased");

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/AzureDataExplorerConnectionProperties.java

@@ -34,21 +34,19 @@ public final class AzureDataExplorerConnectionProperties extends TimeSeriesDatab
     private String adxDatabaseName;
 
     /*
-     * The name of the Azure Data Explorer table.
+     * The name of the Azure Data Explorer table. Defaults to AdtPropertyEvents.
      */
     @JsonProperty(value = "adxTableName")
     private String adxTableName;
 
     /*
-     * The URL of the EventHub namespace for identity-based authentication. It
-     * must include the protocol sb://
+     * The URL of the EventHub namespace for identity-based authentication. It must include the protocol sb://
      */
     @JsonProperty(value = "eventHubEndpointUri", required = true)
     private String eventHubEndpointUri;
 
     /*
-     * The EventHub name in the EventHub namespace for identity-based
-     * authentication.
+     * The EventHub name in the EventHub namespace for identity-based authentication.
      */
     @JsonProperty(value = "eventHubEntityPath", required = true)
     private String eventHubEntityPath;
@@ -60,8 +58,7 @@ public final class AzureDataExplorerConnectionProperties extends TimeSeriesDatab
     private String eventHubNamespaceResourceId;
 
     /*
-     * The EventHub consumer group to use when ADX reads from EventHub.
-     * Defaults to $Default.
+     * The EventHub consumer group to use when ADX reads from EventHub. Defaults to $Default.
      */
     @JsonProperty(value = "eventHubConsumerGroup")
     private String eventHubConsumerGroup;
@@ -127,7 +124,7 @@ public AzureDataExplorerConnectionProperties withAdxDatabaseName(String adxDatab
     }
 
     /**
-     * Get the adxTableName property: The name of the Azure Data Explorer table.
+     * Get the adxTableName property: The name of the Azure Data Explorer table. Defaults to AdtPropertyEvents.
      *
      * @return the adxTableName value.
      */
@@ -136,7 +133,7 @@ public String adxTableName() {
     }
 
     /**
-     * Set the adxTableName property: The name of the Azure Data Explorer table.
+     * Set the adxTableName property: The name of the Azure Data Explorer table. Defaults to AdtPropertyEvents.
      *
      * @param adxTableName the adxTableName value to set.
      * @return the AzureDataExplorerConnectionProperties object itself.

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/CheckNameRequest.java

@@ -18,8 +18,7 @@ public final class CheckNameRequest {
     private String name;
 
     /*
-     * The type of resource, for instance
-     * Microsoft.DigitalTwins/digitalTwinsInstances.
+     * The type of resource, for instance Microsoft.DigitalTwins/digitalTwinsInstances.
      */
     @JsonProperty(value = "type", required = true)
     private String type = "Microsoft.DigitalTwins/digitalTwinsInstances";

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/ConnectionPropertiesProvisioningState.java

@@ -8,7 +8,7 @@
 import com.fasterxml.jackson.annotation.JsonCreator;
 import java.util.Collection;
 
-/** Defines values for ConnectionPropertiesProvisioningState. */
+/** The provisioning state. */
 public final class ConnectionPropertiesProvisioningState
     extends ExpandableStringEnum<ConnectionPropertiesProvisioningState> {
     /** Static value Pending for ConnectionPropertiesProvisioningState. */

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/ConnectionType.java

@@ -8,7 +8,7 @@
 import com.fasterxml.jackson.annotation.JsonCreator;
 import java.util.Collection;
 
-/** Defines values for ConnectionType. */
+/** The type of time series connection resource. */
 public final class ConnectionType extends ExpandableStringEnum<ConnectionType> {
     /** Static value AzureDataExplorer for ConnectionType. */
     public static final ConnectionType AZURE_DATA_EXPLORER = fromString("AzureDataExplorer");

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/DigitalTwinsEndpointResourceProperties.java

@@ -38,18 +38,15 @@ public class DigitalTwinsEndpointResourceProperties {
     private OffsetDateTime createdTime;
 
     /*
-     * Specifies the authentication type being used for connecting to the
-     * endpoint. Defaults to 'KeyBased'. If 'KeyBased' is selected, a
-     * connection string must be specified (at least the primary connection
-     * string). If 'IdentityBased' is select, the endpointUri and entityPath
-     * properties must be specified.
+     * Specifies the authentication type being used for connecting to the endpoint. Defaults to 'KeyBased'. If
+     * 'KeyBased' is selected, a connection string must be specified (at least the primary connection string). If
+     * 'IdentityBased' is select, the endpointUri and entityPath properties must be specified.
      */
     @JsonProperty(value = "authenticationType")
     private AuthenticationType authenticationType;
 
     /*
-     * Dead letter storage secret for key-based authentication. Will be
-     * obfuscated during read.
+     * Dead letter storage secret for key-based authentication. Will be obfuscated during read.
      */
     @JsonProperty(value = "deadLetterSecret")
     private String deadLetterSecret;

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/DigitalTwinsIdentity.java

@@ -11,24 +11,21 @@
 @Fluent
 public class DigitalTwinsIdentity {
     /*
-     * The type of Managed Identity used by the DigitalTwinsInstance. Only
-     * SystemAssigned is supported.
+     * The type of Managed Identity used by the DigitalTwinsInstance. Only SystemAssigned is supported.
      */
     @JsonProperty(value = "type")
     private DigitalTwinsIdentityType type;
 
     /*
-     * The object id of the Managed Identity Resource. This will be sent to the
-     * RP from ARM via the x-ms-identity-principal-id header in the PUT request
-     * if the resource has a systemAssigned(implicit) identity
+     * The object id of the Managed Identity Resource. This will be sent to the RP from ARM via the
+     * x-ms-identity-principal-id header in the PUT request if the resource has a systemAssigned(implicit) identity
      */
     @JsonProperty(value = "principalId", access = JsonProperty.Access.WRITE_ONLY)
     private String principalId;
 
     /*
-     * The tenant id of the Managed Identity Resource. This will be sent to the
-     * RP from ARM via the x-ms-client-tenant-id header in the PUT request if
-     * the resource has a systemAssigned(implicit) identity
+     * The tenant id of the Managed Identity Resource. This will be sent to the RP from ARM via the
+     * x-ms-client-tenant-id header in the PUT request if the resource has a systemAssigned(implicit) identity
      */
     @JsonProperty(value = "tenantId", access = JsonProperty.Access.WRITE_ONLY)
     private String tenantId;

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/DigitalTwinsIdentityType.java

@@ -8,7 +8,7 @@
 import com.fasterxml.jackson.annotation.JsonCreator;
 import java.util.Collection;
 
-/** Defines values for DigitalTwinsIdentityType. */
+/** The type of Managed Identity used by the DigitalTwinsInstance. Only SystemAssigned is supported. */
 public final class DigitalTwinsIdentityType extends ExpandableStringEnum<DigitalTwinsIdentityType> {
     /** Static value None for DigitalTwinsIdentityType. */
     public static final DigitalTwinsIdentityType NONE = fromString("None");

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/DigitalTwinsResource.java

@@ -20,8 +20,7 @@ public class DigitalTwinsResource extends Resource {
     private DigitalTwinsIdentity identity;
 
     /*
-     * Metadata pertaining to creation and last modification of the
-     * DigitalTwinsInstance.
+     * Metadata pertaining to creation and last modification of the DigitalTwinsInstance.
      */
     @JsonProperty(value = "systemData", access = JsonProperty.Access.WRITE_ONLY)
     private SystemData systemData;

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/EndpointProvisioningState.java

@@ -8,7 +8,7 @@
 import com.fasterxml.jackson.annotation.JsonCreator;
 import java.util.Collection;
 
-/** Defines values for EndpointProvisioningState. */
+/** The provisioning state. */
 public final class EndpointProvisioningState extends ExpandableStringEnum<EndpointProvisioningState> {
     /** Static value Provisioning for EndpointProvisioningState. */
     public static final EndpointProvisioningState PROVISIONING = fromString("Provisioning");

sdk/digitaltwins/azure-resourcemanager-digitaltwins/src/main/java/com/azure/resourcemanager/digitaltwins/models/EndpointType.java

@@ -8,7 +8,7 @@
 import com.fasterxml.jackson.annotation.JsonCreator;
 import java.util.Collection;
 
-/** Defines values for EndpointType. */
+/** The type of Digital Twins endpoint. */
 public final class EndpointType extends ExpandableStringEnum<EndpointType> {
     /** Static value EventHub for EndpointType. */
     public static final EndpointType EVENT_HUB = fromString("EventHub");