Azure / Azure/azure-rest-api-specs

[BUG] CDN - Rulesets_Create - undocumented response status code

Open Beginner friendly
#44,244 0 comments 0 reactions 0 assignees View on GitHub
bug customer-reported Mgmt Network - CDN question Service Attention
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.