API Reference

Amazon CodeGuru Reviewer

API Version 2019-09-19

Copyright © 2024 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.
Amazon CodeGuru Reviewer API Reference

Amazon CodeGuru Reviewer: API Reference

Copyright © 2024 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

Amazon's trademarks and trade dress may not be used in connection with any product or service
that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any
manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are
the property of their respective owners, who may or may not be affiliated with, connected to, or
sponsored by Amazon.
Amazon CodeGuru Reviewer API Reference

Table of Contents
Welcome ........................................................................................................................................... 1
Actions .............................................................................................................................................. 2
AssociateRepository ..................................................................................................................................... 3
Request Syntax ........................................................................................................................................ 3
URI Request Parameters ........................................................................................................................ 4
Request Body ........................................................................................................................................... 4
Response Syntax ...................................................................................................................................... 5
Response Elements ................................................................................................................................. 6
Errors .......................................................................................................................................................... 7
See Also ..................................................................................................................................................... 8
CreateCodeReview ........................................................................................................................................ 9
Request Syntax ........................................................................................................................................ 9
URI Request Parameters ...................................................................................................................... 10
Request Body ......................................................................................................................................... 10
Response Syntax ................................................................................................................................... 11
Response Elements ............................................................................................................................... 13
Errors ....................................................................................................................................................... 13
See Also .................................................................................................................................................. 14
DescribeCodeReview .................................................................................................................................. 15
Request Syntax ...................................................................................................................................... 15
URI Request Parameters ...................................................................................................................... 15
Request Body ......................................................................................................................................... 15
Response Syntax ................................................................................................................................... 15
Response Elements ............................................................................................................................... 17
Errors ....................................................................................................................................................... 17
See Also .................................................................................................................................................. 18
DescribeRecommendationFeedback ....................................................................................................... 19
Request Syntax ...................................................................................................................................... 19
URI Request Parameters ...................................................................................................................... 19
Request Body ......................................................................................................................................... 20
Response Syntax ................................................................................................................................... 20
Response Elements ............................................................................................................................... 20
Errors ....................................................................................................................................................... 20
See Also .................................................................................................................................................. 21

API Version 2019-09-19 iii

Amazon CodeGuru Reviewer API Reference

DescribeRepositoryAssociation ................................................................................................................ 22
Request Syntax ...................................................................................................................................... 22
URI Request Parameters ...................................................................................................................... 22
Request Body ......................................................................................................................................... 22
Response Syntax ................................................................................................................................... 22
Response Elements ............................................................................................................................... 23
Errors ....................................................................................................................................................... 24
See Also .................................................................................................................................................. 25
DisassociateRepository .............................................................................................................................. 26
Request Syntax ...................................................................................................................................... 26
URI Request Parameters ...................................................................................................................... 26
Request Body ......................................................................................................................................... 26
Response Syntax ................................................................................................................................... 26
Response Elements ............................................................................................................................... 27
Errors ....................................................................................................................................................... 28
See Also .................................................................................................................................................. 29
ListCodeReviews ......................................................................................................................................... 30
Request Syntax ...................................................................................................................................... 30
URI Request Parameters ...................................................................................................................... 30
Request Body ......................................................................................................................................... 31
Response Syntax ................................................................................................................................... 31
Response Elements ............................................................................................................................... 33
Errors ....................................................................................................................................................... 33
See Also .................................................................................................................................................. 34
ListRecommendationFeedback ................................................................................................................ 35
Request Syntax ...................................................................................................................................... 35
URI Request Parameters ...................................................................................................................... 35
Request Body ......................................................................................................................................... 36
Response Syntax ................................................................................................................................... 36
Response Elements ............................................................................................................................... 36
Errors ....................................................................................................................................................... 37
See Also .................................................................................................................................................. 38
ListRecommendations ............................................................................................................................... 39
Request Syntax ...................................................................................................................................... 39
URI Request Parameters ...................................................................................................................... 39
Request Body ......................................................................................................................................... 39

API Version 2019-09-19 iv

Amazon CodeGuru Reviewer API Reference

Response Syntax ................................................................................................................................... 39

Response Elements ............................................................................................................................... 40
Errors ....................................................................................................................................................... 41
See Also .................................................................................................................................................. 41
ListRepositoryAssociations ....................................................................................................................... 43
Request Syntax ...................................................................................................................................... 43
URI Request Parameters ...................................................................................................................... 43
Request Body ......................................................................................................................................... 45
Response Syntax ................................................................................................................................... 45
Response Elements ............................................................................................................................... 46
Errors ....................................................................................................................................................... 46
See Also .................................................................................................................................................. 47
ListTagsForResource ................................................................................................................................... 48
Request Syntax ...................................................................................................................................... 48
URI Request Parameters ...................................................................................................................... 48
Request Body ......................................................................................................................................... 48
Response Syntax ................................................................................................................................... 48
Response Elements ............................................................................................................................... 49
Errors ....................................................................................................................................................... 49
See Also .................................................................................................................................................. 50
PutRecommendationFeedback ................................................................................................................ 51
Request Syntax ...................................................................................................................................... 51
URI Request Parameters ...................................................................................................................... 51
Request Body ......................................................................................................................................... 51
Response Syntax ................................................................................................................................... 52
Response Elements ............................................................................................................................... 52
Errors ....................................................................................................................................................... 52
See Also .................................................................................................................................................. 53
TagResource ................................................................................................................................................. 54
Request Syntax ...................................................................................................................................... 54
URI Request Parameters ...................................................................................................................... 54
Request Body ......................................................................................................................................... 54
Response Syntax ................................................................................................................................... 55
Response Elements ............................................................................................................................... 55
Errors ....................................................................................................................................................... 55
See Also .................................................................................................................................................. 56

API Version 2019-09-19 v

Amazon CodeGuru Reviewer API Reference

UntagResource ............................................................................................................................................ 57
Request Syntax ...................................................................................................................................... 57
URI Request Parameters ...................................................................................................................... 57
Request Body ......................................................................................................................................... 57
Response Syntax ................................................................................................................................... 57
Response Elements ............................................................................................................................... 58
Errors ....................................................................................................................................................... 58
See Also .................................................................................................................................................. 58
Data Types ..................................................................................................................................... 59
BranchDiffSourceCodeType ...................................................................................................................... 61
Contents .................................................................................................................................................. 61
See Also .................................................................................................................................................. 61
CodeArtifacts ............................................................................................................................................... 62
Contents .................................................................................................................................................. 62
See Also .................................................................................................................................................. 62
CodeCommitRepository ............................................................................................................................ 64
Contents .................................................................................................................................................. 64
See Also .................................................................................................................................................. 64
CodeReview ................................................................................................................................................. 65
Contents .................................................................................................................................................. 65
See Also .................................................................................................................................................. 69
CodeReviewSummary ................................................................................................................................ 70
Contents .................................................................................................................................................. 70
See Also .................................................................................................................................................. 73
CodeReviewType ......................................................................................................................................... 74
Contents .................................................................................................................................................. 74
See Also .................................................................................................................................................. 74
CommitDiffSourceCodeType .................................................................................................................... 76
Contents .................................................................................................................................................. 76
See Also .................................................................................................................................................. 76
EventInfo ...................................................................................................................................................... 78
Contents .................................................................................................................................................. 78
See Also .................................................................................................................................................. 78
KMSKeyDetails ............................................................................................................................................ 80
Contents .................................................................................................................................................. 80
See Also .................................................................................................................................................. 80

API Version 2019-09-19 vi

Amazon CodeGuru Reviewer API Reference

Metrics .......................................................................................................................................................... 82
Contents .................................................................................................................................................. 82
See Also .................................................................................................................................................. 82
MetricsSummary ......................................................................................................................................... 84
Contents .................................................................................................................................................. 84
See Also .................................................................................................................................................. 85
RecommendationFeedback ...................................................................................................................... 86
Contents .................................................................................................................................................. 86
See Also .................................................................................................................................................. 87
RecommendationFeedbackSummary ..................................................................................................... 88
Contents .................................................................................................................................................. 88
See Also .................................................................................................................................................. 89
RecommendationSummary ...................................................................................................................... 90
Contents .................................................................................................................................................. 90
See Also .................................................................................................................................................. 92
Repository .................................................................................................................................................... 93
Contents .................................................................................................................................................. 93
See Also .................................................................................................................................................. 93
RepositoryAnalysis ..................................................................................................................................... 95
Contents .................................................................................................................................................. 95
See Also .................................................................................................................................................. 95
RepositoryAssociation ............................................................................................................................... 96
Contents .................................................................................................................................................. 96
See Also .................................................................................................................................................. 99
RepositoryAssociationSummary ............................................................................................................ 101
Contents ............................................................................................................................................... 101
See Also ................................................................................................................................................ 104
RepositoryHeadSourceCodeType .......................................................................................................... 105
Contents ............................................................................................................................................... 105
See Also ................................................................................................................................................ 105
RequestMetadata ..................................................................................................................................... 106
Contents ............................................................................................................................................... 106
See Also ................................................................................................................................................ 107
RuleMetadata ............................................................................................................................................ 108
Contents ............................................................................................................................................... 108
See Also ................................................................................................................................................ 109

API Version 2019-09-19 vii

Amazon CodeGuru Reviewer API Reference

S3BucketRepository ................................................................................................................................. 110

Contents ............................................................................................................................................... 110
See Also ................................................................................................................................................ 110
S3Repository ............................................................................................................................................. 111
Contents ............................................................................................................................................... 111
See Also ................................................................................................................................................ 111
S3RepositoryDetails ................................................................................................................................. 113
Contents ............................................................................................................................................... 113
See Also ................................................................................................................................................ 113
SourceCodeType ....................................................................................................................................... 114
Contents ............................................................................................................................................... 114
See Also ................................................................................................................................................ 115
ThirdPartySourceRepository .................................................................................................................. 116
Contents ............................................................................................................................................... 116
See Also ................................................................................................................................................ 117
Common Parameters ................................................................................................................... 118
Common Errors ............................................................................................................................ 121

API Version 2019-09-19 viii

Amazon CodeGuru Reviewer API Reference

Welcome
This section provides documentation for the Amazon CodeGuru Reviewer API operations. CodeGuru
Reviewer is a service that uses program analysis and machine learning to detect potential defects
that are difficult for developers to find and recommends fixes in your Java and Python code.

By proactively detecting and providing recommendations for addressing code defects and
implementing best practices, CodeGuru Reviewer improves the overall quality and maintainability
of your code base during the code review stage. For more information about CodeGuru Reviewer,
see the Amazon CodeGuru Reviewer User Guide.

To improve the security of your CodeGuru Reviewer API calls, you can establish a private
connection between your VPC and CodeGuru Reviewer by creating an interface VPC endpoint. For
more information, see CodeGuru Reviewer and interface VPC endpoints (AWS PrivateLink) in the
Amazon CodeGuru Reviewer User Guide.

This document was last published on February 21, 2024.

API Version 2019-09-19 1

Amazon CodeGuru Reviewer API Reference

Actions
The following actions are supported:

• AssociateRepository
• CreateCodeReview
• DescribeCodeReview
• DescribeRecommendationFeedback
• DescribeRepositoryAssociation
• DisassociateRepository
• ListCodeReviews
• ListRecommendationFeedback
• ListRecommendations
• ListRepositoryAssociations
• ListTagsForResource
• PutRecommendationFeedback
• TagResource
• UntagResource

API Version 2019-09-19 2

Amazon CodeGuru Reviewer API Reference

AssociateRepository
Use to associate an AWS CodeCommit repository or a repository managed by AWS CodeStar
Connections with Amazon CodeGuru Reviewer. When you associate a repository, CodeGuru
Reviewer reviews source code changes in the repository's pull requests and provides automatic
recommendations. You can view recommendations using the CodeGuru Reviewer console. For
more information, see Recommendations in Amazon CodeGuru Reviewer in the Amazon CodeGuru
Reviewer User Guide.

If you associate a CodeCommit or S3 repository, it must be in the same AWS Region and AWS
account where its CodeGuru Reviewer code reviews are configured.

Bitbucket and GitHub Enterprise Server repositories are managed by AWS CodeStar Connections
to connect to CodeGuru Reviewer. For more information, see Associate a repository in the Amazon
CodeGuru Reviewer User Guide.

Note
You cannot use the CodeGuru Reviewer SDK or the AWS CLI to associate a GitHub
repository with Amazon CodeGuru Reviewer. To associate a GitHub repository, use the
console. For more information, see Getting started with CodeGuru Reviewer in the
CodeGuru Reviewer User Guide.

Request Syntax

POST /associations HTTP/1.1

Content-type: application/json

{
"ClientRequestToken": "string",
"KMSKeyDetails": {
"EncryptionOption": "string",
"KMSKeyId": "string"
},
"Repository": {
"Bitbucket": {
"ConnectionArn": "string",
"Name": "string",
"Owner": "string"

AssociateRepository API Version 2019-09-19 3

Amazon CodeGuru Reviewer API Reference

},
"CodeCommit": {
"Name": "string"
},
"GitHubEnterpriseServer": {
"ConnectionArn": "string",
"Name": "string",
"Owner": "string"
},
"S3Bucket": {
"BucketName": "string",
"Name": "string"
}
},
"Tags": {
"string" : "string"
}
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

ClientRequestToken

Amazon CodeGuru Reviewer uses this value to prevent the accidental creation of duplicate
repository associations if there are failures and retries.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^[\w-]+$

Required: No
KMSKeyDetails

A KMSKeyDetails object that contains:

URI Request Parameters API Version 2019-09-19 4

Amazon CodeGuru Reviewer API Reference

• The encryption option for this repository association. It is either owned by

AWS Key Management Service (KMS) (AWS_OWNED_CMK) or customer managed
(CUSTOMER_MANAGED_CMK).
• The ID of the AWS KMS key that is associated with this repository association.

Type: KMSKeyDetails object

Required: No
Repository

The repository to associate.

Type: Repository object

Required: Yes
Tags

An array of key-value pairs used to tag an associated repository. A tag is a custom attribute
label with two parts:
• A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case
sensitive.
• An optional field known as a tag value (for example, 111122223333, Production, or a team
name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values
are case sensitive.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Maximum length of 256.

Required: No

Response Syntax

HTTP/1.1 200
Content-type: application/json

Response Syntax API Version 2019-09-19 5

Amazon CodeGuru Reviewer API Reference

"RepositoryAssociation": {
"AssociationArn": "string",
"AssociationId": "string",
"ConnectionArn": "string",
"CreatedTimeStamp": number,
"KMSKeyDetails": {
"EncryptionOption": "string",
"KMSKeyId": "string"
},
"LastUpdatedTimeStamp": number,
"Name": "string",
"Owner": "string",
"ProviderType": "string",
"S3RepositoryDetails": {
"BucketName": "string",
"CodeArtifacts": {
"BuildArtifactsObjectKey": "string",
"SourceCodeArtifactsObjectKey": "string"
}
},
"State": "string",
"StateReason": "string"
},
"Tags": {
"string" : "string"
}
}

Response Elements
If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

RepositoryAssociation

Information about the repository association.

Type: RepositoryAssociation object

Tags

An array of key-value pairs used to tag an associated repository. A tag is a custom attribute
label with two parts:

Response Elements API Version 2019-09-19 6

Amazon CodeGuru Reviewer API Reference

• A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case
sensitive.
• An optional field known as a tag value (for example, 111122223333, Production, or a team
name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values
are case sensitive.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Maximum length of 256.

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

ConflictException

The requested operation would cause a conflict with the current state of a service resource
associated with the request. Resolve the conflict before retrying this request.

HTTP Status Code: 409

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

Errors API Version 2019-09-19 7

Amazon CodeGuru Reviewer API Reference

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 8

Amazon CodeGuru Reviewer API Reference

CreateCodeReview
Use to create a code review with a CodeReviewType of RepositoryAnalysis. This type of code
review analyzes all code under a specified branch in an associated repository. PullRequest code
reviews are automatically triggered by a pull request.

Request Syntax

POST /codereviews HTTP/1.1

Content-type: application/json

{
"ClientRequestToken": "string",
"Name": "string",
"RepositoryAssociationArn": "string",
"Type": {
"AnalysisTypes": [ "string" ],
"RepositoryAnalysis": {
"RepositoryHead": {
"BranchName": "string"
},
"SourceCodeType": {
"BranchDiff": {
"DestinationBranchName": "string",
"SourceBranchName": "string"
},
"CommitDiff": {
"DestinationCommit": "string",
"MergeBaseCommit": "string",
"SourceCommit": "string"
},
"RepositoryHead": {
"BranchName": "string"
},
"RequestMetadata": {
"EventInfo": {
"Name": "string",
"State": "string"
},
"Requester": "string",
"RequestId": "string",
"VendorName": "string"

CreateCodeReview API Version 2019-09-19 9

Amazon CodeGuru Reviewer API Reference

},
"S3BucketRepository": {
"Details": {
"BucketName": "string",
"CodeArtifacts": {
"BuildArtifactsObjectKey": "string",
"SourceCodeArtifactsObjectKey": "string"
}
},
"Name": "string"
}
}
}
}
}

URI Request Parameters

The request does not use any URI parameters.

Request Body
The request accepts the following data in JSON format.

ClientRequestToken

Amazon CodeGuru Reviewer uses this value to prevent the accidental creation of duplicate code
reviews if there are failures and retries.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^[\w-]+$

Required: No
Name

The name of the code review. The name of each code review in your AWS account must be
unique.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

URI Request Parameters API Version 2019-09-19 10

Amazon CodeGuru Reviewer API Reference

Pattern: [a-zA-Z0-9-_]*

Required: Yes
RepositoryAssociationArn

The Amazon Resource Name (ARN) of the RepositoryAssociation object. You can retrieve this
ARN by calling ListRepositoryAssociations.

A code review can only be created on an associated repository. This is the ARN of the associated
repository.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:association:[a-
f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Required: Yes
Type

The type of code review to create. This is specified using a CodeReviewType object. You can
create a code review only of type RepositoryAnalysis.

Type: CodeReviewType object

Required: Yes

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"CodeReview": {
"AnalysisTypes": [ "string" ],
"AssociationArn": "string",
"CodeReviewArn": "string",
"ConfigFileState": "string",
"CreatedTimeStamp": number,
"LastUpdatedTimeStamp": number,
"Metrics": {

Response Syntax API Version 2019-09-19 11

Amazon CodeGuru Reviewer API Reference

"FindingsCount": number,
"MeteredLinesOfCodeCount": number,
"SuppressedLinesOfCodeCount": number
},
"Name": "string",
"Owner": "string",
"ProviderType": "string",
"PullRequestId": "string",
"RepositoryName": "string",
"SourceCodeType": {
"BranchDiff": {
"DestinationBranchName": "string",
"SourceBranchName": "string"
},
"CommitDiff": {
"DestinationCommit": "string",
"MergeBaseCommit": "string",
"SourceCommit": "string"
},
"RepositoryHead": {
"BranchName": "string"
},
"RequestMetadata": {
"EventInfo": {
"Name": "string",
"State": "string"
},
"Requester": "string",
"RequestId": "string",
"VendorName": "string"
},
"S3BucketRepository": {
"Details": {
"BucketName": "string",
"CodeArtifacts": {
"BuildArtifactsObjectKey": "string",
"SourceCodeArtifactsObjectKey": "string"
}
},
"Name": "string"
}
},
"State": "string",
"StateReason": "string",

Response Syntax API Version 2019-09-19 12

Amazon CodeGuru Reviewer API Reference

"Type": "string"
}
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

CodeReview

Information about a code review. A code review belongs to the associated repository that
contains the reviewed code.

Type: CodeReview object

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

ConflictException

The requested operation would cause a conflict with the current state of a service resource
associated with the request. Resolve the conflict before retrying this request.

HTTP Status Code: 409

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

Response Elements API Version 2019-09-19 13

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 14

Amazon CodeGuru Reviewer API Reference

DescribeCodeReview
Returns the metadata associated with the code review along with its status.

Request Syntax

GET /codereviews/CodeReviewArn HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

CodeReviewArn

The Amazon Resource Name (ARN) of the CodeReview object.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: Yes

Request Body
The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"CodeReview": {
"AnalysisTypes": [ "string" ],
"AssociationArn": "string",
"CodeReviewArn": "string",
"ConfigFileState": "string",
"CreatedTimeStamp": number,
"LastUpdatedTimeStamp": number,
"Metrics": {
"FindingsCount": number,
"MeteredLinesOfCodeCount": number,

DescribeCodeReview API Version 2019-09-19 15

Amazon CodeGuru Reviewer API Reference

"SuppressedLinesOfCodeCount": number
},
"Name": "string",
"Owner": "string",
"ProviderType": "string",
"PullRequestId": "string",
"RepositoryName": "string",
"SourceCodeType": {
"BranchDiff": {
"DestinationBranchName": "string",
"SourceBranchName": "string"
},
"CommitDiff": {
"DestinationCommit": "string",
"MergeBaseCommit": "string",
"SourceCommit": "string"
},
"RepositoryHead": {
"BranchName": "string"
},
"RequestMetadata": {
"EventInfo": {
"Name": "string",
"State": "string"
},
"Requester": "string",
"RequestId": "string",
"VendorName": "string"
},
"S3BucketRepository": {
"Details": {
"BucketName": "string",
"CodeArtifacts": {
"BuildArtifactsObjectKey": "string",
"SourceCodeArtifactsObjectKey": "string"
}
},
"Name": "string"
}
},
"State": "string",
"StateReason": "string",
"Type": "string"
}

Response Syntax API Version 2019-09-19 16

Amazon CodeGuru Reviewer API Reference

Response Elements
If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

CodeReview

Information about the code review.

Type: CodeReview object

Errors
For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

Response Elements API Version 2019-09-19 17

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 18

Amazon CodeGuru Reviewer API Reference

DescribeRecommendationFeedback
Describes the customer feedback for a CodeGuru Reviewer recommendation.

Request Syntax

GET /feedback/CodeReviewArn?RecommendationId=RecommendationId&UserId=UserId HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

CodeReviewArn

The Amazon Resource Name (ARN) of the CodeReview object.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: Yes
RecommendationId

The recommendation ID that can be used to track the provided recommendations and then to
collect the feedback.

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: Yes
UserId

Optional parameter to describe the feedback for a given user. If this is not supplied, it defaults
to the user making the request.

The UserId is an IAM principal that can be specified as an AWS account ID or an Amazon
Resource Name (ARN). For more information, see Specifying a Principal in the AWS Identity and
Access Management User Guide.

Length Constraints: Minimum length of 1. Maximum length of 256.

DescribeRecommendationFeedback API Version 2019-09-19 19

Amazon CodeGuru Reviewer API Reference

Request Body
The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"RecommendationFeedback": {
"CodeReviewArn": "string",
"CreatedTimeStamp": number,
"LastUpdatedTimeStamp": number,
"Reactions": [ "string" ],
"RecommendationId": "string",
"UserId": "string"
}
}

Response Elements
If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

RecommendationFeedback

The recommendation feedback given by the user.

Type: RecommendationFeedback object

Errors
For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

Request Body API Version 2019-09-19 20

Amazon CodeGuru Reviewer API Reference

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 21

Amazon CodeGuru Reviewer API Reference

DescribeRepositoryAssociation
Returns a RepositoryAssociation object that contains information about the requested repository
association.

Request Syntax

GET /associations/AssociationArn HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

AssociationArn

The Amazon Resource Name (ARN) of the RepositoryAssociation object. You can retrieve this
ARN by calling ListRepositoryAssociations.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:association:[a-
f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"RepositoryAssociation": {
"AssociationArn": "string",
"AssociationId": "string",

DescribeRepositoryAssociation API Version 2019-09-19 22

Amazon CodeGuru Reviewer API Reference

"ConnectionArn": "string",
"CreatedTimeStamp": number,
"KMSKeyDetails": {
"EncryptionOption": "string",
"KMSKeyId": "string"
},
"LastUpdatedTimeStamp": number,
"Name": "string",
"Owner": "string",
"ProviderType": "string",
"S3RepositoryDetails": {
"BucketName": "string",
"CodeArtifacts": {
"BuildArtifactsObjectKey": "string",
"SourceCodeArtifactsObjectKey": "string"
}
},
"State": "string",
"StateReason": "string"
},
"Tags": {
"string" : "string"
}
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

RepositoryAssociation

Information about the repository association.

Type: RepositoryAssociation object

Tags

An array of key-value pairs used to tag an associated repository. A tag is a custom attribute
label with two parts:
• A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case
sensitive.

Response Elements API Version 2019-09-19 23

Amazon CodeGuru Reviewer API Reference

• An optional field known as a tag value (for example, 111122223333, Production, or a team
name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values
are case sensitive.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Maximum length of 256.

Errors
For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

NotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

Errors API Version 2019-09-19 24

Amazon CodeGuru Reviewer API Reference

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 25

Amazon CodeGuru Reviewer API Reference

DisassociateRepository
Removes the association between Amazon CodeGuru Reviewer and a repository.

Request Syntax

DELETE /associations/AssociationArn HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

AssociationArn

The Amazon Resource Name (ARN) of the RepositoryAssociation object. You can retrieve this
ARN by calling ListRepositoryAssociations.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:association:[a-
f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Required: Yes

Request Body
The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"RepositoryAssociation": {
"AssociationArn": "string",
"AssociationId": "string",
"ConnectionArn": "string",
"CreatedTimeStamp": number,
"KMSKeyDetails": {
"EncryptionOption": "string",

DisassociateRepository API Version 2019-09-19 26

Amazon CodeGuru Reviewer API Reference

"KMSKeyId": "string"
},
"LastUpdatedTimeStamp": number,
"Name": "string",
"Owner": "string",
"ProviderType": "string",
"S3RepositoryDetails": {
"BucketName": "string",
"CodeArtifacts": {
"BuildArtifactsObjectKey": "string",
"SourceCodeArtifactsObjectKey": "string"
}
},
"State": "string",
"StateReason": "string"
},
"Tags": {
"string" : "string"
}
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

RepositoryAssociation

Information about the disassociated repository.

Type: RepositoryAssociation object

Tags

An array of key-value pairs used to tag an associated repository. A tag is a custom attribute
label with two parts:
• A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case
sensitive.
• An optional field known as a tag value (for example, 111122223333, Production, or a team
name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values
are case sensitive.

Response Elements API Version 2019-09-19 27

Amazon CodeGuru Reviewer API Reference

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Maximum length of 256.

Errors
For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

ConflictException

The requested operation would cause a conflict with the current state of a service resource
associated with the request. Resolve the conflict before retrying this request.

HTTP Status Code: 409

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

NotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

Errors API Version 2019-09-19 28

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 29

Amazon CodeGuru Reviewer API Reference

ListCodeReviews
Lists all the code reviews that the customer has created in the past 90 days.

Request Syntax

GET /codereviews?
MaxResults=MaxResults&NextToken=NextToken&ProviderTypes=ProviderTypes&RepositoryNames=Repositor
HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

MaxResults

The maximum number of results that are returned per call. The default is 100.

Valid Range: Minimum value of 1. Maximum value of 100.

NextToken

If nextToken is returned, there are more results available. The value of nextToken is a unique
pagination token for each page. Make the call again using the returned token to retrieve the
next page. Keep all other arguments unchanged.

Length Constraints: Minimum length of 1. Maximum length of 2048.

ProviderTypes

List of provider types for filtering that needs to be applied before displaying the result. For
example, providerTypes=[GitHub] lists code reviews from GitHub.

Array Members: Minimum number of 1 item. Maximum number of 3 items.

Valid Values: CodeCommit | GitHub | Bitbucket | GitHubEnterpriseServer |

S3Bucket
RepositoryNames

List of repository names for filtering that needs to be applied before displaying the result.

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Length Constraints: Minimum length of 1. Maximum length of 100.

ListCodeReviews API Version 2019-09-19 30

Amazon CodeGuru Reviewer API Reference

Pattern: ^\S[\w.-]*$
States

List of states for filtering that needs to be applied before displaying the result. For example,
states=[Pending] lists code reviews in the Pending state.

The valid code review states are:

• Completed: The code review is complete.
• Pending: The code review started and has not completed or failed.
• Failed: The code review failed.
• Deleting: The code review is being deleted.

Array Members: Minimum number of 1 item. Maximum number of 3 items.

Valid Values: Completed | Pending | Failed | Deleting

Type

The type of code reviews to list in the response.

Valid Values: PullRequest | RepositoryAnalysis

Required: Yes

Request Body
The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"CodeReviewSummaries": [
{
"CodeReviewArn": "string",
"CreatedTimeStamp": number,
"LastUpdatedTimeStamp": number,
"MetricsSummary": {
"FindingsCount": number,

Request Body API Version 2019-09-19 31

Amazon CodeGuru Reviewer API Reference

"MeteredLinesOfCodeCount": number,
"SuppressedLinesOfCodeCount": number
},
"Name": "string",
"Owner": "string",
"ProviderType": "string",
"PullRequestId": "string",
"RepositoryName": "string",
"SourceCodeType": {
"BranchDiff": {
"DestinationBranchName": "string",
"SourceBranchName": "string"
},
"CommitDiff": {
"DestinationCommit": "string",
"MergeBaseCommit": "string",
"SourceCommit": "string"
},
"RepositoryHead": {
"BranchName": "string"
},
"RequestMetadata": {
"EventInfo": {
"Name": "string",
"State": "string"
},
"Requester": "string",
"RequestId": "string",
"VendorName": "string"
},
"S3BucketRepository": {
"Details": {
"BucketName": "string",
"CodeArtifacts": {
"BuildArtifactsObjectKey": "string",
"SourceCodeArtifactsObjectKey": "string"
}
},
"Name": "string"
}
},
"State": "string",
"Type": "string"
}

Response Syntax API Version 2019-09-19 32

Amazon CodeGuru Reviewer API Reference

],
"NextToken": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

CodeReviewSummaries

A list of code reviews that meet the criteria of the request.

Type: Array of CodeReviewSummary objects

NextToken

Pagination token.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ThrottlingException

The request was denied due to request throttling.

Response Elements API Version 2019-09-19 33

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 34

Amazon CodeGuru Reviewer API Reference

ListRecommendationFeedback
Returns a list of RecommendationFeedbackSummary objects that contain customer
recommendation feedback for all CodeGuru Reviewer users.

Request Syntax

GET /feedback/CodeReviewArn/RecommendationFeedback?
MaxResults=MaxResults&NextToken=NextToken&RecommendationIds=RecommendationIds&UserIds=UserIds
HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

CodeReviewArn

The Amazon Resource Name (ARN) of the CodeReview object.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: Yes
MaxResults

The maximum number of results that are returned per call. The default is 100.

Valid Range: Minimum value of 1. Maximum value of 100.

NextToken

If nextToken is returned, there are more results available. The value of nextToken is a unique
pagination token for each page. Make the call again using the returned token to retrieve the
next page. Keep all other arguments unchanged.

Length Constraints: Minimum length of 1. Maximum length of 2048.

RecommendationIds

Used to query the recommendation feedback for a given recommendation.

ListRecommendationFeedback API Version 2019-09-19 35

Amazon CodeGuru Reviewer API Reference

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Length Constraints: Minimum length of 1. Maximum length of 64.

UserIds

An AWS user's account ID or Amazon Resource Name (ARN). Use this ID to query the
recommendation feedback for a code review from that user.

The UserId is an IAM principal that can be specified as an AWS account ID or an Amazon
Resource Name (ARN). For more information, see Specifying a Principal in the AWS Identity and
Access Management User Guide.

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Length Constraints: Minimum length of 1. Maximum length of 256.

Request Body
The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"NextToken": "string",
"RecommendationFeedbackSummaries": [
{
"Reactions": [ "string" ],
"RecommendationId": "string",
"UserId": "string"
}
]
}

Response Elements
If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

Request Body API Version 2019-09-19 36

Amazon CodeGuru Reviewer API Reference

NextToken

If nextToken is returned, there are more results available. The value of nextToken is a unique
pagination token for each page. Make the call again using the returned token to retrieve the
next page. Keep all other arguments unchanged.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

RecommendationFeedbackSummaries

Recommendation feedback summaries corresponding to the code review ARN.

Type: Array of RecommendationFeedbackSummary objects

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

Errors API Version 2019-09-19 37

Amazon CodeGuru Reviewer API Reference

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 38

Amazon CodeGuru Reviewer API Reference

ListRecommendations
Returns the list of all recommendations for a completed code review.

Request Syntax

GET /codereviews/CodeReviewArn/Recommendations?
MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

CodeReviewArn

The Amazon Resource Name (ARN) of the CodeReview object.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: Yes
MaxResults

The maximum number of results that are returned per call. The default is 100.

Valid Range: Minimum value of 1. Maximum value of 300.

NextToken

Pagination token.

Length Constraints: Minimum length of 1. Maximum length of 2048.

Request Body
The request does not have a request body.

Response Syntax

HTTP/1.1 200

ListRecommendations API Version 2019-09-19 39

Amazon CodeGuru Reviewer API Reference

Content-type: application/json

{
"NextToken": "string",
"RecommendationSummaries": [
{
"Description": "string",
"EndLine": number,
"FilePath": "string",
"RecommendationCategory": "string",
"RecommendationId": "string",
"RuleMetadata": {
"LongDescription": "string",
"RuleId": "string",
"RuleName": "string",
"RuleTags": [ "string" ],
"ShortDescription": "string"
},
"Severity": "string",
"StartLine": number
}
]
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

NextToken

Pagination token.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

RecommendationSummaries

List of recommendations for the requested code review.

Type: Array of RecommendationSummary objects

Response Elements API Version 2019-09-19 40

Amazon CodeGuru Reviewer API Reference

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go

Errors API Version 2019-09-19 41

Amazon CodeGuru Reviewer API Reference

• AWS SDK for Java V2

• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 42

Amazon CodeGuru Reviewer API Reference

ListRepositoryAssociations
Returns a list of RepositoryAssociationSummary objects that contain summary information about a
repository association. You can filter the returned list by ProviderType, Name, State, and Owner.

Request Syntax

GET /associations?
MaxResults=MaxResults&Name=Names&NextToken=NextToken&Owner=Owners&ProviderType=ProviderTypes&St
HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

MaxResults

The maximum number of repository association results returned by

ListRepositoryAssociations in paginated output. When this parameter is used,
ListRepositoryAssociations only returns maxResults results in a single page
with a nextToken response element. The remaining results of the initial request can be
seen by sending another ListRepositoryAssociations request with the returned
nextToken value. This value can be between 1 and 100. If this parameter is not used,
ListRepositoryAssociations returns up to 100 results and a nextToken value if
applicable.

Valid Range: Minimum value of 1. Maximum value of 100.

Names

List of repository names to use as a filter.

Array Members: Minimum number of 1 item. Maximum number of 3 items.

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

ListRepositoryAssociations API Version 2019-09-19 43

Amazon CodeGuru Reviewer API Reference

NextToken

The nextToken value returned from a previous paginated ListRepositoryAssociations

request where maxResults was used and the results exceeded the value of that parameter.
Pagination continues from the end of the previous results that returned the nextToken value.

Note
Treat this token as an opaque identifier that is only used to retrieve the next items in a
list and not for other programmatic purposes.

Length Constraints: Minimum length of 1. Maximum length of 2048.

Owners

List of owners to use as a filter. For AWS CodeCommit, it is the name of the CodeCommit
account that was used to associate the repository. For other repository source providers, such as
Bitbucket and GitHub Enterprise Server, this is name of the account that was used to associate
the repository.

Array Members: Minimum number of 1 item. Maximum number of 3 items.

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S(.*\S)?$
ProviderTypes

List of provider types to use as a filter.

Array Members: Minimum number of 1 item. Maximum number of 3 items.

Valid Values: CodeCommit | GitHub | Bitbucket | GitHubEnterpriseServer |

S3Bucket
States

List of repository association states to use as a filter.

The valid repository association states are:

• Associated: The repository association is complete.
• Associating: CodeGuru Reviewer is:

URI Request Parameters API Version 2019-09-19 44

Amazon CodeGuru Reviewer API Reference

• Setting up pull request notifications. This is required for pull requests to trigger a CodeGuru
Reviewer review.

Note
If your repository ProviderType is GitHub, GitHub Enterprise Server, or
Bitbucket, CodeGuru Reviewer creates webhooks in your repository to trigger
CodeGuru Reviewer reviews. If you delete these webhooks, reviews of code in your
repository cannot be triggered.

• Setting up source code access. This is required for CodeGuru Reviewer to securely clone
code in your repository.
• Failed: The repository failed to associate or disassociate.
• Disassociating: CodeGuru Reviewer is removing the repository's pull request notifications and
source code access.
• Disassociated: CodeGuru Reviewer successfully disassociated the repository. You can create
a new association with this repository if you want to review source code in it later. You can
control access to code reviews created in anassociated repository with tags after it has
been disassociated. For more information, see Using tags to control access to associated
repositories in the Amazon CodeGuru Reviewer User Guide.

Array Members: Minimum number of 1 item. Maximum number of 5 items.

Valid Values: Associated | Associating | Failed | Disassociating |

Disassociated

Request Body
The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"NextToken": "string",
"RepositoryAssociationSummaries": [

Request Body API Version 2019-09-19 45

Amazon CodeGuru Reviewer API Reference

{
"AssociationArn": "string",
"AssociationId": "string",
"ConnectionArn": "string",
"LastUpdatedTimeStamp": number,
"Name": "string",
"Owner": "string",
"ProviderType": "string",
"State": "string"
}
]
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

NextToken

The nextToken value to include in a future ListRecommendations request. When the results
of a ListRecommendations request exceed maxResults, this value can be used to retrieve
the next page of results. This value is null when there are no more results to return.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

RepositoryAssociationSummaries

A list of repository associations that meet the criteria of the request.

Type: Array of RepositoryAssociationSummary objects

Errors

For information about the errors that are common to all actions, see Common Errors.

InternalServerException

The server encountered an internal error and is unable to complete the request.

Response Elements API Version 2019-09-19 46

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 500

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 47

Amazon CodeGuru Reviewer API Reference

ListTagsForResource
Returns the list of tags associated with an associated repository resource.

Request Syntax

GET /tags/resourceArn HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

resourceArn

The Amazon Resource Name (ARN) of the RepositoryAssociation object. You can retrieve this
ARN by calling ListRepositoryAssociations.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:association:[a-
f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
"Tags": {
"string" : "string"
}
}

ListTagsForResource API Version 2019-09-19 48

Amazon CodeGuru Reviewer API Reference

Response Elements
If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

Tags

An array of key-value pairs used to tag an associated repository. A tag is a custom attribute
label with two parts:
• A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case
sensitive.
• An optional field known as a tag value (for example, 111122223333, Production, or a team
name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values
are case sensitive.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Maximum length of 256.

Errors
For information about the errors that are common to all actions, see Common Errors.

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ValidationException

The input fails to satisfy the specified constraints.

Response Elements API Version 2019-09-19 49

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 50

Amazon CodeGuru Reviewer API Reference

PutRecommendationFeedback
Stores customer feedback for a CodeGuru Reviewer recommendation. When this API is called again
with different reactions the previous feedback is overwritten.

Request Syntax

PUT /feedback HTTP/1.1

Content-type: application/json

{
"CodeReviewArn": "string",
"Reactions": [ "string" ],
"RecommendationId": "string"
}

URI Request Parameters

The request does not use any URI parameters.

Request Body
The request accepts the following data in JSON format.

CodeReviewArn

The Amazon Resource Name (ARN) of the CodeReview object.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: Yes
Reactions

List for storing reactions. Reactions are utf-8 text code for emojis. If you send an empty list it
clears all your feedback.

Type: Array of strings

PutRecommendationFeedback API Version 2019-09-19 51

Amazon CodeGuru Reviewer API Reference

Array Members: Minimum number of 0 items. Maximum number of 1 item.

Valid Values: ThumbsUp | ThumbsDown

Required: Yes
RecommendationId

The recommendation ID that can be used to track the provided recommendations and then to
collect the feedback.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: Yes

Response Syntax

HTTP/1.1 200

Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors
For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

Response Syntax API Version 2019-09-19 52

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 53

Amazon CodeGuru Reviewer API Reference

TagResource
Adds one or more tags to an associated repository.

Request Syntax

POST /tags/resourceArn HTTP/1.1

Content-type: application/json

{
"Tags": {
"string" : "string"
}
}

URI Request Parameters

The request uses the following URI parameters.

resourceArn

The Amazon Resource Name (ARN) of the RepositoryAssociation object. You can retrieve this
ARN by calling ListRepositoryAssociations.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:association:[a-
f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Required: Yes

Request Body

The request accepts the following data in JSON format.

Tags

An array of key-value pairs used to tag an associated repository. A tag is a custom attribute
label with two parts:

TagResource API Version 2019-09-19 54

Amazon CodeGuru Reviewer API Reference

• A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case
sensitive.
• An optional field known as a tag value (for example, 111122223333, Production, or a team
name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values
are case sensitive.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Maximum length of 256.

Required: Yes

Response Syntax

HTTP/1.1 200

Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors
For information about the errors that are common to all actions, see Common Errors.

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ValidationException

The input fails to satisfy the specified constraints.

Response Syntax API Version 2019-09-19 55

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 56

Amazon CodeGuru Reviewer API Reference

UntagResource
Removes a tag from an associated repository.

Request Syntax

DELETE /tags/resourceArn?tagKeys=TagKeys HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

resourceArn

The Amazon Resource Name (ARN) of the RepositoryAssociation object. You can retrieve this
ARN by calling ListRepositoryAssociations.

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:association:[a-
f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Required: Yes
TagKeys

A list of the keys for each tag you want to remove from an associated repository.

Array Members: Minimum number of 1 item. Maximum number of 50 items.

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: Yes

Request Body
The request does not have a request body.

Response Syntax

HTTP/1.1 200

UntagResource API Version 2019-09-19 57

Amazon CodeGuru Reviewer API Reference

Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors
For information about the errors that are common to all actions, see Common Errors.

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 500

ResourceNotFoundException

The resource specified in the request was not found.

HTTP Status Code: 404

ValidationException

The input fails to satisfy the specified constraints.

HTTP Status Code: 400

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS Command Line Interface

• AWS SDK for .NET
• AWS SDK for C++
• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for JavaScript V3
• AWS SDK for PHP V3
• AWS SDK for Python
• AWS SDK for Ruby V3

Response Elements API Version 2019-09-19 58

Amazon CodeGuru Reviewer API Reference

Data Types
The Amazon CodeGuru Reviewer API contains several data types that various actions use. This
section describes each data type in detail.

Note
The order of each element in a data type structure is not guaranteed. Applications should
not assume a particular order.

The following data types are supported:

• BranchDiffSourceCodeType
• CodeArtifacts
• CodeCommitRepository
• CodeReview
• CodeReviewSummary
• CodeReviewType
• CommitDiffSourceCodeType
• EventInfo
• KMSKeyDetails
• Metrics
• MetricsSummary
• RecommendationFeedback
• RecommendationFeedbackSummary
• RecommendationSummary
• Repository
• RepositoryAnalysis
• RepositoryAssociation
• RepositoryAssociationSummary
• RepositoryHeadSourceCodeType
• RequestMetadata

API Version 2019-09-19 59

Amazon CodeGuru Reviewer API Reference

• RuleMetadata
• S3BucketRepository
• S3Repository
• S3RepositoryDetails
• SourceCodeType
• ThirdPartySourceRepository

API Version 2019-09-19 60

Amazon CodeGuru Reviewer API Reference

BranchDiffSourceCodeType
A type of SourceCodeType that specifies a code diff between a source and destination branch in an
associated repository.

Contents
DestinationBranchName

The destination branch for a diff in an associated repository.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Required: Yes
SourceBranchName

The source branch for a diff in an associated repository.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Required: Yes

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

BranchDiffSourceCodeType API Version 2019-09-19 61

Amazon CodeGuru Reviewer API Reference

CodeArtifacts
Code artifacts are source code artifacts and build artifacts used in a repository analysis or a pull
request review.

• Source code artifacts are source code files in a Git repository that are compressed into a .zip file.
• Build artifacts are .jar or .class files that are compressed in a .zip file.

Contents
SourceCodeArtifactsObjectKey

The S3 object key for a source code .zip file. This is required for all code reviews.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: ^\S(.*\S)?$

Required: Yes
BuildArtifactsObjectKey

The S3 object key for a build artifacts .zip file that contains .jar or .class files. This is required for
a code review with security analysis. For more information, see Create code reviews with GitHub
Actions in the Amazon CodeGuru Reviewer User Guide.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: ^\S(.*\S)?$

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the
following:

CodeArtifacts API Version 2019-09-19 62

Amazon CodeGuru Reviewer API Reference

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 63

Amazon CodeGuru Reviewer API Reference

CodeCommitRepository
Information about an AWS CodeCommit repository. The CodeCommit repository must be in the
same AWS Region and AWS account where its CodeGuru Reviewer code reviews are configured.

Contents
Name

The name of the AWS CodeCommit repository. For more information, see repositoryName in
the AWS CodeCommit API Reference.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Required: Yes

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

CodeCommitRepository API Version 2019-09-19 64

Amazon CodeGuru Reviewer API Reference

CodeReview
Information about a code review. A code review belongs to the associated repository that contains
the reviewed code.

Contents
AnalysisTypes

The types of analysis performed during a repository analysis or a pull request review. You can
specify either Security, CodeQuality, or both.

Type: Array of strings

Valid Values: Security | CodeQuality

Required: No
AssociationArn

The Amazon Resource Name (ARN) of the RepositoryAssociation that contains the reviewed
source code. You can retrieve associated repository ARNs by calling ListRepositoryAssociations.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:association:[a-
f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Required: No
CodeReviewArn

The Amazon Resource Name (ARN) of the CodeReview object.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: No

CodeReview API Version 2019-09-19 65

Amazon CodeGuru Reviewer API Reference

ConfigFileState

The state of the aws-codeguru-reviewer.yml configuration file that allows the

configuration of the CodeGuru Reviewer analysis. The file either exists, doesn't exist, or exists
with errors at the root directory of your repository.

Type: String

Valid Values: Present | Absent | PresentWithErrors

Required: No
CreatedTimeStamp

The time, in milliseconds since the epoch, when the code review was created.

Type: Timestamp

Required: No
LastUpdatedTimeStamp

The time, in milliseconds since the epoch, when the code review was last updated.

Type: Timestamp

Required: No
Metrics

The statistics from the code review.

Type: Metrics object

Required: No
Name

The name of the code review.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Contents API Version 2019-09-19 66

Amazon CodeGuru Reviewer API Reference

Required: No
Owner

The owner of the repository. For an AWS CodeCommit repository, this is the AWS account ID
of the account that owns the repository. For a GitHub, GitHub Enterprise Server, or Bitbucket
repository, this is the username for the account that owns the repository. For an S3 repository, it
can be the username or AWS account ID.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S(.*\S)?$

Required: No
ProviderType

The type of repository that contains the reviewed code (for example, GitHub or Bitbucket).

Type: String

Valid Values: CodeCommit | GitHub | Bitbucket | GitHubEnterpriseServer |

S3Bucket

Required: No
PullRequestId

The pull request ID for the code review.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No
RepositoryName

The name of the repository.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Contents API Version 2019-09-19 67

Amazon CodeGuru Reviewer API Reference

Pattern: ^\S[\w.-]*$

Required: No
SourceCodeType

The type of the source code for the code review.

Type: SourceCodeType object

Required: No
State

The valid code review states are:

• Completed: The code review is complete.
• Pending: The code review started and has not completed or failed.
• Failed: The code review failed.
• Deleting: The code review is being deleted.

Type: String

Valid Values: Completed | Pending | Failed | Deleting

Required: No
StateReason

The reason for the state of the code review.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: No
Type

The type of code review.

Type: String

Valid Values: PullRequest | RepositoryAnalysis

Required: No

Contents API Version 2019-09-19 68

Amazon CodeGuru Reviewer API Reference

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 69

Amazon CodeGuru Reviewer API Reference

CodeReviewSummary
Information about the summary of the code review.

Contents
CodeReviewArn

The Amazon Resource Name (ARN) of the CodeReview object.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: No
CreatedTimeStamp

The time, in milliseconds since the epoch, when the code review was created.

Type: Timestamp

Required: No
LastUpdatedTimeStamp

The time, in milliseconds since the epoch, when the code review was last updated.

Type: Timestamp

Required: No
MetricsSummary

The statistics from the code review.

Type: MetricsSummary object

Required: No
Name

The name of the code review.

CodeReviewSummary API Version 2019-09-19 70

Amazon CodeGuru Reviewer API Reference

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Required: No
Owner

The owner of the repository. For an AWS CodeCommit repository, this is the AWS account ID
of the account that owns the repository. For a GitHub, GitHub Enterprise Server, or Bitbucket
repository, this is the username for the account that owns the repository. For an S3 repository, it
can be the username or AWS account ID.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S(.*\S)?$

Required: No
ProviderType

The provider type of the repository association.

Type: String

Valid Values: CodeCommit | GitHub | Bitbucket | GitHubEnterpriseServer |

S3Bucket

Required: No
PullRequestId

The pull request ID for the code review.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No

Contents API Version 2019-09-19 71

Amazon CodeGuru Reviewer API Reference

RepositoryName

The name of the repository.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Required: No
SourceCodeType

Specifies the source code that is analyzed in a code review.

Type: SourceCodeType object

Required: No
State

The state of the code review.

The valid code review states are:

• Completed: The code review is complete.
• Pending: The code review started and has not completed or failed.
• Failed: The code review failed.
• Deleting: The code review is being deleted.

Type: String

Valid Values: Completed | Pending | Failed | Deleting

Required: No
Type

The type of the code review.

Type: String

Valid Values: PullRequest | RepositoryAnalysis

Contents API Version 2019-09-19 72

Amazon CodeGuru Reviewer API Reference

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 73

Amazon CodeGuru Reviewer API Reference

CodeReviewType
The type of a code review. There are two code review types:

• PullRequest - A code review that is automatically triggered by a pull request on an associated

repository.
• RepositoryAnalysis - A code review that analyzes all code under a specified branch in an
associated repository. The associated repository is specified using its ARN in CreateCodeReview.

Contents
RepositoryAnalysis

A code review that analyzes all code under a specified branch in an associated repository. The
associated repository is specified using its ARN in CreateCodeReview.

Type: RepositoryAnalysis object

Required: Yes
AnalysisTypes

They types of analysis performed during a repository analysis or a pull request review. You can
specify either Security, CodeQuality, or both.

Type: Array of strings

Valid Values: Security | CodeQuality

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2

CodeReviewType API Version 2019-09-19 74

Amazon CodeGuru Reviewer API Reference

• AWS SDK for Ruby V3

See Also API Version 2019-09-19 75

Amazon CodeGuru Reviewer API Reference

CommitDiffSourceCodeType
A type of SourceCodeType that specifies the commit diff for a pull request on an associated
repository. The SourceCommit and DestinationCommit fields are required to do a pull request
code review.

Contents
DestinationCommit

The SHA of the destination commit used to generate a commit diff. This field is required for a
pull request code review.

Type: String

Length Constraints: Minimum length of 6. Maximum length of 64.

Required: No
MergeBaseCommit

The SHA of the merge base of a commit.

Type: String

Length Constraints: Minimum length of 6. Maximum length of 64.

Required: No
SourceCommit

The SHA of the source commit used to generate a commit diff. This field is required for a pull
request code review.

Type: String

Length Constraints: Minimum length of 6. Maximum length of 64.

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

CommitDiffSourceCodeType API Version 2019-09-19 76

Amazon CodeGuru Reviewer API Reference

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 77

Amazon CodeGuru Reviewer API Reference

EventInfo
Information about an event. The event might be a push, pull request, scheduled request, or
another type of event.

Contents
Name

The name of the event. The possible names are pull_request, workflow_dispatch,
schedule, and push

Type: String

Length Constraints: Minimum length of 1. Maximum length of 32.

Pattern: ^[ \-A-Z_a-z]+$

Required: No
State

The state of an event. The state might be open, closed, or another state.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 32.

Pattern: ^[ \-A-Z_a-z]+$

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

EventInfo API Version 2019-09-19 78

Amazon CodeGuru Reviewer API Reference

See Also API Version 2019-09-19 79

Amazon CodeGuru Reviewer API Reference

KMSKeyDetails
An object that contains:

• The encryption option for a repository association. It is either owned by AWS Key Management
Service (KMS) (AWS_OWNED_CMK) or customer managed (CUSTOMER_MANAGED_CMK).
• The ID of the AWS KMS key that is associated with a repository association.

Contents
EncryptionOption

The encryption option for a repository association. It is either owned by AWS Key Management
Service (KMS) (AWS_OWNED_CMK) or customer managed (CUSTOMER_MANAGED_CMK).

Type: String

Valid Values: AWS_OWNED_CMK | CUSTOMER_MANAGED_CMK

Required: No
KMSKeyId

The ID of the AWS KMS key that is associated with a repository association.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: [a-zA-Z0-9-]+

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go

KMSKeyDetails API Version 2019-09-19 80

Amazon CodeGuru Reviewer API Reference

• AWS SDK for Java V2

• AWS SDK for Ruby V3

See Also API Version 2019-09-19 81

Amazon CodeGuru Reviewer API Reference

Metrics
Information about the statistics from the code review.

Contents
FindingsCount

Total number of recommendations found in the code review.

Type: Long

Required: No
MeteredLinesOfCodeCount

MeteredLinesOfCodeCount is the number of lines of code in the repository where the code
review happened. This does not include non-code lines such as comments and blank lines.

Type: Long

Required: No
SuppressedLinesOfCodeCount

SuppressedLinesOfCodeCount is the number of lines of code in the repository where the

code review happened that CodeGuru Reviewer did not analyze. The lines suppressed in the
analysis is based on the excludeFiles variable in the aws-codeguru-reviewer.yml file.
This number does not include non-code lines such as comments and blank lines.

Type: Long

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go

Metrics API Version 2019-09-19 82

Amazon CodeGuru Reviewer API Reference

• AWS SDK for Java V2

• AWS SDK for Ruby V3

See Also API Version 2019-09-19 83

Amazon CodeGuru Reviewer API Reference

MetricsSummary
Information about metrics summaries.

Contents
FindingsCount

Total number of recommendations found in the code review.

Type: Long

Required: No
MeteredLinesOfCodeCount

Lines of code metered in the code review. For the initial code review pull request and all
subsequent revisions, this includes all lines of code in the files added to the pull request. In
subsequent revisions, for files that already existed in the pull request, this includes only the
changed lines of code. In both cases, this does not include non-code lines such as comments
and import statements. For example, if you submit a pull request containing 5 files, each with
500 lines of code, and in a subsequent revision you added a new file with 200 lines of code, and
also modified a total of 25 lines across the initial 5 files, MeteredLinesOfCodeCount includes
the first 5 files (5 * 500 = 2,500 lines), the new file (200 lines) and the 25 changed lines of code
for a total of 2,725 lines of code.

Type: Long

Required: No
SuppressedLinesOfCodeCount

Lines of code suppressed in the code review based on the excludeFiles element in the aws-
codeguru-reviewer.yml file. For full repository analyses, this number includes all lines of
code in the files that are suppressed. For pull requests, this number only includes the changed
lines of code that are suppressed. In both cases, this number does not include non-code lines
such as comments and import statements. For example, if you initiate a full repository analysis
on a repository containing 5 files, each file with 100 lines of code, and 2 files are listed as
excluded in the aws-codeguru-reviewer.yml file, then SuppressedLinesOfCodeCount
returns 200 (2 * 100) as the total number of lines of code suppressed. However, if you submit
a pull request for the same repository, then SuppressedLinesOfCodeCount only includes

MetricsSummary API Version 2019-09-19 84

Amazon CodeGuru Reviewer API Reference

the lines in the 2 files that changed. If only 1 of the 2 files changed in the pull request, then
SuppressedLinesOfCodeCount returns 100 (1 * 100) as the total number of lines of code
suppressed.

Type: Long

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 85

Amazon CodeGuru Reviewer API Reference

RecommendationFeedback
Information about the recommendation feedback.

Contents
CodeReviewArn

The Amazon Resource Name (ARN) of the CodeReview object.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: No
CreatedTimeStamp

The time at which the feedback was created.

Type: Timestamp

Required: No
LastUpdatedTimeStamp

The time at which the feedback was last updated.

Type: Timestamp

Required: No
Reactions

List for storing reactions. Reactions are utf-8 text code for emojis. You can send an empty list to
clear off all your feedback.

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 1 item.

Valid Values: ThumbsUp | ThumbsDown

RecommendationFeedback API Version 2019-09-19 86

Amazon CodeGuru Reviewer API Reference

Required: No
RecommendationId

The recommendation ID that can be used to track the provided recommendations. Later on it
can be used to collect the feedback.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No
UserId

The ID of the user that made the API call.

The UserId is an IAM principal that can be specified as an AWS account ID or an Amazon
Resource Name (ARN). For more information, see Specifying a Principal in the AWS Identity and
Access Management User Guide.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 87

Amazon CodeGuru Reviewer API Reference

RecommendationFeedbackSummary
Information about recommendation feedback summaries.

Contents
Reactions

List for storing reactions. Reactions are utf-8 text code for emojis.

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 1 item.

Valid Values: ThumbsUp | ThumbsDown

Required: No
RecommendationId

The recommendation ID that can be used to track the provided recommendations. Later on it
can be used to collect the feedback.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No
UserId

The ID of the user that gave the feedback.

The UserId is an IAM principal that can be specified as an AWS account ID or an Amazon
Resource Name (ARN). For more information, see Specifying a Principal in the AWS Identity and
Access Management User Guide.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Required: No

RecommendationFeedbackSummary API Version 2019-09-19 88

Amazon CodeGuru Reviewer API Reference

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 89

Amazon CodeGuru Reviewer API Reference

RecommendationSummary
Information about recommendations.

Contents
Description

A description of the recommendation generated by CodeGuru Reviewer for the lines of code
between the start line and the end line.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 5000.

Required: No
EndLine

Last line where the recommendation is applicable in the source commit or source branch. For a
single line comment the start line and end line values are the same.

Type: Integer

Required: No
FilePath

Name of the file on which a recommendation is provided.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No
RecommendationCategory

The type of a recommendation.

Type: String

Valid Values: AWSBestPractices | AWSCloudFormationIssues | DuplicateCode

| CodeMaintenanceIssues | ConcurrencyIssues | InputValidations |

RecommendationSummary API Version 2019-09-19 90

Amazon CodeGuru Reviewer API Reference

PythonBestPractices | JavaBestPractices | ResourceLeaks | SecurityIssues

| CodeInconsistencies

Required: No
RecommendationId

The recommendation ID that can be used to track the provided recommendations. Later on it
can be used to collect the feedback.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No
RuleMetadata

Metadata about a rule. Rule metadata includes an ID, a name, a list of tags, and a short and
long description. CodeGuru Reviewer uses rules to analyze code. A rule's recommendation is
included in analysis results if code is detected that violates the rule.

Type: RuleMetadata object

Required: No
Severity

The severity of the issue in the code that generated this recommendation.

Type: String

Valid Values: Info | Low | Medium | High | Critical

Required: No
StartLine

Start line from where the recommendation is applicable in the source commit or source branch.

Type: Integer

Required: No

Contents API Version 2019-09-19 91

Amazon CodeGuru Reviewer API Reference

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 92

Amazon CodeGuru Reviewer API Reference

Repository
Information about an associated AWS CodeCommit repository or an associated repository that is
managed by AWS CodeStar Connections (for example, Bitbucket). This Repository object is not
used if your source code is in an associated GitHub repository.

Contents
Bitbucket

Information about a Bitbucket repository.

Type: ThirdPartySourceRepository object

Required: No
CodeCommit

Information about an AWS CodeCommit repository.

Type: CodeCommitRepository object

Required: No
GitHubEnterpriseServer

Information about a GitHub Enterprise Server repository.

Type: ThirdPartySourceRepository object

Required: No
S3Bucket

Information about a repository in an S3 bucket.

Type: S3Repository object

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

Repository API Version 2019-09-19 93

Amazon CodeGuru Reviewer API Reference

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 94

Amazon CodeGuru Reviewer API Reference

RepositoryAnalysis
A code review type that analyzes all code under a specified branch in an associated repository. The
associated repository is specified using its ARN when you call CreateCodeReview.

Contents
RepositoryHead

A SourceCodeType that specifies the tip of a branch in an associated repository.

Type: RepositoryHeadSourceCodeType object

Required: No
SourceCodeType

Specifies the source code that is analyzed in a code review.

Type: SourceCodeType object

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

RepositoryAnalysis API Version 2019-09-19 95

Amazon CodeGuru Reviewer API Reference

RepositoryAssociation
Information about a repository association. The DescribeRepositoryAssociation operation returns a
RepositoryAssociation object.

Contents
AssociationArn

The Amazon Resource Name (ARN) identifying the repository association.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: No
AssociationId

The ID of the repository association.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No
ConnectionArn

The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. Its format
is arn:aws:codestar-connections:region-id:aws-account_id:connection/
connection-id. For more information, see Connection in the AWS CodeStar Connections API
Reference.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Pattern: arn:aws(-[\w]+)*:.+:.+:[0-9]{12}:.+

Required: No

RepositoryAssociation API Version 2019-09-19 96

Amazon CodeGuru Reviewer API Reference

CreatedTimeStamp

The time, in milliseconds since the epoch, when the repository association was created.

Type: Timestamp

Required: No
KMSKeyDetails

A KMSKeyDetails object that contains:

• The encryption option for this repository association. It is either owned by
AWS Key Management Service (KMS) (AWS_OWNED_CMK) or customer managed
(CUSTOMER_MANAGED_CMK).
• The ID of the AWS KMS key that is associated with this repository association.

Type: KMSKeyDetails object

Required: No
LastUpdatedTimeStamp

The time, in milliseconds since the epoch, when the repository association was last updated.

Type: Timestamp

Required: No
Name

The name of the repository.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Required: No
Owner

The owner of the repository. For an AWS CodeCommit repository, this is the AWS account ID
of the account that owns the repository. For a GitHub, GitHub Enterprise Server, or Bitbucket
repository, this is the username for the account that owns the repository. For an S3 repository, it
can be the username or AWS account ID.

Contents API Version 2019-09-19 97

Amazon CodeGuru Reviewer API Reference

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S(.*\S)?$

Required: No
ProviderType

The provider type of the repository association.

Type: String

Valid Values: CodeCommit | GitHub | Bitbucket | GitHubEnterpriseServer |

S3Bucket

Required: No
S3RepositoryDetails

Specifies the name of an S3 bucket and a CodeArtifacts object that contains the S3 object
keys for a source code .zip file and for a build artifacts .zip file that contains .jar or .class files.

Type: S3RepositoryDetails object

Required: No
State

The state of the repository association.

The valid repository association states are:

• Associated: The repository association is complete.
• Associating: CodeGuru Reviewer is:
• Setting up pull request notifications. This is required for pull requests to trigger a CodeGuru
Reviewer review.

Note
If your repository ProviderType is GitHub, GitHub Enterprise Server, or
Bitbucket, CodeGuru Reviewer creates webhooks in your repository to trigger

Contents API Version 2019-09-19 98

Amazon CodeGuru Reviewer API Reference

CodeGuru Reviewer reviews. If you delete these webhooks, reviews of code in your
repository cannot be triggered.

• Setting up source code access. This is required for CodeGuru Reviewer to securely clone
code in your repository.
• Failed: The repository failed to associate or disassociate.
• Disassociating: CodeGuru Reviewer is removing the repository's pull request notifications and
source code access.
• Disassociated: CodeGuru Reviewer successfully disassociated the repository. You can create
a new association with this repository if you want to review source code in it later. You can
control access to code reviews created in anassociated repository with tags after it has
been disassociated. For more information, see Using tags to control access to associated
repositories in the Amazon CodeGuru Reviewer User Guide.

Type: String

Valid Values: Associated | Associating | Failed | Disassociating |

Disassociated

Required: No
StateReason

A description of why the repository association is in the current state.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2

See Also API Version 2019-09-19 99

Amazon CodeGuru Reviewer API Reference

• AWS SDK for Ruby V3

See Also API Version 2019-09-19 100

Amazon CodeGuru Reviewer API Reference

RepositoryAssociationSummary
Summary information about a repository association. The ListRepositoryAssociations operation
returns a list of RepositoryAssociationSummary objects.

Contents
AssociationArn

The Amazon Resource Name (ARN) of the RepositoryAssociation object. You can retrieve this
ARN by calling ListRepositoryAssociations.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: ^arn:aws[^:\s]*:codeguru-reviewer:[^:\s]+:[\d]{12}:[a-z-]+:[\w-]+$

Required: No
AssociationId

The repository association ID.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No
ConnectionArn

The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. Its format
is arn:aws:codestar-connections:region-id:aws-account_id:connection/
connection-id. For more information, see Connection in the AWS CodeStar Connections API
Reference.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Pattern: arn:aws(-[\w]+)*:.+:.+:[0-9]{12}:.+

RepositoryAssociationSummary API Version 2019-09-19 101

Amazon CodeGuru Reviewer API Reference

Required: No
LastUpdatedTimeStamp

The time, in milliseconds since the epoch, since the repository association was last updated.

Type: Timestamp

Required: No
Name

The name of the repository association.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Required: No
Owner

The owner of the repository. For an AWS CodeCommit repository, this is the AWS account ID
of the account that owns the repository. For a GitHub, GitHub Enterprise Server, or Bitbucket
repository, this is the username for the account that owns the repository. For an S3 repository, it
can be the username or AWS account ID.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S(.*\S)?$

Required: No
ProviderType

The provider type of the repository association.

Type: String

Valid Values: CodeCommit | GitHub | Bitbucket | GitHubEnterpriseServer |

S3Bucket

Contents API Version 2019-09-19 102

Amazon CodeGuru Reviewer API Reference

Required: No
State

The state of the repository association.

The valid repository association states are:

• Associated: The repository association is complete.

• Associating: CodeGuru Reviewer is:

• Setting up pull request notifications. This is required for pull requests to trigger a CodeGuru
Reviewer review.

Note
If your repository ProviderType is GitHub, GitHub Enterprise Server, or
Bitbucket, CodeGuru Reviewer creates webhooks in your repository to trigger
CodeGuru Reviewer reviews. If you delete these webhooks, reviews of code in your
repository cannot be triggered.

• Setting up source code access. This is required for CodeGuru Reviewer to securely clone
code in your repository.

• Failed: The repository failed to associate or disassociate.

• Disassociating: CodeGuru Reviewer is removing the repository's pull request notifications and
source code access.

• Disassociated: CodeGuru Reviewer successfully disassociated the repository. You can create
a new association with this repository if you want to review source code in it later. You can
control access to code reviews created in anassociated repository with tags after it has
been disassociated. For more information, see Using tags to control access to associated
repositories in the Amazon CodeGuru Reviewer User Guide.

Type: String

Valid Values: Associated | Associating | Failed | Disassociating |

Disassociated

Required: No

Contents API Version 2019-09-19 103

Amazon CodeGuru Reviewer API Reference

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 104

Amazon CodeGuru Reviewer API Reference

RepositoryHeadSourceCodeType
A SourceCodeType that specifies the tip of a branch in an associated repository.

Contents
BranchName

The name of the branch in an associated repository. The RepositoryHeadSourceCodeType

specifies the tip of this branch.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Required: Yes

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

RepositoryHeadSourceCodeType API Version 2019-09-19 105

Amazon CodeGuru Reviewer API Reference

RequestMetadata
Metadata that is associated with a code review. This applies to both pull request and repository
analysis code reviews.

Contents
EventInfo

Information about the event associated with a code review.

Type: EventInfo object

Required: No
Requester

An identifier, such as a name or account ID, that is associated with the requester. The
Requester is used to capture the author/actor name of the event request.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S(.*\S)?$

Required: No
RequestId

The ID of the request. This is required for a pull request code review.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No
VendorName

The name of the repository vendor used to upload code to an S3 bucket for a CI/CD code
review. For example, if code and artifacts are uploaded to an S3 bucket for a CI/CD code review
by GitHub scripts from a GitHub repository, then the repository association's ProviderType

RequestMetadata API Version 2019-09-19 106

Amazon CodeGuru Reviewer API Reference

is S3Bucket and the CI/CD repository vendor name is GitHub. For more information, see the
definition for ProviderType in RepositoryAssociation.

Type: String

Valid Values: GitHub | GitLab | NativeS3

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 107

Amazon CodeGuru Reviewer API Reference

RuleMetadata
Metadata about a rule. Rule metadata includes an ID, a name, a list of tags, and a short and long
description. CodeGuru Reviewer uses rules to analyze code. A rule's recommendation is included in
analysis results if code is detected that violates the rule.

Contents
LongDescription

A long description of the rule.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1000.

Pattern: ^\S(.*\S)?$

Required: No
RuleId

The ID of the rule.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^\S+\/[a-zA-Z0-9-]+@v\d+\.\d+$

Required: No
RuleName

The name of the rule.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S(.*\S)?$

Required: No

RuleMetadata API Version 2019-09-19 108

Amazon CodeGuru Reviewer API Reference

RuleTags

Tags that are associated with the rule.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Length Constraints: Minimum length of 1. Maximum length of 50.

Pattern: ^\S(.*\S)?$

Required: No
ShortDescription

A short description of the rule.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 200.

Pattern: ^\S(.*\S)?$

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 109

Amazon CodeGuru Reviewer API Reference

S3BucketRepository
Information about an associated repository in an S3 bucket. The associated repository contains a
source code .zip file and a build artifacts .zip file that contains .jar or .class files.

Contents
Name

The name of the repository when the ProviderType is S3Bucket.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Required: Yes
Details

An S3RepositoryDetails object that specifies the name of an S3 bucket and a

CodeArtifacts object. The CodeArtifacts object includes the S3 object keys for a source
code .zip file and for a build artifacts .zip file.

Type: S3RepositoryDetails object

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

S3BucketRepository API Version 2019-09-19 110

Amazon CodeGuru Reviewer API Reference

S3Repository
Information about a repository in an S3 bucket.

Contents
BucketName

The name of the S3 bucket used for associating a new S3 repository. It must begin with
codeguru-reviewer-.

Type: String

Length Constraints: Minimum length of 3. Maximum length of 63.

Pattern: ^\S(.*\S)?$

Required: Yes
Name

The name of the repository in the S3 bucket.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Required: Yes

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

S3Repository API Version 2019-09-19 111

Amazon CodeGuru Reviewer API Reference

See Also API Version 2019-09-19 112

Amazon CodeGuru Reviewer API Reference

S3RepositoryDetails
Specifies the name of an S3 bucket and a CodeArtifacts object that contains the S3 object keys
for a source code .zip file and for a build artifacts .zip file that contains .jar or .class files.

Contents
BucketName

The name of the S3 bucket used for associating a new S3 repository. It must begin with
codeguru-reviewer-.

Type: String

Length Constraints: Minimum length of 3. Maximum length of 63.

Pattern: ^\S(.*\S)?$

Required: No
CodeArtifacts

A CodeArtifacts object. The CodeArtifacts object includes the S3 object key for a source
code .zip file and for a build artifacts .zip file that contains .jar or .class files.

Type: CodeArtifacts object

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

S3RepositoryDetails API Version 2019-09-19 113

Amazon CodeGuru Reviewer API Reference

SourceCodeType
Specifies the source code that is analyzed in a code review.

Contents
BranchDiff

A type of SourceCodeType that specifies a source branch name and a destination branch name
in an associated repository.

Type: BranchDiffSourceCodeType object

Required: No
CommitDiff

A SourceCodeType that specifies a commit diff created by a pull request on an associated

repository.

Type: CommitDiffSourceCodeType object

Required: No
RepositoryHead

A SourceCodeType that specifies the tip of a branch in an associated repository.

Type: RepositoryHeadSourceCodeType object

Required: No
RequestMetadata

Metadata that is associated with a code review. This applies to any type of code review
supported by CodeGuru Reviewer. The RequestMetadaa field captures any event metadata.
For example, it might capture metadata associated with an event trigger, such as a push or a
pull request.

Type: RequestMetadata object

Required: No

SourceCodeType API Version 2019-09-19 114

Amazon CodeGuru Reviewer API Reference

S3BucketRepository

Information about an associated repository in an S3 bucket that includes its name and an
S3RepositoryDetails object. The S3RepositoryDetails object includes the name of
an S3 bucket, an S3 key for a source code .zip file, and an S3 key for a build artifacts .zip file.
S3BucketRepository is required in SourceCodeType for S3BucketRepository based code
reviews.

Type: S3BucketRepository object

Required: No

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 115

Amazon CodeGuru Reviewer API Reference

ThirdPartySourceRepository
Information about a third-party source repository connected to CodeGuru Reviewer.

Contents
ConnectionArn

The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. Its format
is arn:aws:codestar-connections:region-id:aws-account_id:connection/
connection-id. For more information, see Connection in the AWS CodeStar Connections API
Reference.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Pattern: arn:aws(-[\w]+)*:.+:.+:[0-9]{12}:.+

Required: Yes
Name

The name of the third party source repository.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S[\w.-]*$

Required: Yes
Owner

The owner of the repository. For a GitHub, GitHub Enterprise, or Bitbucket repository, this is
the username for the account that owns the repository. For an S3 repository, this can be the
username or AWS account ID

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^\S(.*\S)?$

ThirdPartySourceRepository API Version 2019-09-19 116

Amazon CodeGuru Reviewer API Reference

Required: Yes

See Also
For more information about using this API in one of the language-specific AWS SDKs, see the
following:

• AWS SDK for C++

• AWS SDK for Go
• AWS SDK for Java V2
• AWS SDK for Ruby V3

See Also API Version 2019-09-19 117

Amazon CodeGuru Reviewer API Reference

Common Parameters
The following list contains the parameters that all actions use for signing Signature Version 4
requests with a query string. Any action-specific parameters are listed in the topic for that action.
For more information about Signature Version 4, see Signing AWS API requests in the IAM User
Guide.

Action

The action to be performed.

Type: string

Required: Yes
Version

The API version that the request is written for, expressed in the format YYYY-MM-DD.

Type: string

Required: Yes
X-Amz-Algorithm

The hash algorithm that you used to create the request signature.

Condition: Specify this parameter when you include authentication information in a query
string instead of in the HTTP authorization header.

Type: string

Valid Values: AWS4-HMAC-SHA256

Required: Conditional
X-Amz-Credential

The credential scope value, which is a string that includes your access key, the date, the region
you are targeting, the service you are requesting, and a termination string ("aws4_request").
The value is expressed in the following format: access_key/YYYYMMDD/region/service/
aws4_request.

API Version 2019-09-19 118

Amazon CodeGuru Reviewer API Reference

For more information, see Create a signed AWS API request in the IAM User Guide.

Condition: Specify this parameter when you include authentication information in a query
string instead of in the HTTP authorization header.

Type: string

Required: Conditional
X-Amz-Date

The date that is used to create the signature. The format must be ISO 8601 basic format
(YYYYMMDD'T'HHMMSS'Z'). For example, the following date time is a valid X-Amz-Date value:
20120325T120000Z.

Condition: X-Amz-Date is optional for all requests; it can be used to override the date used for
signing requests. If the Date header is specified in the ISO 8601 basic format, X-Amz-Date is not
required. When X-Amz-Date is used, it always overrides the value of the Date header. For more
information, see Elements of an AWS API request signature in the IAM User Guide.

Type: string

Required: Conditional
X-Amz-Security-Token

The temporary security token that was obtained through a call to AWS Security Token Service
(AWS STS). For a list of services that support temporary security credentials from AWS STS, see
AWS services that work with IAM in the IAM User Guide.

Condition: If you're using temporary security credentials from AWS STS, you must include the
security token.

Type: string

Required: Conditional
X-Amz-Signature

Specifies the hex-encoded signature that was calculated from the string to sign and the derived
signing key.

Condition: Specify this parameter when you include authentication information in a query
string instead of in the HTTP authorization header.

API Version 2019-09-19 119

Amazon CodeGuru Reviewer API Reference

Type: string

Required: Conditional
X-Amz-SignedHeaders

Specifies all the HTTP headers that were included as part of the canonical request. For more
information about specifying signed headers, see Create a signed AWS API request in the IAM
User Guide.

Condition: Specify this parameter when you include authentication information in a query
string instead of in the HTTP authorization header.

Type: string

Required: Conditional

API Version 2019-09-19 120

Amazon CodeGuru Reviewer API Reference

Common Errors
This section lists the errors common to the API actions of all AWS services. For errors specific to an
API action for this service, see the topic for that API action.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

ExpiredTokenException

The security token included in the request is expired

HTTP Status Code: 403

IncompleteSignature

The request signature does not conform to AWS standards.

HTTP Status Code: 403

InternalFailure

The request processing has failed because of an unknown error, exception or failure.

HTTP Status Code: 500

MalformedHttpRequestException

Problems with the request at the HTTP level, e.g. we can't decompress the body according to
the decompression algorithm specified by the content-encoding.

HTTP Status Code: 400

NotAuthorized

You do not have permission to perform this action.

HTTP Status Code: 401

OptInRequired

The AWS access key ID needs a subscription for the service.

API Version 2019-09-19 121

Amazon CodeGuru Reviewer API Reference

HTTP Status Code: 403

RequestAbortedException

Convenient exception that can be used when a request is aborted before a reply is sent back
(e.g. client closed connection).

HTTP Status Code: 400

RequestEntityTooLargeException

Problems with the request at the HTTP level. The request entity is too large.

HTTP Status Code: 413

RequestExpired

The request reached the service more than 15 minutes after the date stamp on the request or
more than 15 minutes after the request expiration date (such as for pre-signed URLs), or the
date stamp on the request is more than 15 minutes in the future.

HTTP Status Code: 400

RequestTimeoutException

Problems with the request at the HTTP level. Reading the Request timed out.

HTTP Status Code: 408

ServiceUnavailable

The request has failed due to a temporary failure of the server.

HTTP Status Code: 503

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 400

UnrecognizedClientException

The X.509 certificate or AWS access key ID provided does not exist in our records.

HTTP Status Code: 403

API Version 2019-09-19 122

Amazon CodeGuru Reviewer API Reference

UnknownOperationException

The action or operation requested is invalid. Verify that the action is typed correctly.

HTTP Status Code: 404

ValidationError

The input fails to satisfy the constraints specified by an AWS service.

HTTP Status Code: 400

API Version 2019-09-19 123