Skip to content

Commit 1be3813

Browse files
authored
[Hub Generated] Review request for Microsoft.Consumption to add version stable/2019-10-01 (#12347)
* Fixed various Swagger Correctness issues * removed readonly property from ThresholdType * added default value to ThresholdType to fix error * updated ContactEmails/ContactGroups and Forecasts * fixed descriptions & examples. removed extra field * added missing "properties/" to example * updated contactGroups description * reformatted description
1 parent 5dd055d commit 1be3813

File tree

3 files changed

+11
-10
lines changed

3 files changed

+11
-10
lines changed

specification/consumption/resource-manager/Microsoft.Consumption/stable/2019-10-01/consumption.json

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -344,7 +344,7 @@
344344
"Budgets"
345345
],
346346
"operationId": "Budgets_CreateOrUpdate",
347-
"description": "The operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.",
347+
"description": "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.",
348348
"externalDocs": {
349349
"url": "https://docs.microsoft.com/en-us/rest/api/consumption/"
350350
},
@@ -1421,7 +1421,7 @@
14211421
],
14221422
"x-ms-odata": "#/definitions/Forecast",
14231423
"operationId": "Forecasts_List",
1424-
"description": "Lists the forecast charges by subscriptionId.",
1424+
"description": "Lists the forecast charges for scope defined. Please note that this API is no longer actively under development. We recommend using our new Forecast API moving forward: https://docs.microsoft.com/en-us/rest/api/cost-management/forecast/usage.",
14251425
"externalDocs": {
14261426
"url": "https://docs.microsoft.com/en-us/rest/api/consumption/"
14271427
},
@@ -3887,7 +3887,7 @@
38873887
"$ref": "#/definitions/BudgetTimePeriod"
38883888
},
38893889
"filter": {
3890-
"description": "May be used to filter budgets by resource group, resource, or meter.",
3890+
"description": "May be used to filter budgets by user-specified dimensions and/or tags.",
38913891
"type": "object",
38923892
"$ref": "#/definitions/BudgetFilter"
38933893
},
@@ -4044,12 +4044,12 @@
40444044
"format": "decimal"
40454045
},
40464046
"contactEmails": {
4047-
"description": "Email addresses to send the budget notification to when the threshold is exceeded.",
4047+
"description": "Email addresses to send the budget notification to when the threshold is exceeded. Must have at least one contact email or contact group specified at the Subscription or Resource Group scopes. All other scopes must have at least one contact email specified.",
40484048
"type": "array",
40494049
"items": {
40504050
"type": "string"
40514051
},
4052-
"minItems": 1,
4052+
"minItems": 0,
40534053
"maxItems": 50
40544054
},
40554055
"contactRoles": {
@@ -4060,7 +4060,7 @@
40604060
}
40614061
},
40624062
"contactGroups": {
4063-
"description": "Action groups to send the budget notification to when the threshold is exceeded.",
4063+
"description": "Action groups to send the budget notification to when the threshold is exceeded. Must be provided as a fully qualified Azure resource id. Only supported at Subscription or Resource Group scopes.",
40644064
"type": "array",
40654065
"items": {
40664066
"type": "string"
@@ -4077,7 +4077,8 @@
40774077
"x-ms-enum": {
40784078
"name": "ThresholdType",
40794079
"modelAsString": true
4080-
}
4080+
},
4081+
"default": "Actual"
40814082
}
40824083
},
40834084
"required": [
@@ -4214,7 +4215,7 @@
42144215
"readOnly": true
42154216
},
42164217
"grain": {
4217-
"description": "The granularity of forecast.",
4218+
"description": "The granularity of forecast. Please note that Yearly is not currently supported in this API. The API will provide responses in the Monthly grain if Yearly is selected. To get yearly grain data, please use our newer Forecast API.",
42184219
"type": "string",
42194220
"enum": [
42204221
"Daily",

specification/consumption/resource-manager/Microsoft.Consumption/stable/2019-10-01/examples/ForecastsListFilterByDates.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"parameters": {
33
"api-version": "2019-10-01",
44
"subscriptionId": "00000000-0000-0000-0000-000000000000",
5-
"$filter": "usagedate ge '2018-04-01' AND usagedate le '2018-04-02'"
5+
"$filter": "properties/usagedate ge '2018-04-01' AND properties/usagedate le '2018-04-02'"
66
},
77
"responses": {
88
"200": {

specification/consumption/resource-manager/Microsoft.Consumption/stable/2019-10-01/examples/ForecastsListFilterByGrain.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"parameters": {
33
"api-version": "2019-10-01",
44
"subscriptionId": "00000000-0000-0000-0000-000000000000",
5-
"$filter": "Grain eq 'Monthly'"
5+
"$filter": "properties/Grain eq 'Monthly'"
66
},
77
"responses": {
88
"200": {

0 commit comments

Comments
 (0)