[TSP Migration][cost-management] Migrate cost-management to TypeSpec

specification/cost-management/cspell.yaml

@@ -33,8 +33,14 @@ overrides:
     words:
       - unitof
   - filename: >-
-      **/specification/cost-management/resource-manager/Microsoft.CostManagement/CostManagement/stable/2025-03-01/costmanagement.pricesheets.json
+      **/specification/cost-management/resource-manager/Microsoft.CostManagement/CostManagement/stable/2025-03-01/openapi.json
     words:
       - unitofmeasure
       - unitof
-
+      - Unitof
+  - filename: >-
+      **/specification/cost-management/resource-manager/Microsoft.CostManagement/CostManagement/models.tsp
+    words:
+      - unitofmeasure
+      - unitof
+      - Unitof

specification/cost-management/resource-manager/Microsoft.CostManagement/CostManagement/Alert.tsp

@@ -0,0 +1,71 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.CostManagement;
+/**
+ * An individual alert.
+ */
+model Alert is Azure.ResourceManager.ExtensionResource<AlertProperties> {
+  ...ResourceNameParameter<
+    Resource = Alert,
+    KeyName = "alertId",
+    SegmentName = "alerts",
+    NamePattern = ""
+  >;
+
+  /**
+   * eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  eTag?: Azure.Core.eTag;
+}
+
+@armResourceOperations
+interface Alerts {
+  /**
+   * Gets the alert for the scope by alert ID.
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @externalDocs("https://docs.microsoft.com/en-us/rest/api/costmanagement/")
+  get is Extension.Read<Extension.ScopeParameter, Alert, Error = ErrorResponse>;
+
+  /**
+   * Dismisses the specified alert
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @patch(#{ implicitOptionality: false })
+  @externalDocs("https://docs.microsoft.com/en-us/rest/api/costmanagement/")
+  dismiss is Extension.CustomPatchSync<
+    Extension.ScopeParameter,
+    Alert,
+    PatchModel = DismissAlertPayload,
+    Error = ErrorResponse
+  >;
+
+  /**
+   * Lists the alerts for scope defined.
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @externalDocs("https://docs.microsoft.com/en-us/rest/api/costmanagement/")
+  list is Extension.ListByTarget<
+    Extension.ScopeParameter,
+    Alert,
+    Response = ArmResponse<AlertsResult>,
+    Error = ErrorResponse
+  >;
+}
+
+@@doc(Alert.name, "Alert ID");
+@@doc(Alert.properties, "Alert properties.");
+@@doc(Alerts.dismiss::parameters.properties,
+  "Parameters supplied to the Dismiss Alert operation."
+);
+@@path(Alert.name, #{ allowReserved: true });

specification/cost-management/resource-manager/Microsoft.CostManagement/CostManagement/Budget.tsp

@@ -0,0 +1,94 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.CostManagement;
+/**
+ * A budget resource.
+ */
+model Budget is Azure.ResourceManager.ExtensionResource<BudgetProperties> {
+  ...ResourceNameParameter<
+    Resource = Budget,
+    KeyName = "budgetName",
+    SegmentName = "budgets",
+    NamePattern = "^[a-zA-Z0-9_-]+$"
+  >;
+
+  /**
+   * eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  eTag?: Azure.Core.eTag;
+}
+
+@armResourceOperations
+interface Budgets {
+  /**
+   * Gets the budget for the scope by budget name.
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @externalDocs("https://docs.microsoft.com/en-us/rest/api/CostManagement/")
+  get is Extension.Read<
+    Extension.ScopeParameter,
+    Budget,
+    Error = ErrorResponse
+  >;
+
+  /**
+   * The operation to create or update a budget. You can optionally provide an eTag if desired as a form of concurrency control. To obtain the latest eTag for a given budget, perform a get operation prior to your put operation.
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @externalDocs("https://docs.microsoft.com/en-us/rest/api/CostManagement/")
+  createOrUpdate is Extension.CreateOrReplaceSync<
+    Extension.ScopeParameter,
+    Budget,
+    Error = ErrorResponse
+  >;
+
+  /**
+   * The operation to delete a budget.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @externalDocs("https://docs.microsoft.com/en-us/rest/api/CostManagement/")
+  delete is Extension.DeleteSync<
+    Extension.ScopeParameter,
+    Budget,
+    Response = ArmDeletedResponse,
+    Error = ErrorResponse
+  >;
+
+  /**
+   * Lists all budgets for the defined scope.
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @externalDocs("https://docs.microsoft.com/en-us/rest/api/CostManagement/")
+  list is Extension.ListByTarget<
+    Extension.ScopeParameter,
+    Budget,
+    Parameters = {
+      /**
+       * OData filter option. May be used to filter budgets by properties/category. The filter supports 'eq' only.
+       */
+      @query("$filter")
+      $filter?: string;
+    },
+    Response = ArmResponse<BudgetsListResult>,
+    Error = ErrorResponse
+  >;
+}
+
+@@maxLength(Budget.name, 63);
+@@minLength(Budget.name, 1);
+@@doc(Budget.name, "Budget Name.");
+@@doc(Budget.properties, "The properties of the budget.");
+@@doc(Budgets.createOrUpdate::parameters.resource,
+  "Parameters supplied to the Create Budget operation."
+);

specification/cost-management/resource-manager/Microsoft.CostManagement/CostManagement/CostAllocationRuleDefinition.tsp

@@ -0,0 +1,83 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.CostManagement;
+/**
+ * The cost allocation rule model definition
+ */
+@tenantResource
+model CostAllocationRuleDefinition
+  is Azure.ResourceManager.ProxyResource<CostAllocationRuleProperties> {
+  ...ResourceNameParameter<
+    Resource = CostAllocationRuleDefinition,
+    KeyName = "ruleName",
+    SegmentName = "costAllocationRules",
+    NamePattern = "[A-Za-z0-9\\-_]+"
+  >;
+}
+
+alias CostAllocationRuleDefinitionsOps = Extension.ExternalResource<
+  "microsoft.Billing",
+  "billingAccounts",
+  "billingAccountId",
+  Description = "BillingAccount ID",
+  ParentType = "Tenant"
+>;
+
+@armResourceOperations
+interface CostAllocationRuleDefinitions {
+  /**
+   * Get a cost allocation rule by rule name and billing account or enterprise enrollment.
+   */
+  get is Extension.Read<
+    CostAllocationRuleDefinitionsOps,
+    CostAllocationRuleDefinition,
+    Error = ErrorResponse
+  >;
+
+  /**
+   * Create/Update a rule to allocate cost between different resources within a billing account or enterprise enrollment.
+   */
+  createOrUpdate is Extension.CreateOrReplaceSync<
+    CostAllocationRuleDefinitionsOps,
+    CostAllocationRuleDefinition,
+    Error = ErrorResponse
+  >;
+
+  /**
+   * Delete cost allocation rule for billing account or enterprise enrollment.
+   */
+  delete is Extension.DeleteSync<
+    CostAllocationRuleDefinitionsOps,
+    CostAllocationRuleDefinition,
+    Error = ErrorResponse
+  >;
+
+  /**
+   * Get the list of all cost allocation rules for a billing account or enterprise enrollment.
+   */
+  list is Extension.ListByTarget<
+    CostAllocationRuleDefinitionsOps,
+    CostAllocationRuleDefinition,
+    Response = ArmResponse<CostAllocationRuleList>,
+    Error = ErrorResponse
+  >;
+}
+
+@@doc(CostAllocationRuleDefinition.name,
+  "Cost allocation rule name. The name cannot include spaces or any non alphanumeric characters other than '_' and '-'. The max length is 260 characters."
+);
+@@doc(CostAllocationRuleDefinition.properties,
+  "Cost allocation rule properties"
+);
+@@doc(CostAllocationRuleDefinitions.createOrUpdate::parameters.resource,
+  "Cost allocation rule to be created or updated"
+);

specification/cost-management/resource-manager/Microsoft.CostManagement/CostManagement/CostDetailsOperationResults.tsp

@@ -0,0 +1,69 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.CostManagement;
+// FIXME: CostDetailsOperationResults has no properties property
+/**
+ * The result of the long running operation for cost details Api.
+ */
+model CostDetailsOperationResults
+  is Azure.ResourceManager.ExtensionResource<never> {
+  ...ResourceNameParameter<
+    Resource = CostDetailsOperationResults,
+    KeyName = "operationId",
+    SegmentName = "costDetailsOperationResults",
+    NamePattern = ""
+  >;
+
+  /**
+   * The status of the cost details operation
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  status?: CostDetailsStatusType;
+
+  /**
+   * The manifest of the report generated by the operation.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  manifest?: ReportManifest;
+
+  /**
+   * The time at which report URL becomes invalid/expires in UTC e.g. 2020-12-08T05:55:59.4394737Z.
+   */
+  // FIXME: (utcDateTime) Please double check that this is the correct type for your scenario.
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  validTill?: utcDateTime;
+
+  /**
+   * The details of the error.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  error?: ErrorDetails;
+}
+
+@armResourceOperations
+interface GenerateCostDetailsReport {
+  /**
+   * Get the result of the specified operation. This link is provided in the CostDetails creation request response Location header.
+   */
+  #suppress "@azure-tools/typespec-client-generator-core/mark-as-lro-ineffective" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/lro-location-header" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @Azure.ClientGenerator.Core.Legacy.markAsLro
+  getOperationResults is Extension.Read<
+    Extension.ScopeParameter,
+    CostDetailsOperationResults,
+    Response = ArmResponse<CostDetailsOperationResults> | ArmAcceptedResponse,
+    Error = ErrorResponse
+  >;
+}
+
+@@doc(CostDetailsOperationResults.name, "The target operation Id.");