Azure / Azure/azure-rest-api-specs

Container Service: deprecate older versions of containerServices endpoints

Open
#11,087 1 comment 0 reactions 0 assignees View on GitHub
Container Service question Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
3d 2h
Merged PRs (30d)
424

Description

`Microsoft.ContainerService/stable/2017-07-01` deprecated the following paths:

```
/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/containerServices
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/containerServices/{containerServiceName}
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/containerServices
```

and they never appear in later versions.

Should they also be deprecated in older versions? (`2016-03-30`, `2016-09-30`, `2017-01-31`, etc.)

Contributor guide

Open the contributing guide

Research direction

Locate the Microsoft.ContainerService REST API specifications for 2016-03-30, 2016-09-30, 2017-01-31, and the later 2017-07-01 version, then compare the three listed containerServices paths. Check how deprecation is represented in the existing specification and confirm that the older versions still expose these paths; done means the affected versions consistently reflect their deprecated status.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
api
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 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.