@azure/arm-costmanagement 1.0.0-alpha.20230518.2

package/src/operations/operations.ts

@@ -0,0 +1,149 @@
+/*
+ * 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 { PagedAsyncIterableIterator, PageSettings } from "@azure/core-paging";
+import { setContinuationToken } from "../pagingHelper";
+import { Operations } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
+import * as Parameters from "../models/parameters";
+import { CostManagementClient } from "../costManagementClient";
+import {
+  CostManagementOperation,
+  OperationsListNextOptionalParams,
+  OperationsListOptionalParams,
+  OperationsListResponse,
+  OperationsListNextResponse
+} from "../models";
+
+/// <reference lib="esnext.asynciterable" />
+/** Class containing Operations operations. */
+export class OperationsImpl implements Operations {
+  private readonly client: CostManagementClient;
+
+  /**
+   * Initialize a new instance of the class Operations class.
+   * @param client Reference to the service client
+   */
+  constructor(client: CostManagementClient) {
+    this.client = client;
+  }
+
+  /**
+   * Lists all of the available cost management REST API operations.
+   * @param options The options parameters.
+   */
+  public list(
+    options?: OperationsListOptionalParams
+  ): PagedAsyncIterableIterator<CostManagementOperation> {
+    const iter = this.listPagingAll(options);
+    return {
+      next() {
+        return iter.next();
+      },
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+      byPage: (settings?: PageSettings) => {
+        if (settings?.maxPageSize) {
+          throw new Error("maxPageSize is not supported by this operation.");
+        }
+        return this.listPagingPage(options, settings);
+      }
+    };
+  }
+
+  private async *listPagingPage(
+    options?: OperationsListOptionalParams,
+    settings?: PageSettings
+  ): AsyncIterableIterator<CostManagementOperation[]> {
+    let result: OperationsListResponse;
+    let continuationToken = settings?.continuationToken;
+    if (!continuationToken) {
+      result = await this._list(options);
+      let page = result.value || [];
+      continuationToken = result.nextLink;
+      setContinuationToken(page, continuationToken);
+      yield page;
+    }
+    while (continuationToken) {
+      result = await this._listNext(continuationToken, options);
+      continuationToken = result.nextLink;
+      let page = result.value || [];
+      setContinuationToken(page, continuationToken);
+      yield page;
+    }
+  }
+
+  private async *listPagingAll(
+    options?: OperationsListOptionalParams
+  ): AsyncIterableIterator<CostManagementOperation> {
+    for await (const page of this.listPagingPage(options)) {
+      yield* page;
+    }
+  }
+
+  /**
+   * Lists all of the available cost management REST API operations.
+   * @param options The options parameters.
+   */
+  private _list(
+    options?: OperationsListOptionalParams
+  ): Promise<OperationsListResponse> {
+    return this.client.sendOperationRequest({ options }, listOperationSpec);
+  }
+
+  /**
+   * ListNext
+   * @param nextLink The nextLink from the previous successful call to the List method.
+   * @param options The options parameters.
+   */
+  private _listNext(
+    nextLink: string,
+    options?: OperationsListNextOptionalParams
+  ): Promise<OperationsListNextResponse> {
+    return this.client.sendOperationRequest(
+      { nextLink, options },
+      listNextOperationSpec
+    );
+  }
+}
+// Operation Specifications
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const listOperationSpec: coreClient.OperationSpec = {
+  path: "/providers/Microsoft.CostManagement/operations",
+  httpMethod: "GET",
+  responses: {
+    200: {
+      bodyMapper: Mappers.OperationListResult
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host],
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const listNextOperationSpec: coreClient.OperationSpec = {
+  path: "{nextLink}",
+  httpMethod: "GET",
+  responses: {
+    200: {
+      bodyMapper: Mappers.OperationListResult
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  urlParameters: [Parameters.$host, Parameters.nextLink],
+  headerParameters: [Parameters.accept],
+  serializer
+};

package/src/operations/priceSheet.ts

@@ -0,0 +1,299 @@
+/*
+ * 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 { PriceSheet } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
+import * as Parameters from "../models/parameters";
+import { CostManagementClient } from "../costManagementClient";
+import {
+  SimplePollerLike,
+  OperationState,
+  createHttpPoller
+} from "@azure/core-lro";
+import { createLroSpec } from "../lroImpl";
+import {
+  PriceSheetDownloadOptionalParams,
+  PriceSheetDownloadResponse,
+  PriceSheetDownloadByBillingProfileOptionalParams,
+  PriceSheetDownloadByBillingProfileResponse
+} from "../models";
+
+/** Class containing PriceSheet operations. */
+export class PriceSheetImpl implements PriceSheet {
+  private readonly client: CostManagementClient;
+
+  /**
+   * Initialize a new instance of the class PriceSheet class.
+   * @param client Reference to the service client
+   */
+  constructor(client: CostManagementClient) {
+    this.client = client;
+  }
+
+  /**
+   * Gets a URL to download the pricesheet for an invoice. The operation is supported for billing
+   * accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.
+   * @param billingAccountName The ID that uniquely identifies a billing account.
+   * @param billingProfileName The ID that uniquely identifies a billing profile.
+   * @param invoiceName The ID that uniquely identifies an invoice.
+   * @param options The options parameters.
+   */
+  async beginDownload(
+    billingAccountName: string,
+    billingProfileName: string,
+    invoiceName: string,
+    options?: PriceSheetDownloadOptionalParams
+  ): Promise<
+    SimplePollerLike<
+      OperationState<PriceSheetDownloadResponse>,
+      PriceSheetDownloadResponse
+    >
+  > {
+    const directSendOperation = async (
+      args: coreClient.OperationArguments,
+      spec: coreClient.OperationSpec
+    ): Promise<PriceSheetDownloadResponse> => {
+      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: { billingAccountName, billingProfileName, invoiceName, options },
+      spec: downloadOperationSpec
+    });
+    const poller = await createHttpPoller<
+      PriceSheetDownloadResponse,
+      OperationState<PriceSheetDownloadResponse>
+    >(lro, {
+      restoreFrom: options?.resumeFrom,
+      intervalInMs: options?.updateIntervalInMs,
+      resourceLocationConfig: "location"
+    });
+    await poller.poll();
+    return poller;
+  }
+
+  /**
+   * Gets a URL to download the pricesheet for an invoice. The operation is supported for billing
+   * accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.
+   * @param billingAccountName The ID that uniquely identifies a billing account.
+   * @param billingProfileName The ID that uniquely identifies a billing profile.
+   * @param invoiceName The ID that uniquely identifies an invoice.
+   * @param options The options parameters.
+   */
+  async beginDownloadAndWait(
+    billingAccountName: string,
+    billingProfileName: string,
+    invoiceName: string,
+    options?: PriceSheetDownloadOptionalParams
+  ): Promise<PriceSheetDownloadResponse> {
+    const poller = await this.beginDownload(
+      billingAccountName,
+      billingProfileName,
+      invoiceName,
+      options
+    );
+    return poller.pollUntilDone();
+  }
+
+  /**
+   * Gets a URL to download the current month's pricesheet for a billing profile. The operation is
+   * supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer
+   * Agreement.Due to Azure product growth, the Azure price sheet download experience in this preview
+   * version will be updated from a single csv file to a Zip file containing multiple csv files, each
+   * with max 200k records.
+   * @param billingAccountName The ID that uniquely identifies a billing account.
+   * @param billingProfileName The ID that uniquely identifies a billing profile.
+   * @param options The options parameters.
+   */
+  async beginDownloadByBillingProfile(
+    billingAccountName: string,
+    billingProfileName: string,
+    options?: PriceSheetDownloadByBillingProfileOptionalParams
+  ): Promise<
+    SimplePollerLike<
+      OperationState<PriceSheetDownloadByBillingProfileResponse>,
+      PriceSheetDownloadByBillingProfileResponse
+    >
+  > {
+    const directSendOperation = async (
+      args: coreClient.OperationArguments,
+      spec: coreClient.OperationSpec
+    ): Promise<PriceSheetDownloadByBillingProfileResponse> => {
+      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: { billingAccountName, billingProfileName, options },
+      spec: downloadByBillingProfileOperationSpec
+    });
+    const poller = await createHttpPoller<
+      PriceSheetDownloadByBillingProfileResponse,
+      OperationState<PriceSheetDownloadByBillingProfileResponse>
+    >(lro, {
+      restoreFrom: options?.resumeFrom,
+      intervalInMs: options?.updateIntervalInMs,
+      resourceLocationConfig: "location"
+    });
+    await poller.poll();
+    return poller;
+  }
+
+  /**
+   * Gets a URL to download the current month's pricesheet for a billing profile. The operation is
+   * supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer
+   * Agreement.Due to Azure product growth, the Azure price sheet download experience in this preview
+   * version will be updated from a single csv file to a Zip file containing multiple csv files, each
+   * with max 200k records.
+   * @param billingAccountName The ID that uniquely identifies a billing account.
+   * @param billingProfileName The ID that uniquely identifies a billing profile.
+   * @param options The options parameters.
+   */
+  async beginDownloadByBillingProfileAndWait(
+    billingAccountName: string,
+    billingProfileName: string,
+    options?: PriceSheetDownloadByBillingProfileOptionalParams
+  ): Promise<PriceSheetDownloadByBillingProfileResponse> {
+    const poller = await this.beginDownloadByBillingProfile(
+      billingAccountName,
+      billingProfileName,
+      options
+    );
+    return poller.pollUntilDone();
+  }
+}
+// Operation Specifications
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const downloadOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices/{invoiceName}/providers/Microsoft.CostManagement/pricesheets/default/download",
+  httpMethod: "POST",
+  responses: {
+    200: {
+      bodyMapper: Mappers.DownloadURL
+    },
+    201: {
+      bodyMapper: Mappers.DownloadURL
+    },
+    202: {
+      bodyMapper: Mappers.DownloadURL
+    },
+    204: {
+      bodyMapper: Mappers.DownloadURL
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.billingAccountName,
+    Parameters.billingProfileName,
+    Parameters.invoiceName
+  ],
+  headerParameters: [Parameters.accept],
+  serializer
+};
+const downloadByBillingProfileOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.CostManagement/pricesheets/default/download",
+  httpMethod: "POST",
+  responses: {
+    200: {
+      bodyMapper: Mappers.DownloadURL
+    },
+    201: {
+      bodyMapper: Mappers.DownloadURL
+    },
+    202: {
+      bodyMapper: Mappers.DownloadURL
+    },
+    204: {
+      bodyMapper: Mappers.DownloadURL
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.billingAccountName,
+    Parameters.billingProfileName
+  ],
+  headerParameters: [Parameters.accept],
+  serializer
+};

package/src/operations/query.ts

@@ -0,0 +1,137 @@
+/*
+ * 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 { Query } from "../operationsInterfaces";
+import * as coreClient from "@azure/core-client";
+import * as Mappers from "../models/mappers";
+import * as Parameters from "../models/parameters";
+import { CostManagementClient } from "../costManagementClient";
+import {
+  QueryDefinition,
+  QueryUsageOptionalParams,
+  QueryUsageResponse,
+  ExternalCloudProviderType,
+  QueryUsageByExternalCloudProviderTypeOptionalParams,
+  QueryUsageByExternalCloudProviderTypeResponse
+} from "../models";
+
+/** Class containing Query operations. */
+export class QueryImpl implements Query {
+  private readonly client: CostManagementClient;
+
+  /**
+   * Initialize a new instance of the class Query class.
+   * @param client Reference to the service client
+   */
+  constructor(client: CostManagementClient) {
+    this.client = client;
+  }
+
+  /**
+   * Query the usage data for scope defined.
+   * @param scope The scope associated with query and export operations. This includes
+   *              '/subscriptions/{subscriptionId}/' for subscription scope,
+   *              '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope,
+   *              '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope and
+   *              '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for
+   *              Department scope,
+   *              '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}'
+   *              for EnrollmentAccount scope, '/providers/Microsoft.Management/managementGroups/{managementGroupId}
+   *              for Management Group scope,
+   *              '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}'
+   *              for billingProfile scope,
+   *              '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}'
+   *              for invoiceSection scope, and
+   *              '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/customers/{customerId}' specific
+   *              for partners.
+   * @param parameters Parameters supplied to the CreateOrUpdate Query Config operation.
+   * @param options The options parameters.
+   */
+  usage(
+    scope: string,
+    parameters: QueryDefinition,
+    options?: QueryUsageOptionalParams
+  ): Promise<QueryUsageResponse> {
+    return this.client.sendOperationRequest(
+      { scope, parameters, options },
+      usageOperationSpec
+    );
+  }
+
+  /**
+   * Query the usage data for external cloud provider type defined.
+   * @param externalCloudProviderType The external cloud provider type associated with dimension/query
+   *                                  operations. This includes 'externalSubscriptions' for linked account and 'externalBillingAccounts'
+   *                                  for consolidated account.
+   * @param externalCloudProviderId This can be '{externalSubscriptionId}' for linked account or
+   *                                '{externalBillingAccountId}' for consolidated account used with dimension/query operations.
+   * @param parameters Parameters supplied to the CreateOrUpdate Query Config operation.
+   * @param options The options parameters.
+   */
+  usageByExternalCloudProviderType(
+    externalCloudProviderType: ExternalCloudProviderType,
+    externalCloudProviderId: string,
+    parameters: QueryDefinition,
+    options?: QueryUsageByExternalCloudProviderTypeOptionalParams
+  ): Promise<QueryUsageByExternalCloudProviderTypeResponse> {
+    return this.client.sendOperationRequest(
+      {
+        externalCloudProviderType,
+        externalCloudProviderId,
+        parameters,
+        options
+      },
+      usageByExternalCloudProviderTypeOperationSpec
+    );
+  }
+}
+// Operation Specifications
+const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);
+
+const usageOperationSpec: coreClient.OperationSpec = {
+  path: "/{scope}/providers/Microsoft.CostManagement/query",
+  httpMethod: "POST",
+  responses: {
+    200: {
+      bodyMapper: Mappers.QueryResult
+    },
+    204: {},
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  requestBody: Parameters.parameters3,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [Parameters.$host, Parameters.scope1],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
+  serializer
+};
+const usageByExternalCloudProviderTypeOperationSpec: coreClient.OperationSpec = {
+  path:
+    "/providers/Microsoft.CostManagement/{externalCloudProviderType}/{externalCloudProviderId}/query",
+  httpMethod: "POST",
+  responses: {
+    200: {
+      bodyMapper: Mappers.QueryResult
+    },
+    default: {
+      bodyMapper: Mappers.ErrorResponse
+    }
+  },
+  requestBody: Parameters.parameters3,
+  queryParameters: [Parameters.apiVersion],
+  urlParameters: [
+    Parameters.$host,
+    Parameters.externalCloudProviderType,
+    Parameters.externalCloudProviderId
+  ],
+  headerParameters: [Parameters.accept, Parameters.contentType],
+  mediaType: "json",
+  serializer
+};