Microsoft Azure API Management

Microsoft Azure API Management Diagnostic API

The Diagnostic API from Microsoft Azure API Management — 2 operation(s) for diagnostic.

GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics List service-wide diagnostic settings · Microsoft Azure API Management Diagnostic_ListByService #
Ask an LLM
“What diagnostic settings are configured across my API Management instance?”
“Can I see which loggers receive telemetry at the service level?”
Tell an agent
List all service-level diagnostics in my {serviceName} instance.
Show the service-level diagnostic settings.
HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId} Check a diagnostic's ETag · Microsoft Azure API Management Diagnostic_GetEntityTag #
Ask an LLM
“How do I get the ETag of a diagnostic before changing it?”
“Can I check whether a diagnostic exists cheaply?”
Tell an agent
Get the ETag version of diagnostic {diagnosticId} on service {serviceName}.
Check the diagnostic's ETag.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId} Get a diagnostic setting · Microsoft Azure API Management Diagnostic_Get #
Ask an LLM
“How do I see the sampling and logging settings of one diagnostic?”
“Which logger does a particular diagnostic send data to?”
Tell an agent
Get the details of diagnostic {diagnosticId} in {serviceName}.
Show the diagnostic setting by its identifier.
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId} Create or replace a diagnostic setting · Microsoft Azure API Management Diagnostic_CreateOrUpdate #
Ask an LLM
“How do I turn on request logging to Application Insights for the whole service?”
“Can I replace a diagnostic configuration entirely?”
Tell an agent
Create or overwrite diagnostic {diagnosticId} on my {serviceName} service.
Create or overwrite this diagnostic.
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId} Update a diagnostic setting · Microsoft Azure API Management Diagnostic_Update #
Ask an LLM
“Can I change the sampling rate on an existing diagnostic?”
“Is it possible to patch only some diagnostic options?”
Tell an agent
Change the sampling on existing diagnostic {diagnosticId} in {serviceName}.
Change the sampling on my existing diagnostic.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId} Delete a diagnostic setting · Microsoft Azure API Management Diagnostic_Delete #
Ask an LLM
“Can I stop service-wide telemetry by removing a diagnostic?”
“Is deleting a diagnostic reversible?”
Tell an agent destructive · confirm first
Delete diagnostic {diagnosticId} from service {serviceName}.
Remove the service-level diagnostic setting.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/rest/api/apimanagement/
📖
APIReference
https://learn.microsoft.com/en-us/rest/api/apimanagement/operation-groups
📖
Authentication
https://learn.microsoft.com/en-us/azure/api-management/authentication-authorization-overview
📖
Documentation
https://learn.microsoft.com/en-us/azure/api-management/api-management-key-concepts
📖
APIReference
https://learn.microsoft.com/en-us/azure/api-management/api-management-policies
📖
GettingStarted
https://learn.microsoft.com/en-us/azure/api-management/import-and-publish
📖
Documentation
https://learn.microsoft.com/en-us/azure/api-management/self-hosted-gateway-overview
📖
GettingStarted
https://learn.microsoft.com/en-us/azure/api-management/how-to-deploy-self-hosted-gateway-azure-kubernetes-service
📖
Documentation
https://learn.microsoft.com/en-us/azure/api-management/genai-gateway-capabilities
📖
GettingStarted
https://learn.microsoft.com/en-us/azure/api-management/azure-openai-api-from-specification
📖
GettingStarted
https://learn.microsoft.com/en-us/azure/api-management/azure-ai-foundry-api
📖
Documentation
https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-developer-portal-customize

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/openapi/microsoft-azure-api-management-diagnostic-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/Azure/api-management-self-hosted-gateway
📦
GitHubRepository
https://github.com/Azure/api-management-developer-portal

Code Examples

💻
CodeExamples
https://github.com/Azure/api-management-self-hosted-gateway-ingress
💻
CodeExamples
https://github.com/Azure-Samples/ai-gateway

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-chat-completion-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-chat-completion-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-completion-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-completion-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-embedding-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-embedding-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-mcp-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-schema/ai-gateway-mcp-response-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-chat-completion-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-chat-completion-response-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-completion-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-completion-response-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-embedding-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-embedding-response-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-mcp-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-structure/ai-gateway-mcp-response-structure.json

Other Resources

🔗
SDKs
https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/apimanagement
🔗
SDKs
https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/apimanagement
🔗
SDKs
https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/apimanagement
🔗
SDKs
https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/apimanagement
🔗
SDKs
https://github.com/Azure/azure-sdk-for-go/tree/main/sdk/resourcemanager/apimanagement
🔗
Tutorials
https://learn.microsoft.com/en-us/azure/api-management/transform-api
🔗
PolicySnippets
https://github.com/Azure/api-management-policy-snippets
🔗
Tools
https://github.com/Azure/azure-api-management-policy-toolkit
🔗
HelmChart
https://github.com/Azure/api-management-self-hosted-gateway/tree/main/helm-charts/azure-api-management-gateway
🔗
MCPServerOverview
https://learn.microsoft.com/en-us/azure/api-management/mcp-server-overview
🔗
ExportRESTToMCP
https://learn.microsoft.com/en-us/azure/api-management/export-rest-mcp-server
🔗
ProxyExistingMCP
https://learn.microsoft.com/en-us/azure/api-management/expose-existing-mcp-server
🔗
A2AAgentAPI
https://learn.microsoft.com/en-us/azure/api-management/agent-to-agent-api
🔗
TokenLimitPolicy
https://learn.microsoft.com/en-us/azure/api-management/llm-token-limit-policy
🔗
SemanticCaching
https://learn.microsoft.com/en-us/azure/api-management/azure-openai-enable-semantic-caching
🔗
ContentSafetyPolicy
https://learn.microsoft.com/en-us/azure/api-management/llm-content-safety-policy
🔗
ReferenceArchitecture
https://github.com/Azure-Samples/ai-hub-gateway-solution-accelerator
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/json-ld/microsoft-azure-api-management-ai-gateway-context.jsonld
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-chat-completion-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-chat-completion-response-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-completion-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-completion-response-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-embedding-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-embedding-response-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-mcp-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-api-management/refs/heads/main/examples/ai-gateway-mcp-response-example.json
🔗
Tutorials
https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-developer-portal-customize

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/microsoft-azure-api-management-diagnostic-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-azure-api-management-diagnostic-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Azure API Management REST Diagnostic API
  description: REST APIs for managing Azure API Management service instances and their entities including APIs, products, subscriptions, users, groups, policies, gateways, backends, certificates, and workspaces. Uses Azure Resource Manager conventions.
  version: '2024-05-01'
  contact:
    name: Microsoft Azure
    url: https://learn.microsoft.com/en-us/rest/api/apimanagement/
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-source: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/apimanagement/resource-manager/Microsoft.ApiManagement/ApiManagement/stable/2024-05-01
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Diagnostic
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics
  : get:
      summary: Microsoft Azure API Management Diagnostic_ListByService
      operationId: Diagnostic_ListByService
      description: Lists all diagnostics of the API Management service instance.
      responses:
        '200':
          description: Success
      tags:
      - Diagnostic
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
  : head:
      summary: Microsoft Azure API Management Diagnostic_GetEntityTag
      operationId: Diagnostic_GetEntityTag
      description: Gets the entity state (Etag) version of the Diagnostic specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Diagnostic
    get:
      summary: Microsoft Azure API Management Diagnostic_Get
      operationId: Diagnostic_Get
      description: Gets the details of the Diagnostic specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Diagnostic
    put:
      summary: Microsoft Azure API Management Diagnostic_CreateOrUpdate
      operationId: Diagnostic_CreateOrUpdate
      description: Creates a new Diagnostic or updates an existing one.
      responses:
        '200':
          description: Success
      tags:
      - Diagnostic
    patch:
      summary: Microsoft Azure API Management Diagnostic_Update
      operationId: Diagnostic_Update
      description: Updates the details of the Diagnostic specified by its identifier.
      responses:
        '200':
          description: Success
      tags:
      - Diagnostic
    delete:
      summary: Microsoft Azure API Management Diagnostic_Delete
      operationId: Diagnostic_Delete
      description: Deletes the specified Diagnostic.
      responses:
        '200':
          description: Success
      tags:
      - Diagnostic
components:
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
          scopes:
            user_impersonation: impersonate your user account
externalDocs:
  description: Azure API Management REST API Reference
  url: https://learn.microsoft.com/en-us/rest/api/apimanagement/