azure-rest-api-specs
apiops
azure-rest-api-specs | apiops | |
---|---|---|
7 | 3 | |
2,466 | 256 | |
1.7% | 2.3% | |
10.0 | 8.7 | |
3 days ago | 2 days ago | |
TypeScript | C# | |
MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
azure-rest-api-specs
-
Shared APIM Service
Agree here. When I was on the API Management team, I generally saw customers set up a repository of API specifications (incidentally, this is also how we do it internally at Microsoft - check it out at https://github.com/azure/azure-rest-api-specs) - those specifications generally drive the API Management side of things, but with review from a centralized API management team. The “spec” should consist of both the specification (Swagger, SOAP, GraphQL SDL, etc.) and the policy or policies appropriate for the API.
- Are subscriptions idempotent when deployed via Bicep? I seem to have some issue with them after having success the first time.
-
StackQL provider for Azure is now available
The StackQL Azure provider was created using the Autorest project using Azure specification docs from the azure-rest-api-specs repository. We will be adding integrated interactive authentication; for now, this is cli/sdk based; you can find all the documentation here.
-
LocalStack 1.0 General Availability
In the spirit of moto, it actually looks like quite a bit of the groundwork is available for someone to take a swing at an Azure version:
* the cli uses the python SDK: https://github.com/Azure/azure-cli/blob/azure-cli-2.38.0/src...
* which uses autorest: https://github.com/Azure/azure-sdk-for-python/tree/azure-mgm...
* of what appears to be an OpenAPI-ish spec: https://github.com/Azure/azure-rest-api-specs/tree/fda2db441...
-
Implementing Microsoft REST API Guidelines Filter
I'm not sure what you mean by "it is very hard to give contextuality on it"; OAS does supports referring to a type by reference, so that higher level types can reuse the definition of structs they might contain.
But even so, here the problem is that the APIs aren't actual PUT/GETs: they payload types aren't the same going up as they are coming down. It is really two separate types, one for PUT, one for GET.
Some of that is to be expected (there will be some information after the create that is only added by the VM coming into being) but how Kubernetes handles this with a separate "status" for the item I think ends up letting the rest of the type (spec, in k8s's case) be the same type. (… ish. K8s has variants of this problem, too.)
To expand a bit, I'm largely relegated to the API docs themselves. Browsing the actual schema is hard:
Start at: https://github.com/Azure/azure-rest-api-specs
-
Azure Bicep - How do I know what property values are valid?
I feel your pain, a good resource for me has been the REST API specs - https://github.com/Azure/azure-rest-api-specs/tree/master/specification
-
apiVersion deprecation
You might get some clues here. Maybe. https://github.com/Azure/azure-rest-api-specs
apiops
-
Shared APIM Service
The Azure APIOps Toolkit (here: https://github.com/Azure/APIOps) provides a toolkit on top of git to version control your APIs and ensure that updates to the API Management service can be change controlled, approved, and minimally invasive to other running APIs. It takes a little bit to set it up, but I highly recommend it.
-
How to manage APIM as Infrastructure as Code (IaC)?
I want to bring it all into a central repo really, like this but using Terraform: https://azure.github.io/apiops/
- Exporting APIM API configurations to Terraform automatically?
What are some alternatives?
prism - Turn any OpenAPI2/3 and Postman Collection file into an API server with mocking, transformations and validations.
git-credential-manager - Secure, cross-platform Git credential storage with authentication to GitHub, Azure Repos, and other popular Git hosting services.
mockoon - Mockoon is the easiest and quickest way to run mock APIs locally. No remote deployment, no account required, open source.
DevOpsMetrics - A project to extract and process high performing DevOps metrics (DORA) from GitHub and Azure DevOps
autorest - OpenAPI (f.k.a Swagger) Specification code generator. Supports C#, PowerShell, Go, Java, Node.js, TypeScript, Python
azure-cli - Azure Command-Line Interface
stackql-provider-registry - Registry for cloud and SaaS providers for StackQL, generated from extensions to the providers OpenAPI3 specification
azure-sdk-for-python - This repository is for active development of the Azure SDK for Python. For consumers of the SDK we recommend visiting our public developer docs at https://docs.microsoft.com/python/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-python.
SOFA - The best way to create REST APIs - Generate RESTful APIs from your GraphQL Server