Azure / Azure/azure-rest-api-specs

[BUG] Inference specification 2025-03-01-preview is not valid in APIM

Open
#33,792 10 comments 9 reactions 0 assignees View on GitHub
bug customer-reported data-plane OpenAI question Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
3d 37m
Merged PRs (30d)
446

Description

### API Spec link

https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference/preview/2025-03-01-preview/inference.json

### API Spec version

2025-03-01-preview

### Describe the bug

We use the API specifications in our AI-Gateway company solution. All the previous versions would work out of the box and we could import them into the published API. This version is suddenly openapi version 3.1.0 and does not work out of the box as there are issue reported by APIM when adding the specification.

### Expected behavior

It should be possible to import this api spec into API in APIM without issues or modifications.

### Actual behavior

We get this issues reported with the file:

`One or more fields contain incorrect values:
Parsing error(s): $recursiveAnchor is not a valid property at #/components/schemas/CompoundFilter [] $recursiveRef is not a valid property at #/components/schemas/CompoundFilter/properties/filters/items/oneOf [] Cannot create a scalar value from this type of node. [#/components/schemas/createResponse/allOf/properties/include/description] propertyNames is not a valid property at #/components/schemas/VectorStoreFileAttributes []
Parsing error(s): The input OpenAPI file is not valid for the OpenAPI specification https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md (schema https://github.com/OAI/OpenAPI-Specification/blob/master/schemas/v3.0/schema.yaml).`

### Reproduction Steps

Try to update api specification of an API in APIM.

### Environment

We run AI Gateway architecture solution with APIM serving as a centralized AI Gateway with Azure AI instances in the backend.

Contributor guide

Open the contributing guide

Research direction

Start with specification/cognitiveservices/data-plane/AzureOpenAI/inference/preview/2025-03-01-preview/inference.json and reproduce the import in APIM. Compare it with earlier inference specifications and inspect the reported OpenAPI 3.1, $recursiveAnchor, $recursiveRef, propertyNames, and description errors. Done means APIM imports the specification without modifications or parsing errors.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, openapi
Domain
api, cloud
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.