From cfe318beba82c1e5bda6a600f91de32cba814364 Mon Sep 17 00:00:00 2001 From: Jayati Tehri <72947097+jayati-tehri@users.noreply.github.com> Date: Fri, 18 Oct 2024 10:16:22 -0700 Subject: [PATCH] Add deprecation message and update documentation for missing properties (#31049) * add deprecation message * additional properties fixes * fixes to update property name * renaming * make text bold * add suppression * fix path * camelCase propertiy names to fix error * fix * build fixes * fix prettier * Update sdk-suppressions.yaml --------- Co-authored-by: Yuchao Yan --- cSpell.json | 14 +++++++++++++- .../2023-09-01/costmanagement.pricesheets.json | 15 ++++++++++----- .../2023-11-01/costmanagement.pricesheets.json | 17 +++++++++++------ .../resource-manager/sdk-suppressions.yaml | 1 + 4 files changed, 35 insertions(+), 12 deletions(-) diff --git a/cSpell.json b/cSpell.json index cc1518a8a13d..6cc60b88d7d5 100644 --- a/cSpell.json +++ b/cSpell.json @@ -1657,7 +1657,19 @@ ] }, { - "filename": "**/specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCIVM/**/*.json", + "filename": "**/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-09-01/costmanagement.pricesheets.json", + "words": [ + "Unitof" + ] + }, + { + "filename": "**/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-11-01/costmanagement.pricesheets.json", + "words": [ + "Unitof" + ] + }, + { + "filename": "**/specification/azurestackhci/resource-manager/Microsoft.AzureStackHCI/StackHCIVM/**/*.json", "words": [ "SEVSNP" ] diff --git a/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-09-01/costmanagement.pricesheets.json b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-09-01/costmanagement.pricesheets.json index 6fc5b82a582c..c0cc8c04bf8c 100644 --- a/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-09-01/costmanagement.pricesheets.json +++ b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-09-01/costmanagement.pricesheets.json @@ -171,7 +171,7 @@ "x-ms-long-running-operation-options": { "final-state-via": "location" }, - "description": "Generates the pricesheet for the provided billing period asynchronously based on the Enrollment ID. This is for Enterprise Agreement customers. \n You can use the new 2023-09-01 API version at '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download' for billing periods January 2023 onwards. With a new schema detailed below, the new price sheet provides more information and includes prices for Azure Reserved Instances (RI) for the current billing period.\n \n We recommend downloading an Azure Price Sheet for when entering a new billing period if you would maintain a record of past Azure Reserved Instance (RI) pricing. Due to Azure product growth, the Azure price sheet download experience in this preview version will be updated from a single .csv file to a zip file containing multiple csv files, each with max size of 75MB.", + "description": "Generates the pricesheet for the provided billing period asynchronously based on the Enrollment ID. This is for Enterprise Agreement customers.\n \n **Migrate to version 2023-09-01** \n\n You can use the 2023-09-01 API version with the new URI: \n\n '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download' \n\n With a new schema detailed below, the new version of the price sheet provides additional information and includes prices for Azure Reserved Instances (RI) for the current billing period. We recommend downloading an Azure Price Sheet for when entering a new billing period if you would maintain an ongoing record of past Azure Reserved Instance (RI) pricing.\n\n The EA Azure price sheet is available for billing periods in the past 13 months. To request a price sheet for a billing period older than 13 months, please contact support.\n\n The Azure price sheet download experience has been updated from a single .csv file to a zip file containing multiple .csv files, each with max size of 75MB. The 2023-09-01 version has been upgraded to use http POST method; details can be found below.\n\n All versions of the Microsoft.Consumption Azure Price Sheet - Download by Billing Account (including 2022-06-01, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01) are scheduled to be retired on 01 June 2026 and will no longer be supported after this date.", "parameters": [ { "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter" @@ -248,7 +248,7 @@ "readOnly": true }, "validTill": { - "description": "Download link validity.", + "description": "Download link validity. The URI is available for use for 1 hour.", "type": "string", "format": "date-time", "readOnly": true @@ -410,7 +410,7 @@ } }, "EAPriceSheetProperties": { - "description": "The properties of the EA price sheet.", + "description": "The properties of the EA price sheet. Properties supported with version 2023-09-01 as below", "type": "object", "properties": { "enrollmentNumber": { @@ -439,7 +439,7 @@ "readOnly": true }, "unitOfMeasure": { - "description": "How usage is measured for the service", + "description": "How usage is measured for the service. Note: The field “Unit” has been removed with version 2023-09-01 as a duplicate of “UnitofMeasure”, please use the field “UnitOfMeasure”. ", "type": "string", "readOnly": true }, @@ -458,6 +458,11 @@ "type": "string", "readOnly": true }, + "offerId": { + "description": "Determines the Azure offer associated with this meter. [Learn more about Azure offers] (https://azure.microsoft.com/en-us/support/legal/offer-details/)", + "type": "string", + "readOnly": true + }, "meterCategory": { "description": "Name of the classification category for the meter. For example, Cloud services, Networking, etc. ", "type": "string", @@ -491,7 +496,7 @@ "readOnly": true }, "basePrice": { - "description": "The unit price at the time the customer signs on or the unit price at the time of service meter GA launch if it is after sign-on.\n\n This is applicable for Enterprise Agreement users", + "description": "The unit price at the time the customer signs on or the unit price at the time of service meter GA launch if it is after sign-on. May appear as null or 0 where not applicable. Base price is unavailable for ReservedInstance meters. ", "type": "string", "readOnly": true }, diff --git a/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-11-01/costmanagement.pricesheets.json b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-11-01/costmanagement.pricesheets.json index d549402e69c2..ce78ad9ee9a4 100644 --- a/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-11-01/costmanagement.pricesheets.json +++ b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2023-11-01/costmanagement.pricesheets.json @@ -111,7 +111,7 @@ "x-ms-long-running-operation-options": { "final-state-via": "location" }, - "description": "Gets a URL to download the current month's pricesheet for a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.\n \n You can use the new 2023-09-01 API version for billing periods January 2023 onwards. Azure Reserved Instance (RI) pricing is only available through the new version of the API. \n \n Due to Azure product growth, the Azure price sheet download experience in this preview version will be updated from a single csv/json file to a Zip file containing multiple csv/json files, each with max size of 75MB.", + "description": "Gets a URL to download the current month's pricesheet for a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.\n \n You can use the new 2023-11-01 API version for billing periods January 2023 onwards. Azure Reserved Instance (RI) pricing is only available through the new version of the API. \n \n Due to Azure product growth, the Azure price sheet download experience in this preview version will be updated from a single csv/json file to a Zip file containing multiple csv/json files, each with max size of 75MB.", "parameters": [ { "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter" @@ -171,7 +171,7 @@ "x-ms-long-running-operation-options": { "final-state-via": "location" }, - "description": "Generates the pricesheet for the provided billing period asynchronously based on the Enrollment ID. This is for Enterprise Agreement customers. \n You can use the new 2023-09-01 API version at '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download' for billing periods January 2023 onwards. With a new schema detailed below, the new price sheet provides more information and includes prices for Azure Reserved Instances (RI) for the current billing period.\n \n We recommend downloading an Azure Price Sheet for when entering a new billing period if you would maintain a record of past Azure Reserved Instance (RI) pricing. Due to Azure product growth, the Azure price sheet download experience in this preview version will be updated from a single .csv file to a zip file containing multiple csv files, each with max size of 75MB.", + "description": "Generates the pricesheet for the provided billing period asynchronously based on the Enrollment ID. This is for Enterprise Agreement customers.\n \n **Migrate to version 2023-11-01** \n\n You can use the 2023-11-01 API version with the new URI: \n\n '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download' \n\n With a new schema detailed below, the new version of the price sheet provides additional information and includes prices for Azure Reserved Instances (RI) for the current billing period. We recommend downloading an Azure Price Sheet for when entering a new billing period if you would maintain an ongoing record of past Azure Reserved Instance (RI) pricing.\n\n The EA Azure price sheet is available for billing periods in the past 13 months. To request a price sheet for a billing period older than 13 months, please contact support.\n\n The Azure price sheet download experience has been updated from a single .csv file to a zip file containing multiple .csv files, each with max size of 75MB. The 2023-11-01 version has been upgraded to use http POST method; details can be found below.\n\n All versions of the Microsoft.Consumption Azure Price Sheet - Download by Billing Account (including 2022-06-01, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01) are scheduled to be retired on 01 June 2026 and will no longer be supported after this date.", "parameters": [ { "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter" @@ -248,7 +248,7 @@ "readOnly": true }, "validTill": { - "description": "Download link validity.", + "description": "Download link validity. The URI is available for use for 1 hour.", "type": "string", "format": "date-time", "readOnly": true @@ -410,7 +410,7 @@ } }, "EAPriceSheetProperties": { - "description": "The properties of the EA price sheet.", + "description": "The properties of the EA price sheet. Properties supported with version 2023-11-01 are as below", "type": "object", "properties": { "enrollmentNumber": { @@ -439,7 +439,7 @@ "readOnly": true }, "unitOfMeasure": { - "description": "How usage is measured for the service", + "description": "How usage is measured for the service. Note: The field “Unit” has been removed with version 2023-11-01 as a duplicate of “UnitofMeasure”, please use the field “UnitOfMeasure”. ", "type": "string", "readOnly": true }, @@ -458,6 +458,11 @@ "type": "string", "readOnly": true }, + "offerId": { + "description": "Determines the Azure offer associated with this meter. [Learn more about Azure offers] (https://azure.microsoft.com/en-us/support/legal/offer-details/)", + "type": "string", + "readOnly": true + }, "meterCategory": { "description": "Name of the classification category for the meter. For example, Cloud services, Networking, etc. ", "type": "string", @@ -491,7 +496,7 @@ "readOnly": true }, "basePrice": { - "description": "The unit price at the time the customer signs on or the unit price at the time of service meter GA launch if it is after sign-on.\n\n This is applicable for Enterprise Agreement users", + "description": "The unit price at the time the customer signs on or the unit price at the time of service meter GA launch if it is after sign-on. May appear as null or 0 where not applicable. Base price is unavailable for ReservedInstance meters. ", "type": "string", "readOnly": true }, diff --git a/specification/cost-management/resource-manager/sdk-suppressions.yaml b/specification/cost-management/resource-manager/sdk-suppressions.yaml index 23d2686cc0cb..a5d3642ede12 100644 --- a/specification/cost-management/resource-manager/sdk-suppressions.yaml +++ b/specification/cost-management/resource-manager/sdk-suppressions.yaml @@ -7,4 +7,5 @@ suppressions: azure-sdk-for-python: - package: azure-mgmt-costmanagement breaking-changes: + - Deleted or renamed method `PriceSheetOperations.begin_download` - Removed operation PriceSheetOperations.begin_download