aws-sdk-codeguruprofiler 1.0.0 → 1.5.0

Sign up to get free protection for your applications and to get access to all the features.
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