Add docs on supported resources by extractor (#694)

* add documentation on supported functionality

* add link to supported docs from root readme

* fix review comments

* Update docs/SupportedResources/README.md

Co-authored-by: Milan Zolota <Hardell@users.noreply.github.com>

* Update docs/SupportedResources/README.md

Co-authored-by: Milan Zolota <Hardell@users.noreply.github.com>

* add operation as not supported resource

Co-authored-by: Dmitrii Korolev <dmkorolev@microsoft.com>
Co-authored-by: Milan Zolota <Hardell@users.noreply.github.com>

Author: DeagleGross

README.md

@@ -41,7 +41,7 @@ We realize there are two challenges for API developers when working with Resourc
 
 * First, API developers often work with [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification) and may not be familiar with Resource Manager schemas. Authoring templates manually might be an error-prone task. Therefore, we created a utility tool called [**Creator**](./src/README.md#Creator) to automate the creation of API templates based on an Open API Specification file. Optionally, developers can supply API Management policies for an API in XML format. Basically, the tool inserts the Open API specification and policies into a Resource Manager template in the proper format. With this tool, API developers can continue focusing on the formats and artifacts they are familiar with.
 
-* Second, for customers who have already been using API Management, another challenge is how to extract existing configurations into Resource Manager templates. For those customers, We have created another tool called [**Extractor**](./src/README.md#extractor) to help them generate templates by extracting configurations from their exisitng API Management instances.  
+* Second, for customers who have already been using API Management, another challenge is how to extract existing configurations into Resource Manager templates. For those customers, We have created another tool called [**Extractor**](./src/README.md#extractor) to help them generate templates by extracting configurations from their exisitng API Management instances. You can view [Supported Resources](./docs/SupportedResources/README.md) to view the supported functionality for each public APIM API version.
 
 Once API developers have finished developing and testing an API, and have generated the API template, they can submit a pull request to merge the changes to the publisher repository. API publishers can validate the pull request and make sure the changes are safe and compliant. For example, they can check if only HTTPS is allowed to communicate with the API. Most of these validations can be automated as a step in the CI/CD pipeline. Once the changes are approved and merged successfully, API publishers can choose to deploy them to the Production instance either on schedule or on demand. The deployment of the templates can be automated using [Github Actions](https://github.com/Azure/apimanagement-devops-samples), [Azure Pipeline](https://docs.microsoft.com/en-us/azure/devops/pipelines/?view=azure-devops), [PowerShell](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-template-deploy), [Azure CLI](Azure-cli-example.md) or other tools. An example using Azure DevOps can be find [here](docs/AzDO-Example.md)
 

docs/SupportedResources/2021-08-01.md

@@ -0,0 +1,82 @@
+# Supported  2021-08-01
+Below there is a table with all [operation-groups exposed by API Management](https://docs.microsoft.com/en-us/rest/api/apimanagement/). Every operation group is marked as *supported* ✓, *not supported* ✗ or *skipped* **-**. Also, there is information in which first resource-kit version resource extraction was supported.
+
+Some of operations could be skipped (not needed for extraction), because they are not providing any **resource-specific** information about the Azure APIM Instance.
+
+| Operation | Supported | Resource-kit version | Developer comment |
+|---|---|---|---|
+| Api | - |  | |
+| Api Diagnostic | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Api Export | - | | |
+| Api Issue | ✗ | | |
+| API Issue Attachment | ✗ | | |
+| API Issue Comment | ✗ | | |
+| API Management Operations | - | | |
+| API Management Service | ✗ | | we can load service description |
+| API Management Service Skus | - | | |
+| Api Operation | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Api Operation Policy | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Api Policy | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Api Product | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Api Release | ✗ | | |
+| Api Revision | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | Probably needs refactoring (Move out of `ApiExtractor`) |
+| Api Schema | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Api Tags | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Api Version Set | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | probably needs refactoring (Move out of `ApiExtractor`) |
+| APIs | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Authorization Server | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Backend | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Cache | ✗ | | |
+| Certificate | ✗ | | |
+| Content Item | ✗ | | |
+| Content Type | ✗ | | |
+| Delegation Settings | ✗ | | |
+| Deleted Services | - | | |
+| Diagnostic | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | Move out of `ApiExtractor` |
+| Email Template | ✗ | | |
+| Gateway | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Gateway Api | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Gateway Certificate Authority | ✗ | | |
+| Gateway Hostname Configuration | ✗ | | |
+| Group | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Group User | ✗ | | |
+| Identity Provider | ✗ | | |
+| Issue | ✗ | | |
+| Logger | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Network Status | ✗ | | |
+| Notification | ✗ | | |
+| Notification Recipient Email | ✗ | | |
+| Notification Recipient User | ✗ | | |
+| Notification Recipient User | ✗ | | |
+| OpenId Connect Provider | ✗ | | |
+| Operation | ✗ | | |
+| Policy | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Policy Description | - | | |
+| Portal Revision | ✗ | | |
+| Portal Settings | ✗ | | |
+| Private Endpoint Connection | ✗ | | |
+| Product | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Product Api | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Product Group | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Product Policy | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Product Subscriptions | ✗ | | |
+| Product Tag | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Quota By Counter Keys | - | | |
+| Quota By Period Keys | - | | |
+| Region | - | | |
+| Reports | - | | |
+| Sign-In Settings | ✗ | | |
+| Sign-Up Settings | ✗ | | |
+| Subscription | ✗ | | |
+| Tag | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Tag Entity | - | | |
+| Tag Product | ✓ | [1.0.0-beta.2](https://github.com/Azure/azure-api-management-devops-resource-kit/releases/tag/1.0.0-beta.2) | |
+| Tag Resource | - | | |
+| Tenant Access | - | | |
+| Tenant Access Git | - | | |
+| Tenant Configuration | - | | |
+| User | ✗ | | |
+| User Confirmation Password | - | | |
+| User Group | - | | |
+| User Identities | - | | |
+| User Subscription | - | | |

docs/SupportedResources/README.md

@@ -0,0 +1,15 @@
+# Supported Resources by Resource Kit
+
+## What is the resource
+---
+Azure-ApiManagement-Devops-Resources-Kit heavily uses Azure API Management public API and relies on it to get all the information about running services.
+
+Azure API Management team develops services and products continuously, and public API happens to change from time to time. You can always view the **Current-GA**, **current-Preview** and **Previous-GA** public API references on [Azure REST API page](https://docs.microsoft.com/en-us/rest/api/apimanagement/)
+
+This **Resource-Kit** works with `Resource` entities. Let's define, what `Resource` in this case means:  
+`Resource` - entity, that is exposed by ApiManagement, representing some information regarding specific ApiManagement instance. If one contains some set of `resources` describing ApiManagement instance, he\she can recreate another instance one by one (with absolutely the same resources)
+
+## Supported Resources 
+Please, refer to this document to understand what resources are supported in each of the Api-Versions published by the ApiManagement team:
+
+- [api-version = 2021-08-01](./2021-08-01.md)