Azure / Azure/azure-rest-api-specs

`Microsoft.CognitiveServices/accounts` - `kind` values should be modeled as an enum

Open
#16,504 3 comments 0 reactions 0 assignees View on GitHub
Cognitive - Mgmt Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
2d 22h
Merged PRs (30d)
444

Description

The `kind` property defined for an "accounts" resource is modeled as a string with no information on valid values. It would be useful to model as an enum so that the accepted values can be enumerated:

https://github.com/Azure/azure-rest-api-specs/blob/88e7838a09868a51de3894114355c75929847a46/specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2021-04-30/cognitiveservices.json#L1091-L1094

Initially reported under https://github.com/Azure/bicep/issues/4942

Contributor guide

Open the contributing guide

Research direction

Start with specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2021-04-30/cognitiveservices.json at lines 1091-1094, then inspect nearby resource definitions for enum modeling conventions. Confirm the accepted kind values from the specification context and update the model so those values are enumerated; done means the accounts resource no longer exposes kind as an unconstrained string.

Written by the indexing model from the issue text.

Assessment

Tech stack
json, openapi
Domain
api, cloud
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.