Skip to content

put-operation-response-codes

Full name
@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes

Put operations should use the ArmResourceCreateOrReplaceAsync or ArmResourceCreateOrReplaceSync template. They must have 200, 201, default and no other responses.

❌ Incorrect

Section titled “❌ Incorrect”
@armResourceOperations
interface Employees {
  @armResourceCreateOrUpdate(Employee)
  createOrUpdate(...ApiVersionParameter): {
    @statusCode _: 200;
    result: boolean;
  };
}

✅ Correct

Section titled “✅ Correct”
@armResourceOperations
interface Employees {
  createOrUpdate is ArmResourceCreateOrReplaceAsync<Employee>;
}

Reviewer advice

Section titled “Reviewer advice”

Impacts the API: this corresponds to the LintDiff rule PutResponseCodes and causes an RPC violation. Ask the author to use standard createOrUpdate operation templates. Do not accept a suppression unless it is needed to match existing APIs.