aws-sdk-personalizeruntime 1.14.0 → 1.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 98020ec76be383f236d64d6a51fcd5d1340ef041b86ae43682bfe56eda132d47
4
- data.tar.gz: 7acee0c9b4f7d53b3b0905c2c8e45b139aee139dc97397de42618ad8eb7d1649
3
+ metadata.gz: a1a068ec7abbd010896e6d36e06631303e5d65d645e02a06c55c36fb987ce351
4
+ data.tar.gz: 70c9c93a8308b39d7b62f0925f5d2278000a6d5950fc3bfa034069c8296ae4d1
5
5
  SHA512:
6
- metadata.gz: f663d58af663a73438ac2f18a24966e5db06116916ac7c3dfd2a2babbb37b4e883c721c4e183e938647c80d14b53bd06fb460032f8b52b0e2f6e319be7c1fce0
7
- data.tar.gz: 99498da5d96cbbdc1569e5e7f52d337a5237aee486f3e834abe3bd338083e2c026910bd496ef97ca0b9c902b1f7db92e596af29a4bacfb77a87de3adfe0570c5
6
+ metadata.gz: 7cf26df6d82bd0326a4990156fb3c32c80ff7cb28bd735aaa271aafbf3a7ab6b6af50c35ccb9f8959c10009fbf26c52c39d55dc6239358006a6e93757d061390
7
+ data.tar.gz: c452c32ce173b6c7489d21212e6e5356aea5025a4818a814b216c994b80877ae9c9a5fa388752261455b0e034aeb5437b911f141580d2ccfe9a21ddcd45ecee9
@@ -7,6 +7,7 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
+
10
11
  require 'aws-sdk-core'
11
12
  require 'aws-sigv4'
12
13
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-personalizeruntime/customizations'
44
45
  #
45
46
  # See {Errors} for more information.
46
47
  #
47
- # @service
48
+ # @!group service
48
49
  module Aws::PersonalizeRuntime
49
50
 
50
- GEM_VERSION = '1.14.0'
51
+ GEM_VERSION = '1.19.0'
51
52
 
52
53
  end
@@ -85,13 +85,28 @@ module Aws::PersonalizeRuntime
85
85
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
86
86
  # credentials.
87
87
  #
88
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
89
+ # shared file, such as `~/.aws/config`.
90
+ #
91
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
92
+ #
93
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
94
+ # assume a role after providing credentials via the web.
95
+ #
96
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
97
+ # access token generated from `aws login`.
98
+ #
99
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
100
+ # process that outputs to stdout.
101
+ #
88
102
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
89
103
  # from an EC2 IMDS on an EC2 instance.
90
104
  #
91
- # * `Aws::SharedCredentials` - Used for loading credentials from a
92
- # shared file, such as `~/.aws/config`.
105
+ # * `Aws::ECSCredentials` - Used for loading credentials from
106
+ # instances running in ECS.
93
107
  #
94
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
108
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
109
+ # from the Cognito Identity service.
95
110
  #
96
111
  # When `:credentials` are not configured directly, the following
97
112
  # locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::PersonalizeRuntime
101
116
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
102
117
  # * `~/.aws/credentials`
103
118
  # * `~/.aws/config`
104
- # * EC2 IMDS instance profile - When used by default, the timeouts are
105
- # very aggressive. Construct and pass an instance of
106
- # `Aws::InstanceProfileCredentails` to enable retries and extended
107
- # timeouts.
119
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
+ # are very aggressive. Construct and pass an instance of
121
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
+ # enable retries and extended timeouts.
108
123
  #
109
124
  # @option options [required, String] :region
110
125
  # The AWS region to connect to. The configured `:region` is
@@ -341,12 +356,37 @@ module Aws::PersonalizeRuntime
341
356
  # current location or device type.
342
357
  #
343
358
  # @option params [String] :filter_arn
344
- # The Amazon Resource Name (ARN) of a filter you created to include or
345
- # exclude items from recommendations for a given user.
359
+ # The Amazon Resource Name (ARN) of a filter you created to include
360
+ # items or exclude items from recommendations for a given user. For more
361
+ # information, see [Filtering Recommendations][1].
362
+ #
363
+ #
364
+ #
365
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter.html
366
+ #
367
+ # @option params [Hash<String,String>] :filter_values
368
+ # The values to use when filtering recommendations. For each placeholder
369
+ # parameter in your filter expression, provide the parameter name (in
370
+ # matching case) as a key and the filter value(s) as the corresponding
371
+ # value. Separate multiple values for one parameter with a comma.
372
+ #
373
+ # For filter expressions that use an `INCLUDE` element to include items,
374
+ # you must provide values for all parameters that are defined in the
375
+ # expression. For filters with expressions that use an `EXCLUDE` element
376
+ # to exclude items, you can omit the `filter-values`.In this case,
377
+ # Amazon Personalize doesn't use that portion of the expression to
378
+ # filter recommendations.
379
+ #
380
+ # For more information, see [Filtering Recommendations][1].
381
+ #
382
+ #
383
+ #
384
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter.html
346
385
  #
347
386
  # @return [Types::GetPersonalizedRankingResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
348
387
  #
349
388
  # * {Types::GetPersonalizedRankingResponse#personalized_ranking #personalized_ranking} => Array&lt;Types::PredictedItem&gt;
389
+ # * {Types::GetPersonalizedRankingResponse#recommendation_id #recommendation_id} => String
350
390
  #
351
391
  # @example Request syntax with placeholder values
352
392
  #
@@ -358,6 +398,9 @@ module Aws::PersonalizeRuntime
358
398
  # "AttributeName" => "AttributeValue",
359
399
  # },
360
400
  # filter_arn: "Arn",
401
+ # filter_values: {
402
+ # "FilterAttributeName" => "FilterAttributeValue",
403
+ # },
361
404
  # })
362
405
  #
363
406
  # @example Response structure
@@ -365,6 +408,7 @@ module Aws::PersonalizeRuntime
365
408
  # resp.personalized_ranking #=> Array
366
409
  # resp.personalized_ranking[0].item_id #=> String
367
410
  # resp.personalized_ranking[0].score #=> Float
411
+ # resp.recommendation_id #=> String
368
412
  #
369
413
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-runtime-2018-05-22/GetPersonalizedRanking AWS API Documentation
370
414
  #
@@ -414,17 +458,37 @@ module Aws::PersonalizeRuntime
414
458
  #
415
459
  # @option params [String] :filter_arn
416
460
  # The ARN of the filter to apply to the returned recommendations. For
417
- # more information, see [Using Filters with Amazon Personalize][1].
461
+ # more information, see [Filtering Recommendations][1].
418
462
  #
419
463
  # When using this parameter, be sure the filter resource is `ACTIVE`.
420
464
  #
421
465
  #
422
466
  #
423
- # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filters.html
467
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter.html
468
+ #
469
+ # @option params [Hash<String,String>] :filter_values
470
+ # The values to use when filtering recommendations. For each placeholder
471
+ # parameter in your filter expression, provide the parameter name (in
472
+ # matching case) as a key and the filter value(s) as the corresponding
473
+ # value. Separate multiple values for one parameter with a comma.
474
+ #
475
+ # For filter expressions that use an `INCLUDE` element to include items,
476
+ # you must provide values for all parameters that are defined in the
477
+ # expression. For filters with expressions that use an `EXCLUDE` element
478
+ # to exclude items, you can omit the `filter-values`.In this case,
479
+ # Amazon Personalize doesn't use that portion of the expression to
480
+ # filter recommendations.
481
+ #
482
+ # For more information, see [Filtering Recommendations][1].
483
+ #
484
+ #
485
+ #
486
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter.html
424
487
  #
425
488
  # @return [Types::GetRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
426
489
  #
427
490
  # * {Types::GetRecommendationsResponse#item_list #item_list} => Array&lt;Types::PredictedItem&gt;
491
+ # * {Types::GetRecommendationsResponse#recommendation_id #recommendation_id} => String
428
492
  #
429
493
  # @example Request syntax with placeholder values
430
494
  #
@@ -437,6 +501,9 @@ module Aws::PersonalizeRuntime
437
501
  # "AttributeName" => "AttributeValue",
438
502
  # },
439
503
  # filter_arn: "Arn",
504
+ # filter_values: {
505
+ # "FilterAttributeName" => "FilterAttributeValue",
506
+ # },
440
507
  # })
441
508
  #
442
509
  # @example Response structure
@@ -444,6 +511,7 @@ module Aws::PersonalizeRuntime
444
511
  # resp.item_list #=> Array
445
512
  # resp.item_list[0].item_id #=> String
446
513
  # resp.item_list[0].score #=> Float
514
+ # resp.recommendation_id #=> String
447
515
  #
448
516
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-runtime-2018-05-22/GetRecommendations AWS API Documentation
449
517
  #
@@ -467,7 +535,7 @@ module Aws::PersonalizeRuntime
467
535
  params: params,
468
536
  config: config)
469
537
  context[:gem_name] = 'aws-sdk-personalizeruntime'
470
- context[:gem_version] = '1.14.0'
538
+ context[:gem_version] = '1.19.0'
471
539
  Seahorse::Client::Request.new(handlers, context)
472
540
  end
473
541
 
@@ -18,6 +18,9 @@ module Aws::PersonalizeRuntime
18
18
  AttributeValue = Shapes::StringShape.new(name: 'AttributeValue')
19
19
  Context = Shapes::MapShape.new(name: 'Context')
20
20
  ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
21
+ FilterAttributeName = Shapes::StringShape.new(name: 'FilterAttributeName')
22
+ FilterAttributeValue = Shapes::StringShape.new(name: 'FilterAttributeValue')
23
+ FilterValues = Shapes::MapShape.new(name: 'FilterValues')
21
24
  GetPersonalizedRankingRequest = Shapes::StructureShape.new(name: 'GetPersonalizedRankingRequest')
22
25
  GetPersonalizedRankingResponse = Shapes::StructureShape.new(name: 'GetPersonalizedRankingResponse')
23
26
  GetRecommendationsRequest = Shapes::StructureShape.new(name: 'GetRecommendationsRequest')
@@ -28,6 +31,7 @@ module Aws::PersonalizeRuntime
28
31
  ItemList = Shapes::ListShape.new(name: 'ItemList')
29
32
  NumResults = Shapes::IntegerShape.new(name: 'NumResults')
30
33
  PredictedItem = Shapes::StructureShape.new(name: 'PredictedItem')
34
+ RecommendationID = Shapes::StringShape.new(name: 'RecommendationID')
31
35
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
32
36
  Score = Shapes::FloatShape.new(name: 'Score')
33
37
  UserID = Shapes::StringShape.new(name: 'UserID')
@@ -35,14 +39,19 @@ module Aws::PersonalizeRuntime
35
39
  Context.key = Shapes::ShapeRef.new(shape: AttributeName)
36
40
  Context.value = Shapes::ShapeRef.new(shape: AttributeValue)
37
41
 
42
+ FilterValues.key = Shapes::ShapeRef.new(shape: FilterAttributeName)
43
+ FilterValues.value = Shapes::ShapeRef.new(shape: FilterAttributeValue)
44
+
38
45
  GetPersonalizedRankingRequest.add_member(:campaign_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "campaignArn"))
39
46
  GetPersonalizedRankingRequest.add_member(:input_list, Shapes::ShapeRef.new(shape: InputList, required: true, location_name: "inputList"))
40
47
  GetPersonalizedRankingRequest.add_member(:user_id, Shapes::ShapeRef.new(shape: UserID, required: true, location_name: "userId"))
41
48
  GetPersonalizedRankingRequest.add_member(:context, Shapes::ShapeRef.new(shape: Context, location_name: "context"))
42
49
  GetPersonalizedRankingRequest.add_member(:filter_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "filterArn"))
50
+ GetPersonalizedRankingRequest.add_member(:filter_values, Shapes::ShapeRef.new(shape: FilterValues, location_name: "filterValues"))
43
51
  GetPersonalizedRankingRequest.struct_class = Types::GetPersonalizedRankingRequest
44
52
 
45
53
  GetPersonalizedRankingResponse.add_member(:personalized_ranking, Shapes::ShapeRef.new(shape: ItemList, location_name: "personalizedRanking"))
54
+ GetPersonalizedRankingResponse.add_member(:recommendation_id, Shapes::ShapeRef.new(shape: RecommendationID, location_name: "recommendationId"))
46
55
  GetPersonalizedRankingResponse.struct_class = Types::GetPersonalizedRankingResponse
47
56
 
48
57
  GetRecommendationsRequest.add_member(:campaign_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "campaignArn"))
@@ -51,9 +60,11 @@ module Aws::PersonalizeRuntime
51
60
  GetRecommendationsRequest.add_member(:num_results, Shapes::ShapeRef.new(shape: NumResults, location_name: "numResults"))
52
61
  GetRecommendationsRequest.add_member(:context, Shapes::ShapeRef.new(shape: Context, location_name: "context"))
53
62
  GetRecommendationsRequest.add_member(:filter_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "filterArn"))
63
+ GetRecommendationsRequest.add_member(:filter_values, Shapes::ShapeRef.new(shape: FilterValues, location_name: "filterValues"))
54
64
  GetRecommendationsRequest.struct_class = Types::GetRecommendationsRequest
55
65
 
56
66
  GetRecommendationsResponse.add_member(:item_list, Shapes::ShapeRef.new(shape: ItemList, location_name: "itemList"))
67
+ GetRecommendationsResponse.add_member(:recommendation_id, Shapes::ShapeRef.new(shape: RecommendationID, location_name: "recommendationId"))
57
68
  GetRecommendationsResponse.struct_class = Types::GetRecommendationsResponse
58
69
 
59
70
  InputList.member = Shapes::ShapeRef.new(shape: ItemID)
@@ -21,6 +21,9 @@ module Aws::PersonalizeRuntime
21
21
  # "AttributeName" => "AttributeValue",
22
22
  # },
23
23
  # filter_arn: "Arn",
24
+ # filter_values: {
25
+ # "FilterAttributeName" => "FilterAttributeValue",
26
+ # },
24
27
  # }
25
28
  #
26
29
  # @!attribute [rw] campaign_arn
@@ -47,10 +50,36 @@ module Aws::PersonalizeRuntime
47
50
  # @return [Hash<String,String>]
48
51
  #
49
52
  # @!attribute [rw] filter_arn
50
- # The Amazon Resource Name (ARN) of a filter you created to include or
51
- # exclude items from recommendations for a given user.
53
+ # The Amazon Resource Name (ARN) of a filter you created to include
54
+ # items or exclude items from recommendations for a given user. For
55
+ # more information, see [Filtering Recommendations][1].
56
+ #
57
+ #
58
+ #
59
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter.html
52
60
  # @return [String]
53
61
  #
62
+ # @!attribute [rw] filter_values
63
+ # The values to use when filtering recommendations. For each
64
+ # placeholder parameter in your filter expression, provide the
65
+ # parameter name (in matching case) as a key and the filter value(s)
66
+ # as the corresponding value. Separate multiple values for one
67
+ # parameter with a comma.
68
+ #
69
+ # For filter expressions that use an `INCLUDE` element to include
70
+ # items, you must provide values for all parameters that are defined
71
+ # in the expression. For filters with expressions that use an
72
+ # `EXCLUDE` element to exclude items, you can omit the
73
+ # `filter-values`.In this case, Amazon Personalize doesn't use that
74
+ # portion of the expression to filter recommendations.
75
+ #
76
+ # For more information, see [Filtering Recommendations][1].
77
+ #
78
+ #
79
+ #
80
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter.html
81
+ # @return [Hash<String,String>]
82
+ #
54
83
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-runtime-2018-05-22/GetPersonalizedRankingRequest AWS API Documentation
55
84
  #
56
85
  class GetPersonalizedRankingRequest < Struct.new(
@@ -58,7 +87,8 @@ module Aws::PersonalizeRuntime
58
87
  :input_list,
59
88
  :user_id,
60
89
  :context,
61
- :filter_arn)
90
+ :filter_arn,
91
+ :filter_values)
62
92
  SENSITIVE = []
63
93
  include Aws::Structure
64
94
  end
@@ -68,10 +98,15 @@ module Aws::PersonalizeRuntime
68
98
  # maximum is 500.
69
99
  # @return [Array<Types::PredictedItem>]
70
100
  #
101
+ # @!attribute [rw] recommendation_id
102
+ # The ID of the recommendation.
103
+ # @return [String]
104
+ #
71
105
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-runtime-2018-05-22/GetPersonalizedRankingResponse AWS API Documentation
72
106
  #
73
107
  class GetPersonalizedRankingResponse < Struct.new(
74
- :personalized_ranking)
108
+ :personalized_ranking,
109
+ :recommendation_id)
75
110
  SENSITIVE = []
76
111
  include Aws::Structure
77
112
  end
@@ -88,6 +123,9 @@ module Aws::PersonalizeRuntime
88
123
  # "AttributeName" => "AttributeValue",
89
124
  # },
90
125
  # filter_arn: "Arn",
126
+ # filter_values: {
127
+ # "FilterAttributeName" => "FilterAttributeValue",
128
+ # },
91
129
  # }
92
130
  #
93
131
  # @!attribute [rw] campaign_arn
@@ -121,15 +159,36 @@ module Aws::PersonalizeRuntime
121
159
  #
122
160
  # @!attribute [rw] filter_arn
123
161
  # The ARN of the filter to apply to the returned recommendations. For
124
- # more information, see [Using Filters with Amazon Personalize][1].
162
+ # more information, see [Filtering Recommendations][1].
125
163
  #
126
164
  # When using this parameter, be sure the filter resource is `ACTIVE`.
127
165
  #
128
166
  #
129
167
  #
130
- # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filters.html
168
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter.html
131
169
  # @return [String]
132
170
  #
171
+ # @!attribute [rw] filter_values
172
+ # The values to use when filtering recommendations. For each
173
+ # placeholder parameter in your filter expression, provide the
174
+ # parameter name (in matching case) as a key and the filter value(s)
175
+ # as the corresponding value. Separate multiple values for one
176
+ # parameter with a comma.
177
+ #
178
+ # For filter expressions that use an `INCLUDE` element to include
179
+ # items, you must provide values for all parameters that are defined
180
+ # in the expression. For filters with expressions that use an
181
+ # `EXCLUDE` element to exclude items, you can omit the
182
+ # `filter-values`.In this case, Amazon Personalize doesn't use that
183
+ # portion of the expression to filter recommendations.
184
+ #
185
+ # For more information, see [Filtering Recommendations][1].
186
+ #
187
+ #
188
+ #
189
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter.html
190
+ # @return [Hash<String,String>]
191
+ #
133
192
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-runtime-2018-05-22/GetRecommendationsRequest AWS API Documentation
134
193
  #
135
194
  class GetRecommendationsRequest < Struct.new(
@@ -138,7 +197,8 @@ module Aws::PersonalizeRuntime
138
197
  :user_id,
139
198
  :num_results,
140
199
  :context,
141
- :filter_arn)
200
+ :filter_arn,
201
+ :filter_values)
142
202
  SENSITIVE = []
143
203
  include Aws::Structure
144
204
  end
@@ -148,10 +208,15 @@ module Aws::PersonalizeRuntime
148
208
  # score. There can be a maximum of 500 items in the list.
149
209
  # @return [Array<Types::PredictedItem>]
150
210
  #
211
+ # @!attribute [rw] recommendation_id
212
+ # The ID of the recommendation.
213
+ # @return [String]
214
+ #
151
215
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-runtime-2018-05-22/GetRecommendationsResponse AWS API Documentation
152
216
  #
153
217
  class GetRecommendationsResponse < Struct.new(
154
- :item_list)
218
+ :item_list,
219
+ :recommendation_id)
155
220
  SENSITIVE = []
156
221
  include Aws::Structure
157
222
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-personalizeruntime
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.14.0
4
+ version: 1.19.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: 2020-07-31 00:00:00.000000000 Z
11
+ date: 2020-11-12 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.99.0
22
+ version: 3.109.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.99.0
32
+ version: 3.109.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement