An open API service indexing awesome lists of open source software.

https://github.com/microsoft/vscode-apimanagement

VS Code extension for Azure API Management.
https://github.com/microsoft/vscode-apimanagement

apim azure azure-api-management microsoft serverless vscode-extension

Last synced: about 1 month ago
JSON representation

VS Code extension for Azure API Management.

Awesome Lists containing this project

README

        

[![Build Status](https://dev.azure.com/ms-azuretools/AzCode/_apis/build/status/vscode-apimanagement?branchName=master)](https://dev.azure.com/ms-azuretools/AzCode/_build/latest?definitionId=20&branchName=master)

# 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](https://aka.ms/apimrocks) 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](https://aka.ms/apimlove) 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](https://azure.microsoft.com/en-us/free/) 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](https://marketplace.visualstudio.com/items?itemName=humao.rest-client)
- Command Palette support for most features
- Import Azure Functions - Transform HttpTriggers into APIs
- Import App Service WebApp
- Manage Self-Hosted Gateways
- Policy Debugging
- 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](resources/create-default.gif)

## Create an API Management instance using custom options

![Create-advanced](resources/create-advanced.gif)

## Create an API by importing an OpenAPI specification

Please note: only JSON format is supported currently.
![Import-OAS](resources/import-oas.gif)

## Edit an API in Azure Resource Manager format

![Edit-JSON](resources/edit-json.gif)

## Edit an API in OpenAPI format

![Edit-OAS](resources/edit-oas.gif)

## Edit policies

![Edit-Policy](resources/policy.gif)

## Test an API

![Test-API](resources/test-api.gif)

## Create and edit a Named Value

![Named-Values](resources/namedvalues.gif)

## Import Function App
![importFuncApp](resources/importFunc.gif)

## Import App Service Web App
![importWebApp](resources/importWebapp.gif)

## Deploy Gateway with Docker or Kubernetes
![deployGateway](resources/deployGw.gif)

## Debug Policy
![debugPolicy](resources/debug.gif)

## Show diffs against last saved version
![diffing](resources/diffing.gif)

## Switch API Revision
![SwitchRevision](resources/SwitchRevision.gif)

## Release API Revision
![ReleaseRevision](resources/ReleaseRevision.gif)

## API Filter
![apiFilter](resources/apiFilter.gif)

## Self-Hosted Gateway Debugging
![selfHostedDebugging](resources/selfdebug.gif)

## Manage User Subscriptions
![manageUserSubscription](resources/subscription.gif)

## Intellisense for Policy Expressions.

Follow instructions [here](https://github.com/microsoft/vscode-apimanagement/issues/37#issuecomment-516551741).

## Managing Azure Subscriptions

If you are not signed in to Azure, a 'Sign in to Azure...' link will appear.

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 select "Create an Azure for Students Account...".

To sign out of Azure in VSCode, go to the account page, select your Azure account, and click 'Sign Out'.

To switch tenants in VSCode, go to "View" -> "Command Palette" and search for "Azure API Management: Select Tenant...".

To choose which subscriptions appear in the extension's explorer, click the "Select Subscriptions..." button on any subscription node (indicated by a filter icon when you hover over it), or go to "View" -> "Command Palette" and search for "Azure API Management: Select Subscriptions".

## 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](https://github.com/Microsoft/vscode-apimanagement/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](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-typescript-tslint-plugin).
- 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](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[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](https://go.microsoft.com/fwlink/?LinkID=528096&clcid=0x409) 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](https://code.visualstudio.com/docs/supporting/faq#_how-to-disable-telemetry-reporting).

## License

[MIT](LICENSE.md)