aws-sdk-codegurureviewer 1.7.1 → 1.12.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: f6da7d158762ff6da67e8b399b3ac1e1ef320050e90dee794b02e118aece00d4
4
- data.tar.gz: e1177b3e7950812bfc7f18281107a117642eb9416fd6642c3fcc21ae90b52a41
3
+ metadata.gz: 1a548bb9e62ffde1a29973534325e12e3c6bd18805976ffdfeb25ce0c22ae239
4
+ data.tar.gz: 699d7d9ab105a60bd02bb2a7c2de2b8a9b2fc3733e92c8ad56b7078403a77e51
5
5
  SHA512:
6
- metadata.gz: ff03d52665593e7b2f92496740040a85e4cc3ca829f74afe05f9b76d14d1fa74175bd65b1058b906832e60263c86edd54d0470f8d0e3f37620e787c643f4f0da
7
- data.tar.gz: a9376b5aad07946cb14f63eafeb4d82b11d2136efd7adf524df993ce0437ee1941fb606730c51ee061b357f82d675bb3efae760ceddb706e9b462257611b7e5f
6
+ metadata.gz: 7f39127ea3c5a6d0adfd782caa992aa23082f6e309f4ac2e9218c00a465fc7fb5f6e886c1a4393b585e734ad31b6ade64e1bbf199cabc4128851607e40eeae51
7
+ data.tar.gz: a5c1e60574033974419baefe1fb93311aea38d272b9700dc532f848a239849819979f96e22c60315852b0736f44a76ccab55af143b45ac46fb2d5b0f81f04ead
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -5,6 +7,7 @@
5
7
  #
6
8
  # WARNING ABOUT GENERATED CODE
7
9
 
10
+
8
11
  require 'aws-sdk-core'
9
12
  require 'aws-sigv4'
10
13
 
@@ -42,9 +45,9 @@ require_relative 'aws-sdk-codegurureviewer/customizations'
42
45
  #
43
46
  # See {Errors} for more information.
44
47
  #
45
- # @service
48
+ # @!group service
46
49
  module Aws::CodeGuruReviewer
47
50
 
48
- GEM_VERSION = '1.7.1'
51
+ GEM_VERSION = '1.12.0'
49
52
 
50
53
  end
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -83,13 +85,28 @@ module Aws::CodeGuruReviewer
83
85
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
84
86
  # credentials.
85
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
+ #
86
102
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
87
103
  # from an EC2 IMDS on an EC2 instance.
88
104
  #
89
- # * `Aws::SharedCredentials` - Used for loading credentials from a
90
- # shared file, such as `~/.aws/config`.
105
+ # * `Aws::ECSCredentials` - Used for loading credentials from
106
+ # instances running in ECS.
91
107
  #
92
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
108
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
109
+ # from the Cognito Identity service.
93
110
  #
94
111
  # When `:credentials` are not configured directly, the following
95
112
  # locations will be searched for credentials:
@@ -99,10 +116,10 @@ module Aws::CodeGuruReviewer
99
116
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
100
117
  # * `~/.aws/credentials`
101
118
  # * `~/.aws/config`
102
- # * EC2 IMDS instance profile - When used by default, the timeouts are
103
- # very aggressive. Construct and pass an instance of
104
- # `Aws::InstanceProfileCredentails` to enable retries and extended
105
- # 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.
106
123
  #
107
124
  # @option options [required, String] :region
108
125
  # The AWS region to connect to. The configured `:region` is
@@ -310,38 +327,41 @@ module Aws::CodeGuruReviewer
310
327
 
311
328
  # @!group API Operations
312
329
 
313
- # Associates an AWS CodeCommit repository with Amazon CodeGuru Reviewer.
314
- # When you associate an AWS CodeCommit repository with Amazon CodeGuru
315
- # Reviewer, Amazon CodeGuru Reviewer will provide recommendations for
316
- # each pull request raised within the repository. You can view
317
- # recommendations in the AWS CodeCommit repository.
330
+ # Use to associate an AWS CodeCommit repository or a repostory managed
331
+ # by AWS CodeStar Connections with Amazon CodeGuru Reviewer. When you
332
+ # associate a repository, CodeGuru Reviewer reviews source code changes
333
+ # in the repository's pull requests and provides automatic
334
+ # recommendations. You can view recommendations using the CodeGuru
335
+ # Reviewer console. For more information, see [Recommendations in Amazon
336
+ # CodeGuru Reviewer][1] in the *Amazon CodeGuru Reviewer User Guide.*
318
337
  #
319
- # You can associate a GitHub repository using the Amazon CodeGuru
320
- # Reviewer console.
338
+ # If you associate a CodeCommit repository, it must be in the same AWS
339
+ # Region and AWS account where its CodeGuru Reviewer code reviews are
340
+ # configured.
321
341
  #
322
- # @option params [required, Types::Repository] :repository
323
- # The repository to associate.
342
+ # Bitbucket and GitHub Enterprise Server repositories are managed by AWS
343
+ # CodeStar Connections to connect to CodeGuru Reviewer. For more
344
+ # information, see [Connect to a repository source provider][2] in the
345
+ # *Amazon CodeGuru Reviewer User Guide.*
324
346
  #
325
- # @option params [String] :client_request_token
326
- # Unique, case-sensitive identifier that you provide to ensure the
327
- # idempotency of the request.
347
+ # <note markdown="1"> You cannot use the CodeGuru Reviewer SDK or the AWS CLI to associate a
348
+ # GitHub repository with Amazon CodeGuru Reviewer. To associate a GitHub
349
+ # repository, use the console. For more information, see [Getting
350
+ # started with CodeGuru Reviewer][3] in the *CodeGuru Reviewer User
351
+ # Guide.*
352
+ #
353
+ # </note>
328
354
  #
329
- # To add a new repository association, this parameter specifies a unique
330
- # identifier for the new repository association that helps ensure
331
- # idempotency.
332
355
  #
333
- # If you use the AWS CLI or one of the AWS SDKs to call this operation,
334
- # you can leave this parameter empty. The CLI or SDK generates a random
335
- # UUID for you and includes that in the request. If you don't use the
336
- # SDK and instead generate a raw HTTP request to the Secrets Manager
337
- # service endpoint, you must generate a ClientRequestToken yourself for
338
- # new versions and include that value in the request.
339
356
  #
340
- # You typically interact with this value if you implement your own retry
341
- # logic and want to ensure that a given repository association is not
342
- # created twice. We recommend that you generate a UUID-type value to
343
- # ensure uniqueness within the specified repository association.
357
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/recommendations.html
358
+ # [2]: https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/reviewer-ug/step-one.html#select-repository-source-provider
359
+ # [3]: https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/getting-started-with-guru.html
360
+ #
361
+ # @option params [required, Types::Repository] :repository
362
+ # The repository to associate.
344
363
  #
364
+ # @option params [String] :client_request_token
345
365
  # Amazon CodeGuru Reviewer uses this value to prevent the accidental
346
366
  # creation of duplicate repository associations if there are failures
347
367
  # and retries.
@@ -365,6 +385,11 @@ module Aws::CodeGuruReviewer
365
385
  # connection_arn: "ConnectionArn", # required
366
386
  # owner: "Owner", # required
367
387
  # },
388
+ # git_hub_enterprise_server: {
389
+ # name: "Name", # required
390
+ # connection_arn: "ConnectionArn", # required
391
+ # owner: "Owner", # required
392
+ # },
368
393
  # },
369
394
  # client_request_token: "ClientRequestToken",
370
395
  # })
@@ -376,7 +401,7 @@ module Aws::CodeGuruReviewer
376
401
  # resp.repository_association.connection_arn #=> String
377
402
  # resp.repository_association.name #=> String
378
403
  # resp.repository_association.owner #=> String
379
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
404
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
380
405
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
381
406
  # resp.repository_association.state_reason #=> String
382
407
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -391,11 +416,94 @@ module Aws::CodeGuruReviewer
391
416
  req.send_request(options)
392
417
  end
393
418
 
394
- # Returns the metadaata associated with the code review along with its
419
+ # Use to create a code review for a repository analysis.
420
+ #
421
+ # @option params [required, String] :name
422
+ # The name of the code review. Each code review of the same code review
423
+ # type must have a unique name in your AWS account.
424
+ #
425
+ # @option params [required, String] :repository_association_arn
426
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
427
+ # object. You can retrieve this ARN by calling `ListRepositories`.
428
+ #
429
+ # A code review can only be created on an associated repository. This is
430
+ # the ARN of the associated repository.
431
+ #
432
+ #
433
+ #
434
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
435
+ #
436
+ # @option params [required, Types::CodeReviewType] :type
437
+ # The type of code review to create. This is specified using a [
438
+ # `CodeReviewType` ][1] object.
439
+ #
440
+ #
441
+ #
442
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReviewType.html
443
+ #
444
+ # @option params [String] :client_request_token
445
+ # Amazon CodeGuru Reviewer uses this value to prevent the accidental
446
+ # creation of duplicate code reviews if there are failures and retries.
447
+ #
448
+ # **A suitable default value is auto-generated.** You should normally
449
+ # not need to pass this option.**
450
+ #
451
+ # @return [Types::CreateCodeReviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
452
+ #
453
+ # * {Types::CreateCodeReviewResponse#code_review #code_review} => Types::CodeReview
454
+ #
455
+ # @example Request syntax with placeholder values
456
+ #
457
+ # resp = client.create_code_review({
458
+ # name: "CodeReviewName", # required
459
+ # repository_association_arn: "Arn", # required
460
+ # type: { # required
461
+ # repository_analysis: { # required
462
+ # repository_head: { # required
463
+ # branch_name: "BranchName", # required
464
+ # },
465
+ # },
466
+ # },
467
+ # client_request_token: "ClientRequestToken",
468
+ # })
469
+ #
470
+ # @example Response structure
471
+ #
472
+ # resp.code_review.name #=> String
473
+ # resp.code_review.code_review_arn #=> String
474
+ # resp.code_review.repository_name #=> String
475
+ # resp.code_review.owner #=> String
476
+ # resp.code_review.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
477
+ # resp.code_review.state #=> String, one of "Completed", "Pending", "Failed", "Deleting"
478
+ # resp.code_review.state_reason #=> String
479
+ # resp.code_review.created_time_stamp #=> Time
480
+ # resp.code_review.last_updated_time_stamp #=> Time
481
+ # resp.code_review.type #=> String, one of "PullRequest", "RepositoryAnalysis"
482
+ # resp.code_review.pull_request_id #=> String
483
+ # resp.code_review.source_code_type.commit_diff.source_commit #=> String
484
+ # resp.code_review.source_code_type.commit_diff.destination_commit #=> String
485
+ # resp.code_review.source_code_type.repository_head.branch_name #=> String
486
+ # resp.code_review.metrics.metered_lines_of_code_count #=> Integer
487
+ # resp.code_review.metrics.findings_count #=> Integer
488
+ #
489
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/CreateCodeReview AWS API Documentation
490
+ #
491
+ # @overload create_code_review(params = {})
492
+ # @param [Hash] params ({})
493
+ def create_code_review(params = {}, options = {})
494
+ req = build_request(:create_code_review, params)
495
+ req.send_request(options)
496
+ end
497
+
498
+ # Returns the metadata associated with the code review along with its
395
499
  # status.
396
500
  #
397
501
  # @option params [required, String] :code_review_arn
398
- # The Amazon Resource Name (ARN) of the code review to describe.
502
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
503
+ #
504
+ #
505
+ #
506
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
399
507
  #
400
508
  # @return [Types::DescribeCodeReviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
401
509
  #
@@ -413,15 +521,16 @@ module Aws::CodeGuruReviewer
413
521
  # resp.code_review.code_review_arn #=> String
414
522
  # resp.code_review.repository_name #=> String
415
523
  # resp.code_review.owner #=> String
416
- # resp.code_review.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
524
+ # resp.code_review.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
417
525
  # resp.code_review.state #=> String, one of "Completed", "Pending", "Failed", "Deleting"
418
526
  # resp.code_review.state_reason #=> String
419
527
  # resp.code_review.created_time_stamp #=> Time
420
528
  # resp.code_review.last_updated_time_stamp #=> Time
421
- # resp.code_review.type #=> String, one of "PullRequest"
529
+ # resp.code_review.type #=> String, one of "PullRequest", "RepositoryAnalysis"
422
530
  # resp.code_review.pull_request_id #=> String
423
531
  # resp.code_review.source_code_type.commit_diff.source_commit #=> String
424
532
  # resp.code_review.source_code_type.commit_diff.destination_commit #=> String
533
+ # resp.code_review.source_code_type.repository_head.branch_name #=> String
425
534
  # resp.code_review.metrics.metered_lines_of_code_count #=> Integer
426
535
  # resp.code_review.metrics.findings_count #=> Integer
427
536
  #
@@ -438,7 +547,11 @@ module Aws::CodeGuruReviewer
438
547
  # recommendation.
439
548
  #
440
549
  # @option params [required, String] :code_review_arn
441
- # The Amazon Resource Name (ARN) that identifies the code review.
550
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
551
+ #
552
+ #
553
+ #
554
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
442
555
  #
443
556
  # @option params [required, String] :recommendation_id
444
557
  # The recommendation ID that can be used to track the provided
@@ -448,6 +561,15 @@ module Aws::CodeGuruReviewer
448
561
  # Optional parameter to describe the feedback for a given user. If this
449
562
  # is not supplied, it defaults to the user making the request.
450
563
  #
564
+ # The `UserId` is an IAM principal that can be specified as an AWS
565
+ # account ID or an Amazon Resource Name (ARN). For more information, see
566
+ # [ Specifying a Principal][1] in the *AWS Identity and Access
567
+ # Management User Guide*.
568
+ #
569
+ #
570
+ #
571
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
572
+ #
451
573
  # @return [Types::DescribeRecommendationFeedbackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
452
574
  #
453
575
  # * {Types::DescribeRecommendationFeedbackResponse#recommendation_feedback #recommendation_feedback} => Types::RecommendationFeedback
@@ -479,11 +601,20 @@ module Aws::CodeGuruReviewer
479
601
  req.send_request(options)
480
602
  end
481
603
 
482
- # Describes a repository association.
604
+ # Returns a [ `RepositoryAssociation` ][1] object that contains
605
+ # information about the requested repository association.
606
+ #
607
+ #
608
+ #
609
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
483
610
  #
484
611
  # @option params [required, String] :association_arn
485
- # The Amazon Resource Name (ARN) identifying the association. You can
486
- # retrieve this ARN by calling `ListRepositories`.
612
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
613
+ # object. You can retrieve this ARN by calling `ListRepositories`.
614
+ #
615
+ #
616
+ #
617
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
487
618
  #
488
619
  # @return [Types::DescribeRepositoryAssociationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
489
620
  #
@@ -502,7 +633,7 @@ module Aws::CodeGuruReviewer
502
633
  # resp.repository_association.connection_arn #=> String
503
634
  # resp.repository_association.name #=> String
504
635
  # resp.repository_association.owner #=> String
505
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
636
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
506
637
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
507
638
  # resp.repository_association.state_reason #=> String
508
639
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -521,7 +652,12 @@ module Aws::CodeGuruReviewer
521
652
  # repository.
522
653
  #
523
654
  # @option params [required, String] :association_arn
524
- # The Amazon Resource Name (ARN) identifying the association.
655
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
656
+ # object. You can retrieve this ARN by calling `ListRepositories`.
657
+ #
658
+ #
659
+ #
660
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
525
661
  #
526
662
  # @return [Types::DisassociateRepositoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
527
663
  #
@@ -540,7 +676,7 @@ module Aws::CodeGuruReviewer
540
676
  # resp.repository_association.connection_arn #=> String
541
677
  # resp.repository_association.name #=> String
542
678
  # resp.repository_association.owner #=> String
543
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
679
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
544
680
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
545
681
  # resp.repository_association.state_reason #=> String
546
682
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -560,13 +696,23 @@ module Aws::CodeGuruReviewer
560
696
  #
561
697
  # @option params [Array<String>] :provider_types
562
698
  # List of provider types for filtering that needs to be applied before
563
- # displaying the result. For example, "providerTypes=\[GitHub\]" will
564
- # list code reviews from GitHub.
699
+ # displaying the result. For example, `providerTypes=[GitHub]` lists
700
+ # code reviews from GitHub.
565
701
  #
566
702
  # @option params [Array<String>] :states
567
703
  # List of states for filtering that needs to be applied before
568
- # displaying the result. For example, "states=\[Pending\]" will list
569
- # code reviews in the Pending state.
704
+ # displaying the result. For example, `states=[Pending]` lists code
705
+ # reviews in the Pending state.
706
+ #
707
+ # The valid code review states are:
708
+ #
709
+ # * `Completed`\: The code review is complete.
710
+ #
711
+ # * `Pending`\: The code review started and has not completed or failed.
712
+ #
713
+ # * `Failed`\: The code review failed.
714
+ #
715
+ # * `Deleting`\: The code review is being deleted.
570
716
  #
571
717
  # @option params [Array<String>] :repository_names
572
718
  # List of repository names for filtering that needs to be applied before
@@ -595,10 +741,10 @@ module Aws::CodeGuruReviewer
595
741
  # @example Request syntax with placeholder values
596
742
  #
597
743
  # resp = client.list_code_reviews({
598
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
744
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
599
745
  # states: ["Completed"], # accepts Completed, Pending, Failed, Deleting
600
746
  # repository_names: ["Name"],
601
- # type: "PullRequest", # required, accepts PullRequest
747
+ # type: "PullRequest", # required, accepts PullRequest, RepositoryAnalysis
602
748
  # max_results: 1,
603
749
  # next_token: "NextToken",
604
750
  # })
@@ -610,11 +756,11 @@ module Aws::CodeGuruReviewer
610
756
  # resp.code_review_summaries[0].code_review_arn #=> String
611
757
  # resp.code_review_summaries[0].repository_name #=> String
612
758
  # resp.code_review_summaries[0].owner #=> String
613
- # resp.code_review_summaries[0].provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
759
+ # resp.code_review_summaries[0].provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
614
760
  # resp.code_review_summaries[0].state #=> String, one of "Completed", "Pending", "Failed", "Deleting"
615
761
  # resp.code_review_summaries[0].created_time_stamp #=> Time
616
762
  # resp.code_review_summaries[0].last_updated_time_stamp #=> Time
617
- # resp.code_review_summaries[0].type #=> String, one of "PullRequest"
763
+ # resp.code_review_summaries[0].type #=> String, one of "PullRequest", "RepositoryAnalysis"
618
764
  # resp.code_review_summaries[0].pull_request_id #=> String
619
765
  # resp.code_review_summaries[0].metrics_summary.metered_lines_of_code_count #=> Integer
620
766
  # resp.code_review_summaries[0].metrics_summary.findings_count #=> Integer
@@ -629,33 +775,46 @@ module Aws::CodeGuruReviewer
629
775
  req.send_request(options)
630
776
  end
631
777
 
632
- # Lists the customer feedback for a CodeGuru Reviewer recommendation for
633
- # all users. This API will be used from the console to extract the
634
- # previously given feedback by the user to pre-populate the feedback
635
- # emojis for all recommendations.
778
+ # Returns a list of [ `RecommendationFeedbackSummary` ][1] objects that
779
+ # contain customer recommendation feedback for all CodeGuru Reviewer
780
+ # users.
781
+ #
782
+ #
783
+ #
784
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RecommendationFeedbackSummary.html
636
785
  #
637
786
  # @option params [String] :next_token
638
- # If nextToken is returned, there are more results available. The value
639
- # of nextToken is a unique pagination token for each page. Make the call
640
- # again using the returned token to retrieve the next page. Keep all
641
- # other arguments unchanged.
787
+ # If `nextToken` is returned, there are more results available. The
788
+ # value of nextToken is a unique pagination token for each page. Make
789
+ # the call again using the returned token to retrieve the next page.
790
+ # Keep all other arguments unchanged.
642
791
  #
643
792
  # @option params [Integer] :max_results
644
793
  # The maximum number of results that are returned per call. The default
645
794
  # is 100.
646
795
  #
647
796
  # @option params [required, String] :code_review_arn
648
- # The Amazon Resource Name (ARN) that identifies the code review.
797
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
798
+ #
799
+ #
800
+ #
801
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
649
802
  #
650
803
  # @option params [Array<String>] :user_ids
651
- # Filter on userIds that need to be applied before displaying the
652
- # result. This can be used to query all the recommendation feedback for
653
- # a code review from a given user.
804
+ # An AWS user's account ID or Amazon Resource Name (ARN). Use this ID
805
+ # to query the recommendation feedback for a code review from that user.
806
+ #
807
+ # The `UserId` is an IAM principal that can be specified as an AWS
808
+ # account ID or an Amazon Resource Name (ARN). For more information, see
809
+ # [ Specifying a Principal][1] in the *AWS Identity and Access
810
+ # Management User Guide*.
811
+ #
812
+ #
813
+ #
814
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
654
815
  #
655
816
  # @option params [Array<String>] :recommendation_ids
656
- # Filter on recommendationIds that need to be applied before displaying
657
- # the result. This can be used to query all the recommendation feedback
658
- # for a given recommendation.
817
+ # Used to query the recommendation feedback for a given recommendation.
659
818
  #
660
819
  # @return [Types::ListRecommendationFeedbackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
661
820
  #
@@ -702,7 +861,11 @@ module Aws::CodeGuruReviewer
702
861
  # is 100.
703
862
  #
704
863
  # @option params [required, String] :code_review_arn
705
- # The Amazon Resource Name (ARN) of the code review to describe.
864
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
865
+ #
866
+ #
867
+ #
868
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
706
869
  #
707
870
  # @return [Types::ListRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
708
871
  #
@@ -738,23 +901,58 @@ module Aws::CodeGuruReviewer
738
901
  req.send_request(options)
739
902
  end
740
903
 
741
- # Lists repository associations. You can optionally filter on one or
742
- # more of the following recommendation properties: provider types,
743
- # states, names, and owners.
904
+ # Returns a list of [ `RepositoryAssociationSummary` ][1] objects that
905
+ # contain summary information about a repository association. You can
906
+ # filter the returned list by [ `ProviderType` ][2], [ `Name` ][3], [
907
+ # `State` ][4], and [ `Owner` ][5].
908
+ #
909
+ #
910
+ #
911
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html
912
+ # [2]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-ProviderType
913
+ # [3]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-Name
914
+ # [4]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-State
915
+ # [5]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-Owner
744
916
  #
745
917
  # @option params [Array<String>] :provider_types
746
918
  # List of provider types to use as a filter.
747
919
  #
748
920
  # @option params [Array<String>] :states
749
- # List of states to use as a filter.
921
+ # List of repository association states to use as a filter.
922
+ #
923
+ # The valid repository association states are:
924
+ #
925
+ # * **Associated**\: The repository association is complete.
926
+ #
927
+ # * **Associating**\: CodeGuru Reviewer is:
928
+ #
929
+ # * Setting up pull request notifications. This is required for pull
930
+ # requests to trigger a CodeGuru Reviewer review.
931
+ #
932
+ # <note markdown="1"> If your repository `ProviderType` is `GitHub`, `GitHub Enterprise
933
+ # Server`, or `Bitbucket`, CodeGuru Reviewer creates webhooks in
934
+ # your repository to trigger CodeGuru Reviewer reviews. If you
935
+ # delete these webhooks, reviews of code in your repository cannot
936
+ # be triggered.
937
+ #
938
+ # </note>
939
+ #
940
+ # * Setting up source code access. This is required for CodeGuru
941
+ # Reviewer to securely clone code in your repository.
942
+ #
943
+ # * **Failed**\: The repository failed to associate or disassociate.
944
+ #
945
+ # * **Disassociating**\: CodeGuru Reviewer is removing the repository's
946
+ # pull request notifications and source code access.
750
947
  #
751
948
  # @option params [Array<String>] :names
752
949
  # List of repository names to use as a filter.
753
950
  #
754
951
  # @option params [Array<String>] :owners
755
- # List of owners to use as a filter. For GitHub, this is name of the
756
- # GitHub account that was used to associate the repository. For AWS
757
- # CodeCommit, it is the name of the CodeCommit account that was used to
952
+ # List of owners to use as a filter. For AWS CodeCommit, it is the name
953
+ # of the CodeCommit account that was used to associate the repository.
954
+ # For other repository source providers, such as Bitbucket and GitHub
955
+ # Enterprise Server, this is name of the account that was used to
758
956
  # associate the repository.
759
957
  #
760
958
  # @option params [Integer] :max_results
@@ -764,8 +962,8 @@ module Aws::CodeGuruReviewer
764
962
  # results in a single page with a `nextToken` response element. The
765
963
  # remaining results of the initial request can be seen by sending
766
964
  # another `ListRepositoryAssociations` request with the returned
767
- # `nextToken` value. This value can be between 1 and 25. If this
768
- # parameter is not used, `ListRepositoryAssociations` returns up to 25
965
+ # `nextToken` value. This value can be between 1 and 100. If this
966
+ # parameter is not used, `ListRepositoryAssociations` returns up to 100
769
967
  # results and a `nextToken` value if applicable.
770
968
  #
771
969
  # @option params [String] :next_token
@@ -790,7 +988,7 @@ module Aws::CodeGuruReviewer
790
988
  # @example Request syntax with placeholder values
791
989
  #
792
990
  # resp = client.list_repository_associations({
793
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
991
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
794
992
  # states: ["Associated"], # accepts Associated, Associating, Failed, Disassociating
795
993
  # names: ["Name"],
796
994
  # owners: ["Owner"],
@@ -807,7 +1005,7 @@ module Aws::CodeGuruReviewer
807
1005
  # resp.repository_association_summaries[0].association_id #=> String
808
1006
  # resp.repository_association_summaries[0].name #=> String
809
1007
  # resp.repository_association_summaries[0].owner #=> String
810
- # resp.repository_association_summaries[0].provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
1008
+ # resp.repository_association_summaries[0].provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
811
1009
  # resp.repository_association_summaries[0].state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
812
1010
  # resp.next_token #=> String
813
1011
  #
@@ -820,12 +1018,16 @@ module Aws::CodeGuruReviewer
820
1018
  req.send_request(options)
821
1019
  end
822
1020
 
823
- # Stores customer feedback for a CodeGuru-Reviewer recommendation. When
1021
+ # Stores customer feedback for a CodeGuru Reviewer recommendation. When
824
1022
  # this API is called again with different reactions the previous
825
1023
  # feedback is overwritten.
826
1024
  #
827
1025
  # @option params [required, String] :code_review_arn
828
- # The Amazon Resource Name (ARN) that identifies the code review.
1026
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
1027
+ #
1028
+ #
1029
+ #
1030
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
829
1031
  #
830
1032
  # @option params [required, String] :recommendation_id
831
1033
  # The recommendation ID that can be used to track the provided
@@ -867,7 +1069,7 @@ module Aws::CodeGuruReviewer
867
1069
  params: params,
868
1070
  config: config)
869
1071
  context[:gem_name] = 'aws-sdk-codegurureviewer'
870
- context[:gem_version] = '1.7.1'
1072
+ context[:gem_version] = '1.12.0'
871
1073
  Seahorse::Client::Request.new(handlers, context)
872
1074
  end
873
1075