Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions sdk/consumption/azure-mgmt-consumption/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,18 @@
# Release History

## 11.1.0 (2026-08-17)

### Features Added

- Model `ReservationRecommendationDetailsProperties` added property `management_group_id`
- Model `ReservationRecommendationDetailsProperties` added property `projected_usage`
- Model `ReservationRecommendationDetailsProperties` added property `tenant_id`
- Enum `Scope` added member `MANAGEMENT_GROUP`
- Added model `LegacyManagementGroupScopeReservationRecommendationProperties`
- Added model `ModernManagementGroupScopeReservationRecommendationProperties`
- Added model `ReservationRecommendationDetailsProjectedUsageProperties`
- Operation group `ReservationRecommendationDetailsOperations` added parameter `management_group_id` in method `get`

## 11.0.0 (2026-07-20)

### Features Added
Expand Down
10 changes: 5 additions & 5 deletions sdk/consumption/azure-mgmt-consumption/_metadata.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
{
"apiVersion": "2024-08-01",
"apiVersion": "2026-06-01",
"apiVersions": {
"Microsoft.Consumption": "2024-08-01"
"Microsoft.Consumption": "2026-06-01"
},
"commit": "cf49df24bee763924bb4d9abceebe4fd1916a6ad",
"commit": "069ddc2a68bac3f5e5f51a9e3c4636a5316cade3",
"repository_url": "https://github.com/Azure/azure-rest-api-specs",
"typespec_src": "specification/consumption/resource-manager/Microsoft.Consumption/Consumption",
"emitterVersion": "0.63.3",
"httpClientPythonVersion": "^0.34.2"
"emitterVersion": "0.63.5",
"httpClientPythonVersion": "^0.36.0"
}
111 changes: 89 additions & 22 deletions sdk/consumption/azure-mgmt-consumption/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -386,12 +386,14 @@ namespace azure.mgmt.consumption.aio.operations
) -> None: ...

@distributed_trace_async
@api_version_validation(params_added_on={'2026-06-01': ['management_group_id']}, api_versions_list=['2024-08-01', '2026-06-01'])
async def get(
self,
resource_scope: str,
*,
filter: Optional[str] = ...,
look_back_period: Union[str, LookBackPeriod],
management_group_id: Optional[str] = ...,
product: str,
region: str,
scope: Union[str, Scope],
Expand Down Expand Up @@ -1080,6 +1082,34 @@ namespace azure.mgmt.consumption.models
usage_start: Optional[str]


class azure.mgmt.consumption.models.LegacyManagementGroupScopeReservationRecommendationProperties(LegacyReservationRecommendationProperties, discriminator='ManagementGroup'):
cost_with_no_reserved_instances: Decimal
first_usage_date: datetime
instance_flexibility_group: str
instance_flexibility_ratio: float
last_usage_date: datetime
look_back_period: str
management_group_id: str
meter_id: str
net_savings: Decimal
normalized_size: str
recommended_quantity: Decimal
recommended_quantity_normalized: float
resource_type: str
scope: Literal["ManagementGroup"]
sku_properties: list[SkuProperty]
tenant_id: str
term: str
total_cost_with_reserved_instances: Decimal
total_hours: int

@overload
def __init__(self) -> None: ...

@overload
def __init__(self, mapping: Mapping[str, Any]) -> None: ...


class azure.mgmt.consumption.models.LegacyReservationRecommendation(ReservationRecommendation, discriminator='legacy'):
etag: str
id: str
Expand Down Expand Up @@ -1530,6 +1560,36 @@ namespace azure.mgmt.consumption.models
usage_start: Optional[str]


class azure.mgmt.consumption.models.ModernManagementGroupScopeReservationRecommendationProperties(ModernReservationRecommendationProperties, discriminator='ManagementGroup'):
cost_with_no_reserved_instances: Amount
first_usage_date: datetime
instance_flexibility_group: str
instance_flexibility_ratio: float
last_usage_date: datetime
location: str
look_back_period: int
management_group_id: str
meter_id: str
net_savings: Amount
normalized_size: str
recommended_quantity: Decimal
recommended_quantity_normalized: float
resource_type: str
scope: Literal["ManagementGroup"]
sku_name: str
sku_properties: list[SkuProperty]
tenant_id: str
term: str
total_cost_with_reserved_instances: Amount
total_hours: int

@overload
def __init__(self) -> None: ...

@overload
def __init__(self, mapping: Mapping[str, Any]) -> None: ...


class azure.mgmt.consumption.models.ModernReservationRecommendation(ReservationRecommendation, discriminator='modern'):
etag: str
id: str
Expand Down Expand Up @@ -2074,12 +2134,19 @@ namespace azure.mgmt.consumption.models
) -> None: ...


class azure.mgmt.consumption.models.ReservationRecommendationDetailsProjectedUsageProperties(_Model):
total_retail_usage_in_c_us: Optional[float]


class azure.mgmt.consumption.models.ReservationRecommendationDetailsProperties(_Model):
currency: Optional[str]
management_group_id: Optional[str]
projected_usage: Optional[ReservationRecommendationDetailsProjectedUsageProperties]
resource: Optional[ReservationRecommendationDetailsResourceProperties]
resource_group: Optional[str]
savings: Optional[ReservationRecommendationDetailsSavingsProperties]
scope: Optional[str]
tenant_id: Optional[str]
usage: Optional[ReservationRecommendationDetailsUsageProperties]


Expand Down Expand Up @@ -2211,6 +2278,7 @@ namespace azure.mgmt.consumption.models


class azure.mgmt.consumption.models.Scope(str, Enum, metaclass=CaseInsensitiveEnumMeta):
MANAGEMENT_GROUP = "ManagementGroup"
SHARED = "Shared"
SINGLE = "Single"

Expand Down Expand Up @@ -2657,12 +2725,14 @@ namespace azure.mgmt.consumption.operations
) -> None: ...

@distributed_trace
@api_version_validation(params_added_on={'2026-06-01': ['management_group_id']}, api_versions_list=['2024-08-01', '2026-06-01'])
def get(
self,
resource_scope: str,
*,
filter: Optional[str] = ...,
look_back_period: Union[str, LookBackPeriod],
management_group_id: Optional[str] = ...,
product: str,
region: str,
scope: Union[str, Scope],
Expand Down Expand Up @@ -2851,11 +2921,11 @@ namespace azure.mgmt.consumption.types
key "properties": ForwardRef('BudgetProperties', module='types')
key "systemData": ForwardRef('SystemData', module='types')
key "type": str
e_tag: str
eTag: str
id: str
name: str
properties: BudgetProperties
system_data: SystemData
systemData: SystemData
type: str


Expand All @@ -2865,14 +2935,13 @@ namespace azure.mgmt.consumption.types
key "values": Required[list[str]]
name: str
operator: Union[str, BudgetOperatorType]
values_property: list[str]
values: list[str]


class azure.mgmt.consumption.types.BudgetFilter(TypedDict):
key "dimensions": ForwardRef('BudgetComparisonExpression', module='types')
key "tags": ForwardRef('BudgetComparisonExpression', module='types')
and: list[BudgetFilterProperties]
and_property: list[BudgetFilterProperties]
dimensions: BudgetComparisonExpression
tags: BudgetComparisonExpression

Expand All @@ -2894,19 +2963,19 @@ namespace azure.mgmt.consumption.types
key "timePeriod": Required[BudgetTimePeriod]
amount: float
category: Union[str, CategoryType]
current_spend: CurrentSpend
currentSpend: CurrentSpend
filter: BudgetFilter
forecast_spend: ForecastSpend
forecastSpend: ForecastSpend
notifications: dict[str, Notification]
time_grain: Union[str, TimeGrainType]
time_period: BudgetTimePeriod
timeGrain: Union[str, TimeGrainType]
timePeriod: BudgetTimePeriod


class azure.mgmt.consumption.types.BudgetTimePeriod(TypedDict, total=False):
key "endDate": str
key "startDate": Required[str]
end_date: str
start_date: str
endDate: str
startDate: str


class azure.mgmt.consumption.types.CurrentSpend(TypedDict, total=False):
Expand All @@ -2923,7 +2992,7 @@ namespace azure.mgmt.consumption.types
key "type": str
id: str
name: str
system_data: SystemData
systemData: SystemData
type: str


Expand All @@ -2941,16 +3010,14 @@ namespace azure.mgmt.consumption.types
key "operator": Required[Union[str, OperatorType]]
key "threshold": Required[float]
key "thresholdType": Union[str, ThresholdType]
contactEmails: list[str]
contactGroups: list[str]
contactRoles: list[str]
contact_emails: list[str]
contact_groups: list[str]
contact_roles: list[str]
enabled: bool
locale: Union[str, CultureCode]
operator: Union[str, OperatorType]
threshold: float
threshold_type: Union[str, ThresholdType]
thresholdType: Union[str, ThresholdType]


class azure.mgmt.consumption.types.Resource(TypedDict, total=False):
Expand All @@ -2960,7 +3027,7 @@ namespace azure.mgmt.consumption.types
key "type": str
id: str
name: str
system_data: SystemData
systemData: SystemData
type: str


Expand All @@ -2971,12 +3038,12 @@ namespace azure.mgmt.consumption.types
key "lastModifiedAt": str
key "lastModifiedBy": str
key "lastModifiedByType": Union[str, CreatedByType]
created_at: str
created_by: str
created_by_type: Union[str, CreatedByType]
last_modified_at: str
last_modified_by: str
last_modified_by_type: Union[str, CreatedByType]
createdAt: str
createdBy: str
createdByType: Union[str, CreatedByType]
lastModifiedAt: str
lastModifiedBy: str
lastModifiedByType: Union[str, CreatedByType]


```
4 changes: 2 additions & 2 deletions sdk/consumption/azure-mgmt-consumption/api.metadata.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
apiMdSha256: 23a638a77b22f3c78142f262c0d789b16a0153c9fe719b1e9ac21873153a9251
parserVersion: 0.3.28
apiMdSha256: 6b5aec58eae9255676978940bd7eadbd6dd0a052d371fda42707164956c80363
parserVersion: 0.3.31
pythonVersion: 3.13.14
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,10 @@
"azure.mgmt.consumption.models.HighCasedErrorResponse": "Microsoft.Consumption.HighCasedErrorResponse",
"azure.mgmt.consumption.models.LegacyChargeSummary": "Microsoft.Consumption.LegacyChargeSummary",
"azure.mgmt.consumption.models.LegacyChargeSummaryProperties": "Microsoft.Consumption.LegacyChargeSummaryProperties",
"azure.mgmt.consumption.models.LegacyReservationRecommendationProperties": "Microsoft.Consumption.LegacyReservationRecommendationProperties",
"azure.mgmt.consumption.models.LegacyManagementGroupScopeReservationRecommendationProperties": "Microsoft.Consumption.LegacyManagementGroupScopeReservationRecommendationProperties",
"azure.mgmt.consumption.models.ReservationRecommendation": "Microsoft.Consumption.ReservationRecommendation",
"azure.mgmt.consumption.models.LegacyReservationRecommendation": "Microsoft.Consumption.LegacyReservationRecommendation",
"azure.mgmt.consumption.models.LegacyReservationRecommendationProperties": "Microsoft.Consumption.LegacyReservationRecommendationProperties",
"azure.mgmt.consumption.models.LegacyReservationTransactionProperties": "Microsoft.Consumption.LegacyReservationTransactionProperties",
"azure.mgmt.consumption.models.LegacySharedScopeReservationRecommendationProperties": "Microsoft.Consumption.LegacySharedScopeReservationRecommendationProperties",
"azure.mgmt.consumption.models.LegacySingleScopeReservationRecommendationProperties": "Microsoft.Consumption.LegacySingleScopeReservationRecommendationProperties",
Expand All @@ -51,8 +52,9 @@
"azure.mgmt.consumption.models.MeterDetailsResponse": "Microsoft.Consumption.MeterDetailsResponse",
"azure.mgmt.consumption.models.ModernChargeSummary": "Microsoft.Consumption.ModernChargeSummary",
"azure.mgmt.consumption.models.ModernChargeSummaryProperties": "Microsoft.Consumption.ModernChargeSummaryProperties",
"azure.mgmt.consumption.models.ModernReservationRecommendation": "Microsoft.Consumption.ModernReservationRecommendation",
"azure.mgmt.consumption.models.ModernReservationRecommendationProperties": "Microsoft.Consumption.ModernReservationRecommendationProperties",
"azure.mgmt.consumption.models.ModernManagementGroupScopeReservationRecommendationProperties": "Microsoft.Consumption.ModernManagementGroupScopeReservationRecommendationProperties",
"azure.mgmt.consumption.models.ModernReservationRecommendation": "Microsoft.Consumption.ModernReservationRecommendation",
"azure.mgmt.consumption.models.ModernReservationTransaction": "Microsoft.Consumption.ModernReservationTransaction",
"azure.mgmt.consumption.models.ModernReservationTransactionProperties": "Microsoft.Consumption.ModernReservationTransactionProperties",
"azure.mgmt.consumption.models.ModernSharedScopeReservationRecommendationProperties": "Microsoft.Consumption.ModernSharedScopeReservationRecommendationProperties",
Expand All @@ -72,6 +74,7 @@
"azure.mgmt.consumption.models.ReservationDetailProperties": "Microsoft.Consumption.ReservationDetailProperties",
"azure.mgmt.consumption.models.ReservationRecommendationDetailsCalculatedSavingsProperties": "Microsoft.Consumption.ReservationRecommendationDetailsCalculatedSavingsProperties",
"azure.mgmt.consumption.models.ReservationRecommendationDetailsModel": "Microsoft.Consumption.ReservationRecommendationDetailsModel",
"azure.mgmt.consumption.models.ReservationRecommendationDetailsProjectedUsageProperties": "Microsoft.Consumption.ReservationRecommendationDetailsProjectedUsageProperties",
"azure.mgmt.consumption.models.ReservationRecommendationDetailsProperties": "Microsoft.Consumption.ReservationRecommendationDetailsProperties",
"azure.mgmt.consumption.models.ReservationRecommendationDetailsResourceProperties": "Microsoft.Consumption.ReservationRecommendationDetailsResourceProperties",
"azure.mgmt.consumption.models.ReservationRecommendationDetailsSavingsProperties": "Microsoft.Consumption.ReservationRecommendationDetailsSavingsProperties",
Expand Down Expand Up @@ -172,5 +175,5 @@
"azure.mgmt.consumption.operations.LotsOperations.list_by_customer": "Microsoft.Consumption.LotsOperationGroup.listByCustomer",
"azure.mgmt.consumption.aio.operations.LotsOperations.list_by_customer": "Microsoft.Consumption.LotsOperationGroup.listByCustomer"
},
"CrossLanguageVersion": "6d59b39f8eeb"
"CrossLanguageVersion": "4cef19d23bc5"
}
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
# pylint: disable=line-too-long,useless-suppression
# coding=utf-8
# --------------------------------------------------------------------------
# Copyright (c) Microsoft Corporation. All rights reserved.
Expand Down Expand Up @@ -49,7 +50,7 @@
from azure.core.credentials import TokenCredential


class ConsumptionManagementClient: # pylint: disable=too-many-instance-attributes
class ConsumptionManagementClient: # pylint: disable=too-many-instance-attributes,docstring-keyword-should-match-keyword-only
"""Consumption management client provides access to consumption resources for Azure Enterprise
Subscriptions.

Expand Down Expand Up @@ -100,7 +101,7 @@ class ConsumptionManagementClient: # pylint: disable=too-many-instance-attribut
:keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
None.
:paramtype cloud_setting: ~azure.core.AzureClouds
:keyword api_version: The API version to use for this operation. Known values are "2024-08-01"
:keyword api_version: The API version to use for this operation. Known values are "2026-06-01"
and None. Default value is None. If not set, the operation's default API version will be used.
Note that overriding this default value may result in unsupported behavior.
:paramtype api_version: str
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
# pylint: disable=line-too-long,useless-suppression
# coding=utf-8
# --------------------------------------------------------------------------
# Copyright (c) Microsoft Corporation. All rights reserved.
Expand All @@ -18,7 +19,7 @@
from azure.core.credentials import TokenCredential


class ConsumptionManagementClientConfiguration: # pylint: disable=too-many-instance-attributes
class ConsumptionManagementClientConfiguration: # pylint: disable=too-many-instance-attributes,docstring-keyword-should-match-keyword-only
"""Configuration for ConsumptionManagementClient.

Note that all parameters used to create this instance are saved as instance
Expand All @@ -33,7 +34,7 @@ class ConsumptionManagementClientConfiguration: # pylint: disable=too-many-inst
:param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
None.
:type cloud_setting: ~azure.core.AzureClouds
:keyword api_version: The API version to use for this operation. Known values are "2024-08-01"
:keyword api_version: The API version to use for this operation. Known values are "2026-06-01"
and None. Default value is None. If not set, the operation's default API version will be used.
Note that overriding this default value may result in unsupported behavior.
Comment thread
ChenxiJiang333 marked this conversation as resolved.
Resolved
:paramtype api_version: str
Expand All @@ -47,7 +48,7 @@ def __init__(
cloud_setting: Optional["AzureClouds"] = None,
**kwargs: Any
) -> None:
api_version: str = kwargs.pop("api_version", "2024-08-01")
api_version: str = kwargs.pop("api_version", "2026-06-01")

if credential is None:
raise ValueError("Parameter 'credential' must not be None.")
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@
Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize
"""


__all__: list[str] = [] # Add all objects you want publicly available to users at this package level


Expand Down
Loading
Loading