Azure Monitor Private Link Scopes

Name: Azure Monitor Private Link Scopes API
Brand: Azure Monitor Private Link Scopes
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCloud InfrastructureNetworkingoauth216 EndpointsREST

For Agents

Create Azure Monitor Private Link Scopes, attach Application Insights and Log Analytics resources to them, and approve or reject the private endpoint connections that bind monitoring to a private network.

Connect the Azure Monitor Private Link Scopes to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Azure Monitor Private Link Scopes, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Azure Monitor Private Link Scopes API.

Create or update an Azure Monitor Private Link Scope and configure its resource group placement

Attach Application Insights components or Log Analytics workspaces to a scope as scopedResources

Approve, reject, or delete pending private endpoint connections on an AMPLS

List the privateLinkResources exposed by a scope for client-side DNS configuration

GET STARTED

Start building with Azure Monitor Private Link Scopes API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Azure Monitor Private Link Scopes, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Azure Monitor Private Link Scopes, keeping it validated and agent-ready. The API manages Azure Monitor Private Link Scopes (AMPLS) under the microsoft.insights provider, allowing teams to gate Application Insights and Log Analytics ingestion to private network endpoints. It exposes 16 endpoints covering scope CRUD, scoped resource binding, private endpoint connection approval, and private link resource discovery.

Use Cases

Patterns agents use Azure Monitor Private Link Scopes API for, with concrete tasks.

★ Lock Application Insights Ingestion to a Private Network

Create an Azure Monitor Private Link Scope, attach the relevant Application Insights components and Log Analytics workspaces as scopedResources, and approve a private endpoint connection from the corporate VNet so monitoring data never traverses the public internet. The PUT on /privateLinkScopes/{scopeName} provisions the scope, the scopedResources child API binds monitoring resources, and privateEndpointConnections approves the inbound link. This satisfies common compliance requirements that telemetry must remain on private networking.

Create an AMPLS named 'prod-ampls' in resource group 'monitoring-rg', attach the Log Analytics workspace 'prod-law', and approve the pending private endpoint connection from the corporate VNet

Approve Pending Private Endpoint Connections at Scale

Iterate over every Private Link Scope in a subscription, list its pending privateEndpointConnections, and approve those originating from approved subscriptions while rejecting the rest. The privateEndpointConnections API supports list, get, create-or-update (used for approval state), and delete on a per-connection basis. This replaces manual portal review and produces a deterministic audit log of approval decisions.

List all private endpoint connections on AMPLS 'prod-ampls' with status Pending and approve any whose subscription id is in the allowlist, rejecting the rest

Audit Scoped Resources Across All AMPLS

Walk every Azure Monitor Private Link Scope in a subscription and list its scopedResources to build a single inventory of which Application Insights components and Log Analytics workspaces are protected by private link. Each scopedResource record includes the linkedResourceId so the report can be correlated with the resource's own metadata. This audit is the foundation for compliance evidence that telemetry is private-network only.

List every AMPLS in subscription '00000000-0000-0000-0000-000000000000' and emit a CSV of (scopeName, scopedResourceName, linkedResourceId) rows

Agent-Driven AMPLS Compliance Workflow via Jentic

An AI agent uses Jentic to audit Azure Monitor private networking on a schedule: discovering scopes, validating their scoped resources, and approving or rejecting pending private endpoint connections by policy. The agent searches Jentic for 'list azure monitor private link scopes', loads the schema, and chains it into the scopedResources and privateEndpointConnections operations. Azure AD tokens are sourced from the Jentic vault per call.

Search Jentic for 'list azure monitor private link scopes', list every AMPLS, walk each scope's scopedResources and pending privateEndpointConnections, and emit a compliance report flagging deviations

Key Endpoints

16 endpoints — jentic publishes the only available openapi specification for azure monitor private link scopes, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}

Create or update an AMPLS

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}

Get an AMPLS

DELETE

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}

Delete an AMPLS

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes/{scopeName}/scopedResources

List scoped resources on an AMPLS

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes/{scopeName}/privateEndpointConnections/{privateEndpointConnectionName}

Create or update a private endpoint connection (approval/rejection)

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes/{scopeName}/privateEndpointConnections

List private endpoint connections

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes/{scopeName}/privateLinkResources

List private link resources for DNS configuration

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}

Create or update an AMPLS

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}

Get an AMPLS

DELETE

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}

Delete an AMPLS

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes/{scopeName}/scopedResources

List scoped resources on an AMPLS

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes/{scopeName}/privateEndpointConnections/{privateEndpointConnectionName}

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Azure AD client credentials are stored encrypted in the Jentic vault. A short-lived bearer token scoped to https://management.azure.com/ is fetched per call; raw client secrets and refresh tokens never reach the agent context.

Intent-based discovery

Agents search Jentic by intent (e.g., 'attach a workspace to an Azure Monitor private link scope') and receive the matching microsoft.insights operation with its full input schema so the agent calls the right endpoint without browsing the ARM reference.

Time to first call

Direct integration with microsoft.insights private link scopes: 2-4 days for ARM auth, long-running operation polling, and connection approval flows. Through Jentic: under an hour from search to first successful call.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Azure Log Analytics

Manages the Log Analytics workspaces that are bound to an AMPLS as scoped resources.

Use alongside this API when the agent needs to provision the workspace before binding it to a Private Link Scope.

Complementary

Azure Resource Graph

Run KQL queries to find every microsoft.insights resource and validate AMPLS coverage.

Use to discover Application Insights or Log Analytics resources that are not yet scoped to an AMPLS.

Complementary

Azure Activity Log Alerts

Alert on Azure Activity Log events, including AMPLS configuration changes.

Use to alert when an AMPLS or its scoped resources are created, modified, or deleted outside the change window.

FAQs

Specific to using Azure Monitor Private Link Scopes API through Jentic.

Why is there no official OpenAPI spec for Azure Monitor Private Link Scopes?

Microsoft Azure does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Azure Monitor Private Link Scopes via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Azure Monitor Private Link Scopes API use?

The API uses Azure Active Directory OAuth 2.0 (the azure_auth scheme) with the user_impersonation scope on https://management.azure.com/. Through Jentic, the bearer token is fetched from the Jentic vault and injected at call time so the agent never sees the raw client secret.

How do I approve a pending private endpoint connection on an AMPLS?

PUT to /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes/{scopeName}/privateEndpointConnections/{privateEndpointConnectionName} with privateLinkServiceConnectionState.status set to 'Approved'. The same endpoint with status 'Rejected' rejects the connection.

What are the rate limits for the Azure Monitor Private Link Scopes API?

The spec does not declare per-API limits; calls are throttled by Azure Resource Manager's per-subscription budget for read and write operations on microsoft.insights. Honour the Retry-After header on HTTP 429 before retrying.

How do I attach a Log Analytics workspace to an AMPLS through Jentic?

Search Jentic for 'attach log analytics to private link scope', load the schema for PUT /privateLinkScopes/{scopeName}/scopedResources/{name}, supply the linkedResourceId of the workspace, and execute. Jentic injects the Azure AD bearer token automatically.

Is the Azure Monitor Private Link Scopes API free?

Control plane calls are free. The underlying Private Link infrastructure incurs Azure Private Endpoint and DNS charges, and Application Insights or Log Analytics ingestion is billed at standard Azure Monitor rates.