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
129 changes: 129 additions & 0 deletions sdk/resourcemanager/costmanagement/armcostmanagement/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,134 @@
# Release History

## 3.0.0 (2025-12-03)
### Breaking Changes

- Type of `Alert.ETag` has been changed from `*string` to `*azcore.ETag`
- Type of `Export.ETag` has been changed from `*string` to `*azcore.ETag`
- Type of `KpiProperties.Type` has been changed from `*KpiType` to `*KpiTypeType`
- Type of `OperationListResult.Value` has been changed from `[]*OperationForCostManagement` to `[]*Operation`
- Type of `PivotProperties.Type` has been changed from `*PivotType` to `*PivotTypeType`
- Type of `ScheduledAction.ETag` has been changed from `*string` to `*azcore.ETag`
- Type of `View.ETag` has been changed from `*string` to `*azcore.ETag`
- Enum `KpiType` has been removed
- Enum `PivotType` has been removed
- Function `*PriceSheetClient.BeginDownload` has been removed
- Operation `*AlertsClient.List` has supported pagination, use `*AlertsClient.NewListPager` instead.
- Operation `*ExportsClient.List` has supported pagination, use `*ExportsClient.NewListPager` instead.
- Struct `OperationForCostManagement` has been removed
- Field `DownloadURL` of struct `PriceSheetClientDownloadByBillingProfileResponse` has been removed

### Features Added

- New value `ExportTypeFocusCost`, `ExportTypePriceSheet`, `ExportTypeReservationDetails`, `ExportTypeReservationRecommendations`, `ExportTypeReservationTransactions` added to enum type `ExportType`
- New value `FormatTypeParquet` added to enum type `FormatType`
- New value `GranularityTypeMonthly` added to enum type `GranularityType`
- New value `TimeframeTypeTheCurrentMonth` added to enum type `TimeframeType`
- New enum type `BenefitUtilizationSummaryReportSchema` with values `BenefitUtilizationSummaryReportSchemaAvgUtilizationPercentage`, `BenefitUtilizationSummaryReportSchemaBenefitID`, `BenefitUtilizationSummaryReportSchemaBenefitOrderID`, `BenefitUtilizationSummaryReportSchemaBenefitType`, `BenefitUtilizationSummaryReportSchemaKind`, `BenefitUtilizationSummaryReportSchemaMaxUtilizationPercentage`, `BenefitUtilizationSummaryReportSchemaMinUtilizationPercentage`, `BenefitUtilizationSummaryReportSchemaUsageDate`, `BenefitUtilizationSummaryReportSchemaUtilizedPercentage`
- New enum type `BudgetNotificationOperatorType` with values `BudgetNotificationOperatorTypeEqualTo`, `BudgetNotificationOperatorTypeGreaterThan`, `BudgetNotificationOperatorTypeGreaterThanOrEqualTo`, `BudgetNotificationOperatorTypeLessThan`
- New enum type `BudgetOperatorType` with values `BudgetOperatorTypeIn`
- New enum type `CategoryType` with values `CategoryTypeCost`, `CategoryTypeReservationUtilization`
- New enum type `CompressionModeType` with values `CompressionModeTypeGzip`, `CompressionModeTypeNone`, `CompressionModeTypeSnappy`
- New enum type `CostAllocationPolicyType` with values `CostAllocationPolicyTypeFixedProportion`
- New enum type `CostAllocationResourceType` with values `CostAllocationResourceTypeDimension`, `CostAllocationResourceTypeTag`
- New enum type `CultureCode` with values `CultureCodeCsCz`, `CultureCodeDaDk`, `CultureCodeDeDe`, `CultureCodeEnGb`, `CultureCodeEnUs`, `CultureCodeEsEs`, `CultureCodeFrFr`, `CultureCodeHuHu`, `CultureCodeItIt`, `CultureCodeJaJp`, `CultureCodeKoKr`, `CultureCodeNbNo`, `CultureCodeNlNl`, `CultureCodePlPl`, `CultureCodePtBr`, `CultureCodePtPt`, `CultureCodeRuRu`, `CultureCodeSvSe`, `CultureCodeTrTr`, `CultureCodeZhCn`, `CultureCodeZhTw`
- New enum type `DataOverwriteBehaviorType` with values `DataOverwriteBehaviorTypeCreateNewReport`, `DataOverwriteBehaviorTypeOverwritePreviousReport`
- New enum type `DestinationType` with values `DestinationTypeAzureBlob`
- New enum type `FilterItemNames` with values `FilterItemNamesLookBackPeriod`, `FilterItemNamesReservationScope`, `FilterItemNamesResourceType`
- New enum type `Frequency` with values `FrequencyDaily`, `FrequencyMonthly`, `FrequencyWeekly`
- New enum type `KpiTypeType` with values `KpiTypeTypeBudget`, `KpiTypeTypeForecast`
- New enum type `PivotTypeType` with values `PivotTypeTypeDimension`, `PivotTypeTypeTagKey`
- New enum type `Reason` with values `ReasonAlreadyExists`, `ReasonInvalid`, `ReasonValid`
- New enum type `RuleStatus` with values `RuleStatusActive`, `RuleStatusNotActive`, `RuleStatusProcessing`
- New enum type `SettingType` with values `SettingTypeTaginheritance`
- New enum type `SettingsKind` with values `SettingsKindTaginheritance`
- New enum type `SystemAssignedServiceIdentityType` with values `SystemAssignedServiceIdentityTypeNone`, `SystemAssignedServiceIdentityTypeSystemAssigned`
- New enum type `ThresholdType` with values `ThresholdTypeActual`, `ThresholdTypeForecasted`
- New enum type `TimeGrainType` with values `TimeGrainTypeAnnually`, `TimeGrainTypeBillingAnnual`, `TimeGrainTypeBillingMonth`, `TimeGrainTypeBillingQuarter`, `TimeGrainTypeLast30Days`, `TimeGrainTypeLast7Days`, `TimeGrainTypeMonthly`, `TimeGrainTypeQuarterly`
- New function `NewBudgetsClient(credential azcore.TokenCredential, options *arm.ClientOptions) (*BudgetsClient, error)`
- New function `*BudgetsClient.CreateOrUpdate(ctx context.Context, scope string, budgetName string, parameters Budget, options *BudgetsClientCreateOrUpdateOptions) (BudgetsClientCreateOrUpdateResponse, error)`
- New function `*BudgetsClient.Delete(ctx context.Context, scope string, budgetName string, options *BudgetsClientDeleteOptions) (BudgetsClientDeleteResponse, error)`
- New function `*BudgetsClient.Get(ctx context.Context, scope string, budgetName string, options *BudgetsClientGetOptions) (BudgetsClientGetResponse, error)`
- New function `*BudgetsClient.NewListPager(scope string, options *BudgetsClientListOptions) *runtime.Pager[BudgetsClientListResponse]`
- New function `*ClientFactory.NewBudgetsClient() *BudgetsClient`
- New function `*ClientFactory.NewCostAllocationRulesClient() *CostAllocationRulesClient`
- New function `*ClientFactory.NewGenerateBenefitUtilizationSummariesReportClient() *GenerateBenefitUtilizationSummariesReportClient`
- New function `*ClientFactory.NewSettingsClient() *SettingsClient`
- New function `NewCostAllocationRulesClient(credential azcore.TokenCredential, options *arm.ClientOptions) (*CostAllocationRulesClient, error)`
- New function `*CostAllocationRulesClient.CheckNameAvailability(ctx context.Context, billingAccountID string, costAllocationRuleCheckNameAvailabilityRequest CostAllocationRuleCheckNameAvailabilityRequest, options *CostAllocationRulesClientCheckNameAvailabilityOptions) (CostAllocationRulesClientCheckNameAvailabilityResponse, error)`
- New function `*CostAllocationRulesClient.CreateOrUpdate(ctx context.Context, billingAccountID string, ruleName string, costAllocationRule CostAllocationRuleDefinition, options *CostAllocationRulesClientCreateOrUpdateOptions) (CostAllocationRulesClientCreateOrUpdateResponse, error)`
- New function `*CostAllocationRulesClient.Delete(ctx context.Context, billingAccountID string, ruleName string, options *CostAllocationRulesClientDeleteOptions) (CostAllocationRulesClientDeleteResponse, error)`
- New function `*CostAllocationRulesClient.Get(ctx context.Context, billingAccountID string, ruleName string, options *CostAllocationRulesClientGetOptions) (CostAllocationRulesClientGetResponse, error)`
- New function `*CostAllocationRulesClient.NewListPager(billingAccountID string, options *CostAllocationRulesClientListOptions) *runtime.Pager[CostAllocationRulesClientListResponse]`
- New function `NewGenerateBenefitUtilizationSummariesReportClient(credential azcore.TokenCredential, options *arm.ClientOptions) (*GenerateBenefitUtilizationSummariesReportClient, error)`
- New function `*GenerateBenefitUtilizationSummariesReportClient.BeginGenerateByBillingAccount(ctx context.Context, billingAccountID string, benefitUtilizationSummariesRequest BenefitUtilizationSummariesRequest, options *GenerateBenefitUtilizationSummariesReportClientBeginGenerateByBillingAccountOptions) (*runtime.Poller[GenerateBenefitUtilizationSummariesReportClientGenerateByBillingAccountResponse], error)`
- New function `*GenerateBenefitUtilizationSummariesReportClient.BeginGenerateByBillingProfile(ctx context.Context, billingAccountID string, billingProfileID string, benefitUtilizationSummariesRequest BenefitUtilizationSummariesRequest, options *GenerateBenefitUtilizationSummariesReportClientBeginGenerateByBillingProfileOptions) (*runtime.Poller[GenerateBenefitUtilizationSummariesReportClientGenerateByBillingProfileResponse], error)`
- New function `*GenerateBenefitUtilizationSummariesReportClient.BeginGenerateByReservationID(ctx context.Context, reservationOrderID string, reservationID string, benefitUtilizationSummariesRequest BenefitUtilizationSummariesRequest, options *GenerateBenefitUtilizationSummariesReportClientBeginGenerateByReservationIDOptions) (*runtime.Poller[GenerateBenefitUtilizationSummariesReportClientGenerateByReservationIDResponse], error)`
- New function `*GenerateBenefitUtilizationSummariesReportClient.BeginGenerateByReservationOrderID(ctx context.Context, reservationOrderID string, benefitUtilizationSummariesRequest BenefitUtilizationSummariesRequest, options *GenerateBenefitUtilizationSummariesReportClientBeginGenerateByReservationOrderIDOptions) (*runtime.Poller[GenerateBenefitUtilizationSummariesReportClientGenerateByReservationOrderIDResponse], error)`
- New function `*GenerateBenefitUtilizationSummariesReportClient.BeginGenerateBySavingsPlanID(ctx context.Context, savingsPlanOrderID string, savingsPlanID string, benefitUtilizationSummariesRequest BenefitUtilizationSummariesRequest, options *GenerateBenefitUtilizationSummariesReportClientBeginGenerateBySavingsPlanIDOptions) (*runtime.Poller[GenerateBenefitUtilizationSummariesReportClientGenerateBySavingsPlanIDResponse], error)`
- New function `*GenerateBenefitUtilizationSummariesReportClient.BeginGenerateBySavingsPlanOrderID(ctx context.Context, savingsPlanOrderID string, benefitUtilizationSummariesRequest BenefitUtilizationSummariesRequest, options *GenerateBenefitUtilizationSummariesReportClientBeginGenerateBySavingsPlanOrderIDOptions) (*runtime.Poller[GenerateBenefitUtilizationSummariesReportClientGenerateBySavingsPlanOrderIDResponse], error)`
- New function `*PriceSheetClient.BeginDownloadByBillingAccount(ctx context.Context, billingAccountID string, billingPeriodName string, options *PriceSheetClientBeginDownloadByBillingAccountOptions) (*runtime.Poller[PriceSheetClientDownloadByBillingAccountResponse], error)`
- New function `*PriceSheetClient.BeginDownloadByInvoice(ctx context.Context, billingAccountName string, billingProfileName string, invoiceName string, options *PriceSheetClientBeginDownloadByInvoiceOptions) (*runtime.Poller[PriceSheetClientDownloadByInvoiceResponse], error)`
- New function `*Setting.GetSetting() *Setting`
- New function `NewSettingsClient(credential azcore.TokenCredential, options *arm.ClientOptions) (*SettingsClient, error)`
- New function `*SettingsClient.CreateOrUpdateByScope(ctx context.Context, scope string, typeParam SettingType, setting SettingClassification, options *SettingsClientCreateOrUpdateByScopeOptions) (SettingsClientCreateOrUpdateByScopeResponse, error)`
- New function `*SettingsClient.DeleteByScope(ctx context.Context, scope string, typeParam SettingType, options *SettingsClientDeleteByScopeOptions) (SettingsClientDeleteByScopeResponse, error)`
- New function `*SettingsClient.GetByScope(ctx context.Context, scope string, typeParam SettingType, options *SettingsClientGetByScopeOptions) (SettingsClientGetByScopeResponse, error)`
- New function `*SettingsClient.NewListPager(scope string, options *SettingsClientListOptions) *runtime.Pager[SettingsClientListResponse]`
- New function `*TagInheritanceSetting.GetSetting() *Setting`
- New struct `AsyncOperationStatusProperties`
- New struct `BenefitUtilizationSummariesOperationStatus`
- New struct `BenefitUtilizationSummariesRequest`
- New struct `Budget`
- New struct `BudgetComparisonExpression`
- New struct `BudgetFilter`
- New struct `BudgetFilterProperties`
- New struct `BudgetProperties`
- New struct `BudgetTimePeriod`
- New struct `BudgetsListResult`
- New struct `CostAllocationProportion`
- New struct `CostAllocationRuleCheckNameAvailabilityRequest`
- New struct `CostAllocationRuleCheckNameAvailabilityResponse`
- New struct `CostAllocationRuleDefinition`
- New struct `CostAllocationRuleDetails`
- New struct `CostAllocationRuleList`
- New struct `CostAllocationRuleProperties`
- New struct `CurrentSpend`
- New struct `ExportRunRequest`
- New struct `ExportSuspensionContext`
- New struct `FilterItems`
- New struct `ForecastSpend`
- New struct `MCAPriceSheetProperties`
- New struct `Notification`
- New struct `Operation`
- New struct `PricesheetDownloadProperties`
- New struct `SettingsListResult`
- New struct `SourceCostAllocationResource`
- New struct `SystemAssignedServiceIdentity`
- New struct `TagInheritanceProperties`
- New struct `TagInheritanceSetting`
- New struct `TargetCostAllocationResource`
- New field `SystemData` in struct `Alert`
- New field `SystemData` in struct `BenefitRecommendationModel`
- New field `SystemData` in struct `BenefitUtilizationSummary`
- New field `CompressionMode`, `DataOverwriteBehavior`, `ExportDescription`, `SystemSuspensionContext` in struct `CommonExportProperties`
- New field `NextLink` in struct `DimensionsListResult`
- New field `Identity`, `Location`, `SystemData` in struct `Export`
- New field `DataVersion`, `Filters` in struct `ExportDatasetConfiguration`
- New field `Type` in struct `ExportDeliveryDestination`
- New field `CompressionMode`, `DataOverwriteBehavior`, `ExportDescription`, `SystemSuspensionContext` in struct `ExportProperties`
- New field `EndDate`, `ManifestFile`, `StartDate` in struct `ExportRunProperties`
- New field `Parameters` in struct `ExportsClientExecuteOptions`
- New field `AzureConsumptionAsyncOperation` in struct `GenerateDetailedCostReportClientCreateOperationResponse`
- New field `SystemData` in struct `GenerateDetailedCostReportOperationResult`
- New field `SystemData` in struct `GenerateDetailedCostReportOperationStatuses`
- New field `SystemData` in struct `IncludedQuantityUtilizationSummary`
- New anonymous field `PricesheetDownloadProperties` in struct `PriceSheetClientDownloadByBillingProfileResponse`
- New field `ODataEntityID` in struct `PriceSheetClientDownloadByBillingProfileResponse`
- New field `SystemData` in struct `SavingsPlanUtilizationSummary`
- New field `SystemData` in struct `View`


## 2.1.0 (2023-11-24)
### Features Added

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ This project uses [Go modules](https://github.com/golang/go/wiki/Modules) for ve
Install the Azure Costmanagement module:

```sh
go get github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/costmanagement/armcostmanagement/v2
go get github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/costmanagement/armcostmanagement/v3
```

## Authorization
Expand All @@ -36,7 +36,7 @@ For more information on authentication, please see the documentation for `aziden
Azure Costmanagement module consists of one or more clients. We provide a client factory which could be used to create any client in this module.

```go
clientFactory, err := armcostmanagement.NewClientFactory(<subscription ID>, cred, nil)
clientFactory, err := armcostmanagement.NewClientFactory(cred, nil)
```

You can use `ClientOptions` in package `github.com/Azure/azure-sdk-for-go/sdk/azcore/arm` to set endpoint to connect with public and sovereign clouds as well as Azure Stack. For more information, please see the documentation for `azcore` at [pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azcore](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azcore).
Expand All @@ -47,7 +47,7 @@ options := arm.ClientOptions {
Cloud: cloud.AzureChina,
},
}
clientFactory, err := armcostmanagement.NewClientFactory(<subscription ID>, cred, &options)
clientFactory, err := armcostmanagement.NewClientFactory(cred, &options)
```

## Clients
Expand Down
Loading
Loading