You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: azure/Guidelines.md
+7Lines changed: 7 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -551,9 +551,16 @@ The [Azure Naming Guidelines](./ConsiderationsForServiceDesign.md#common-names)
551
551
<aname="json-polymorphism-kind-extensible"></a>
552
552
:ballot_box_with_check:**YOU SHOULD** define the discriminator field of a polymorphic type to be an extensible enum.
553
553
554
+
**WE SHOULD CHOOSE ONE OF THE FOLLOWING TWO OPTIONS**
555
+
554
556
<aname="json-polymorphism-kind-immutable"></a>
555
557
:warning:**YOU SHOULD NOT** allow an update (patch) to change the discriminator field of a polymorphic type.
556
558
559
+
**OR**
560
+
561
+
<aname="json-polymorphism-mutable-kind"></a>
562
+
:ballot_box_with_check:**YOU SHOULD** remove all properties specific to the old discriminator value from the resource when an update (patch) changes the discriminator field.
563
+
557
564
<aname="json-polymorphism-versioning"></a>
558
565
:warning:**YOU SHOULD NOT** return properties of a polymorphic type that are not defined for the api-version specified in the request.
0 commit comments