Azure / Azure/azure-rest-api-specs

Microsoft.ServicesBus Topic & Queue missing x-ms-mutability

Open
#16,679 2 comments 0 reactions 0 assignees View on GitHub
customer-reported question Service Attention Service Bus
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
3d 37m
Merged PRs (30d)
446

Description

Within the definitions of `SBTopicProperties` and `SBQueueProperties`, the properties `requiresDuplicateDetection`, `requiresSession` and `enablePartitioning` should have the following attribute added as they can't be updated once created.

```json
"x-ms-mutability": [
"create",
"read"
]
```

## Documentation References

> You can't enable or disable message sessions after the queue or subscription is created. You can only do so at the time of creating the queue or subscription.

https://docs.microsoft.com/en-us/azure/service-bus-messaging/enable-message-sessions

> You can't enable or disable duplicate detection after the queue or topic is created. You can only do so at the time of creating the queue or topic.

https://docs.microsoft.com/en-us/azure/service-bus-messaging/enable-duplicate-detection

> It's not possible to change the partitioning option on any existing queue or topic. You can only set the option when you create a queue or a topic.

https://docs.microsoft.com/en-us/azure/service-bus-messaging/enable-partitions

Contributor guide

Open the contributing guide

Research direction

Search the Service Bus API specifications for the SBTopicProperties and SBQueueProperties definitions, then inspect requiresDuplicateDetection, requiresSession, and enablePartitioning. Confirm the documented immutability behavior in the linked references, add the specified create/read mutability metadata, and verify the generated specification reflects it.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
api
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.