diff --git a/CHANGELOG.md b/CHANGELOG.md index 24e9a9759ba..9984ffcedf3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,10 @@ +Release v1.20.16 (2019-07-08) +=== + +### Service Client Updates +* `service/ce`: Updates service API and documentation +* `aws/endpoints`: Updated Regions and Endpoints metadata. + Release v1.20.15 (2019-07-03) === diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index 996c64cf2c3..214f8d8af25 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -2328,6 +2328,7 @@ var awsPartition = partition{ "ap-southeast-2": endpoint{}, "ca-central-1": endpoint{}, "eu-central-1": endpoint{}, + "eu-north-1": endpoint{}, "eu-west-1": endpoint{}, "eu-west-2": endpoint{}, "eu-west-3": endpoint{}, @@ -3759,6 +3760,13 @@ var awscnPartition = partition{ "cn-northwest-1": endpoint{}, }, }, + "license-manager": service{ + + Endpoints: endpoints{ + "cn-north-1": endpoint{}, + "cn-northwest-1": endpoint{}, + }, + }, "logs": service{ Endpoints: endpoints{ @@ -4406,6 +4414,12 @@ var awsusgovPartition = partition{ "us-gov-west-1": endpoint{}, }, }, + "ram": service{ + + Endpoints: endpoints{ + "us-gov-west-1": endpoint{}, + }, + }, "rds": service{ Endpoints: endpoints{ diff --git a/aws/version.go b/aws/version.go index b994f26177e..06211935975 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.20.15" +const SDKVersion = "1.20.16" diff --git a/models/apis/ce/2017-10-25/api-2.json b/models/apis/ce/2017-10-25/api-2.json index 8083d249052..910ebd4710c 100644 --- a/models/apis/ce/2017-10-25/api-2.json +++ b/models/apis/ce/2017-10-25/api-2.json @@ -116,6 +116,20 @@ {"shape":"InvalidNextTokenException"}, {"shape":"RequestChangedException"} ] + }, + "GetUsageForecast":{ + "name":"GetUsageForecast", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetUsageForecastRequest"}, + "output":{"shape":"GetUsageForecastResponse"}, + "errors":[ + {"shape":"LimitExceededException"}, + {"shape":"DataUnavailableException"}, + {"shape":"UnresolvableUsageUnitException"} + ] } }, "shapes":{ @@ -488,6 +502,28 @@ "TotalSize":{"shape":"PageSize"} } }, + "GetUsageForecastRequest":{ + "type":"structure", + "required":[ + "TimePeriod", + "Metric", + "Granularity" + ], + "members":{ + "TimePeriod":{"shape":"DateInterval"}, + "Metric":{"shape":"Metric"}, + "Granularity":{"shape":"Granularity"}, + "Filter":{"shape":"Expression"}, + "PredictionIntervalLevel":{"shape":"PredictionIntervalLevel"} + } + }, + "GetUsageForecastResponse":{ + "type":"structure", + "members":{ + "Total":{"shape":"MetricValue"}, + "ForecastResultsByTime":{"shape":"ForecastResultsByTime"} + } + }, "Granularity":{ "type":"string", "enum":[ @@ -812,6 +848,13 @@ "TotalPotentialRISavings":{"type":"string"}, "TotalRunningHours":{"type":"string"}, "TotalRunningNormalizedUnits":{"type":"string"}, + "UnresolvableUsageUnitException":{ + "type":"structure", + "members":{ + "Message":{"shape":"ErrorMessage"} + }, + "exception":true + }, "UnusedHours":{"type":"string"}, "UnusedUnits":{"type":"string"}, "UtilizationByTime":{ diff --git a/models/apis/ce/2017-10-25/docs-2.json b/models/apis/ce/2017-10-25/docs-2.json index a121dfa4db6..65a2890ef99 100644 --- a/models/apis/ce/2017-10-25/docs-2.json +++ b/models/apis/ce/2017-10-25/docs-2.json @@ -8,7 +8,8 @@ "GetReservationCoverage": "
Retrieves the reservation coverage for your account. This enables you to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service, or Amazon Redshift usage is covered by a reservation. An organization's master account can see the coverage of the associated member accounts. For any time period, you can filter data about reservation usage by the following dimensions:
AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
TAG
TENANCY
To determine valid values for a dimension, use the GetDimensionValues
operation.
Gets recommendations for which reservations to purchase. These recommendations could help you reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.
AWS generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After AWS has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of RI to purchase to maximize your estimated savings.
For example, AWS automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. AWS recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible RI. AWS also shows the equal number of normalized units so that you can purchase any instance size that you want. For this example, your RI recommendation would be for c4.large
because that is the smallest size instance in the c4 instance family.
Retrieves the reservation utilization for your account. Master accounts in an organization have access to member accounts. You can filter data by dimensions in a time period. You can use GetDimensionValues
to determine the possible dimension values. Currently, you can group only by SUBSCRIPTION_ID
.
Queries for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.
" + "GetTags": "Queries for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.
", + "GetUsageForecast": "Retrieves a forecast for how much Amazon Web Services predicts that you will use over the forecast time period that you select, based on your past usage.
" }, "shapes": { "AccountScope": { @@ -127,6 +128,7 @@ "GetReservationCoverageRequest$TimePeriod": "The start and end dates of the period that you want to retrieve data about reservation coverage for. You can retrieve data for a maximum of 13 months: the last 12 months and the current month. The start date is inclusive, but the end date is exclusive. For example, if start
is 2017-01-01
and end
is 2017-05-01
, then the cost and usage data is retrieved from 2017-01-01
up to and including 2017-04-30
but not including 2017-05-01
.
Sets the start and end dates for retrieving RI utilization. The start date is inclusive, but the end date is exclusive. For example, if start
is 2017-01-01
and end
is 2017-05-01
, then the cost and usage data is retrieved from 2017-01-01
up to and including 2017-04-30
but not including 2017-05-01
.
The start and end dates for retrieving the dimension values. The start date is inclusive, but the end date is exclusive. For example, if start
is 2017-01-01
and end
is 2017-05-01
, then the cost and usage data is retrieved from 2017-01-01
up to and including 2017-04-30
but not including 2017-05-01
.
The start and end dates of the period that you want to retrieve usage forecast for. The start date is inclusive, but the end date is exclusive. For example, if start
is 2017-01-01
and end
is 2017-05-01
, then the cost and usage data is retrieved from 2017-01-01
up to and including 2017-04-30
but not including 2017-05-01
.
The time period that the result covers.
", "UtilizationByTime$TimePeriod": "The period of time that this utilization was used for.
" } @@ -193,7 +195,8 @@ "DataUnavailableException$Message": null, "InvalidNextTokenException$Message": null, "LimitExceededException$Message": null, - "RequestChangedException$Message": null + "RequestChangedException$Message": null, + "UnresolvableUsageUnitException$Message": null } }, "Estimated": { @@ -210,7 +213,8 @@ "GetCostAndUsageRequest$Filter": "Filters AWS costs by different dimensions. For example, you can specify SERVICE
and LINKED_ACCOUNT
and get the costs that are associated with that account's usage of that service. You can nest Expression
objects to define any combination of dimension filters. For more information, see Expression.
The filters that you want to use to filter your forecast. Cost Explorer API supports all of the Cost Explorer filters.
", "GetReservationCoverageRequest$Filter": "Filters utilization data by dimensions. You can filter by the following dimensions:
AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
TAG
TENANCY
GetReservationCoverage
uses the same Expression object as the other operations, but only AND
is supported among each dimension. You can nest only one level deep. If there are multiple values for a dimension, they are OR'd together.
If you don't provide a SERVICE
filter, Cost Explorer defaults to EC2.
Filters utilization data by dimensions. You can filter by the following dimensions:
AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
SCOPE
TENANCY
GetReservationUtilization
uses the same Expression object as the other operations, but only AND
is supported among each dimension, and nesting is supported up to only one level deep. If there are multiple values for a dimension, they are OR'd together.
Filters utilization data by dimensions. You can filter by the following dimensions:
AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
SCOPE
TENANCY
GetReservationUtilization
uses the same Expression object as the other operations, but only AND
is supported among each dimension, and nesting is supported up to only one level deep. If there are multiple values for a dimension, they are OR'd together.
The filters that you want to use to filter your forecast. Cost Explorer API supports all of the Cost Explorer filters.
" } }, "Expressions": { @@ -229,7 +233,8 @@ "ForecastResultsByTime": { "base": null, "refs": { - "GetCostForecastResponse$ForecastResultsByTime": "The forecasts for your query, in order. For DAILY
forecasts, this is a list of days. For MONTHLY
forecasts, this is a list of months.
The forecasts for your query, in order. For DAILY
forecasts, this is a list of days. For MONTHLY
forecasts, this is a list of months.
The forecasts for your query, in order. For DAILY
forecasts, this is a list of days. For MONTHLY
forecasts, this is a list of months.
Sets the AWS cost granularity to MONTHLY
or DAILY
. If Granularity
isn't set, the response object doesn't include the Granularity
, either MONTHLY
or DAILY
.
The GetCostAndUsageRequest
operation supports only DAILY
and MONTHLY
granularities.
How granular you want the forecast to be. You can get 3 months of DAILY
forecasts or 12 months of MONTHLY
forecasts.
The GetCostForecast
operation supports only DAILY
and MONTHLY
granularities.
The granularity of the AWS cost data for the reservation. Valid values are MONTHLY
and DAILY
.
If GroupBy
is set, Granularity
can't be set. If Granularity
isn't set, the response object doesn't include Granularity
, either MONTHLY
or DAILY
.
The GetReservationCoverage
operation supports only DAILY
and MONTHLY
granularities.
If GroupBy
is set, Granularity
can't be set. If Granularity
isn't set, the response object doesn't include Granularity
, either MONTHLY
or DAILY
. If both GroupBy
and Granularity
aren't set, GetReservationUtilization
defaults to DAILY
.
The GetReservationUtilization
operation supports only DAILY
and MONTHLY
granularities.
If GroupBy
is set, Granularity
can't be set. If Granularity
isn't set, the response object doesn't include Granularity
, either MONTHLY
or DAILY
. If both GroupBy
and Granularity
aren't set, GetReservationUtilization
defaults to DAILY
.
The GetReservationUtilization
operation supports only DAILY
and MONTHLY
granularities.
How granular you want the forecast to be. You can get 3 months of DAILY
forecasts or 12 months of MONTHLY
forecasts.
The GetUsageForecast
operation supports only DAILY
and MONTHLY
granularities.
Which metric Cost Explorer uses to create your forecast. For more information about blended and unblended rates, see Why does the \"blended\" annotation appear on some line items in my bill?.
Valid values for a GetCostForecast
call are the following:
AmortizedCost
BlendedCost
NetAmortizedCost
NetUnblendedCost
UnblendedCost
Which metric Cost Explorer uses to create your forecast. For more information about blended and unblended rates, see Why does the \"blended\" annotation appear on some line items in my bill?.
Valid values for a GetCostForecast
call are the following:
AMORTIZED_COST
BLENDED_COST
NET_AMORTIZED_COST
NET_UNBLENDED_COST
UNBLENDED_COST
Which metric Cost Explorer uses to create your forecast.
Valid values for a GetUsageForecast
call are the following:
USAGE_QUANTITY
NORMALIZED_USAGE_AMOUNT
The aggregated value for a metric.
", "refs": { "GetCostForecastResponse$Total": "How much you are forecasted to spend over the forecast period, in USD
.
How much you're forecasted to use over the forecast period.
", "Metrics$value": null } }, @@ -580,7 +598,8 @@ "PredictionIntervalLevel": { "base": null, "refs": { - "GetCostForecastRequest$PredictionIntervalLevel": "Cost Explorer always returns the mean forecast as a single point. You can request a prediction interval around the mean by specifying a confidence level. The higher the confidence level, the more confident Cost Explorer is about the actual value falling in the prediction interval. Higher confidence levels result in wider prediction intervals.
" + "GetCostForecastRequest$PredictionIntervalLevel": "Cost Explorer always returns the mean forecast as a single point. You can request a prediction interval around the mean by specifying a confidence level. The higher the confidence level, the more confident Cost Explorer is about the actual value falling in the prediction interval. Higher confidence levels result in wider prediction intervals.
", + "GetUsageForecastRequest$PredictionIntervalLevel": "Cost Explorer always returns the mean forecast as a single point. You can request a prediction interval around the mean by specifying a confidence level. The higher the confidence level, the more confident Cost Explorer is about the actual value falling in the prediction interval. Higher confidence levels result in wider prediction intervals.
" } }, "PurchasedHours": { @@ -792,6 +811,11 @@ "CoverageNormalizedUnits$TotalRunningNormalizedUnits": "The total number of normalized units that you used.
" } }, + "UnresolvableUsageUnitException": { + "base": "Cost Explorer was unable to identify the usage unit. Provide UsageType/UsageTypeGroup
filter selections that contain matching units, for example: hours
.(