Integration API gateway verified

Product

An API Management product is the package developers subscribe to when they want to use one or more APIs. It is not the backend API itself. Think of it as a managed offering: it can contain APIs, require a subscription key, expose documentation in the developer portal, and apply product-level policies. A product helps API teams decide which consumers can see or call a group of APIs, whether approval is required, and how access should be tracked over time.

Aliases
No aliases mapped yet
Difficulty
fundamentals
CLI mappings
6
Last verified
2026-05-20

Microsoft Learn

In Azure API Management, a product is a container that surfaces one or more APIs to developers. Products can be open or protected, may require subscriptions, and let administrators control visibility, access, policies, and subscription keys for API consumers consistently.

Microsoft Learn: Create and publish a product in Azure API Management2026-05-20

Technical context

In Azure architecture, a product sits inside an API Management service between published APIs and API consumers. It influences developer portal visibility, subscription scope, subscription keys, access approval, and product-level policies that run through the API gateway. Products connect API design with identity, governance, monetization, partner onboarding, and operations. They do not replace backend authorization or workload security, but they define how APIM exposes API bundles to consumers and how administrators manage access at the gateway layer.

Why it matters

Products matter because API gateways become messy when every consumer receives direct, one-off access to individual APIs. A product gives teams a clean way to group APIs by audience, plan, environment, partner, or business capability. It supports open access for low-risk APIs and protected access with subscriptions for controlled APIs. Product-level policies can enforce rate limits, transformations, headers, or other gateway behavior consistently for subscribers. Without good product design, developers see confusing catalogs, subscription keys sprawl, and operations teams struggle to answer who can call which APIs and under what conditions during operations, billing reviews, contract renewals, billing disputes, and audits.

Where you see it

Signals, screens, and Azure surfaces where this term usually becomes operational.

Signal 01

In the API Management portal, the Products blade shows published state, subscription requirement, approval settings, associated APIs, groups, product IDs, assigned groups, and product-level policies.

Signal 02

Azure CLI output from az apim product commands lists product IDs, names, descriptions, terms, subscription requirements, approval settings, publication state, API membership, terms, and groups.

Signal 03

Developer portal pages and subscription records show which products a consumer can discover, request, subscribe to, and use with generated subscription keys, approvals, or portal groups.

When this becomes relevant

Specific situations where this term helps solve real Azure design, operations, migration, security, reliability, cost, or governance problems.

  • Expose partner APIs as a protected APIM product requiring approval and subscription keys before production access.
  • Create separate internal and external API products with different quotas, documentation, and gateway policies.
  • Bundle versioned APIs into a developer-facing offering while hiding backend implementation details from consumers.
  • Apply product-level rate limits to prevent one subscriber group from overwhelming shared backend services.
  • Audit which developers, groups, and subscriptions can call a business API before contract or compliance reviews.

Real-world case studies

Different enterprise-style examples that show the term being used to hit measurable objectives.

Case study 01

Logistics platform packages partner shipment APIs

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

A logistics software company used API Management to expose shipment APIs to carriers, brokers, and warehouse partners. Every partner previously received custom access instructions and inconsistent keys.

Business/Technical Objectives
  • Create a single partner-facing API catalog for shipment operations.
  • Require approval before production API access is granted.
  • Apply partner-specific quotas without changing backend services.
  • Reduce onboarding time for new carriers.
Solution Using Product

The API platform team created an APIM product called Partner Shipment Operations and associated tracking, label, and status callback APIs with it. The product required subscriptions and administrator approval, while developer portal groups controlled which partners could discover it. Product-level policies enforced quotas and added partner headers for backend routing. Azure CLI commands created the product consistently in dev, test, and production, listed attached APIs, and exported product settings for partner audits. Backend services still validated OAuth tokens, so the product subscription key acted as gateway access control rather than the only security boundary. A documented approval workflow linked subscription requests to partner contracts.

Results & Business Impact
  • Carrier onboarding time dropped from ten business days to three.
  • Gateway quota violations fell by 46% after product-level limits were standardized.
  • Partner audit evidence was exported in minutes from APIM product and subscription data.
  • Backend teams stopped creating one-off access paths for each new carrier.
Key Takeaway for Glossary Readers

An APIM product turns a group of APIs into a controlled consumer offering with clear access and operating rules.

Case study 02

Transit agency separates public and internal APIs

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

A city transportation agency published public arrival prediction APIs while keeping internal scheduling APIs private. Developers were confused because both appeared in the same unmanaged catalog.

Business/Technical Objectives
  • Separate public developer access from internal operations access.
  • Protect internal APIs from accidental external subscription.
  • Apply lower public rate limits during major events.
  • Improve developer portal documentation for civic app builders.
Solution Using Product

The agency split its APIs into two APIM products: Public Transit Data and Internal Operations. The public product was published with a subscription requirement and conservative rate limits, while the internal product was visible only to an Entra-backed employee group. Product-level policies set different quotas and response headers, and backend APIs still used separate authorization. Azure CLI listed product membership before each portal release, ensuring internal routes were not attached to the public product. Event-day rate-limit changes were made through product policy updates and reviewed after traffic returned to normal.

Results & Business Impact
  • No internal scheduling API appeared in the public developer portal after the redesign.
  • Public API traffic during a marathon was throttled before backend services degraded.
  • Developer support tickets about API access dropped by 38% in two months.
  • Internal operations retained full access without sharing public subscription rules.
Key Takeaway for Glossary Readers

Products help APIM teams express different audiences and risk levels without duplicating every backend API.

Case study 03

Payments platform builds premium fraud API tiers

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

A B2B payments platform launched premium fraud-screening APIs for enterprise customers. Sales needed controlled access tiers, while engineering needed consistent gateway policies.

Business/Technical Objectives
  • Offer premium API access without changing the fraud-service backend.
  • Track subscribers by customer contract tier.
  • Enforce tighter quotas for trial accounts.
  • Preserve a clean deployment path across environments.
Solution Using Product

The API team created separate APIM products for Trial Fraud Screening and Enterprise Fraud Screening. Both products included the same core APIs, but product-level policies applied different quotas, headers, and analytics dimensions. Subscription approval required a contract reference, and product groups mapped to customer tiers. Azure CLI created and updated products from deployment scripts, then listed APIs attached to each product during release validation. Backends continued to validate tokens and tenant claims, while APIM products controlled gateway packaging and subscription access. Trial subscriptions automatically received lower limits and shorter renewal reviews.

Results & Business Impact
  • Trial customers were onboarded in one day without manual gateway policy edits.
  • Enterprise customers received higher quota limits with no backend code fork.
  • Gateway analytics by product improved revenue reporting for API usage.
  • Release drift between test and production product settings fell to zero in validation checks.
Key Takeaway for Glossary Readers

APIM products are a practical way to align API access with business offerings while keeping backend services stable.

Why use Azure CLI for this?

As an Azure engineer with ten years of API platform work, I use Azure CLI for APIM products because product access changes often need repeatable promotion across environments. The portal is convenient for a single edit, but CLI lets me list products, inspect subscription requirements, associate APIs, compare policy drift, and export product evidence before an audit. It also helps during partner onboarding when multiple products and subscriptions must be checked quickly. If a consumer suddenly loses access, CLI output can prove whether the product is published, whether the API is associated, whether groups apply, and whether subscription rules changed.

CLI use cases

  • List products in an APIM instance and identify which are published, protected, or missing expected metadata.
  • Create a protected partner product with subscription approval before adding APIs and developer groups.
  • Show one product configuration to verify subscription requirement, approval setting, and publication state.
  • List APIs attached to a product before removing access or changing product-level policies.
  • Update product details through deployment automation so dev, test, and production catalogs stay aligned.

Before you run CLI

  • Confirm tenant, subscription, APIM resource group, service name, product ID, and target environment before changing products.
  • Check whether the command only reads product state or updates publication, subscription, or access behavior.
  • Verify permissions for API Management service operations and understand whether workspace-specific access applies.
  • Review backend readiness, product policies, developer groups, and subscription approval rules before publishing a product.
  • Use JSON output for drift checks and table output for quick catalog reviews across APIM instances.

What output tells you

  • Product IDs are stable identifiers used by CLI and automation; display names alone can be duplicated or changed.
  • Subscription required and approval settings show whether consumers need keys and administrator approval before calling APIs.
  • Publication state tells you whether the product is visible to developers or still staged for configuration.
  • Associated API lists show which gateway routes become available when a consumer subscribes to the product.
  • Policy and group relationships explain why two consumers calling the same backend API may receive different gateway behavior.

Mapped Azure CLI commands

Product CLI Commands

direct
az apim product list --resource-group <resource-group> --service-name <apim-name> --output table
az apim productdiscoverIntegration
az apim product show --resource-group <resource-group> --service-name <apim-name> --product-id <product-id>
az apim productdiscoverIntegration
az apim product create --resource-group <resource-group> --service-name <apim-name> --product-id <product-id> --product-name <name> --subscription-required true
az apim productprovisionIntegration
az apim product update --resource-group <resource-group> --service-name <apim-name> --product-id <product-id> --set state=published
az apim productconfigureIntegration
az apim product api list --resource-group <resource-group> --service-name <apim-name> --product-id <product-id>
az apim product apidiscoverIntegration
az apim product delete --resource-group <resource-group> --service-name <apim-name> --product-id <product-id>
az apim productremoveIntegration

Architecture context

As an Azure architect, I use API Management products to turn backend APIs into consumable offerings. I separate internal, partner, public, and premium API access with different products instead of making one giant catalog. Product design should line up with developer portal groups, subscription approval, APIM policies, API versions, and backend authorization. I also check whether an API belongs in multiple products for different audiences, because product policy can change the behavior that each subscriber receives. A strong product model makes onboarding, revocation, throttling, and audit evidence much cleaner than ad hoc subscription keys undocumented partner exceptions, or emergency workarounds.

Security

Security impact is direct at the API gateway layer. Protected products can require subscriptions and keys, while product visibility and groups help limit who can discover and request access. Risk remains because a subscription key is not a full identity strategy, and open products can expose APIs too broadly if backend authorization is weak. Product policies may enforce quotas or header checks, but they do not replace OAuth, managed identities, mTLS, private networking, or backend validation. Security reviews should verify product visibility, subscription requirements, approval workflow, group membership, key rotation, product policies, backend authorization alignment, evidence exports, and subscriber reviews.

Cost

Cost impact is mostly indirect. Products do not create a separate Azure meter, but they influence API usage, gateway load, backend consumption, and operational support effort. An open product can drive unexpected traffic if consumers discover it broadly. Protected products with quotas, rate limits, and approval workflows can reduce backend overuse and make cost attribution easier. Product sprawl also costs time because operators must manage subscriptions, policies, documentation, and support paths. FinOps owners should review call volume by product, subscription growth, backend cost by consumer group, and unused products that still require maintenance by platform teams every quarter for governance.

Reliability

Reliability impact is indirect but practical. A product does not run the backend service, but it shapes how consumers reach APIs through APIM. Poor product design can overload a backend if many consumers share an open product without quotas or rate limits. Product-level policy mistakes can break every API inside the product at once. Reliable designs test policy changes, use revision workflows, separate high-risk consumers, and monitor gateway errors by product and subscription. Operators should keep rollback paths for policy updates, document which APIs belong to each product, and alert on sudden call-volume shifts before backends fail under load suddenly.

Performance

Performance impact is indirect through gateway behavior and consumer traffic patterns. Product-level policies can add transformations, validation, rate limits, quota checks, header changes, and routing decisions that affect request latency. Products also shape how many consumers can call a set of APIs and whether their calls are throttled before reaching backends. A poorly scoped product can concentrate too much traffic on one backend path. Operators should measure APIM gateway latency, backend latency, failed requests, policy errors, subscription call volume, and rate-limit events before changing product access, subscriber groups, policy chains, backend latency, throttling, request volume, payload size, quota events, or policies.

Operations

Operators manage products by listing products, checking whether they are published, associating APIs, reviewing subscriptions, updating policies, and auditing which developers or groups have access. Azure CLI is useful for inventory, drift detection, scripted product creation, and exporting evidence across APIM instances. Day-to-day operations include onboarding partners, disabling stale subscriptions, validating product visibility in the developer portal, and comparing product policies between dev, test, and production. Runbooks should name product owners, approval rules, key rotation practices, API membership, policy review, rollback steps, subscriber communication, and evidence capture before major catalog, contract, partner, policy, or subscription changes across environments. Review product owners monthly.

Common mistakes

  • Publishing an open product accidentally and exposing APIs without subscription approval or clear backend authorization.
  • Assuming a product subscription key replaces user identity, OAuth validation, or backend authorization checks.
  • Removing an API from a product without checking active subscribers and partner contracts first.
  • Using different product IDs across environments and breaking automated promotion or drift comparison.
  • Applying a product-level policy that unintentionally affects every API associated with that product.