Release - API Management service: August, 2024 (#56)

* Release: 2024-08

Author: mikebudzynski

changelogs/api-management-service.md

@@ -1,5 +1,54 @@
 # Azure API Management service changelog
 
+## Release - API Management service: August, 2024
+
+### Announcements
+
+- Workspaces are now generally available. [Learn how to empower API teams and federate the management of APIs with workspaces](https://aka.ms/apim/workspaces/ga-announcement).
+- [GenAI gateway capabilities are now expanded to support a wider range of large language models through Azure AI Model Inference API](https://aka.ms/apim/genai/llm-policies).
+- [Developer portal audit logging is now generally available](http://aka.ms/AzureAPIMDeveloperPortalLogs).
+- [WordPress plugin to build customized developer portals is now in preview](https://aka.ms/apim-wordpressblog).
+- You can watch [the recording of our July live stream on YouTube](https://aka.ms/apim/standups/2024-07). We'll be hosting another live stream in September—stay tuned to [our blog](https://aka.ms/apim/blogs) for the upcoming announcement.
+
+### Changes
+
+* If an API does not require subscription authentication, any API request that includes a subscription key will now be treated the same as a request without a subscription key. Previously, if a request included a subscription key associated with a different API or product, API Management would return a `401 Unauthorized` response. This change improves the security of your APIs by preventing the accidental exposure of subscription keys linked to other products.
+* As part of the general availability of workspaces, we are discontinuing support for preview workspaces in API Management. You can learn more about these changes [in the last section of the workspaces general availability announcement](https://aka.ms/apim/workspaces/ga-announcement) and [in this documentation article](https://aka.ms/apimdocs/workspaces/changes-ga).
+
+### New features
+
+* We added support for serializing a single child XML element into a JSON array using [the `XML-to-JSON` policy](https://learn.microsoft.com/azure/api-management/xml-to-json-policy).
+* We added support for case-insensitive property names comparison with the optional `case-insensitive-property-names` attribute in [the `validate-content` policy](https://learn.microsoft.com/azure/api-management/validate-content-policy). The default value is `false`.
+* We added support for the `2024-02-01` and `2024-06-01` [Azure OpenAI API versions]( https://learn.microsoft.com/azure/ai-services/openai/reference#data-plane-inference) in the [`azure-openai-token-limit`](https://learn.microsoft.com/azure/api-management/azure-openai-token-limit-policy) and [`azure-openai-emit-token-metric`](https://learn.microsoft.com/azure/api-management/azure-openai-emit-token-metric-policy) policies.
+* We added support for integer and integer arrays as output of [Azure OpenAI embeddings calls](https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference/stable/2024-06-01/inference.yaml) in the [`azure-openai-token-limit`](https://learn.microsoft.com/azure/api-management/azure-openai-token-limit-policy) and [`azure-openai-emit-token-metric`](https://learn.microsoft.com/azure/api-management/azure-openai-emit-token-metric-policy) policies.
+* We added support for managed identity authentication for newly created backends.
+* We added support for ES256 token signing algorithm in [the `validate-jwt` policy](https://learn.microsoft.com/azure/api-management/validate-jwt-policy).
+
+### Fixes and improvements
+
+* We fixed an issue with [the `retry` policy](https://learn.microsoft.com/azure/api-management/retry-policy) not working correctly with [load balancer backends](https://learn.microsoft.com/azure/api-management/backends?tabs=bicep#load-balanced-pool).
+* We fixed a bug with [the backend reconnect action](https://learn.microsoft.com/rest/api/apimanagement/backend/reconnect?view=rest-apimanagement-2022-08-01&tabs=HTTP) not working properly.
+* We fixed a bug with decrypted token not being returned in a context variable in the [`validate-azure-ad-token` policy](https://learn.microsoft.com/azure/api-management/validate-azure-ad-token-policy).
+* We made the `certificate-id` attribute of the `decryption-keys` element in [the `validate-azure-ad-token` policy](https://learn.microsoft.com/azure/api-management/validate-azure-ad-token-policy) optional.
+* We fixed a bug that caused Key Vault certificate refresh failures if a certificate was referenced within a policy fragment.
+* We optimized the performance of deleting users. Previously, the operation could time out if there were thousands or more users in the API Management service.
+* We fixed a bug that caused an incorrect date-time format to be returned when testing GraphQL resolvers.
+* We removed internal runtime exception details from GraphQL resolver error messages.
+* The developer portal `delegationUrl` setting now defaults to `null`. Previously, it defaulted to an empty string, causing payload validation errors on `PUT` calls to the management API.
+
+### Self-hosted developer portal releases
+
+- [2.29.0](https://github.com/Azure/api-management-developer-portal/releases/tag/2.29.0)
+
+### Self-hosted gateway container image releases
+
+- [2.7.1](https://github.com/Azure/api-management-self-hosted-gateway/releases/tag/Container-v2.7.1)
+- [2.7.0](https://github.com/Azure/api-management-self-hosted-gateway/releases/tag/Container-v2.7.0)
+
+### Self-hosted gateway Helm chart releases
+
+- [1.11.0](https://github.com/Azure/api-management-self-hosted-gateway/releases/tag/v1.11.0)
+
 ## Release - API Management service: June, 2024
 
 ### New features, improvements, and changes
@@ -20,10 +69,6 @@
 - URL properties in the [Backend](https://learn.microsoft.com/rest/api/apimanagement/backend/create-or-update) entity no longer accept URLs containing query parameters. We've made the change to fix a bug. Please use [`set-query-parameter`](https://learn.microsoft.com/azure/api-management/set-query-parameter-policy) policy and [`backend.credentials.query`](https://learn.microsoft.com/rest/api/apimanagement/backend/create-or-update#backendcredentialscontract) to set query parameters
 - We fixed an issue preventing [backend load balancing feature](https://learn.microsoft.com/azure/api-management/backends?tabs=bicep#load-balanced-pool) from working properly with [`retry`](https://learn.microsoft.com/azure/api-management/retry-policy) policy
 
-### Self-hosted developer portal releases
-
-- [2.28.0](https://github.com/Azure/api-management-developer-portal/releases/tag/2.28.0)
-
 ### Self-hosted gateway container image releases
 
 - [2.6.0](https://github.com/Azure/api-management-self-hosted-gateway/releases/tag/Container-v2.6.0)