Azure / Azure/azure-rest-api-specs
[BUG] CDN - Rulesets_Create - undocumented response status code
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 3d 2h
- Merged PRs (30d)
- 424
Description
### API Spec link
https://github.com/Azure/azure-rest-api-specs/blob/e7a85a5632ecc4ebda065311e4da8e12e3848ba7/specification/cdn/resource-manager/Microsoft.Cdn/Cdn/stable/2025-12-01/openapi.json#L6873-L6961
### API Spec version
2025-12-01
### Describe the bug
The `Rulesets_Create` PUT operation may respond with a `202` (Accepted) on updates. Since this is not documented in the API spec, this causes errors downstream in our SDK that is generated based on this spec.
### Expected behavior
API spec is accurate and documents all possible status codes
### Actual behavior
Missing possible status code
### Reproduction Steps
Create:
```
PUT https://management.azure.com/subscriptions/{subscriptionID}/resourceGroups/{rg}/providers/Microsoft.Cdn/profiles/{profile}/ruleSets/{ruleSet}?api-version=2025-12-01
{
"properties": {
"batchMode": true,
"rules": [{
"actions": [{
"name": "RouteConfigurationOverride",
"parameters": {
"cacheConfiguration": {
"cacheBehavior": "OverrideIfOriginMissing",
"cacheDuration": "365.23:59:59",
"isCompressionEnabled": "Enabled",
"queryParameters": "foo,clientIp={client_ip}",
"queryStringCachingBehavior": "IncludeSpecifiedQueryStrings"
},
"originGroupOverride": {
"forwardingProtocol": "HttpsOnly",
"originGroup": {
"id": "/subscriptions/{subscriptionID}/resourceGroups/{rg}/providers/Microsoft.Cdn/profiles/{profile}/originGroups/{group}"
}
},
"typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
}
}],
"conditions": [],
"matchProcessingBehavior": "Continue",
"order": 0,
"ruleName": "rule"
}]
}
}
```
Responds with 201 Created. Wait for provisioningState to progress to succeeded, then update:
```
PUT https://management.azure.com/subscriptions/{subscriptionID}/resourceGroups/{rg}/providers/Microsoft.Cdn/profiles/{profile}/ruleSets/{ruleSet}?api-version=2025-12-01
{
"properties": {
"batchMode": true,
"rules": [{
"actions": [{
"name": "RouteConfigurationOverride",
"parameters": {
"originGroupOverride": {
"forwardingProtocol": "HttpsOnly",
"originGroup": {
"id": "/subscriptions/{subscriptionID}/resourceGroups/{rg}/providers/Microsoft.Cdn/profiles/{profile}/originGroups/{group}"
}
},
"typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
}
}],
"conditions": [],
"matchProcessingBehavior": "Continue",
"order": 0,
"ruleName": "rule"
}]
}
}
```
Observe 202 response. (Which then errors out in our SDK because this is an unexpected status code)
### Environment
Terraform
Contributor guide
Research direction
Open the linked specification/cdn resource-manager/Microsoft.Cdn/Cdn/stable/2025-12-01/openapi.json around lines 6873-6961 and inspect the Rulesets_Create PUT responses. Document the observed 202 Accepted response while preserving the existing 201 Created response, then confirm the operation lists all reported status codes.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure, openapi
- Domain
- api
- Issue type
- Bug
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 86/100