Skip to content

microsoft/vscode-apimanagement

Repository files navigation

Build Status

Azure API Management Extension for Visual Studio Code

Use the Azure API Management extension to perform common management operations on your Azure API Management service instances without switching away from Visual Studio Code.

Azure API Management is a fully managed service that helps customers to securely expose their APIs to external and internal consumers. API Management serves as a facade and a front door for the API implementations and enables their frictionless consumption by developers. Visit this page for more information and resources related to Azure API Management.

Requirements

All you need is an Azure Subscription to get started. If you don't have one, click here for a free subscription with $200 in Azure credits!

Main Features

  • Create and delete an API Management instance
  • Create an API by importing an OpenAPI specification
  • Edit APIs and operations in Azure Resource Manager or OpenAPI formats
  • Edit policies at any scope
  • Associate an API with a product
  • Create, delete, and edit Named Values
  • Test an API using REST Client
  • Command Palette support for most features
  • Extract API and service configurations into ARM templates
  • Import Azure Functions - Transform HttpTriggers into APIs
  • Import App Service WebApp
  • Manage Self-Hosted Gateways
  • Policy Debugging
  • Scaffold Azure Functions
  • Show diffs against last saved version
  • Switch / Release API Revisions
  • API Filter
  • Policy Debugging on Self-Hosted Gateways
  • Manage User Subscriptions
  • Manage Authorization Providers, Authorizations and Access Policies

Create an API Management instance using defaults

Create-simple

Create an API Management instance using custom options

Create-advanced

Create an API by importing an OpenAPI specification

Please note: only JSON format is supported currently. Import-OAS

Edit an API in Azure Resource Manager format

Edit-JSON

Edit an API in OpenAPI format

Edit-OAS

Edit policies

Edit-Policy

Test an API

Test-API

Create and edit a Named Value

Named-Values

Extract Service or API

Extract

Import Function App

importFuncApp

Import App Service Web App

importWebApp

Deploy Gateway with Docker or Kubernetes

deployGateway

Debug Policy

debugPolicy

Scaffold Azure Functions

generateFunctions

Show diffs against last saved version

diffing

Switch API Revision

SwitchRevision

Release API Revision

ReleaseRevision

API Filter

apiFilter

Self-Hosted Gateway Debugging

selfHostedDebugging

Manage User Subscriptions

manageUserSubscription

Intellisense for Policy Expressions.

Follow instructions here.

Managing Azure Subscriptions

If you are not signed in to Azure, you will see a "Sign in to Azure..." link. Alternatively, you can select "View->Command Palette" in the VS Code menu, and search for "Azure: Sign In".

If you don't have an Azure Account, you can sign up for one today for free and receive $200 in credits by selecting "Create a Free Azure Account..." or selecting "View->Command Palette" and searching for "Azure: Create an Account".

You may sign out of Azure by selecting "View->Command Palette" and searching for "Azure: Sign Out".

To select which subscriptions show up in the extension's explorer, click on the "Select Subscriptions..." button on any subscription node (indicated by a "filter" icon when you hover over it), or select "View->Command Palette" and search for "Azure: Select Subscriptions". Note that this selection affects all VS Code extensions that support the Azure Account and Sign-In extension.

Contributing

There are several ways you can contribute to this repo:

  • Ideas, feature requests and bugs: We are open to all ideas and we want to get rid of bugs! Use the Issues section to either report a new issue, share your ideas, or contribute to ongoing discussions.
  • Documentation: Found a typo or an awkwardly worded sentence? Submit a PR!
  • Code: Contribute bug fixes, features, or design changes:
    • Clone the repository locally and open in Visual Studio Code.
    • Install TSLint for Visual Studio Code.
    • Open the terminal (press CTRL+`) and run npm install.
    • To build, press F1 and type in Tasks: Run Build Task.
    • Debug: press F5 to start debugging the extension.

Legal

Before we can accept your pull request you will need to sign a Contribution License Agreement. All you need to do is to submit a pull request, then the PR will get appropriately labelled (e.g. cla-required, cla-norequired, cla-signed, cla-already-signed). If you already signed the agreement we will continue with reviewing the PR, otherwise system will tell you how you can sign the CLA. Once you sign the CLA all future PR's will be labeled as cla-signed.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Telemetry

VS Code collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more. If you don’t wish to send usage data to Microsoft, you can set the telemetry.enableTelemetry setting to false. Learn more in our FAQ.

License

MIT