arm-custom-resource-no-key

Id

@azure-tools/typespec-azure-resource-manager/arm-custom-resource-no-key

Validate that custom resource contains a key property.

-

@azure-tools/typespec-azure-resource-manager/arm-custom-resource-no-key

Custom Azure resource models must define a key property using the @key decorator, especially if the custom resource will be used in operations. Without a key, operation paths may be duplicated.

Impact

• Area: API, SDK

Mainly a correctness issue: the resource’s name property should be marked with @key.

❌ Incorrect

@Azure.ResourceManager.Legacy.customAzureResource
model CustomResource {
  someId: string;
}

✅ Correct

@Azure.ResourceManager.Legacy.customAzureResource
model CustomResource {
  @key
  someId: string;
}

Suppression

Suppress only when required to match an existing API; otherwise add @key to the name parameter of the resource.