Skip to content

Commit f394460

Browse files
author
awstools
committed
feat(client-pricing): This release increases the MaxResults parameter of the GetAttributeValues API from 100 to 10000.
1 parent c34638a commit f394460

File tree

12 files changed

+115
-301
lines changed

12 files changed

+115
-301
lines changed

clients/client-pricing/README.md

Lines changed: 1 addition & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -6,35 +6,7 @@
66

77
AWS SDK for JavaScript Pricing Client for Node.js, Browser and React Native.
88

9-
<p>The Amazon Web Services Price List API is a centralized and convenient way to programmatically
10-
query Amazon Web Services for services, products, and pricing information. The Amazon Web Services Price List uses standardized product attributes such as <code>Location</code>,
11-
<code>Storage Class</code>, and <code>Operating System</code>, and provides prices at
12-
the SKU level. You can use the Amazon Web Services Price List to do the following:</p>
13-
<ul>
14-
<li>
15-
<p>Build cost control and scenario planning tools</p>
16-
</li>
17-
<li>
18-
<p>Reconcile billing data</p>
19-
</li>
20-
<li>
21-
<p>Forecast future spend for budgeting purposes</p>
22-
</li>
23-
<li>
24-
<p>Provide cost benefit analysis that compare your internal workloads with Amazon Web Services</p>
25-
</li>
26-
</ul>
27-
<p>Use <code>GetServices</code> without a service code to retrieve the service codes for
28-
all Amazon Web Services services, then <code>GetServices</code> with a service code to
29-
retrieve the attribute names for that service. After you have the service code and
30-
attribute names, you can use <code>GetAttributeValues</code> to see what values are
31-
available for an attribute. With the service code and an attribute name and value, you can
32-
use <code>GetProducts</code> to find specific products that you're interested in, such as
33-
an <code>AmazonEC2</code> instance, with a <code>Provisioned IOPS</code>
34-
<code>volumeType</code>.</p>
35-
<p>For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html">Using the
36-
Amazon Web Services Price List API</a> in the <i>Billing User
37-
Guide</i>.</p>
9+
<p>The Amazon Web Services Price List API is a centralized and convenient way to programmatically query Amazon Web Services for services, products, and pricing information. The Amazon Web Services Price List uses standardized product attributes such as <code>Location</code>, <code>Storage Class</code>, and <code>Operating System</code>, and provides prices at the SKU level. You can use the Amazon Web Services Price List to do the following:</p> <ul> <li> <p>Build cost control and scenario planning tools</p> </li> <li> <p>Reconcile billing data</p> </li> <li> <p>Forecast future spend for budgeting purposes</p> </li> <li> <p>Provide cost benefit analysis that compare your internal workloads with Amazon Web Services</p> </li> </ul> <p>Use <code>GetServices</code> without a service code to retrieve the service codes for all Amazon Web Services services, then <code>GetServices</code> with a service code to retrieve the attribute names for that service. After you have the service code and attribute names, you can use <code>GetAttributeValues</code> to see what values are available for an attribute. With the service code and an attribute name and value, you can use <code>GetProducts</code> to find specific products that you're interested in, such as an <code>AmazonEC2</code> instance, with a <code>Provisioned IOPS</code> <code>volumeType</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html">Using the Amazon Web Services Price List API</a> in the <i>Billing User Guide</i>.</p>
3810

3911
## Installing
4012

clients/client-pricing/src/Pricing.ts

Lines changed: 1 addition & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -180,35 +180,7 @@ export interface Pricing {
180180
}
181181

182182
/**
183-
* <p>The Amazon Web Services Price List API is a centralized and convenient way to programmatically
184-
* query Amazon Web Services for services, products, and pricing information. The Amazon Web Services Price List uses standardized product attributes such as <code>Location</code>,
185-
* <code>Storage Class</code>, and <code>Operating System</code>, and provides prices at
186-
* the SKU level. You can use the Amazon Web Services Price List to do the following:</p>
187-
* <ul>
188-
* <li>
189-
* <p>Build cost control and scenario planning tools</p>
190-
* </li>
191-
* <li>
192-
* <p>Reconcile billing data</p>
193-
* </li>
194-
* <li>
195-
* <p>Forecast future spend for budgeting purposes</p>
196-
* </li>
197-
* <li>
198-
* <p>Provide cost benefit analysis that compare your internal workloads with Amazon Web Services</p>
199-
* </li>
200-
* </ul>
201-
* <p>Use <code>GetServices</code> without a service code to retrieve the service codes for
202-
* all Amazon Web Services services, then <code>GetServices</code> with a service code to
203-
* retrieve the attribute names for that service. After you have the service code and
204-
* attribute names, you can use <code>GetAttributeValues</code> to see what values are
205-
* available for an attribute. With the service code and an attribute name and value, you can
206-
* use <code>GetProducts</code> to find specific products that you're interested in, such as
207-
* an <code>AmazonEC2</code> instance, with a <code>Provisioned IOPS</code>
208-
* <code>volumeType</code>.</p>
209-
* <p>For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html">Using the
210-
* Amazon Web Services Price List API</a> in the <i>Billing User
211-
* Guide</i>.</p>
183+
* <p>The Amazon Web Services Price List API is a centralized and convenient way to programmatically query Amazon Web Services for services, products, and pricing information. The Amazon Web Services Price List uses standardized product attributes such as <code>Location</code>, <code>Storage Class</code>, and <code>Operating System</code>, and provides prices at the SKU level. You can use the Amazon Web Services Price List to do the following:</p> <ul> <li> <p>Build cost control and scenario planning tools</p> </li> <li> <p>Reconcile billing data</p> </li> <li> <p>Forecast future spend for budgeting purposes</p> </li> <li> <p>Provide cost benefit analysis that compare your internal workloads with Amazon Web Services</p> </li> </ul> <p>Use <code>GetServices</code> without a service code to retrieve the service codes for all Amazon Web Services services, then <code>GetServices</code> with a service code to retrieve the attribute names for that service. After you have the service code and attribute names, you can use <code>GetAttributeValues</code> to see what values are available for an attribute. With the service code and an attribute name and value, you can use <code>GetProducts</code> to find specific products that you're interested in, such as an <code>AmazonEC2</code> instance, with a <code>Provisioned IOPS</code> <code>volumeType</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html">Using the Amazon Web Services Price List API</a> in the <i>Billing User Guide</i>.</p>
212184
* @public
213185
*/
214186
export class Pricing extends PricingClient implements Pricing {}

clients/client-pricing/src/PricingClient.ts

Lines changed: 1 addition & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -294,35 +294,7 @@ export type PricingClientResolvedConfigType = __SmithyResolvedConfiguration<__Ht
294294
export interface PricingClientResolvedConfig extends PricingClientResolvedConfigType {}
295295

296296
/**
297-
* <p>The Amazon Web Services Price List API is a centralized and convenient way to programmatically
298-
* query Amazon Web Services for services, products, and pricing information. The Amazon Web Services Price List uses standardized product attributes such as <code>Location</code>,
299-
* <code>Storage Class</code>, and <code>Operating System</code>, and provides prices at
300-
* the SKU level. You can use the Amazon Web Services Price List to do the following:</p>
301-
* <ul>
302-
* <li>
303-
* <p>Build cost control and scenario planning tools</p>
304-
* </li>
305-
* <li>
306-
* <p>Reconcile billing data</p>
307-
* </li>
308-
* <li>
309-
* <p>Forecast future spend for budgeting purposes</p>
310-
* </li>
311-
* <li>
312-
* <p>Provide cost benefit analysis that compare your internal workloads with Amazon Web Services</p>
313-
* </li>
314-
* </ul>
315-
* <p>Use <code>GetServices</code> without a service code to retrieve the service codes for
316-
* all Amazon Web Services services, then <code>GetServices</code> with a service code to
317-
* retrieve the attribute names for that service. After you have the service code and
318-
* attribute names, you can use <code>GetAttributeValues</code> to see what values are
319-
* available for an attribute. With the service code and an attribute name and value, you can
320-
* use <code>GetProducts</code> to find specific products that you're interested in, such as
321-
* an <code>AmazonEC2</code> instance, with a <code>Provisioned IOPS</code>
322-
* <code>volumeType</code>.</p>
323-
* <p>For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html">Using the
324-
* Amazon Web Services Price List API</a> in the <i>Billing User
325-
* Guide</i>.</p>
297+
* <p>The Amazon Web Services Price List API is a centralized and convenient way to programmatically query Amazon Web Services for services, products, and pricing information. The Amazon Web Services Price List uses standardized product attributes such as <code>Location</code>, <code>Storage Class</code>, and <code>Operating System</code>, and provides prices at the SKU level. You can use the Amazon Web Services Price List to do the following:</p> <ul> <li> <p>Build cost control and scenario planning tools</p> </li> <li> <p>Reconcile billing data</p> </li> <li> <p>Forecast future spend for budgeting purposes</p> </li> <li> <p>Provide cost benefit analysis that compare your internal workloads with Amazon Web Services</p> </li> </ul> <p>Use <code>GetServices</code> without a service code to retrieve the service codes for all Amazon Web Services services, then <code>GetServices</code> with a service code to retrieve the attribute names for that service. After you have the service code and attribute names, you can use <code>GetAttributeValues</code> to see what values are available for an attribute. With the service code and an attribute name and value, you can use <code>GetProducts</code> to find specific products that you're interested in, such as an <code>AmazonEC2</code> instance, with a <code>Provisioned IOPS</code> <code>volumeType</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html">Using the Amazon Web Services Price List API</a> in the <i>Billing User Guide</i>.</p>
326298
* @public
327299
*/
328300
export class PricingClient extends __Client<

clients/client-pricing/src/commands/DescribeServicesCommand.ts

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,7 @@ export interface DescribeServicesCommandInput extends DescribeServicesRequest {}
2727
export interface DescribeServicesCommandOutput extends DescribeServicesResponse, __MetadataBearer {}
2828

2929
/**
30-
* <p>Returns the metadata for one service or a list of the metadata for all services. Use
31-
* this without a service code to get the service codes for all services.
32-
* Use it with a service code, such as <code>AmazonEC2</code>, to get information specific to
33-
* that service, such as the attribute
34-
* names available for that service. For example, some of the attribute names available for EC2 are
35-
* <code>volumeType</code>, <code>maxIopsVolume</code>, <code>operation</code>,
36-
* <code>locationType</code>, and <code>instanceCapacity10xlarge</code>.</p>
30+
* <p>Returns the metadata for one service or a list of the metadata for all services. Use this without a service code to get the service codes for all services. Use it with a service code, such as <code>AmazonEC2</code>, to get information specific to that service, such as the attribute names available for that service. For example, some of the attribute names available for EC2 are <code>volumeType</code>, <code>maxIopsVolume</code>, <code>operation</code>, <code>locationType</code>, and <code>instanceCapacity10xlarge</code>.</p>
3731
* @example
3832
* Use a bare-bones client and the command you need to make an API call.
3933
* ```javascript
@@ -71,6 +65,9 @@ export interface DescribeServicesCommandOutput extends DescribeServicesResponse,
7165
* @see {@link DescribeServicesCommandOutput} for command's `response` shape.
7266
* @see {@link PricingClientResolvedConfig | config} for PricingClient's `config` shape.
7367
*
68+
* @throws {@link AccessDeniedException} (client fault)
69+
* <p>General authentication failure. The request wasn't signed correctly.</p>
70+
*
7471
* @throws {@link ExpiredNextTokenException} (client fault)
7572
* <p>The pagination token expired. Try again without a pagination token.</p>
7673
*
@@ -87,8 +84,7 @@ export interface DescribeServicesCommandOutput extends DescribeServicesResponse,
8784
* <p>The requested resource can't be found.</p>
8885
*
8986
* @throws {@link ThrottlingException} (client fault)
90-
* <p>You've made too many requests exceeding service quotas.
91-
* </p>
87+
* <p>You've made too many requests exceeding service quotas. </p>
9288
*
9389
* @throws {@link PricingServiceException}
9490
* <p>Base exception class for all service exceptions from Pricing service.</p>

clients/client-pricing/src/commands/GetAttributeValuesCommand.ts

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,7 @@ export interface GetAttributeValuesCommandInput extends GetAttributeValuesReques
2727
export interface GetAttributeValuesCommandOutput extends GetAttributeValuesResponse, __MetadataBearer {}
2828

2929
/**
30-
* <p>Returns a list of attribute values. Attributes are similar to the details
31-
* in a Price List API offer file. For a list of available attributes, see
32-
* <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/reading-an-offer.html#pps-defs">Offer File Definitions</a>
33-
* in the <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html">Billing and Cost Management User Guide</a>.</p>
30+
* <p>Returns a list of attribute values. Attributes are similar to the details in a Price List API offer file. For a list of available attributes, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/reading-an-offer.html#pps-defs">Offer File Definitions</a> in the <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html">Billing and Cost Management User Guide</a>.</p>
3431
* @example
3532
* Use a bare-bones client and the command you need to make an API call.
3633
* ```javascript
@@ -64,6 +61,9 @@ export interface GetAttributeValuesCommandOutput extends GetAttributeValuesRespo
6461
* @see {@link GetAttributeValuesCommandOutput} for command's `response` shape.
6562
* @see {@link PricingClientResolvedConfig | config} for PricingClient's `config` shape.
6663
*
64+
* @throws {@link AccessDeniedException} (client fault)
65+
* <p>General authentication failure. The request wasn't signed correctly.</p>
66+
*
6767
* @throws {@link ExpiredNextTokenException} (client fault)
6868
* <p>The pagination token expired. Try again without a pagination token.</p>
6969
*
@@ -80,8 +80,7 @@ export interface GetAttributeValuesCommandOutput extends GetAttributeValuesRespo
8080
* <p>The requested resource can't be found.</p>
8181
*
8282
* @throws {@link ThrottlingException} (client fault)
83-
* <p>You've made too many requests exceeding service quotas.
84-
* </p>
83+
* <p>You've made too many requests exceeding service quotas. </p>
8584
*
8685
* @throws {@link PricingServiceException}
8786
* <p>Base exception class for all service exceptions from Pricing service.</p>

clients/client-pricing/src/commands/GetPriceListFileUrlCommand.ts

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -27,14 +27,7 @@ export interface GetPriceListFileUrlCommandInput extends GetPriceListFileUrlRequ
2727
export interface GetPriceListFileUrlCommandOutput extends GetPriceListFileUrlResponse, __MetadataBearer {}
2828

2929
/**
30-
* <p>
31-
* <i>
32-
* <b>This feature is in preview release and is subject to change. Your use of Amazon Web Services Price List API is subject to the Beta Service Participation terms of the <a href="https://aws.amazon.com/service-terms/">Amazon Web Services Service Terms</a> (Section 1.10).</b>
33-
* </i>
34-
* </p>
35-
* <p>This returns the URL that you can retrieve your Price List file from. This URL is based
36-
* on the <code>PriceListArn</code> and <code>FileFormat</code> that you retrieve from the
37-
* <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html">ListPriceLists</a> response. </p>
30+
* <p> <i> <b>This feature is in preview release and is subject to change. Your use of Amazon Web Services Price List API is subject to the Beta Service Participation terms of the <a href="https://aws.amazon.com/service-terms/">Amazon Web Services Service Terms</a> (Section 1.10).</b> </i> </p> <p>This returns the URL that you can retrieve your Price List file from. This URL is based on the <code>PriceListArn</code> and <code>FileFormat</code> that you retrieve from the <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html">ListPriceLists</a> response. </p>
3831
* @example
3932
* Use a bare-bones client and the command you need to make an API call.
4033
* ```javascript
@@ -77,8 +70,7 @@ export interface GetPriceListFileUrlCommandOutput extends GetPriceListFileUrlRes
7770
* <p>The requested resource can't be found.</p>
7871
*
7972
* @throws {@link ThrottlingException} (client fault)
80-
* <p>You've made too many requests exceeding service quotas.
81-
* </p>
73+
* <p>You've made too many requests exceeding service quotas. </p>
8274
*
8375
* @throws {@link PricingServiceException}
8476
* <p>Base exception class for all service exceptions from Pricing service.</p>

clients/client-pricing/src/commands/GetProductsCommand.ts

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,9 @@ export interface GetProductsCommandOutput extends GetProductsResponse, __Metadat
6767
* @see {@link GetProductsCommandOutput} for command's `response` shape.
6868
* @see {@link PricingClientResolvedConfig | config} for PricingClient's `config` shape.
6969
*
70+
* @throws {@link AccessDeniedException} (client fault)
71+
* <p>General authentication failure. The request wasn't signed correctly.</p>
72+
*
7073
* @throws {@link ExpiredNextTokenException} (client fault)
7174
* <p>The pagination token expired. Try again without a pagination token.</p>
7275
*
@@ -83,8 +86,7 @@ export interface GetProductsCommandOutput extends GetProductsResponse, __Metadat
8386
* <p>The requested resource can't be found.</p>
8487
*
8588
* @throws {@link ThrottlingException} (client fault)
86-
* <p>You've made too many requests exceeding service quotas.
87-
* </p>
89+
* <p>You've made too many requests exceeding service quotas. </p>
8890
*
8991
* @throws {@link PricingServiceException}
9092
* <p>Base exception class for all service exceptions from Pricing service.</p>

0 commit comments

Comments
 (0)