@azure/arm-selfhelp 2.0.0-beta.1 → 2.0.0-beta.3

package/src/operations/discoverySolution.ts

@@ -18,7 +18,7 @@ import {
   DiscoverySolutionListNextOptionalParams,
   DiscoverySolutionListOptionalParams,
   DiscoverySolutionListResponse,
-  DiscoverySolutionListNextResponse
+  DiscoverySolutionListNextResponse,
 } from "../models";
 
 /// <reference lib="esnext.asynciterable" />
@@ -35,25 +35,21 @@ export class DiscoverySolutionImpl implements DiscoverySolution {
   }
 
   /**
-   * Lists the relevant Azure diagnostics and solutions using [problemClassification
+   * Lists the relevant Azure Diagnostics, Solutions and Troubleshooters using [problemClassification
    * API](https://learn.microsoft.com/rest/api/support/problem-classifications/list?tabs=HTTP)) AND
    * resourceUri or resourceType.<br/> Discovery Solutions is the initial entry point within Help API,
-   * which identifies relevant Azure diagnostics and solutions. We will do our best to return the most
-   * effective solutions based on the type of inputs, in the request URL  <br/><br/> Mandatory input :
+   * which identifies relevant Azure diagnostics and solutions. <br/><br/> Required Input :
    * problemClassificationId (Use the [problemClassification
    * API](https://learn.microsoft.com/rest/api/support/problem-classifications/list?tabs=HTTP))
    * <br/>Optional input: resourceUri OR resource Type <br/><br/> <b>Note: </b>  ‘requiredInputs’ from
    * Discovery solutions response must be passed via ‘additionalParameters’ as an input to Diagnostics
    * and Solutions API.
-   * @param scope This is an extension resource provider and only resource level extension is supported
-   *              at the moment.
    * @param options The options parameters.
    */
   public list(
-    scope: string,
-    options?: DiscoverySolutionListOptionalParams
+    options?: DiscoverySolutionListOptionalParams,
   ): PagedAsyncIterableIterator<SolutionMetadataResource> {
-    const iter = this.listPagingAll(scope, options);
+    const iter = this.listPagingAll(options);
     return {
       next() {
         return iter.next();
@@ -65,27 +61,26 @@ export class DiscoverySolutionImpl implements DiscoverySolution {
         if (settings?.maxPageSize) {
           throw new Error("maxPageSize is not supported by this operation.");
         }
-        return this.listPagingPage(scope, options, settings);
-      }
+        return this.listPagingPage(options, settings);
+      },
     };
   }
 
   private async *listPagingPage(
-    scope: string,
     options?: DiscoverySolutionListOptionalParams,
-    settings?: PageSettings
+    settings?: PageSettings,
   ): AsyncIterableIterator<SolutionMetadataResource[]> {
     let result: DiscoverySolutionListResponse;
     let continuationToken = settings?.continuationToken;
     if (!continuationToken) {
-      result = await this._list(scope, options);
+      result = await this._list(options);
       let page = result.value || [];
       continuationToken = result.nextLink;
       setContinuationToken(page, continuationToken);
       yield page;
     }
     while (continuationToken) {
-      result = await this._listNext(scope, continuationToken, options);
+      result = await this._listNext(continuationToken, options);
       continuationToken = result.nextLink;
       let page = result.value || [];
       setContinuationToken(page, continuationToken);
@@ -94,54 +89,43 @@ export class DiscoverySolutionImpl implements DiscoverySolution {
   }
 
   private async *listPagingAll(
-    scope: string,
-    options?: DiscoverySolutionListOptionalParams
+    options?: DiscoverySolutionListOptionalParams,
   ): AsyncIterableIterator<SolutionMetadataResource> {
-    for await (const page of this.listPagingPage(scope, options)) {
+    for await (const page of this.listPagingPage(options)) {
       yield* page;
     }
   }
 
   /**
-   * Lists the relevant Azure diagnostics and solutions using [problemClassification
+   * Lists the relevant Azure Diagnostics, Solutions and Troubleshooters using [problemClassification
    * API](https://learn.microsoft.com/rest/api/support/problem-classifications/list?tabs=HTTP)) AND
    * resourceUri or resourceType.<br/> Discovery Solutions is the initial entry point within Help API,
-   * which identifies relevant Azure diagnostics and solutions. We will do our best to return the most
-   * effective solutions based on the type of inputs, in the request URL  <br/><br/> Mandatory input :
+   * which identifies relevant Azure diagnostics and solutions. <br/><br/> Required Input :
    * problemClassificationId (Use the [problemClassification
    * API](https://learn.microsoft.com/rest/api/support/problem-classifications/list?tabs=HTTP))
    * <br/>Optional input: resourceUri OR resource Type <br/><br/> <b>Note: </b>  ‘requiredInputs’ from
    * Discovery solutions response must be passed via ‘additionalParameters’ as an input to Diagnostics
    * and Solutions API.
-   * @param scope This is an extension resource provider and only resource level extension is supported
-   *              at the moment.
    * @param options The options parameters.
    */
   private _list(
-    scope: string,
-    options?: DiscoverySolutionListOptionalParams
+    options?: DiscoverySolutionListOptionalParams,
   ): Promise<DiscoverySolutionListResponse> {
-    return this.client.sendOperationRequest(
-      { scope, options },
-      listOperationSpec
-    );
+    return this.client.sendOperationRequest({ options }, listOperationSpec);
   }
 
   /**
    * ListNext
-   * @param scope This is an extension resource provider and only resource level extension is supported
-   *              at the moment.
    * @param nextLink The nextLink from the previous successful call to the List method.
    * @param options The options parameters.
    */
   private _listNext(
-    scope: string,
     nextLink: string,
-    options?: DiscoverySolutionListNextOptionalParams
+    options?: DiscoverySolutionListNextOptionalParams,
   ): Promise<DiscoverySolutionListNextResponse> {
     return this.client.sendOperationRequest(
-      { scope, nextLink, options },
-      listNextOperationSpec
+      { nextLink, options },
+      listNextOperationSpec,
     );
   }
 }
@@ -149,37 +133,37 @@ export class DiscoverySolutionImpl implements DiscoverySolution {
 const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
 
 const listOperationSpec: coreClient.OperationSpec = {
-  path: "/{scope}/providers/Microsoft.Help/discoverySolutions",
+  path: "/providers/Microsoft.Help/discoverySolutions",
   httpMethod: "GET",
   responses: {
     200: {
-      bodyMapper: Mappers.DiscoveryResponse
+      bodyMapper: Mappers.DiscoveryResponse,
     },
     default: {
-      bodyMapper: Mappers.ErrorResponse
-    }
+      bodyMapper: Mappers.ErrorResponse,
+    },
   },
   queryParameters: [
     Parameters.apiVersion,
     Parameters.filter,
-    Parameters.skiptoken
+    Parameters.skiptoken,
   ],
-  urlParameters: [Parameters.$host, Parameters.scope],
+  urlParameters: [Parameters.$host],
   headerParameters: [Parameters.accept],
-  serializer
+  serializer,
 };
 const listNextOperationSpec: coreClient.OperationSpec = {
   path: "{nextLink}",
   httpMethod: "GET",
   responses: {
     200: {
-      bodyMapper: Mappers.DiscoveryResponse
+      bodyMapper: Mappers.DiscoveryResponse,
     },
     default: {
-      bodyMapper: Mappers.ErrorResponse
-    }
+      bodyMapper: Mappers.ErrorResponse,
+    },
   },
-  urlParameters: [Parameters.$host, Parameters.nextLink, Parameters.scope],
+  urlParameters: [Parameters.$host, Parameters.nextLink],
   headerParameters: [Parameters.accept],
-  serializer
+  serializer,
 };

package/src/operations/discoverySolutionNLPSubscriptionScope.ts

@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * Code generated by Microsoft (R) AutoRest Code Generator.
+ * Changes may cause incorrect behavior and will be lost if the code is regenerated.
+ */
+
+import { DiscoverySolutionNLPSubscriptionScope } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
+import * as Parameters from "../models/parameters";
+import { HelpRP } from "../helpRP";
+import {
+  DiscoverySolutionNLPSubscriptionScopePostOptionalParams,
+  DiscoverySolutionNLPSubscriptionScopePostResponse,
+} from "../models";
+
+/** Class containing DiscoverySolutionNLPSubscriptionScope operations. */
+export class DiscoverySolutionNLPSubscriptionScopeImpl
+  implements DiscoverySolutionNLPSubscriptionScope
+{
+  private readonly client: HelpRP;
+
+  /**
+   * Initialize a new instance of the class DiscoverySolutionNLPSubscriptionScope class.
+   * @param client Reference to the service client
+   */
+  constructor(client: HelpRP) {
+    this.client = client;
+  }
+
+  /**
+   * Search for relevant Azure Diagnostics, Solutions and Troubleshooters using a natural language issue
+   * summary and subscription.
+   * @param options The options parameters.
+   */
+  post(
+    options?: DiscoverySolutionNLPSubscriptionScopePostOptionalParams,
+  ): Promise<DiscoverySolutionNLPSubscriptionScopePostResponse> {
+    return this.client.sendOperationRequest({ options }, postOperationSpec);
+  }
+}
+// Operation Specifications
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const postOperationSpec: coreClient.OperationSpec = {
+  path: "/subscriptions/{subscriptionId}/providers/Microsoft.Help/discoverSolutions",
+  httpMethod: "POST",
+  responses: {
+    200: {
+      bodyMapper: Mappers.DiscoveryNlpResponse,
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse,
+    },
+  },
+  requestBody: Parameters.discoverSolutionRequest,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host, Parameters.subscriptionId],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
+  serializer,
+};

package/src/operations/discoverySolutionNLPTenantScope.ts

@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * Code generated by Microsoft (R) AutoRest Code Generator.
+ * Changes may cause incorrect behavior and will be lost if the code is regenerated.
+ */
+
+import { DiscoverySolutionNLPTenantScope } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
+import * as Parameters from "../models/parameters";
+import { HelpRP } from "../helpRP";
+import {
+  DiscoverySolutionNLPTenantScopePostOptionalParams,
+  DiscoverySolutionNLPTenantScopePostResponse,
+} from "../models";
+
+/** Class containing DiscoverySolutionNLPTenantScope operations. */
+export class DiscoverySolutionNLPTenantScopeImpl
+  implements DiscoverySolutionNLPTenantScope
+{
+  private readonly client: HelpRP;
+
+  /**
+   * Initialize a new instance of the class DiscoverySolutionNLPTenantScope class.
+   * @param client Reference to the service client
+   */
+  constructor(client: HelpRP) {
+    this.client = client;
+  }
+
+  /**
+   * Search for relevant Azure Diagnostics, Solutions and Troubleshooters using a natural language issue
+   * summary.
+   * @param options The options parameters.
+   */
+  post(
+    options?: DiscoverySolutionNLPTenantScopePostOptionalParams,
+  ): Promise<DiscoverySolutionNLPTenantScopePostResponse> {
+    return this.client.sendOperationRequest({ options }, postOperationSpec);
+  }
+}
+// Operation Specifications
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const postOperationSpec: coreClient.OperationSpec = {
+  path: "/providers/Microsoft.Help/discoverSolutions",
+  httpMethod: "POST",
+  responses: {
+    200: {
+      bodyMapper: Mappers.DiscoveryNlpResponse,
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse,
+    },
+  },
+  requestBody: Parameters.discoverSolutionRequest,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
+  serializer,
+};

package/src/operations/index.ts

@@ -11,4 +11,8 @@ export * from "./checkNameAvailability";
 export * from "./diagnostics";
 export * from "./discoverySolution";
 export * from "./solution";
+export * from "./simplifiedSolutions";
 export * from "./troubleshooters";
+export * from "./solutionSelfHelp";
+export * from "./discoverySolutionNLPTenantScope";
+export * from "./discoverySolutionNLPSubscriptionScope";

package/src/operations/operations.ts

@@ -18,7 +18,7 @@ import {
   OperationsListNextOptionalParams,
   OperationsListOptionalParams,
   OperationsListResponse,
-  OperationsListNextResponse
+  OperationsListNextResponse,
 } from "../models";
 
 /// <reference lib="esnext.asynciterable" />
@@ -39,7 +39,7 @@ export class OperationsImpl implements Operations {
    * @param options The options parameters.
    */
   public list(
-    options?: OperationsListOptionalParams
+    options?: OperationsListOptionalParams,
   ): PagedAsyncIterableIterator<Operation> {
     const iter = this.listPagingAll(options);
     return {
@@ -54,13 +54,13 @@ export class OperationsImpl implements Operations {
           throw new Error("maxPageSize is not supported by this operation.");
         }
         return this.listPagingPage(options, settings);
-      }
+      },
     };
   }
 
   private async *listPagingPage(
     options?: OperationsListOptionalParams,
-    settings?: PageSettings
+    settings?: PageSettings,
   ): AsyncIterableIterator<Operation[]> {
     let result: OperationsListResponse;
     let continuationToken = settings?.continuationToken;
@@ -81,7 +81,7 @@ export class OperationsImpl implements Operations {
   }
 
   private async *listPagingAll(
-    options?: OperationsListOptionalParams
+    options?: OperationsListOptionalParams,
   ): AsyncIterableIterator<Operation> {
     for await (const page of this.listPagingPage(options)) {
       yield* page;
@@ -93,7 +93,7 @@ export class OperationsImpl implements Operations {
    * @param options The options parameters.
    */
   private _list(
-    options?: OperationsListOptionalParams
+    options?: OperationsListOptionalParams,
   ): Promise<OperationsListResponse> {
     return this.client.sendOperationRequest({ options }, listOperationSpec);
   }
@@ -105,11 +105,11 @@ export class OperationsImpl implements Operations {
    */
   private _listNext(
     nextLink: string,
-    options?: OperationsListNextOptionalParams
+    options?: OperationsListNextOptionalParams,
   ): Promise<OperationsListNextResponse> {
     return this.client.sendOperationRequest(
       { nextLink, options },
-      listNextOperationSpec
+      listNextOperationSpec,
     );
   }
 }
@@ -121,29 +121,29 @@ const listOperationSpec: coreClient.OperationSpec = {
   httpMethod: "GET",
   responses: {
     200: {
-      bodyMapper: Mappers.OperationListResult
+      bodyMapper: Mappers.OperationListResult,
     },
     default: {
-      bodyMapper: Mappers.ErrorResponse
-    }
+      bodyMapper: Mappers.ErrorResponse,
+    },
   },
   queryParameters: [Parameters.apiVersion],
   urlParameters: [Parameters.$host],
   headerParameters: [Parameters.accept],
-  serializer
+  serializer,
 };
 const listNextOperationSpec: coreClient.OperationSpec = {
   path: "{nextLink}",
   httpMethod: "GET",
   responses: {
     200: {
-      bodyMapper: Mappers.OperationListResult
+      bodyMapper: Mappers.OperationListResult,
     },
     default: {
-      bodyMapper: Mappers.ErrorResponse
-    }
+      bodyMapper: Mappers.ErrorResponse,
+    },
   },
   urlParameters: [Parameters.$host, Parameters.nextLink],
   headerParameters: [Parameters.accept],
-  serializer
+  serializer,
 };

package/src/operations/simplifiedSolutions.ts

@@ -0,0 +1,216 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * Code generated by Microsoft (R) AutoRest Code Generator.
+ * Changes may cause incorrect behavior and will be lost if the code is regenerated.
+ */
+
+import { SimplifiedSolutions } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
+import * as Parameters from "../models/parameters";
+import { HelpRP } from "../helpRP";
+import {
+  SimplePollerLike,
+  OperationState,
+  createHttpPoller,
+} from "@azure/core-lro";
+import { createLroSpec } from "../lroImpl";
+import {
+  SimplifiedSolutionsCreateOptionalParams,
+  SimplifiedSolutionsCreateResponse,
+  SimplifiedSolutionsGetOptionalParams,
+  SimplifiedSolutionsGetResponse,
+} from "../models";
+
+/** Class containing SimplifiedSolutions operations. */
+export class SimplifiedSolutionsImpl implements SimplifiedSolutions {
+  private readonly client: HelpRP;
+
+  /**
+   * Initialize a new instance of the class SimplifiedSolutions class.
+   * @param client Reference to the service client
+   */
+  constructor(client: HelpRP) {
+    this.client = client;
+  }
+
+  /**
+   * Creates Simplified Solutions for an Azure subscription using 'solutionId' from Discovery Solutions
+   * as the input. <br/><br/> Simplified Solutions API makes the consumption of solutions APIs easier
+   * while still providing access to the same powerful solutions rendered in Solutions API. With
+   * Simplified Solutions, users don't have to worry about stitching together the article using
+   * replacement maps and can use the content in the API response to directly render as HTML
+   * content.<br/>
+   * @param scope scope = resourceUri of affected resource.<br/> For example:
+   *              /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read
+   *
+   * @param simplifiedSolutionsResourceName Simplified Solutions Resource Name.
+   * @param options The options parameters.
+   */
+  async beginCreate(
+    scope: string,
+    simplifiedSolutionsResourceName: string,
+    options?: SimplifiedSolutionsCreateOptionalParams,
+  ): Promise<
+    SimplePollerLike<
+      OperationState<SimplifiedSolutionsCreateResponse>,
+      SimplifiedSolutionsCreateResponse
+    >
+  > {
+    const directSendOperation = async (
+      args: coreClient.OperationArguments,
+      spec: coreClient.OperationSpec,
+    ): Promise<SimplifiedSolutionsCreateResponse> => {
+      return this.client.sendOperationRequest(args, spec);
+    };
+    const sendOperationFn = async (
+      args: coreClient.OperationArguments,
+      spec: coreClient.OperationSpec,
+    ) => {
+      let currentRawResponse: coreClient.FullOperationResponse | undefined =
+        undefined;
+      const providedCallback = args.options?.onResponse;
+      const callback: coreClient.RawResponseCallback = (
+        rawResponse: coreClient.FullOperationResponse,
+        flatResponse: unknown,
+      ) => {
+        currentRawResponse = rawResponse;
+        providedCallback?.(rawResponse, flatResponse);
+      };
+      const updatedArgs = {
+        ...args,
+        options: {
+          ...args.options,
+          onResponse: callback,
+        },
+      };
+      const flatResponse = await directSendOperation(updatedArgs, spec);
+      return {
+        flatResponse,
+        rawResponse: {
+          statusCode: currentRawResponse!.status,
+          body: currentRawResponse!.parsedBody,
+          headers: currentRawResponse!.headers.toJSON(),
+        },
+      };
+    };
+
+    const lro = createLroSpec({
+      sendOperationFn,
+      args: { scope, simplifiedSolutionsResourceName, options },
+      spec: createOperationSpec,
+    });
+    const poller = await createHttpPoller<
+      SimplifiedSolutionsCreateResponse,
+      OperationState<SimplifiedSolutionsCreateResponse>
+    >(lro, {
+      restoreFrom: options?.resumeFrom,
+      intervalInMs: options?.updateIntervalInMs,
+      resourceLocationConfig: "azure-async-operation",
+    });
+    await poller.poll();
+    return poller;
+  }
+
+  /**
+   * Creates Simplified Solutions for an Azure subscription using 'solutionId' from Discovery Solutions
+   * as the input. <br/><br/> Simplified Solutions API makes the consumption of solutions APIs easier
+   * while still providing access to the same powerful solutions rendered in Solutions API. With
+   * Simplified Solutions, users don't have to worry about stitching together the article using
+   * replacement maps and can use the content in the API response to directly render as HTML
+   * content.<br/>
+   * @param scope scope = resourceUri of affected resource.<br/> For example:
+   *              /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read
+   *
+   * @param simplifiedSolutionsResourceName Simplified Solutions Resource Name.
+   * @param options The options parameters.
+   */
+  async beginCreateAndWait(
+    scope: string,
+    simplifiedSolutionsResourceName: string,
+    options?: SimplifiedSolutionsCreateOptionalParams,
+  ): Promise<SimplifiedSolutionsCreateResponse> {
+    const poller = await this.beginCreate(
+      scope,
+      simplifiedSolutionsResourceName,
+      options,
+    );
+    return poller.pollUntilDone();
+  }
+
+  /**
+   * Get the simplified Solutions using the applicable solutionResourceName while creating the simplified
+   * Solutions.
+   * @param scope scope = resourceUri of affected resource.<br/> For example:
+   *              /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read
+   *
+   * @param simplifiedSolutionsResourceName Simplified Solutions Resource Name.
+   * @param options The options parameters.
+   */
+  get(
+    scope: string,
+    simplifiedSolutionsResourceName: string,
+    options?: SimplifiedSolutionsGetOptionalParams,
+  ): Promise<SimplifiedSolutionsGetResponse> {
+    return this.client.sendOperationRequest(
+      { scope, simplifiedSolutionsResourceName, options },
+      getOperationSpec,
+    );
+  }
+}
+// Operation Specifications
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const createOperationSpec: coreClient.OperationSpec = {
+  path: "/{scope}/providers/Microsoft.Help/simplifiedSolutions/{simplifiedSolutionsResourceName}",
+  httpMethod: "PUT",
+  responses: {
+    200: {
+      bodyMapper: Mappers.SimplifiedSolutionsResource,
+    },
+    201: {
+      bodyMapper: Mappers.SimplifiedSolutionsResource,
+    },
+    202: {
+      bodyMapper: Mappers.SimplifiedSolutionsResource,
+    },
+    204: {
+      bodyMapper: Mappers.SimplifiedSolutionsResource,
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse,
+    },
+  },
+  requestBody: Parameters.simplifiedSolutionsRequestBody,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.scope,
+    Parameters.simplifiedSolutionsResourceName,
+  ],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
+  serializer,
+};
+const getOperationSpec: coreClient.OperationSpec = {
+  path: "/{scope}/providers/Microsoft.Help/simplifiedSolutions/{simplifiedSolutionsResourceName}",
+  httpMethod: "GET",
+  responses: {
+    200: {
+      bodyMapper: Mappers.SimplifiedSolutionsResource,
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse,
+    },
+  },
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.scope,
+    Parameters.simplifiedSolutionsResourceName,
+  ],
+  headerParameters: [Parameters.accept],
+  serializer,
+};