Official agent skill

Azure Mgmt Apimanagement Py

by microsoft in microsoft/skills

Azure API Management SDK for Python. An agent skill from microsoft/skills.

OfficialMITAuto-check passedBackend & APIs

Install Azure Mgmt Apimanagement Py

skills CLI
$ npx skills add microsoft/skills --skill azure-mgmt-apimanagement-py -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/skills azure-mgmt-apimanagement-py --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/plugins/azure-sdk-python/skills/azure-mgmt-apimanagement-py .claude/skills/azure-mgmt-apimanagement-py && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
azure-mgmt-apimanagement-py
GitHub stars
3.1k
Used in
5 other repos
Token cost
~2.2k tokens
SKILL.md length
344 words
Files
3 (incl. references)
Skills in repo
150
Repo updated
First seen
Licence
MIT

At a glance

Azure API Management SDK for Python. An agent skill from microsoft/skills.

  • Works in 8 steps: Pick sync OR async and stay consistent.… → Always use context managers for clients… → Use named values for secrets and… → …
  • Managing APIM services
  • SKILL.md covers Installation, Environment Variables, Authentication & Lifecycle and Create APIM Service, plus 13 more sections
  • Calls pip; reaches petstore.swagger.io; needs AZURE_TOKEN_CREDENTIALS

What it does

Azure Mgmt Apimanagement Py is an agent skill from microsoft/skills, published by the product's own GitHub organization. Azure API Management SDK for Python. Use for managing APIM services, APIs, products, subscriptions, and policies. Triggers: "azure-mgmt-apimanagement", "ApiManagementClient", "APIM", "API gateway", "API Management".

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/capabilities.md` and `references/non-hero-scenarios.md`).

It sits in Backend & APIs, covering Microservices. It works with Microsoft Azure, Azure API Management, Python and Visual Studio Code. The repository describes itself as: Skills, MCP servers, Custom Agents, Agents.md for SDKs to ground Coding Agents. The licence is MIT.

When your agent uses it

  • Managing APIM services
  • Tasks that involve Microservices

Example prompts

  • “azure-mgmt-apimanagement”
  • “ApiManagementClient”
  • “API gateway”
  • “/azure-mgmt-apimanagement-py”

Requirements

  • Python 3

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Pick sync OR async and stay consistent. Do not mix azure.xxx sync clients with azure.xxx.aio async clients in the same call path. Choose…
  2. Always use context managers for clients and async credentials. Wrap every client in with Client(...) as client: (sync) or async with…
  3. Use named values for secrets and configuration
  4. Apply policies at appropriate scopes (global, product, API, operation)
  5. Use products to bundle APIs and manage access
  6. Enable Application Insights for monitoring
  7. Use backends to abstract backend services
  8. Version your APIs using APIM's versioning features

What it can do on your machine

Read from SKILL.md and the folder at commit d5741a1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • petstore.swagger.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AZURE_TOKEN_CREDENTIALS

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Azure Mgmt Apimanagement Py loads about 2.2k tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 344 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/skills at commit d5741a1, republished under its MIT licence (© microsoft). 344 words, ~2,216 tokens.

Download SKILL.mdSave it as .claude/skills/azure-mgmt-apimanagement-py/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
azure-mgmt-apimanagement-py
description
Azure API Management SDK for Python. Use for managing APIM services, APIs, products, subscriptions, and policies. Triggers: "azure-mgmt-apimanagement", "ApiManagementClient", "APIM", "API gateway", "API Management".
license
MIT
metadata.author
Microsoft
metadata.version
1.0.0
metadata.package
azure-mgmt-apimanagement

Azure API Management SDK for Python

Manage Azure API Management services, APIs, products, and policies.

Installation

bash
pip install azure-mgmt-apimanagement
pip install azure-identity

Environment Variables

bash
AZURE_SUBSCRIPTION_ID=your-subscription-id  # Required for all auth methods
AZURE_TOKEN_CREDENTIALS=prod # Required only if DefaultAzureCredential is used in production

Authentication & Lifecycle

🔑 Two rules apply to every code sample below:

  1. Prefer DefaultAzureCredential. It works locally (Azure CLI / VS Code / Developer CLI) and in Azure (managed identity, workload identity) with no code change. Avoid connection strings, account/API keys — they bypass Entra audit and rotation.
    • Local dev: DefaultAzureCredential works as-is.
    • Production: set AZURE_TOKEN_CREDENTIALS=prod (or AZURE_TOKEN_CREDENTIALS=<specific_credential>) to constrain the credential chain to production-safe credentials.
  2. Wrap every client in a context manager so HTTP transports, sockets, and token caches are released deterministically:
    • Sync: with <Client>(...) as client:
    • Async: async with <Client>(...) as client: and async with DefaultAzureCredential() as credential: (from azure.identity.aio)

Snippets may abbreviate this setup, but production code should always follow both rules.

python
from azure.identity import DefaultAzureCredential
from azure.mgmt.apimanagement import ApiManagementClient
import os

with ApiManagementClient(
    credential=DefaultAzureCredential(),
    subscription_id=os.environ["AZURE_SUBSCRIPTION_ID"]
) as client:
    # Use `client` for all subsequent operations (see examples below)
    ...

Create APIM Service

python
from azure.mgmt.apimanagement.models import (
    ApiManagementServiceResource,
    ApiManagementServiceSkuProperties,
    SkuType
)

service = client.api_management_service.begin_create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    parameters=ApiManagementServiceResource(
        location="eastus",
        publisher_email="admin@example.com",
        publisher_name="My Organization",
        sku=ApiManagementServiceSkuProperties(
            name=SkuType.DEVELOPER,
            capacity=1
        )
    )
).result()

print(f"Created APIM: {service.name}")

Import API from OpenAPI

python
from azure.mgmt.apimanagement.models import (
    ApiCreateOrUpdateParameter,
    ContentFormat,
    Protocol
)

api = client.api.begin_create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    api_id="my-api",
    parameters=ApiCreateOrUpdateParameter(
        display_name="My API",
        path="myapi",
        protocols=[Protocol.HTTPS],
        format=ContentFormat.OPENAPI_JSON,
        value='{"openapi": "3.0.0", "info": {"title": "My API", "version": "1.0"}, "paths": {"/health": {"get": {"responses": {"200": {"description": "OK"}}}}}}'
    )
).result()

print(f"Imported API: {api.display_name}")

Import API from URL

python
api = client.api.begin_create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    api_id="petstore",
    parameters=ApiCreateOrUpdateParameter(
        display_name="Petstore API",
        path="petstore",
        protocols=[Protocol.HTTPS],
        format=ContentFormat.OPENAPI_LINK,
        value="https://petstore.swagger.io/v2/swagger.json"
    )
).result()

List APIs

python
apis = client.api.list_by_service(
    resource_group_name="my-resource-group",
    service_name="my-apim"
)

for api in apis:
    print(f"{api.name}: {api.display_name} - {api.path}")

Create Product

python
from azure.mgmt.apimanagement.models import ProductContract

product = client.product.create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    product_id="premium",
    parameters=ProductContract(
        display_name="Premium",
        description="Premium tier with unlimited access",
        subscription_required=True,
        approval_required=False,
        state="published"
    )
)

print(f"Created product: {product.display_name}")

Add API to Product

python
client.product_api.create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    product_id="premium",
    api_id="my-api"
)

Create Subscription

python
from azure.mgmt.apimanagement.models import SubscriptionCreateParameters

subscription = client.subscription.create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    sid="my-subscription",
    parameters=SubscriptionCreateParameters(
        display_name="My Subscription",
        scope=f"/products/premium",
        state="active"
    )
)

print(f"Subscription key: {subscription.primary_key}")

Set API Policy

python
from azure.mgmt.apimanagement.models import PolicyContract

policy_xml = """
<policies>
    <inbound>
        <rate-limit calls="100" renewal-period="60" />
        <set-header name="X-Custom-Header" exists-action="override">
            <value>CustomValue</value>
        </set-header>
    </inbound>
    <backend>
        <forward-request />
    </backend>
    <outbound />
    <on-error />
</policies>
"""

client.api_policy.create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    api_id="my-api",
    policy_id="policy",
    parameters=PolicyContract(
        value=policy_xml,
        format="xml"
    )
)

Create Named Value (Secret)

python
from azure.mgmt.apimanagement.models import NamedValueCreateContract

named_value = client.named_value.begin_create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    named_value_id="backend-api-key",
    parameters=NamedValueCreateContract(
        display_name="Backend API Key",
        value="secret-key-value",
        secret=True
    )
).result()

Create Backend

python
from azure.mgmt.apimanagement.models import BackendContract

backend = client.backend.create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    backend_id="my-backend",
    parameters=BackendContract(
        url="https://api.backend.example.com",
        protocol="http",
        description="My backend service"
    )
)

Create User

python
from azure.mgmt.apimanagement.models import UserCreateParameters

user = client.user.create_or_update(
    resource_group_name="my-resource-group",
    service_name="my-apim",
    user_id="newuser",
    parameters=UserCreateParameters(
        email="user@example.com",
        first_name="John",
        last_name="Doe"
    )
)

Operation Groups

GroupPurpose
api_management_serviceAPIM instance management
apiAPI operations
api_operationAPI operation details
api_policyAPI-level policies
productProduct management
product_apiProduct-API associations
subscriptionSubscription management
userUser management
named_valueNamed values/secrets
backendBackend services
certificateCertificates
gatewaySelf-hosted gateways

Best Practices

  1. Pick sync OR async and stay consistent. Do not mix azure.xxx sync clients with azure.xxx.aio async clients in the same call path. Choose one mode per module.
  2. Always use context managers for clients and async credentials. Wrap every client in with Client(...) as client: (sync) or async with Client(...) as client: (async). For async DefaultAzureCredential from azure.identity.aio, also use async with credential: so tokens and transports are cleaned up.
  3. Use named values for secrets and configuration
  4. Apply policies at appropriate scopes (global, product, API, operation)
  5. Use products to bundle APIs and manage access
  6. Enable Application Insights for monitoring
  7. Use backends to abstract backend services
  8. Version your APIs using APIM's versioning features

Reference Files

FileContents
references/capabilities.mdAdditional non-hero capabilities, operation-group coverage, and production checklists.
references/non-hero-scenarios.mdDedicated non-hero examples for secondary/advanced scenarios.

© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .github/plugins/azure-sdk-python/skills/azure-mgmt-apimanagement-py of microsoft/skills.

  • SKILL.md
  • references/capabilities.md
  • references/non-hero-scenarios.md

Open the folder on GitHubat commit d5741a1

Used in 5 other repositories

We found 14 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in microsoft/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Azure Mgmt Apimanagement Py next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Azure Mgmt Apimanagement Py compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Azure Mgmt Apimanagement Py this skillmicrosoft/skills3.1k5 repos~2.2kAutomated safety check: PassMIT
API Security Designvinayaklatthe/microsoft-security-skills175—~2.2kAutomated safety check: PassMIT
Implementing API Gateway Security Controlsmukul975/Anthropic-Cybersecurity-Skills34k—~3.9kAutomated safety check: PassApache-2.0
Azure API CenterMicrosoftDocs/Agent-Skills776—~1.4kAutomated safety check: PassCC-BY-4.0
Engineering PrinciplesAzure/agent-app-orchestrator103—~282Automated safety check: PassMIT
Python Appservice Deploymicrosoft/GitHub-Copilot-for-Azure2551 repos~688Automated safety check: PassMIT

Similar skills

  • API Security Design

    vinayaklatthe/microsoft-security-skills

    Guidance for designing secure APIs on Azure - authentication, authorization, gateway controls, input validation, rate limiting, secret management, and runtime threat detection - aligned to OWASP API…

    175 GitHub stars~2.2k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • Implementing API Gateway Security Controls

    mukul975/Anthropic-Cybersecurity-Skills

    Configures API gateways such as Kong, AWS API Gateway, Azure APIM, or Apigee as a centralized security enforcement point, covering authentication enforcement, rate limiting and throttling, request…

    34k GitHub stars~3.9k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Azure API Center

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure Api Center development including best practices, security, configuration, integrations & coding patterns, and deployment.

    776 GitHub stars~1.4k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Engineering Principles

    Azure/agent-app-orchestrator

    Official

    Agent Landing Zone Orchestrator architecture and implementation principles.

    103 GitHub stars~282 tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Python Appservice Deploy

    microsoft/GitHub-Copilot-for-Azure

    Official

    Deploy Python (Flask/Django/FastAPI) code to Azure App Service Linux.

    255 GitHub starsUsed in 1 repo~688 tokens
    Backend & APIsAuto-check passed
  • Azure Apim Architecture

    thomast1906/github-copilot-agent-skills

    Analyzes and explains Azure API Management architecture decisions for enterprise API marketplace implementations using VNet Internal mode, Front Door, hybrid authentication, and multi-environment…

    202 GitHub stars~5k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed

More from microsoft/skills

All 150 skills in this repo
  • Official

    Covers producer, consumer, and checkpoint-store setup for Azure Event Hubs streaming in Python, with Entra ID auth and partition targeting.

    3.1k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Official

    Builds podcast-style audio narration from text with Azure OpenAI's GPT Realtime Mini over WebSocket, from a Python FastAPI backend to a React player.

    3.1k GitHub starsUsed in 1 repo~947 tokens
    Auto-check passed
  • Frontend UI Dark TS

    microsoft/skills

    Official

    Build dark-themed React applications using Tailwind CSS with custom theming, glassmorphism effects, and Framer Motion animations.

    3.1k GitHub starsUsed in 5 repos~3.6k tokens
    Auto-check passed
  • Pydantic Models Py

    microsoft/skills

    Official

    Create Pydantic models following the multi-model pattern with Base, Create, Update, Response, and InDB variants.

    3.1k GitHub starsUsed in 5 repos~496 tokens
    Auto-check passed
  • Official

    Reference for building on Microsoft Foundry with the azure-ai-projects Python SDK: project clients, versioned agents, evaluations, connections, datasets and indexes.

    3.1k GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Skill Creator

    microsoft/skills

    Official

    Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services.

    3.1k GitHub starsUsed in 5 repos~17k tokens
    Auto-check passed

Questions about Azure Mgmt Apimanagement Py

What does Azure Mgmt Apimanagement Py do?

Azure API Management SDK for Python. An agent skill from microsoft/skills. Azure Mgmt Apimanagement Py is an agent skill from microsoft/skills, published by the product's own GitHub organization. Azure API Management SDK for Python.

When should I use Azure Mgmt Apimanagement Py?

Azure Mgmt Apimanagement Py fits situations like: managing APIM services; tasks that involve Microservices.

How do I install Azure Mgmt Apimanagement Py in Claude Code?

Run `npx skills add microsoft/skills --skill azure-mgmt-apimanagement-py -a claude-code`. Or copy the skill folder (.github/plugins/azure-sdk-python/skills/azure-mgmt-apimanagement-py in microsoft/skills) into .claude/skills/azure-mgmt-apimanagement-py in your project. Claude Code loads it when a task matches its description.

How do I install Azure Mgmt Apimanagement Py in Codex?

Run `npx skills add microsoft/skills --skill azure-mgmt-apimanagement-py -a codex`. Or copy the skill folder (.github/plugins/azure-sdk-python/skills/azure-mgmt-apimanagement-py in microsoft/skills) into .agents/skills/azure-mgmt-apimanagement-py in your project. Codex loads it when a task matches its description.

Can I use Azure Mgmt Apimanagement Py in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/skills --skill azure-mgmt-apimanagement-py -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/azure-mgmt-apimanagement-py, .gemini/skills/azure-mgmt-apimanagement-py, .github/skills/azure-mgmt-apimanagement-py and .opencode/skills/azure-mgmt-apimanagement-py in your project.

What does Azure Mgmt Apimanagement Py need to run?

Going by SKILL.md and its folder, Azure Mgmt Apimanagement Py needs the command-line tools its instructions call (pip) and credentials named AZURE_TOKEN_CREDENTIALS. Our summary lists: Python 3.

Does Azure Mgmt Apimanagement Py access the network?

SKILL.md names 1 domain. In commands or code: petstore.swagger.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Azure Mgmt Apimanagement Py safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Azure Mgmt Apimanagement Py use?

Azure Mgmt Apimanagement Py is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Azure Mgmt Apimanagement Py use?

About 2.2k tokens (SKILL.md is roughly 8.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Azure Mgmt Apimanagement Py?

Skills that share tags, products or a category with Azure Mgmt Apimanagement Py: API Security Design (vinayaklatthe/microsoft-security-skills, 175 stars), Implementing API Gateway Security Controls (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Azure API Center (MicrosoftDocs/Agent-Skills, 776 stars) and Engineering Principles (Azure/agent-app-orchestrator, 103 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Azure Mgmt Apimanagement Py?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/skills, which has 3,097 GitHub stars. The repository holds 150 skills in this directory. The repository was last updated on October 9, 2026.

Source: microsoft/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.