aws-sdk-marketplacemetering 1.38.0 → 1.43.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +25 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-marketplacemetering/client.rb +101 -42
- data/lib/aws-sdk-marketplacemetering/client_api.rb +2 -0
- data/lib/aws-sdk-marketplacemetering/types.rb +89 -68
- data/lib/aws-sdk-marketplacemetering.rb +1 -1
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 755218de5f1b120c0a61502a01750666cc07a7a8edc5af7e7313b736c2eca2ad
|
4
|
+
data.tar.gz: e218f8d49b902ad28d5f2e03fa2247be1defe14c0f029f42ac1d9d7c330ddc6a
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 4537f5d577576220eed7ffd66b645639055cd9d86e626e5d714b20f98f61aec470c483bfc397e62d6273b1ab02d631405c4f1ed6a5a14fb941b9429ea7976454
|
7
|
+
data.tar.gz: 96d8ddc4edc2d82e4904e945aca3420ac599ae08ab2fb1e7ab4f3798e9005aa67f71ea39e00da90befc671a1ed2c1fa3efbf889bdf10953f5efba9f7d5a0fd7f
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,31 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.43.0 (2022-02-03)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Add CustomerAWSAccountId to ResolveCustomer API response and increase UsageAllocation limit to 2500.
|
8
|
+
|
9
|
+
1.42.0 (2022-02-03)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Add CustomerAWSAccountId to ResolveCustomer API response and increase UsageAllocation limit to 2500.
|
13
|
+
|
14
|
+
1.41.0 (2021-12-21)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
18
|
+
|
19
|
+
1.40.0 (2021-11-30)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
23
|
+
|
24
|
+
1.39.0 (2021-11-04)
|
25
|
+
------------------
|
26
|
+
|
27
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
28
|
+
|
4
29
|
1.38.0 (2021-10-18)
|
5
30
|
------------------
|
6
31
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.43.0
|
@@ -27,6 +27,8 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
|
|
27
27
|
require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
|
28
28
|
require 'aws-sdk-core/plugins/transfer_encoding.rb'
|
29
29
|
require 'aws-sdk-core/plugins/http_checksum.rb'
|
30
|
+
require 'aws-sdk-core/plugins/defaults_mode.rb'
|
31
|
+
require 'aws-sdk-core/plugins/recursion_detection.rb'
|
30
32
|
require 'aws-sdk-core/plugins/signature_v4.rb'
|
31
33
|
require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
|
32
34
|
|
@@ -73,6 +75,8 @@ module Aws::MarketplaceMetering
|
|
73
75
|
add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
|
74
76
|
add_plugin(Aws::Plugins::TransferEncoding)
|
75
77
|
add_plugin(Aws::Plugins::HttpChecksum)
|
78
|
+
add_plugin(Aws::Plugins::DefaultsMode)
|
79
|
+
add_plugin(Aws::Plugins::RecursionDetection)
|
76
80
|
add_plugin(Aws::Plugins::SignatureV4)
|
77
81
|
add_plugin(Aws::Plugins::Protocols::JsonRpc)
|
78
82
|
|
@@ -119,7 +123,9 @@ module Aws::MarketplaceMetering
|
|
119
123
|
# * EC2/ECS IMDS instance profile - When used by default, the timeouts
|
120
124
|
# are very aggressive. Construct and pass an instance of
|
121
125
|
# `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
|
122
|
-
# enable retries and extended timeouts.
|
126
|
+
# enable retries and extended timeouts. Instance profile credential
|
127
|
+
# fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
|
128
|
+
# to true.
|
123
129
|
#
|
124
130
|
# @option options [required, String] :region
|
125
131
|
# The AWS region to connect to. The configured `:region` is
|
@@ -173,6 +179,10 @@ module Aws::MarketplaceMetering
|
|
173
179
|
# Used only in `standard` and adaptive retry modes. Specifies whether to apply
|
174
180
|
# a clock skew correction and retry requests with skewed client clocks.
|
175
181
|
#
|
182
|
+
# @option options [String] :defaults_mode ("legacy")
|
183
|
+
# See {Aws::DefaultsModeConfiguration} for a list of the
|
184
|
+
# accepted modes and the configuration defaults that are included.
|
185
|
+
#
|
176
186
|
# @option options [Boolean] :disable_host_prefix_injection (false)
|
177
187
|
# Set to true to disable SDK automatically adding host prefix
|
178
188
|
# to default service endpoint when available.
|
@@ -285,6 +295,15 @@ module Aws::MarketplaceMetering
|
|
285
295
|
# ** Please note ** When response stubbing is enabled, no HTTP
|
286
296
|
# requests are made, and retries are disabled.
|
287
297
|
#
|
298
|
+
# @option options [Boolean] :use_dualstack_endpoint
|
299
|
+
# When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
|
300
|
+
# will be used if available.
|
301
|
+
#
|
302
|
+
# @option options [Boolean] :use_fips_endpoint
|
303
|
+
# When set to `true`, fips compatible endpoints will be used if available.
|
304
|
+
# When a `fips` region is used, the region is normalized and this config
|
305
|
+
# is set to `true`.
|
306
|
+
#
|
288
307
|
# @option options [Boolean] :validate_params (true)
|
289
308
|
# When `true`, request parameters are validated before
|
290
309
|
# sending the request.
|
@@ -296,7 +315,7 @@ module Aws::MarketplaceMetering
|
|
296
315
|
# seconds to wait when opening a HTTP session before raising a
|
297
316
|
# `Timeout::Error`.
|
298
317
|
#
|
299
|
-
# @option options [
|
318
|
+
# @option options [Float] :http_read_timeout (60) The default
|
300
319
|
# number of seconds to wait for response data. This value can
|
301
320
|
# safely be set per-request on the session.
|
302
321
|
#
|
@@ -312,6 +331,9 @@ module Aws::MarketplaceMetering
|
|
312
331
|
# disables this behaviour. This value can safely be set per
|
313
332
|
# request on the session.
|
314
333
|
#
|
334
|
+
# @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
|
335
|
+
# in seconds.
|
336
|
+
#
|
315
337
|
# @option options [Boolean] :http_wire_trace (false) When `true`,
|
316
338
|
# HTTP debug output will be sent to the `:logger`.
|
317
339
|
#
|
@@ -337,27 +359,45 @@ module Aws::MarketplaceMetering
|
|
337
359
|
|
338
360
|
# @!group API Operations
|
339
361
|
|
340
|
-
# BatchMeterUsage is called from a SaaS application listed on
|
362
|
+
# `BatchMeterUsage` is called from a SaaS application listed on AWS
|
341
363
|
# Marketplace to post metering records for a set of customers.
|
342
364
|
#
|
343
365
|
# For identical requests, the API is idempotent; requests can be retried
|
344
366
|
# with the same records or a subset of the input records.
|
345
367
|
#
|
346
|
-
# Every request to BatchMeterUsage is for one product. If you need to
|
368
|
+
# Every request to `BatchMeterUsage` is for one product. If you need to
|
347
369
|
# meter usage for multiple products, you must make multiple calls to
|
348
|
-
# BatchMeterUsage
|
370
|
+
# `BatchMeterUsage`.
|
349
371
|
#
|
350
|
-
#
|
372
|
+
# Usage records are expected to be submitted as quickly as possible
|
373
|
+
# after the event that is being recorded, and are not accepted more than
|
374
|
+
# 6 hours after the event.
|
351
375
|
#
|
352
|
-
#
|
353
|
-
#
|
376
|
+
# `BatchMeterUsage` can process up to 25 `UsageRecords` at a time.
|
377
|
+
#
|
378
|
+
# A `UsageRecord` can optionally include multiple usage allocations, to
|
379
|
+
# provide customers with usage data split into buckets by tags that you
|
354
380
|
# define (or allow the customer to define).
|
355
381
|
#
|
356
|
-
# BatchMeterUsage
|
382
|
+
# `BatchMeterUsage` returns a list of `UsageRecordResult` objects,
|
383
|
+
# showing the result for each `UsageRecord`, as well as a list of
|
384
|
+
# `UnprocessedRecords`, indicating errors in the service side that you
|
385
|
+
# should retry.
|
386
|
+
#
|
387
|
+
# `BatchMeterUsage` requests must be less than 1MB in size.
|
388
|
+
#
|
389
|
+
# <note markdown="1"> For an example of using `BatchMeterUsage`, see [ BatchMeterUsage code
|
390
|
+
# example][1] in the *AWS Marketplace Seller Guide*.
|
391
|
+
#
|
392
|
+
# </note>
|
393
|
+
#
|
394
|
+
#
|
395
|
+
#
|
396
|
+
# [1]: https://docs.aws.amazon.com/marketplace/latest/userguide/saas-code-examples.html#saas-batchmeterusage-example
|
357
397
|
#
|
358
398
|
# @option params [required, Array<Types::UsageRecord>] :usage_records
|
359
|
-
# The set of UsageRecords to submit. BatchMeterUsage accepts up to
|
360
|
-
# UsageRecords at a time.
|
399
|
+
# The set of `UsageRecords` to submit. `BatchMeterUsage` accepts up to
|
400
|
+
# 25 `UsageRecords` at a time.
|
361
401
|
#
|
362
402
|
# @option params [required, String] :product_code
|
363
403
|
# Product code is used to uniquely identify a product in AWS
|
@@ -431,13 +471,17 @@ module Aws::MarketplaceMetering
|
|
431
471
|
# API to emit metering records. For identical requests, the API is
|
432
472
|
# idempotent. It simply returns the metering record ID.
|
433
473
|
#
|
434
|
-
# MeterUsage is authenticated on the buyer's AWS account using
|
474
|
+
# `MeterUsage` is authenticated on the buyer's AWS account using
|
435
475
|
# credentials from the EC2 instance, ECS task, or EKS pod.
|
436
476
|
#
|
437
|
-
# MeterUsage can optionally include multiple usage allocations, to
|
477
|
+
# `MeterUsage` can optionally include multiple usage allocations, to
|
438
478
|
# provide customers with usage data split into buckets by tags that you
|
439
479
|
# define (or allow the customer to define).
|
440
480
|
#
|
481
|
+
# Usage records are expected to be submitted as quickly as possible
|
482
|
+
# after the event that is being recorded, and are not accepted more than
|
483
|
+
# 6 hours after the event.
|
484
|
+
#
|
441
485
|
# @option params [required, String] :product_code
|
442
486
|
# Product code is used to uniquely identify a product in AWS
|
443
487
|
# Marketplace. The product code should be the same as the one used
|
@@ -446,7 +490,7 @@ module Aws::MarketplaceMetering
|
|
446
490
|
# @option params [required, Time,DateTime,Date,Integer,String] :timestamp
|
447
491
|
# Timestamp, in UTC, for which the usage is being reported. Your
|
448
492
|
# application can meter usage for up to one hour in the past. Make sure
|
449
|
-
# the timestamp value is not before the start of the software usage.
|
493
|
+
# the `timestamp` value is not before the start of the software usage.
|
450
494
|
#
|
451
495
|
# @option params [required, String] :usage_dimension
|
452
496
|
# It will be one of the fcp dimension name provided during the
|
@@ -458,15 +502,15 @@ module Aws::MarketplaceMetering
|
|
458
502
|
# @option params [Boolean] :dry_run
|
459
503
|
# Checks whether you have the permissions required for the action, but
|
460
504
|
# does not make the request. If you have the permissions, the request
|
461
|
-
# returns DryRunOperation
|
462
|
-
# Defaults to `false` if not specified.
|
505
|
+
# returns `DryRunOperation`; otherwise, it returns
|
506
|
+
# `UnauthorizedException`. Defaults to `false` if not specified.
|
463
507
|
#
|
464
508
|
# @option params [Array<Types::UsageAllocation>] :usage_allocations
|
465
|
-
# The set of UsageAllocations to submit.
|
509
|
+
# The set of `UsageAllocations` to submit.
|
466
510
|
#
|
467
|
-
# The sum of all UsageAllocation quantities must equal the
|
468
|
-
# of the MeterUsage request, and each
|
469
|
-
# set of tags (include no tags).
|
511
|
+
# The sum of all `UsageAllocation` quantities must equal the
|
512
|
+
# `UsageQuantity` of the `MeterUsage` request, and each
|
513
|
+
# `UsageAllocation` must have a unique set of tags (include no tags).
|
470
514
|
#
|
471
515
|
# @return [Types::MeterUsageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
472
516
|
#
|
@@ -508,26 +552,26 @@ module Aws::MarketplaceMetering
|
|
508
552
|
|
509
553
|
# Paid container software products sold through AWS Marketplace must
|
510
554
|
# integrate with the AWS Marketplace Metering Service and call the
|
511
|
-
# RegisterUsage operation for software entitlement and metering. Free
|
555
|
+
# `RegisterUsage` operation for software entitlement and metering. Free
|
512
556
|
# and BYOL products for Amazon ECS or Amazon EKS aren't required to
|
513
|
-
# call RegisterUsage
|
557
|
+
# call `RegisterUsage`, but you may choose to do so if you would like to
|
514
558
|
# receive usage data in your seller reports. The sections below explain
|
515
|
-
# the behavior of RegisterUsage
|
559
|
+
# the behavior of `RegisterUsage`. `RegisterUsage` performs two primary
|
516
560
|
# functions: metering and entitlement.
|
517
561
|
#
|
518
|
-
# * *Entitlement*\: RegisterUsage allows you to verify that the
|
519
|
-
# running your paid software is subscribed to your product on
|
520
|
-
# Marketplace, enabling you to guard against unauthorized use.
|
521
|
-
# container image that integrates with RegisterUsage is only
|
522
|
-
# to guard against unauthorized use at container startup, as
|
523
|
-
# CustomerNotSubscribedException
|
524
|
-
# only be thrown on the initial
|
525
|
-
# calls from the same Amazon ECS
|
526
|
-
# Amazon EKS pod will not throw a
|
527
|
-
# if the customer unsubscribes
|
528
|
-
# pod is still running.
|
529
|
-
#
|
530
|
-
# * *Metering*\: RegisterUsage meters software use per ECS task, per
|
562
|
+
# * *Entitlement*\: `RegisterUsage` allows you to verify that the
|
563
|
+
# customer running your paid software is subscribed to your product on
|
564
|
+
# AWS Marketplace, enabling you to guard against unauthorized use.
|
565
|
+
# Your container image that integrates with `RegisterUsage` is only
|
566
|
+
# required to guard against unauthorized use at container startup, as
|
567
|
+
# such a `CustomerNotSubscribedException` or
|
568
|
+
# `PlatformNotSupportedException` will only be thrown on the initial
|
569
|
+
# call to `RegisterUsage`. Subsequent calls from the same Amazon ECS
|
570
|
+
# task instance (e.g. task-id) or Amazon EKS pod will not throw a
|
571
|
+
# `CustomerNotSubscribedException`, even if the customer unsubscribes
|
572
|
+
# while the Amazon ECS task or Amazon EKS pod is still running.
|
573
|
+
#
|
574
|
+
# * *Metering*\: `RegisterUsage` meters software use per ECS task, per
|
531
575
|
# hour, or per pod for Amazon EKS with usage prorated to the second. A
|
532
576
|
# minimum of 1 minute of usage applies to tasks that are short lived.
|
533
577
|
# For example, if a customer has a 10 node Amazon ECS or Amazon EKS
|
@@ -536,7 +580,7 @@ module Aws::MarketplaceMetering
|
|
536
580
|
# customer will be charged: (10 * hourly\_rate). Metering for
|
537
581
|
# software use is automatically handled by the AWS Marketplace
|
538
582
|
# Metering Control Plane -- your software is not required to perform
|
539
|
-
# any metering specific actions, other than call RegisterUsage once
|
583
|
+
# any metering specific actions, other than call `RegisterUsage` once
|
540
584
|
# for metering of software use to commence. The AWS Marketplace
|
541
585
|
# Metering Control Plane will also continue to bill customers for
|
542
586
|
# running ECS tasks and Amazon EKS pods, regardless of the customers
|
@@ -582,22 +626,36 @@ module Aws::MarketplaceMetering
|
|
582
626
|
req.send_request(options)
|
583
627
|
end
|
584
628
|
|
585
|
-
# ResolveCustomer is called by a SaaS application during the
|
629
|
+
# `ResolveCustomer` is called by a SaaS application during the
|
586
630
|
# registration process. When a buyer visits your website during the
|
587
631
|
# registration process, the buyer submits a registration token through
|
588
632
|
# their browser. The registration token is resolved through this API to
|
589
|
-
# obtain a CustomerIdentifier
|
633
|
+
# obtain a `CustomerIdentifier` along with the `CustomerAWSAccountId`
|
634
|
+
# and `ProductCode`.
|
635
|
+
#
|
636
|
+
# <note markdown="1"> The API needs to called from the seller account id used to publish the
|
637
|
+
# SaaS application to successfully resolve the token.
|
638
|
+
#
|
639
|
+
# For an example of using `ResolveCustomer`, see [ ResolveCustomer code
|
640
|
+
# example][1] in the *AWS Marketplace Seller Guide*.
|
641
|
+
#
|
642
|
+
# </note>
|
643
|
+
#
|
644
|
+
#
|
645
|
+
#
|
646
|
+
# [1]: https://docs.aws.amazon.com/marketplace/latest/userguide/saas-code-examples.html#saas-resolvecustomer-example
|
590
647
|
#
|
591
648
|
# @option params [required, String] :registration_token
|
592
649
|
# When a buyer visits your website during the registration process, the
|
593
650
|
# buyer submits a registration token through the browser. The
|
594
|
-
# registration token is resolved to obtain a CustomerIdentifier
|
595
|
-
#
|
651
|
+
# registration token is resolved to obtain a `CustomerIdentifier` along
|
652
|
+
# with the `CustomerAWSAccountId` and `ProductCode`.
|
596
653
|
#
|
597
654
|
# @return [Types::ResolveCustomerResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
598
655
|
#
|
599
656
|
# * {Types::ResolveCustomerResult#customer_identifier #customer_identifier} => String
|
600
657
|
# * {Types::ResolveCustomerResult#product_code #product_code} => String
|
658
|
+
# * {Types::ResolveCustomerResult#customer_aws_account_id #customer_aws_account_id} => String
|
601
659
|
#
|
602
660
|
# @example Request syntax with placeholder values
|
603
661
|
#
|
@@ -609,6 +667,7 @@ module Aws::MarketplaceMetering
|
|
609
667
|
#
|
610
668
|
# resp.customer_identifier #=> String
|
611
669
|
# resp.product_code #=> String
|
670
|
+
# resp.customer_aws_account_id #=> String
|
612
671
|
#
|
613
672
|
# @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/ResolveCustomer AWS API Documentation
|
614
673
|
#
|
@@ -632,7 +691,7 @@ module Aws::MarketplaceMetering
|
|
632
691
|
params: params,
|
633
692
|
config: config)
|
634
693
|
context[:gem_name] = 'aws-sdk-marketplacemetering'
|
635
|
-
context[:gem_version] = '1.
|
694
|
+
context[:gem_version] = '1.43.0'
|
636
695
|
Seahorse::Client::Request.new(handlers, context)
|
637
696
|
end
|
638
697
|
|
@@ -17,6 +17,7 @@ module Aws::MarketplaceMetering
|
|
17
17
|
BatchMeterUsageRequest = Shapes::StructureShape.new(name: 'BatchMeterUsageRequest')
|
18
18
|
BatchMeterUsageResult = Shapes::StructureShape.new(name: 'BatchMeterUsageResult')
|
19
19
|
Boolean = Shapes::BooleanShape.new(name: 'Boolean')
|
20
|
+
CustomerAWSAccountId = Shapes::StringShape.new(name: 'CustomerAWSAccountId')
|
20
21
|
CustomerIdentifier = Shapes::StringShape.new(name: 'CustomerIdentifier')
|
21
22
|
CustomerNotEntitledException = Shapes::StructureShape.new(name: 'CustomerNotEntitledException')
|
22
23
|
DisabledApiException = Shapes::StructureShape.new(name: 'DisabledApiException')
|
@@ -140,6 +141,7 @@ module Aws::MarketplaceMetering
|
|
140
141
|
|
141
142
|
ResolveCustomerResult.add_member(:customer_identifier, Shapes::ShapeRef.new(shape: CustomerIdentifier, location_name: "CustomerIdentifier"))
|
142
143
|
ResolveCustomerResult.add_member(:product_code, Shapes::ShapeRef.new(shape: ProductCode, location_name: "ProductCode"))
|
144
|
+
ResolveCustomerResult.add_member(:customer_aws_account_id, Shapes::ShapeRef.new(shape: CustomerAWSAccountId, location_name: "CustomerAWSAccountId"))
|
143
145
|
ResolveCustomerResult.struct_class = Types::ResolveCustomerResult
|
144
146
|
|
145
147
|
Tag.add_member(:key, Shapes::ShapeRef.new(shape: TagKey, required: true, location_name: "Key"))
|
@@ -10,7 +10,7 @@
|
|
10
10
|
module Aws::MarketplaceMetering
|
11
11
|
module Types
|
12
12
|
|
13
|
-
# A BatchMeterUsageRequest contains UsageRecords
|
13
|
+
# A `BatchMeterUsageRequest` contains `UsageRecords`, which indicate
|
14
14
|
# quantities of usage within your application.
|
15
15
|
#
|
16
16
|
# @note When making an API call, you may pass BatchMeterUsageRequest
|
@@ -40,8 +40,8 @@ module Aws::MarketplaceMetering
|
|
40
40
|
# }
|
41
41
|
#
|
42
42
|
# @!attribute [rw] usage_records
|
43
|
-
# The set of UsageRecords to submit. BatchMeterUsage accepts up to
|
44
|
-
# UsageRecords at a time.
|
43
|
+
# The set of `UsageRecords` to submit. `BatchMeterUsage` accepts up to
|
44
|
+
# 25 `UsageRecords` at a time.
|
45
45
|
# @return [Array<Types::UsageRecord>]
|
46
46
|
#
|
47
47
|
# @!attribute [rw] product_code
|
@@ -59,20 +59,21 @@ module Aws::MarketplaceMetering
|
|
59
59
|
include Aws::Structure
|
60
60
|
end
|
61
61
|
|
62
|
-
# Contains the UsageRecords processed by BatchMeterUsage and any
|
63
|
-
# that have failed due to transient error.
|
62
|
+
# Contains the `UsageRecords` processed by `BatchMeterUsage` and any
|
63
|
+
# records that have failed due to transient error.
|
64
64
|
#
|
65
65
|
# @!attribute [rw] results
|
66
|
-
# Contains all UsageRecords processed by BatchMeterUsage
|
66
|
+
# Contains all `UsageRecords` processed by `BatchMeterUsage`. These
|
67
67
|
# records were either honored by AWS Marketplace Metering Service or
|
68
|
-
# were invalid.
|
68
|
+
# were invalid. Invalid records should be fixed before being
|
69
|
+
# resubmitted.
|
69
70
|
# @return [Array<Types::UsageRecordResult>]
|
70
71
|
#
|
71
72
|
# @!attribute [rw] unprocessed_records
|
72
|
-
# Contains all UsageRecords that were not processed by
|
73
|
-
# BatchMeterUsage
|
74
|
-
# failed request by making another BatchMeterUsage call with
|
75
|
-
# as input in the BatchMeterUsageRequest
|
73
|
+
# Contains all `UsageRecords` that were not processed by
|
74
|
+
# `BatchMeterUsage`. This is a list of `UsageRecords`. You can retry
|
75
|
+
# the failed request by making another `BatchMeterUsage` call with
|
76
|
+
# this list as input in the `BatchMeterUsageRequest`.
|
76
77
|
# @return [Array<Types::UsageRecord>]
|
77
78
|
#
|
78
79
|
# @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/BatchMeterUsageResult AWS API Documentation
|
@@ -112,8 +113,8 @@ module Aws::MarketplaceMetering
|
|
112
113
|
end
|
113
114
|
|
114
115
|
# A metering record has already been emitted by the same EC2 instance,
|
115
|
-
# ECS task, or EKS pod for the given \\\{usageDimension
|
116
|
-
# with a different usageQuantity
|
116
|
+
# ECS task, or EKS pod for the given \\\{`usageDimension`,
|
117
|
+
# `timestamp`\\} with a different `usageQuantity`.
|
117
118
|
#
|
118
119
|
# @!attribute [rw] message
|
119
120
|
# @return [String]
|
@@ -158,7 +159,7 @@ module Aws::MarketplaceMetering
|
|
158
159
|
include Aws::Structure
|
159
160
|
end
|
160
161
|
|
161
|
-
# You have metered usage for a CustomerIdentifier that does not exist.
|
162
|
+
# You have metered usage for a `CustomerIdentifier` that does not exist.
|
162
163
|
#
|
163
164
|
# @!attribute [rw] message
|
164
165
|
# @return [String]
|
@@ -213,9 +214,9 @@ module Aws::MarketplaceMetering
|
|
213
214
|
include Aws::Structure
|
214
215
|
end
|
215
216
|
|
216
|
-
# RegisterUsage must be called in the same AWS Region the ECS task was
|
217
|
+
# `RegisterUsage` must be called in the same AWS Region the ECS task was
|
217
218
|
# launched in. This prevents a container from hardcoding a Region (e.g.
|
218
|
-
# withRegion(“us-east-1”) when calling RegisterUsage
|
219
|
+
# withRegion(“us-east-1”) when calling `RegisterUsage`.
|
219
220
|
#
|
220
221
|
# @!attribute [rw] message
|
221
222
|
# @return [String]
|
@@ -268,7 +269,7 @@ module Aws::MarketplaceMetering
|
|
268
269
|
include Aws::Structure
|
269
270
|
end
|
270
271
|
|
271
|
-
# The usage dimension does not match one of the UsageDimensions
|
272
|
+
# The usage dimension does not match one of the `UsageDimensions`
|
272
273
|
# associated with products.
|
273
274
|
#
|
274
275
|
# @!attribute [rw] message
|
@@ -313,7 +314,7 @@ module Aws::MarketplaceMetering
|
|
313
314
|
# @!attribute [rw] timestamp
|
314
315
|
# Timestamp, in UTC, for which the usage is being reported. Your
|
315
316
|
# application can meter usage for up to one hour in the past. Make
|
316
|
-
# sure the timestamp value is not before the start of the software
|
317
|
+
# sure the `timestamp` value is not before the start of the software
|
317
318
|
# usage.
|
318
319
|
# @return [Time]
|
319
320
|
#
|
@@ -329,16 +330,16 @@ module Aws::MarketplaceMetering
|
|
329
330
|
# @!attribute [rw] dry_run
|
330
331
|
# Checks whether you have the permissions required for the action, but
|
331
332
|
# does not make the request. If you have the permissions, the request
|
332
|
-
# returns DryRunOperation
|
333
|
-
# UnauthorizedException
|
333
|
+
# returns `DryRunOperation`; otherwise, it returns
|
334
|
+
# `UnauthorizedException`. Defaults to `false` if not specified.
|
334
335
|
# @return [Boolean]
|
335
336
|
#
|
336
337
|
# @!attribute [rw] usage_allocations
|
337
|
-
# The set of UsageAllocations to submit.
|
338
|
+
# The set of `UsageAllocations` to submit.
|
338
339
|
#
|
339
|
-
# The sum of all UsageAllocation quantities must equal the
|
340
|
-
# UsageQuantity of the MeterUsage request, and each
|
341
|
-
# must have a unique set of tags (include no tags).
|
340
|
+
# The sum of all `UsageAllocation` quantities must equal the
|
341
|
+
# `UsageQuantity` of the `MeterUsage` request, and each
|
342
|
+
# `UsageAllocation` must have a unique set of tags (include no tags).
|
342
343
|
# @return [Array<Types::UsageAllocation>]
|
343
344
|
#
|
344
345
|
# @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/MeterUsageRequest AWS API Documentation
|
@@ -432,7 +433,7 @@ module Aws::MarketplaceMetering
|
|
432
433
|
include Aws::Structure
|
433
434
|
end
|
434
435
|
|
435
|
-
# Contains input to the ResolveCustomer operation.
|
436
|
+
# Contains input to the `ResolveCustomer` operation.
|
436
437
|
#
|
437
438
|
# @note When making an API call, you may pass ResolveCustomerRequest
|
438
439
|
# data as a hash:
|
@@ -444,8 +445,8 @@ module Aws::MarketplaceMetering
|
|
444
445
|
# @!attribute [rw] registration_token
|
445
446
|
# When a buyer visits your website during the registration process,
|
446
447
|
# the buyer submits a registration token through the browser. The
|
447
|
-
# registration token is resolved to obtain a CustomerIdentifier
|
448
|
-
#
|
448
|
+
# registration token is resolved to obtain a `CustomerIdentifier`
|
449
|
+
# along with the `CustomerAWSAccountId` and `ProductCode`.
|
449
450
|
# @return [String]
|
450
451
|
#
|
451
452
|
# @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/ResolveCustomerRequest AWS API Documentation
|
@@ -456,32 +457,39 @@ module Aws::MarketplaceMetering
|
|
456
457
|
include Aws::Structure
|
457
458
|
end
|
458
459
|
|
459
|
-
# The result of the ResolveCustomer operation. Contains the
|
460
|
-
# CustomerIdentifier
|
460
|
+
# The result of the `ResolveCustomer` operation. Contains the
|
461
|
+
# `CustomerIdentifier` along with the `CustomerAWSAccountId` and
|
462
|
+
# `ProductCode`.
|
461
463
|
#
|
462
464
|
# @!attribute [rw] customer_identifier
|
463
|
-
# The CustomerIdentifier is used to identify an individual customer
|
464
|
-
# your application. Calls to BatchMeterUsage require
|
465
|
-
# CustomerIdentifiers for each UsageRecord
|
465
|
+
# The `CustomerIdentifier` is used to identify an individual customer
|
466
|
+
# in your application. Calls to `BatchMeterUsage` require
|
467
|
+
# `CustomerIdentifiers` for each `UsageRecord`.
|
466
468
|
# @return [String]
|
467
469
|
#
|
468
470
|
# @!attribute [rw] product_code
|
469
471
|
# The product code is returned to confirm that the buyer is
|
470
|
-
# registering for your product. Subsequent BatchMeterUsage calls
|
472
|
+
# registering for your product. Subsequent `BatchMeterUsage` calls
|
471
473
|
# should be made using this product code.
|
472
474
|
# @return [String]
|
473
475
|
#
|
476
|
+
# @!attribute [rw] customer_aws_account_id
|
477
|
+
# The `CustomerAWSAccountId` provides the AWS account ID associated
|
478
|
+
# with the `CustomerIdentifier` for the individual customer.
|
479
|
+
# @return [String]
|
480
|
+
#
|
474
481
|
# @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/ResolveCustomerResult AWS API Documentation
|
475
482
|
#
|
476
483
|
class ResolveCustomerResult < Struct.new(
|
477
484
|
:customer_identifier,
|
478
|
-
:product_code
|
485
|
+
:product_code,
|
486
|
+
:customer_aws_account_id)
|
479
487
|
SENSITIVE = []
|
480
488
|
include Aws::Structure
|
481
489
|
end
|
482
490
|
|
483
|
-
# Metadata assigned to an allocation. Each tag is made up of a key and
|
484
|
-
# value
|
491
|
+
# Metadata assigned to an allocation. Each tag is made up of a `key` and
|
492
|
+
# a `value`.
|
485
493
|
#
|
486
494
|
# @note When making an API call, you may pass Tag
|
487
495
|
# data as a hash:
|
@@ -492,14 +500,14 @@ module Aws::MarketplaceMetering
|
|
492
500
|
# }
|
493
501
|
#
|
494
502
|
# @!attribute [rw] key
|
495
|
-
# One part of a key-value pair that makes up a tag
|
496
|
-
# that acts like a category for the specific tag values.
|
503
|
+
# One part of a key-value pair that makes up a `tag`. A `key` is a
|
504
|
+
# label that acts like a category for the specific tag values.
|
497
505
|
# @return [String]
|
498
506
|
#
|
499
507
|
# @!attribute [rw] value
|
500
|
-
# One part of a key-value pair that makes up a tag
|
501
|
-
# descriptor within a tag category (key). The value can be empty
|
502
|
-
# null.
|
508
|
+
# One part of a key-value pair that makes up a `tag`. A `value` acts
|
509
|
+
# as a descriptor within a tag category (key). The value can be empty
|
510
|
+
# or null.
|
503
511
|
# @return [String]
|
504
512
|
#
|
505
513
|
# @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/Tag AWS API Documentation
|
@@ -524,9 +532,13 @@ module Aws::MarketplaceMetering
|
|
524
532
|
include Aws::Structure
|
525
533
|
end
|
526
534
|
|
527
|
-
# The timestamp value passed in the
|
535
|
+
# The `timestamp` value passed in the `UsageRecord` is out of allowed
|
528
536
|
# range.
|
529
537
|
#
|
538
|
+
# For `BatchMeterUsage`, if any of the records are outside of the
|
539
|
+
# allowed range, the entire batch is not processed. You must remove
|
540
|
+
# invalid records and try again.
|
541
|
+
#
|
530
542
|
# @!attribute [rw] message
|
531
543
|
# @return [String]
|
532
544
|
#
|
@@ -540,7 +552,7 @@ module Aws::MarketplaceMetering
|
|
540
552
|
|
541
553
|
# Usage allocations allow you to split usage into buckets by tags.
|
542
554
|
#
|
543
|
-
# Each UsageAllocation indicates the usage quantity for a specific set
|
555
|
+
# Each `UsageAllocation` indicates the usage quantity for a specific set
|
544
556
|
# of tags.
|
545
557
|
#
|
546
558
|
# @note When making an API call, you may pass UsageAllocation
|
@@ -574,11 +586,11 @@ module Aws::MarketplaceMetering
|
|
574
586
|
include Aws::Structure
|
575
587
|
end
|
576
588
|
|
577
|
-
# A UsageRecord indicates a quantity of usage for a given product,
|
589
|
+
# A `UsageRecord` indicates a quantity of usage for a given product,
|
578
590
|
# customer, dimension and time.
|
579
591
|
#
|
580
|
-
# Multiple requests with the same UsageRecords as input will be
|
581
|
-
#
|
592
|
+
# Multiple requests with the same `UsageRecords` as input will be
|
593
|
+
# de-duplicated to prevent double charges.
|
582
594
|
#
|
583
595
|
# @note When making an API call, you may pass UsageRecord
|
584
596
|
# data as a hash:
|
@@ -605,19 +617,19 @@ module Aws::MarketplaceMetering
|
|
605
617
|
# Timestamp, in UTC, for which the usage is being reported.
|
606
618
|
#
|
607
619
|
# Your application can meter usage for up to one hour in the past.
|
608
|
-
# Make sure the timestamp value is not before the start of the
|
620
|
+
# Make sure the `timestamp` value is not before the start of the
|
609
621
|
# software usage.
|
610
622
|
# @return [Time]
|
611
623
|
#
|
612
624
|
# @!attribute [rw] customer_identifier
|
613
|
-
# The CustomerIdentifier is obtained through the ResolveCustomer
|
625
|
+
# The `CustomerIdentifier` is obtained through the `ResolveCustomer`
|
614
626
|
# operation and represents an individual buyer in your application.
|
615
627
|
# @return [String]
|
616
628
|
#
|
617
629
|
# @!attribute [rw] dimension
|
618
|
-
# During the process of registering a product on AWS Marketplace,
|
619
|
-
#
|
620
|
-
#
|
630
|
+
# During the process of registering a product on AWS Marketplace,
|
631
|
+
# dimensions are specified. These represent different units of value
|
632
|
+
# in your application.
|
621
633
|
# @return [String]
|
622
634
|
#
|
623
635
|
# @!attribute [rw] quantity
|
@@ -626,9 +638,9 @@ module Aws::MarketplaceMetering
|
|
626
638
|
# @return [Integer]
|
627
639
|
#
|
628
640
|
# @!attribute [rw] usage_allocations
|
629
|
-
# The set of UsageAllocations to submit. The sum of all
|
630
|
-
# UsageAllocation quantities must equal the Quantity of the
|
631
|
-
# UsageRecord
|
641
|
+
# The set of `UsageAllocations` to submit. The sum of all
|
642
|
+
# `UsageAllocation` quantities must equal the Quantity of the
|
643
|
+
# `UsageRecord`.
|
632
644
|
# @return [Array<Types::UsageAllocation>]
|
633
645
|
#
|
634
646
|
# @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/UsageRecord AWS API Documentation
|
@@ -643,31 +655,40 @@ module Aws::MarketplaceMetering
|
|
643
655
|
include Aws::Structure
|
644
656
|
end
|
645
657
|
|
646
|
-
# A UsageRecordResult indicates the status of a given UsageRecord
|
647
|
-
# processed by BatchMeterUsage
|
658
|
+
# A `UsageRecordResult` indicates the status of a given `UsageRecord`
|
659
|
+
# processed by `BatchMeterUsage`.
|
648
660
|
#
|
649
661
|
# @!attribute [rw] usage_record
|
650
|
-
# The UsageRecord that was part of the BatchMeterUsage request.
|
662
|
+
# The `UsageRecord` that was part of the `BatchMeterUsage` request.
|
651
663
|
# @return [Types::UsageRecord]
|
652
664
|
#
|
653
665
|
# @!attribute [rw] metering_record_id
|
654
|
-
# The MeteringRecordId is a unique identifier for this metering
|
666
|
+
# The `MeteringRecordId` is a unique identifier for this metering
|
667
|
+
# event.
|
655
668
|
# @return [String]
|
656
669
|
#
|
657
670
|
# @!attribute [rw] status
|
658
|
-
# The UsageRecordResult Status indicates the status of an
|
659
|
-
# UsageRecord processed by BatchMeterUsage
|
671
|
+
# The `UsageRecordResult` `Status` indicates the status of an
|
672
|
+
# individual `UsageRecord` processed by `BatchMeterUsage`.
|
673
|
+
#
|
674
|
+
# * *Success*- The `UsageRecord` was accepted and honored by
|
675
|
+
# `BatchMeterUsage`.
|
676
|
+
#
|
677
|
+
# * *CustomerNotSubscribed*- The `CustomerIdentifier` specified is not
|
678
|
+
# able to use your product. The `UsageRecord` was not honored. There
|
679
|
+
# are three causes for this result:
|
680
|
+
#
|
681
|
+
# * The customer identifier is invalid.
|
660
682
|
#
|
661
|
-
#
|
662
|
-
#
|
683
|
+
# * The customer identifier provided in the metering record does not
|
684
|
+
# have an active agreement or subscription with this product.
|
685
|
+
# Future `UsageRecords` for this customer will fail until the
|
686
|
+
# customer subscribes to your product.
|
663
687
|
#
|
664
|
-
#
|
665
|
-
# subscribed to your product. The UsageRecord was not honored.
|
666
|
-
# Future UsageRecords for this customer will fail until the customer
|
667
|
-
# subscribes to your product.
|
688
|
+
# * The customer's AWS account was suspended.
|
668
689
|
#
|
669
|
-
# * *DuplicateRecord*- Indicates that the UsageRecord was invalid
|
670
|
-
# not honored. A previously metered UsageRecord had the same
|
690
|
+
# * *DuplicateRecord*- Indicates that the `UsageRecord` was invalid
|
691
|
+
# and not honored. A previously metered `UsageRecord` had the same
|
671
692
|
# customer, dimension, and time, but a different quantity.
|
672
693
|
# @return [String]
|
673
694
|
#
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: aws-sdk-marketplacemetering
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.43.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Amazon Web Services
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2022-02-03 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: aws-sdk-core
|
@@ -19,7 +19,7 @@ dependencies:
|
|
19
19
|
version: '3'
|
20
20
|
- - ">="
|
21
21
|
- !ruby/object:Gem::Version
|
22
|
-
version: 3.
|
22
|
+
version: 3.126.0
|
23
23
|
type: :runtime
|
24
24
|
prerelease: false
|
25
25
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -29,7 +29,7 @@ dependencies:
|
|
29
29
|
version: '3'
|
30
30
|
- - ">="
|
31
31
|
- !ruby/object:Gem::Version
|
32
|
-
version: 3.
|
32
|
+
version: 3.126.0
|
33
33
|
- !ruby/object:Gem::Dependency
|
34
34
|
name: aws-sigv4
|
35
35
|
requirement: !ruby/object:Gem::Requirement
|