Required dependencies

npm install @azure/core-client @azure/core-rest-pipeline @azure/core-auth @azure/identity @azure/core-paging @azure/core-lro @azure/abort-controller @azure/logger

No native modules, pod installs, or Android linking steps are required. All packages are pure JavaScript/TypeScript and run on Node.js 18+ and modern browsers (where supported by the individual library).

Project setup

1. Copy the source/ directory into your project root, e.g. ./azure-sdk/.

2. Each service library lives at a path like azure-sdk/advisor/arm-advisor/. Install the specific package's own dependencies by running npm install inside that folder, or reference its package.json directly.

3. Configure tsconfig.json paths if you want to import directly from source instead of built output:

{
  "compilerOptions": {
    "moduleResolution": "bundler",
    "module": "ESNext",
    "target": "ES2020",
    "strict": true,
    "paths": {
      "@azure/arm-advisor": ["./azure-sdk/advisor/arm-advisor/src/index.ts"],
      "@azure/arm-agricultureplatform": ["./azure-sdk/agricultureplatform/arm-agricultureplatform/src/index.ts"]
    }
  }
}

4. Set the required environment variables for authentication:

AZURE_CLIENT_ID=<your-service-principal-client-id>
AZURE_CLIENT_SECRET=<your-service-principal-client-secret>
AZURE_TENANT_ID=<your-tenant-id>
AZURE_SUBSCRIPTION_ID=<your-subscription-id>

5. Use DefaultAzureCredential from @azure/identity (already a dependency) to authenticate all clients.

Public API

AdvisorManagementClient

import { AdvisorManagementClient } from "./azure-sdk/advisor/arm-advisor/src/index.js";
import { DefaultAzureCredential } from "@azure/identity";

const client = new AdvisorManagementClient(
  new DefaultAzureCredential(),
  "<subscriptionId>"
);

The top-level client for the Azure Advisor ARM service. Use it to access recommendations, configurations, suppressions, recommendationMetadata, and operations sub-clients. Instantiate once per subscription and reuse across calls.

AgriculturePlatformClient

import { AgriculturePlatformClient } from "./azure-sdk/agricultureplatform/arm-agricultureplatform/src/index.js";
import { DefaultAzureCredential } from "@azure/identity";

const client = new AgriculturePlatformClient(
  new DefaultAzureCredential(),
  "<subscriptionId>"
);

ARM client for managing AgriServiceResource instances. Use this to create, update, delete, and list Agriculture Platform resources within a subscription or resource group. Supports long-running operations (LRO) via built-in poller helpers.

getContinuationToken

import { getContinuationToken } from "./azure-sdk/advisor/arm-advisor/src/index.js";

// After receiving a paged response:
const continuationToken = getContinuationToken(pagedResponse);

Extracts the continuation token from a paged ARM response for manual pagination control. Use when you need to checkpoint iteration progress or resume paging across process restarts.

MetadataEntity

import { MetadataEntity } from "./azure-sdk/advisor/arm-advisor/src/index.js";

const entity: MetadataEntity = {
  id: "/providers/Microsoft.Advisor/metadata/cost",
  displayName: "Cost",
  dependsOn: [],
  applicableScenarios: ["Alerts"],
  supportedValues: [{ id: "Low", displayName: "Low Impact" }],
};

Represents a metadata entity returned by the Advisor Recommendation Metadata API. Use it for typed access to recommendation category metadata, including supported values and applicable scenarios.

Working examples

Scenario - List all Advisor recommendations for a subscription

Retrieve all active Advisor recommendations across all categories for a given Azure subscription using async iteration.

import { AdvisorManagementClient } from "./azure-sdk/advisor/arm-advisor/src/index.js";
import { DefaultAzureCredential } from "@azure/identity";

async function listRecommendations() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = process.env.AZURE_SUBSCRIPTION_ID!;
  const client = new AdvisorManagementClient(credential, subscriptionId);

  for await (const rec of client.recommendations.list()) {
    console.log(`[${rec.category}] ${rec.shortDescription?.solution}`);
  }
}

listRecommendations().catch(console.error);

Scenario - Create or update an Advisor configuration in a resource group

Apply a custom Advisor configuration (e.g. set a low CPU threshold) scoped to a specific resource group.

import { AdvisorManagementClient } from "./azure-sdk/advisor/arm-advisor/src/index.js";
import { DefaultAzureCredential } from "@azure/identity";

async function setConfiguration() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = process.env.AZURE_SUBSCRIPTION_ID!;
  const resourceGroup = "my-resource-group";

  const client = new AdvisorManagementClient(credential, subscriptionId);

  const result = await client.configurations.createInResourceGroup(
    "default",
    resourceGroup,
    {
      properties: {
        exclude: false,
        lowCpuThreshold: "5",
      },
    }
  );

  console.log("Configuration created:", result.id);
}

setConfiguration().catch(console.error);

Scenario - List Agriculture Platform AgriService resources by subscription

Enumerate all AgriServiceResource instances across a subscription, logging provisioning state and SKU details.

import { AgriculturePlatformClient } from "./azure-sdk/agricultureplatform/arm-agricultureplatform/src/index.js";
import { DefaultAzureCredential } from "@azure/identity";

async function listAgriServices() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = process.env.AZURE_SUBSCRIPTION_ID!;
  const client = new AgriculturePlatformClient(credential, subscriptionId);

  for await (const svc of client.agriService.listBySubscription()) {
    console.log(
      `Name: ${svc.name}, State: ${svc.properties?.provisioningState}, SKU: ${svc.sku?.name}`
    );
  }
}

listAgriServices().catch(console.error);

File walkthrough

• advisor/ - Contains arm-advisor: the ARM management client for Azure Advisor. Includes generated source, samples, review API snapshots, and CI configuration.
• agricultureplatform/ - Contains arm-agricultureplatform: ARM client for the Agriculture Platform service with LRO and paging support.
• agrifood/ - ARM client for Azure Data Manager for Agriculture (legacy agrifood namespace).
• ai/ - Azure AI service clients (e.g. Inference, Document Intelligence wrappers).
• alertprocessingrules/ - ARM client for creating and managing Azure Monitor alert processing rules.
• analysisservices/ - ARM client for Azure Analysis Services instance management.
• apicenter/ - ARM client for Azure API Center catalog management.
• apimanagement/ - ARM client for Azure API Management service lifecycle.
• appcomplianceautomation/ - ARM client for compliance report generation and management.
• appconfiguration/ - Both ARM management and data-plane client for Azure App Configuration key-value stores.
• appcontainers/ - ARM client for Azure Container Apps environments and apps.
• applicationinsights/ - ARM client for Application Insights component management.
• appnetwork/ - ARM client for application-layer networking resources.
• appservice/ - ARM client for Azure App Service plans, web apps, and function apps.
• eslint.config.mjs - Shared ESLint flat-config for enforcing code style across all SDK packages.
• run.js - Cross-package task runner utility for monorepo-level build and test orchestration.

Common pitfalls and fixes

• DefaultAzureCredential fails silently in CI: Ensure AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, and AZURE_TENANT_ID are all set; missing any one causes fallthrough to the next credential provider with no obvious error.
• ESM/CJS interop errors with .js extension imports: The source uses explicit .js extensions in imports (ESM style); set "moduleResolution": "bundler" or "node16" in tsconfig.json to resolve them correctly.
• PagedAsyncIterableIterator not assignable: Pin @azure/core-paging to the same version required by the specific arm package's package.json; version mismatches cause iterator type incompatibilities.
• Long-running operations (LRO) timing out: Pass { updateIntervalInMs: 5000 } as options to LRO calls; the default polling interval may be too aggressive for some ARM endpoints.
• getContinuationToken returns undefined: Only call it on a raw page response object (the result of .byPage() iteration), not on individual items from for await iteration.
• Samples import from @azure/arm-* package names: The samples-dev/ and samples/ directories assume published packages. When running from source, update imports to point to the local src/index.ts or build first with tsc -p tsconfig.src.json.

Vibe-coding prompt template

I have the Azure SDK for JavaScript source code in my project under ./azure-sdk/
(from the upstream package @azure/monorepo@0.0.1, repository azure-sdk-for-js, sdk/ root).
I also have USAGE.md in the same directory describing the public API and exports.

Please help me integrate this into my existing Node.js/TypeScript project by:

1. Reading USAGE.md and the relevant source files under ./azure-sdk/ to understand
   the available clients and their exports.

2. Installing all required runtime dependencies listed in USAGE.md.

3. Updating my tsconfig.json to resolve the SDK source paths correctly (ESM,
   moduleResolution: bundler, explicit .js extensions).

4. Creating an Azure credential helper using DefaultAzureCredential that reads
   AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID, and AZURE_SUBSCRIPTION_ID
   from environment variables.

5. Adding a service module that uses [AdvisorManagementClient / AgriculturePlatformClient /
   the relevant client from ./azure-sdk/] to [describe your use case here, e.g. list
   recommendations, create a resource, etc.].

6. Showing me how to handle paginated responses using for-await iteration and,
   if needed, getContinuationToken for checkpoint-based pagination.

7. Pointing out any ESM/CJS interop issues or peer dependency version pins I need
   to be aware of based on the actual package.json files in the source.

Work step-by-step, show all file changes, and use only exports documented in USAGE.md
and visible in ./azure-sdk/ source files.

License and credit

All source code is copyright Microsoft Corporation and licensed under the MIT License. See source/advisor/arm-advisor/LICENSE (and the LICENSE file within each individual package directory) for the full license text. Upstream repository: azure-sdk-for-js on GitHub. Upstream npm package: @azure/monorepo@0.0.1.

This product’s unique contribution is clean room implementation of valuable code block into AVCP compatible standard.

Hướng dẫn cài đặt đầy đủ và prompt tích hợp sẽ mở khóa sau khi mua.