arm-custom-resource-usage-discourage

Full name

@azure-tools/typespec-azure-resource-manager/arm-custom-resource-usage-discourage

Avoid using the @customAzureResource decorator. It doesn’t provide validation for ARM resources, and its usage should be limited to brownfield services migration.

❌ Incorrect

@Azure.ResourceManager.Legacy.customAzureResource
model Person {
  name: string;
}

✅ Correct

Use standard ARM resource types:

model Employee is TrackedResource<EmployeeProperties> {
  ...ResourceNameParameter<Employee>;
}

Reviewer advice

Impacts the API: custom resources do not use ARM common types. Ask the author to use TrackedResource, ProxyResource, or ExtensionResource instead. Treat suppressions like any other resource not using common types.