@azure/arm-managementgroups 1.2.0 → 2.0.0-alpha.20211215.1

package/src/operations/hierarchySettingsOperations.ts

@@ -0,0 +1,214 @@
+/*
+ * 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 { HierarchySettingsOperations } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
+import * as Parameters from "../models/parameters";
+import { ManagementGroupsAPIContext } from "../managementGroupsAPIContext";
+import {
+  HierarchySettingsListOptionalParams,
+  HierarchySettingsListResponse,
+  HierarchySettingsGetOptionalParams,
+  HierarchySettingsGetResponse,
+  CreateOrUpdateSettingsRequest,
+  HierarchySettingsCreateOrUpdateOptionalParams,
+  HierarchySettingsCreateOrUpdateResponse,
+  HierarchySettingsUpdateOptionalParams,
+  HierarchySettingsUpdateResponse,
+  HierarchySettingsDeleteOptionalParams
+} from "../models";
+
+/** Class containing HierarchySettingsOperations operations. */
+export class HierarchySettingsOperationsImpl
+  implements HierarchySettingsOperations {
+  private readonly client: ManagementGroupsAPIContext;
+
+  /**
+   * Initialize a new instance of the class HierarchySettingsOperations class.
+   * @param client Reference to the service client
+   */
+  constructor(client: ManagementGroupsAPIContext) {
+    this.client = client;
+  }
+
+  /**
+   * Gets all the hierarchy settings defined at the Management Group level. Settings can only be set on
+   * the root Management Group of the hierarchy.
+   *
+   * @param groupId Management Group ID.
+   * @param options The options parameters.
+   */
+  list(
+    groupId: string,
+    options?: HierarchySettingsListOptionalParams
+  ): Promise<HierarchySettingsListResponse> {
+    return this.client.sendOperationRequest(
+      { groupId, options },
+      listOperationSpec
+    );
+  }
+
+  /**
+   * Gets the hierarchy settings defined at the Management Group level. Settings can only be set on the
+   * root Management Group of the hierarchy.
+   *
+   * @param groupId Management Group ID.
+   * @param options The options parameters.
+   */
+  get(
+    groupId: string,
+    options?: HierarchySettingsGetOptionalParams
+  ): Promise<HierarchySettingsGetResponse> {
+    return this.client.sendOperationRequest(
+      { groupId, options },
+      getOperationSpec
+    );
+  }
+
+  /**
+   * Creates or updates the hierarchy settings defined at the Management Group level.
+   *
+   * @param groupId Management Group ID.
+   * @param createTenantSettingsRequest Tenant level settings request parameter.
+   * @param options The options parameters.
+   */
+  createOrUpdate(
+    groupId: string,
+    createTenantSettingsRequest: CreateOrUpdateSettingsRequest,
+    options?: HierarchySettingsCreateOrUpdateOptionalParams
+  ): Promise<HierarchySettingsCreateOrUpdateResponse> {
+    return this.client.sendOperationRequest(
+      { groupId, createTenantSettingsRequest, options },
+      createOrUpdateOperationSpec
+    );
+  }
+
+  /**
+   * Updates the hierarchy settings defined at the Management Group level.
+   *
+   * @param groupId Management Group ID.
+   * @param createTenantSettingsRequest Tenant level settings request parameter.
+   * @param options The options parameters.
+   */
+  update(
+    groupId: string,
+    createTenantSettingsRequest: CreateOrUpdateSettingsRequest,
+    options?: HierarchySettingsUpdateOptionalParams
+  ): Promise<HierarchySettingsUpdateResponse> {
+    return this.client.sendOperationRequest(
+      { groupId, createTenantSettingsRequest, options },
+      updateOperationSpec
+    );
+  }
+
+  /**
+   * Deletes the hierarchy settings defined at the Management Group level.
+   *
+   * @param groupId Management Group ID.
+   * @param options The options parameters.
+   */
+  delete(
+    groupId: string,
+    options?: HierarchySettingsDeleteOptionalParams
+  ): Promise<void> {
+    return this.client.sendOperationRequest(
+      { groupId, options },
+      deleteOperationSpec
+    );
+  }
+}
+// Operation Specifications
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const listOperationSpec: coreClient.OperationSpec = {
+  path: "/providers/Microsoft.Management/managementGroups/{groupId}/settings",
+  httpMethod: "GET",
+  responses: {
+    200: {
+      bodyMapper: Mappers.HierarchySettingsList
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host, Parameters.groupId],
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const getOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Management/managementGroups/{groupId}/settings/default",
+  httpMethod: "GET",
+  responses: {
+    200: {
+      bodyMapper: Mappers.HierarchySettings
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host, Parameters.groupId],
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const createOrUpdateOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Management/managementGroups/{groupId}/settings/default",
+  httpMethod: "PUT",
+  responses: {
+    200: {
+      bodyMapper: Mappers.HierarchySettings
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  requestBody: Parameters.createTenantSettingsRequest,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host, Parameters.groupId],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
+  serializer
+};
+const updateOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Management/managementGroups/{groupId}/settings/default",
+  httpMethod: "PATCH",
+  responses: {
+    200: {
+      bodyMapper: Mappers.HierarchySettings
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  requestBody: Parameters.createTenantSettingsRequest,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host, Parameters.groupId],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
+  serializer
+};
+const deleteOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Management/managementGroups/{groupId}/settings/default",
+  httpMethod: "DELETE",
+  responses: {
+    200: {},
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host, Parameters.groupId],
+  headerParameters: [Parameters.accept],
+  serializer
+};

package/src/operations/index.ts

@@ -1,14 +1,13 @@
 /*
- * 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.
  */
 
 export * from "./managementGroups";
 export * from "./managementGroupSubscriptions";
+export * from "./hierarchySettingsOperations";
 export * from "./operations";
 export * from "./entities";

package/src/operations/managementGroupSubscriptions.ts

@@ -1,140 +1,294 @@
 /*
- * 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/managementGroupSubscriptionsMappers";
+import { PagedAsyncIterableIterator } from "@azure/core-paging";
+import { ManagementGroupSubscriptions } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
 import * as Parameters from "../models/parameters";
 import { ManagementGroupsAPIContext } from "../managementGroupsAPIContext";
+import {
+  SubscriptionUnderManagementGroup,
+  ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupNextOptionalParams,
+  ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupOptionalParams,
+  ManagementGroupSubscriptionsCreateOptionalParams,
+  ManagementGroupSubscriptionsCreateResponse,
+  ManagementGroupSubscriptionsDeleteOptionalParams,
+  ManagementGroupSubscriptionsGetSubscriptionOptionalParams,
+  ManagementGroupSubscriptionsGetSubscriptionResponse,
+  ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupResponse,
+  ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupNextResponse
+} from "../models";
 
-/** Class representing a ManagementGroupSubscriptions. */
-export class ManagementGroupSubscriptions {
+/// <reference lib="esnext.asynciterable" />
+/** Class containing ManagementGroupSubscriptions operations. */
+export class ManagementGroupSubscriptionsImpl
+  implements ManagementGroupSubscriptions {
   private readonly client: ManagementGroupsAPIContext;
 
   /**
-   * Create a ManagementGroupSubscriptions.
-   * @param {ManagementGroupsAPIContext} client Reference to the service client.
+   * Initialize a new instance of the class ManagementGroupSubscriptions class.
+   * @param client Reference to the service client
    */
   constructor(client: ManagementGroupsAPIContext) {
     this.client = client;
   }
 
   /**
-   * Associates existing subscription with the management group.
+   * Retrieves details about all subscriptions which are associated with the management group.
+   *
    * @param groupId Management Group ID.
-   * @param subscriptionId Subscription ID.
-   * @param [options] The optional parameters
-   * @returns Promise<msRest.RestResponse>
+   * @param options The options parameters.
    */
-  create(groupId: string, subscriptionId: string, options?: Models.ManagementGroupSubscriptionsCreateOptionalParams): Promise<msRest.RestResponse>;
+  public listSubscriptionsUnderManagementGroup(
+    groupId: string,
+    options?: ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupOptionalParams
+  ): PagedAsyncIterableIterator<SubscriptionUnderManagementGroup> {
+    const iter = this.getSubscriptionsUnderManagementGroupPagingAll(
+      groupId,
+      options
+    );
+    return {
+      next() {
+        return iter.next();
+      },
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+      byPage: () => {
+        return this.getSubscriptionsUnderManagementGroupPagingPage(
+          groupId,
+          options
+        );
+      }
+    };
+  }
+
+  private async *getSubscriptionsUnderManagementGroupPagingPage(
+    groupId: string,
+    options?: ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupOptionalParams
+  ): AsyncIterableIterator<SubscriptionUnderManagementGroup[]> {
+    let result = await this._getSubscriptionsUnderManagementGroup(
+      groupId,
+      options
+    );
+    yield result.value || [];
+    let continuationToken = result.nextLink;
+    while (continuationToken) {
+      result = await this._getSubscriptionsUnderManagementGroupNext(
+        groupId,
+        continuationToken,
+        options
+      );
+      continuationToken = result.nextLink;
+      yield result.value || [];
+    }
+  }
+
+  private async *getSubscriptionsUnderManagementGroupPagingAll(
+    groupId: string,
+    options?: ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupOptionalParams
+  ): AsyncIterableIterator<SubscriptionUnderManagementGroup> {
+    for await (const page of this.getSubscriptionsUnderManagementGroupPagingPage(
+      groupId,
+      options
+    )) {
+      yield* page;
+    }
+  }
+
   /**
+   * Associates existing subscription with the management group.
+   *
    * @param groupId Management Group ID.
    * @param subscriptionId Subscription ID.
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  create(groupId: string, subscriptionId: string, callback: msRest.ServiceCallback<void>): void;
+  create(
+    groupId: string,
+    subscriptionId: string,
+    options?: ManagementGroupSubscriptionsCreateOptionalParams
+  ): Promise<ManagementGroupSubscriptionsCreateResponse> {
+    return this.client.sendOperationRequest(
+      { groupId, subscriptionId, options },
+      createOperationSpec
+    );
+  }
+
   /**
+   * De-associates subscription from the management group.
+   *
    * @param groupId Management Group ID.
    * @param subscriptionId Subscription ID.
-   * @param options The optional parameters
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  create(groupId: string, subscriptionId: string, options: Models.ManagementGroupSubscriptionsCreateOptionalParams, callback: msRest.ServiceCallback<void>): void;
-  create(groupId: string, subscriptionId: string, options?: Models.ManagementGroupSubscriptionsCreateOptionalParams | msRest.ServiceCallback<void>, callback?: msRest.ServiceCallback<void>): Promise<msRest.RestResponse> {
+  delete(
+    groupId: string,
+    subscriptionId: string,
+    options?: ManagementGroupSubscriptionsDeleteOptionalParams
+  ): Promise<void> {
     return this.client.sendOperationRequest(
-      {
-        groupId,
-        subscriptionId,
-        options
-      },
-      createOperationSpec,
-      callback);
+      { groupId, subscriptionId, options },
+      deleteOperationSpec
+    );
   }
 
   /**
-   * De-associates subscription from the management group.
+   * Retrieves details about given subscription which is associated with the management group.
+   *
    * @param groupId Management Group ID.
    * @param subscriptionId Subscription ID.
-   * @param [options] The optional parameters
-   * @returns Promise<msRest.RestResponse>
+   * @param options The options parameters.
    */
-  deleteMethod(groupId: string, subscriptionId: string, options?: Models.ManagementGroupSubscriptionsDeleteMethodOptionalParams): Promise<msRest.RestResponse>;
+  getSubscription(
+    groupId: string,
+    subscriptionId: string,
+    options?: ManagementGroupSubscriptionsGetSubscriptionOptionalParams
+  ): Promise<ManagementGroupSubscriptionsGetSubscriptionResponse> {
+    return this.client.sendOperationRequest(
+      { groupId, subscriptionId, options },
+      getSubscriptionOperationSpec
+    );
+  }
+
   /**
+   * Retrieves details about all subscriptions which are associated with the management group.
+   *
    * @param groupId Management Group ID.
-   * @param subscriptionId Subscription ID.
-   * @param callback The callback
+   * @param options The options parameters.
    */
-  deleteMethod(groupId: string, subscriptionId: string, callback: msRest.ServiceCallback<void>): void;
+  private _getSubscriptionsUnderManagementGroup(
+    groupId: string,
+    options?: ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupOptionalParams
+  ): Promise<
+    ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupResponse
+  > {
+    return this.client.sendOperationRequest(
+      { groupId, options },
+      getSubscriptionsUnderManagementGroupOperationSpec
+    );
+  }
+
   /**
+   * GetSubscriptionsUnderManagementGroupNext
    * @param groupId Management Group ID.
-   * @param subscriptionId Subscription ID.
-   * @param options The optional parameters
-   * @param callback The callback
+   * @param nextLink The nextLink from the previous successful call to the
+   *                 GetSubscriptionsUnderManagementGroup method.
+   * @param options The options parameters.
    */
-  deleteMethod(groupId: string, subscriptionId: string, options: Models.ManagementGroupSubscriptionsDeleteMethodOptionalParams, callback: msRest.ServiceCallback<void>): void;
-  deleteMethod(groupId: string, subscriptionId: string, options?: Models.ManagementGroupSubscriptionsDeleteMethodOptionalParams | msRest.ServiceCallback<void>, callback?: msRest.ServiceCallback<void>): Promise<msRest.RestResponse> {
+  private _getSubscriptionsUnderManagementGroupNext(
+    groupId: string,
+    nextLink: string,
+    options?: ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupNextOptionalParams
+  ): Promise<
+    ManagementGroupSubscriptionsGetSubscriptionsUnderManagementGroupNextResponse
+  > {
     return this.client.sendOperationRequest(
-      {
-        groupId,
-        subscriptionId,
-        options
-      },
-      deleteMethodOperationSpec,
-      callback);
+      { groupId, nextLink, options },
+      getSubscriptionsUnderManagementGroupNextOperationSpec
+    );
   }
 }
-
 // Operation Specifications
-const serializer = new msRest.Serializer(Mappers);
-const createOperationSpec: msRest.OperationSpec = {
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const createOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}",
   httpMethod: "PUT",
-  path: "providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}",
+  responses: {
+    200: {
+      bodyMapper: Mappers.SubscriptionUnderManagementGroup
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
   urlParameters: [
+    Parameters.$host,
     Parameters.groupId,
     Parameters.subscriptionId
   ],
-  queryParameters: [
-    Parameters.apiVersion
-  ],
-  headerParameters: [
-    Parameters.cacheControl,
-    Parameters.acceptLanguage
-  ],
+  headerParameters: [Parameters.accept, Parameters.cacheControl],
+  serializer
+};
+const deleteOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}",
+  httpMethod: "DELETE",
   responses: {
+    200: {},
     204: {},
     default: {
       bodyMapper: Mappers.ErrorResponse
     }
   },
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.groupId,
+    Parameters.subscriptionId
+  ],
+  headerParameters: [Parameters.accept, Parameters.cacheControl],
   serializer
 };
-
-const deleteMethodOperationSpec: msRest.OperationSpec = {
-  httpMethod: "DELETE",
-  path: "providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}",
+const getSubscriptionOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}",
+  httpMethod: "GET",
+  responses: {
+    200: {
+      bodyMapper: Mappers.SubscriptionUnderManagementGroup
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
   urlParameters: [
+    Parameters.$host,
     Parameters.groupId,
     Parameters.subscriptionId
   ],
-  queryParameters: [
-    Parameters.apiVersion
-  ],
-  headerParameters: [
-    Parameters.cacheControl,
-    Parameters.acceptLanguage
-  ],
+  headerParameters: [Parameters.accept, Parameters.cacheControl],
+  serializer
+};
+const getSubscriptionsUnderManagementGroupOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions",
+  httpMethod: "GET",
   responses: {
-    204: {},
+    200: {
+      bodyMapper: Mappers.ListSubscriptionUnderManagementGroup
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion, Parameters.skiptoken],
+  urlParameters: [Parameters.$host, Parameters.groupId],
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const getSubscriptionsUnderManagementGroupNextOperationSpec: coreClient.OperationSpec = {
+  path: "{nextLink}",
+  httpMethod: "GET",
+  responses: {
+    200: {
+      bodyMapper: Mappers.ListSubscriptionUnderManagementGroup
+    },
     default: {
       bodyMapper: Mappers.ErrorResponse
     }
   },
+  queryParameters: [Parameters.apiVersion, Parameters.skiptoken],
+  urlParameters: [Parameters.$host, Parameters.groupId, Parameters.nextLink],
+  headerParameters: [Parameters.accept],
   serializer
 };