arm-resource-action-no-segment

Full name

@azure-tools/typespec-azure-resource-manager/arm-resource-action-no-segment

The @armResourceAction decorator should not be used together with @segment. If you need to rename the action, use @action(...) instead or omit the segment entirely.

❌ Incorrect

@armResourceAction(MyResource)
@segment("doSomething")
@post
op doAction(...ApiVersionParameter): void;

✅ Correct

@armResourceAction(MyResource)
@post
op doAction(...ApiVersionParameter): void;

✅ Correct (with custom action name)

@armResourceAction(MyResource)
@action("doSomething")
@post
op doAction(...ApiVersionParameter): void;

Reviewer advice

Impacts the API and generated SDKs: this can indicate the resource action path is modeled incorrectly, though LintDiff partially covers it through PathForResourceAction. Ask the author to use @action for the final path segment with standard resource action templates. Suppress only if the actual emitted path works.