aws-sdk-codeguruprofiler 1.0.0 → 1.5.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
- SHA1:
3
- metadata.gz: b4cc53085da17ec46155faa92032692f067449ff
4
- data.tar.gz: 46670705aea14a16a79fcbf4b1b076367011a11e
2
+ SHA256:
3
+ metadata.gz: 4d60f21f7f3b84fe65bcd4877900edb6a314996f244de52655881b0c20519cd7
4
+ data.tar.gz: 8f34870a86c0b132725bbe28619994085b461528ad85972240d38f6c22b050c0
5
5
  SHA512:
6
- metadata.gz: 8271046afc4f8249a7ab5fd0a539bf5d5b059a217ec7a753f358d8bc15427c6e1b31d81fabdb3a5ee1209b349643293e6e3036e60c3143f97dab944c6e9487d4
7
- data.tar.gz: 3d470dc7efe5e63eb77502f98308f40274951c739d59fcddf6abaf824c55ae999c3d79d71e1ce0629ca7260ff2d668bd94323a23cf1afbef216cd6637203ff07
6
+ metadata.gz: b2d4412aa367a5eab222d7056abe86d720472e226c5f43c6ed4fd25d3fc91804dc387827f9045f131c054d8238bb49f910f66b9077000a663988d669fc03fbb5
7
+ data.tar.gz: 375e43a1bc301c82d071b6ceeba4df4b2e6c5922a4b10f7a52683fb85fd73cfad64b68c94aed36303783b1604cec72066fe85fbc5d3d5a18602ec307ae3eab18
@@ -24,17 +24,20 @@ require_relative 'aws-sdk-codeguruprofiler/customizations'
24
24
  # methods each accept a hash of request parameters and return a response
25
25
  # structure.
26
26
  #
27
+ # code_guru_profiler = Aws::CodeGuruProfiler::Client.new
28
+ # resp = code_guru_profiler.configure_agent(params)
29
+ #
27
30
  # See {Client} for more information.
28
31
  #
29
32
  # # Errors
30
33
  #
31
- # Errors returned from Amazon CodeGuru Profiler all
32
- # extend {Errors::ServiceError}.
34
+ # Errors returned from Amazon CodeGuru Profiler are defined in the
35
+ # {Errors} module and all extend {Errors::ServiceError}.
33
36
  #
34
37
  # begin
35
38
  # # do stuff
36
39
  # rescue Aws::CodeGuruProfiler::Errors::ServiceError
37
- # # rescues all service API errors
40
+ # # rescues all Amazon CodeGuru Profiler API errors
38
41
  # end
39
42
  #
40
43
  # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-codeguruprofiler/customizations'
42
45
  # @service
43
46
  module Aws::CodeGuruProfiler
44
47
 
45
- GEM_VERSION = '1.0.0'
48
+ GEM_VERSION = '1.5.0'
46
49
 
47
50
  end
@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/rest_json.rb'
30
30
  Aws::Plugins::GlobalConfiguration.add_identifier(:codeguruprofiler)
31
31
 
32
32
  module Aws::CodeGuruProfiler
33
+ # An API client for CodeGuruProfiler. To construct a client, you need to configure a `:region` and `:credentials`.
34
+ #
35
+ # client = Aws::CodeGuruProfiler::Client.new(
36
+ # region: region_name,
37
+ # credentials: credentials,
38
+ # # ...
39
+ # )
40
+ #
41
+ # For details on configuring region and credentials see
42
+ # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
43
+ #
44
+ # See {#initialize} for a full list of supported configuration options.
33
45
  class Client < Seahorse::Client::Base
34
46
 
35
47
  include Aws::ClientStubs
@@ -93,7 +105,7 @@ module Aws::CodeGuruProfiler
93
105
  # @option options [required, String] :region
94
106
  # The AWS region to connect to. The configured `:region` is
95
107
  # used to determine the service `:endpoint`. When not passed,
96
- # a default `:region` is search for in the following locations:
108
+ # a default `:region` is searched for in the following locations:
97
109
  #
98
110
  # * `Aws.config[:region]`
99
111
  # * `ENV['AWS_REGION']`
@@ -108,6 +120,12 @@ module Aws::CodeGuruProfiler
108
120
  # When set to `true`, a thread polling for endpoints will be running in
109
121
  # the background every 60 secs (default). Defaults to `false`.
110
122
  #
123
+ # @option options [Boolean] :adaptive_retry_wait_to_fill (true)
124
+ # Used only in `adaptive` retry mode. When true, the request will sleep
125
+ # until there is sufficent client side capacity to retry the request.
126
+ # When false, the request will raise a `RetryCapacityNotAvailableError` and will
127
+ # not retry instead of sleeping.
128
+ #
111
129
  # @option options [Boolean] :client_side_monitoring (false)
112
130
  # When `true`, client-side metrics will be collected for all API requests from
113
131
  # this client.
@@ -132,6 +150,10 @@ module Aws::CodeGuruProfiler
132
150
  # When `true`, an attempt is made to coerce request parameters into
133
151
  # the required types.
134
152
  #
153
+ # @option options [Boolean] :correct_clock_skew (true)
154
+ # Used only in `standard` and adaptive retry modes. Specifies whether to apply
155
+ # a clock skew correction and retry requests with skewed client clocks.
156
+ #
135
157
  # @option options [Boolean] :disable_host_prefix_injection (false)
136
158
  # Set to true to disable SDK automatically adding host prefix
137
159
  # to default service endpoint when available.
@@ -139,7 +161,7 @@ module Aws::CodeGuruProfiler
139
161
  # @option options [String] :endpoint
140
162
  # The client endpoint is normally constructed from the `:region`
141
163
  # option. You should only configure an `:endpoint` when connecting
142
- # to test endpoints. This should be avalid HTTP(S) URI.
164
+ # to test endpoints. This should be a valid HTTP(S) URI.
143
165
  #
144
166
  # @option options [Integer] :endpoint_cache_max_entries (1000)
145
167
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +176,7 @@ module Aws::CodeGuruProfiler
154
176
  # requests fetching endpoints information. Defaults to 60 sec.
155
177
  #
156
178
  # @option options [Boolean] :endpoint_discovery (false)
157
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
179
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
158
180
  #
159
181
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
160
182
  # The log formatter.
@@ -166,15 +188,29 @@ module Aws::CodeGuruProfiler
166
188
  # The Logger instance to send log messages to. If this option
167
189
  # is not set, logging will be disabled.
168
190
  #
191
+ # @option options [Integer] :max_attempts (3)
192
+ # An integer representing the maximum number attempts that will be made for
193
+ # a single request, including the initial attempt. For example,
194
+ # setting this value to 5 will result in a request being retried up to
195
+ # 4 times. Used in `standard` and `adaptive` retry modes.
196
+ #
169
197
  # @option options [String] :profile ("default")
170
198
  # Used when loading credentials from the shared credentials file
171
199
  # at HOME/.aws/credentials. When not specified, 'default' is used.
172
200
  #
201
+ # @option options [Proc] :retry_backoff
202
+ # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
203
+ # This option is only used in the `legacy` retry mode.
204
+ #
173
205
  # @option options [Float] :retry_base_delay (0.3)
174
- # The base delay in seconds used by the default backoff function.
206
+ # The base delay in seconds used by the default backoff function. This option
207
+ # is only used in the `legacy` retry mode.
175
208
  #
176
209
  # @option options [Symbol] :retry_jitter (:none)
177
- # A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
210
+ # A delay randomiser function used by the default backoff function.
211
+ # Some predefined functions can be referenced by name - :none, :equal, :full,
212
+ # otherwise a Proc that takes and returns a number. This option is only used
213
+ # in the `legacy` retry mode.
178
214
  #
179
215
  # @see https://www.awsarchitectureblog.com/2015/03/backoff.html
180
216
  #
@@ -182,11 +218,30 @@ module Aws::CodeGuruProfiler
182
218
  # The maximum number of times to retry failed requests. Only
183
219
  # ~ 500 level server errors and certain ~ 400 level client errors
184
220
  # are retried. Generally, these are throttling errors, data
185
- # checksum errors, networking errors, timeout errors and auth
186
- # errors from expired credentials.
221
+ # checksum errors, networking errors, timeout errors, auth errors,
222
+ # endpoint discovery, and errors from expired credentials.
223
+ # This option is only used in the `legacy` retry mode.
187
224
  #
188
225
  # @option options [Integer] :retry_max_delay (0)
189
- # The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
226
+ # The maximum number of seconds to delay between retries (0 for no limit)
227
+ # used by the default backoff function. This option is only used in the
228
+ # `legacy` retry mode.
229
+ #
230
+ # @option options [String] :retry_mode ("legacy")
231
+ # Specifies which retry algorithm to use. Values are:
232
+ #
233
+ # * `legacy` - The pre-existing retry behavior. This is default value if
234
+ # no retry mode is provided.
235
+ #
236
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
237
+ # This includes support for retry quotas, which limit the number of
238
+ # unsuccessful retries a client can make.
239
+ #
240
+ # * `adaptive` - An experimental retry mode that includes all the
241
+ # functionality of `standard` mode along with automatic client side
242
+ # throttling. This is a provisional mode that may change behavior
243
+ # in the future.
244
+ #
190
245
  #
191
246
  # @option options [String] :secret_access_key
192
247
  #
@@ -209,16 +264,15 @@ module Aws::CodeGuruProfiler
209
264
  # requests through. Formatted like 'http://proxy.com:123'.
210
265
  #
211
266
  # @option options [Float] :http_open_timeout (15) The number of
212
- # seconds to wait when opening a HTTP session before rasing a
267
+ # seconds to wait when opening a HTTP session before raising a
213
268
  # `Timeout::Error`.
214
269
  #
215
270
  # @option options [Integer] :http_read_timeout (60) The default
216
271
  # number of seconds to wait for response data. This value can
217
- # safely be set
218
- # per-request on the session yeidled by {#session_for}.
272
+ # safely be set per-request on the session.
219
273
  #
220
274
  # @option options [Float] :http_idle_timeout (5) The number of
221
- # seconds a connection is allowed to sit idble before it is
275
+ # seconds a connection is allowed to sit idle before it is
222
276
  # considered stale. Stale connections are closed and removed
223
277
  # from the pool before making a request.
224
278
  #
@@ -227,7 +281,7 @@ module Aws::CodeGuruProfiler
227
281
  # request body. This option has no effect unless the request has
228
282
  # "Expect" header set to "100-continue". Defaults to `nil` which
229
283
  # disables this behaviour. This value can safely be set per
230
- # request on the session yeidled by {#session_for}.
284
+ # request on the session.
231
285
  #
232
286
  # @option options [Boolean] :http_wire_trace (false) When `true`,
233
287
  # HTTP debug output will be sent to the `:logger`.
@@ -254,15 +308,9 @@ module Aws::CodeGuruProfiler
254
308
 
255
309
  # @!group API Operations
256
310
 
257
- # Provides the configuration to use for an agent of the profiling group.
258
- #
259
311
  # @option params [String] :fleet_instance_id
260
- # Identifier of the instance of compute fleet being profiled by the
261
- # agent. For instance, host name in EC2, task id for ECS, function name
262
- # for AWS Lambda
263
312
  #
264
313
  # @option params [required, String] :profiling_group_name
265
- # The name of the profiling group.
266
314
  #
267
315
  # @return [Types::ConfigureAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
268
316
  #
@@ -289,15 +337,17 @@ module Aws::CodeGuruProfiler
289
337
  req.send_request(options)
290
338
  end
291
339
 
292
- # Create a profiling group.
340
+ # Creates a profiling group.
293
341
  #
294
342
  # @option params [Types::AgentOrchestrationConfig] :agent_orchestration_config
295
- # Configuration to orchestrate agents to create and report agent
296
- # profiles of the profiling group. Agents are orchestrated if they
297
- # follow the agent orchestration protocol.
343
+ # The agent orchestration configuration.
298
344
  #
299
345
  # @option params [required, String] :client_token
300
- # Client token for the request.
346
+ # Unique, case-sensitive identifier that you provide to ensure the
347
+ # idempotency of the request.
348
+ #
349
+ # This parameter specifies a unique identifier for the new profiling
350
+ # group that helps ensure idempotency.
301
351
  #
302
352
  # **A suitable default value is auto-generated.** You should normally
303
353
  # not need to pass this option.**
@@ -340,10 +390,10 @@ module Aws::CodeGuruProfiler
340
390
  req.send_request(options)
341
391
  end
342
392
 
343
- # Delete a profiling group.
393
+ # Deletes a profiling group.
344
394
  #
345
395
  # @option params [required, String] :profiling_group_name
346
- # The name of the profiling group.
396
+ # The profiling group name to delete.
347
397
  #
348
398
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
349
399
  #
@@ -362,10 +412,10 @@ module Aws::CodeGuruProfiler
362
412
  req.send_request(options)
363
413
  end
364
414
 
365
- # Describe a profiling group.
415
+ # Describes a profiling group.
366
416
  #
367
417
  # @option params [required, String] :profiling_group_name
368
- # The name of the profiling group.
418
+ # The profiling group name.
369
419
  #
370
420
  # @return [Types::DescribeProfilingGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
371
421
  #
@@ -398,38 +448,77 @@ module Aws::CodeGuruProfiler
398
448
  req.send_request(options)
399
449
  end
400
450
 
401
- # Get the aggregated profile of a profiling group for the specified time
402
- # range. If the requested time range does not align with the available
403
- # aggregated profiles, it will be expanded to attain alignment. If
451
+ # Gets the profiling group policy.
452
+ #
453
+ # @option params [required, String] :profiling_group_name
454
+ # The name of the profiling group.
455
+ #
456
+ # @return [Types::GetPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
457
+ #
458
+ # * {Types::GetPolicyResponse#policy #policy} => String
459
+ # * {Types::GetPolicyResponse#revision_id #revision_id} => String
460
+ #
461
+ # @example Request syntax with placeholder values
462
+ #
463
+ # resp = client.get_policy({
464
+ # profiling_group_name: "ProfilingGroupName", # required
465
+ # })
466
+ #
467
+ # @example Response structure
468
+ #
469
+ # resp.policy #=> String
470
+ # resp.revision_id #=> String
471
+ #
472
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/GetPolicy AWS API Documentation
473
+ #
474
+ # @overload get_policy(params = {})
475
+ # @param [Hash] params ({})
476
+ def get_policy(params = {}, options = {})
477
+ req = build_request(:get_policy, params)
478
+ req.send_request(options)
479
+ end
480
+
481
+ # Gets the aggregated profile of a profiling group for the specified
482
+ # time range. If the requested time range does not align with the
483
+ # available aggregated profiles, it is expanded to attain alignment. If
404
484
  # aggregated profiles are available only for part of the period
405
485
  # requested, the profile is returned from the earliest available to the
406
- # latest within the requested time range. For instance, if the requested
407
- # time range is from 00:00 to 00:20 and the available profiles are from
408
- # 00:15 to 00:25, then the returned profile will be from 00:15 to 00:20.
486
+ # latest within the requested time range.
487
+ #
488
+ # For example, if the requested time range is from 00:00 to 00:20 and
489
+ # the available profiles are from 00:15 to 00:25, the returned profile
490
+ # will be from 00:15 to 00:20.
491
+ #
492
+ # You must specify exactly two of the following parameters: `startTime`,
493
+ # `period`, and `endTime`.
409
494
  #
410
495
  # @option params [String] :accept
411
- # The format of the profile to return. Supports application/json or
412
- # application/x-amzn-ion. Defaults to application/x-amzn-ion.
496
+ # The format of the profile to return. You can choose `application/json`
497
+ # or the default `application/x-amzn-ion`.
413
498
  #
414
499
  # @option params [Time,DateTime,Date,Integer,String] :end_time
415
- # The end time of the profile to get. Either period or endTime must be
416
- # specified. Must be greater than start and the overall time range to be
417
- # in the past and not larger than a week.
500
+ # You must specify exactly two of the following parameters: `startTime`,
501
+ # `period`, and `endTime`.
418
502
  #
419
503
  # @option params [Integer] :max_depth
420
- # Limit the max depth of the profile.
504
+ # The maximum depth of the graph.
421
505
  #
422
506
  # @option params [String] :period
423
- # The period of the profile to get. Exactly two of `startTime`, `period`
424
- # and `endTime` must be specified. Must be positive and the overall time
425
- # range to be in the past and not larger than a week.
507
+ # The period of the profile to get. The time range must be in the past
508
+ # and not longer than one week.
509
+ #
510
+ # You must specify exactly two of the following parameters: `startTime`,
511
+ # `period`, and `endTime`.
426
512
  #
427
513
  # @option params [required, String] :profiling_group_name
428
- # The name of the profiling group.
514
+ # The name of the profiling group to get.
429
515
  #
430
516
  # @option params [Time,DateTime,Date,Integer,String] :start_time
431
517
  # The start time of the profile to get.
432
518
  #
519
+ # You must specify exactly two of the following parameters: `startTime`,
520
+ # `period`, and `endTime`.
521
+ #
433
522
  # @return [Types::GetProfileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
434
523
  #
435
524
  # * {Types::GetProfileResponse#content_encoding #content_encoding} => String
@@ -467,32 +556,48 @@ module Aws::CodeGuruProfiler
467
556
  # range.
468
557
  #
469
558
  # @option params [required, Time,DateTime,Date,Integer,String] :end_time
470
- # The end time of the time range to list profiles until.
559
+ # The end time of the time range from which to list the profiles.
471
560
  #
472
561
  # @option params [Integer] :max_results
473
- # Upper bound on the number of results to list in a single call.
562
+ # The maximum number of profile time results returned by
563
+ # `ListProfileTimes` in paginated output. When this parameter is used,
564
+ # `ListProfileTimes` only returns `maxResults` results in a single page
565
+ # with a `nextToken` response element. The remaining results of the
566
+ # initial request can be seen by sending another `ListProfileTimes`
567
+ # request with the returned `nextToken` value.
474
568
  #
475
569
  # @option params [String] :next_token
476
- # Token for paginating results.
570
+ # The `nextToken` value returned from a previous paginated
571
+ # `ListProfileTimes` request where `maxResults` was used and the results
572
+ # exceeded the value of that parameter. Pagination continues from the
573
+ # end of the previous results that returned the `nextToken` value.
574
+ #
575
+ # <note markdown="1"> This token should be treated as an opaque identifier that is only used
576
+ # to retrieve the next items in a list and not for other programmatic
577
+ # purposes.
578
+ #
579
+ # </note>
477
580
  #
478
581
  # @option params [String] :order_by
479
582
  # The order (ascending or descending by start time of the profile) to
480
- # list the profiles by. Defaults to TIMESTAMP\_DESCENDING.
583
+ # use when listing profiles. Defaults to `TIMESTAMP_DESCENDING`.
481
584
  #
482
585
  # @option params [required, String] :period
483
- # The aggregation period to list the profiles for.
586
+ # The aggregation period.
484
587
  #
485
588
  # @option params [required, String] :profiling_group_name
486
589
  # The name of the profiling group.
487
590
  #
488
591
  # @option params [required, Time,DateTime,Date,Integer,String] :start_time
489
- # The start time of the time range to list the profiles from.
592
+ # The start time of the time range from which to list the profiles.
490
593
  #
491
594
  # @return [Types::ListProfileTimesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
492
595
  #
493
596
  # * {Types::ListProfileTimesResponse#next_token #next_token} => String
494
597
  # * {Types::ListProfileTimesResponse#profile_times #profile_times} => Array&lt;Types::ProfileTime&gt;
495
598
  #
599
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
600
+ #
496
601
  # @example Request syntax with placeholder values
497
602
  #
498
603
  # resp = client.list_profile_times({
@@ -520,17 +625,31 @@ module Aws::CodeGuruProfiler
520
625
  req.send_request(options)
521
626
  end
522
627
 
523
- # List profiling groups in the account.
628
+ # Lists profiling groups.
524
629
  #
525
630
  # @option params [Boolean] :include_description
526
- # If set to true, returns the full description of the profiling groups
527
- # instead of the names. Defaults to false.
631
+ # A Boolean value indicating whether to include a description.
528
632
  #
529
633
  # @option params [Integer] :max_results
530
- # Upper bound on the number of results to list in a single call.
634
+ # The maximum number of profiling groups results returned by
635
+ # `ListProfilingGroups` in paginated output. When this parameter is
636
+ # used, `ListProfilingGroups` only returns `maxResults` results in a
637
+ # single page along with a `nextToken` response element. The remaining
638
+ # results of the initial request can be seen by sending another
639
+ # `ListProfilingGroups` request with the returned `nextToken` value.
531
640
  #
532
641
  # @option params [String] :next_token
533
- # Token for paginating results.
642
+ # The `nextToken` value returned from a previous paginated
643
+ # `ListProfilingGroups` request where `maxResults` was used and the
644
+ # results exceeded the value of that parameter. Pagination continues
645
+ # from the end of the previous results that returned the `nextToken`
646
+ # value.
647
+ #
648
+ # <note markdown="1"> This token should be treated as an opaque identifier that is only used
649
+ # to retrieve the next items in a list and not for other programmatic
650
+ # purposes.
651
+ #
652
+ # </note>
534
653
  #
535
654
  # @return [Types::ListProfilingGroupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
536
655
  #
@@ -538,6 +657,8 @@ module Aws::CodeGuruProfiler
538
657
  # * {Types::ListProfilingGroupsResponse#profiling_group_names #profiling_group_names} => Array&lt;String&gt;
539
658
  # * {Types::ListProfilingGroupsResponse#profiling_groups #profiling_groups} => Array&lt;Types::ProfilingGroupDescription&gt;
540
659
  #
660
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
661
+ #
541
662
  # @example Request syntax with placeholder values
542
663
  #
543
664
  # resp = client.list_profiling_groups({
@@ -571,27 +692,15 @@ module Aws::CodeGuruProfiler
571
692
  req.send_request(options)
572
693
  end
573
694
 
574
- # Submit profile collected by an agent belonging to a profiling group
575
- # for aggregation.
576
- #
577
695
  # @option params [required, String, IO] :agent_profile
578
- # The profile collected by an agent for a time range.
579
696
  #
580
697
  # @option params [required, String] :content_type
581
- # The content type of the agent profile in the payload. Recommended to
582
- # send the profile gzipped with content-type application/octet-stream.
583
- # Other accepted values are application/x-amzn-ion and application/json
584
- # for unzipped Ion and JSON respectively.
585
698
  #
586
699
  # @option params [String] :profile_token
587
- # Client generated token to deduplicate the agent profile during
588
- # aggregation.
589
- #
590
700
  # **A suitable default value is auto-generated.** You should normally
591
701
  # not need to pass this option.**
592
702
  #
593
703
  # @option params [required, String] :profiling_group_name
594
- # The name of the profiling group.
595
704
  #
596
705
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
597
706
  #
@@ -613,14 +722,99 @@ module Aws::CodeGuruProfiler
613
722
  req.send_request(options)
614
723
  end
615
724
 
616
- # Update a profiling group.
725
+ # Provides permission to the principals. This overwrites the existing
726
+ # permissions, and is not additive.
617
727
  #
618
- # @option params [required, Types::AgentOrchestrationConfig] :agent_orchestration_config
619
- # Remote configuration to configure the agents of the profiling group.
728
+ # @option params [required, String] :action_group
729
+ # The list of actions that the users and roles can perform on the
730
+ # profiling group.
731
+ #
732
+ # @option params [required, Array<String>] :principals
733
+ # The list of role and user ARNs or the accountId that needs access
734
+ # (wildcards are not allowed).
620
735
  #
621
736
  # @option params [required, String] :profiling_group_name
622
737
  # The name of the profiling group.
623
738
  #
739
+ # @option params [String] :revision_id
740
+ # A unique identifier for the current revision of the policy. This is
741
+ # required, if a policy exists for the profiling group. This is not
742
+ # required when creating the policy for the first time.
743
+ #
744
+ # @return [Types::PutPermissionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
745
+ #
746
+ # * {Types::PutPermissionResponse#policy #policy} => String
747
+ # * {Types::PutPermissionResponse#revision_id #revision_id} => String
748
+ #
749
+ # @example Request syntax with placeholder values
750
+ #
751
+ # resp = client.put_permission({
752
+ # action_group: "agentPermissions", # required, accepts agentPermissions
753
+ # principals: ["Principal"], # required
754
+ # profiling_group_name: "ProfilingGroupName", # required
755
+ # revision_id: "RevisionId",
756
+ # })
757
+ #
758
+ # @example Response structure
759
+ #
760
+ # resp.policy #=> String
761
+ # resp.revision_id #=> String
762
+ #
763
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/PutPermission AWS API Documentation
764
+ #
765
+ # @overload put_permission(params = {})
766
+ # @param [Hash] params ({})
767
+ def put_permission(params = {}, options = {})
768
+ req = build_request(:put_permission, params)
769
+ req.send_request(options)
770
+ end
771
+
772
+ # Removes statement for the provided action group from the policy.
773
+ #
774
+ # @option params [required, String] :action_group
775
+ # The list of actions that the users and roles can perform on the
776
+ # profiling group.
777
+ #
778
+ # @option params [required, String] :profiling_group_name
779
+ # The name of the profiling group.
780
+ #
781
+ # @option params [required, String] :revision_id
782
+ # A unique identifier for the current revision of the policy.
783
+ #
784
+ # @return [Types::RemovePermissionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
785
+ #
786
+ # * {Types::RemovePermissionResponse#policy #policy} => String
787
+ # * {Types::RemovePermissionResponse#revision_id #revision_id} => String
788
+ #
789
+ # @example Request syntax with placeholder values
790
+ #
791
+ # resp = client.remove_permission({
792
+ # action_group: "agentPermissions", # required, accepts agentPermissions
793
+ # profiling_group_name: "ProfilingGroupName", # required
794
+ # revision_id: "RevisionId", # required
795
+ # })
796
+ #
797
+ # @example Response structure
798
+ #
799
+ # resp.policy #=> String
800
+ # resp.revision_id #=> String
801
+ #
802
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/RemovePermission AWS API Documentation
803
+ #
804
+ # @overload remove_permission(params = {})
805
+ # @param [Hash] params ({})
806
+ def remove_permission(params = {}, options = {})
807
+ req = build_request(:remove_permission, params)
808
+ req.send_request(options)
809
+ end
810
+
811
+ # Updates a profiling group.
812
+ #
813
+ # @option params [required, Types::AgentOrchestrationConfig] :agent_orchestration_config
814
+ #
815
+ # @option params [required, String] :profiling_group_name
816
+ # The name of the profiling group to update.
817
+ #
624
818
  # @return [Types::UpdateProfilingGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
625
819
  #
626
820
  # * {Types::UpdateProfilingGroupResponse#profiling_group #profiling_group} => Types::ProfilingGroupDescription
@@ -668,7 +862,7 @@ module Aws::CodeGuruProfiler
668
862
  params: params,
669
863
  config: config)
670
864
  context[:gem_name] = 'aws-sdk-codeguruprofiler'
671
- context[:gem_version] = '1.0.0'
865
+ context[:gem_version] = '1.5.0'
672
866
  Seahorse::Client::Request.new(handlers, context)
673
867
  end
674
868