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

[Hub Generated] Public private branch 'dev-digitaltwins-Microsoft.DigitalTwins-2021-06-30-preview-merge-with-main' (Azure#17186)

* Adds base for updating Microsoft.DigitalTwins from version stable/2020-12-01 to version 2021-06-30-preview

* Updates readme

* Updates API version in new specs and examples

* Add RM API Version Microsoft.DigitalTwins 2021-06-30-preview (#3404)

* Add SDK Generation Options for new API Version (#3179)

* Add SDK generation for 2021-06-30-preview

* The following fixes were done:
 * Fixed schema location: preview instead of stable
 * Updated go SDK generation to point to preview namespace

* Remove Ruby support

* add SystemData and update instance and endpoints definitions

* added systemdata to all examples

* fix typo

* fix prettier issues

* added experimental operations fix

* fixed some errors

* addressed lint and model errors

* fixed type issues with endpoints examples

* Fixed autorest error

* removed unnecessary _allOf_s

* Add Time Series Database Connection Resource and CRUD API Endpoints (#3180)

* Added basic time series integration resource CRUD and resource description

* Add list call for TSDB integration resources

* Modify naming for adx endpoint

* Rename document names and paths from integration resources to time series database connections; also clean up descriptions, and make more specific to time series database connections (rather than general integrations)

* Update operation names

* Resolve review comments

* Add examples for time series database connection CRUD

* Add example for missing status code 200 to DELETE

* Run prettier and fix formatting issues

* Align tags, solve issue in Python SDK generation

* Align python readme

* Fix linter error

* Fix linter error 2

* Fix linter error

* Made privateEndpointConnections readonly, added additional documentation for keybased and entitybased authenticationType (#3358)

* Address major lintdiff warnings

* Fix more linter warnings

* Address remaining lintdiff warnings and errors

* Remove property flattening to avoid issues with polymorphism, edit suppression directives to point to new location

* Address lintdiff error

* Add systemData property to private endpoint connection resource

* Address breaking change warnings

* Fix inheritance

* Update suppressions to point to new locations in document

* Updated TSDB connection parameter set

* Fix issue in property set

* Revert readOnly=true from private endpoint connections property

* Revert change to TopicEndpoint

* Back to camelcase...

* Revert change in old API version

* Revert TopicEndpoint back to camelCase

* Revert allOf addition

* Change capitalization of TopicEndpoint back to original from previous version

* Add approved suppression

* Fix $.definitions path in suppression rules

Co-authored-by: Nate Lehman <[email protected]>
Co-authored-by: Nate Lehman <[email protected]>

* Align with repo (#5658)

Co-authored-by: Nate Lehman <[email protected]>
Co-authored-by: Nate Lehman <[email protected]>

Author: 3 people

sdk/digitaltwins/arm-digitaltwins/CHANGELOG.md

@@ -1,15 +1,40 @@
 # Release History
-
-## 3.0.1 (Unreleased)
-
-### Features Added
-
-### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes
-
+    
+## 3.1.0-beta.1 (2022-02-01)
+    
+**Features**
+
+  - Added operation group TimeSeriesDatabaseConnections
+  - Added Interface GroupIdInformationProperties
+  - Added Interface SystemData
+  - Added Interface TimeSeriesDatabaseConnectionListResult
+  - Added Interface TimeSeriesDatabaseConnectionProperties
+  - Added Interface TimeSeriesDatabaseConnectionsCreateOrUpdateOptionalParams
+  - Added Interface TimeSeriesDatabaseConnectionsDeleteOptionalParams
+  - Added Interface TimeSeriesDatabaseConnectionsGetOptionalParams
+  - Added Interface TimeSeriesDatabaseConnectionsListNextOptionalParams
+  - Added Interface TimeSeriesDatabaseConnectionsListOptionalParams
+  - Added Type Alias AzureDataExplorerConnectionProperties
+  - Added Type Alias ConnectionType_2
+  - Added Type Alias CreatedByType
+  - Added Type Alias TimeSeriesDatabaseConnection
+  - Added Type Alias TimeSeriesDatabaseConnectionPropertiesUnion
+  - Added Type Alias TimeSeriesDatabaseConnectionsCreateOrUpdateResponse
+  - Added Type Alias TimeSeriesDatabaseConnectionsDeleteResponse
+  - Added Type Alias TimeSeriesDatabaseConnectionsGetResponse
+  - Added Type Alias TimeSeriesDatabaseConnectionsListNextResponse
+  - Added Type Alias TimeSeriesDatabaseConnectionsListResponse
+  - Added Type Alias TimeSeriesDatabaseConnectionState
+  - Interface DigitalTwinsResource has a new optional parameter systemData
+  - Interface ExternalResource has a new optional parameter systemData
+  - Interface Operation has a new optional parameter properties
+  - Interface PrivateEndpointConnection has a new optional parameter systemData
+  - Class AzureDigitalTwinsManagementClient has a new parameter timeSeriesDatabaseConnections
+  - Added Enum KnownConnectionType
+  - Added Enum KnownCreatedByType
+  - Added Enum KnownTimeSeriesDatabaseConnectionState
+    
+    
 ## 3.0.0 (2022-01-13)
 
 The package of @azure/arm-digitaltwins is using our next generation design principles since version 3.0.0, which contains breaking changes.

sdk/digitaltwins/arm-digitaltwins/README.md

@@ -6,7 +6,7 @@ Azure Digital Twins Client for managing DigitalTwinsInstance
 
 [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/digitaltwins/arm-digitaltwins) |
 [Package (NPM)](https://www.npmjs.com/package/@azure/arm-digitaltwins) |
-[API reference documentation](https://docs.microsoft.com/javascript/api/@azure/arm-digitaltwins) |
+[API reference documentation](https://docs.microsoft.com/javascript/api/@azure/arm-digitaltwins?view=azure-node-preview) |
 [Samples](https://github.com/Azure-Samples/azure-samples-js-management)
 
 ## Getting started

sdk/digitaltwins/arm-digitaltwins/_meta.json

@@ -1,7 +1,7 @@
 {
-  "commit": "1f1d5b0b9ce6cc94605b2fd619dce374fb6e033a",
+  "commit": "938d33ac71d661bfa53946ad4fa72c7fdbf2dfcf",
   "readme": "specification/digitaltwins/resource-manager/readme.md",
-  "autorest_command": "autorest --version=3.1.3 --typescript --modelerfour.lenient-model-deduplication --head-as-boolean=true --license-header=MICROSOFT_MIT_NO_VERSION --generate-test --typescript-sdks-folder=D:\\mydev\\azure-sdk-for-js ../azure-rest-api-specs/specification/devspaces/resource-manager/readme.md --use=@autorest/[email protected].20211217.1",
+  "autorest_command": "autorest --version=3.7.3 --typescript --modelerfour.lenient-model-deduplication --head-as-boolean=true --license-header=MICROSOFT_MIT_NO_VERSION --generate-test --typescript-sdks-folder=/home/vsts/work/1/s/azure-sdk-for-js ../azure-rest-api-specs/specification/digitaltwins/resource-manager/readme.md --use=@autorest/[email protected].20220105.1",
   "repository_url": "https://github.com/Azure/azure-rest-api-specs.git",
-  "use": "@autorest/[email protected].20211217.1"
-}
+  "use": "@autorest/[email protected].20220105.1"
+}

sdk/digitaltwins/arm-digitaltwins/api-extractor.json

@@ -1,18 +1,31 @@
 {
   "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
   "mainEntryPointFilePath": "./dist-esm/src/index.d.ts",
-  "docModel": { "enabled": true },
-  "apiReport": { "enabled": true, "reportFolder": "./review" },
+  "docModel": {
+    "enabled": true
+  },
+  "apiReport": {
+    "enabled": true,
+    "reportFolder": "./review"
+  },
   "dtsRollup": {
     "enabled": true,
     "untrimmedFilePath": "",
     "publicTrimmedFilePath": "./types/arm-digitaltwins.d.ts"
   },
   "messages": {
-    "tsdocMessageReporting": { "default": { "logLevel": "none" } },
+    "tsdocMessageReporting": {
+      "default": {
+        "logLevel": "none"
+      }
+    },
     "extractorMessageReporting": {
-      "ae-missing-release-tag": { "logLevel": "none" },
-      "ae-unresolved-link": { "logLevel": "none" }
+      "ae-missing-release-tag": {
+        "logLevel": "none"
+      },
+      "ae-unresolved-link": {
+        "logLevel": "none"
+      }
     }
   }
-}
+}

sdk/digitaltwins/arm-digitaltwins/package.json

@@ -3,7 +3,7 @@
   "sdk-type": "mgmt",
   "author": "Microsoft Corporation",
   "description": "A generated SDK for AzureDigitalTwinsManagementClient.",
-  "version": "3.0.1",
+  "version": "3.1.0-beta.1",
   "engines": {
     "node": ">=12.0.0"
   },
@@ -99,4 +99,4 @@
   },
   "sideEffects": false,
   "autoPublish": true
-}
+}

sdk/digitaltwins/arm-digitaltwins/review/arm-digitaltwins.api.md

@@ -13,6 +13,19 @@ import { PollOperationState } from '@azure/core-lro';
 // @public
 export type AuthenticationType = string;
 
+// @public
+export type AzureDataExplorerConnectionProperties = TimeSeriesDatabaseConnectionProperties & {
+    connectionType: "AzureDataExplorer";
+    adxResourceId: string;
+    adxEndpointUri: string;
+    adxDatabaseName: string;
+    adxTableName?: string;
+    eventHubEndpointUri: string;
+    eventHubEntityPath: string;
+    eventHubNamespaceResourceId: string;
+    eventHubConsumerGroup?: string;
+};
+
 // @public (undocumented)
 export class AzureDigitalTwinsManagementClient extends coreClient.ServiceClient {
     // (undocumented)
@@ -32,6 +45,8 @@ export class AzureDigitalTwinsManagementClient extends coreClient.ServiceClient
     privateLinkResources: PrivateLinkResources;
     // (undocumented)
     subscriptionId: string;
+    // (undocumented)
+    timeSeriesDatabaseConnections: TimeSeriesDatabaseConnections;
 }
 
 // @public
@@ -57,17 +72,12 @@ export interface CheckNameResult {
 // @public
 export interface ConnectionProperties {
     groupIds?: string[];
-    // (undocumented)
-    privateEndpoint?: ConnectionPropertiesPrivateEndpoint;
-    // (undocumented)
+    privateEndpoint?: PrivateEndpoint;
     privateLinkServiceConnectionState?: ConnectionPropertiesPrivateLinkServiceConnectionState;
     readonly provisioningState?: ConnectionPropertiesProvisioningState;
 }
 
-// @public (undocumented)
-export type ConnectionPropertiesPrivateEndpoint = PrivateEndpoint & {};
-
-// @public (undocumented)
+// @public
 export type ConnectionPropertiesPrivateLinkServiceConnectionState = ConnectionState & {};
 
 // @public
@@ -80,6 +90,13 @@ export interface ConnectionState {
     status: PrivateLinkServiceConnectionStatus;
 }
 
+// @public
+type ConnectionType_2 = string;
+export { ConnectionType_2 as ConnectionType }
+
+// @public
+export type CreatedByType = string;
+
 // @public
 export interface DigitalTwins {
     beginCreateOrUpdate(resourceGroupName: string, resourceName: string, digitalTwinsCreate: DigitalTwinsDescription, options?: DigitalTwinsCreateOrUpdateOptionalParams): Promise<PollerLike<PollOperationState<DigitalTwinsCreateOrUpdateResponse>, DigitalTwinsCreateOrUpdateResponse>>;
@@ -273,6 +290,7 @@ export interface DigitalTwinsResource {
     identity?: DigitalTwinsIdentity;
     location: string;
     readonly name?: string;
+    readonly systemData?: SystemData;
     tags?: {
         [propertyName: string]: string;
     };
@@ -327,23 +345,20 @@ export type EventHub = DigitalTwinsEndpointResourceProperties & {
 export interface ExternalResource {
     readonly id?: string;
     readonly name?: string;
+    readonly systemData?: SystemData;
     readonly type?: string;
 }
 
 // @public
 export interface GroupIdInformation {
     id?: string;
     readonly name?: string;
-    // (undocumented)
     properties: GroupIdInformationProperties;
     readonly type?: string;
 }
 
-// @public (undocumented)
-export type GroupIdInformationProperties = GroupIdInformationPropertiesAutoGenerated & {};
-
 // @public
-export interface GroupIdInformationPropertiesAutoGenerated {
+export interface GroupIdInformationProperties {
     groupId?: string;
     requiredMembers?: string[];
     requiredZoneNames?: string[];
@@ -374,6 +389,24 @@ export enum KnownConnectionPropertiesProvisioningState {
     Rejected = "Rejected"
 }
 
+// @public
+export enum KnownConnectionType {
+    // (undocumented)
+    AzureDataExplorer = "AzureDataExplorer"
+}
+
+// @public
+export enum KnownCreatedByType {
+    // (undocumented)
+    Application = "Application",
+    // (undocumented)
+    Key = "Key",
+    // (undocumented)
+    ManagedIdentity = "ManagedIdentity",
+    // (undocumented)
+    User = "User"
+}
+
 // @public
 export enum KnownDigitalTwinsIdentityType {
     // (undocumented)
@@ -472,12 +505,41 @@ export enum KnownReason {
     Invalid = "Invalid"
 }
 
+// @public
+export enum KnownTimeSeriesDatabaseConnectionState {
+    // (undocumented)
+    Canceled = "Canceled",
+    // (undocumented)
+    Deleted = "Deleted",
+    // (undocumented)
+    Deleting = "Deleting",
+    // (undocumented)
+    Disabled = "Disabled",
+    // (undocumented)
+    Failed = "Failed",
+    // (undocumented)
+    Moving = "Moving",
+    // (undocumented)
+    Provisioning = "Provisioning",
+    // (undocumented)
+    Restoring = "Restoring",
+    // (undocumented)
+    Succeeded = "Succeeded",
+    // (undocumented)
+    Suspending = "Suspending",
+    // (undocumented)
+    Warning = "Warning"
+}
+
 // @public
 export interface Operation {
     display?: OperationDisplay;
     readonly isDataAction?: boolean;
     readonly name?: string;
     readonly origin?: string;
+    readonly properties?: {
+        [propertyName: string]: Record<string, unknown>;
+    };
 }
 
 // @public
@@ -522,14 +584,11 @@ export interface PrivateEndpoint {
 export interface PrivateEndpointConnection {
     readonly id?: string;
     readonly name?: string;
-    // (undocumented)
-    properties: PrivateEndpointConnectionProperties;
+    properties: ConnectionProperties;
+    readonly systemData?: SystemData;
     readonly type?: string;
 }
 
-// @public (undocumented)
-export type PrivateEndpointConnectionProperties = ConnectionProperties & {};
-
 // @public
 export interface PrivateEndpointConnections {
     beginCreateOrUpdate(resourceGroupName: string, resourceName: string, privateEndpointConnectionName: string, privateEndpointConnection: PrivateEndpointConnection, options?: PrivateEndpointConnectionsCreateOrUpdateOptionalParams): Promise<PollerLike<PollOperationState<PrivateEndpointConnectionsCreateOrUpdateResponse>, PrivateEndpointConnectionsCreateOrUpdateResponse>>;
@@ -615,6 +674,88 @@ export type ServiceBus = DigitalTwinsEndpointResourceProperties & {
     entityPath?: string;
 };
 
+// @public
+export interface SystemData {
+    createdAt?: Date;
+    createdBy?: string;
+    createdByType?: CreatedByType;
+    lastModifiedAt?: Date;
+    lastModifiedBy?: string;
+    lastModifiedByType?: CreatedByType;
+}
+
+// @public
+export type TimeSeriesDatabaseConnection = ExternalResource & {
+    properties?: TimeSeriesDatabaseConnectionPropertiesUnion;
+};
+
+// @public
+export interface TimeSeriesDatabaseConnectionListResult {
+    nextLink?: string;
+    value?: TimeSeriesDatabaseConnection[];
+}
+
+// @public
+export interface TimeSeriesDatabaseConnectionProperties {
+    connectionType: "AzureDataExplorer";
+    readonly provisioningState?: TimeSeriesDatabaseConnectionState;
+}
+
+// @public (undocumented)
+export type TimeSeriesDatabaseConnectionPropertiesUnion = TimeSeriesDatabaseConnectionProperties | AzureDataExplorerConnectionProperties;
+
+// @public
+export interface TimeSeriesDatabaseConnections {
+    beginCreateOrUpdate(resourceGroupName: string, resourceName: string, timeSeriesDatabaseConnectionName: string, timeSeriesDatabaseConnectionDescription: TimeSeriesDatabaseConnection, options?: TimeSeriesDatabaseConnectionsCreateOrUpdateOptionalParams): Promise<PollerLike<PollOperationState<TimeSeriesDatabaseConnectionsCreateOrUpdateResponse>, TimeSeriesDatabaseConnectionsCreateOrUpdateResponse>>;
+    beginCreateOrUpdateAndWait(resourceGroupName: string, resourceName: string, timeSeriesDatabaseConnectionName: string, timeSeriesDatabaseConnectionDescription: TimeSeriesDatabaseConnection, options?: TimeSeriesDatabaseConnectionsCreateOrUpdateOptionalParams): Promise<TimeSeriesDatabaseConnectionsCreateOrUpdateResponse>;
+    beginDelete(resourceGroupName: string, resourceName: string, timeSeriesDatabaseConnectionName: string, options?: TimeSeriesDatabaseConnectionsDeleteOptionalParams): Promise<PollerLike<PollOperationState<TimeSeriesDatabaseConnectionsDeleteResponse>, TimeSeriesDatabaseConnectionsDeleteResponse>>;
+    beginDeleteAndWait(resourceGroupName: string, resourceName: string, timeSeriesDatabaseConnectionName: string, options?: TimeSeriesDatabaseConnectionsDeleteOptionalParams): Promise<TimeSeriesDatabaseConnectionsDeleteResponse>;
+    get(resourceGroupName: string, resourceName: string, timeSeriesDatabaseConnectionName: string, options?: TimeSeriesDatabaseConnectionsGetOptionalParams): Promise<TimeSeriesDatabaseConnectionsGetResponse>;
+    list(resourceGroupName: string, resourceName: string, options?: TimeSeriesDatabaseConnectionsListOptionalParams): PagedAsyncIterableIterator<TimeSeriesDatabaseConnection>;
+}
+
+// @public
+export interface TimeSeriesDatabaseConnectionsCreateOrUpdateOptionalParams extends coreClient.OperationOptions {
+    resumeFrom?: string;
+    updateIntervalInMs?: number;
+}
+
+// @public
+export type TimeSeriesDatabaseConnectionsCreateOrUpdateResponse = TimeSeriesDatabaseConnection;
+
+// @public
+export interface TimeSeriesDatabaseConnectionsDeleteOptionalParams extends coreClient.OperationOptions {
+    resumeFrom?: string;
+    updateIntervalInMs?: number;
+}
+
+// @public
+export type TimeSeriesDatabaseConnectionsDeleteResponse = TimeSeriesDatabaseConnection;
+
+// @public
+export interface TimeSeriesDatabaseConnectionsGetOptionalParams extends coreClient.OperationOptions {
+}
+
+// @public
+export type TimeSeriesDatabaseConnectionsGetResponse = TimeSeriesDatabaseConnection;
+
+// @public
+export interface TimeSeriesDatabaseConnectionsListNextOptionalParams extends coreClient.OperationOptions {
+}
+
+// @public
+export type TimeSeriesDatabaseConnectionsListNextResponse = TimeSeriesDatabaseConnectionListResult;
+
+// @public
+export interface TimeSeriesDatabaseConnectionsListOptionalParams extends coreClient.OperationOptions {
+}
+
+// @public
+export type TimeSeriesDatabaseConnectionsListResponse = TimeSeriesDatabaseConnectionListResult;
+
+// @public
+export type TimeSeriesDatabaseConnectionState = string;
+
 // (No @packageDocumentation comment for this package)
 
 ```