aws-sdk-codegurureviewer 1.8.0 → 1.9.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: 0ff512e283508d54f7007eb4e0dcb3c34882ca2729ba5dfeb52ea84eaf249812
4
- data.tar.gz: 17c38e9367138635c3e6bc5b20fa90dd04777825efe390431cbf010396eb3127
3
+ metadata.gz: 97877fd3223aa07ecea5b6eaa4080b18b3a3322ad037404fa9836cd4e1d472e4
4
+ data.tar.gz: 17b2086f833788c4e344de3b2b85ecd8b4c70250ef7515dddc8b75e789cbf424
5
5
  SHA512:
6
- metadata.gz: 792cef40fcdef52613b7dec75815facbef1f79d606c41c3df68553937371715061db1b35664d4311555cd3f691d0f0351c2f5b4f65c84ff14ee76ebf6e720836
7
- data.tar.gz: 53426e4a660cf27740ac6d41c37684403fa58da7efb883b696f1867307260cf702fa5c42a5154b4b65d2d785caaf87e771e1ebeeeb73f4e0ce71db943fb19b42
6
+ metadata.gz: de05bcf32ecccd4fc8b2271fe3572076437c6007cac4164d93105963ad187b04556a14819fb98f8df642b4a49a7b48b65f0f93f2d945bbbf5fde0c07cf064bc0
7
+ data.tar.gz: d93cbeed0e064455f7c7b918b6dd53201a53f845746d042a99d276f0d5cf13495be2019671f5317b82cbd4e6a61ff80455db23fbb749e32b2c8e7d62792677b1
@@ -47,6 +47,6 @@ require_relative 'aws-sdk-codegurureviewer/customizations'
47
47
  # @service
48
48
  module Aws::CodeGuruReviewer
49
49
 
50
- GEM_VERSION = '1.8.0'
50
+ GEM_VERSION = '1.9.0'
51
51
 
52
52
  end
@@ -312,14 +312,36 @@ module Aws::CodeGuruReviewer
312
312
 
313
313
  # @!group API Operations
314
314
 
315
- # Associates an AWS CodeCommit repository with Amazon CodeGuru Reviewer.
316
- # When you associate an AWS CodeCommit repository with Amazon CodeGuru
317
- # Reviewer, Amazon CodeGuru Reviewer will provide recommendations for
318
- # each pull request raised within the repository. You can view
319
- # recommendations in the AWS CodeCommit repository.
315
+ # Use to associate an AWS CodeCommit repository or a repostory managed
316
+ # by AWS CodeStar Connections with Amazon CodeGuru Reviewer. When you
317
+ # associate a repository, CodeGuru Reviewer reviews source code changes
318
+ # in the repository's pull requests and provides automatic
319
+ # recommendations. You can view recommendations using the CodeGuru
320
+ # Reviewer console. For more information, see [Recommendations in Amazon
321
+ # CodeGuru Reviewer][1] in the *Amazon CodeGuru Reviewer User Guide.*
320
322
  #
321
- # You can associate a GitHub repository using the Amazon CodeGuru
322
- # Reviewer console.
323
+ # If you associate a CodeCommit repository, it must be in the same AWS
324
+ # Region and AWS account where its CodeGuru Reviewer code reviews are
325
+ # configured.
326
+ #
327
+ # Bitbucket and GitHub Enterprise Server repositories are managed by AWS
328
+ # CodeStar Connections to connect to CodeGuru Reviewer. For more
329
+ # information, see [Connect to a repository source provider][2] in the
330
+ # *Amazon CodeGuru Reviewer User Guide.*
331
+ #
332
+ # <note markdown="1"> You cannot use the CodeGuru Reviewer SDK or the AWS CLI to associate a
333
+ # GitHub repository with Amazon CodeGuru Reviewer. To associate a GitHub
334
+ # repository, use the console. For more information, see [Getting
335
+ # started with CodeGuru Reviewer][3] in the *CodeGuru Reviewer User
336
+ # Guide.*
337
+ #
338
+ # </note>
339
+ #
340
+ #
341
+ #
342
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/recommendations.html
343
+ # [2]: https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/reviewer-ug/step-one.html#select-repository-source-provider
344
+ # [3]: https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/getting-started-with-guru.html
323
345
  #
324
346
  # @option params [required, Types::Repository] :repository
325
347
  # The repository to associate.
@@ -367,6 +389,11 @@ module Aws::CodeGuruReviewer
367
389
  # connection_arn: "ConnectionArn", # required
368
390
  # owner: "Owner", # required
369
391
  # },
392
+ # git_hub_enterprise_server: {
393
+ # name: "Name", # required
394
+ # connection_arn: "ConnectionArn", # required
395
+ # owner: "Owner", # required
396
+ # },
370
397
  # },
371
398
  # client_request_token: "ClientRequestToken",
372
399
  # })
@@ -378,7 +405,7 @@ module Aws::CodeGuruReviewer
378
405
  # resp.repository_association.connection_arn #=> String
379
406
  # resp.repository_association.name #=> String
380
407
  # resp.repository_association.owner #=> String
381
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
408
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
382
409
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
383
410
  # resp.repository_association.state_reason #=> String
384
411
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -393,11 +420,15 @@ module Aws::CodeGuruReviewer
393
420
  req.send_request(options)
394
421
  end
395
422
 
396
- # Returns the metadaata associated with the code review along with its
423
+ # Returns the metadata associated with the code review along with its
397
424
  # status.
398
425
  #
399
426
  # @option params [required, String] :code_review_arn
400
- # The Amazon Resource Name (ARN) of the code review to describe.
427
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
428
+ #
429
+ #
430
+ #
431
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
401
432
  #
402
433
  # @return [Types::DescribeCodeReviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
403
434
  #
@@ -415,7 +446,7 @@ module Aws::CodeGuruReviewer
415
446
  # resp.code_review.code_review_arn #=> String
416
447
  # resp.code_review.repository_name #=> String
417
448
  # resp.code_review.owner #=> String
418
- # resp.code_review.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
449
+ # resp.code_review.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
419
450
  # resp.code_review.state #=> String, one of "Completed", "Pending", "Failed", "Deleting"
420
451
  # resp.code_review.state_reason #=> String
421
452
  # resp.code_review.created_time_stamp #=> Time
@@ -440,7 +471,11 @@ module Aws::CodeGuruReviewer
440
471
  # recommendation.
441
472
  #
442
473
  # @option params [required, String] :code_review_arn
443
- # The Amazon Resource Name (ARN) that identifies the code review.
474
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
475
+ #
476
+ #
477
+ #
478
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
444
479
  #
445
480
  # @option params [required, String] :recommendation_id
446
481
  # The recommendation ID that can be used to track the provided
@@ -450,6 +485,15 @@ module Aws::CodeGuruReviewer
450
485
  # Optional parameter to describe the feedback for a given user. If this
451
486
  # is not supplied, it defaults to the user making the request.
452
487
  #
488
+ # The `UserId` is an IAM principal that can be specified as an AWS
489
+ # account ID or an Amazon Resource Name (ARN). For more information, see
490
+ # [ Specifying a Principal][1] in the *AWS Identity and Access
491
+ # Management User Guide*.
492
+ #
493
+ #
494
+ #
495
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
496
+ #
453
497
  # @return [Types::DescribeRecommendationFeedbackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
454
498
  #
455
499
  # * {Types::DescribeRecommendationFeedbackResponse#recommendation_feedback #recommendation_feedback} => Types::RecommendationFeedback
@@ -481,11 +525,20 @@ module Aws::CodeGuruReviewer
481
525
  req.send_request(options)
482
526
  end
483
527
 
484
- # Describes a repository association.
528
+ # Returns a [ `RepositoryAssociation` ][1] object that contains
529
+ # information about the requested repository association.
530
+ #
531
+ #
532
+ #
533
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
485
534
  #
486
535
  # @option params [required, String] :association_arn
487
- # The Amazon Resource Name (ARN) identifying the association. You can
488
- # retrieve this ARN by calling `ListRepositories`.
536
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
537
+ # object. You can retrieve this ARN by calling `ListRepositories`.
538
+ #
539
+ #
540
+ #
541
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
489
542
  #
490
543
  # @return [Types::DescribeRepositoryAssociationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
491
544
  #
@@ -504,7 +557,7 @@ module Aws::CodeGuruReviewer
504
557
  # resp.repository_association.connection_arn #=> String
505
558
  # resp.repository_association.name #=> String
506
559
  # resp.repository_association.owner #=> String
507
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
560
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
508
561
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
509
562
  # resp.repository_association.state_reason #=> String
510
563
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -523,7 +576,12 @@ module Aws::CodeGuruReviewer
523
576
  # repository.
524
577
  #
525
578
  # @option params [required, String] :association_arn
526
- # The Amazon Resource Name (ARN) identifying the association.
579
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
580
+ # object.
581
+ #
582
+ #
583
+ #
584
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
527
585
  #
528
586
  # @return [Types::DisassociateRepositoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
529
587
  #
@@ -542,7 +600,7 @@ module Aws::CodeGuruReviewer
542
600
  # resp.repository_association.connection_arn #=> String
543
601
  # resp.repository_association.name #=> String
544
602
  # resp.repository_association.owner #=> String
545
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
603
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
546
604
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
547
605
  # resp.repository_association.state_reason #=> String
548
606
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -562,13 +620,23 @@ module Aws::CodeGuruReviewer
562
620
  #
563
621
  # @option params [Array<String>] :provider_types
564
622
  # List of provider types for filtering that needs to be applied before
565
- # displaying the result. For example, "providerTypes=\[GitHub\]" will
566
- # list code reviews from GitHub.
623
+ # displaying the result. For example, `providerTypes=[GitHub]` lists
624
+ # code reviews from GitHub.
567
625
  #
568
626
  # @option params [Array<String>] :states
569
627
  # List of states for filtering that needs to be applied before
570
- # displaying the result. For example, "states=\[Pending\]" will list
571
- # code reviews in the Pending state.
628
+ # displaying the result. For example, `states=[Pending]` lists code
629
+ # reviews in the Pending state.
630
+ #
631
+ # The valid code review states are:
632
+ #
633
+ # * `Completed`\: The code review is complete.
634
+ #
635
+ # * `Pending`\: The code review started and has not completed or failed.
636
+ #
637
+ # * `Failed`\: The code review failed.
638
+ #
639
+ # * `Deleting`\: The code review is being deleted.
572
640
  #
573
641
  # @option params [Array<String>] :repository_names
574
642
  # List of repository names for filtering that needs to be applied before
@@ -597,7 +665,7 @@ module Aws::CodeGuruReviewer
597
665
  # @example Request syntax with placeholder values
598
666
  #
599
667
  # resp = client.list_code_reviews({
600
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
668
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
601
669
  # states: ["Completed"], # accepts Completed, Pending, Failed, Deleting
602
670
  # repository_names: ["Name"],
603
671
  # type: "PullRequest", # required, accepts PullRequest
@@ -612,7 +680,7 @@ module Aws::CodeGuruReviewer
612
680
  # resp.code_review_summaries[0].code_review_arn #=> String
613
681
  # resp.code_review_summaries[0].repository_name #=> String
614
682
  # resp.code_review_summaries[0].owner #=> String
615
- # resp.code_review_summaries[0].provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
683
+ # resp.code_review_summaries[0].provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
616
684
  # resp.code_review_summaries[0].state #=> String, one of "Completed", "Pending", "Failed", "Deleting"
617
685
  # resp.code_review_summaries[0].created_time_stamp #=> Time
618
686
  # resp.code_review_summaries[0].last_updated_time_stamp #=> Time
@@ -631,33 +699,46 @@ module Aws::CodeGuruReviewer
631
699
  req.send_request(options)
632
700
  end
633
701
 
634
- # Lists the customer feedback for a CodeGuru Reviewer recommendation for
635
- # all users. This API will be used from the console to extract the
636
- # previously given feedback by the user to pre-populate the feedback
637
- # emojis for all recommendations.
702
+ # Returns a list of [ `RecommendationFeedbackSummary` ][1] objects that
703
+ # contain customer recommendation feedback for all CodeGuru Reviewer
704
+ # users.
705
+ #
706
+ #
707
+ #
708
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RecommendationFeedbackSummary.html
638
709
  #
639
710
  # @option params [String] :next_token
640
- # If nextToken is returned, there are more results available. The value
641
- # of nextToken is a unique pagination token for each page. Make the call
642
- # again using the returned token to retrieve the next page. Keep all
643
- # other arguments unchanged.
711
+ # If `nextToken` is returned, there are more results available. The
712
+ # value of nextToken is a unique pagination token for each page. Make
713
+ # the call again using the returned token to retrieve the next page.
714
+ # Keep all other arguments unchanged.
644
715
  #
645
716
  # @option params [Integer] :max_results
646
717
  # The maximum number of results that are returned per call. The default
647
718
  # is 100.
648
719
  #
649
720
  # @option params [required, String] :code_review_arn
650
- # The Amazon Resource Name (ARN) that identifies the code review.
721
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
722
+ #
723
+ #
724
+ #
725
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
651
726
  #
652
727
  # @option params [Array<String>] :user_ids
653
- # Filter on userIds that need to be applied before displaying the
654
- # result. This can be used to query all the recommendation feedback for
655
- # a code review from a given user.
728
+ # An AWS user's account ID or Amazon Resource Name (ARN). Use this ID
729
+ # to query the recommendation feedback for a code review from that user.
730
+ #
731
+ # The `UserId` is an IAM principal that can be specified as an AWS
732
+ # account ID or an Amazon Resource Name (ARN). For more information, see
733
+ # [ Specifying a Principal][1] in the *AWS Identity and Access
734
+ # Management User Guide*.
735
+ #
736
+ #
737
+ #
738
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
656
739
  #
657
740
  # @option params [Array<String>] :recommendation_ids
658
- # Filter on recommendationIds that need to be applied before displaying
659
- # the result. This can be used to query all the recommendation feedback
660
- # for a given recommendation.
741
+ # Used to query the recommendation feedback for a given recommendation.
661
742
  #
662
743
  # @return [Types::ListRecommendationFeedbackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
663
744
  #
@@ -704,7 +785,11 @@ module Aws::CodeGuruReviewer
704
785
  # is 100.
705
786
  #
706
787
  # @option params [required, String] :code_review_arn
707
- # The Amazon Resource Name (ARN) of the code review to describe.
788
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
789
+ #
790
+ #
791
+ #
792
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
708
793
  #
709
794
  # @return [Types::ListRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
710
795
  #
@@ -740,24 +825,57 @@ module Aws::CodeGuruReviewer
740
825
  req.send_request(options)
741
826
  end
742
827
 
743
- # Lists repository associations. You can optionally filter on one or
744
- # more of the following recommendation properties: provider types,
745
- # states, names, and owners.
828
+ # Returns a list of [ `RepositoryAssociationSummary` ][1] objects that
829
+ # contain summary information about a repository association. You can
830
+ # filter the returned list by [ `ProviderType` ][2], [ `Name` ][3], [
831
+ # `State` ][4], and [ `Owner` ][5].
832
+ #
833
+ #
834
+ #
835
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html
836
+ # [2]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-ProviderType
837
+ # [3]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-Name
838
+ # [4]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-State
839
+ # [5]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-Owner
746
840
  #
747
841
  # @option params [Array<String>] :provider_types
748
842
  # List of provider types to use as a filter.
749
843
  #
750
844
  # @option params [Array<String>] :states
751
- # List of states to use as a filter.
845
+ # List of repository association states to use as a filter.
846
+ #
847
+ # The valid repository association states are:
848
+ #
849
+ # * **Associated**\: The repository association is complete.
850
+ #
851
+ # * **Associating**\: CodeGuru Reviewer is:
852
+ #
853
+ # * Setting up pull request notifications. This is required for pull
854
+ # requests to trigger a CodeGuru Reviewer review.
855
+ #
856
+ # <note markdown="1"> If your repository `ProviderType` is `GitHub` or `Bitbucket`,
857
+ # CodeGuru Reviewer creates webhooks in your repository to trigger
858
+ # CodeGuru Reviewer reviews. If you delete these webhooks, reviews
859
+ # of code in your repository cannot be triggered.
860
+ #
861
+ # </note>
862
+ #
863
+ # * Setting up source code access. This is required for CodeGuru
864
+ # Reviewer to securely clone code in your repository.
865
+ #
866
+ # * **Failed**\: The repository failed to associate or disassociate.
867
+ #
868
+ # * **Disassociating**\: CodeGuru Reviewer is removing the repository's
869
+ # pull request notifications and source code access.
752
870
  #
753
871
  # @option params [Array<String>] :names
754
872
  # List of repository names to use as a filter.
755
873
  #
756
874
  # @option params [Array<String>] :owners
757
- # List of owners to use as a filter. For GitHub, this is name of the
758
- # GitHub account that was used to associate the repository. For AWS
759
- # CodeCommit, it is the name of the CodeCommit account that was used to
760
- # associate the repository.
875
+ # List of owners to use as a filter. For AWS CodeCommit, it is the name
876
+ # of the CodeCommit account that was used to associate the repository.
877
+ # For other repository source providers, such as Bitbucket, this is name
878
+ # of the account that was used to associate the repository.
761
879
  #
762
880
  # @option params [Integer] :max_results
763
881
  # The maximum number of repository association results returned by
@@ -766,8 +884,8 @@ module Aws::CodeGuruReviewer
766
884
  # results in a single page with a `nextToken` response element. The
767
885
  # remaining results of the initial request can be seen by sending
768
886
  # another `ListRepositoryAssociations` request with the returned
769
- # `nextToken` value. This value can be between 1 and 25. If this
770
- # parameter is not used, `ListRepositoryAssociations` returns up to 25
887
+ # `nextToken` value. This value can be between 1 and 100. If this
888
+ # parameter is not used, `ListRepositoryAssociations` returns up to 100
771
889
  # results and a `nextToken` value if applicable.
772
890
  #
773
891
  # @option params [String] :next_token
@@ -792,7 +910,7 @@ module Aws::CodeGuruReviewer
792
910
  # @example Request syntax with placeholder values
793
911
  #
794
912
  # resp = client.list_repository_associations({
795
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
913
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
796
914
  # states: ["Associated"], # accepts Associated, Associating, Failed, Disassociating
797
915
  # names: ["Name"],
798
916
  # owners: ["Owner"],
@@ -809,7 +927,7 @@ module Aws::CodeGuruReviewer
809
927
  # resp.repository_association_summaries[0].association_id #=> String
810
928
  # resp.repository_association_summaries[0].name #=> String
811
929
  # resp.repository_association_summaries[0].owner #=> String
812
- # resp.repository_association_summaries[0].provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
930
+ # resp.repository_association_summaries[0].provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
813
931
  # resp.repository_association_summaries[0].state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
814
932
  # resp.next_token #=> String
815
933
  #
@@ -822,12 +940,16 @@ module Aws::CodeGuruReviewer
822
940
  req.send_request(options)
823
941
  end
824
942
 
825
- # Stores customer feedback for a CodeGuru-Reviewer recommendation. When
943
+ # Stores customer feedback for a CodeGuru Reviewer recommendation. When
826
944
  # this API is called again with different reactions the previous
827
945
  # feedback is overwritten.
828
946
  #
829
947
  # @option params [required, String] :code_review_arn
830
- # The Amazon Resource Name (ARN) that identifies the code review.
948
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
949
+ #
950
+ #
951
+ #
952
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
831
953
  #
832
954
  # @option params [required, String] :recommendation_id
833
955
  # The recommendation ID that can be used to track the provided
@@ -869,7 +991,7 @@ module Aws::CodeGuruReviewer
869
991
  params: params,
870
992
  config: config)
871
993
  context[:gem_name] = 'aws-sdk-codegurureviewer'
872
- context[:gem_version] = '1.8.0'
994
+ context[:gem_version] = '1.9.0'
873
995
  Seahorse::Client::Request.new(handlers, context)
874
996
  end
875
997
 
@@ -273,6 +273,7 @@ module Aws::CodeGuruReviewer
273
273
 
274
274
  Repository.add_member(:code_commit, Shapes::ShapeRef.new(shape: CodeCommitRepository, location_name: "CodeCommit"))
275
275
  Repository.add_member(:bitbucket, Shapes::ShapeRef.new(shape: ThirdPartySourceRepository, location_name: "Bitbucket"))
276
+ Repository.add_member(:git_hub_enterprise_server, Shapes::ShapeRef.new(shape: ThirdPartySourceRepository, location_name: "GitHubEnterpriseServer"))
276
277
  Repository.struct_class = Types::Repository
277
278
 
278
279
  RepositoryAssociation.add_member(:association_id, Shapes::ShapeRef.new(shape: AssociationId, location_name: "AssociationId"))
@@ -36,6 +36,11 @@ module Aws::CodeGuruReviewer
36
36
  # connection_arn: "ConnectionArn", # required
37
37
  # owner: "Owner", # required
38
38
  # },
39
+ # git_hub_enterprise_server: {
40
+ # name: "Name", # required
41
+ # connection_arn: "ConnectionArn", # required
42
+ # owner: "Owner", # required
43
+ # },
39
44
  # },
40
45
  # client_request_token: "ClientRequestToken",
41
46
  # }
@@ -95,7 +100,9 @@ module Aws::CodeGuruReviewer
95
100
  include Aws::Structure
96
101
  end
97
102
 
98
- # Information about an AWS CodeCommit repository.
103
+ # Information about an AWS CodeCommit repository. The CodeCommit
104
+ # repository must be in the same AWS Region and AWS account where its
105
+ # CodeGuru Reviewer code reviews are configured.
99
106
  #
100
107
  # @note When making an API call, you may pass CodeCommitRepository
101
108
  # data as a hash:
@@ -105,7 +112,12 @@ module Aws::CodeGuruReviewer
105
112
  # }
106
113
  #
107
114
  # @!attribute [rw] name
108
- # The name of the AWS CodeCommit repository.
115
+ # The name of the AWS CodeCommit repository. For more information, see
116
+ # [repositoryName][1] in the *AWS CodeCommit API Reference*.
117
+ #
118
+ #
119
+ #
120
+ # [1]: https://docs.aws.amazon.com/codecommit/latest/APIReference/API_GetRepository.html#CodeCommit-GetRepository-request-repositoryName
109
121
  # @return [String]
110
122
  #
111
123
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/CodeCommitRepository AWS API Documentation
@@ -123,7 +135,11 @@ module Aws::CodeGuruReviewer
123
135
  # @return [String]
124
136
  #
125
137
  # @!attribute [rw] code_review_arn
126
- # The Amazon Resource Name (ARN) of the code review to describe.
138
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
139
+ #
140
+ #
141
+ #
142
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
127
143
  # @return [String]
128
144
  #
129
145
  # @!attribute [rw] repository_name
@@ -131,15 +147,28 @@ module Aws::CodeGuruReviewer
131
147
  # @return [String]
132
148
  #
133
149
  # @!attribute [rw] owner
134
- # The owner of the repository.
150
+ # The owner of the repository. For an AWS CodeCommit repository, this
151
+ # is the AWS account ID of the account that owns the repository. For a
152
+ # GitHub or Bitbucket repository, this is the username for the account
153
+ # that owns the repository.
135
154
  # @return [String]
136
155
  #
137
156
  # @!attribute [rw] provider_type
138
- # The provider type of the repository association.
157
+ # The type of repository that contains the reviewed code (for example,
158
+ # GitHub or Bitbucket).
139
159
  # @return [String]
140
160
  #
141
161
  # @!attribute [rw] state
142
- # The state of the code review.
162
+ # The valid code review states are:
163
+ #
164
+ # * `Completed`\: The code review is complete.
165
+ #
166
+ # * `Pending`\: The code review started and has not completed or
167
+ # failed.
168
+ #
169
+ # * `Failed`\: The code review failed.
170
+ #
171
+ # * `Deleting`\: The code review is being deleted.
143
172
  # @return [String]
144
173
  #
145
174
  # @!attribute [rw] state_reason
@@ -199,7 +228,11 @@ module Aws::CodeGuruReviewer
199
228
  # @return [String]
200
229
  #
201
230
  # @!attribute [rw] code_review_arn
202
- # The Amazon Resource Name (ARN) of the code review to describe.
231
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
232
+ #
233
+ #
234
+ #
235
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
203
236
  # @return [String]
204
237
  #
205
238
  # @!attribute [rw] repository_name
@@ -207,7 +240,10 @@ module Aws::CodeGuruReviewer
207
240
  # @return [String]
208
241
  #
209
242
  # @!attribute [rw] owner
210
- # The owner of the repository.
243
+ # The owner of the repository. For an AWS CodeCommit repository, this
244
+ # is the AWS account ID of the account that owns the repository. For a
245
+ # GitHub or Bitbucket repository, this is the username for the account
246
+ # that owns the repository.
211
247
  # @return [String]
212
248
  #
213
249
  # @!attribute [rw] provider_type
@@ -216,6 +252,17 @@ module Aws::CodeGuruReviewer
216
252
  #
217
253
  # @!attribute [rw] state
218
254
  # The state of the code review.
255
+ #
256
+ # The valid code review states are:
257
+ #
258
+ # * `Completed`\: The code review is complete.
259
+ #
260
+ # * `Pending`\: The code review started and has not completed or
261
+ # failed.
262
+ #
263
+ # * `Failed`\: The code review failed.
264
+ #
265
+ # * `Deleting`\: The code review is being deleted.
219
266
  # @return [String]
220
267
  #
221
268
  # @!attribute [rw] created_time_stamp
@@ -261,11 +308,11 @@ module Aws::CodeGuruReviewer
261
308
  # The commit diff for the pull request.
262
309
  #
263
310
  # @!attribute [rw] source_commit
264
- # Source Commit SHA.
311
+ # The SHA of the source commit.
265
312
  # @return [String]
266
313
  #
267
314
  # @!attribute [rw] destination_commit
268
- # Destination Commit SHA
315
+ # The SHA of the destination commit.
269
316
  # @return [String]
270
317
  #
271
318
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/CommitDiffSourceCodeType AWS API Documentation
@@ -300,7 +347,11 @@ module Aws::CodeGuruReviewer
300
347
  # }
301
348
  #
302
349
  # @!attribute [rw] code_review_arn
303
- # The Amazon Resource Name (ARN) of the code review to describe.
350
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
351
+ #
352
+ #
353
+ #
354
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
304
355
  # @return [String]
305
356
  #
306
357
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/DescribeCodeReviewRequest AWS API Documentation
@@ -333,7 +384,11 @@ module Aws::CodeGuruReviewer
333
384
  # }
334
385
  #
335
386
  # @!attribute [rw] code_review_arn
336
- # The Amazon Resource Name (ARN) that identifies the code review.
387
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
388
+ #
389
+ #
390
+ #
391
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
337
392
  # @return [String]
338
393
  #
339
394
  # @!attribute [rw] recommendation_id
@@ -344,6 +399,15 @@ module Aws::CodeGuruReviewer
344
399
  # @!attribute [rw] user_id
345
400
  # Optional parameter to describe the feedback for a given user. If
346
401
  # this is not supplied, it defaults to the user making the request.
402
+ #
403
+ # The `UserId` is an IAM principal that can be specified as an AWS
404
+ # account ID or an Amazon Resource Name (ARN). For more information,
405
+ # see [ Specifying a Principal][1] in the *AWS Identity and Access
406
+ # Management User Guide*.
407
+ #
408
+ #
409
+ #
410
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
347
411
  # @return [String]
348
412
  #
349
413
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/DescribeRecommendationFeedbackRequest AWS API Documentation
@@ -376,8 +440,12 @@ module Aws::CodeGuruReviewer
376
440
  # }
377
441
  #
378
442
  # @!attribute [rw] association_arn
379
- # The Amazon Resource Name (ARN) identifying the association. You can
380
- # retrieve this ARN by calling `ListRepositories`.
443
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
444
+ # object. You can retrieve this ARN by calling `ListRepositories`.
445
+ #
446
+ #
447
+ #
448
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
381
449
  # @return [String]
382
450
  #
383
451
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/DescribeRepositoryAssociationRequest AWS API Documentation
@@ -408,7 +476,12 @@ module Aws::CodeGuruReviewer
408
476
  # }
409
477
  #
410
478
  # @!attribute [rw] association_arn
411
- # The Amazon Resource Name (ARN) identifying the association.
479
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
480
+ # object.
481
+ #
482
+ #
483
+ #
484
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
412
485
  # @return [String]
413
486
  #
414
487
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/DisassociateRepositoryRequest AWS API Documentation
@@ -449,7 +522,7 @@ module Aws::CodeGuruReviewer
449
522
  # data as a hash:
450
523
  #
451
524
  # {
452
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
525
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
453
526
  # states: ["Completed"], # accepts Completed, Pending, Failed, Deleting
454
527
  # repository_names: ["Name"],
455
528
  # type: "PullRequest", # required, accepts PullRequest
@@ -459,14 +532,25 @@ module Aws::CodeGuruReviewer
459
532
  #
460
533
  # @!attribute [rw] provider_types
461
534
  # List of provider types for filtering that needs to be applied before
462
- # displaying the result. For example, "providerTypes=\[GitHub\]"
463
- # will list code reviews from GitHub.
535
+ # displaying the result. For example, `providerTypes=[GitHub]` lists
536
+ # code reviews from GitHub.
464
537
  # @return [Array<String>]
465
538
  #
466
539
  # @!attribute [rw] states
467
540
  # List of states for filtering that needs to be applied before
468
- # displaying the result. For example, "states=\[Pending\]" will list
469
- # code reviews in the Pending state.
541
+ # displaying the result. For example, `states=[Pending]` lists code
542
+ # reviews in the Pending state.
543
+ #
544
+ # The valid code review states are:
545
+ #
546
+ # * `Completed`\: The code review is complete.
547
+ #
548
+ # * `Pending`\: The code review started and has not completed or
549
+ # failed.
550
+ #
551
+ # * `Failed`\: The code review failed.
552
+ #
553
+ # * `Deleting`\: The code review is being deleted.
470
554
  # @return [Array<String>]
471
555
  #
472
556
  # @!attribute [rw] repository_names
@@ -532,7 +616,7 @@ module Aws::CodeGuruReviewer
532
616
  # }
533
617
  #
534
618
  # @!attribute [rw] next_token
535
- # If nextToken is returned, there are more results available. The
619
+ # If `nextToken` is returned, there are more results available. The
536
620
  # value of nextToken is a unique pagination token for each page. Make
537
621
  # the call again using the returned token to retrieve the next page.
538
622
  # Keep all other arguments unchanged.
@@ -544,19 +628,31 @@ module Aws::CodeGuruReviewer
544
628
  # @return [Integer]
545
629
  #
546
630
  # @!attribute [rw] code_review_arn
547
- # The Amazon Resource Name (ARN) that identifies the code review.
631
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
632
+ #
633
+ #
634
+ #
635
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
548
636
  # @return [String]
549
637
  #
550
638
  # @!attribute [rw] user_ids
551
- # Filter on userIds that need to be applied before displaying the
552
- # result. This can be used to query all the recommendation feedback
553
- # for a code review from a given user.
639
+ # An AWS user's account ID or Amazon Resource Name (ARN). Use this ID
640
+ # to query the recommendation feedback for a code review from that
641
+ # user.
642
+ #
643
+ # The `UserId` is an IAM principal that can be specified as an AWS
644
+ # account ID or an Amazon Resource Name (ARN). For more information,
645
+ # see [ Specifying a Principal][1] in the *AWS Identity and Access
646
+ # Management User Guide*.
647
+ #
648
+ #
649
+ #
650
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
554
651
  # @return [Array<String>]
555
652
  #
556
653
  # @!attribute [rw] recommendation_ids
557
- # Filter on recommendationIds that need to be applied before
558
- # displaying the result. This can be used to query all the
559
- # recommendation feedback for a given recommendation.
654
+ # Used to query the recommendation feedback for a given
655
+ # recommendation.
560
656
  # @return [Array<String>]
561
657
  #
562
658
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/ListRecommendationFeedbackRequest AWS API Documentation
@@ -572,7 +668,7 @@ module Aws::CodeGuruReviewer
572
668
  end
573
669
 
574
670
  # @!attribute [rw] recommendation_feedback_summaries
575
- # Recommendation feedback summaries corresponding to the code reivew
671
+ # Recommendation feedback summaries corresponding to the code review
576
672
  # ARN.
577
673
  # @return [Array<Types::RecommendationFeedbackSummary>]
578
674
  #
@@ -611,7 +707,11 @@ module Aws::CodeGuruReviewer
611
707
  # @return [Integer]
612
708
  #
613
709
  # @!attribute [rw] code_review_arn
614
- # The Amazon Resource Name (ARN) of the code review to describe.
710
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
711
+ #
712
+ #
713
+ #
714
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
615
715
  # @return [String]
616
716
  #
617
717
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/ListRecommendationsRequest AWS API Documentation
@@ -645,7 +745,7 @@ module Aws::CodeGuruReviewer
645
745
  # data as a hash:
646
746
  #
647
747
  # {
648
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
748
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
649
749
  # states: ["Associated"], # accepts Associated, Associating, Failed, Disassociating
650
750
  # names: ["Name"],
651
751
  # owners: ["Owner"],
@@ -658,7 +758,31 @@ module Aws::CodeGuruReviewer
658
758
  # @return [Array<String>]
659
759
  #
660
760
  # @!attribute [rw] states
661
- # List of states to use as a filter.
761
+ # List of repository association states to use as a filter.
762
+ #
763
+ # The valid repository association states are:
764
+ #
765
+ # * **Associated**\: The repository association is complete.
766
+ #
767
+ # * **Associating**\: CodeGuru Reviewer is:
768
+ #
769
+ # * Setting up pull request notifications. This is required for pull
770
+ # requests to trigger a CodeGuru Reviewer review.
771
+ #
772
+ # <note markdown="1"> If your repository `ProviderType` is `GitHub` or `Bitbucket`,
773
+ # CodeGuru Reviewer creates webhooks in your repository to trigger
774
+ # CodeGuru Reviewer reviews. If you delete these webhooks, reviews
775
+ # of code in your repository cannot be triggered.
776
+ #
777
+ # </note>
778
+ #
779
+ # * Setting up source code access. This is required for CodeGuru
780
+ # Reviewer to securely clone code in your repository.
781
+ #
782
+ # * **Failed**\: The repository failed to associate or disassociate.
783
+ #
784
+ # * **Disassociating**\: CodeGuru Reviewer is removing the
785
+ # repository's pull request notifications and source code access.
662
786
  # @return [Array<String>]
663
787
  #
664
788
  # @!attribute [rw] names
@@ -666,10 +790,11 @@ module Aws::CodeGuruReviewer
666
790
  # @return [Array<String>]
667
791
  #
668
792
  # @!attribute [rw] owners
669
- # List of owners to use as a filter. For GitHub, this is name of the
670
- # GitHub account that was used to associate the repository. For AWS
671
- # CodeCommit, it is the name of the CodeCommit account that was used
672
- # to associate the repository.
793
+ # List of owners to use as a filter. For AWS CodeCommit, it is the
794
+ # name of the CodeCommit account that was used to associate the
795
+ # repository. For other repository source providers, such as
796
+ # Bitbucket, this is name of the account that was used to associate
797
+ # the repository.
673
798
  # @return [Array<String>]
674
799
  #
675
800
  # @!attribute [rw] max_results
@@ -679,9 +804,9 @@ module Aws::CodeGuruReviewer
679
804
  # `maxResults` results in a single page with a `nextToken` response
680
805
  # element. The remaining results of the initial request can be seen by
681
806
  # sending another `ListRepositoryAssociations` request with the
682
- # returned `nextToken` value. This value can be between 1 and 25. If
807
+ # returned `nextToken` value. This value can be between 1 and 100. If
683
808
  # this parameter is not used, `ListRepositoryAssociations` returns up
684
- # to 25 results and a `nextToken` value if applicable.
809
+ # to 100 results and a `nextToken` value if applicable.
685
810
  # @return [Integer]
686
811
  #
687
812
  # @!attribute [rw] next_token
@@ -736,7 +861,18 @@ module Aws::CodeGuruReviewer
736
861
  # Information about the statistics from the code review.
737
862
  #
738
863
  # @!attribute [rw] metered_lines_of_code_count
739
- # Lines of code metered in the code review.
864
+ # Lines of code metered in the code review. For the initial code
865
+ # review pull request and all subsequent revisions, this includes all
866
+ # lines of code in the files added to the pull request. In subsequent
867
+ # revisions, for files that already existed in the pull request, this
868
+ # includes only the changed lines of code. In both cases, this does
869
+ # not include non-code lines such as comments and import statements.
870
+ # For example, if you submit a pull request containing 5 files, each
871
+ # with 500 lines of code, and in a subsequent revision you added a new
872
+ # file with 200 lines of code, and also modified a total of 25 lines
873
+ # across the initial 5 files, `MeteredLinesOfCodeCount` includes the
874
+ # first 5 files (5 * 500 = 2,500 lines), the new file (200 lines) and
875
+ # the 25 changed lines of code for a total of 2,725 lines of code.
740
876
  # @return [Integer]
741
877
  #
742
878
  # @!attribute [rw] findings_count
@@ -755,7 +891,18 @@ module Aws::CodeGuruReviewer
755
891
  # Information about metrics summaries.
756
892
  #
757
893
  # @!attribute [rw] metered_lines_of_code_count
758
- # Lines of code metered in the code review.
894
+ # Lines of code metered in the code review. For the initial code
895
+ # review pull request and all subsequent revisions, this includes all
896
+ # lines of code in the files added to the pull request. In subsequent
897
+ # revisions, for files that already existed in the pull request, this
898
+ # includes only the changed lines of code. In both cases, this does
899
+ # not include non-code lines such as comments and import statements.
900
+ # For example, if you submit a pull request containing 5 files, each
901
+ # with 500 lines of code, and in a subsequent revision you added a new
902
+ # file with 200 lines of code, and also modified a total of 25 lines
903
+ # across the initial 5 files, `MeteredLinesOfCodeCount` includes the
904
+ # first 5 files (5 * 500 = 2,500 lines), the new file (200 lines) and
905
+ # the 25 changed lines of code for a total of 2,725 lines of code.
759
906
  # @return [Integer]
760
907
  #
761
908
  # @!attribute [rw] findings_count
@@ -794,7 +941,11 @@ module Aws::CodeGuruReviewer
794
941
  # }
795
942
  #
796
943
  # @!attribute [rw] code_review_arn
797
- # The Amazon Resource Name (ARN) that identifies the code review.
944
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
945
+ #
946
+ #
947
+ #
948
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
798
949
  # @return [String]
799
950
  #
800
951
  # @!attribute [rw] recommendation_id
@@ -824,7 +975,11 @@ module Aws::CodeGuruReviewer
824
975
  # Information about the recommendation feedback.
825
976
  #
826
977
  # @!attribute [rw] code_review_arn
827
- # The Amazon Resource Name (ARN) that identifies the code review.
978
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
979
+ #
980
+ #
981
+ #
982
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
828
983
  # @return [String]
829
984
  #
830
985
  # @!attribute [rw] recommendation_id
@@ -838,7 +993,16 @@ module Aws::CodeGuruReviewer
838
993
  # @return [Array<String>]
839
994
  #
840
995
  # @!attribute [rw] user_id
841
- # The user principal that made the API call.
996
+ # The ID of the user that made the API call.
997
+ #
998
+ # The `UserId` is an IAM principal that can be specified as an AWS
999
+ # account ID or an Amazon Resource Name (ARN). For more information,
1000
+ # see [ Specifying a Principal][1] in the *AWS Identity and Access
1001
+ # Management User Guide*.
1002
+ #
1003
+ #
1004
+ #
1005
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
842
1006
  # @return [String]
843
1007
  #
844
1008
  # @!attribute [rw] created_time_stamp
@@ -875,7 +1039,16 @@ module Aws::CodeGuruReviewer
875
1039
  # @return [Array<String>]
876
1040
  #
877
1041
  # @!attribute [rw] user_id
878
- # The identifier for the user that gave the feedback.
1042
+ # The ID of the user that gave the feedback.
1043
+ #
1044
+ # The `UserId` is an IAM principal that can be specified as an AWS
1045
+ # account ID or an Amazon Resource Name (ARN). For more information,
1046
+ # see [ Specifying a Principal][1] in the *AWS Identity and Access
1047
+ # Management User Guide*.
1048
+ #
1049
+ #
1050
+ #
1051
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
879
1052
  # @return [String]
880
1053
  #
881
1054
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/RecommendationFeedbackSummary AWS API Documentation
@@ -907,7 +1080,7 @@ module Aws::CodeGuruReviewer
907
1080
  # @!attribute [rw] end_line
908
1081
  # Last line where the recommendation is applicable in the source
909
1082
  # commit or source branch. For a single line comment the start line
910
- # and end line values will be the same.
1083
+ # and end line values are the same.
911
1084
  # @return [Integer]
912
1085
  #
913
1086
  # @!attribute [rw] description
@@ -927,7 +1100,10 @@ module Aws::CodeGuruReviewer
927
1100
  include Aws::Structure
928
1101
  end
929
1102
 
930
- # Information about a repository.
1103
+ # Information about an associated AWS CodeCommit repository or an
1104
+ # associated repository that is managed by AWS CodeStar Connections (for
1105
+ # example, Bitbucket). This `Repository` object is not used if your
1106
+ # source code is in an associated GitHub repository.
931
1107
  #
932
1108
  # @note When making an API call, you may pass Repository
933
1109
  # data as a hash:
@@ -941,6 +1117,11 @@ module Aws::CodeGuruReviewer
941
1117
  # connection_arn: "ConnectionArn", # required
942
1118
  # owner: "Owner", # required
943
1119
  # },
1120
+ # git_hub_enterprise_server: {
1121
+ # name: "Name", # required
1122
+ # connection_arn: "ConnectionArn", # required
1123
+ # owner: "Owner", # required
1124
+ # },
944
1125
  # }
945
1126
  #
946
1127
  # @!attribute [rw] code_commit
@@ -948,19 +1129,30 @@ module Aws::CodeGuruReviewer
948
1129
  # @return [Types::CodeCommitRepository]
949
1130
  #
950
1131
  # @!attribute [rw] bitbucket
951
- # Information about a Bitbucket Cloud repository.
1132
+ # Information about a Bitbucket repository.
1133
+ # @return [Types::ThirdPartySourceRepository]
1134
+ #
1135
+ # @!attribute [rw] git_hub_enterprise_server
1136
+ # Information about a GitHub Enterprise Server repository.
952
1137
  # @return [Types::ThirdPartySourceRepository]
953
1138
  #
954
1139
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/Repository AWS API Documentation
955
1140
  #
956
1141
  class Repository < Struct.new(
957
1142
  :code_commit,
958
- :bitbucket)
1143
+ :bitbucket,
1144
+ :git_hub_enterprise_server)
959
1145
  SENSITIVE = []
960
1146
  include Aws::Structure
961
1147
  end
962
1148
 
963
- # Information about a repository association.
1149
+ # Information about a repository association. The [
1150
+ # `DescribeRepositoryAssociation` ][1] operation returns a
1151
+ # `RepositoryAssociation` object.
1152
+ #
1153
+ #
1154
+ #
1155
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_DescribeRepositoryAssociation.html
964
1156
  #
965
1157
  # @!attribute [rw] association_id
966
1158
  # The ID of the repository association.
@@ -972,8 +1164,15 @@ module Aws::CodeGuruReviewer
972
1164
  # @return [String]
973
1165
  #
974
1166
  # @!attribute [rw] connection_arn
975
- # The Amazon Resource Name (ARN) identifying the repository
976
- # connection.
1167
+ # The Amazon Resource Name (ARN) of an AWS CodeStar Connections
1168
+ # connection. Its format is
1169
+ # `arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id`.
1170
+ # For more information, see [Connection][1] in the *AWS CodeStar
1171
+ # Connections API Reference*.
1172
+ #
1173
+ #
1174
+ #
1175
+ # [1]: https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html
977
1176
  # @return [String]
978
1177
  #
979
1178
  # @!attribute [rw] name
@@ -981,7 +1180,10 @@ module Aws::CodeGuruReviewer
981
1180
  # @return [String]
982
1181
  #
983
1182
  # @!attribute [rw] owner
984
- # The owner of the repository.
1183
+ # The owner of the repository. For an AWS CodeCommit repository, this
1184
+ # is the AWS account ID of the account that owns the repository. For a
1185
+ # GitHub or Bitbucket repository, this is the username for the account
1186
+ # that owns the repository.
985
1187
  # @return [String]
986
1188
  #
987
1189
  # @!attribute [rw] provider_type
@@ -990,6 +1192,30 @@ module Aws::CodeGuruReviewer
990
1192
  #
991
1193
  # @!attribute [rw] state
992
1194
  # The state of the repository association.
1195
+ #
1196
+ # The valid repository association states are:
1197
+ #
1198
+ # * **Associated**\: The repository association is complete.
1199
+ #
1200
+ # * **Associating**\: CodeGuru Reviewer is:
1201
+ #
1202
+ # * Setting up pull request notifications. This is required for pull
1203
+ # requests to trigger a CodeGuru Reviewer review.
1204
+ #
1205
+ # <note markdown="1"> If your repository `ProviderType` is `GitHub` or `Bitbucket`,
1206
+ # CodeGuru Reviewer creates webhooks in your repository to trigger
1207
+ # CodeGuru Reviewer reviews. If you delete these webhooks, reviews
1208
+ # of code in your repository cannot be triggered.
1209
+ #
1210
+ # </note>
1211
+ #
1212
+ # * Setting up source code access. This is required for CodeGuru
1213
+ # Reviewer to securely clone code in your repository.
1214
+ #
1215
+ # * **Failed**\: The repository failed to associate or disassociate.
1216
+ #
1217
+ # * **Disassociating**\: CodeGuru Reviewer is removing the
1218
+ # repository's pull request notifications and source code access.
993
1219
  # @return [String]
994
1220
  #
995
1221
  # @!attribute [rw] state_reason
@@ -1024,16 +1250,33 @@ module Aws::CodeGuruReviewer
1024
1250
  include Aws::Structure
1025
1251
  end
1026
1252
 
1027
- # Information about a repository association.
1253
+ # Summary information about a repository association. The [
1254
+ # `ListRepositoryAssociations` ][1] operation returns a list of
1255
+ # `RepositoryAssociationSummary` objects.
1256
+ #
1257
+ #
1258
+ #
1259
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_ListRepositoryAssociations.html
1028
1260
  #
1029
1261
  # @!attribute [rw] association_arn
1030
- # The Amazon Resource Name (ARN) identifying the repository
1031
- # association.
1262
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
1263
+ # object.
1264
+ #
1265
+ #
1266
+ #
1267
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
1032
1268
  # @return [String]
1033
1269
  #
1034
1270
  # @!attribute [rw] connection_arn
1035
- # The Amazon Resource Name (ARN) identifying the repository
1036
- # connection.
1271
+ # The Amazon Resource Name (ARN) of an AWS CodeStar Connections
1272
+ # connection. Its format is
1273
+ # `arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id`.
1274
+ # For more information, see [Connection][1] in the *AWS CodeStar
1275
+ # Connections API Reference*.
1276
+ #
1277
+ #
1278
+ #
1279
+ # [1]: https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html
1037
1280
  # @return [String]
1038
1281
  #
1039
1282
  # @!attribute [rw] last_updated_time_stamp
@@ -1050,7 +1293,10 @@ module Aws::CodeGuruReviewer
1050
1293
  # @return [String]
1051
1294
  #
1052
1295
  # @!attribute [rw] owner
1053
- # The owner of the repository association.
1296
+ # The owner of the repository. For an AWS CodeCommit repository, this
1297
+ # is the AWS account ID of the account that owns the repository. For a
1298
+ # GitHub or Bitbucket repository, this is the username for the account
1299
+ # that owns the repository.
1054
1300
  # @return [String]
1055
1301
  #
1056
1302
  # @!attribute [rw] provider_type
@@ -1060,22 +1306,29 @@ module Aws::CodeGuruReviewer
1060
1306
  # @!attribute [rw] state
1061
1307
  # The state of the repository association.
1062
1308
  #
1063
- # Associated
1309
+ # The valid repository association states are:
1064
1310
  #
1065
- # : Amazon CodeGuru Reviewer is associated with the repository.
1311
+ # * **Associated**\: The repository association is complete.
1066
1312
  #
1067
- # Associating
1313
+ # * **Associating**\: CodeGuru Reviewer is:
1068
1314
  #
1069
- # : The association is in progress.
1315
+ # * Setting up pull request notifications. This is required for pull
1316
+ # requests to trigger a CodeGuru Reviewer review.
1070
1317
  #
1071
- # Failed
1318
+ # <note markdown="1"> If your repository `ProviderType` is `GitHub` or `Bitbucket`,
1319
+ # CodeGuru Reviewer creates webhooks in your repository to trigger
1320
+ # CodeGuru Reviewer reviews. If you delete these webhooks, reviews
1321
+ # of code in your repository cannot be triggered.
1072
1322
  #
1073
- # : The association failed.
1323
+ # </note>
1074
1324
  #
1075
- # Disassociating
1325
+ # * Setting up source code access. This is required for CodeGuru
1326
+ # Reviewer to securely clone code in your repository.
1076
1327
  #
1077
- # : Amazon CodeGuru Reviewer is in the process of disassociating with
1078
- # the repository.
1328
+ # * **Failed**\: The repository failed to associate or disassociate.
1329
+ #
1330
+ # * **Disassociating**\: CodeGuru Reviewer is removing the
1331
+ # repository's pull request notifications and source code access.
1079
1332
  # @return [String]
1080
1333
  #
1081
1334
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/RepositoryAssociationSummary AWS API Documentation
@@ -1120,8 +1373,8 @@ module Aws::CodeGuruReviewer
1120
1373
  include Aws::Structure
1121
1374
  end
1122
1375
 
1123
- # Information about a third party source repository connected through
1124
- # CodeStar Connections.
1376
+ # Information about a third-party source repository connected to
1377
+ # CodeGuru Reviewer.
1125
1378
  #
1126
1379
  # @note When making an API call, you may pass ThirdPartySourceRepository
1127
1380
  # data as a hash:
@@ -1137,12 +1390,21 @@ module Aws::CodeGuruReviewer
1137
1390
  # @return [String]
1138
1391
  #
1139
1392
  # @!attribute [rw] connection_arn
1140
- # The Amazon Resource Name (ARN) identifying the repository
1141
- # connection.
1393
+ # The Amazon Resource Name (ARN) of an AWS CodeStar Connections
1394
+ # connection. Its format is
1395
+ # `arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id`.
1396
+ # For more information, see [Connection][1] in the *AWS CodeStar
1397
+ # Connections API Reference*.
1398
+ #
1399
+ #
1400
+ #
1401
+ # [1]: https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html
1142
1402
  # @return [String]
1143
1403
  #
1144
1404
  # @!attribute [rw] owner
1145
- # The username of the owner of the repository.
1405
+ # The owner of the repository. For a GitHub, GitHub Enterprise, or
1406
+ # Bitbucket repository, this is the username for the account that owns
1407
+ # the repository.
1146
1408
  # @return [String]
1147
1409
  #
1148
1410
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/ThirdPartySourceRepository AWS API Documentation
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-codegurureviewer
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.8.0
4
+ version: 1.9.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-06-23 00:00:00.000000000 Z
11
+ date: 2020-06-30 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core