Azure / Azure/azure-rest-api-specs

App Service Domain: API not idempotent and missing exmaple on creation

Open
#10,223 3 comments 3 reactions 0 assignees View on GitHub
App Services question Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
6k
Avg merge
2d 22h
Merged PRs (30d)
444

Description

The App Service Domain API is not idempotent in turns that `PUT`/`PATCH` need some fields (e.g. `consent`, `contact`) which are not returned in a later `GET`. Also, I noticed that the contact information filled in Portal doesn't ends up show in the WHOIS database, where it uses some "preset" contact information instead.

Besideds, there is no example on how to create this resource in current spec, which makes it not easy to reason about. For instance, it is confusing what should pass as `consent.agreedBy`.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the App Service Domain API specification, especially the PUT, PATCH, and GET definitions and the resource-creation examples. Compare the handling of consent and contact fields across operations, then document a complete creation example and clarify the expected consent.agreedBy value; verify the requested behavior against the reported WHOIS outcome.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, openapi
Domain
api, cloud, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 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.