@azure-tools/typespec-azure-resource-manager 0.71.0-dev.11 → 0.71.0-dev.13

package/lib/base-types/agent.tsp

@@ -56,7 +56,8 @@ internal model AgentDefinition {
 /**
  * Appliance deployment model of AgentDefinition.
  * Properties controlled by `@baseTypeOptional` are invisible when the corresponding
- * template parameter is false, or read-only when present.
+ * template parameter is false. When present, `instructions` is read-only while
+ * `modelDeploymentRef` stays writable so the client can point the agent at a model deployment.
  * @template HasModelDeploymentRef Whether the modelDeploymentRef property is present.
  * @template HasInstructions Whether the instructions property is present.
  */
@@ -72,8 +73,8 @@ model AgentDefinitionAppliance<
   @baseTypeOptional(HasInstructions, true)
   instructions: string;
 
-  /** Optional RP-specific reference to an underlying model deployment. */
-  @baseTypeOptional(HasModelDeploymentRef, true)
+  /** Optional RP-specific reference to an underlying model deployment. Writable in both deployment models. */
+  @baseTypeOptional(HasModelDeploymentRef, false)
   modelDeploymentRef?: string;
 }
 
@@ -125,7 +126,10 @@ internal model AgentProperties {
 
 /**
  * Appliance deployment model of AgentProperties.
- * All properties are read-only (the appliance owns and reports state).
+ * All properties are read-only (the appliance owns and reports state), except the `definition`
+ * container itself: it stays writable so the client can send the fields the agent definition
+ * marks as writable, such as `modelDeploymentRef`. Every service-owned field inside the
+ * definition remains read-only.
  * @template AgentDefinitionType The user-defined agent definition model (must extend AgentDefinition).
  */
 model AgentPropertiesAppliance<AgentDefinitionType extends AgentDefinition> {
@@ -141,8 +145,7 @@ model AgentPropertiesAppliance<AgentDefinitionType extends AgentDefinition> {
   @visibility(Lifecycle.Read)
   description: string;
 
-  /** Inline agent definition. */
-  @visibility(Lifecycle.Read)
+  /** Inline agent definition. The container is writable so the client can set the definition fields that are not service-owned. */
   definition: AgentDefinitionType;
 
   /** Tool bindings. Read-only in the Appliance deployment model. */

package/lib/common-types/billing-data.tsp

@@ -0,0 +1,211 @@
+using Azure.Core;
+using Versioning;
+
+namespace Azure.ResourceManager.CommonTypes;
+
+/**
+ * Billing Data
+ */
+@added(Versions.v6)
+model BillingData {
+  /**
+   * The system ID of the resource. Globally unique per cloud.
+   */
+  @visibility(Lifecycle.Read)
+  systemId?: uuid;
+
+  /**
+   * Indicates the billing state of the resource.
+   */
+  @visibility(Lifecycle.Read)
+  state?: BillingState = BillingState.Pending;
+
+  /**
+   * Indicates reason(s) for the current billing state of the resource.
+   */
+  @visibility(Lifecycle.Read)
+  reasons?: BillingStateReason[];
+
+  /**
+   * The product identifier referencing a product in the catalog.
+   */
+  productCode: uuid;
+
+  /**
+   * Product token (JWT) identifying a specific version of the product.
+   */
+  @visibility(Lifecycle.Create, Lifecycle.Update)
+  productToken?: string;
+
+  /**
+   * The number of instances of the product.
+   */
+  quantity: int64 = 1;
+
+  /**
+   * Start date indicating the beginning of the term for which the resource is committed.
+   */
+  startDate?: utcDateTime;
+
+  /**
+   * End date indicating the end of the term for which the resource is committed.
+   */
+  endDate?: utcDateTime;
+
+  /**
+   * Billing token (JWT) representing additional billing context.
+   */
+  @visibility(Lifecycle.Create, Lifecycle.Update)
+  billingToken?: string;
+
+  /**
+   * The resource's billing schedule.
+   */
+  schedule?: BillingSchedule;
+}
+
+/**
+ * Billing schedule.
+ */
+@added(Versions.v6)
+model BillingSchedule {
+  /**
+   * Indicates the renewal behavior of this resource.
+   */
+  renewal: BillingRenewalType = BillingRenewalType.Automatic;
+
+  /**
+   * Schedules billing changes for this resource.
+   */
+  changes?: BillingScheduleChange[];
+}
+
+/**
+ * Billing schedule change.
+ */
+@added(Versions.v6)
+model BillingScheduleChange {
+  /**
+   * Indicates when the change is expected to become effective.
+   */
+  effective: BillingScheduleChangeEffectiveType = BillingScheduleChangeEffectiveType.Renewal;
+
+  /**
+   * The absolute date when the change is expected to become effective. Required when `effective` = `AbsoluteDate`.
+   */
+  effectiveDate?: utcDateTime;
+
+  /**
+   * The kind of change.
+   */
+  kind: BillingScheduleChangeKind = BillingScheduleChangeKind.Update;
+
+  /**
+   * The new product identifier. When not specified, the resource's product code remains unchanged.
+   */
+  productCode?: uuid;
+
+  /**
+   * Product token (JWT) identifying a specific version of the scheduled product. Can only be
+   * specified when productCode is specified also.
+   */
+  @visibility(Lifecycle.Create, Lifecycle.Update)
+  productToken?: string;
+
+  /**
+   * The new number of instances of the product. When not specified, the resource's quantity remains unchanged.
+   */
+  quantity?: int64;
+
+  /**
+   * The new (coterminous) end date of the product. Can only be specified when effective = renewal.
+   * When not specified, the resource's end date is calculated based on the renewal date and the
+   * product's term duration.
+   */
+  endDate?: utcDateTime;
+
+  /**
+   * Billing token (JWT) representing additional billing context.
+   */
+  @visibility(Lifecycle.Create, Lifecycle.Update)
+  billingToken?: string;
+}
+
+/**
+ * Billing state.
+ */
+@added(Versions.v6)
+union BillingState {
+  /** Resource's billing has not yet started. */
+  Pending: "Pending",
+
+  /** Resource's billing is activate. */
+  Active: "Active",
+
+  /** Resource's billing is in a warning state. */
+  Warned: "Warned",
+
+  /** Resource's billing is inactive. */
+  Inactive: "Inactive",
+
+  string,
+}
+
+/**
+ * Billing state reason.
+ */
+@added(Versions.v6)
+union BillingStateReason {
+  /** Resource's billing has been suspended by Microsoft. */
+  Suspended: "Suspended",
+
+  /** Resource has been canceled by the customer. */
+  Canceled: "Canceled",
+
+  /** Resource's billing has expired. */
+  Expired: "Expired",
+
+  string,
+}
+
+/**
+ * Type of renewal.
+ */
+@added(Versions.v6)
+union BillingRenewalType {
+  /** Automatically renew the product when its term ends. */
+  Automatic: "Automatic",
+
+  /** Don't automatically renew the product. */
+  None: "None",
+
+  string,
+}
+
+/**
+ * When a scheduled change is expected to become effective.
+ */
+@added(Versions.v6)
+union BillingScheduleChangeEffectiveType {
+  /** At a specified date. */
+  AbsoluteDate: "AbsoluteDate",
+
+  /** At time of term renewal. */
+  Renewal: "Renewal",
+
+  string,
+}
+
+/**
+ * Type of scheduled change.
+ */
+@added(Versions.v6)
+union BillingScheduleChangeKind {
+  /** Update the resource. */
+  Update: "Update",
+
+  /** Cancel the resource. */
+  Cancel: "Cancel",
+
+  string,
+}

package/lib/common-types/common-types.tsp

@@ -12,5 +12,5 @@ import "./versions.tsp";
 import "./mobo-ref.tsp";
 import "./network-security-perimeter-ref.tsp";
 import "./nsp-operations.tsp";
-
+import "./billing-data.tsp";
 namespace Azure.ResourceManager.CommonTypes;

package/lib/models.tsp

@@ -452,4 +452,21 @@ model AvailabilityZonesProperty {
   zones?: string[];
 }
 
+/**
+ * Standard resource billing data property to represent the resource's current billing state.
+ * Spread this model directly into your resource property model when modeling e.g. prepaid resources.
+ *
+ * @example
+ *
+ * ```typespec
+ * model FooProperties {
+ *   ...BillingDataProperty,
+ * }
+ * ```
+ */
+model BillingDataProperty {
+  /** The billing data of the resource. */
+  billingData: CommonTypes.BillingData;
+}
+
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-azure-resource-manager",
-  "version": "0.71.0-dev.11",
+  "version": "0.71.0-dev.13",
   "author": "Microsoft Corporation",
   "description": "TypeSpec Azure Resource Manager library",
   "homepage": "https://azure.github.io/typespec-azure",
@@ -49,10 +49,10 @@
   "peerDependencies": {
     "@azure-tools/typespec-azure-core": "^0.70.0 || >= 0.71.0-dev.4",
     "@typespec/compiler": "^1.14.0",
-    "@typespec/http": "^1.14.0",
-    "@typespec/rest": "^0.84.0",
     "@typespec/openapi": "^1.14.0",
-    "@typespec/versioning": "^0.84.0"
+    "@typespec/versioning": "^0.84.0",
+    "@typespec/http": "^1.14.0",
+    "@typespec/rest": "^0.84.0"
   },
   "devDependencies": {
     "@azure-tools/typespec-azure-core": "^0.70.0 || >= 0.71.0-dev.4",
@@ -64,11 +64,11 @@
     "typescript": "~6.0.2",
     "vitest": "^4.1.3",
     "@typespec/compiler": "^1.14.0",
-    "@typespec/library-linter": "^0.84.0",
     "@typespec/http": "^1.14.0",
-    "@typespec/versioning": "^0.84.0",
     "@typespec/rest": "^0.84.0",
     "@typespec/tspd": "^0.76.0",
+    "@typespec/versioning": "^0.84.0",
+    "@typespec/library-linter": "^0.84.0",
     "@typespec/openapi": "^1.14.0"
   },
   "scripts": {