vscode-apimanagement/README.md

140 строки
7.1 KiB
Markdown
Исходник Постоянная ссылка Обычный вид История

[![Version](https://vsmarketplacebadge.apphb.com/version/ms-azuretools.vscode-apimanagement.svg)](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-apimanagement) [![Installs](https://vsmarketplacebadge.apphb.com/installs-short/ms-azuretools.vscode-apimanagement.svg)](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-apimanagement)
2020-03-31 20:26:13 +03:00
[![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) [![GitHub](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/Microsoft/vscode-apimanagement/blob/master/LICENSE.md)
2019-06-07 00:00:08 +03:00
2021-03-12 20:54:04 +03:00
# Azure API Management Extension for Visual Studio Code
2019-05-29 23:57:50 +03:00
2019-06-25 03:25:19 +03:00
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.
2019-06-19 01:58:12 +03:00
2019-06-25 03:06:13 +03:00
[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.
2019-06-19 01:58:12 +03:00
## 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!
2019-06-19 01:58:12 +03:00
## Main Features
2019-06-25 03:06:13 +03:00
- Create and delete an API Management instance
2019-06-28 00:46:36 +03:00
- Create an API by importing an OpenAPI specification
2019-06-25 03:06:13 +03:00
- Edit APIs and operations in Azure Resource Manager or OpenAPI formats
- Edit policies at any scope
- Associate an API with a product
2019-06-28 00:46:36 +03:00
- Create, delete, and edit Named Values
2019-06-25 03:06:13 +03:00
- Test an API using [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client)
- Command Palette support for most features
2020-01-09 22:51:56 +03:00
- Extract API and service configurations into ARM templates
2020-04-10 02:01:13 +03:00
- Import Azure Functions - Transform HttpTriggers into APIs
- Import App Service WebApp
2020-04-08 22:26:59 +03:00
- Manage Self-Hosted Gateways
- Policy Debugging
- Scaffold Azure Functions
2020-10-30 23:10:54 +03:00
- Show diffs against last saved version
- Switch / Release API Revisions
2020-12-10 05:16:05 +03:00
- API Filter
2019-06-19 01:58:12 +03:00
## Create an API Management instance using defaults
2019-06-25 03:06:13 +03:00
2019-06-19 01:58:12 +03:00
![Create-simple](resources/create-default.gif)
2019-06-25 03:06:13 +03:00
## Create an API Management instance using custom options
2019-06-19 01:58:12 +03:00
![Create-advanced](resources/create-advanced.gif)
## Create an API by importing an OpenAPI specification
2019-06-25 03:06:13 +03:00
Please note: only JSON format is supported currently.
2019-06-19 01:58:12 +03:00
![Import-OAS](resources/import-oas.gif)
## Edit an API in Azure Resource Manager format
2019-06-25 03:06:13 +03:00
2019-06-19 01:58:12 +03:00
![Edit-JSON](resources/edit-json.gif)
2019-06-25 03:06:13 +03:00
## Edit an API in OpenAPI format
2019-06-19 01:58:12 +03:00
![Edit-OAS](resources/edit-oas.gif)
## Edit policies
2019-06-25 03:06:13 +03:00
2019-06-19 01:58:12 +03:00
![Edit-Policy](resources/policy.gif)
## Test an API
2019-06-25 03:06:13 +03:00
2019-06-19 01:58:12 +03:00
![Test-API](resources/test-api.gif)
2019-05-29 23:57:50 +03:00
2019-06-28 00:46:36 +03:00
## Create and edit a Named Value
![Named-Values](resources/namedvalues.gif)
2020-01-09 22:51:56 +03:00
## Extract Service or API
![Extract](resources/extract.gif)
2020-04-10 02:01:13 +03:00
## Import Function App
2020-03-28 04:20:29 +03:00
![importFuncApp](resources/importFunc.gif)
2020-04-10 02:01:13 +03:00
## Import App Service Web App
2020-03-28 04:20:29 +03:00
![importWebApp](resources/importWebapp.gif)
2020-04-08 22:26:59 +03:00
## Deploy Gateway with Docker or Kubernetes
![deployGateway](resources/deployGw.gif)
2020-03-28 04:20:29 +03:00
## Debug Policy
![debugPolicy](resources/debug.gif)
## Scaffold Azure Functions
![generateFunctions](resources/stencil.gif)
2020-10-30 23:10:54 +03:00
## Show diffs against last saved version
![diffing](resources/diffing.gif)
## Switch API Revision
![SwitchRevision](resources/SwitchRevision.gif)
## Release API Revision
2020-12-10 04:58:30 +03:00
![ReleaseRevision](resources/ReleaseRevision.gif)
2020-12-10 05:16:05 +03:00
## API Filter
![apiFilter](resources/apiFilter.gif)
## Intellisense for Policy Expressions.
2020-01-09 23:06:47 +03:00
Follow instructions [here](https://github.com/microsoft/vscode-apimanagement/issues/37#issuecomment-516551741).
## 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](https://github.com/Microsoft/vscode-azure-account) extension.
2019-06-05 08:40:17 +03:00
## Contributing
2019-06-19 01:58:12 +03:00
There are several ways you can contribute to this repo:
2019-06-05 08:40:17 +03:00
2019-06-25 03:06:13 +03:00
- **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.
2019-06-05 08:40:17 +03:00
### 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 [opencode@microsoft.com](mailto:opencode@microsoft.com) 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 dont 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
2019-06-07 00:00:08 +03:00
[MIT](LICENSE.md)