aws-sdk-codegurureviewer 1.8.0 → 1.13.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.
@@ -18,15 +18,20 @@ module Aws::CodeGuruReviewer
18
18
  AssociateRepositoryRequest = Shapes::StructureShape.new(name: 'AssociateRepositoryRequest')
19
19
  AssociateRepositoryResponse = Shapes::StructureShape.new(name: 'AssociateRepositoryResponse')
20
20
  AssociationId = Shapes::StringShape.new(name: 'AssociationId')
21
+ BranchName = Shapes::StringShape.new(name: 'BranchName')
21
22
  ClientRequestToken = Shapes::StringShape.new(name: 'ClientRequestToken')
22
23
  CodeCommitRepository = Shapes::StructureShape.new(name: 'CodeCommitRepository')
23
24
  CodeReview = Shapes::StructureShape.new(name: 'CodeReview')
25
+ CodeReviewName = Shapes::StringShape.new(name: 'CodeReviewName')
24
26
  CodeReviewSummaries = Shapes::ListShape.new(name: 'CodeReviewSummaries')
25
27
  CodeReviewSummary = Shapes::StructureShape.new(name: 'CodeReviewSummary')
28
+ CodeReviewType = Shapes::StructureShape.new(name: 'CodeReviewType')
26
29
  CommitDiffSourceCodeType = Shapes::StructureShape.new(name: 'CommitDiffSourceCodeType')
27
30
  CommitId = Shapes::StringShape.new(name: 'CommitId')
28
31
  ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
29
32
  ConnectionArn = Shapes::StringShape.new(name: 'ConnectionArn')
33
+ CreateCodeReviewRequest = Shapes::StructureShape.new(name: 'CreateCodeReviewRequest')
34
+ CreateCodeReviewResponse = Shapes::StructureShape.new(name: 'CreateCodeReviewResponse')
30
35
  DescribeCodeReviewRequest = Shapes::StructureShape.new(name: 'DescribeCodeReviewRequest')
31
36
  DescribeCodeReviewResponse = Shapes::StructureShape.new(name: 'DescribeCodeReviewResponse')
32
37
  DescribeRecommendationFeedbackRequest = Shapes::StructureShape.new(name: 'DescribeRecommendationFeedbackRequest')
@@ -76,11 +81,13 @@ module Aws::CodeGuruReviewer
76
81
  RecommendationSummaries = Shapes::ListShape.new(name: 'RecommendationSummaries')
77
82
  RecommendationSummary = Shapes::StructureShape.new(name: 'RecommendationSummary')
78
83
  Repository = Shapes::StructureShape.new(name: 'Repository')
84
+ RepositoryAnalysis = Shapes::StructureShape.new(name: 'RepositoryAnalysis')
79
85
  RepositoryAssociation = Shapes::StructureShape.new(name: 'RepositoryAssociation')
80
86
  RepositoryAssociationState = Shapes::StringShape.new(name: 'RepositoryAssociationState')
81
87
  RepositoryAssociationStates = Shapes::ListShape.new(name: 'RepositoryAssociationStates')
82
88
  RepositoryAssociationSummaries = Shapes::ListShape.new(name: 'RepositoryAssociationSummaries')
83
89
  RepositoryAssociationSummary = Shapes::StructureShape.new(name: 'RepositoryAssociationSummary')
90
+ RepositoryHeadSourceCodeType = Shapes::StructureShape.new(name: 'RepositoryHeadSourceCodeType')
84
91
  RepositoryNames = Shapes::ListShape.new(name: 'RepositoryNames')
85
92
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
86
93
  SourceCodeType = Shapes::StructureShape.new(name: 'SourceCodeType')
@@ -137,6 +144,9 @@ module Aws::CodeGuruReviewer
137
144
  CodeReviewSummary.add_member(:metrics_summary, Shapes::ShapeRef.new(shape: MetricsSummary, location_name: "MetricsSummary"))
138
145
  CodeReviewSummary.struct_class = Types::CodeReviewSummary
139
146
 
147
+ CodeReviewType.add_member(:repository_analysis, Shapes::ShapeRef.new(shape: RepositoryAnalysis, required: true, location_name: "RepositoryAnalysis"))
148
+ CodeReviewType.struct_class = Types::CodeReviewType
149
+
140
150
  CommitDiffSourceCodeType.add_member(:source_commit, Shapes::ShapeRef.new(shape: CommitId, location_name: "SourceCommit"))
141
151
  CommitDiffSourceCodeType.add_member(:destination_commit, Shapes::ShapeRef.new(shape: CommitId, location_name: "DestinationCommit"))
142
152
  CommitDiffSourceCodeType.struct_class = Types::CommitDiffSourceCodeType
@@ -144,6 +154,15 @@ module Aws::CodeGuruReviewer
144
154
  ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
145
155
  ConflictException.struct_class = Types::ConflictException
146
156
 
157
+ CreateCodeReviewRequest.add_member(:name, Shapes::ShapeRef.new(shape: CodeReviewName, required: true, location_name: "Name"))
158
+ CreateCodeReviewRequest.add_member(:repository_association_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "RepositoryAssociationArn"))
159
+ CreateCodeReviewRequest.add_member(:type, Shapes::ShapeRef.new(shape: CodeReviewType, required: true, location_name: "Type"))
160
+ CreateCodeReviewRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken", metadata: {"idempotencyToken"=>true}))
161
+ CreateCodeReviewRequest.struct_class = Types::CreateCodeReviewRequest
162
+
163
+ CreateCodeReviewResponse.add_member(:code_review, Shapes::ShapeRef.new(shape: CodeReview, location_name: "CodeReview"))
164
+ CreateCodeReviewResponse.struct_class = Types::CreateCodeReviewResponse
165
+
147
166
  DescribeCodeReviewRequest.add_member(:code_review_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location: "uri", location_name: "CodeReviewArn"))
148
167
  DescribeCodeReviewRequest.struct_class = Types::DescribeCodeReviewRequest
149
168
 
@@ -273,8 +292,12 @@ module Aws::CodeGuruReviewer
273
292
 
274
293
  Repository.add_member(:code_commit, Shapes::ShapeRef.new(shape: CodeCommitRepository, location_name: "CodeCommit"))
275
294
  Repository.add_member(:bitbucket, Shapes::ShapeRef.new(shape: ThirdPartySourceRepository, location_name: "Bitbucket"))
295
+ Repository.add_member(:git_hub_enterprise_server, Shapes::ShapeRef.new(shape: ThirdPartySourceRepository, location_name: "GitHubEnterpriseServer"))
276
296
  Repository.struct_class = Types::Repository
277
297
 
298
+ RepositoryAnalysis.add_member(:repository_head, Shapes::ShapeRef.new(shape: RepositoryHeadSourceCodeType, required: true, location_name: "RepositoryHead"))
299
+ RepositoryAnalysis.struct_class = Types::RepositoryAnalysis
300
+
278
301
  RepositoryAssociation.add_member(:association_id, Shapes::ShapeRef.new(shape: AssociationId, location_name: "AssociationId"))
279
302
  RepositoryAssociation.add_member(:association_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "AssociationArn"))
280
303
  RepositoryAssociation.add_member(:connection_arn, Shapes::ShapeRef.new(shape: ConnectionArn, location_name: "ConnectionArn"))
@@ -301,12 +324,16 @@ module Aws::CodeGuruReviewer
301
324
  RepositoryAssociationSummary.add_member(:state, Shapes::ShapeRef.new(shape: RepositoryAssociationState, location_name: "State"))
302
325
  RepositoryAssociationSummary.struct_class = Types::RepositoryAssociationSummary
303
326
 
327
+ RepositoryHeadSourceCodeType.add_member(:branch_name, Shapes::ShapeRef.new(shape: BranchName, required: true, location_name: "BranchName"))
328
+ RepositoryHeadSourceCodeType.struct_class = Types::RepositoryHeadSourceCodeType
329
+
304
330
  RepositoryNames.member = Shapes::ShapeRef.new(shape: Name)
305
331
 
306
332
  ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
307
333
  ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
308
334
 
309
335
  SourceCodeType.add_member(:commit_diff, Shapes::ShapeRef.new(shape: CommitDiffSourceCodeType, location_name: "CommitDiff"))
336
+ SourceCodeType.add_member(:repository_head, Shapes::ShapeRef.new(shape: RepositoryHeadSourceCodeType, location_name: "RepositoryHead"))
310
337
  SourceCodeType.struct_class = Types::SourceCodeType
311
338
 
312
339
  ThirdPartySourceRepository.add_member(:name, Shapes::ShapeRef.new(shape: Name, required: true, location_name: "Name"))
@@ -354,6 +381,20 @@ module Aws::CodeGuruReviewer
354
381
  o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
355
382
  end)
356
383
 
384
+ api.add_operation(:create_code_review, Seahorse::Model::Operation.new.tap do |o|
385
+ o.name = "CreateCodeReview"
386
+ o.http_method = "POST"
387
+ o.http_request_uri = "/codereviews"
388
+ o.input = Shapes::ShapeRef.new(shape: CreateCodeReviewRequest)
389
+ o.output = Shapes::ShapeRef.new(shape: CreateCodeReviewResponse)
390
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
391
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
392
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
393
+ o.errors << Shapes::ShapeRef.new(shape: ConflictException)
394
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
395
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
396
+ end)
397
+
357
398
  api.add_operation(:describe_code_review, Seahorse::Model::Operation.new.tap do |o|
358
399
  o.name = "DescribeCodeReview"
359
400
  o.http_method = "GET"
@@ -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
  # }
@@ -45,27 +50,6 @@ module Aws::CodeGuruReviewer
45
50
  # @return [Types::Repository]
46
51
  #
47
52
  # @!attribute [rw] client_request_token
48
- # Unique, case-sensitive identifier that you provide to ensure the
49
- # idempotency of the request.
50
- #
51
- # To add a new repository association, this parameter specifies a
52
- # unique identifier for the new repository association that helps
53
- # ensure idempotency.
54
- #
55
- # If you use the AWS CLI or one of the AWS SDKs to call this
56
- # operation, you can leave this parameter empty. The CLI or SDK
57
- # generates a random UUID for you and includes that in the request. If
58
- # you don't use the SDK and instead generate a raw HTTP request to
59
- # the Secrets Manager service endpoint, you must generate a
60
- # ClientRequestToken yourself for new versions and include that value
61
- # in the request.
62
- #
63
- # You typically interact with this value if you implement your own
64
- # retry logic and want to ensure that a given repository association
65
- # is not created twice. We recommend that you generate a UUID-type
66
- # value to ensure uniqueness within the specified repository
67
- # association.
68
- #
69
53
  # Amazon CodeGuru Reviewer uses this value to prevent the accidental
70
54
  # creation of duplicate repository associations if there are failures
71
55
  # and retries.
@@ -95,7 +79,9 @@ module Aws::CodeGuruReviewer
95
79
  include Aws::Structure
96
80
  end
97
81
 
98
- # Information about an AWS CodeCommit repository.
82
+ # Information about an AWS CodeCommit repository. The CodeCommit
83
+ # repository must be in the same AWS Region and AWS account where its
84
+ # CodeGuru Reviewer code reviews are configured.
99
85
  #
100
86
  # @note When making an API call, you may pass CodeCommitRepository
101
87
  # data as a hash:
@@ -105,7 +91,12 @@ module Aws::CodeGuruReviewer
105
91
  # }
106
92
  #
107
93
  # @!attribute [rw] name
108
- # The name of the AWS CodeCommit repository.
94
+ # The name of the AWS CodeCommit repository. For more information, see
95
+ # [repositoryName][1] in the *AWS CodeCommit API Reference*.
96
+ #
97
+ #
98
+ #
99
+ # [1]: https://docs.aws.amazon.com/codecommit/latest/APIReference/API_GetRepository.html#CodeCommit-GetRepository-request-repositoryName
109
100
  # @return [String]
110
101
  #
111
102
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/CodeCommitRepository AWS API Documentation
@@ -123,7 +114,11 @@ module Aws::CodeGuruReviewer
123
114
  # @return [String]
124
115
  #
125
116
  # @!attribute [rw] code_review_arn
126
- # The Amazon Resource Name (ARN) of the code review to describe.
117
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
118
+ #
119
+ #
120
+ #
121
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
127
122
  # @return [String]
128
123
  #
129
124
  # @!attribute [rw] repository_name
@@ -131,15 +126,28 @@ module Aws::CodeGuruReviewer
131
126
  # @return [String]
132
127
  #
133
128
  # @!attribute [rw] owner
134
- # The owner of the repository.
129
+ # The owner of the repository. For an AWS CodeCommit repository, this
130
+ # is the AWS account ID of the account that owns the repository. For a
131
+ # GitHub, GitHub Enterprise Server, or Bitbucket repository, this is
132
+ # the username for the account that owns the repository.
135
133
  # @return [String]
136
134
  #
137
135
  # @!attribute [rw] provider_type
138
- # The provider type of the repository association.
136
+ # The type of repository that contains the reviewed code (for example,
137
+ # GitHub or Bitbucket).
139
138
  # @return [String]
140
139
  #
141
140
  # @!attribute [rw] state
142
- # The state of the code review.
141
+ # The valid code review states are:
142
+ #
143
+ # * `Completed`\: The code review is complete.
144
+ #
145
+ # * `Pending`\: The code review started and has not completed or
146
+ # failed.
147
+ #
148
+ # * `Failed`\: The code review failed.
149
+ #
150
+ # * `Deleting`\: The code review is being deleted.
143
151
  # @return [String]
144
152
  #
145
153
  # @!attribute [rw] state_reason
@@ -199,7 +207,11 @@ module Aws::CodeGuruReviewer
199
207
  # @return [String]
200
208
  #
201
209
  # @!attribute [rw] code_review_arn
202
- # The Amazon Resource Name (ARN) of the code review to describe.
210
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
211
+ #
212
+ #
213
+ #
214
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
203
215
  # @return [String]
204
216
  #
205
217
  # @!attribute [rw] repository_name
@@ -207,7 +219,10 @@ module Aws::CodeGuruReviewer
207
219
  # @return [String]
208
220
  #
209
221
  # @!attribute [rw] owner
210
- # The owner of the repository.
222
+ # The owner of the repository. For an AWS CodeCommit repository, this
223
+ # is the AWS account ID of the account that owns the repository. For a
224
+ # GitHub, GitHub Enterprise Server, or Bitbucket repository, this is
225
+ # the username for the account that owns the repository.
211
226
  # @return [String]
212
227
  #
213
228
  # @!attribute [rw] provider_type
@@ -216,6 +231,17 @@ module Aws::CodeGuruReviewer
216
231
  #
217
232
  # @!attribute [rw] state
218
233
  # The state of the code review.
234
+ #
235
+ # The valid code review states are:
236
+ #
237
+ # * `Completed`\: The code review is complete.
238
+ #
239
+ # * `Pending`\: The code review started and has not completed or
240
+ # failed.
241
+ #
242
+ # * `Failed`\: The code review failed.
243
+ #
244
+ # * `Deleting`\: The code review is being deleted.
219
245
  # @return [String]
220
246
  #
221
247
  # @!attribute [rw] created_time_stamp
@@ -258,14 +284,63 @@ module Aws::CodeGuruReviewer
258
284
  include Aws::Structure
259
285
  end
260
286
 
261
- # The commit diff for the pull request.
287
+ # The type of a code review. There are two code review types:
288
+ #
289
+ # * `PullRequest` - A code review that is automatically triggered by a
290
+ # pull request on an assocaited repository. Because this type of code
291
+ # review is automatically generated, you cannot specify this code
292
+ # review type using [ `CreateCodeReview` ][1].
293
+ #
294
+ # * `RepositoryAnalysis` - A code review that analyzes all code under a
295
+ # specified branch in an associated respository. The assocated
296
+ # repository is specified using its ARN in [ `CreateCodeReview` ][1].
297
+ #
298
+ #
299
+ #
300
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CreateCodeReview
301
+ #
302
+ # @note When making an API call, you may pass CodeReviewType
303
+ # data as a hash:
304
+ #
305
+ # {
306
+ # repository_analysis: { # required
307
+ # repository_head: { # required
308
+ # branch_name: "BranchName", # required
309
+ # },
310
+ # },
311
+ # }
312
+ #
313
+ # @!attribute [rw] repository_analysis
314
+ # A code review that analyzes all code under a specified branch in an
315
+ # associated respository. The assocated repository is specified using
316
+ # its ARN in [ `CreateCodeReview` ][1]
317
+ #
318
+ #
319
+ #
320
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CreateCodeReview
321
+ # @return [Types::RepositoryAnalysis]
322
+ #
323
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/CodeReviewType AWS API Documentation
324
+ #
325
+ class CodeReviewType < Struct.new(
326
+ :repository_analysis)
327
+ SENSITIVE = []
328
+ include Aws::Structure
329
+ end
330
+
331
+ # A type of [ `SourceCodeType` ][1] that specifies the commit diff for a
332
+ # pull request on an associated repository.
333
+ #
334
+ #
335
+ #
336
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_SourceCodeType
262
337
  #
263
338
  # @!attribute [rw] source_commit
264
- # Source Commit SHA.
339
+ # The SHA of the source commit used to generate a commit diff.
265
340
  # @return [String]
266
341
  #
267
342
  # @!attribute [rw] destination_commit
268
- # Destination Commit SHA
343
+ # The SHA of the destination commit used to generate a commit diff.
269
344
  # @return [String]
270
345
  #
271
346
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/CommitDiffSourceCodeType AWS API Documentation
@@ -292,6 +367,80 @@ module Aws::CodeGuruReviewer
292
367
  include Aws::Structure
293
368
  end
294
369
 
370
+ # @note When making an API call, you may pass CreateCodeReviewRequest
371
+ # data as a hash:
372
+ #
373
+ # {
374
+ # name: "CodeReviewName", # required
375
+ # repository_association_arn: "Arn", # required
376
+ # type: { # required
377
+ # repository_analysis: { # required
378
+ # repository_head: { # required
379
+ # branch_name: "BranchName", # required
380
+ # },
381
+ # },
382
+ # },
383
+ # client_request_token: "ClientRequestToken",
384
+ # }
385
+ #
386
+ # @!attribute [rw] name
387
+ # The name of the code review. Each code review of the same code
388
+ # review type must have a unique name in your AWS account.
389
+ # @return [String]
390
+ #
391
+ # @!attribute [rw] repository_association_arn
392
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
393
+ # object. You can retrieve this ARN by calling `ListRepositories`.
394
+ #
395
+ # A code review can only be created on an associated repository. This
396
+ # is the ARN of the associated repository.
397
+ #
398
+ #
399
+ #
400
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
401
+ # @return [String]
402
+ #
403
+ # @!attribute [rw] type
404
+ # The type of code review to create. This is specified using a [
405
+ # `CodeReviewType` ][1] object.
406
+ #
407
+ #
408
+ #
409
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReviewType.html
410
+ # @return [Types::CodeReviewType]
411
+ #
412
+ # @!attribute [rw] client_request_token
413
+ # Amazon CodeGuru Reviewer uses this value to prevent the accidental
414
+ # creation of duplicate code reviews if there are failures and
415
+ # retries.
416
+ #
417
+ # **A suitable default value is auto-generated.** You should normally
418
+ # not need to pass this option.
419
+ # @return [String]
420
+ #
421
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/CreateCodeReviewRequest AWS API Documentation
422
+ #
423
+ class CreateCodeReviewRequest < Struct.new(
424
+ :name,
425
+ :repository_association_arn,
426
+ :type,
427
+ :client_request_token)
428
+ SENSITIVE = []
429
+ include Aws::Structure
430
+ end
431
+
432
+ # @!attribute [rw] code_review
433
+ # Information about a code review.
434
+ # @return [Types::CodeReview]
435
+ #
436
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/CreateCodeReviewResponse AWS API Documentation
437
+ #
438
+ class CreateCodeReviewResponse < Struct.new(
439
+ :code_review)
440
+ SENSITIVE = []
441
+ include Aws::Structure
442
+ end
443
+
295
444
  # @note When making an API call, you may pass DescribeCodeReviewRequest
296
445
  # data as a hash:
297
446
  #
@@ -300,7 +449,11 @@ module Aws::CodeGuruReviewer
300
449
  # }
301
450
  #
302
451
  # @!attribute [rw] code_review_arn
303
- # The Amazon Resource Name (ARN) of the code review to describe.
452
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
453
+ #
454
+ #
455
+ #
456
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
304
457
  # @return [String]
305
458
  #
306
459
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/DescribeCodeReviewRequest AWS API Documentation
@@ -333,7 +486,11 @@ module Aws::CodeGuruReviewer
333
486
  # }
334
487
  #
335
488
  # @!attribute [rw] code_review_arn
336
- # The Amazon Resource Name (ARN) that identifies the code review.
489
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
490
+ #
491
+ #
492
+ #
493
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
337
494
  # @return [String]
338
495
  #
339
496
  # @!attribute [rw] recommendation_id
@@ -344,6 +501,15 @@ module Aws::CodeGuruReviewer
344
501
  # @!attribute [rw] user_id
345
502
  # Optional parameter to describe the feedback for a given user. If
346
503
  # this is not supplied, it defaults to the user making the request.
504
+ #
505
+ # The `UserId` is an IAM principal that can be specified as an AWS
506
+ # account ID or an Amazon Resource Name (ARN). For more information,
507
+ # see [ Specifying a Principal][1] in the *AWS Identity and Access
508
+ # Management User Guide*.
509
+ #
510
+ #
511
+ #
512
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
347
513
  # @return [String]
348
514
  #
349
515
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/DescribeRecommendationFeedbackRequest AWS API Documentation
@@ -376,8 +542,12 @@ module Aws::CodeGuruReviewer
376
542
  # }
377
543
  #
378
544
  # @!attribute [rw] association_arn
379
- # The Amazon Resource Name (ARN) identifying the association. You can
380
- # retrieve this ARN by calling `ListRepositories`.
545
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
546
+ # object. You can retrieve this ARN by calling `ListRepositories`.
547
+ #
548
+ #
549
+ #
550
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
381
551
  # @return [String]
382
552
  #
383
553
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/DescribeRepositoryAssociationRequest AWS API Documentation
@@ -408,7 +578,12 @@ module Aws::CodeGuruReviewer
408
578
  # }
409
579
  #
410
580
  # @!attribute [rw] association_arn
411
- # The Amazon Resource Name (ARN) identifying the association.
581
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
582
+ # object. You can retrieve this ARN by calling `ListRepositories`.
583
+ #
584
+ #
585
+ #
586
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
412
587
  # @return [String]
413
588
  #
414
589
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/DisassociateRepositoryRequest AWS API Documentation
@@ -449,24 +624,35 @@ module Aws::CodeGuruReviewer
449
624
  # data as a hash:
450
625
  #
451
626
  # {
452
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
627
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
453
628
  # states: ["Completed"], # accepts Completed, Pending, Failed, Deleting
454
629
  # repository_names: ["Name"],
455
- # type: "PullRequest", # required, accepts PullRequest
630
+ # type: "PullRequest", # required, accepts PullRequest, RepositoryAnalysis
456
631
  # max_results: 1,
457
632
  # next_token: "NextToken",
458
633
  # }
459
634
  #
460
635
  # @!attribute [rw] provider_types
461
636
  # 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.
637
+ # displaying the result. For example, `providerTypes=[GitHub]` lists
638
+ # code reviews from GitHub.
464
639
  # @return [Array<String>]
465
640
  #
466
641
  # @!attribute [rw] states
467
642
  # 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.
643
+ # displaying the result. For example, `states=[Pending]` lists code
644
+ # reviews in the Pending state.
645
+ #
646
+ # The valid code review states are:
647
+ #
648
+ # * `Completed`\: The code review is complete.
649
+ #
650
+ # * `Pending`\: The code review started and has not completed or
651
+ # failed.
652
+ #
653
+ # * `Failed`\: The code review failed.
654
+ #
655
+ # * `Deleting`\: The code review is being deleted.
470
656
  # @return [Array<String>]
471
657
  #
472
658
  # @!attribute [rw] repository_names
@@ -532,7 +718,7 @@ module Aws::CodeGuruReviewer
532
718
  # }
533
719
  #
534
720
  # @!attribute [rw] next_token
535
- # If nextToken is returned, there are more results available. The
721
+ # If `nextToken` is returned, there are more results available. The
536
722
  # value of nextToken is a unique pagination token for each page. Make
537
723
  # the call again using the returned token to retrieve the next page.
538
724
  # Keep all other arguments unchanged.
@@ -544,19 +730,31 @@ module Aws::CodeGuruReviewer
544
730
  # @return [Integer]
545
731
  #
546
732
  # @!attribute [rw] code_review_arn
547
- # The Amazon Resource Name (ARN) that identifies the code review.
733
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
734
+ #
735
+ #
736
+ #
737
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
548
738
  # @return [String]
549
739
  #
550
740
  # @!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.
741
+ # An AWS user's account ID or Amazon Resource Name (ARN). Use this ID
742
+ # to query the recommendation feedback for a code review from that
743
+ # user.
744
+ #
745
+ # The `UserId` is an IAM principal that can be specified as an AWS
746
+ # account ID or an Amazon Resource Name (ARN). For more information,
747
+ # see [ Specifying a Principal][1] in the *AWS Identity and Access
748
+ # Management User Guide*.
749
+ #
750
+ #
751
+ #
752
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
554
753
  # @return [Array<String>]
555
754
  #
556
755
  # @!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.
756
+ # Used to query the recommendation feedback for a given
757
+ # recommendation.
560
758
  # @return [Array<String>]
561
759
  #
562
760
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/ListRecommendationFeedbackRequest AWS API Documentation
@@ -572,7 +770,7 @@ module Aws::CodeGuruReviewer
572
770
  end
573
771
 
574
772
  # @!attribute [rw] recommendation_feedback_summaries
575
- # Recommendation feedback summaries corresponding to the code reivew
773
+ # Recommendation feedback summaries corresponding to the code review
576
774
  # ARN.
577
775
  # @return [Array<Types::RecommendationFeedbackSummary>]
578
776
  #
@@ -611,7 +809,11 @@ module Aws::CodeGuruReviewer
611
809
  # @return [Integer]
612
810
  #
613
811
  # @!attribute [rw] code_review_arn
614
- # The Amazon Resource Name (ARN) of the code review to describe.
812
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
813
+ #
814
+ #
815
+ #
816
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
615
817
  # @return [String]
616
818
  #
617
819
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/ListRecommendationsRequest AWS API Documentation
@@ -645,7 +847,7 @@ module Aws::CodeGuruReviewer
645
847
  # data as a hash:
646
848
  #
647
849
  # {
648
- # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket
850
+ # provider_types: ["CodeCommit"], # accepts CodeCommit, GitHub, Bitbucket, GitHubEnterpriseServer
649
851
  # states: ["Associated"], # accepts Associated, Associating, Failed, Disassociating
650
852
  # names: ["Name"],
651
853
  # owners: ["Owner"],
@@ -658,7 +860,32 @@ module Aws::CodeGuruReviewer
658
860
  # @return [Array<String>]
659
861
  #
660
862
  # @!attribute [rw] states
661
- # List of states to use as a filter.
863
+ # List of repository association states to use as a filter.
864
+ #
865
+ # The valid repository association states are:
866
+ #
867
+ # * **Associated**\: The repository association is complete.
868
+ #
869
+ # * **Associating**\: CodeGuru Reviewer is:
870
+ #
871
+ # * Setting up pull request notifications. This is required for pull
872
+ # requests to trigger a CodeGuru Reviewer review.
873
+ #
874
+ # <note markdown="1"> If your repository `ProviderType` is `GitHub`, `GitHub
875
+ # Enterprise Server`, or `Bitbucket`, CodeGuru Reviewer creates
876
+ # webhooks in your repository to trigger CodeGuru Reviewer
877
+ # reviews. If you delete these webhooks, reviews of code in your
878
+ # repository cannot be triggered.
879
+ #
880
+ # </note>
881
+ #
882
+ # * Setting up source code access. This is required for CodeGuru
883
+ # Reviewer to securely clone code in your repository.
884
+ #
885
+ # * **Failed**\: The repository failed to associate or disassociate.
886
+ #
887
+ # * **Disassociating**\: CodeGuru Reviewer is removing the
888
+ # repository's pull request notifications and source code access.
662
889
  # @return [Array<String>]
663
890
  #
664
891
  # @!attribute [rw] names
@@ -666,10 +893,11 @@ module Aws::CodeGuruReviewer
666
893
  # @return [Array<String>]
667
894
  #
668
895
  # @!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.
896
+ # List of owners to use as a filter. For AWS CodeCommit, it is the
897
+ # name of the CodeCommit account that was used to associate the
898
+ # repository. For other repository source providers, such as Bitbucket
899
+ # and GitHub Enterprise Server, this is name of the account that was
900
+ # used to associate the repository.
673
901
  # @return [Array<String>]
674
902
  #
675
903
  # @!attribute [rw] max_results
@@ -679,9 +907,9 @@ module Aws::CodeGuruReviewer
679
907
  # `maxResults` results in a single page with a `nextToken` response
680
908
  # element. The remaining results of the initial request can be seen by
681
909
  # sending another `ListRepositoryAssociations` request with the
682
- # returned `nextToken` value. This value can be between 1 and 25. If
910
+ # returned `nextToken` value. This value can be between 1 and 100. If
683
911
  # this parameter is not used, `ListRepositoryAssociations` returns up
684
- # to 25 results and a `nextToken` value if applicable.
912
+ # to 100 results and a `nextToken` value if applicable.
685
913
  # @return [Integer]
686
914
  #
687
915
  # @!attribute [rw] next_token
@@ -736,7 +964,18 @@ module Aws::CodeGuruReviewer
736
964
  # Information about the statistics from the code review.
737
965
  #
738
966
  # @!attribute [rw] metered_lines_of_code_count
739
- # Lines of code metered in the code review.
967
+ # Lines of code metered in the code review. For the initial code
968
+ # review pull request and all subsequent revisions, this includes all
969
+ # lines of code in the files added to the pull request. In subsequent
970
+ # revisions, for files that already existed in the pull request, this
971
+ # includes only the changed lines of code. In both cases, this does
972
+ # not include non-code lines such as comments and import statements.
973
+ # For example, if you submit a pull request containing 5 files, each
974
+ # with 500 lines of code, and in a subsequent revision you added a new
975
+ # file with 200 lines of code, and also modified a total of 25 lines
976
+ # across the initial 5 files, `MeteredLinesOfCodeCount` includes the
977
+ # first 5 files (5 * 500 = 2,500 lines), the new file (200 lines) and
978
+ # the 25 changed lines of code for a total of 2,725 lines of code.
740
979
  # @return [Integer]
741
980
  #
742
981
  # @!attribute [rw] findings_count
@@ -755,7 +994,18 @@ module Aws::CodeGuruReviewer
755
994
  # Information about metrics summaries.
756
995
  #
757
996
  # @!attribute [rw] metered_lines_of_code_count
758
- # Lines of code metered in the code review.
997
+ # Lines of code metered in the code review. For the initial code
998
+ # review pull request and all subsequent revisions, this includes all
999
+ # lines of code in the files added to the pull request. In subsequent
1000
+ # revisions, for files that already existed in the pull request, this
1001
+ # includes only the changed lines of code. In both cases, this does
1002
+ # not include non-code lines such as comments and import statements.
1003
+ # For example, if you submit a pull request containing 5 files, each
1004
+ # with 500 lines of code, and in a subsequent revision you added a new
1005
+ # file with 200 lines of code, and also modified a total of 25 lines
1006
+ # across the initial 5 files, `MeteredLinesOfCodeCount` includes the
1007
+ # first 5 files (5 * 500 = 2,500 lines), the new file (200 lines) and
1008
+ # the 25 changed lines of code for a total of 2,725 lines of code.
759
1009
  # @return [Integer]
760
1010
  #
761
1011
  # @!attribute [rw] findings_count
@@ -794,7 +1044,11 @@ module Aws::CodeGuruReviewer
794
1044
  # }
795
1045
  #
796
1046
  # @!attribute [rw] code_review_arn
797
- # The Amazon Resource Name (ARN) that identifies the code review.
1047
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
1048
+ #
1049
+ #
1050
+ #
1051
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
798
1052
  # @return [String]
799
1053
  #
800
1054
  # @!attribute [rw] recommendation_id
@@ -824,7 +1078,11 @@ module Aws::CodeGuruReviewer
824
1078
  # Information about the recommendation feedback.
825
1079
  #
826
1080
  # @!attribute [rw] code_review_arn
827
- # The Amazon Resource Name (ARN) that identifies the code review.
1081
+ # The Amazon Resource Name (ARN) of the [ `CodeReview` ][1] object.
1082
+ #
1083
+ #
1084
+ #
1085
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html
828
1086
  # @return [String]
829
1087
  #
830
1088
  # @!attribute [rw] recommendation_id
@@ -838,7 +1096,16 @@ module Aws::CodeGuruReviewer
838
1096
  # @return [Array<String>]
839
1097
  #
840
1098
  # @!attribute [rw] user_id
841
- # The user principal that made the API call.
1099
+ # The ID of the user that made the API call.
1100
+ #
1101
+ # The `UserId` is an IAM principal that can be specified as an AWS
1102
+ # account ID or an Amazon Resource Name (ARN). For more information,
1103
+ # see [ Specifying a Principal][1] in the *AWS Identity and Access
1104
+ # Management User Guide*.
1105
+ #
1106
+ #
1107
+ #
1108
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
842
1109
  # @return [String]
843
1110
  #
844
1111
  # @!attribute [rw] created_time_stamp
@@ -875,7 +1142,16 @@ module Aws::CodeGuruReviewer
875
1142
  # @return [Array<String>]
876
1143
  #
877
1144
  # @!attribute [rw] user_id
878
- # The identifier for the user that gave the feedback.
1145
+ # The ID of the user that gave the feedback.
1146
+ #
1147
+ # The `UserId` is an IAM principal that can be specified as an AWS
1148
+ # account ID or an Amazon Resource Name (ARN). For more information,
1149
+ # see [ Specifying a Principal][1] in the *AWS Identity and Access
1150
+ # Management User Guide*.
1151
+ #
1152
+ #
1153
+ #
1154
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying
879
1155
  # @return [String]
880
1156
  #
881
1157
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/RecommendationFeedbackSummary AWS API Documentation
@@ -907,7 +1183,7 @@ module Aws::CodeGuruReviewer
907
1183
  # @!attribute [rw] end_line
908
1184
  # Last line where the recommendation is applicable in the source
909
1185
  # commit or source branch. For a single line comment the start line
910
- # and end line values will be the same.
1186
+ # and end line values are the same.
911
1187
  # @return [Integer]
912
1188
  #
913
1189
  # @!attribute [rw] description
@@ -927,7 +1203,10 @@ module Aws::CodeGuruReviewer
927
1203
  include Aws::Structure
928
1204
  end
929
1205
 
930
- # Information about a repository.
1206
+ # Information about an associated AWS CodeCommit repository or an
1207
+ # associated repository that is managed by AWS CodeStar Connections (for
1208
+ # example, Bitbucket). This `Repository` object is not used if your
1209
+ # source code is in an associated GitHub repository.
931
1210
  #
932
1211
  # @note When making an API call, you may pass Repository
933
1212
  # data as a hash:
@@ -941,6 +1220,11 @@ module Aws::CodeGuruReviewer
941
1220
  # connection_arn: "ConnectionArn", # required
942
1221
  # owner: "Owner", # required
943
1222
  # },
1223
+ # git_hub_enterprise_server: {
1224
+ # name: "Name", # required
1225
+ # connection_arn: "ConnectionArn", # required
1226
+ # owner: "Owner", # required
1227
+ # },
944
1228
  # }
945
1229
  #
946
1230
  # @!attribute [rw] code_commit
@@ -948,19 +1232,64 @@ module Aws::CodeGuruReviewer
948
1232
  # @return [Types::CodeCommitRepository]
949
1233
  #
950
1234
  # @!attribute [rw] bitbucket
951
- # Information about a Bitbucket Cloud repository.
1235
+ # Information about a Bitbucket repository.
1236
+ # @return [Types::ThirdPartySourceRepository]
1237
+ #
1238
+ # @!attribute [rw] git_hub_enterprise_server
1239
+ # Information about a GitHub Enterprise Server repository.
952
1240
  # @return [Types::ThirdPartySourceRepository]
953
1241
  #
954
1242
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/Repository AWS API Documentation
955
1243
  #
956
1244
  class Repository < Struct.new(
957
1245
  :code_commit,
958
- :bitbucket)
1246
+ :bitbucket,
1247
+ :git_hub_enterprise_server)
1248
+ SENSITIVE = []
1249
+ include Aws::Structure
1250
+ end
1251
+
1252
+ # A code review type that analyzes all code under a specified branch in
1253
+ # an associated respository. The assocated repository is specified using
1254
+ # its ARN when you call [ `CreateCodeReview` ][1].
1255
+ #
1256
+ #
1257
+ #
1258
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CreateCodeReview
1259
+ #
1260
+ # @note When making an API call, you may pass RepositoryAnalysis
1261
+ # data as a hash:
1262
+ #
1263
+ # {
1264
+ # repository_head: { # required
1265
+ # branch_name: "BranchName", # required
1266
+ # },
1267
+ # }
1268
+ #
1269
+ # @!attribute [rw] repository_head
1270
+ # A [ `SourceCodeType` ][1] that specifies the tip of a branch in an
1271
+ # associated repository.
1272
+ #
1273
+ #
1274
+ #
1275
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_SourceCodeType
1276
+ # @return [Types::RepositoryHeadSourceCodeType]
1277
+ #
1278
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/RepositoryAnalysis AWS API Documentation
1279
+ #
1280
+ class RepositoryAnalysis < Struct.new(
1281
+ :repository_head)
959
1282
  SENSITIVE = []
960
1283
  include Aws::Structure
961
1284
  end
962
1285
 
963
- # Information about a repository association.
1286
+ # Information about a repository association. The [
1287
+ # `DescribeRepositoryAssociation` ][1] operation returns a
1288
+ # `RepositoryAssociation` object.
1289
+ #
1290
+ #
1291
+ #
1292
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_DescribeRepositoryAssociation.html
964
1293
  #
965
1294
  # @!attribute [rw] association_id
966
1295
  # The ID of the repository association.
@@ -972,8 +1301,15 @@ module Aws::CodeGuruReviewer
972
1301
  # @return [String]
973
1302
  #
974
1303
  # @!attribute [rw] connection_arn
975
- # The Amazon Resource Name (ARN) identifying the repository
976
- # connection.
1304
+ # The Amazon Resource Name (ARN) of an AWS CodeStar Connections
1305
+ # connection. Its format is
1306
+ # `arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id`.
1307
+ # For more information, see [ `Connection` ][1] in the *AWS CodeStar
1308
+ # Connections API Reference*.
1309
+ #
1310
+ #
1311
+ #
1312
+ # [1]: https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html
977
1313
  # @return [String]
978
1314
  #
979
1315
  # @!attribute [rw] name
@@ -981,7 +1317,10 @@ module Aws::CodeGuruReviewer
981
1317
  # @return [String]
982
1318
  #
983
1319
  # @!attribute [rw] owner
984
- # The owner of the repository.
1320
+ # The owner of the repository. For an AWS CodeCommit repository, this
1321
+ # is the AWS account ID of the account that owns the repository. For a
1322
+ # GitHub, GitHub Enterprise Server, or Bitbucket repository, this is
1323
+ # the username for the account that owns the repository.
985
1324
  # @return [String]
986
1325
  #
987
1326
  # @!attribute [rw] provider_type
@@ -990,6 +1329,31 @@ module Aws::CodeGuruReviewer
990
1329
  #
991
1330
  # @!attribute [rw] state
992
1331
  # The state of the repository association.
1332
+ #
1333
+ # The valid repository association states are:
1334
+ #
1335
+ # * **Associated**\: The repository association is complete.
1336
+ #
1337
+ # * **Associating**\: CodeGuru Reviewer is:
1338
+ #
1339
+ # * Setting up pull request notifications. This is required for pull
1340
+ # requests to trigger a CodeGuru Reviewer review.
1341
+ #
1342
+ # <note markdown="1"> If your repository `ProviderType` is `GitHub`, `GitHub
1343
+ # Enterprise Server`, or `Bitbucket`, CodeGuru Reviewer creates
1344
+ # webhooks in your repository to trigger CodeGuru Reviewer
1345
+ # reviews. If you delete these webhooks, reviews of code in your
1346
+ # repository cannot be triggered.
1347
+ #
1348
+ # </note>
1349
+ #
1350
+ # * Setting up source code access. This is required for CodeGuru
1351
+ # Reviewer to securely clone code in your repository.
1352
+ #
1353
+ # * **Failed**\: The repository failed to associate or disassociate.
1354
+ #
1355
+ # * **Disassociating**\: CodeGuru Reviewer is removing the
1356
+ # repository's pull request notifications and source code access.
993
1357
  # @return [String]
994
1358
  #
995
1359
  # @!attribute [rw] state_reason
@@ -1024,16 +1388,33 @@ module Aws::CodeGuruReviewer
1024
1388
  include Aws::Structure
1025
1389
  end
1026
1390
 
1027
- # Information about a repository association.
1391
+ # Summary information about a repository association. The [
1392
+ # `ListRepositoryAssociations` ][1] operation returns a list of
1393
+ # `RepositoryAssociationSummary` objects.
1394
+ #
1395
+ #
1396
+ #
1397
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_ListRepositoryAssociations.html
1028
1398
  #
1029
1399
  # @!attribute [rw] association_arn
1030
- # The Amazon Resource Name (ARN) identifying the repository
1031
- # association.
1400
+ # The Amazon Resource Name (ARN) of the [ `RepositoryAssociation` ][1]
1401
+ # object. You can retrieve this ARN by calling `ListRepositories`.
1402
+ #
1403
+ #
1404
+ #
1405
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html
1032
1406
  # @return [String]
1033
1407
  #
1034
1408
  # @!attribute [rw] connection_arn
1035
- # The Amazon Resource Name (ARN) identifying the repository
1036
- # connection.
1409
+ # The Amazon Resource Name (ARN) of an AWS CodeStar Connections
1410
+ # connection. Its format is
1411
+ # `arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id`.
1412
+ # For more information, see [ `Connection` ][1] in the *AWS CodeStar
1413
+ # Connections API Reference*.
1414
+ #
1415
+ #
1416
+ #
1417
+ # [1]: https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html
1037
1418
  # @return [String]
1038
1419
  #
1039
1420
  # @!attribute [rw] last_updated_time_stamp
@@ -1050,7 +1431,10 @@ module Aws::CodeGuruReviewer
1050
1431
  # @return [String]
1051
1432
  #
1052
1433
  # @!attribute [rw] owner
1053
- # The owner of the repository association.
1434
+ # The owner of the repository. For an AWS CodeCommit repository, this
1435
+ # is the AWS account ID of the account that owns the repository. For a
1436
+ # GitHub, GitHub Enterprise Server, or Bitbucket repository, this is
1437
+ # the username for the account that owns the repository.
1054
1438
  # @return [String]
1055
1439
  #
1056
1440
  # @!attribute [rw] provider_type
@@ -1060,22 +1444,30 @@ module Aws::CodeGuruReviewer
1060
1444
  # @!attribute [rw] state
1061
1445
  # The state of the repository association.
1062
1446
  #
1063
- # Associated
1447
+ # The valid repository association states are:
1448
+ #
1449
+ # * **Associated**\: The repository association is complete.
1064
1450
  #
1065
- # : Amazon CodeGuru Reviewer is associated with the repository.
1451
+ # * **Associating**\: CodeGuru Reviewer is:
1066
1452
  #
1067
- # Associating
1453
+ # * Setting up pull request notifications. This is required for pull
1454
+ # requests to trigger a CodeGuru Reviewer review.
1068
1455
  #
1069
- # : The association is in progress.
1456
+ # <note markdown="1"> If your repository `ProviderType` is `GitHub`, `GitHub
1457
+ # Enterprise Server`, or `Bitbucket`, CodeGuru Reviewer creates
1458
+ # webhooks in your repository to trigger CodeGuru Reviewer
1459
+ # reviews. If you delete these webhooks, reviews of code in your
1460
+ # repository cannot be triggered.
1070
1461
  #
1071
- # Failed
1462
+ # </note>
1072
1463
  #
1073
- # : The association failed.
1464
+ # * Setting up source code access. This is required for CodeGuru
1465
+ # Reviewer to securely clone code in your repository.
1074
1466
  #
1075
- # Disassociating
1467
+ # * **Failed**\: The repository failed to associate or disassociate.
1076
1468
  #
1077
- # : Amazon CodeGuru Reviewer is in the process of disassociating with
1078
- # the repository.
1469
+ # * **Disassociating**\: CodeGuru Reviewer is removing the
1470
+ # repository's pull request notifications and source code access.
1079
1471
  # @return [String]
1080
1472
  #
1081
1473
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/RepositoryAssociationSummary AWS API Documentation
@@ -1093,6 +1485,33 @@ module Aws::CodeGuruReviewer
1093
1485
  include Aws::Structure
1094
1486
  end
1095
1487
 
1488
+ # A [ `SourceCodeType` ][1] that specifies the tip of a branch in an
1489
+ # associated repository.
1490
+ #
1491
+ #
1492
+ #
1493
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_SourceCodeType
1494
+ #
1495
+ # @note When making an API call, you may pass RepositoryHeadSourceCodeType
1496
+ # data as a hash:
1497
+ #
1498
+ # {
1499
+ # branch_name: "BranchName", # required
1500
+ # }
1501
+ #
1502
+ # @!attribute [rw] branch_name
1503
+ # The name of the branch in an associated repository. The
1504
+ # `RepositoryHeadSourceCodeType` specifies the tip of this branch.
1505
+ # @return [String]
1506
+ #
1507
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/RepositoryHeadSourceCodeType AWS API Documentation
1508
+ #
1509
+ class RepositoryHeadSourceCodeType < Struct.new(
1510
+ :branch_name)
1511
+ SENSITIVE = []
1512
+ include Aws::Structure
1513
+ end
1514
+
1096
1515
  # The resource specified in the request was not found.
1097
1516
  #
1098
1517
  # @!attribute [rw] message
@@ -1106,22 +1525,39 @@ module Aws::CodeGuruReviewer
1106
1525
  include Aws::Structure
1107
1526
  end
1108
1527
 
1109
- # Information about the source code type.
1528
+ # Specifies the source code that is analyzed in a code review. A code
1529
+ # review can analyze the source code that is specified using a pull
1530
+ # request diff or a branch in an associated repository.
1110
1531
  #
1111
1532
  # @!attribute [rw] commit_diff
1112
- # The commit diff for the pull request.
1533
+ # A [ `SourceCodeType` ][1] that specifies a commit diff created by a
1534
+ # pull request on an associated repository.
1535
+ #
1536
+ #
1537
+ #
1538
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_SourceCodeType
1113
1539
  # @return [Types::CommitDiffSourceCodeType]
1114
1540
  #
1541
+ # @!attribute [rw] repository_head
1542
+ # A [ `SourceCodeType` ][1] that specifies the tip of a branch in an
1543
+ # associated repository.
1544
+ #
1545
+ #
1546
+ #
1547
+ # [1]: https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_SourceCodeType
1548
+ # @return [Types::RepositoryHeadSourceCodeType]
1549
+ #
1115
1550
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/SourceCodeType AWS API Documentation
1116
1551
  #
1117
1552
  class SourceCodeType < Struct.new(
1118
- :commit_diff)
1553
+ :commit_diff,
1554
+ :repository_head)
1119
1555
  SENSITIVE = []
1120
1556
  include Aws::Structure
1121
1557
  end
1122
1558
 
1123
- # Information about a third party source repository connected through
1124
- # CodeStar Connections.
1559
+ # Information about a third-party source repository connected to
1560
+ # CodeGuru Reviewer.
1125
1561
  #
1126
1562
  # @note When making an API call, you may pass ThirdPartySourceRepository
1127
1563
  # data as a hash:
@@ -1137,12 +1573,21 @@ module Aws::CodeGuruReviewer
1137
1573
  # @return [String]
1138
1574
  #
1139
1575
  # @!attribute [rw] connection_arn
1140
- # The Amazon Resource Name (ARN) identifying the repository
1141
- # connection.
1576
+ # The Amazon Resource Name (ARN) of an AWS CodeStar Connections
1577
+ # connection. Its format is
1578
+ # `arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id`.
1579
+ # For more information, see [ `Connection` ][1] in the *AWS CodeStar
1580
+ # Connections API Reference*.
1581
+ #
1582
+ #
1583
+ #
1584
+ # [1]: https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html
1142
1585
  # @return [String]
1143
1586
  #
1144
1587
  # @!attribute [rw] owner
1145
- # The username of the owner of the repository.
1588
+ # The owner of the repository. For a GitHub, GitHub Enterprise, or
1589
+ # Bitbucket repository, this is the username for the account that owns
1590
+ # the repository.
1146
1591
  # @return [String]
1147
1592
  #
1148
1593
  # @see http://docs.aws.amazon.com/goto/WebAPI/codeguru-reviewer-2019-09-19/ThirdPartySourceRepository AWS API Documentation