@azure/arm-compute 19.2.1-alpha.20230104.1 → 20.0.0

package/src/operations/virtualMachines.ts

@@ -6,7 +6,8 @@
  * Changes may cause incorrect behavior and will be lost if the code is regenerated.
  */
 
-import { PagedAsyncIterableIterator } from "@azure/core-paging";
+import { PagedAsyncIterableIterator, PageSettings } from "@azure/core-paging";
+import { setContinuationToken } from "../pagingHelper";
 import { VirtualMachines } from "../operationsInterfaces";
 import * as coreClient from "@azure/core-client";
 import * as Mappers from "../models/mappers";
@@ -18,13 +19,16 @@ import {
   VirtualMachine,
   VirtualMachinesListByLocationNextOptionalParams,
   VirtualMachinesListByLocationOptionalParams,
+  VirtualMachinesListByLocationResponse,
   VirtualMachinesListNextOptionalParams,
   VirtualMachinesListOptionalParams,
+  VirtualMachinesListResponse,
   VirtualMachinesListAllNextOptionalParams,
   VirtualMachinesListAllOptionalParams,
+  VirtualMachinesListAllResponse,
   VirtualMachineSize,
   VirtualMachinesListAvailableSizesOptionalParams,
-  VirtualMachinesListByLocationResponse,
+  VirtualMachinesListAvailableSizesResponse,
   VirtualMachineCaptureParameters,
   VirtualMachinesCaptureOptionalParams,
   VirtualMachinesCaptureResponse,
@@ -41,9 +45,6 @@ import {
   VirtualMachinesConvertToManagedDisksOptionalParams,
   VirtualMachinesDeallocateOptionalParams,
   VirtualMachinesGeneralizeOptionalParams,
-  VirtualMachinesListResponse,
-  VirtualMachinesListAllResponse,
-  VirtualMachinesListAvailableSizesResponse,
   VirtualMachinesPowerOffOptionalParams,
   VirtualMachinesReapplyOptionalParams,
   VirtualMachinesRestartOptionalParams,
@@ -97,19 +98,29 @@ export class VirtualMachinesImpl implements VirtualMachines {
       [Symbol.asyncIterator]() {
         return this;
       },
-      byPage: () => {
-        return this.listByLocationPagingPage(location, options);
+      byPage: (settings?: PageSettings) => {
+        if (settings?.maxPageSize) {
+          throw new Error("maxPageSize is not supported by this operation.");
+        }
+        return this.listByLocationPagingPage(location, options, settings);
       }
     };
   }
 
   private async *listByLocationPagingPage(
     location: string,
-    options?: VirtualMachinesListByLocationOptionalParams
+    options?: VirtualMachinesListByLocationOptionalParams,
+    settings?: PageSettings
   ): AsyncIterableIterator<VirtualMachine[]> {
-    let result = await this._listByLocation(location, options);
-    yield result.value || [];
-    let continuationToken = result.nextLink;
+    let result: VirtualMachinesListByLocationResponse;
+    let continuationToken = settings?.continuationToken;
+    if (!continuationToken) {
+      result = await this._listByLocation(location, options);
+      let page = result.value || [];
+      continuationToken = result.nextLink;
+      setContinuationToken(page, continuationToken);
+      yield page;
+    }
     while (continuationToken) {
       result = await this._listByLocationNext(
         location,
@@ -117,7 +128,9 @@ export class VirtualMachinesImpl implements VirtualMachines {
         options
       );
       continuationToken = result.nextLink;
-      yield result.value || [];
+      let page = result.value || [];
+      setContinuationToken(page, continuationToken);
+      yield page;
     }
   }
 
@@ -148,19 +161,29 @@ export class VirtualMachinesImpl implements VirtualMachines {
       [Symbol.asyncIterator]() {
         return this;
       },
-      byPage: () => {
-        return this.listPagingPage(resourceGroupName, options);
+      byPage: (settings?: PageSettings) => {
+        if (settings?.maxPageSize) {
+          throw new Error("maxPageSize is not supported by this operation.");
+        }
+        return this.listPagingPage(resourceGroupName, options, settings);
       }
     };
   }
 
   private async *listPagingPage(
     resourceGroupName: string,
-    options?: VirtualMachinesListOptionalParams
+    options?: VirtualMachinesListOptionalParams,
+    settings?: PageSettings
   ): AsyncIterableIterator<VirtualMachine[]> {
-    let result = await this._list(resourceGroupName, options);
-    yield result.value || [];
-    let continuationToken = result.nextLink;
+    let result: VirtualMachinesListResponse;
+    let continuationToken = settings?.continuationToken;
+    if (!continuationToken) {
+      result = await this._list(resourceGroupName, options);
+      let page = result.value || [];
+      continuationToken = result.nextLink;
+      setContinuationToken(page, continuationToken);
+      yield page;
+    }
     while (continuationToken) {
       result = await this._listNext(
         resourceGroupName,
@@ -168,7 +191,9 @@ export class VirtualMachinesImpl implements VirtualMachines {
         options
       );
       continuationToken = result.nextLink;
-      yield result.value || [];
+      let page = result.value || [];
+      setContinuationToken(page, continuationToken);
+      yield page;
     }
   }
 
@@ -197,22 +222,34 @@ export class VirtualMachinesImpl implements VirtualMachines {
       [Symbol.asyncIterator]() {
         return this;
       },
-      byPage: () => {
-        return this.listAllPagingPage(options);
+      byPage: (settings?: PageSettings) => {
+        if (settings?.maxPageSize) {
+          throw new Error("maxPageSize is not supported by this operation.");
+        }
+        return this.listAllPagingPage(options, settings);
       }
     };
   }
 
   private async *listAllPagingPage(
-    options?: VirtualMachinesListAllOptionalParams
+    options?: VirtualMachinesListAllOptionalParams,
+    settings?: PageSettings
   ): AsyncIterableIterator<VirtualMachine[]> {
-    let result = await this._listAll(options);
-    yield result.value || [];
-    let continuationToken = result.nextLink;
+    let result: VirtualMachinesListAllResponse;
+    let continuationToken = settings?.continuationToken;
+    if (!continuationToken) {
+      result = await this._listAll(options);
+      let page = result.value || [];
+      continuationToken = result.nextLink;
+      setContinuationToken(page, continuationToken);
+      yield page;
+    }
     while (continuationToken) {
       result = await this._listAllNext(continuationToken, options);
       continuationToken = result.nextLink;
-      yield result.value || [];
+      let page = result.value || [];
+      setContinuationToken(page, continuationToken);
+      yield page;
     }
   }
 
@@ -247,11 +284,15 @@ export class VirtualMachinesImpl implements VirtualMachines {
       [Symbol.asyncIterator]() {
         return this;
       },
-      byPage: () => {
+      byPage: (settings?: PageSettings) => {
+        if (settings?.maxPageSize) {
+          throw new Error("maxPageSize is not supported by this operation.");
+        }
         return this.listAvailableSizesPagingPage(
           resourceGroupName,
           vmName,
-          options
+          options,
+          settings
         );
       }
     };
@@ -260,13 +301,11 @@ export class VirtualMachinesImpl implements VirtualMachines {
   private async *listAvailableSizesPagingPage(
     resourceGroupName: string,
     vmName: string,
-    options?: VirtualMachinesListAvailableSizesOptionalParams
+    options?: VirtualMachinesListAvailableSizesOptionalParams,
+    _settings?: PageSettings
   ): AsyncIterableIterator<VirtualMachineSize[]> {
-    let result = await this._listAvailableSizes(
-      resourceGroupName,
-      vmName,
-      options
-    );
+    let result: VirtualMachinesListAvailableSizesResponse;
+    result = await this._listAvailableSizes(resourceGroupName, vmName, options);
     yield result.value || [];
   }
 
@@ -1319,7 +1358,12 @@ export class VirtualMachinesImpl implements VirtualMachines {
   }
 
   /**
-   * Reimages the virtual machine which has an ephemeral OS disk back to its initial state.
+   * Reimages (upgrade the operating system) a virtual machine which don't have a ephemeral OS disk, for
+   * virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state. NOTE:
+   * The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is
+   * detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk
+   * will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before
+   * performing the reimage.
    * @param resourceGroupName The name of the resource group.
    * @param vmName The name of the virtual machine.
    * @param options The options parameters.
@@ -1382,7 +1426,12 @@ export class VirtualMachinesImpl implements VirtualMachines {
   }
 
   /**
-   * Reimages the virtual machine which has an ephemeral OS disk back to its initial state.
+   * Reimages (upgrade the operating system) a virtual machine which don't have a ephemeral OS disk, for
+   * virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state. NOTE:
+   * The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is
+   * detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk
+   * will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before
+   * performing the reimage.
    * @param resourceGroupName The name of the resource group.
    * @param vmName The name of the virtual machine.
    * @param options The options parameters.
@@ -2468,7 +2517,6 @@ const listByLocationNextOperationSpec: coreClient.OperationSpec = {
       bodyMapper: Mappers.CloudError
     }
   },
-  queryParameters: [Parameters.apiVersion],
   urlParameters: [
     Parameters.$host,
     Parameters.location,
@@ -2489,7 +2537,6 @@ const listNextOperationSpec: coreClient.OperationSpec = {
       bodyMapper: Mappers.CloudError
     }
   },
-  queryParameters: [Parameters.apiVersion, Parameters.filter],
   urlParameters: [
     Parameters.$host,
     Parameters.subscriptionId,
@@ -2510,11 +2557,6 @@ const listAllNextOperationSpec: coreClient.OperationSpec = {
       bodyMapper: Mappers.CloudError
     }
   },
-  queryParameters: [
-    Parameters.apiVersion,
-    Parameters.filter,
-    Parameters.statusOnly
-  ],
   urlParameters: [
     Parameters.$host,
     Parameters.subscriptionId,

package/src/operationsInterfaces/virtualMachineExtensionImages.ts

@@ -21,15 +21,15 @@ export interface VirtualMachineExtensionImages {
    * Gets a virtual machine extension image.
    * @param location The name of a supported Azure region.
    * @param publisherName
-   * @param version
    * @param typeParam
+   * @param version
    * @param options The options parameters.
    */
   get(
     location: string,
     publisherName: string,
-    version: string,
     typeParam: string,
+    version: string,
     options?: VirtualMachineExtensionImagesGetOptionalParams
   ): Promise<VirtualMachineExtensionImagesGetResponse>;
   /**

package/src/operationsInterfaces/virtualMachines.ts

@@ -410,7 +410,12 @@ export interface VirtualMachines {
     options?: VirtualMachinesRedeployOptionalParams
   ): Promise<void>;
   /**
-   * Reimages the virtual machine which has an ephemeral OS disk back to its initial state.
+   * Reimages (upgrade the operating system) a virtual machine which don't have a ephemeral OS disk, for
+   * virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state. NOTE:
+   * The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is
+   * detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk
+   * will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before
+   * performing the reimage.
    * @param resourceGroupName The name of the resource group.
    * @param vmName The name of the virtual machine.
    * @param options The options parameters.
@@ -421,7 +426,12 @@ export interface VirtualMachines {
     options?: VirtualMachinesReimageOptionalParams
   ): Promise<PollerLike<PollOperationState<void>, void>>;
   /**
-   * Reimages the virtual machine which has an ephemeral OS disk back to its initial state.
+   * Reimages (upgrade the operating system) a virtual machine which don't have a ephemeral OS disk, for
+   * virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state. NOTE:
+   * The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is
+   * detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk
+   * will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before
+   * performing the reimage.
    * @param resourceGroupName The name of the resource group.
    * @param vmName The name of the virtual machine.
    * @param options The options parameters.

package/src/pagingHelper.ts

@@ -0,0 +1,39 @@
+/*
+ * 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.
+ */
+
+export interface PageInfo {
+  continuationToken?: string;
+}
+
+const pageMap = new WeakMap<object, PageInfo>();
+
+/**
+ * Given the last `.value` produced by the `byPage` iterator,
+ * returns a continuation token that can be used to begin paging from
+ * that point later.
+ * @param page An object from accessing `value` on the IteratorResult from a `byPage` iterator.
+ * @returns The continuation token that can be passed into byPage() during future calls.
+ */
+export function getContinuationToken(page: unknown): string | undefined {
+  if (typeof page !== "object" || page === null) {
+    return undefined;
+  }
+  return pageMap.get(page)?.continuationToken;
+}
+
+export function setContinuationToken(
+  page: unknown,
+  continuationToken: string | undefined
+): void {
+  if (typeof page !== "object" || page === null || !continuationToken) {
+    return;
+  }
+  const pageInfo = pageMap.get(page) ?? {};
+  pageInfo.continuationToken = continuationToken;
+  pageMap.set(page, pageInfo);
+}