Skip to content

Latest commit

 

History

History
35 lines (19 loc) · 868 Bytes

put-in-operation-name.md

File metadata and controls

35 lines (19 loc) · 868 Bytes
Raw

PutInOperationName

Category

SDK Warning

Applies to

ARM and Data plane OpenAPI(swagger) specs

Output Message

'PUT' operation '{0}' should use method name 'Create'. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change.

Description

Verifies whether value for operationId is named as per ARM guidelines.

Why the rule is important

Per ARM SDK guidelines, each 'PUT' operation on a resource should have "create" in the name. Guidelines are in place for a more consistent customer experience among ARM services SDKs.

How to fix the violation

Make sure that operationId is in the form of NOUN_Create or Create.

Impact on generated code

Operation name in the generated SDK will be named based on this.

Examples

  • Resources_Create
  • Resources_CreateOrUpdate
  • Create