---
title: ARM Rules, TypeSpec Linting, and Suppression
---

ARM includes many rules on the structure of resources and the details of resource operations that ensure a consistent user experience when managing services inside Azure. TypeSpec encodes many fo these rules into linting checks that occur on each compilation. If you use an IDE and install the [TypeSpec IDE Tools](../../getstarted/azure-resource-manager/step00.md#installing-ide-tools), violations of rules will show up as yellow highlights in your tsp code. If you hover over these, you will get a message indicating the issue and how to fix it in your specification. If you use the typespec command-line, violations of rules will be printed as warnings, with a description and steps to correct the issue, and a pointer to the location in the specification where the violation occurred.

In the sections below, we will discuss these rules, how they work, and, in cases where a violation is a false positive, or has a reason approved by an ARM reviewer, can be suppressed.

## ARM RPC Rules

TypeSpec has a set of linting rules that execute whenever the specification is compiled, and in the IDE as you type. Violations are highlighted inline in the spec, or emitted during compilation.

For more information, see [ARM RPC rules](https://eng.ms/docs/products/arm/api_contracts/guidelines/rpc)

## Detecting and Suppressing Rule Violations at Design Time

Violations of ARM RPC rules will show up at design time as a yellow highlight over the violating type in TypeSpec, and at compile time as an emitted warning with a specific reference in the specification code (line number, position, pointer).

Here is an example of a linter warning:

```bash
Diagnostics were reported during compilation:

C:/typespec-samples/resource-manager/zerotrust/main.tsp:38:3 - warning @azure-tools/typespec-azure-resource-manager/use-operation-decorator: Resource POST operation must be decorated with @armResourceAction.
> 38 |   /** Gets the Zero Trust URL for this resource */
     |   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> 39 |   @post
     | ^^^^^^^
> 40 |   getZeroTrustUrl(...ResourceInstanceParameters<ZeroTrustResource>): ZeroTrustUrl | ErrorResponse;
     | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Found 1 warning.

```

To suppress the warning, you would use the `#suppress` directive on the type that violates the rule. The directive takes the fully-qualified name of the rule you are suppressing, and a reason for the suppression.

```typespec
  #suppress "@azure-tools/typespec-azure-resource-manager/use-operation-decorator" "This is a sample suppression."
  /** Gets the MAA URL for this resource */
  @post
  getZeroTrustUrl(...ResourceInstanceParameters<ZeroTrustResource>): ZeroTrustUrl | ErrorResponse;
```

Of course, in this case, the best resolution would be to follow the advice in the linting rule, and add the `@armResourceAction` decorator.

```typespec
  @armResourceAction(ZeroTrustResource)
  /** Gets the MAA URL for this resource */
  @post
  getZeroTrustUrl(...ResourceInstanceParameters<ZeroTrustResource>): ZeroTrustUrl | ErrorResponse;
```

## Evaluating Rule Violations

The tables below provide guidance to rule authors and ARM reviewers on how to evaluate violations of TypeSpec ARM rules. Rules are grouped by the library that defines them and listed alphabetically by name. For each rule, the tables give a link to its reference documentation, the corresponding LintDiff rule (if any), and the impact of a violation, including the area it affects.

### Rules in @azure-tools/typespec-azure-core

| Rule                                                                                                                                                                                                                       | LintDiff                                                                                                                                                      | Impact                                                                                                                                                            |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`auth-required`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/auth-required/)                                                                                                                   | —                                                                                                                                                             | **API, SDK.** None; all ARM APIs allow the same authentication.                                                                                                   |
| [`byos`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/byos/)                                                                                                                                     | —                                                                                                                                                             | **API.** The API uses file upload and download instead of a storage account.                                                                                      |
| [`casing-style`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/casing-style/)                                                                                                                     | [R3016](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r3016) (covers the serious violation) | **API, SDK.** On properties, this produces non-standard casing that impacts usability. On other types, emitters substitute the correct casing for their language. |
| [`composition-over-inheritance`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/composition-over-inheritance/)                                                                                     | —                                                                                                                                                             | **SDK.** Overuse of inheritance impacts SDK usability.                                                                                                            |
| [`documentation-required`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/documentation-required/)                                                                                                 | [`*SummaryOrDescription`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/operation-summary-or-description.md)                                | **API, SDK.** Results in poor documentation in SDKs and API docs.                                                                                                 |
| [`friendly-name`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/friendly-name/)                                                                                                                   | —                                                                                                                                                             | **API evolution.** Names a type for emitters in an unscoped way; `@clientName` should be used instead.                                                            |
| [`key-visibility-required`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/key-visibility-required/)                                                                                               | —                                                                                                                                                             | **API, SDK.** May inaccurately represent the mutability of identity fields.                                                                                       |
| [`known-encoding`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/known-encoding/)                                                                                                                 | [R2003](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r2003)                                | **API, SDK.** Impacts API and SDK usability; non-standard formats are transmitted only as the unencoded wire type.                                                |
| [`long-running-polling-operation-required`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/long-running-polling-operation-required/)                                                               | —                                                                                                                                                             | **SDK, API.** Inapplicable to ARM LROs, but prevents an API from being represented as an LRO.                                                                     |
| [`no-case-mismatch`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-case-mismatch/)                                                                                                             | —                                                                                                                                                             | **SDK.** Type names that differ only by casing prevent SDK generation.                                                                                            |
| [`no-error-status-codes`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-error-status-codes/)                                                                                                   | [`NoErrorCodeResponses`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/no-error-code-responses.md)                                          | **API.** Using status codes in a non-standard way makes APIs difficult to use.                                                                                    |
| [`no-explicit-routes-resource-ops`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-explicit-routes-resource-ops/)                                                                               | —                                                                                                                                                             | **API.** May indicate non-standard resource paths.                                                                                                                |
| [`no-fixed-enum-discriminator`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-string-discriminator/)                                                                                           | —                                                                                                                                                             | **API.** Makes adding a new discriminant value a breaking change.                                                                                                 |
| [`no-format`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-format/)                                                                                                                           | —                                                                                                                                                             | **SDK, API.** May use an invalid format.                                                                                                                          |
| [`no-generic-numeric`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-generic-numeric/)                                                                                                         | [R2003](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r2003)                                | **SDK.** SDKs lose precision or cannot represent the value with a strong numeric type.                                                                            |
| [`no-header-explode`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-header-explode/)                                                                                                           | —                                                                                                                                                             | **API.** Mainly a data-plane concern, but explode should not be allowed for headers.                                                                              |
| [`no-legacy-usage`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-legacy-usage/)                                                                                                               | —                                                                                                                                                             | **API, SDK.** Uses legacy patterns instead of standard patterns.                                                                                                  |
| [`no-multiple-discriminator`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-multiple-discriminator/)                                                                                           | —                                                                                                                                                             | **SDK, API.** Multiple discriminators are not supported by SDKs, nor by Swagger without extensions.                                                               |
| [`no-nullable`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-nullable/)                                                                                                                       | —                                                                                                                                                             | **API, SDK.** This is usually a mistake where the property should be optional.                                                                                    |
| [`no-offsetdatetime`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-offsetdatetime/)                                                                                                           | —                                                                                                                                                             | **SDK, API.** Reduces clarity of purpose; a time is best provided in UTC.                                                                                         |
| [`no-openapi`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-openapi/)                                                                                                                         | —                                                                                                                                                             | **API, SDK, Emitters.** Introduces OpenAPI changes that are not reflected in other emitters such as SDKs, which can cause SDKs to misrepresent the wire API.      |
| [`no-private-usage`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-private-usage/)                                                                                                             | —                                                                                                                                                             | **API, SDK.** May cause a spec break in the future.                                                                                                               |
| [`no-query-explode`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-query-explode/)                                                                                                             | —                                                                                                                                                             | **API.** Mainly a data-plane concern, but explode should not be allowed for query parameters.                                                                     |
| [`no-rest-library-interfaces`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-rest-library-interfaces/)                                                                                         | —                                                                                                                                                             | **SDK, Emitters.** If used to describe resource APIs, emitters may not recognize them as such, though this would produce other violations.                        |
| [`no-route-parameter-name-mismatch`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-route-parameter-name-mismatch/)                                                                             | —                                                                                                                                                             | **SDK.** When representing operations over a resource, mismatched parameters can produce strange SDK operation signatures.                                        |
| [`no-rpc-path-params`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-rpc-path-params/)                                                                                                         | —                                                                                                                                                             | There are no violations in ARM.                                                                                                                                   |
| [`no-string-discriminator`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-string-discriminator/)                                                                                               | —                                                                                                                                                             | **SDK.** Makes the SDK less usable because discriminant values are unknown.                                                                                       |
| [`no-unknown`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-unknown/)                                                                                                                         | —                                                                                                                                                             | **API, SDK.** Allowing any JSON type makes SDKs and APIs unusable without extensive documentation.                                                                |
| [`no-unnamed-types`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-unnamed-types/)                                                                                                             | —                                                                                                                                                             | **SDK, API.** Causes the SDK to use an unnamed type.                                                                                                              |
| [`operation-missing-api-version`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/operation-missing-api-version/)                                                                                   | [`ApiVersionParameterRequired`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/api-version-parameter-required.md)                            | **API, SDK.** An unversioned operation cannot evolve.                                                                                                             |
| [`request-body-problem`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/request-body-problem/)                                                                                                     | —                                                                                                                                                             | **API, SDK.** A request body that is an array makes API evolution difficult.                                                                                      |
| [`require-versioned`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/require-versioned/)                                                                                                           | —                                                                                                                                                             | **SDK, API.** Prevents updating the API with new api-versions.                                                                                                    |
| [`response-schema-problem`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/response-schema-problem/)                                                                                               | —                                                                                                                                                             | **API, SDK.** May indicate a forgotten response status code.                                                                                                      |
| [`spread-discriminated-model`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/spread-discriminated-model/)                                                                                         | —                                                                                                                                                             | **SDK.** May indicate a mistake, because a discriminator is ineffective when spread.                                                                              |
| [`no-closed-literal-union`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-closed-literal-union/), [`no-enum`](https://azure.github.io/typespec-azure/docs/libraries/azure-core/rules/no-enum/) | —                                                                                                                                                             | **SDK, API.** Prevents adding values to an enum in new api-versions without a breaking change.                                                                    |

### Rules in @azure-tools/typespec-azure-resource-manager

| Rule                                                                                                                                                                         | LintDiff                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Impact                                                                                                                                                                                           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |   | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`arm-common-types-version`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-common-types-version/)                                   | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API, SDK.** Indicates that common-types are not used, though this should produce other violations.                                                                                             |
| [`arm-custom-resource-no-key`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-custom-resource-no-key/)                               | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API, SDK.** Mainly a correctness issue; the name property should use `@key`.                                                                                                                   |
| [`arm-custom-resource-usage-discourage`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-custom-resource-usage-discourage/)           | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API.** The resource does not use ARM common-types.                                                                                                                                             |
| [`arm-delete-operation-response-codes`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-delete-operation-response-codes/)             | [`DeleteResponseCodes`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/delete-response-codes.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-no-path-casing-conflicts`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-no-path-casing-conflicts/)                           | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API, SDK.** Different-case paths to the same resource can cause ARM manifest failures.                                                                                                         |
| [`arm-no-record`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-no-record/)                                                         | [`AvoidAdditionalProperties`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/avoid-additional-properties.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                        | **API, SDK.** Dictionary types make the API and SDK difficult to use.                                                                                                                            |
| [`arm-post-operation-response-codes`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-post-operation-response-codes/)                 | [`PostResponseCodes`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/post-response-codes.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-put-operation-response-codes`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-put-operation-response-codes/)                   | [`PutResponseCodes`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/put-response-codes.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-resource-action-no-segment`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-action-no-segment/)                       | [`PathForResourceAction`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/path-for-resource-action.md) (partial)                                                                                                                                                                                                                                                                                                                                                                                                                                                     | **API, SDK.** May indicate a violation of the resource action path.                                                                                                                              |
| [`arm-resource-duplicate-property`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-duplicate-property/)                     | [R3019](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r3019)                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-resource-interface-requires-decorator`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-interface-requires-decorator/) | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | No impact beyond what other rules cover.                                                                                                                                                         |
| [`arm-resource-invalid-action-verb`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-invalid-action-verb/)                   | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API, SDK.** An improper HTTP verb for a resource action can cause failures in the C# SDK and in emitters that model resource actions, such as service generation and the portal.               |
| [`arm-resource-invalid-envelope-property`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-invalid-envelope-property/)       | [R3006](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r3006)                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-resource-invalid-version-format`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-invalid-version-format/)             | [R3012](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r3012)                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-resource-key-invalid-chars`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-key-invalid-chars/)                       | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **SDK.** The resource parameter name produces invalid keys in SDKs.                                                                                                                              |
| [`arm-resource-name-pattern`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-name-pattern/)                                 | [`ResourceNameRestriction`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/resource-name-restriction.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                            | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-resource-operation-response`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-operation-response/)                     | [R3007](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r3007) (the TypeSpec rule also covers `list`)                                                                                                                                                                                                                                                                                                                                                                                                                | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-resource-patch`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-patch/)                                               | [`ConsistentPatchProperties`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/consistent-patch-properties.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                        | **API.** RPC violation.                                                                                                                                                                          |
| [`arm-resource-path-segment-invalid-chars`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-path-segment-invalid-chars/)     | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **SDK, API.** Produces an invalid ARM API and invalid parameter names.                                                                                                                           |
| [`arm-resource-provisioning-state`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-provisioning-state/)                     | [`ProvisioningStateValidation`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/provisioning-state-validation.md), [`ProvisioningStateSpecifiedForLROPut`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/lro-put-provisioning-state-specified.md), [`ProvisioningStateSpecifiedForLROPatch`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/lro-patch-provisioning-state-specified.md), [`RpaaS_ResourceProvisioningState`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/rpaas-resource-provisioning-state.md) | **API.** RPC / RPaaS violation.                                                                                                                                                                  |
| [`beyond-nesting-levels`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/beyond-nesting-levels/)                                         | [`TrackedResourceBeyondsThirdLevel`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/tracked-resource-beyond-thrid-level.md)                                                                                                                                                                                                                                                                                                                                                                                                                                         | **API.** RPC violation.                                                                                                                                                                          |
| [`empty-updateable-properties`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/empty-updateable-properties/)                             | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API.** Covered by patch-specific rules.                                                                                                                                                        |
| [`improper-subscription-list-operation`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/improper-subscription-list-operation/)           | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API.** Likely a modeling error; only subscription-based resources should have list operations.                                                                                                 |
| [`lro-location-header`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/lro-location-header/)                                             | [`LroLocationHeader`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/lro-location-header.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | **API.** RPC violation.                                                                                                                                                                          |
| [`missing-operations-endpoint`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/missing-operations-endpoint/)                             | [R3023](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r3023)                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **API.** RPC violation.                                                                                                                                                                          |
| [`missing-x-ms-identifiers`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/missing-x-ms-identifiers/)                                   | [R4041](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r4041) (warning)                                                                                                                                                                                                                                                                                                                                                                                                                                             | **API.** No real impact (an old pattern).                                                                                                                                                        |
| [`no-empty-model`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/no-empty-model/)                                                       | [R4037](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/openapi-authoring-automated-guidelines.md#r4037)                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **API, SDK.** Accepting any schema makes the API and SDK difficult to use.                                                                                                                       |
| [`no-override-props`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/no-override-props/)                                                 | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **SDK, Tooling.** Violations can crash the breaking-change tool and are unsupported by most languages.                                                                                           |
| [`no-resource-delete-operation`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/no-resource-delete-operation/)                           | [`AllTrackedResourcesMustHaveDelete`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/all-tracked-resources-must-have-delete.md)                                                                                                                                                                                                                                                                                                                                                                                                                                     | **API.** RPC violation.                                                                                                                                                                          |
| [`no-response-body`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/no-response-body/)                                                   | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API.** A non-empty response, usually for a 202.                                                                                                                                                |
| [`patch-envelope`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/patch-envelope/)                                                       | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API.** A Patch operation is missing updatable envelope properties.                                                                                                                             |
| [`resource-name`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/resource-name/)                                                         | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API, SDK.** Invalid characters in a name violate the RPC and create invalid client parameter names, which prevents SDK generation.                                                             |
| [`secret-prop`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/secret-prop/)                                                             | [`XMSSecretInResponse`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/xms-secret-in-response.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | **API.** RPC violation.                                                                                                                                                                          |
| [`unsupported-type`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/unsupported-type/)                                                   | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **SDK.** The data type cannot be modeled in SDKs.                                                                                                                                                |
| [`use-api-version`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-api-version/)                                                     | [`ApiVersionParameterRequired`](https://github.com/Azure/azure-openapi-validator/blob/main/docs/api-version-parameter-required.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                   | **API, SDK.** An operation without the standard API version parameter cannot evolve safely and is difficult for SDKs to represent consistently.                                                  |
| [`use-interface`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-interface/)                                                         | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API, SDK, Emitters.** Resource operations outside interfaces can break ARM resource-operation modeling and downstream tooling assumptions.                                                     |
| [`use-operation-decorator`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-operation-decorator/)                                     | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API, SDK, Emitters.** Missing or mismatched decorators prevent resource operations from being associated with the correct resource, which can break SDK generation and resource-aware tooling. |
| [`version-progression`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/version-progression/)                                             | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | **API, SDK, Tooling.** Out-of-order versions make specs unmaintainable, and versions with matching dates cause SDK problems.                                                                     |

### Rules in @azure-tools/typespec-client-generator-core

| Rule                                                                                                                                           | LintDiff | Impact                                                    |
| ---------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------- |
| [`property-name-conflict`](https://azure.github.io/typespec-azure/docs/libraries/typespec-client-generator-core/rules/property-name-conflict/) | —        | **SDK.** Not representable in the C# SDK.                 |
| [`require-client-suffix`](https://azure.github.io/typespec-azure/docs/libraries/typespec-client-generator-core/rules/require-client-suffix/)   | —        | **SDK.** Clients do not follow the SDK naming guidelines. |
