aws-sdk-codegurureviewer 1.8.0 → 1.13.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
2
  SHA256:
3
- metadata.gz: 0ff512e283508d54f7007eb4e0dcb3c34882ca2729ba5dfeb52ea84eaf249812
4
- data.tar.gz: 17c38e9367138635c3e6bc5b20fa90dd04777825efe390431cbf010396eb3127
3
+ metadata.gz: 7b3dc52479126596a4738b392fdde867c32e88cfde759aeb4fe435e82d52e427
4
+ data.tar.gz: 639d3f9feb9f51e6a68f89425ee02cf7f1b7fbd6690412b661e24f7a73037533
5
5
  SHA512:
6
- metadata.gz: 792cef40fcdef52613b7dec75815facbef1f79d606c41c3df68553937371715061db1b35664d4311555cd3f691d0f0351c2f5b4f65c84ff14ee76ebf6e720836
7
- data.tar.gz: 53426e4a660cf27740ac6d41c37684403fa58da7efb883b696f1867307260cf702fa5c42a5154b4b65d2d785caaf87e771e1ebeeeb73f4e0ce71db943fb19b42
6
+ metadata.gz: 59432a7407ede52e9fe9338521ac3f95a5fddf7bcfe21c6a76860a0d1560b1e09cd7d12fd0b601c6d6eb23e64829794d6ffc958758bf2c03577905b4fe9b1546
7
+ data.tar.gz: 1ab0f7b9206c850d47d0ccbdf50c4b923137a8ad551ce769d30024087c276d69ba0006d2a2e2201f0b3dd94d53bacf57538ec45ae2aac99e962196f24c8986ce
@@ -7,6 +7,7 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
+
10
11
  require 'aws-sdk-core'
11
12
  require 'aws-sigv4'
12
13
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-codegurureviewer/customizations'
44
45
  #
45
46
  # See {Errors} for more information.
46
47
  #
47
- # @service
48
+ # @!group service
48
49
  module Aws::CodeGuruReviewer
49
50
 
50
- GEM_VERSION = '1.8.0'
51
+ GEM_VERSION = '1.13.0'
51
52
 
52
53
  end
@@ -85,13 +85,28 @@ module Aws::CodeGuruReviewer
85
85
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
86
86
  # credentials.
87
87
  #
88
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
89
+ # shared file, such as `~/.aws/config`.
90
+ #
91
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
92
+ #
93
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
94
+ # assume a role after providing credentials via the web.
95
+ #
96
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
97
+ # access token generated from `aws login`.
98
+ #
99
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
100
+ # process that outputs to stdout.
101
+ #
88
102
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
89
103
  # from an EC2 IMDS on an EC2 instance.
90
104
  #
91
- # * `Aws::SharedCredentials` - Used for loading credentials from a
92
- # shared file, such as `~/.aws/config`.
105
+ # * `Aws::ECSCredentials` - Used for loading credentials from
106
+ # instances running in ECS.
93
107
  #
94
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
108
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
109
+ # from the Cognito Identity service.
95
110
  #
96
111
  # When `:credentials` are not configured directly, the following
97
112
  # locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::CodeGuruReviewer
101
116
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
102
117
  # * `~/.aws/credentials`
103
118
  # * `~/.aws/config`
104
- # * EC2 IMDS instance profile - When used by default, the timeouts are
105
- # very aggressive. Construct and pass an instance of
106
- # `Aws::InstanceProfileCredentails` to enable retries and extended
107
- # timeouts.
119
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
+ # are very aggressive. Construct and pass an instance of
121
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
+ # enable retries and extended timeouts.
108
123
  #
109
124
  # @option options [required, String] :region
110
125
  # The AWS region to connect to. The configured `:region` is
@@ -312,38 +327,41 @@ module Aws::CodeGuruReviewer
312
327
 
313
328
  # @!group API Operations
314
329
 
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.
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.*
320
337
  #
321
- # You can associate a GitHub repository using the Amazon CodeGuru
322
- # 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.
323
341
  #
324
- # @option params [required, Types::Repository] :repository
325
- # 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.*
326
346
  #
327
- # @option params [String] :client_request_token
328
- # Unique, case-sensitive identifier that you provide to ensure the
329
- # 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.*
330
352
  #
331
- # To add a new repository association, this parameter specifies a unique
332
- # identifier for the new repository association that helps ensure
333
- # idempotency.
353
+ # </note>
334
354
  #
335
- # If you use the AWS CLI or one of the AWS SDKs to call this operation,
336
- # you can leave this parameter empty. The CLI or SDK generates a random
337
- # UUID for you and includes that in the request. If you don't use the
338
- # SDK and instead generate a raw HTTP request to the Secrets Manager
339
- # service endpoint, you must generate a ClientRequestToken yourself for
340
- # new versions and include that value in the request.
341
355
  #
342
- # You typically interact with this value if you implement your own retry
343
- # logic and want to ensure that a given repository association is not
344
- # created twice. We recommend that you generate a UUID-type value to
345
- # ensure uniqueness within the specified repository association.
346
356
  #
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.
363
+ #
364
+ # @option params [String] :client_request_token
347
365
  # Amazon CodeGuru Reviewer uses this value to prevent the accidental
348
366
  # creation of duplicate repository associations if there are failures
349
367
  # and retries.
@@ -367,6 +385,11 @@ module Aws::CodeGuruReviewer
367
385
  # connection_arn: "ConnectionArn", # required
368
386
  # owner: "Owner", # required
369
387
  # },
388
+ # git_hub_enterprise_server: {
389
+ # name: "Name", # required
390
+ # connection_arn: "ConnectionArn", # required
391
+ # owner: "Owner", # required
392
+ # },
370
393
  # },
371
394
  # client_request_token: "ClientRequestToken",
372
395
  # })
@@ -378,7 +401,7 @@ module Aws::CodeGuruReviewer
378
401
  # resp.repository_association.connection_arn #=> String
379
402
  # resp.repository_association.name #=> String
380
403
  # resp.repository_association.owner #=> String
381
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
404
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
382
405
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
383
406
  # resp.repository_association.state_reason #=> String
384
407
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -393,11 +416,94 @@ module Aws::CodeGuruReviewer
393
416
  req.send_request(options)
394
417
  end
395
418
 
396
- # 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
397
499
  # status.
398
500
  #
399
501
  # @option params [required, String] :code_review_arn
400
- # 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
401
507
  #
402
508
  # @return [Types::DescribeCodeReviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
403
509
  #
@@ -415,15 +521,16 @@ module Aws::CodeGuruReviewer
415
521
  # resp.code_review.code_review_arn #=> String
416
522
  # resp.code_review.repository_name #=> String
417
523
  # resp.code_review.owner #=> String
418
- # resp.code_review.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
524
+ # resp.code_review.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
419
525
  # resp.code_review.state #=> String, one of "Completed", "Pending", "Failed", "Deleting"
420
526
  # resp.code_review.state_reason #=> String
421
527
  # resp.code_review.created_time_stamp #=> Time
422
528
  # resp.code_review.last_updated_time_stamp #=> Time
423
- # resp.code_review.type #=> String, one of "PullRequest"
529
+ # resp.code_review.type #=> String, one of "PullRequest", "RepositoryAnalysis"
424
530
  # resp.code_review.pull_request_id #=> String
425
531
  # resp.code_review.source_code_type.commit_diff.source_commit #=> String
426
532
  # resp.code_review.source_code_type.commit_diff.destination_commit #=> String
533
+ # resp.code_review.source_code_type.repository_head.branch_name #=> String
427
534
  # resp.code_review.metrics.metered_lines_of_code_count #=> Integer
428
535
  # resp.code_review.metrics.findings_count #=> Integer
429
536
  #
@@ -440,7 +547,11 @@ module Aws::CodeGuruReviewer
440
547
  # recommendation.
441
548
  #
442
549
  # @option params [required, String] :code_review_arn
443
- # 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
444
555
  #
445
556
  # @option params [required, String] :recommendation_id
446
557
  # The recommendation ID that can be used to track the provided
@@ -450,6 +561,15 @@ module Aws::CodeGuruReviewer
450
561
  # Optional parameter to describe the feedback for a given user. If this
451
562
  # is not supplied, it defaults to the user making the request.
452
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
+ #
453
573
  # @return [Types::DescribeRecommendationFeedbackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
454
574
  #
455
575
  # * {Types::DescribeRecommendationFeedbackResponse#recommendation_feedback #recommendation_feedback} => Types::RecommendationFeedback
@@ -481,11 +601,20 @@ module Aws::CodeGuruReviewer
481
601
  req.send_request(options)
482
602
  end
483
603
 
484
- # 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
485
610
  #
486
611
  # @option params [required, String] :association_arn
487
- # The Amazon Resource Name (ARN) identifying the association. You can
488
- # 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
489
618
  #
490
619
  # @return [Types::DescribeRepositoryAssociationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
491
620
  #
@@ -504,7 +633,7 @@ module Aws::CodeGuruReviewer
504
633
  # resp.repository_association.connection_arn #=> String
505
634
  # resp.repository_association.name #=> String
506
635
  # resp.repository_association.owner #=> String
507
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
636
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
508
637
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
509
638
  # resp.repository_association.state_reason #=> String
510
639
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -523,7 +652,12 @@ module Aws::CodeGuruReviewer
523
652
  # repository.
524
653
  #
525
654
  # @option params [required, String] :association_arn
526
- # 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
527
661
  #
528
662
  # @return [Types::DisassociateRepositoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
529
663
  #
@@ -542,7 +676,7 @@ module Aws::CodeGuruReviewer
542
676
  # resp.repository_association.connection_arn #=> String
543
677
  # resp.repository_association.name #=> String
544
678
  # resp.repository_association.owner #=> String
545
- # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket"
679
+ # resp.repository_association.provider_type #=> String, one of "CodeCommit", "GitHub", "Bitbucket", "GitHubEnterpriseServer"
546
680
  # resp.repository_association.state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
547
681
  # resp.repository_association.state_reason #=> String
548
682
  # resp.repository_association.last_updated_time_stamp #=> Time
@@ -562,13 +696,23 @@ module Aws::CodeGuruReviewer
562
696
  #
563
697
  # @option params [Array<String>] :provider_types
564
698
  # 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.
699
+ # displaying the result. For example, `providerTypes=[GitHub]` lists
700
+ # code reviews from GitHub.
567
701
  #
568
702
  # @option params [Array<String>] :states
569
703
  # 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.
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.
572
716
  #
573
717
  # @option params [Array<String>] :repository_names
574
718
  # List of repository names for filtering that needs to be applied before
@@ -597,10 +741,10 @@ module Aws::CodeGuruReviewer
597
741
  # @example Request syntax with placeholder values
598
742
  #
599
743
  # resp = client.list_code_reviews({
600
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
744
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
601
745
  # states: ["Completed"], # accepts Completed, Pending, Failed, Deleting
602
746
  # repository_names: ["Name"],
603
- # type: "PullRequest", # required, accepts PullRequest
747
+ # type: "PullRequest", # required, accepts PullRequest, RepositoryAnalysis
604
748
  # max_results: 1,
605
749
  # next_token: "NextToken",
606
750
  # })
@@ -612,11 +756,11 @@ module Aws::CodeGuruReviewer
612
756
  # resp.code_review_summaries[0].code_review_arn #=> String
613
757
  # resp.code_review_summaries[0].repository_name #=> String
614
758
  # resp.code_review_summaries[0].owner #=> String
615
- # 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"
616
760
  # resp.code_review_summaries[0].state #=> String, one of "Completed", "Pending", "Failed", "Deleting"
617
761
  # resp.code_review_summaries[0].created_time_stamp #=> Time
618
762
  # resp.code_review_summaries[0].last_updated_time_stamp #=> Time
619
- # resp.code_review_summaries[0].type #=> String, one of "PullRequest"
763
+ # resp.code_review_summaries[0].type #=> String, one of "PullRequest", "RepositoryAnalysis"
620
764
  # resp.code_review_summaries[0].pull_request_id #=> String
621
765
  # resp.code_review_summaries[0].metrics_summary.metered_lines_of_code_count #=> Integer
622
766
  # resp.code_review_summaries[0].metrics_summary.findings_count #=> Integer
@@ -631,33 +775,46 @@ module Aws::CodeGuruReviewer
631
775
  req.send_request(options)
632
776
  end
633
777
 
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.
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
638
785
  #
639
786
  # @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.
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.
644
791
  #
645
792
  # @option params [Integer] :max_results
646
793
  # The maximum number of results that are returned per call. The default
647
794
  # is 100.
648
795
  #
649
796
  # @option params [required, String] :code_review_arn
650
- # 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
651
802
  #
652
803
  # @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.
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
656
815
  #
657
816
  # @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.
817
+ # Used to query the recommendation feedback for a given recommendation.
661
818
  #
662
819
  # @return [Types::ListRecommendationFeedbackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
663
820
  #
@@ -704,7 +861,11 @@ module Aws::CodeGuruReviewer
704
861
  # is 100.
705
862
  #
706
863
  # @option params [required, String] :code_review_arn
707
- # 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
708
869
  #
709
870
  # @return [Types::ListRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
710
871
  #
@@ -740,23 +901,58 @@ module Aws::CodeGuruReviewer
740
901
  req.send_request(options)
741
902
  end
742
903
 
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.
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
746
916
  #
747
917
  # @option params [Array<String>] :provider_types
748
918
  # List of provider types to use as a filter.
749
919
  #
750
920
  # @option params [Array<String>] :states
751
- # 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.
752
947
  #
753
948
  # @option params [Array<String>] :names
754
949
  # List of repository names to use as a filter.
755
950
  #
756
951
  # @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
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
760
956
  # associate the repository.
761
957
  #
762
958
  # @option params [Integer] :max_results
@@ -766,8 +962,8 @@ module Aws::CodeGuruReviewer
766
962
  # results in a single page with a `nextToken` response element. The
767
963
  # remaining results of the initial request can be seen by sending
768
964
  # 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
965
+ # `nextToken` value. This value can be between 1 and 100. If this
966
+ # parameter is not used, `ListRepositoryAssociations` returns up to 100
771
967
  # results and a `nextToken` value if applicable.
772
968
  #
773
969
  # @option params [String] :next_token
@@ -792,7 +988,7 @@ module Aws::CodeGuruReviewer
792
988
  # @example Request syntax with placeholder values
793
989
  #
794
990
  # resp = client.list_repository_associations({
795
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
991
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
796
992
  # states: ["Associated"], # accepts Associated, Associating, Failed, Disassociating
797
993
  # names: ["Name"],
798
994
  # owners: ["Owner"],
@@ -809,7 +1005,7 @@ module Aws::CodeGuruReviewer
809
1005
  # resp.repository_association_summaries[0].association_id #=> String
810
1006
  # resp.repository_association_summaries[0].name #=> String
811
1007
  # resp.repository_association_summaries[0].owner #=> String
812
- # 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"
813
1009
  # resp.repository_association_summaries[0].state #=> String, one of "Associated", "Associating", "Failed", "Disassociating"
814
1010
  # resp.next_token #=> String
815
1011
  #
@@ -822,12 +1018,16 @@ module Aws::CodeGuruReviewer
822
1018
  req.send_request(options)
823
1019
  end
824
1020
 
825
- # Stores customer feedback for a CodeGuru-Reviewer recommendation. When
1021
+ # Stores customer feedback for a CodeGuru Reviewer recommendation. When
826
1022
  # this API is called again with different reactions the previous
827
1023
  # feedback is overwritten.
828
1024
  #
829
1025
  # @option params [required, String] :code_review_arn
830
- # 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
831
1031
  #
832
1032
  # @option params [required, String] :recommendation_id
833
1033
  # The recommendation ID that can be used to track the provided
@@ -869,7 +1069,7 @@ module Aws::CodeGuruReviewer
869
1069
  params: params,
870
1070
  config: config)
871
1071
  context[:gem_name] = 'aws-sdk-codegurureviewer'
872
- context[:gem_version] = '1.8.0'
1072
+ context[:gem_version] = '1.13.0'
873
1073
  Seahorse::Client::Request.new(handlers, context)
874
1074
  end
875
1075