@azure-tools/typespec-azure-resource-manager 0.30.0-dev.1 → 0.30.0-dev.11

package/dist/src/rules/utils.js

@@ -1,4 +1,4 @@
-import { getNamespaceFullName, SyntaxKind, } from "@typespec/compiler";
+import { getNamespaceFullName, isTemplateDeclaration, SyntaxKind, } from "@typespec/compiler";
 import { getResourceOperation } from "@typespec/rest";
 import { getArmResourceKind } from "../resource.js";
 /**
@@ -7,11 +7,10 @@ import { getArmResourceKind } from "../resource.js";
  *@returns true if the operation is defined on a templated interface which hasn't had args filled in
  */
 export function isTemplatedInterfaceOperation(target) {
-    var _a, _b;
+    var _a;
     return (((_a = target.node) === null || _a === void 0 ? void 0 : _a.kind) === SyntaxKind.OperationStatement &&
         target.interface &&
-        target.interface.node.templateParameters.length &&
-        !((_b = target.interface.templateArguments) === null || _b === void 0 ? void 0 : _b.length));
+        isTemplateDeclaration(target.interface));
 }
 export function isTrackedResource(resourceType) {
     const resultKind = getArmResourceKind(resourceType);

package/dist/src/rules/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/rules/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/rules/utils.ts"],"names":[],"mappings":"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"}

package/lib/arm.foundations.tsp

@@ -4,6 +4,9 @@ using TypeSpec.Versioning;
 
 namespace Azure.ResourceManager.Foundations;
 
+/**
+ * A list of REST API operations supported by an Azure Resource Provider. It contains an URL link to get the next set of results.
+ */
 @armCommonDefinition
 @doc("""
 A list of REST API operations supported by an Azure Resource Provider. It contains an URL link to get the next set of results.
@@ -90,6 +93,9 @@ enum ActionType {
   Internal,
 }
 
+/**
+ * Localized display information for and operation.
+ */
 @armCommonDefinition
 @doc("Localized display information for and operation.")
 model OperationDisplay {
@@ -112,6 +118,9 @@ model OperationDisplay {
   description?: string;
 }
 
+/**
+ * The current status of an async operation.
+ */
 @armCommonDefinition
 @doc("The current status of an async operation.")
 model OperationStatusResult {
@@ -142,6 +151,9 @@ model OperationStatusResult {
   error?: ErrorDetail;
 }
 
+/**
+ * The error detail.
+ */
 @armCommonDefinition
 @doc("The error detail.")
 model ErrorDetail {
@@ -168,6 +180,10 @@ model ErrorDetail {
   additionalInfo?: ErrorAdditionalInfo[];
 }
 
+/**
+ * Base parameters for a resource.
+ * @template TResource The type of the resource.
+ */
 @resourceBaseParametersOf(TResource)
 model BaseParameters<TResource extends ArmResource> {
   ...ApiVersionParameter;
@@ -181,31 +197,44 @@ model BaseParameters<TResource extends ArmResource> {
   ...ResourceUriParameter;
 }
 
-// The static parameters for a tenant-based resource
+/**
+ * The static parameters for a tenant-based resource
+ */
 model TenantBaseParameters {
   ...ApiVersionParameter;
 }
 
-// The static parameters for a subscription based resource
+/**
+ * The static parameters for a subscription based resource
+ */
 model SubscriptionBaseParameters is TenantBaseParameters {
   ...SubscriptionIdParameter;
 }
 
-// The static parameters for a location-based resource
+/**
+ * The static parameters for a location-based resource
+ */
 model LocationBaseParameters is SubscriptionBaseParameters {
   ...LocationParameter;
 }
 
-// The static parameters for a resource-group based resource
+/**
+ * The static parameters for a resource-group based resource
+ */
 model ResourceGroupBaseParameters is SubscriptionBaseParameters {
   ...ResourceGroupParameter;
 }
 
-// The static parameters for an extension resource
+/**
+ * The static parameters for an extension resource
+ */
 model ExtensionBaseParameters is TenantBaseParameters {
   ...ResourceUriParameter;
 }
 
+/**
+ * The resource management error additional info.
+ */
 @armCommonDefinition
 @doc("The resource management error additional info.")
 model ErrorAdditionalInfo {
@@ -229,6 +258,9 @@ model ArmTagsProperty {
   tags?: Record<string>;
 }
 
+/**
+ * The kind of entity that created the resource.
+ */
 // NOTE: This is how the enum is named in types.json
 @doc("The kind of entity that created the resource.")
 enum createdByType {
@@ -238,6 +270,9 @@ enum createdByType {
   Key,
 }
 
+/**
+ * Metadata pertaining to creation and last modification of the resource.
+ */
 @armCommonDefinition("systemData")
 @doc("Metadata pertaining to creation and last modification of the resource.")
 model SystemData {
@@ -266,6 +301,9 @@ model SystemData {
   lastModifiedAt?: plainDate;
 }
 
+/**
+ * The properties of the managed service identities assigned to this resource.
+ */
 @armCommonDefinition("ManagedServiceIdentity", "v4", "managedidentity.json")
 @doc("The properties of the managed service identities assigned to this resource.")
 model ManagedIdentityProperties {
@@ -284,6 +322,9 @@ model ManagedIdentityProperties {
   userAssignedIdentities?: Record<UserAssignedIdentity>;
 }
 
+/**
+ * The properties of the service-assigned identity associated with this resource.
+ */
 @armCommonDefinition("SystemAssignedServiceIdentity", "v4", "managedidentity.json")
 @doc("The properties of the service-assigned identity associated with this resource.")
 model ManagedSystemIdentityProperties {
@@ -299,6 +340,9 @@ model ManagedSystemIdentityProperties {
   type: ManagedSystemIdentityType;
 }
 
+/**
+ * A managed identity assigned by the user.
+ */
 @doc("A managed identity assigned by the user.")
 model UserAssignedIdentity {
   @doc("The active directory client identifier for this principal.")
@@ -308,6 +352,9 @@ model UserAssignedIdentity {
   principalId?: string;
 }
 
+/**
+ * The kind of managed identity assigned to this resource.
+ */
 @doc("The kind of managed identity assigned to this resource.")
 enum ManagedIdentityType {
   None,
@@ -316,21 +363,32 @@ enum ManagedIdentityType {
   SystemAndUserAssigned: "SystemAssigned, UserAssigned",
 }
 
+/**
+ * The kind of managemed identity assigned to this resource.
+ */
 @doc("The kind of managemed identity assigned to this resource.")
 enum ManagedSystemIdentityType {
   None,
   SystemAssigned,
 }
 
-// Defines a properties type used to create named resource update models.
-// This type is not used directly, it is referenced by ResourceUpdateModel<T>.
+/**
+ * Defines a properties type used to create named resource update models.
+ * This type is not used directly, it is referenced by ResourceUpdateModel.
+ * @template TResource The type of the resource.
+ * @template TProperties The type of the properties.
+ */
 @doc("The updatable properties of the {name}.", TResource)
 @friendlyName("{name}UpdateProperties", TResource)
 model ResourceUpdateModelProperties<TResource extends ArmResource, TProperties extends object>
   is OptionalProperties<UpdateableProperties<TProperties>>;
 
-// Defines a model type used to create named resource update models
-//   e.g. `model MyResourceUpdate is ResourceUpdate<MyResourceProperties> {}`
+/**
+ * Defines a model type used to create named resource update models
+ * e.g. `model MyResourceUpdate is ResourceUpdate<MyResourceProperties> {}`
+ * @template TResource The type of the resource.
+ * @template TProperties The type of the properties.
+ */
 @doc("The type used for update operations of the {name}.", TResource)
 @friendlyName("{name}Update", TResource)
 @omitIfEmpty("properties")
@@ -340,6 +398,10 @@ model ResourceUpdateModel<TResource extends ArmResource, TProperties extends obj
   properties?: ResourceUpdateModelProperties<TResource, TProperties>;
 }
 
+/**
+ * The type used for updating tags in resources.
+ * @template TResource The type of the resource.
+ */
 @doc("The type used for updating tags in {name} resources.", TResource)
 @friendlyName("{name}TagsUpdate", TResource)
 model TagsUpdateModel<TResource extends ArmResource> {
@@ -350,25 +412,43 @@ model TagsUpdateModel<TResource extends ArmResource> {
 
 alias TenantParentScope<TResource extends ArmResource> = TenantScope<TResource>;
 
-// Parameter model for listing a resource at the tenant scope
+/**
+ * Parameter model for listing a resource at the tenant scope
+ * @template TResource The type of the resource.
+ */
 model TenantScope<TResource extends ArmResource>
   is ResourceParentParameters<TResource, TenantBaseParameters>;
 
-// Parameter model for listing a resource at the subscription scope
+/**
+ * Parameter model for listing a resource at the subscription scope
+ * @template TResource The type of the resource.
+ */
 model SubscriptionScope<TResource extends ArmResource>
   is ResourceParentParameters<TResource, SubscriptionBaseParameters>;
 
-// Parameter model for listing a resource at the location scope
+/**
+ * Parameter model for listing a resource at the location scope
+ * @template TResource The type of the resource.
+ */
 model LocationScope<TResource extends ArmResource>
   is ResourceParentParameters<TResource, LocationBaseParameters>;
 
-// Parameter model for listing an extension resource
+/**
+ * Parameter model for listing an extension resource
+ * @template TResource The type of the resource.
+ */
 model ExtensionScope<TResource extends ArmResource>
   is ResourceParentParameters<TResource, ExtensionBaseParameters>;
 
-// Parameter model for listing a resource at the resource group scope
+/**
+ * Parameter model for listing a resource at the resource group scope
+ * @template TResource The type of the resource.
+ */
 model ResourceGroupScope<TResource extends ArmResource> is ResourceParentParameters<TResource>;
 
+/**
+ * Details of the resource plan.
+ */
 @doc("Details of the resource plan.")
 @armCommonDefinition("Plan")
 model ResourcePlanType {
@@ -388,6 +468,9 @@ model ResourcePlanType {
   version?: string;
 }
 
+/**
+ * The SKU (Stock Keeping Unit) assigned to this resource.
+ */
 @doc("The SKU (Stock Keeping Unit) assigned to this resource.")
 @armCommonDefinition("Sku")
 model ResourceSkuType {
@@ -407,6 +490,9 @@ model ResourceSkuType {
   capacity?: int32;
 }
 
+/**
+ * Available service tiers for the SKU.
+ */
 @doc("Available service tiers for the SKU.")
 enum SkuTier {
   Free,
@@ -415,6 +501,11 @@ enum SkuTier {
   Premium,
 }
 
+/**
+ * The type used for update operations of the resource.
+ * @template TResource The type of the resource.
+ * @template TProperties The type of the properties.
+ */
 @doc("The type used for update operations of the {name}.", TResource)
 @friendlyName("{name}Update", TResource)
 model ProxyResourceUpdateModel<TResource extends ArmResource, TProperties extends object> {
@@ -455,6 +546,9 @@ model Operation {
   actionType?: ActionType;
 }
 
+/**
+ * The default operationId parameter type.
+ */
 @doc("The default operationId parameter type.")
 model OperationIdParameter {
   @path
@@ -463,3 +557,79 @@ model OperationIdParameter {
   @armCommonParameter("OperationIdParameter")
   operationId: string;
 }
+
+/**
+ * The check availability request body.
+ */
+@armCommonDefinition
+@doc("The check availability request body.")
+model CheckNameAvailabilityRequest {
+  @doc("The name of the resource for which availability needs to be checked.")
+  name?: string;
+
+  @doc("The resource type.")
+  type?: string;
+}
+
+/**
+ * Possible reasons for a name not being available.
+ */
+@doc("Possible reasons for a name not being available.")
+enum CheckNameAvailabilityReason {
+  Invalid,
+  AlreadyExists,
+}
+
+/**
+ * The check availability result.
+ */
+@armCommonDefinition
+@doc("The check availability result.")
+model CheckNameAvailabilityResponse {
+  @doc("Indicates if the resource name is available.")
+  nameAvailable?: boolean;
+
+  @doc("The reason why the given name is not available.")
+  reason?: CheckNameAvailabilityReason;
+
+  @doc("Detailed reason why the given name is not available.")
+  message?: string;
+}
+
+alias DefaultProviderNamespace = {
+  @path
+  @TypeSpec.Rest.segment("providers")
+  @doc("The provider namespace for the resource.")
+  provider: "Microsoft.ThisWillBeReplaced";
+};
+
+/**
+ * Adds check name availability operation, normally used if
+ * a resource name must be globally unique (for example, if the resource
+ * exposes an endpoint that uses the resource name in the url)
+ * @template TScopeParameters A parameter model with properties representing the scope of the resource
+ * @template TRequest The operation request body
+ * @template TResponse The operation response
+ * @template TAdditionalParams A parameter model with properties representing non-path parameters
+ */
+@TypeSpec.Rest.autoRoute
+@armResourceCollectionAction
+@armProviderNameValue
+@doc("Implements global CheckNameAvailability operations")
+@TypeSpec.Rest.action("checkNameAvailability")
+@post
+op checkNameAvailability<
+  TScopeParameters extends object,
+  TRequest extends object = Azure.ResourceManager.Foundations.CheckNameAvailabilityRequest,
+  TResponse extends object = CheckNameAvailabilityResponse,
+  TAdditionalParams extends object = {}
+>(
+  ...ApiVersionParameter,
+  ...TScopeParameters,
+  ...DefaultProviderNamespace,
+  ...TAdditionalParams,
+
+  @doc("The CheckAvailability request")
+  @body
+  body: TRequest
+): TResponse | ErrorResponse;

package/lib/arm.tsp

@@ -25,6 +25,9 @@ using Azure.ResourceManager.Foundations;
 @versioned(Azure.ResourceManager.Versions)
 namespace Azure.ResourceManager;
 
+/**
+ * Supported versions of Azure.ResourceManager building blocks.
+ */
 enum Versions {
   @useDependency(Azure.Core.Versions.v1_0_Preview_1)
   v1_0_Preview_1: "1.0-preview.1",

package/lib/decorators.tsp

@@ -85,3 +85,15 @@ extern dec resourceGroupResource(target: object);
  * See more details on [different ARM resource type here.](https://azure.github.io/typespec-azure/docs/howtos/ARM/resource-type)
  */
 extern dec extensionResource(target: object);
+
+/**
+ * `@armResourceType` sets the value fo the decorated string
+ * property to the type of the ARM resource.
+ * @param resource The resource to get the type of
+ */
+extern dec armProviderNameValue(target: Operation | object);
+
+/**
+ * Marks the operation as being a collection action
+ */
+extern dec armResourceCollectionAction(target: Operation | object);

package/lib/interfaces.tsp

@@ -75,6 +75,8 @@ interface TrackedResourceOperations<
  *   `/subscriptions/{id}/resourcegroups/{rg}/providers/Microsoft.XXX/...`
  *
  * This is the most common API pattern for Proxy Resources to use.
+ * @template TResource the ArmResource that provides these operations
+ * @template TBaseParameters The http parameters that are part of the request
  */
 interface ProxyResourceOperations<
   TResource extends ArmResource,
@@ -93,6 +95,8 @@ interface ProxyResourceOperations<
  *   `/providers/Microsoft.XXX/...`
  *
  * This is the most common API pattern for Tenant Resources to use.
+ * @template TResource the ArmResource that provides these operations
+ * @template TProperties RP-specific property bag for the resource
  */
 interface TenantResourceOperations<TResource extends ArmResource, TProperties extends object>
   extends TenantResourceRead<TResource>,
@@ -101,6 +105,13 @@ interface TenantResourceOperations<TResource extends ArmResource, TProperties ex
     TenantResourceDelete<TResource>,
     TenantResourceListByParent<TResource> {}
 
+/**
+ * A composite interface for resources that have CRUD operations.
+ * @template TResource The ArmResource that provides these operations
+ * @template TProperties RP-specific property bag for the resource
+ * @template TBaseParameters The http parameters that are part of the request
+ * @template TPatchModel The model used for PATCH operations
+ */
 interface ResourceInstanceOperations<
   TResource extends ArmResource,
   TProperties extends object,
@@ -112,15 +123,31 @@ interface ResourceInstanceOperations<
     ResourceUpdate<TResource, TProperties, TBaseParameters>,
     ResourceDelete<TResource, TBaseParameters> {}
 
+/**
+ * A composite interface for resource collections.
+ * @template TResource The ArmResource that provides these operations
+ * @template TBaseParameters The http parameters that are part of the request
+ */
 interface ResourceCollectionOperations<
   TResource extends ArmResource,
   TBaseParameters = BaseParameters<TResource>
 > extends ResourceListByParent<TResource, TBaseParameters>, ResourceListBySubscription<TResource> {}
 
+/**
+ * An interface for resources with can be listed by subscription.
+ * @template TResource The ArmResource that provides these operations
+ */
 interface ResourceListBySubscription<TResource extends ArmResource> {
   listBySubscription is ArmListBySubscription<TResource>;
 }
 
+/**
+ * An interface for resources which can be listed by parent.
+ * @template TResource The ArmResource that provides these operations
+ * @template TBaseParameters The http parameters that are part of the request
+ * @template TParentName The name of the parent resource
+ * @template TParentFriendlyName The friendly name of the parent resource
+ */
 interface ResourceListByParent<
   TResource extends ArmResource,
   TBaseParameters = BaseParameters<TResource>,
@@ -135,10 +162,20 @@ interface ResourceListByParent<
   >;
 }
 
+/**
+ * A composite interface for resources that include a GET operation.
+ * @template TResource The ArmResource that provides these operations
+ * @template TBaseParameters The http parameters that are part of the request
+ */
 interface ResourceRead<TResource extends ArmResource, TBaseParameters = BaseParameters<TResource>> {
   get is ArmResourceRead<TResource, TBaseParameters>;
 }
 
+/**
+ * A composite interface for resources that include a synchronous create or update operation.
+ * @template TResource The ArmResource that provides these operations
+ * @template TBaseParameters The http parameters that are part of the request
+ */
 interface ResourceCreateSync<
   TResource extends ArmResource,
   TBaseParameters = BaseParameters<TResource>
@@ -146,6 +183,11 @@ interface ResourceCreateSync<
   createOrUpdate is ArmResourceCreateOrUpdateSync<TResource, TBaseParameters>;
 }
 
+/**
+ * A composite interface for resources that include a long-running create or update operation.
+ * @template TResource The ArmResource that provides these operations
+ * @template TBaseParameters The http parameters that are part of the request
+ */
 interface ResourceCreateAsync<
   TResource extends ArmResource,
   TBaseParameters = BaseParameters<TResource>
@@ -153,6 +195,11 @@ interface ResourceCreateAsync<
   createOrUpdate is ArmResourceCreateOrUpdateAsync<TResource, TBaseParameters>;
 }
 
+/**
+ * A composite interface for resources that include a long-running delete operation.
+ * @template TResource The ArmResource that provides these operations
+ * @template TBaseParameters The http parameters that are part of the request
+ */
 @doc("Delete a resource using the asynchronous call pattern")
 interface ResourceDeleteAsync<
   TResource extends ArmResource,
@@ -161,6 +208,11 @@ interface ResourceDeleteAsync<
   delete is ArmResourceDeleteAsync<TResource, TBaseParameters>;
 }
 
+/**
+ * A composite interface for resources that include a synchronous delete operation.
+ * @template TResource The ArmResource that provides these operations
+ * @template TBaseParameters The http parameters that are part of the request
+ */
 @doc("Delete a resource")
 interface ResourceDeleteSync<
   TResource extends ArmResource,
@@ -169,6 +221,12 @@ interface ResourceDeleteSync<
   delete is ArmResourceDeleteSync<TResource, TBaseParameters>;
 }
 
+/**
+ * A composite interface for resources that include a long-running update operation.
+ * @template TResource The ArmResource that provides these operations
+ * @template TProperties RP-specific property bag for the resource
+ * @template TBaseParameters The http parameters that are part of the request
+ */
 @doc("Asynchronous resource update")
 interface ResourceUpdateAsync<
   TResource extends ArmResource,
@@ -182,6 +240,12 @@ interface ResourceUpdateAsync<
   >;
 }
 
+/**
+ * A composite interface for resources that include a synchronous update operation.
+ * @template TResource The ArmResource that provides these operations
+ * @template TProperties RP-specific property bag for the resource
+ * @template TBaseParameters The http parameters that are part of the request
+ */
 @doc("Synchronous resource update")
 interface ResourceUpdateSync<
   TResource extends ArmResource,
@@ -195,6 +259,11 @@ interface ResourceUpdateSync<
   >;
 }
 
+/**
+ * A composite interface for resources that includes CRUD operations.
+ * @template TResource The ArmResource that provides these operations
+ * @template TProperties RP-specific property bag for the resource
+ */
 interface ExtensionResourceInstanceOperations<
   TResource extends ArmResource,
   TProperties extends object
@@ -204,9 +273,18 @@ interface ExtensionResourceInstanceOperations<
     ExtensionResourceUpdate<TResource, TProperties>,
     ExtensionResourceDelete<TResource> {}
 
+/**
+ * A composite interface for resource collections that include a paginated list operation.
+ * @template TResource The ArmResource that provides these operations
+ */
 interface ExtensionResourceCollectionOperations<TResource extends ArmResource>
   extends ExtensionResourceList<TResource> {}
 
+/**
+ * A composite interface for resources that include CRUD and list operations.
+ * @template TResource The ArmResource that provides these operations
+ * @template TProperties RP-specific property bag for the resource
+ */
 interface ExtensionResourceOperations<TResource extends ArmResource, TProperties extends object>
   extends ExtensionResourceInstanceOperations<TResource, TProperties>,
     ExtensionResourceCollectionOperations<TResource> {}