@azure/arm-migrate 1.2.1 → 2.0.0

package/src/operations/groups.ts

@@ -1,206 +1,216 @@
 /*
- * 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 Models from "../models";
-import * as Mappers from "../models/groupsMappers";
+import { PagedAsyncIterableIterator } from "@azure/core-paging";
+import { Groups } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
 import * as Parameters from "../models/parameters";
-import { AzureMigrateContext } from "../azureMigrateContext";
+import { AzureMigrateV2 } from "../azureMigrateV2";
+import {
+  Group,
+  GroupsListByProjectOptionalParams,
+  GroupsListByProjectResponse,
+  GroupsGetOptionalParams,
+  GroupsGetResponse,
+  GroupsCreateOptionalParams,
+  GroupsCreateResponse,
+  GroupsDeleteOptionalParams,
+  GroupsDeleteResponse,
+  GroupsUpdateMachinesOptionalParams,
+  GroupsUpdateMachinesResponse
+} from "../models";
 
-/** Class representing a Groups. */
-export class Groups {
-  private readonly client: AzureMigrateContext;
+/// <reference lib="esnext.asynciterable" />
+/** Class containing Groups operations. */
+export class GroupsImpl implements Groups {
+  private readonly client: AzureMigrateV2;
 
   /**
-   * Create a Groups.
-   * @param {AzureMigrateContext} client Reference to the service client.
+   * Initialize a new instance of the class Groups class.
+   * @param client Reference to the service client
    */
-  constructor(client: AzureMigrateContext) {
+  constructor(client: AzureMigrateV2) {
     this.client = client;
   }
 
   /**
-   * Get all groups created in the project. Returns a json array of objects of type 'group' as
-   * specified in the Models section.
-   * @summary Get all groups
+   * Get all groups created in the project. Returns a json array of objects of type 'group' as specified
+   * in the Models section.
    * @param resourceGroupName Name of the Azure Resource Group that project is part of.
    * @param projectName Name of the Azure Migrate project.
-   * @param [options] The optional parameters
-   * @returns Promise<Models.GroupsListByProjectResponse>
+   * @param options The options parameters.
    */
-  listByProject(resourceGroupName: string, projectName: string, options?: msRest.RequestOptionsBase): Promise<Models.GroupsListByProjectResponse>;
-  /**
-   * @param resourceGroupName Name of the Azure Resource Group that project is part of.
-   * @param projectName Name of the Azure Migrate project.
-   * @param callback The callback
-   */
-  listByProject(resourceGroupName: string, projectName: string, callback: msRest.ServiceCallback<Models.GroupResultList>): void;
-  /**
-   * @param resourceGroupName Name of the Azure Resource Group that project is part of.
-   * @param projectName Name of the Azure Migrate project.
-   * @param options The optional parameters
-   * @param callback The callback
-   */
-  listByProject(resourceGroupName: string, projectName: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.GroupResultList>): void;
-  listByProject(resourceGroupName: string, projectName: string, options?: msRest.RequestOptionsBase | msRest.ServiceCallback<Models.GroupResultList>, callback?: msRest.ServiceCallback<Models.GroupResultList>): Promise<Models.GroupsListByProjectResponse> {
-    return this.client.sendOperationRequest(
-      {
-        resourceGroupName,
-        projectName,
-        options
+  public listByProject(
+    resourceGroupName: string,
+    projectName: string,
+    options?: GroupsListByProjectOptionalParams
+  ): PagedAsyncIterableIterator<Group> {
+    const iter = this.listByProjectPagingAll(
+      resourceGroupName,
+      projectName,
+      options
+    );
+    return {
+      next() {
+        return iter.next();
       },
-      listByProjectOperationSpec,
-      callback) as Promise<Models.GroupsListByProjectResponse>;
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+      byPage: () => {
+        return this.listByProjectPagingPage(
+          resourceGroupName,
+          projectName,
+          options
+        );
+      }
+    };
+  }
+
+  private async *listByProjectPagingPage(
+    resourceGroupName: string,
+    projectName: string,
+    options?: GroupsListByProjectOptionalParams
+  ): AsyncIterableIterator<Group[]> {
+    let result = await this._listByProject(
+      resourceGroupName,
+      projectName,
+      options
+    );
+    yield result.value || [];
+  }
+
+  private async *listByProjectPagingAll(
+    resourceGroupName: string,
+    projectName: string,
+    options?: GroupsListByProjectOptionalParams
+  ): AsyncIterableIterator<Group> {
+    for await (const page of this.listByProjectPagingPage(
+      resourceGroupName,
+      projectName,
+      options
+    )) {
+      yield* page;
+    }
   }
 
   /**
-   * Get information related to a specific group in the project. Returns a json object of type
-   * 'group' as specified in the models section.
-   * @summary Get a specific group.
-   * @param resourceGroupName Name of the Azure Resource Group that project is part of.
-   * @param projectName Name of the Azure Migrate project.
-   * @param groupName Unique name of a group within a project.
-   * @param [options] The optional parameters
-   * @returns Promise<Models.GroupsGetResponse>
-   */
-  get(resourceGroupName: string, projectName: string, groupName: string, options?: msRest.RequestOptionsBase): Promise<Models.GroupsGetResponse>;
-  /**
+   * Get all groups created in the project. Returns a json array of objects of type 'group' as specified
+   * in the Models section.
    * @param resourceGroupName Name of the Azure Resource Group that project is part of.
    * @param projectName Name of the Azure Migrate project.
-   * @param groupName Unique name of a group within a project.
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  get(resourceGroupName: string, projectName: string, groupName: string, callback: msRest.ServiceCallback<Models.Group>): void;
+  private _listByProject(
+    resourceGroupName: string,
+    projectName: string,
+    options?: GroupsListByProjectOptionalParams
+  ): Promise<GroupsListByProjectResponse> {
+    return this.client.sendOperationRequest(
+      { resourceGroupName, projectName, options },
+      listByProjectOperationSpec
+    );
+  }
+
   /**
+   * Get information related to a specific group in the project. Returns a json object of type 'group' as
+   * specified in the models section.
    * @param resourceGroupName Name of the Azure Resource Group that project is part of.
    * @param projectName Name of the Azure Migrate project.
    * @param groupName Unique name of a group within a project.
-   * @param options The optional parameters
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  get(resourceGroupName: string, projectName: string, groupName: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<Models.Group>): void;
-  get(resourceGroupName: string, projectName: string, groupName: string, options?: msRest.RequestOptionsBase | msRest.ServiceCallback<Models.Group>, callback?: msRest.ServiceCallback<Models.Group>): Promise<Models.GroupsGetResponse> {
+  get(
+    resourceGroupName: string,
+    projectName: string,
+    groupName: string,
+    options?: GroupsGetOptionalParams
+  ): Promise<GroupsGetResponse> {
     return this.client.sendOperationRequest(
-      {
-        resourceGroupName,
-        projectName,
-        groupName,
-        options
-      },
-      getOperationSpec,
-      callback) as Promise<Models.GroupsGetResponse>;
+      { resourceGroupName, projectName, groupName, options },
+      getOperationSpec
+    );
   }
 
   /**
-   * Create a new group by sending a json object of type 'group' as given in Models section as part
-   * of the Request Body. The group name in a project is unique. Labels can be applied on a group as
-   * part of creation.
-   *
-   * If a group with the groupName specified in the URL already exists, then this call acts as an
-   * update.
+   * Create a new group by sending a json object of type 'group' as given in Models section as part of
+   * the Request Body. The group name in a project is unique.
    *
    * This operation is Idempotent.
-   * @summary Create a new group with specified settings. If group with the name provided already
-   * exists, then the existing group is updated.
-   * @param resourceGroupName Name of the Azure Resource Group that project is part of.
-   * @param projectName Name of the Azure Migrate project.
-   * @param groupName Unique name of a group within a project.
-   * @param [options] The optional parameters
-   * @returns Promise<Models.GroupsCreateResponse>
-   */
-  create(resourceGroupName: string, projectName: string, groupName: string, options?: Models.GroupsCreateOptionalParams): Promise<Models.GroupsCreateResponse>;
-  /**
-   * @param resourceGroupName Name of the Azure Resource Group that project is part of.
-   * @param projectName Name of the Azure Migrate project.
-   * @param groupName Unique name of a group within a project.
-   * @param callback The callback
-   */
-  create(resourceGroupName: string, projectName: string, groupName: string, callback: msRest.ServiceCallback<Models.Group>): void;
-  /**
+   *
    * @param resourceGroupName Name of the Azure Resource Group that project is part of.
    * @param projectName Name of the Azure Migrate project.
    * @param groupName Unique name of a group within a project.
-   * @param options The optional parameters
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  create(resourceGroupName: string, projectName: string, groupName: string, options: Models.GroupsCreateOptionalParams, callback: msRest.ServiceCallback<Models.Group>): void;
-  create(resourceGroupName: string, projectName: string, groupName: string, options?: Models.GroupsCreateOptionalParams | msRest.ServiceCallback<Models.Group>, callback?: msRest.ServiceCallback<Models.Group>): Promise<Models.GroupsCreateResponse> {
+  create(
+    resourceGroupName: string,
+    projectName: string,
+    groupName: string,
+    options?: GroupsCreateOptionalParams
+  ): Promise<GroupsCreateResponse> {
     return this.client.sendOperationRequest(
-      {
-        resourceGroupName,
-        projectName,
-        groupName,
-        options
-      },
-      createOperationSpec,
-      callback) as Promise<Models.GroupsCreateResponse>;
+      { resourceGroupName, projectName, groupName, options },
+      createOperationSpec
+    );
   }
 
   /**
-   * Delete the group from the project. The machines remain in the project. Deleting a non-existent
-   * group results in a no-operation.
+   * Delete the group from the project. The machines remain in the project. Deleting a non-existent group
+   * results in a no-operation.
+   *
+   * A group is an aggregation mechanism for machines in a project. Therefore, deleting group does not
+   * delete machines in it.
    *
-   * A group is an aggregation mechanism for machines in a project. Therefore, deleting group does
-   * not delete machines in it.
-   * @summary Delete the group
-   * @param resourceGroupName Name of the Azure Resource Group that project is part of.
-   * @param projectName Name of the Azure Migrate project.
-   * @param groupName Unique name of a group within a project.
-   * @param [options] The optional parameters
-   * @returns Promise<Models.GroupsDeleteResponse>
-   */
-  deleteMethod(resourceGroupName: string, projectName: string, groupName: string, options?: msRest.RequestOptionsBase): Promise<Models.GroupsDeleteResponse>;
-  /**
    * @param resourceGroupName Name of the Azure Resource Group that project is part of.
    * @param projectName Name of the Azure Migrate project.
    * @param groupName Unique name of a group within a project.
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  deleteMethod(resourceGroupName: string, projectName: string, groupName: string, callback: msRest.ServiceCallback<void>): void;
+  delete(
+    resourceGroupName: string,
+    projectName: string,
+    groupName: string,
+    options?: GroupsDeleteOptionalParams
+  ): Promise<GroupsDeleteResponse> {
+    return this.client.sendOperationRequest(
+      { resourceGroupName, projectName, groupName, options },
+      deleteOperationSpec
+    );
+  }
+
   /**
+   * Update machines in group by adding or removing machines.
    * @param resourceGroupName Name of the Azure Resource Group that project is part of.
    * @param projectName Name of the Azure Migrate project.
    * @param groupName Unique name of a group within a project.
-   * @param options The optional parameters
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  deleteMethod(resourceGroupName: string, projectName: string, groupName: string, options: msRest.RequestOptionsBase, callback: msRest.ServiceCallback<void>): void;
-  deleteMethod(resourceGroupName: string, projectName: string, groupName: string, options?: msRest.RequestOptionsBase | msRest.ServiceCallback<void>, callback?: msRest.ServiceCallback<void>): Promise<Models.GroupsDeleteResponse> {
+  updateMachines(
+    resourceGroupName: string,
+    projectName: string,
+    groupName: string,
+    options?: GroupsUpdateMachinesOptionalParams
+  ): Promise<GroupsUpdateMachinesResponse> {
     return this.client.sendOperationRequest(
-      {
-        resourceGroupName,
-        projectName,
-        groupName,
-        options
-      },
-      deleteMethodOperationSpec,
-      callback) as Promise<Models.GroupsDeleteResponse>;
+      { resourceGroupName, projectName, groupName, options },
+      updateMachinesOperationSpec
+    );
   }
 }
-
 // Operation Specifications
-const serializer = new msRest.Serializer(Mappers);
-const listByProjectOperationSpec: msRest.OperationSpec = {
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const listByProjectOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups",
   httpMethod: "GET",
-  path: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups",
-  urlParameters: [
-    Parameters.subscriptionId,
-    Parameters.resourceGroupName,
-    Parameters.projectName
-  ],
-  queryParameters: [
-    Parameters.apiVersion
-  ],
-  headerParameters: [
-    Parameters.acceptLanguage
-  ],
   responses: {
     200: {
       bodyMapper: Mappers.GroupResultList,
@@ -210,24 +220,20 @@ const listByProjectOperationSpec: msRest.OperationSpec = {
       bodyMapper: Mappers.CloudError
     }
   },
-  serializer
-};
-
-const getOperationSpec: msRest.OperationSpec = {
-  httpMethod: "GET",
-  path: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}",
+  queryParameters: [Parameters.apiVersion],
   urlParameters: [
+    Parameters.$host,
     Parameters.subscriptionId,
     Parameters.resourceGroupName,
-    Parameters.projectName,
-    Parameters.groupName
-  ],
-  queryParameters: [
-    Parameters.apiVersion
-  ],
-  headerParameters: [
-    Parameters.acceptLanguage
+    Parameters.projectName
   ],
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const getOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}",
+  httpMethod: "GET",
   responses: {
     200: {
       bodyMapper: Mappers.Group,
@@ -237,31 +243,21 @@ const getOperationSpec: msRest.OperationSpec = {
       bodyMapper: Mappers.CloudError
     }
   },
-  serializer
-};
-
-const createOperationSpec: msRest.OperationSpec = {
-  httpMethod: "PUT",
-  path: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}",
+  queryParameters: [Parameters.apiVersion],
   urlParameters: [
+    Parameters.$host,
     Parameters.subscriptionId,
     Parameters.resourceGroupName,
     Parameters.projectName,
     Parameters.groupName
   ],
-  queryParameters: [
-    Parameters.apiVersion
-  ],
-  headerParameters: [
-    Parameters.acceptLanguage
-  ],
-  requestBody: {
-    parameterPath: [
-      "options",
-      "group"
-    ],
-    mapper: Mappers.Group
-  },
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const createOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}",
+  httpMethod: "PUT",
   responses: {
     200: {
       bodyMapper: Mappers.Group,
@@ -275,31 +271,66 @@ const createOperationSpec: msRest.OperationSpec = {
       bodyMapper: Mappers.CloudError
     }
   },
+  requestBody: Parameters.group,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.subscriptionId,
+    Parameters.resourceGroupName,
+    Parameters.projectName,
+    Parameters.groupName
+  ],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
   serializer
 };
-
-const deleteMethodOperationSpec: msRest.OperationSpec = {
+const deleteOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}",
   httpMethod: "DELETE",
-  path: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}",
+  responses: {
+    200: {
+      headersMapper: Mappers.GroupsDeleteHeaders
+    },
+    204: {},
+    default: {
+      bodyMapper: Mappers.CloudError
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
   urlParameters: [
+    Parameters.$host,
     Parameters.subscriptionId,
     Parameters.resourceGroupName,
     Parameters.projectName,
     Parameters.groupName
   ],
-  queryParameters: [
-    Parameters.apiVersion
-  ],
-  headerParameters: [
-    Parameters.acceptLanguage
-  ],
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const updateMachinesOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/updateMachines",
+  httpMethod: "POST",
   responses: {
     200: {
-      headersMapper: Mappers.GroupsDeleteHeaders
+      bodyMapper: Mappers.Group,
+      headersMapper: Mappers.GroupsUpdateMachinesHeaders
     },
     default: {
       bodyMapper: Mappers.CloudError
     }
   },
+  requestBody: Parameters.groupUpdateProperties,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.subscriptionId,
+    Parameters.resourceGroupName,
+    Parameters.projectName,
+    Parameters.groupName
+  ],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
   serializer
 };