@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AWSCodeCommit
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAWSCodeCommit
instead.
This is the AWS CodeCommit API Reference. This reference provides descriptions of the operations and data types for AWS CodeCommit API along with usage examples.
You can use the AWS CodeCommit API to work with the following objects:
Repositories, by calling the following:
BatchGetRepositories, which returns information about one or more repositories associated with your AWS account.
CreateRepository, which creates an AWS CodeCommit repository.
DeleteRepository, which deletes an AWS CodeCommit repository.
GetRepository, which returns information about a specified repository.
ListRepositories, which lists all AWS CodeCommit repositories associated with your AWS account.
UpdateRepositoryDescription, which sets or updates the description of the repository.
UpdateRepositoryName, which changes the name of the repository. If you change the name of a repository, no other users of that repository will be able to access it until you send them the new HTTPS or SSH URL to use.
Branches, by calling the following:
CreateBranch, which creates a new branch in a specified repository.
DeleteBranch, which deletes the specified branch in a repository unless it is the default branch.
GetBranch, which returns information about a specified branch.
ListBranches, which lists all branches for a specified repository.
UpdateDefaultBranch, which changes the default branch for a repository.
Files, by calling the following:
DeleteFile, which deletes the content of a specified file from a specified branch.
GetFile, which returns the base-64 encoded content of a specified file.
GetFolder, which returns the contents of a specified folder or directory.
PutFile, which adds or modifies a file in a specified repository and branch.
Information about committed code in a repository, by calling the following:
GetBlob, which returns the base-64 encoded content of an individual Git blob object within a repository.
GetCommit, which returns information about a commit, including commit messages and author and committer information.
GetDifferences, which returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or other fully qualified reference).
Pull requests, by calling the following:
CreatePullRequest, which creates a pull request in a specified repository.
DescribePullRequestEvents, which returns information about one or more pull request events.
GetCommentsForPullRequest, which returns information about comments on a specified pull request.
GetMergeConflicts, which returns information about merge conflicts between the source and destination branch in a pull request.
GetPullRequest, which returns information about a specified pull request.
ListPullRequests, which lists all pull requests for a repository.
MergePullRequestByFastForward, which merges the source destination branch of a pull request into the specified destination branch for that pull request using the fast-forward merge option.
PostCommentForPullRequest, which posts a comment to a pull request at the specified line, file, or request.
UpdatePullRequestDescription, which updates the description of a pull request.
UpdatePullRequestStatus, which updates the status of a pull request.
UpdatePullRequestTitle, which updates the title of a pull request.
Information about comments in a repository, by calling the following:
DeleteCommentContent, which deletes the content of a comment on a commit in a repository.
GetComment, which returns information about a comment on a commit.
GetCommentsForComparedCommit, which returns information about comments on the comparison between two commit specifiers in a repository.
PostCommentForComparedCommit, which creates a comment on the comparison between two commit specifiers in a repository.
PostCommentReply, which creates a reply to a comment.
UpdateComment, which updates the content of a comment on a commit in a repository.
Triggers, by calling the following:
GetRepositoryTriggers, which returns information about triggers configured for a repository.
PutRepositoryTriggers, which replaces all triggers for a repository and can be used to create or delete triggers.
TestRepositoryTriggers, which tests the functionality of a repository trigger by sending data to the trigger target.
For information about how to use AWS CodeCommit, see the AWS CodeCommit User Guide.
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
BatchGetRepositoriesResult |
batchGetRepositories(BatchGetRepositoriesRequest batchGetRepositoriesRequest)
Returns information about one or more repositories.
|
CreateBranchResult |
createBranch(CreateBranchRequest createBranchRequest)
Creates a new branch in a repository and points the branch to a commit.
|
CreatePullRequestResult |
createPullRequest(CreatePullRequestRequest createPullRequestRequest)
Creates a pull request in the specified repository.
|
CreateRepositoryResult |
createRepository(CreateRepositoryRequest createRepositoryRequest)
Creates a new, empty repository.
|
DeleteBranchResult |
deleteBranch(DeleteBranchRequest deleteBranchRequest)
Deletes a branch from a repository, unless that branch is the default branch for the repository.
|
DeleteCommentContentResult |
deleteCommentContent(DeleteCommentContentRequest deleteCommentContentRequest)
Deletes the content of a comment made on a change, file, or commit in a repository.
|
DeleteFileResult |
deleteFile(DeleteFileRequest deleteFileRequest)
Deletes a specified file from a specified branch.
|
DeleteRepositoryResult |
deleteRepository(DeleteRepositoryRequest deleteRepositoryRequest)
Deletes a repository.
|
DescribePullRequestEventsResult |
describePullRequestEvents(DescribePullRequestEventsRequest describePullRequestEventsRequest)
Returns information about one or more pull request events.
|
GetBlobResult |
getBlob(GetBlobRequest getBlobRequest)
Returns the base-64 encoded content of an individual blob within a repository.
|
GetBranchResult |
getBranch(GetBranchRequest getBranchRequest)
Returns information about a repository branch, including its name and the last commit ID.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetCommentResult |
getComment(GetCommentRequest getCommentRequest)
Returns the content of a comment made on a change, file, or commit in a repository.
|
GetCommentsForComparedCommitResult |
getCommentsForComparedCommit(GetCommentsForComparedCommitRequest getCommentsForComparedCommitRequest)
Returns information about comments made on the comparison between two commits.
|
GetCommentsForPullRequestResult |
getCommentsForPullRequest(GetCommentsForPullRequestRequest getCommentsForPullRequestRequest)
Returns comments made on a pull request.
|
GetCommitResult |
getCommit(GetCommitRequest getCommitRequest)
Returns information about a commit, including commit message and committer information.
|
GetDifferencesResult |
getDifferences(GetDifferencesRequest getDifferencesRequest)
Returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or
other fully qualified reference).
|
GetFileResult |
getFile(GetFileRequest getFileRequest)
Returns the base-64 encoded contents of a specified file and its metadata.
|
GetFolderResult |
getFolder(GetFolderRequest getFolderRequest)
Returns the contents of a specified folder in a repository.
|
GetMergeConflictsResult |
getMergeConflicts(GetMergeConflictsRequest getMergeConflictsRequest)
Returns information about merge conflicts between the before and after commit IDs for a pull request in a
repository.
|
GetPullRequestResult |
getPullRequest(GetPullRequestRequest getPullRequestRequest)
Gets information about a pull request in a specified repository.
|
GetRepositoryResult |
getRepository(GetRepositoryRequest getRepositoryRequest)
Returns information about a repository.
|
GetRepositoryTriggersResult |
getRepositoryTriggers(GetRepositoryTriggersRequest getRepositoryTriggersRequest)
Gets information about triggers configured for a repository.
|
ListBranchesResult |
listBranches(ListBranchesRequest listBranchesRequest)
Gets information about one or more branches in a repository.
|
ListPullRequestsResult |
listPullRequests(ListPullRequestsRequest listPullRequestsRequest)
Returns a list of pull requests for a specified repository.
|
ListRepositoriesResult |
listRepositories(ListRepositoriesRequest listRepositoriesRequest)
Gets information about one or more repositories.
|
MergePullRequestByFastForwardResult |
mergePullRequestByFastForward(MergePullRequestByFastForwardRequest mergePullRequestByFastForwardRequest)
Closes a pull request and attempts to merge the source commit of a pull request into the specified destination
branch for that pull request at the specified commit using the fast-forward merge option.
|
PostCommentForComparedCommitResult |
postCommentForComparedCommit(PostCommentForComparedCommitRequest postCommentForComparedCommitRequest)
Posts a comment on the comparison between two commits.
|
PostCommentForPullRequestResult |
postCommentForPullRequest(PostCommentForPullRequestRequest postCommentForPullRequestRequest)
Posts a comment on a pull request.
|
PostCommentReplyResult |
postCommentReply(PostCommentReplyRequest postCommentReplyRequest)
Posts a comment in reply to an existing comment on a comparison between commits or a pull request.
|
PutFileResult |
putFile(PutFileRequest putFileRequest)
Adds or updates a file in a branch in an AWS CodeCommit repository, and generates a commit for the addition in
the specified branch.
|
PutRepositoryTriggersResult |
putRepositoryTriggers(PutRepositoryTriggersRequest putRepositoryTriggersRequest)
Replaces all triggers for a repository.
|
void |
setEndpoint(String endpoint)
Deprecated.
use
AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration) for
example:
builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion)); |
void |
setRegion(Region region)
Deprecated.
use
AwsClientBuilder#setRegion(String) |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
TestRepositoryTriggersResult |
testRepositoryTriggers(TestRepositoryTriggersRequest testRepositoryTriggersRequest)
Tests the functionality of repository triggers by sending information to the trigger target.
|
UpdateCommentResult |
updateComment(UpdateCommentRequest updateCommentRequest)
Replaces the contents of a comment.
|
UpdateDefaultBranchResult |
updateDefaultBranch(UpdateDefaultBranchRequest updateDefaultBranchRequest)
Sets or changes the default branch name for the specified repository.
|
UpdatePullRequestDescriptionResult |
updatePullRequestDescription(UpdatePullRequestDescriptionRequest updatePullRequestDescriptionRequest)
Replaces the contents of the description of a pull request.
|
UpdatePullRequestStatusResult |
updatePullRequestStatus(UpdatePullRequestStatusRequest updatePullRequestStatusRequest)
Updates the status of a pull request.
|
UpdatePullRequestTitleResult |
updatePullRequestTitle(UpdatePullRequestTitleRequest updatePullRequestTitleRequest)
Replaces the title of a pull request.
|
UpdateRepositoryDescriptionResult |
updateRepositoryDescription(UpdateRepositoryDescriptionRequest updateRepositoryDescriptionRequest)
Sets or changes the comment or description for a repository.
|
UpdateRepositoryNameResult |
updateRepositoryName(UpdateRepositoryNameRequest updateRepositoryNameRequest)
Renames a repository.
|
static final String ENDPOINT_PREFIX
@Deprecated void setEndpoint(String endpoint)
AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)
for
example:
builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));
Callers can pass in just the endpoint (ex: "codecommit.us-east-1.amazonaws.com") or a full URL, including the
protocol (ex: "https://codecommit.us-east-1.amazonaws.com"). If the protocol is not specified here, the default
protocol from this client's ClientConfiguration
will be used, which by default is HTTPS.
For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-region-selection.html#region-selection- choose-endpoint
This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
endpoint
- The endpoint (ex: "codecommit.us-east-1.amazonaws.com") or a full URL, including the protocol (ex:
"https://codecommit.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will
communicate with.@Deprecated void setRegion(Region region)
AwsClientBuilder#setRegion(String)
setEndpoint(String)
, sets the regional endpoint for this client's service
calls. Callers can use this method to control which AWS region they want to work with.
By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the
ClientConfiguration
supplied at construction.
This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
region
- The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions)
for accessing a given region. Must not be null and must be a region where the service is available.Region.getRegion(com.amazonaws.regions.Regions)
,
Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
,
Region.isServiceSupported(String)
BatchGetRepositoriesResult batchGetRepositories(BatchGetRepositoriesRequest batchGetRepositoriesRequest)
Returns information about one or more repositories.
The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.
batchGetRepositoriesRequest
- Represents the input of a batch get repositories operation.RepositoryNamesRequiredException
- A repository names object is required but was not specified.MaximumRepositoryNamesExceededException
- The maximum number of allowed repository names was exceeded. Currently, this number is 25.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.CreateBranchResult createBranch(CreateBranchRequest createBranchRequest)
Creates a new branch in a repository and points the branch to a commit.
Calling the create branch operation does not set a repository's default branch. To do this, call the update default branch operation.
createBranchRequest
- Represents the input of a create branch operation.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.BranchNameRequiredException
- A branch name is required but was not specified.BranchNameExistsException
- The specified branch name already exists.InvalidBranchNameException
- The specified reference name is not valid.CommitIdRequiredException
- A commit ID was not specified.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.InvalidCommitIdException
- The specified commit ID is not valid.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.CreatePullRequestResult createPullRequest(CreatePullRequestRequest createPullRequestRequest)
Creates a pull request in the specified repository.
createPullRequestRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.ClientRequestTokenRequiredException
- A client request token is required. A client request token is an unique, client-generated idempotency
token that when provided in a request, ensures the request cannot be repeated with a changed parameter.
If a request is received with the same parameters and a token is included, the request will return
information about the initial request that used that token.InvalidClientRequestTokenException
- The client request token is not valid.IdempotencyParameterMismatchException
- The client request token is not valid. Either the token is not in a valid format, or the token has been
used in a previous request and cannot be re-used.ReferenceNameRequiredException
- A reference name is required, but none was provided.InvalidReferenceNameException
- The specified reference name format is not valid. Reference names must conform to the Git references
format, for example refs/heads/master. For more information, see Git Internals - Git References or
consult your Git documentation.ReferenceDoesNotExistException
- The specified reference does not exist. You must provide a full commit ID.ReferenceTypeNotSupportedException
- The specified reference is not a supported type.TitleRequiredException
- A pull request title is required. It cannot be empty or null.InvalidTitleException
- The title of the pull request is not valid. Pull request titles cannot exceed 100 characters in length.InvalidDescriptionException
- The pull request description is not valid. Descriptions are limited to 1,000 characters in length.TargetsRequiredException
- An array of target objects is required. It cannot be empty or null.InvalidTargetsException
- The targets for the pull request is not valid or not in a valid format. Targets are a list of target
objects. Each target object must contain the full values for the repository name, source branch, and
destination branch for a pull request.TargetRequiredException
- A pull request target is required. It cannot be empty or null. A pull request target must contain the
full values for the repository name, source branch, and destination branch for the pull request.InvalidTargetException
- The target for the pull request is not valid. A target must contain the full values for the repository
name, source branch, and destination branch for the pull request.MultipleRepositoriesInPullRequestException
- You cannot include more than one repository in a pull request. Make sure you have specified only one
repository name in your request, and then try again.MaximumOpenPullRequestsExceededException
- You cannot create the pull request because the repository has too many open pull requests. The maximum
number of open pull requests for a repository is 1,000. Close one or more open pull requests, and then
try again.SourceAndDestinationAreSameException
- The source branch and the destination branch for the pull request are the same. You must specify
different branches for the source and destination.CreateRepositoryResult createRepository(CreateRepositoryRequest createRepositoryRequest)
Creates a new, empty repository.
createRepositoryRequest
- Represents the input of a create repository operation.RepositoryNameExistsException
- The specified repository name already exists.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
InvalidRepositoryDescriptionException
- The specified repository description is not valid.RepositoryLimitExceededException
- A repository resource limit was exceeded.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.DeleteBranchResult deleteBranch(DeleteBranchRequest deleteBranchRequest)
Deletes a branch from a repository, unless that branch is the default branch for the repository.
deleteBranchRequest
- Represents the input of a delete branch operation.RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
BranchNameRequiredException
- A branch name is required but was not specified.InvalidBranchNameException
- The specified reference name is not valid.DefaultBranchCannotBeDeletedException
- The specified branch is the default branch for the repository, and cannot be deleted. To delete this
branch, you must first set another branch as the default branch.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.DeleteCommentContentResult deleteCommentContent(DeleteCommentContentRequest deleteCommentContentRequest)
Deletes the content of a comment made on a change, file, or commit in a repository.
deleteCommentContentRequest
- CommentDoesNotExistException
- No comment exists with the provided ID. Verify that you have provided the correct ID, and then try again.CommentIdRequiredException
- The comment ID is missing or null. A comment ID is required.InvalidCommentIdException
- The comment ID is not in a valid format. Make sure that you have provided the full comment ID.CommentDeletedException
- This comment has already been deleted. You cannot edit or delete a deleted comment.DeleteFileResult deleteFile(DeleteFileRequest deleteFileRequest)
Deletes a specified file from a specified branch. A commit is created on the branch that contains the revision. The file will still exist in the commits prior to the commit that contains the deletion.
deleteFileRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.ParentCommitIdRequiredException
- A parent commit ID is required. To view the full commit ID of a branch in a repository, use
GetBranch or a Git command (for example, git pull or git log).InvalidParentCommitIdException
- The parent commit ID is not valid. The commit ID cannot be empty, and must match the head commit ID for
the branch of the repository where you want to add or update a file.ParentCommitDoesNotExistException
- The parent commit ID is not valid because it does not exist. The specified parent commit ID does not
exist in the specified branch of the repository.ParentCommitIdOutdatedException
- The file could not be added because the provided parent commit ID is not the current tip of the specified
branch. To view the full commit ID of the current head of the branch, use GetBranch.PathRequiredException
- The folderPath for a location cannot be null.InvalidPathException
- The specified path is not valid.FileDoesNotExistException
- The specified file does not exist. Verify that you have provided the correct name of the file, including
its full path and extension.BranchNameRequiredException
- A branch name is required but was not specified.InvalidBranchNameException
- The specified reference name is not valid.BranchDoesNotExistException
- The specified branch does not exist.BranchNameIsTagNameException
- The specified branch name is not valid because it is a tag name. Type the name of a current branch in the
repository. For a list of valid branch names, use ListBranches.NameLengthExceededException
- The user name is not valid because it has exceeded the character limit for file names. File names,
including the path to the file, cannot exceed the character limit.InvalidEmailException
- The specified email address either contains one or more characters that are not allowed, or it exceeds
the maximum number of characters allowed for an email address.CommitMessageLengthExceededException
- The commit message is too long. Provide a shorter string.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.DeleteRepositoryResult deleteRepository(DeleteRepositoryRequest deleteRepositoryRequest)
Deletes a repository. If a specified repository was already deleted, a null repository ID will be returned.
Deleting a repository also deletes all associated objects and metadata. After a repository is deleted, all future push calls to the deleted repository will fail.
deleteRepositoryRequest
- Represents the input of a delete repository operation.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.DescribePullRequestEventsResult describePullRequestEvents(DescribePullRequestEventsRequest describePullRequestEventsRequest)
Returns information about one or more pull request events.
describePullRequestEventsRequest
- PullRequestDoesNotExistException
- The pull request ID could not be found. Make sure that you have specified the correct repository name and
pull request ID, and then try again.InvalidPullRequestIdException
- The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request
is in the specified repository, and then try again.PullRequestIdRequiredException
- A pull request ID is required, but none was provided.InvalidPullRequestEventTypeException
- The pull request event type is not valid.InvalidActorArnException
- The Amazon Resource Name (ARN) is not valid. Make sure that you have provided the full ARN for the user
who initiated the change for the pull request, and then try again.ActorDoesNotExistException
- The specified Amazon Resource Name (ARN) does not exist in the AWS account.InvalidMaxResultsException
- The specified number of maximum results is not valid.InvalidContinuationTokenException
- The specified continuation token is not valid.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetBlobResult getBlob(GetBlobRequest getBlobRequest)
Returns the base-64 encoded content of an individual blob within a repository.
getBlobRequest
- Represents the input of a get blob operation.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.BlobIdRequiredException
- A blob ID is required but was not specified.InvalidBlobIdException
- The specified blob is not valid.BlobIdDoesNotExistException
- The specified blob does not exist.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.FileTooLargeException
- The specified file exceeds the file size limit for AWS CodeCommit. For more information about limits in
AWS CodeCommit, see AWS
CodeCommit User Guide.GetBranchResult getBranch(GetBranchRequest getBranchRequest)
Returns information about a repository branch, including its name and the last commit ID.
getBranchRequest
- Represents the input of a get branch operation.RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
BranchNameRequiredException
- A branch name is required but was not specified.InvalidBranchNameException
- The specified reference name is not valid.BranchDoesNotExistException
- The specified branch does not exist.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetCommentResult getComment(GetCommentRequest getCommentRequest)
Returns the content of a comment made on a change, file, or commit in a repository.
getCommentRequest
- CommentDoesNotExistException
- No comment exists with the provided ID. Verify that you have provided the correct ID, and then try again.CommentIdRequiredException
- The comment ID is missing or null. A comment ID is required.InvalidCommentIdException
- The comment ID is not in a valid format. Make sure that you have provided the full comment ID.CommentDeletedException
- This comment has already been deleted. You cannot edit or delete a deleted comment.GetCommentsForComparedCommitResult getCommentsForComparedCommit(GetCommentsForComparedCommitRequest getCommentsForComparedCommitRequest)
Returns information about comments made on the comparison between two commits.
getCommentsForComparedCommitRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
CommitIdRequiredException
- A commit ID was not specified.InvalidCommitIdException
- The specified commit ID is not valid.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.InvalidMaxResultsException
- The specified number of maximum results is not valid.InvalidContinuationTokenException
- The specified continuation token is not valid.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetCommentsForPullRequestResult getCommentsForPullRequest(GetCommentsForPullRequestRequest getCommentsForPullRequestRequest)
Returns comments made on a pull request.
getCommentsForPullRequestRequest
- PullRequestIdRequiredException
- A pull request ID is required, but none was provided.PullRequestDoesNotExistException
- The pull request ID could not be found. Make sure that you have specified the correct repository name and
pull request ID, and then try again.InvalidPullRequestIdException
- The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request
is in the specified repository, and then try again.RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
CommitIdRequiredException
- A commit ID was not specified.InvalidCommitIdException
- The specified commit ID is not valid.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.InvalidMaxResultsException
- The specified number of maximum results is not valid.InvalidContinuationTokenException
- The specified continuation token is not valid.RepositoryNotAssociatedWithPullRequestException
- The repository does not contain any pull requests with that pull request ID. Check to make sure you have
provided the correct repository name for the pull request.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetCommitResult getCommit(GetCommitRequest getCommitRequest)
Returns information about a commit, including commit message and committer information.
getCommitRequest
- Represents the input of a get commit operation.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.CommitIdRequiredException
- A commit ID was not specified.InvalidCommitIdException
- The specified commit ID is not valid.CommitIdDoesNotExistException
- The specified commit ID does not exist.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetDifferencesResult getDifferences(GetDifferencesRequest getDifferencesRequest)
Returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or other fully qualified reference). Results can be limited to a specified path.
getDifferencesRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
InvalidContinuationTokenException
- The specified continuation token is not valid.InvalidMaxResultsException
- The specified number of maximum results is not valid.InvalidCommitIdException
- The specified commit ID is not valid.CommitRequiredException
- A commit was not specified.InvalidCommitException
- The specified commit is not valid.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.InvalidPathException
- The specified path is not valid.PathDoesNotExistException
- The specified path does not exist.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetFileResult getFile(GetFileRequest getFileRequest)
Returns the base-64 encoded contents of a specified file and its metadata.
getFileRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.InvalidCommitException
- The specified commit is not valid.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.PathRequiredException
- The folderPath for a location cannot be null.InvalidPathException
- The specified path is not valid.FileDoesNotExistException
- The specified file does not exist. Verify that you have provided the correct name of the file, including
its full path and extension.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.FileTooLargeException
- The specified file exceeds the file size limit for AWS CodeCommit. For more information about limits in
AWS CodeCommit, see AWS
CodeCommit User Guide.GetFolderResult getFolder(GetFolderRequest getFolderRequest)
Returns the contents of a specified folder in a repository.
getFolderRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.InvalidCommitException
- The specified commit is not valid.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.PathRequiredException
- The folderPath for a location cannot be null.InvalidPathException
- The specified path is not valid.FolderDoesNotExistException
- The specified folder does not exist. Either the folder name is not correct, or you did not provide the
full path to the folder.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetMergeConflictsResult getMergeConflicts(GetMergeConflictsRequest getMergeConflictsRequest)
Returns information about merge conflicts between the before and after commit IDs for a pull request in a repository.
getMergeConflictsRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.MergeOptionRequiredException
- A merge option or stategy is required, and none was provided.InvalidMergeOptionException
- The specified merge option is not valid. The only valid value is FAST_FORWARD_MERGE.InvalidDestinationCommitSpecifierException
- The destination commit specifier is not valid. You must provide a valid branch name, tag, or full commit
ID.InvalidSourceCommitSpecifierException
- The source commit specifier is not valid. You must provide a valid branch name, tag, or full commit ID.CommitRequiredException
- A commit was not specified.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.InvalidCommitException
- The specified commit is not valid.TipsDivergenceExceededException
- The divergence between the tips of the provided commit specifiers is too great to determine whether there
might be any merge conflicts. Locally compare the specifiers using git diff
or a diff tool.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetPullRequestResult getPullRequest(GetPullRequestRequest getPullRequestRequest)
Gets information about a pull request in a specified repository.
getPullRequestRequest
- PullRequestDoesNotExistException
- The pull request ID could not be found. Make sure that you have specified the correct repository name and
pull request ID, and then try again.InvalidPullRequestIdException
- The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request
is in the specified repository, and then try again.PullRequestIdRequiredException
- A pull request ID is required, but none was provided.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetRepositoryResult getRepository(GetRepositoryRequest getRepositoryRequest)
Returns information about a repository.
The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.
getRepositoryRequest
- Represents the input of a get repository operation.RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.GetRepositoryTriggersResult getRepositoryTriggers(GetRepositoryTriggersRequest getRepositoryTriggersRequest)
Gets information about triggers configured for a repository.
getRepositoryTriggersRequest
- Represents the input of a get repository triggers operation.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.ListBranchesResult listBranches(ListBranchesRequest listBranchesRequest)
Gets information about one or more branches in a repository.
listBranchesRequest
- Represents the input of a list branches operation.RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.InvalidContinuationTokenException
- The specified continuation token is not valid.ListPullRequestsResult listPullRequests(ListPullRequestsRequest listPullRequestsRequest)
Returns a list of pull requests for a specified repository. The return list can be refined by pull request status or pull request author ARN.
listPullRequestsRequest
- InvalidPullRequestStatusException
- The pull request status is not valid. The only valid values are OPEN
and CLOSED
.InvalidAuthorArnException
- The Amazon Resource Name (ARN) is not valid. Make sure that you have provided the full ARN for the author
of the pull request, and then try again.AuthorDoesNotExistException
- The specified Amazon Resource Name (ARN) does not exist in the AWS account.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.InvalidMaxResultsException
- The specified number of maximum results is not valid.InvalidContinuationTokenException
- The specified continuation token is not valid.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.ListRepositoriesResult listRepositories(ListRepositoriesRequest listRepositoriesRequest)
Gets information about one or more repositories.
listRepositoriesRequest
- Represents the input of a list repositories operation.InvalidSortByException
- The specified sort by value is not valid.InvalidOrderException
- The specified sort order is not valid.InvalidContinuationTokenException
- The specified continuation token is not valid.MergePullRequestByFastForwardResult mergePullRequestByFastForward(MergePullRequestByFastForwardRequest mergePullRequestByFastForwardRequest)
Closes a pull request and attempts to merge the source commit of a pull request into the specified destination branch for that pull request at the specified commit using the fast-forward merge option.
mergePullRequestByFastForwardRequest
- ManualMergeRequiredException
- The pull request cannot be merged automatically into the destination branch. You must manually merge the
branches and resolve any conflicts.PullRequestAlreadyClosedException
- The pull request status cannot be updated because it is already closed.PullRequestDoesNotExistException
- The pull request ID could not be found. Make sure that you have specified the correct repository name and
pull request ID, and then try again.InvalidPullRequestIdException
- The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request
is in the specified repository, and then try again.PullRequestIdRequiredException
- A pull request ID is required, but none was provided.TipOfSourceReferenceIsDifferentException
- The tip of the source branch in the destination repository does not match the tip of the source branch
specified in your request. The pull request might have been updated. Make sure that you have the latest
changes.ReferenceDoesNotExistException
- The specified reference does not exist. You must provide a full commit ID.InvalidCommitIdException
- The specified commit ID is not valid.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.PostCommentForComparedCommitResult postCommentForComparedCommit(PostCommentForComparedCommitRequest postCommentForComparedCommitRequest)
Posts a comment on the comparison between two commits.
postCommentForComparedCommitRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
ClientRequestTokenRequiredException
- A client request token is required. A client request token is an unique, client-generated idempotency
token that when provided in a request, ensures the request cannot be repeated with a changed parameter.
If a request is received with the same parameters and a token is included, the request will return
information about the initial request that used that token.InvalidClientRequestTokenException
- The client request token is not valid.IdempotencyParameterMismatchException
- The client request token is not valid. Either the token is not in a valid format, or the token has been
used in a previous request and cannot be re-used.CommentContentRequiredException
- The comment is empty. You must provide some content for a comment. The content cannot be null.CommentContentSizeLimitExceededException
- The comment is too large. Comments are limited to 1,000 characters.InvalidFileLocationException
- The location of the file is not valid. Make sure that you include the extension of the file as well as
the file name.InvalidRelativeFileVersionEnumException
- Either the enum is not in a valid format, or the specified file version enum is not valid in respect to
the current file version.PathRequiredException
- The folderPath for a location cannot be null.InvalidFilePositionException
- The position is not valid. Make sure that the line number exists in the version of the file you want to
comment on.CommitIdRequiredException
- A commit ID was not specified.InvalidCommitIdException
- The specified commit ID is not valid.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.BeforeCommitIdAndAfterCommitIdAreSameException
- The before commit ID and the after commit ID are the same, which is not valid. The before commit ID and
the after commit ID must be different commit IDs.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.InvalidPathException
- The specified path is not valid.PathDoesNotExistException
- The specified path does not exist.PostCommentForPullRequestResult postCommentForPullRequest(PostCommentForPullRequestRequest postCommentForPullRequestRequest)
Posts a comment on a pull request.
postCommentForPullRequestRequest
- PullRequestDoesNotExistException
- The pull request ID could not be found. Make sure that you have specified the correct repository name and
pull request ID, and then try again.InvalidPullRequestIdException
- The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request
is in the specified repository, and then try again.PullRequestIdRequiredException
- A pull request ID is required, but none was provided.RepositoryNotAssociatedWithPullRequestException
- The repository does not contain any pull requests with that pull request ID. Check to make sure you have
provided the correct repository name for the pull request.RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
ClientRequestTokenRequiredException
- A client request token is required. A client request token is an unique, client-generated idempotency
token that when provided in a request, ensures the request cannot be repeated with a changed parameter.
If a request is received with the same parameters and a token is included, the request will return
information about the initial request that used that token.InvalidClientRequestTokenException
- The client request token is not valid.IdempotencyParameterMismatchException
- The client request token is not valid. Either the token is not in a valid format, or the token has been
used in a previous request and cannot be re-used.CommentContentRequiredException
- The comment is empty. You must provide some content for a comment. The content cannot be null.CommentContentSizeLimitExceededException
- The comment is too large. Comments are limited to 1,000 characters.InvalidFileLocationException
- The location of the file is not valid. Make sure that you include the extension of the file as well as
the file name.InvalidRelativeFileVersionEnumException
- Either the enum is not in a valid format, or the specified file version enum is not valid in respect to
the current file version.PathRequiredException
- The folderPath for a location cannot be null.InvalidFilePositionException
- The position is not valid. Make sure that the line number exists in the version of the file you want to
comment on.CommitIdRequiredException
- A commit ID was not specified.InvalidCommitIdException
- The specified commit ID is not valid.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.CommitDoesNotExistException
- The specified commit does not exist or no commit was specified, and the specified repository has no
default branch.InvalidPathException
- The specified path is not valid.PathDoesNotExistException
- The specified path does not exist.PathRequiredException
- The folderPath for a location cannot be null.BeforeCommitIdAndAfterCommitIdAreSameException
- The before commit ID and the after commit ID are the same, which is not valid. The before commit ID and
the after commit ID must be different commit IDs.PostCommentReplyResult postCommentReply(PostCommentReplyRequest postCommentReplyRequest)
Posts a comment in reply to an existing comment on a comparison between commits or a pull request.
postCommentReplyRequest
- ClientRequestTokenRequiredException
- A client request token is required. A client request token is an unique, client-generated idempotency
token that when provided in a request, ensures the request cannot be repeated with a changed parameter.
If a request is received with the same parameters and a token is included, the request will return
information about the initial request that used that token.InvalidClientRequestTokenException
- The client request token is not valid.IdempotencyParameterMismatchException
- The client request token is not valid. Either the token is not in a valid format, or the token has been
used in a previous request and cannot be re-used.CommentContentRequiredException
- The comment is empty. You must provide some content for a comment. The content cannot be null.CommentContentSizeLimitExceededException
- The comment is too large. Comments are limited to 1,000 characters.CommentDoesNotExistException
- No comment exists with the provided ID. Verify that you have provided the correct ID, and then try again.CommentIdRequiredException
- The comment ID is missing or null. A comment ID is required.InvalidCommentIdException
- The comment ID is not in a valid format. Make sure that you have provided the full comment ID.PutFileResult putFile(PutFileRequest putFileRequest)
Adds or updates a file in a branch in an AWS CodeCommit repository, and generates a commit for the addition in the specified branch.
putFileRequest
- RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryDoesNotExistException
- The specified repository does not exist.ParentCommitIdRequiredException
- A parent commit ID is required. To view the full commit ID of a branch in a repository, use
GetBranch or a Git command (for example, git pull or git log).InvalidParentCommitIdException
- The parent commit ID is not valid. The commit ID cannot be empty, and must match the head commit ID for
the branch of the repository where you want to add or update a file.ParentCommitDoesNotExistException
- The parent commit ID is not valid because it does not exist. The specified parent commit ID does not
exist in the specified branch of the repository.ParentCommitIdOutdatedException
- The file could not be added because the provided parent commit ID is not the current tip of the specified
branch. To view the full commit ID of the current head of the branch, use GetBranch.FileContentRequiredException
- The file cannot be added because it is empty. Empty files cannot be added to the repository with this
API.FileContentSizeLimitExceededException
- The file cannot be added because it is too large. The maximum file size that can be added using PutFile
is 6 MB. For files larger than 6 MB but smaller than 2 GB, add them using a Git client.PathRequiredException
- The folderPath for a location cannot be null.InvalidPathException
- The specified path is not valid.BranchNameRequiredException
- A branch name is required but was not specified.InvalidBranchNameException
- The specified reference name is not valid.BranchDoesNotExistException
- The specified branch does not exist.BranchNameIsTagNameException
- The specified branch name is not valid because it is a tag name. Type the name of a current branch in the
repository. For a list of valid branch names, use ListBranches.InvalidFileModeException
- The specified file mode permission is not valid. For a list of valid file mode permissions, see
PutFile.NameLengthExceededException
- The user name is not valid because it has exceeded the character limit for file names. File names,
including the path to the file, cannot exceed the character limit.InvalidEmailException
- The specified email address either contains one or more characters that are not allowed, or it exceeds
the maximum number of characters allowed for an email address.CommitMessageLengthExceededException
- The commit message is too long. Provide a shorter string.InvalidDeletionParameterException
- The specified deletion parameter is not valid.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.SameFileContentException
- The file was not added or updated because the content of the file is exactly the same as the content of
that file in the repository and branch that you specified.FileNameConflictsWithDirectoryNameException
- A file cannot be added to the repository because the specified file name has the same name as a directory
in this repository. Either provide another name for the file, or add the file in a directory that does
not match the file name.DirectoryNameConflictsWithFileNameException
- A file cannot be added to the repository because the specified path name has the same name as a file that
already exists in this repository. Either provide a different name for the file, or specify a different
path for the file.PutRepositoryTriggersResult putRepositoryTriggers(PutRepositoryTriggersRequest putRepositoryTriggersRequest)
Replaces all triggers for a repository. This can be used to create or delete triggers.
putRepositoryTriggersRequest
- Represents the input ofa put repository triggers operation.RepositoryDoesNotExistException
- The specified repository does not exist.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryTriggersListRequiredException
- The list of triggers for the repository is required but was not specified.MaximumRepositoryTriggersExceededException
- The number of triggers allowed for the repository was exceeded.InvalidRepositoryTriggerNameException
- The name of the trigger is not valid.InvalidRepositoryTriggerDestinationArnException
- The Amazon Resource Name (ARN) for the trigger is not valid for the specified destination. The most
common reason for this error is that the ARN does not meet the requirements for the service type.InvalidRepositoryTriggerRegionException
- The region for the trigger target does not match the region for the repository. Triggers must be created
in the same region as the target for the trigger.InvalidRepositoryTriggerCustomDataException
- The custom data provided for the trigger is not valid.MaximumBranchesExceededException
- The number of branches for the trigger was exceeded.InvalidRepositoryTriggerBranchNameException
- One or more branch names specified for the trigger is not valid.InvalidRepositoryTriggerEventsException
- One or more events specified for the trigger is not valid. Check to make sure that all events specified
match the requirements for allowed events.RepositoryTriggerNameRequiredException
- A name for the trigger is required but was not specified.RepositoryTriggerDestinationArnRequiredException
- A destination ARN for the target service for the trigger is required but was not specified.RepositoryTriggerBranchNameListRequiredException
- At least one branch name is required but was not specified in the trigger configuration.RepositoryTriggerEventsListRequiredException
- At least one event for the trigger is required but was not specified.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.TestRepositoryTriggersResult testRepositoryTriggers(TestRepositoryTriggersRequest testRepositoryTriggersRequest)
Tests the functionality of repository triggers by sending information to the trigger target. If real data is available in the repository, the test will send data from the last commit. If no data is available, sample data will be generated.
testRepositoryTriggersRequest
- Represents the input of a test repository triggers operation.RepositoryDoesNotExistException
- The specified repository does not exist.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
RepositoryTriggersListRequiredException
- The list of triggers for the repository is required but was not specified.MaximumRepositoryTriggersExceededException
- The number of triggers allowed for the repository was exceeded.InvalidRepositoryTriggerNameException
- The name of the trigger is not valid.InvalidRepositoryTriggerDestinationArnException
- The Amazon Resource Name (ARN) for the trigger is not valid for the specified destination. The most
common reason for this error is that the ARN does not meet the requirements for the service type.InvalidRepositoryTriggerRegionException
- The region for the trigger target does not match the region for the repository. Triggers must be created
in the same region as the target for the trigger.InvalidRepositoryTriggerCustomDataException
- The custom data provided for the trigger is not valid.MaximumBranchesExceededException
- The number of branches for the trigger was exceeded.InvalidRepositoryTriggerBranchNameException
- One or more branch names specified for the trigger is not valid.InvalidRepositoryTriggerEventsException
- One or more events specified for the trigger is not valid. Check to make sure that all events specified
match the requirements for allowed events.RepositoryTriggerNameRequiredException
- A name for the trigger is required but was not specified.RepositoryTriggerDestinationArnRequiredException
- A destination ARN for the target service for the trigger is required but was not specified.RepositoryTriggerBranchNameListRequiredException
- At least one branch name is required but was not specified in the trigger configuration.RepositoryTriggerEventsListRequiredException
- At least one event for the trigger is required but was not specified.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.UpdateCommentResult updateComment(UpdateCommentRequest updateCommentRequest)
Replaces the contents of a comment.
updateCommentRequest
- CommentContentRequiredException
- The comment is empty. You must provide some content for a comment. The content cannot be null.CommentContentSizeLimitExceededException
- The comment is too large. Comments are limited to 1,000 characters.CommentDoesNotExistException
- No comment exists with the provided ID. Verify that you have provided the correct ID, and then try again.CommentIdRequiredException
- The comment ID is missing or null. A comment ID is required.InvalidCommentIdException
- The comment ID is not in a valid format. Make sure that you have provided the full comment ID.CommentNotCreatedByCallerException
- You cannot modify or delete this comment. Only comment authors can modify or delete their comments.CommentDeletedException
- This comment has already been deleted. You cannot edit or delete a deleted comment.UpdateDefaultBranchResult updateDefaultBranch(UpdateDefaultBranchRequest updateDefaultBranchRequest)
Sets or changes the default branch name for the specified repository.
If you use this operation to change the default branch name to the current default branch name, a success message is returned even though the default branch did not change.
updateDefaultBranchRequest
- Represents the input of an update default branch operation.RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
BranchNameRequiredException
- A branch name is required but was not specified.InvalidBranchNameException
- The specified reference name is not valid.BranchDoesNotExistException
- The specified branch does not exist.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.UpdatePullRequestDescriptionResult updatePullRequestDescription(UpdatePullRequestDescriptionRequest updatePullRequestDescriptionRequest)
Replaces the contents of the description of a pull request.
updatePullRequestDescriptionRequest
- PullRequestDoesNotExistException
- The pull request ID could not be found. Make sure that you have specified the correct repository name and
pull request ID, and then try again.InvalidPullRequestIdException
- The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request
is in the specified repository, and then try again.PullRequestIdRequiredException
- A pull request ID is required, but none was provided.InvalidDescriptionException
- The pull request description is not valid. Descriptions are limited to 1,000 characters in length.PullRequestAlreadyClosedException
- The pull request status cannot be updated because it is already closed.UpdatePullRequestStatusResult updatePullRequestStatus(UpdatePullRequestStatusRequest updatePullRequestStatusRequest)
Updates the status of a pull request.
updatePullRequestStatusRequest
- PullRequestDoesNotExistException
- The pull request ID could not be found. Make sure that you have specified the correct repository name and
pull request ID, and then try again.InvalidPullRequestIdException
- The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request
is in the specified repository, and then try again.PullRequestIdRequiredException
- A pull request ID is required, but none was provided.InvalidPullRequestStatusUpdateException
- The pull request status update is not valid. The only valid update is from OPEN
to
CLOSED
.InvalidPullRequestStatusException
- The pull request status is not valid. The only valid values are OPEN
and CLOSED
.PullRequestStatusRequiredException
- A pull request status is required, but none was provided.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.UpdatePullRequestTitleResult updatePullRequestTitle(UpdatePullRequestTitleRequest updatePullRequestTitleRequest)
Replaces the title of a pull request.
updatePullRequestTitleRequest
- PullRequestDoesNotExistException
- The pull request ID could not be found. Make sure that you have specified the correct repository name and
pull request ID, and then try again.InvalidPullRequestIdException
- The pull request ID is not valid. Make sure that you have provided the full ID and that the pull request
is in the specified repository, and then try again.PullRequestIdRequiredException
- A pull request ID is required, but none was provided.TitleRequiredException
- A pull request title is required. It cannot be empty or null.InvalidTitleException
- The title of the pull request is not valid. Pull request titles cannot exceed 100 characters in length.PullRequestAlreadyClosedException
- The pull request status cannot be updated because it is already closed.UpdateRepositoryDescriptionResult updateRepositoryDescription(UpdateRepositoryDescriptionRequest updateRepositoryDescriptionRequest)
Sets or changes the comment or description for a repository.
The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.
updateRepositoryDescriptionRequest
- Represents the input of an update repository description operation.RepositoryNameRequiredException
- A repository name is required but was not specified.RepositoryDoesNotExistException
- The specified repository does not exist.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
InvalidRepositoryDescriptionException
- The specified repository description is not valid.EncryptionIntegrityChecksFailedException
- An encryption integrity check failed.EncryptionKeyAccessDeniedException
- An encryption key could not be accessed.EncryptionKeyDisabledException
- The encryption key is disabled.EncryptionKeyNotFoundException
- No encryption key was found.EncryptionKeyUnavailableException
- The encryption key is not available.UpdateRepositoryNameResult updateRepositoryName(UpdateRepositoryNameRequest updateRepositoryNameRequest)
Renames a repository. The repository name must be unique across the calling AWS account. In addition, repository names are limited to 100 alphanumeric, dash, and underscore characters, and cannot include certain characters. The suffix ".git" is prohibited. For a full description of the limits on repository names, see Limits in the AWS CodeCommit User Guide.
updateRepositoryNameRequest
- Represents the input of an update repository description operation.RepositoryDoesNotExistException
- The specified repository does not exist.RepositoryNameExistsException
- The specified repository name already exists.RepositoryNameRequiredException
- A repository name is required but was not specified.InvalidRepositoryNameException
- At least one specified repository name is not valid. This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.
void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
request
- The originally executed request.Copyright © 2013 Amazon Web Services, Inc. All Rights Reserved.