@azure/arm-frontdoor 4.1.1 → 5.0.0

package/src/operations/policies.ts

@@ -1,90 +1,125 @@
 /*
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the MIT License. See License.txt in the project root for
- * license information.
+ * 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.
+ * Changes may cause incorrect behavior and will be lost if the code is regenerated.
  */
 
-import * as msRest from "@azure/ms-rest-js";
-import * as msRestAzure from "@azure/ms-rest-azure-js";
-import * as Models from "../models";
-import * as Mappers from "../models/policiesMappers";
+import { PagedAsyncIterableIterator } from "@azure/core-paging";
+import { Policies } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
 import * as Parameters from "../models/parameters";
-import { FrontDoorManagementClientContext } from "../frontDoorManagementClientContext";
+import { FrontDoorManagementClient } from "../frontDoorManagementClient";
+import { PollerLike, PollOperationState, LroEngine } from "@azure/core-lro";
+import { LroImpl } from "../lroImpl";
+import {
+  WebApplicationFirewallPolicy,
+  PoliciesListNextOptionalParams,
+  PoliciesListOptionalParams,
+  PoliciesListResponse,
+  PoliciesGetOptionalParams,
+  PoliciesGetResponse,
+  PoliciesCreateOrUpdateOptionalParams,
+  PoliciesCreateOrUpdateResponse,
+  PoliciesDeleteOptionalParams,
+  PoliciesListNextResponse
+} from "../models";
 
-/** Class representing a Policies. */
-export class Policies {
-  private readonly client: FrontDoorManagementClientContext;
+/// <reference lib="esnext.asynciterable" />
+/** Class containing Policies operations. */
+export class PoliciesImpl implements Policies {
+  private readonly client: FrontDoorManagementClient;
 
   /**
-   * Create a Policies.
-   * @param {FrontDoorManagementClientContext} client Reference to the service client.
+   * Initialize a new instance of the class Policies class.
+   * @param client Reference to the service client
    */
-  constructor(client: FrontDoorManagementClientContext) {
+  constructor(client: FrontDoorManagementClient) {
     this.client = client;
   }
 
   /**
    * Lists all of the protection policies within a resource group.
    * @param resourceGroupName Name of the Resource group within the Azure subscription.
-   * @param [options] The optional parameters
-   * @returns Promise<Models.PoliciesListResponse>
+   * @param options The options parameters.
    */
-  list(resourceGroupName: string, options?: msRest.RequestOptionsBase): Promise<Models.PoliciesListResponse>;
-  /**
-   * @param resourceGroupName Name of the Resource group within the Azure subscription.
-   * @param callback The callback
-   */
-  list(resourceGroupName: string, callback: msRest.ServiceCallback<Models.WebApplicationFirewallPolicyList>): void;
-  /**
-   * @param resourceGroupName Name of the Resource group within the Azure subscription.
-   * @param options The optional parameters
-   * @param callback The callback
-   */
-  list(resourceGroupName: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.WebApplicationFirewallPolicyList>): void;
-  list(resourceGroupName: string, options?: msRest.RequestOptionsBase | msRest.ServiceCallback<Models.WebApplicationFirewallPolicyList>, callback?: msRest.ServiceCallback<Models.WebApplicationFirewallPolicyList>): Promise<Models.PoliciesListResponse> {
-    return this.client.sendOperationRequest(
-      {
+  public list(
+    resourceGroupName: string,
+    options?: PoliciesListOptionalParams
+  ): PagedAsyncIterableIterator<WebApplicationFirewallPolicy> {
+    const iter = this.listPagingAll(resourceGroupName, options);
+    return {
+      next() {
+        return iter.next();
+      },
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+      byPage: () => {
+        return this.listPagingPage(resourceGroupName, options);
+      }
+    };
+  }
+
+  private async *listPagingPage(
+    resourceGroupName: string,
+    options?: PoliciesListOptionalParams
+  ): AsyncIterableIterator<WebApplicationFirewallPolicy[]> {
+    let result = await this._list(resourceGroupName, options);
+    yield result.value || [];
+    let continuationToken = result.nextLink;
+    while (continuationToken) {
+      result = await this._listNext(
         resourceGroupName,
+        continuationToken,
         options
-      },
-      listOperationSpec,
-      callback) as Promise<Models.PoliciesListResponse>;
+      );
+      continuationToken = result.nextLink;
+      yield result.value || [];
+    }
+  }
+
+  private async *listPagingAll(
+    resourceGroupName: string,
+    options?: PoliciesListOptionalParams
+  ): AsyncIterableIterator<WebApplicationFirewallPolicy> {
+    for await (const page of this.listPagingPage(resourceGroupName, options)) {
+      yield* page;
+    }
   }
 
   /**
-   * Retrieve protection policy with specified name within a resource group.
-   * @param resourceGroupName Name of the Resource group within the Azure subscription.
-   * @param policyName The name of the Web Application Firewall Policy.
-   * @param [options] The optional parameters
-   * @returns Promise<Models.PoliciesGetResponse>
-   */
-  get(resourceGroupName: string, policyName: string, options?: msRest.RequestOptionsBase): Promise<Models.PoliciesGetResponse>;
-  /**
+   * Lists all of the protection policies within a resource group.
    * @param resourceGroupName Name of the Resource group within the Azure subscription.
-   * @param policyName The name of the Web Application Firewall Policy.
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  get(resourceGroupName: string, policyName: string, callback: msRest.ServiceCallback<Models.WebApplicationFirewallPolicy>): void;
+  private _list(
+    resourceGroupName: string,
+    options?: PoliciesListOptionalParams
+  ): Promise<PoliciesListResponse> {
+    return this.client.sendOperationRequest(
+      { resourceGroupName, options },
+      listOperationSpec
+    );
+  }
+
   /**
+   * Retrieve protection policy with specified name within a resource group.
    * @param resourceGroupName Name of the Resource group within the Azure subscription.
    * @param policyName The name of the Web Application Firewall Policy.
-   * @param options The optional parameters
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  get(resourceGroupName: string, policyName: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.WebApplicationFirewallPolicy>): void;
-  get(resourceGroupName: string, policyName: string, options?: msRest.RequestOptionsBase | msRest.ServiceCallback<Models.WebApplicationFirewallPolicy>, callback?: msRest.ServiceCallback<Models.WebApplicationFirewallPolicy>): Promise<Models.PoliciesGetResponse> {
+  get(
+    resourceGroupName: string,
+    policyName: string,
+    options?: PoliciesGetOptionalParams
+  ): Promise<PoliciesGetResponse> {
     return this.client.sendOperationRequest(
-      {
-        resourceGroupName,
-        policyName,
-        options
-      },
-      getOperationSpec,
-      callback) as Promise<Models.PoliciesGetResponse>;
+      { resourceGroupName, policyName, options },
+      getOperationSpec
+    );
   }
 
   /**
@@ -92,108 +127,195 @@ export class Policies {
    * @param resourceGroupName Name of the Resource group within the Azure subscription.
    * @param policyName The name of the Web Application Firewall Policy.
    * @param parameters Policy to be created.
-   * @param [options] The optional parameters
-   * @returns Promise<Models.PoliciesCreateOrUpdateResponse>
+   * @param options The options parameters.
    */
-  createOrUpdate(resourceGroupName: string, policyName: string, parameters: Models.WebApplicationFirewallPolicy, options?: msRest.RequestOptionsBase): Promise<Models.PoliciesCreateOrUpdateResponse> {
-    return this.beginCreateOrUpdate(resourceGroupName,policyName,parameters,options)
-      .then(lroPoller => lroPoller.pollUntilFinished()) as Promise<Models.PoliciesCreateOrUpdateResponse>;
+  async beginCreateOrUpdate(
+    resourceGroupName: string,
+    policyName: string,
+    parameters: WebApplicationFirewallPolicy,
+    options?: PoliciesCreateOrUpdateOptionalParams
+  ): Promise<
+    PollerLike<
+      PollOperationState<PoliciesCreateOrUpdateResponse>,
+      PoliciesCreateOrUpdateResponse
+    >
+  > {
+    const directSendOperation = async (
+      args: coreClient.OperationArguments,
+      spec: coreClient.OperationSpec
+    ): Promise<PoliciesCreateOrUpdateResponse> => {
+      return this.client.sendOperationRequest(args, spec);
+    };
+    const sendOperation = 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 = new LroImpl(
+      sendOperation,
+      { resourceGroupName, policyName, parameters, options },
+      createOrUpdateOperationSpec
+    );
+    return new LroEngine(lro, {
+      resumeFrom: options?.resumeFrom,
+      intervalInMs: options?.updateIntervalInMs
+    });
   }
 
   /**
-   * Deletes Policy
+   * Create or update policy with specified rule set name within a resource group.
    * @param resourceGroupName Name of the Resource group within the Azure subscription.
    * @param policyName The name of the Web Application Firewall Policy.
-   * @param [options] The optional parameters
-   * @returns Promise<msRest.RestResponse>
+   * @param parameters Policy to be created.
+   * @param options The options parameters.
    */
-  deleteMethod(resourceGroupName: string, policyName: string, options?: msRest.RequestOptionsBase): Promise<msRest.RestResponse> {
-    return this.beginDeleteMethod(resourceGroupName,policyName,options)
-      .then(lroPoller => lroPoller.pollUntilFinished());
+  async beginCreateOrUpdateAndWait(
+    resourceGroupName: string,
+    policyName: string,
+    parameters: WebApplicationFirewallPolicy,
+    options?: PoliciesCreateOrUpdateOptionalParams
+  ): Promise<PoliciesCreateOrUpdateResponse> {
+    const poller = await this.beginCreateOrUpdate(
+      resourceGroupName,
+      policyName,
+      parameters,
+      options
+    );
+    return poller.pollUntilDone();
   }
 
   /**
-   * Create or update policy with specified rule set name within a resource group.
+   * Deletes Policy
    * @param resourceGroupName Name of the Resource group within the Azure subscription.
    * @param policyName The name of the Web Application Firewall Policy.
-   * @param parameters Policy to be created.
-   * @param [options] The optional parameters
-   * @returns Promise<msRestAzure.LROPoller>
+   * @param options The options parameters.
    */
-  beginCreateOrUpdate(resourceGroupName: string, policyName: string, parameters: Models.WebApplicationFirewallPolicy, options?: msRest.RequestOptionsBase): Promise<msRestAzure.LROPoller> {
-    return this.client.sendLRORequest(
-      {
-        resourceGroupName,
-        policyName,
-        parameters,
-        options
-      },
-      beginCreateOrUpdateOperationSpec,
-      options);
+  async beginDelete(
+    resourceGroupName: string,
+    policyName: string,
+    options?: PoliciesDeleteOptionalParams
+  ): Promise<PollerLike<PollOperationState<void>, void>> {
+    const directSendOperation = async (
+      args: coreClient.OperationArguments,
+      spec: coreClient.OperationSpec
+    ): Promise<void> => {
+      return this.client.sendOperationRequest(args, spec);
+    };
+    const sendOperation = 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 = new LroImpl(
+      sendOperation,
+      { resourceGroupName, policyName, options },
+      deleteOperationSpec
+    );
+    return new LroEngine(lro, {
+      resumeFrom: options?.resumeFrom,
+      intervalInMs: options?.updateIntervalInMs
+    });
   }
 
   /**
    * Deletes Policy
    * @param resourceGroupName Name of the Resource group within the Azure subscription.
    * @param policyName The name of the Web Application Firewall Policy.
-   * @param [options] The optional parameters
-   * @returns Promise<msRestAzure.LROPoller>
+   * @param options The options parameters.
    */
-  beginDeleteMethod(resourceGroupName: string, policyName: string, options?: msRest.RequestOptionsBase): Promise<msRestAzure.LROPoller> {
-    return this.client.sendLRORequest(
-      {
-        resourceGroupName,
-        policyName,
-        options
-      },
-      beginDeleteMethodOperationSpec,
-      options);
+  async beginDeleteAndWait(
+    resourceGroupName: string,
+    policyName: string,
+    options?: PoliciesDeleteOptionalParams
+  ): Promise<void> {
+    const poller = await this.beginDelete(
+      resourceGroupName,
+      policyName,
+      options
+    );
+    return poller.pollUntilDone();
   }
 
   /**
-   * Lists all of the protection policies within a resource group.
-   * @param nextPageLink The NextLink from the previous successful call to List operation.
-   * @param [options] The optional parameters
-   * @returns Promise<Models.PoliciesListNextResponse>
-   */
-  listNext(nextPageLink: string, options?: msRest.RequestOptionsBase): Promise<Models.PoliciesListNextResponse>;
-  /**
-   * @param nextPageLink The NextLink from the previous successful call to List operation.
-   * @param callback The callback
-   */
-  listNext(nextPageLink: string, callback: msRest.ServiceCallback<Models.WebApplicationFirewallPolicyList>): void;
-  /**
-   * @param nextPageLink The NextLink from the previous successful call to List operation.
-   * @param options The optional parameters
-   * @param callback The callback
+   * ListNext
+   * @param resourceGroupName Name of the Resource group within the Azure subscription.
+   * @param nextLink The nextLink from the previous successful call to the List method.
+   * @param options The options parameters.
    */
-  listNext(nextPageLink: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.WebApplicationFirewallPolicyList>): void;
-  listNext(nextPageLink: string, options?: msRest.RequestOptionsBase | msRest.ServiceCallback<Models.WebApplicationFirewallPolicyList>, callback?: msRest.ServiceCallback<Models.WebApplicationFirewallPolicyList>): Promise<Models.PoliciesListNextResponse> {
+  private _listNext(
+    resourceGroupName: string,
+    nextLink: string,
+    options?: PoliciesListNextOptionalParams
+  ): Promise<PoliciesListNextResponse> {
     return this.client.sendOperationRequest(
-      {
-        nextPageLink,
-        options
-      },
-      listNextOperationSpec,
-      callback) as Promise<Models.PoliciesListNextResponse>;
+      { resourceGroupName, nextLink, options },
+      listNextOperationSpec
+    );
   }
 }
-
 // Operation Specifications
-const serializer = new msRest.Serializer(Mappers);
-const listOperationSpec: msRest.OperationSpec = {
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const listOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies",
   httpMethod: "GET",
-  path: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies",
-  urlParameters: [
-    Parameters.resourceGroupName,
-    Parameters.subscriptionId
-  ],
-  queryParameters: [
-    Parameters.apiVersion2
-  ],
-  headerParameters: [
-    Parameters.acceptLanguage
-  ],
   responses: {
     200: {
       bodyMapper: Mappers.WebApplicationFirewallPolicyList
@@ -202,23 +324,19 @@ const listOperationSpec: msRest.OperationSpec = {
       bodyMapper: Mappers.ErrorResponse
     }
   },
+  queryParameters: [Parameters.apiVersion2],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.subscriptionId,
+    Parameters.resourceGroupName
+  ],
+  headerParameters: [Parameters.accept],
   serializer
 };
-
-const getOperationSpec: msRest.OperationSpec = {
+const getOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/{policyName}",
   httpMethod: "GET",
-  path: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/{policyName}",
-  urlParameters: [
-    Parameters.resourceGroupName,
-    Parameters.policyName,
-    Parameters.subscriptionId
-  ],
-  queryParameters: [
-    Parameters.apiVersion2
-  ],
-  headerParameters: [
-    Parameters.acceptLanguage
-  ],
   responses: {
     200: {
       bodyMapper: Mappers.WebApplicationFirewallPolicy
@@ -227,30 +345,20 @@ const getOperationSpec: msRest.OperationSpec = {
       bodyMapper: Mappers.ErrorResponse
     }
   },
-  serializer
-};
-
-const beginCreateOrUpdateOperationSpec: msRest.OperationSpec = {
-  httpMethod: "PUT",
-  path: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/{policyName}",
+  queryParameters: [Parameters.apiVersion2],
   urlParameters: [
+    Parameters.$host,
+    Parameters.subscriptionId,
     Parameters.resourceGroupName,
-    Parameters.policyName,
-    Parameters.subscriptionId
-  ],
-  queryParameters: [
-    Parameters.apiVersion2
+    Parameters.policyName
   ],
-  headerParameters: [
-    Parameters.acceptLanguage
-  ],
-  requestBody: {
-    parameterPath: "parameters",
-    mapper: {
-      ...Mappers.WebApplicationFirewallPolicy,
-      required: true
-    }
-  },
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const createOrUpdateOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/{policyName}",
+  httpMethod: "PUT",
   responses: {
     200: {
       bodyMapper: Mappers.WebApplicationFirewallPolicy
@@ -261,48 +369,42 @@ const beginCreateOrUpdateOperationSpec: msRest.OperationSpec = {
     202: {
       bodyMapper: Mappers.WebApplicationFirewallPolicy
     },
+    204: {
+      bodyMapper: Mappers.WebApplicationFirewallPolicy
+    },
     default: {
       bodyMapper: Mappers.ErrorResponse
     }
   },
+  requestBody: Parameters.parameters4,
+  queryParameters: [Parameters.apiVersion2],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.subscriptionId,
+    Parameters.resourceGroupName,
+    Parameters.policyName
+  ],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
   serializer
 };
-
-const beginDeleteMethodOperationSpec: msRest.OperationSpec = {
+const deleteOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/{policyName}",
   httpMethod: "DELETE",
-  path: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/{policyName}",
+  responses: { 200: {}, 201: {}, 202: {}, 204: {} },
+  queryParameters: [Parameters.apiVersion2],
   urlParameters: [
+    Parameters.$host,
+    Parameters.subscriptionId,
     Parameters.resourceGroupName,
-    Parameters.policyName,
-    Parameters.subscriptionId
+    Parameters.policyName
   ],
-  queryParameters: [
-    Parameters.apiVersion2
-  ],
-  headerParameters: [
-    Parameters.acceptLanguage
-  ],
-  responses: {
-    200: {},
-    202: {},
-    204: {},
-    default: {
-      bodyMapper: Mappers.CloudError
-    }
-  },
   serializer
 };
-
-const listNextOperationSpec: msRest.OperationSpec = {
-  httpMethod: "GET",
-  baseUrl: "https://management.azure.com",
+const listNextOperationSpec: coreClient.OperationSpec = {
   path: "{nextLink}",
-  urlParameters: [
-    Parameters.nextPageLink
-  ],
-  headerParameters: [
-    Parameters.acceptLanguage
-  ],
+  httpMethod: "GET",
   responses: {
     200: {
       bodyMapper: Mappers.WebApplicationFirewallPolicyList
@@ -311,5 +413,13 @@ const listNextOperationSpec: msRest.OperationSpec = {
       bodyMapper: Mappers.ErrorResponse
     }
   },
+  queryParameters: [Parameters.apiVersion2],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.subscriptionId,
+    Parameters.resourceGroupName,
+    Parameters.nextLink
+  ],
+  headerParameters: [Parameters.accept],
   serializer
 };