@azure/arm-apimanagement 9.0.1-alpha.20230823.1 → 9.1.0

package/src/apiManagementClient.ts

@@ -14,8 +14,12 @@ import {
   SendRequest
 } from "@azure/core-rest-pipeline";
 import * as coreAuth from "@azure/core-auth";
-import { PollerLike, PollOperationState, LroEngine } from "@azure/core-lro";
-import { LroImpl } from "./lroImpl";
+import {
+  SimplePollerLike,
+  OperationState,
+  createHttpPoller
+} from "@azure/core-lro";
+import { createLroSpec } from "./lroImpl";
 import {
   ApiImpl,
   ApiRevisionImpl,
@@ -23,6 +27,8 @@ import {
   ApiOperationImpl,
   ApiOperationPolicyImpl,
   TagImpl,
+  GraphQLApiResolverImpl,
+  GraphQLApiResolverPolicyImpl,
   ApiProductImpl,
   ApiPolicyImpl,
   ApiSchemaImpl,
@@ -32,9 +38,15 @@ import {
   ApiIssueAttachmentImpl,
   ApiTagDescriptionImpl,
   OperationOperationsImpl,
+  ApiWikiImpl,
+  ApiWikisImpl,
   ApiExportImpl,
   ApiVersionSetImpl,
   AuthorizationServerImpl,
+  AuthorizationProviderImpl,
+  AuthorizationImpl,
+  AuthorizationLoginLinksImpl,
+  AuthorizationAccessPolicyImpl,
   BackendImpl,
   CacheImpl,
   CertificateImpl,
@@ -64,6 +76,8 @@ import {
   OutboundNetworkDependenciesEndpointsImpl,
   PolicyImpl,
   PolicyDescriptionImpl,
+  PolicyFragmentImpl,
+  PortalConfigImpl,
   PortalRevisionImpl,
   PortalSettingsImpl,
   SignInSettingsImpl,
@@ -75,6 +89,8 @@ import {
   ProductGroupImpl,
   ProductSubscriptionsImpl,
   ProductPolicyImpl,
+  ProductWikiImpl,
+  ProductWikisImpl,
   QuotaByCounterKeysImpl,
   QuotaByPeriodKeysImpl,
   RegionImpl,
@@ -91,7 +107,8 @@ import {
   UserGroupImpl,
   UserSubscriptionImpl,
   UserIdentitiesImpl,
-  UserConfirmationPasswordImpl
+  UserConfirmationPasswordImpl,
+  DocumentationImpl
 } from "./operations";
 import {
   Api,
@@ -100,6 +117,8 @@ import {
   ApiOperation,
   ApiOperationPolicy,
   Tag,
+  GraphQLApiResolver,
+  GraphQLApiResolverPolicy,
   ApiProduct,
   ApiPolicy,
   ApiSchema,
@@ -109,9 +128,15 @@ import {
   ApiIssueAttachment,
   ApiTagDescription,
   OperationOperations,
+  ApiWiki,
+  ApiWikis,
   ApiExport,
   ApiVersionSet,
   AuthorizationServer,
+  AuthorizationProvider,
+  Authorization,
+  AuthorizationLoginLinks,
+  AuthorizationAccessPolicy,
   Backend,
   Cache,
   Certificate,
@@ -141,6 +166,8 @@ import {
   OutboundNetworkDependenciesEndpoints,
   Policy,
   PolicyDescription,
+  PolicyFragment,
+  PortalConfig,
   PortalRevision,
   PortalSettings,
   SignInSettings,
@@ -152,6 +179,8 @@ import {
   ProductGroup,
   ProductSubscriptions,
   ProductPolicy,
+  ProductWiki,
+  ProductWikis,
   QuotaByCounterKeys,
   QuotaByPeriodKeys,
   Region,
@@ -168,7 +197,8 @@ import {
   UserGroup,
   UserSubscription,
   UserIdentities,
-  UserConfirmationPassword
+  UserConfirmationPassword,
+  Documentation
 } from "./operationsInterfaces";
 import * as Parameters from "./models/parameters";
 import * as Mappers from "./models/mappers";
@@ -182,25 +212,38 @@ import {
 export class ApiManagementClient extends coreClient.ServiceClient {
   $host: string;
   apiVersion: string;
-  subscriptionId: string;
+  subscriptionId?: string;
 
   /**
    * Initializes a new instance of the ApiManagementClient class.
    * @param credentials Subscription credentials which uniquely identify client subscription.
-   * @param subscriptionId Subscription credentials which uniquely identify Microsoft Azure subscription.
-   *                       The subscription ID forms part of the URI for every service call.
+   * @param subscriptionId The ID of the target subscription.
    * @param options The parameter options
    */
   constructor(
     credentials: coreAuth.TokenCredential,
     subscriptionId: string,
     options?: ApiManagementClientOptionalParams
+  );
+  constructor(
+    credentials: coreAuth.TokenCredential,
+    options?: ApiManagementClientOptionalParams
+  );
+  constructor(
+    credentials: coreAuth.TokenCredential,
+    subscriptionIdOrOptions?: ApiManagementClientOptionalParams | string,
+    options?: ApiManagementClientOptionalParams
   ) {
     if (credentials === undefined) {
       throw new Error("'credentials' cannot be null");
     }
-    if (subscriptionId === undefined) {
-      throw new Error("'subscriptionId' cannot be null");
+
+    let subscriptionId: string | undefined;
+
+    if (typeof subscriptionIdOrOptions === "string") {
+      subscriptionId = subscriptionIdOrOptions;
+    } else if (typeof subscriptionIdOrOptions === "object") {
+      options = subscriptionIdOrOptions;
     }
 
     // Initializing default values for options
@@ -212,7 +255,7 @@ export class ApiManagementClient extends coreClient.ServiceClient {
       credential: credentials
     };
 
-    const packageDetails = `azsdk-js-arm-apimanagement/9.0.1`;
+    const packageDetails = `azsdk-js-arm-apimanagement/9.1.0`;
     const userAgentPrefix =
       options.userAgentOptions && options.userAgentOptions.userAgentPrefix
         ? `${options.userAgentOptions.userAgentPrefix} ${packageDetails}`
@@ -265,13 +308,15 @@ export class ApiManagementClient extends coreClient.ServiceClient {
 
     // Assigning values to Constant parameters
     this.$host = options.$host || "https://management.azure.com";
-    this.apiVersion = options.apiVersion || "2021-08-01";
+    this.apiVersion = options.apiVersion || "2022-08-01";
     this.api = new ApiImpl(this);
     this.apiRevision = new ApiRevisionImpl(this);
     this.apiRelease = new ApiReleaseImpl(this);
     this.apiOperation = new ApiOperationImpl(this);
     this.apiOperationPolicy = new ApiOperationPolicyImpl(this);
     this.tag = new TagImpl(this);
+    this.graphQLApiResolver = new GraphQLApiResolverImpl(this);
+    this.graphQLApiResolverPolicy = new GraphQLApiResolverPolicyImpl(this);
     this.apiProduct = new ApiProductImpl(this);
     this.apiPolicy = new ApiPolicyImpl(this);
     this.apiSchema = new ApiSchemaImpl(this);
@@ -281,9 +326,15 @@ export class ApiManagementClient extends coreClient.ServiceClient {
     this.apiIssueAttachment = new ApiIssueAttachmentImpl(this);
     this.apiTagDescription = new ApiTagDescriptionImpl(this);
     this.operationOperations = new OperationOperationsImpl(this);
+    this.apiWiki = new ApiWikiImpl(this);
+    this.apiWikis = new ApiWikisImpl(this);
     this.apiExport = new ApiExportImpl(this);
     this.apiVersionSet = new ApiVersionSetImpl(this);
     this.authorizationServer = new AuthorizationServerImpl(this);
+    this.authorizationProvider = new AuthorizationProviderImpl(this);
+    this.authorization = new AuthorizationImpl(this);
+    this.authorizationLoginLinks = new AuthorizationLoginLinksImpl(this);
+    this.authorizationAccessPolicy = new AuthorizationAccessPolicyImpl(this);
     this.backend = new BackendImpl(this);
     this.cache = new CacheImpl(this);
     this.certificate = new CertificateImpl(this);
@@ -319,6 +370,8 @@ export class ApiManagementClient extends coreClient.ServiceClient {
     );
     this.policy = new PolicyImpl(this);
     this.policyDescription = new PolicyDescriptionImpl(this);
+    this.policyFragment = new PolicyFragmentImpl(this);
+    this.portalConfig = new PortalConfigImpl(this);
     this.portalRevision = new PortalRevisionImpl(this);
     this.portalSettings = new PortalSettingsImpl(this);
     this.signInSettings = new SignInSettingsImpl(this);
@@ -332,6 +385,8 @@ export class ApiManagementClient extends coreClient.ServiceClient {
     this.productGroup = new ProductGroupImpl(this);
     this.productSubscriptions = new ProductSubscriptionsImpl(this);
     this.productPolicy = new ProductPolicyImpl(this);
+    this.productWiki = new ProductWikiImpl(this);
+    this.productWikis = new ProductWikisImpl(this);
     this.quotaByCounterKeys = new QuotaByCounterKeysImpl(this);
     this.quotaByPeriodKeys = new QuotaByPeriodKeysImpl(this);
     this.region = new RegionImpl(this);
@@ -349,6 +404,7 @@ export class ApiManagementClient extends coreClient.ServiceClient {
     this.userSubscription = new UserSubscriptionImpl(this);
     this.userIdentities = new UserIdentitiesImpl(this);
     this.userConfirmationPassword = new UserConfirmationPasswordImpl(this);
+    this.documentation = new DocumentationImpl(this);
     this.addCustomApiVersionPolicy(options.apiVersion);
   }
 
@@ -383,7 +439,7 @@ export class ApiManagementClient extends coreClient.ServiceClient {
   /**
    * Performs a connectivity check between the API Management service and a given destination, and
    * returns metrics for the connection, as well as errors encountered while trying to establish it.
-   * @param resourceGroupName The name of the resource group.
+   * @param resourceGroupName The name of the resource group. The name is case insensitive.
    * @param serviceName The name of the API Management service.
    * @param connectivityCheckRequestParams Connectivity Check request parameters.
    * @param options The options parameters.
@@ -394,8 +450,8 @@ export class ApiManagementClient extends coreClient.ServiceClient {
     connectivityCheckRequestParams: ConnectivityCheckRequest,
     options?: PerformConnectivityCheckAsyncOptionalParams
   ): Promise<
-    PollerLike<
-      PollOperationState<PerformConnectivityCheckAsyncResponse>,
+    SimplePollerLike<
+      OperationState<PerformConnectivityCheckAsyncResponse>,
       PerformConnectivityCheckAsyncResponse
     >
   > {
@@ -405,7 +461,7 @@ export class ApiManagementClient extends coreClient.ServiceClient {
     ): Promise<PerformConnectivityCheckAsyncResponse> => {
       return this.sendOperationRequest(args, spec);
     };
-    const sendOperation = async (
+    const sendOperationFn = async (
       args: coreClient.OperationArguments,
       spec: coreClient.OperationSpec
     ) => {
@@ -438,20 +494,23 @@ export class ApiManagementClient extends coreClient.ServiceClient {
       };
     };
 
-    const lro = new LroImpl(
-      sendOperation,
-      {
+    const lro = createLroSpec({
+      sendOperationFn,
+      args: {
         resourceGroupName,
         serviceName,
         connectivityCheckRequestParams,
         options
       },
-      performConnectivityCheckAsyncOperationSpec
-    );
-    const poller = new LroEngine(lro, {
-      resumeFrom: options?.resumeFrom,
+      spec: performConnectivityCheckAsyncOperationSpec
+    });
+    const poller = await createHttpPoller<
+      PerformConnectivityCheckAsyncResponse,
+      OperationState<PerformConnectivityCheckAsyncResponse>
+    >(lro, {
+      restoreFrom: options?.resumeFrom,
       intervalInMs: options?.updateIntervalInMs,
-      lroResourceLocationConfig: "location"
+      resourceLocationConfig: "location"
     });
     await poller.poll();
     return poller;
@@ -460,7 +519,7 @@ export class ApiManagementClient extends coreClient.ServiceClient {
   /**
    * Performs a connectivity check between the API Management service and a given destination, and
    * returns metrics for the connection, as well as errors encountered while trying to establish it.
-   * @param resourceGroupName The name of the resource group.
+   * @param resourceGroupName The name of the resource group. The name is case insensitive.
    * @param serviceName The name of the API Management service.
    * @param connectivityCheckRequestParams Connectivity Check request parameters.
    * @param options The options parameters.
@@ -486,6 +545,8 @@ export class ApiManagementClient extends coreClient.ServiceClient {
   apiOperation: ApiOperation;
   apiOperationPolicy: ApiOperationPolicy;
   tag: Tag;
+  graphQLApiResolver: GraphQLApiResolver;
+  graphQLApiResolverPolicy: GraphQLApiResolverPolicy;
   apiProduct: ApiProduct;
   apiPolicy: ApiPolicy;
   apiSchema: ApiSchema;
@@ -495,9 +556,15 @@ export class ApiManagementClient extends coreClient.ServiceClient {
   apiIssueAttachment: ApiIssueAttachment;
   apiTagDescription: ApiTagDescription;
   operationOperations: OperationOperations;
+  apiWiki: ApiWiki;
+  apiWikis: ApiWikis;
   apiExport: ApiExport;
   apiVersionSet: ApiVersionSet;
   authorizationServer: AuthorizationServer;
+  authorizationProvider: AuthorizationProvider;
+  authorization: Authorization;
+  authorizationLoginLinks: AuthorizationLoginLinks;
+  authorizationAccessPolicy: AuthorizationAccessPolicy;
   backend: Backend;
   cache: Cache;
   certificate: Certificate;
@@ -527,6 +594,8 @@ export class ApiManagementClient extends coreClient.ServiceClient {
   outboundNetworkDependenciesEndpoints: OutboundNetworkDependenciesEndpoints;
   policy: Policy;
   policyDescription: PolicyDescription;
+  policyFragment: PolicyFragment;
+  portalConfig: PortalConfig;
   portalRevision: PortalRevision;
   portalSettings: PortalSettings;
   signInSettings: SignInSettings;
@@ -538,6 +607,8 @@ export class ApiManagementClient extends coreClient.ServiceClient {
   productGroup: ProductGroup;
   productSubscriptions: ProductSubscriptions;
   productPolicy: ProductPolicy;
+  productWiki: ProductWiki;
+  productWikis: ProductWikis;
   quotaByCounterKeys: QuotaByCounterKeys;
   quotaByPeriodKeys: QuotaByPeriodKeys;
   region: Region;
@@ -555,6 +626,7 @@ export class ApiManagementClient extends coreClient.ServiceClient {
   userSubscription: UserSubscription;
   userIdentities: UserIdentities;
   userConfirmationPassword: UserConfirmationPassword;
+  documentation: Documentation;
 }
 // Operation Specifications
 const serializer = coreClient.createSerializer(Mappers, /* isXml */ false);

package/src/lroImpl.ts

@@ -6,29 +6,37 @@
  * Changes may cause incorrect behavior and will be lost if the code is regenerated.
  */
 
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+import { AbortSignalLike } from "@azure/abort-controller";
 import { LongRunningOperation, LroResponse } from "@azure/core-lro";
 
-export class LroImpl<T> implements LongRunningOperation<T> {
-  constructor(
-    private sendOperationFn: (args: any, spec: any) => Promise<LroResponse<T>>,
-    private args: Record<string, unknown>,
-    private spec: {
-      readonly requestBody?: unknown;
-      readonly path?: string;
-      readonly httpMethod: string;
-    } & Record<string, any>,
-    public requestPath: string = spec.path!,
-    public requestMethod: string = spec.httpMethod
-  ) {}
-  public async sendInitialRequest(): Promise<LroResponse<T>> {
-    return this.sendOperationFn(this.args, this.spec);
-  }
-  public async sendPollRequest(path: string): Promise<LroResponse<T>> {
-    const { requestBody, ...restSpec } = this.spec;
-    return this.sendOperationFn(this.args, {
-      ...restSpec,
-      path,
-      httpMethod: "GET"
-    });
-  }
+export function createLroSpec<T>(inputs: {
+  sendOperationFn: (args: any, spec: any) => Promise<LroResponse<T>>;
+  args: Record<string, unknown>;
+  spec: {
+    readonly requestBody?: unknown;
+    readonly path?: string;
+    readonly httpMethod: string;
+  } & Record<string, any>;
+}): LongRunningOperation<T> {
+  const { args, spec, sendOperationFn } = inputs;
+  return {
+    requestMethod: spec.httpMethod,
+    requestPath: spec.path!,
+    sendInitialRequest: () => sendOperationFn(args, spec),
+    sendPollRequest: (
+      path: string,
+      options?: { abortSignal?: AbortSignalLike }
+    ) => {
+      const { requestBody, ...restSpec } = spec;
+      return sendOperationFn(args, {
+        ...restSpec,
+        httpMethod: "GET",
+        path,
+        abortSignal: options?.abortSignal
+      });
+    }
+  };
 }