@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSCodeCommitClient extends AmazonWebServiceClient implements AWSCodeCommit
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:
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.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Constructor and Description |
---|
AWSCodeCommitClient()
Deprecated.
|
AWSCodeCommitClient(AWSCredentials awsCredentials)
Deprecated.
use
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example:
AWSCodeCommitClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build(); |
AWSCodeCommitClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
|
AWSCodeCommitClient(AWSCredentialsProvider awsCredentialsProvider)
Deprecated.
|
AWSCodeCommitClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
|
AWSCodeCommitClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
|
AWSCodeCommitClient(ClientConfiguration clientConfiguration)
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
BatchGetRepositoriesResult |
batchGetRepositories(BatchGetRepositoriesRequest request)
Returns information about one or more repositories.
|
static AWSCodeCommitClientBuilder |
builder() |
CreateBranchResult |
createBranch(CreateBranchRequest request)
Creates a new branch in a repository and points the branch to a commit.
|
CreatePullRequestResult |
createPullRequest(CreatePullRequestRequest request)
Creates a pull request in the specified repository.
|
CreateRepositoryResult |
createRepository(CreateRepositoryRequest request)
Creates a new, empty repository.
|
DeleteBranchResult |
deleteBranch(DeleteBranchRequest request)
Deletes a branch from a repository, unless that branch is the default branch for the repository.
|
DeleteCommentContentResult |
deleteCommentContent(DeleteCommentContentRequest request)
Deletes the content of a comment made on a change, file, or commit in a repository.
|
DeleteRepositoryResult |
deleteRepository(DeleteRepositoryRequest request)
Deletes a repository.
|
DescribePullRequestEventsResult |
describePullRequestEvents(DescribePullRequestEventsRequest request)
Returns information about one or more pull request events.
|
GetBlobResult |
getBlob(GetBlobRequest request)
Returns the base-64 encoded content of an individual blob within a repository.
|
GetBranchResult |
getBranch(GetBranchRequest request)
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 request)
Returns the content of a comment made on a change, file, or commit in a repository.
|
GetCommentsForComparedCommitResult |
getCommentsForComparedCommit(GetCommentsForComparedCommitRequest request)
Returns information about comments made on the comparison between two commits.
|
GetCommentsForPullRequestResult |
getCommentsForPullRequest(GetCommentsForPullRequestRequest request)
Returns comments made on a pull request.
|
GetCommitResult |
getCommit(GetCommitRequest request)
Returns information about a commit, including commit message and committer information.
|
GetDifferencesResult |
getDifferences(GetDifferencesRequest request)
Returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or
other fully qualified reference).
|
GetMergeConflictsResult |
getMergeConflicts(GetMergeConflictsRequest request)
Returns information about merge conflicts between the before and after commit IDs for a pull request in a
repository.
|
GetPullRequestResult |
getPullRequest(GetPullRequestRequest request)
Gets information about a pull request in a specified repository.
|
GetRepositoryResult |
getRepository(GetRepositoryRequest request)
Returns information about a repository.
|
GetRepositoryTriggersResult |
getRepositoryTriggers(GetRepositoryTriggersRequest request)
Gets information about triggers configured for a repository.
|
ListBranchesResult |
listBranches(ListBranchesRequest request)
Gets information about one or more branches in a repository.
|
ListPullRequestsResult |
listPullRequests(ListPullRequestsRequest request)
Returns a list of pull requests for a specified repository.
|
ListRepositoriesResult |
listRepositories(ListRepositoriesRequest request)
Gets information about one or more repositories.
|
MergePullRequestByFastForwardResult |
mergePullRequestByFastForward(MergePullRequestByFastForwardRequest request)
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 request)
Posts a comment on the comparison between two commits.
|
PostCommentForPullRequestResult |
postCommentForPullRequest(PostCommentForPullRequestRequest request)
Posts a comment on a pull request.
|
PostCommentReplyResult |
postCommentReply(PostCommentReplyRequest request)
Posts a comment in reply to an existing comment on a comparison between commits or a pull request.
|
PutFileResult |
putFile(PutFileRequest request)
Adds or updates a file in an AWS CodeCommit repository.
|
PutRepositoryTriggersResult |
putRepositoryTriggers(PutRepositoryTriggersRequest request)
Replaces all triggers for a repository.
|
TestRepositoryTriggersResult |
testRepositoryTriggers(TestRepositoryTriggersRequest request)
Tests the functionality of repository triggers by sending information to the trigger target.
|
UpdateCommentResult |
updateComment(UpdateCommentRequest request)
Replaces the contents of a comment.
|
UpdateDefaultBranchResult |
updateDefaultBranch(UpdateDefaultBranchRequest request)
Sets or changes the default branch name for the specified repository.
|
UpdatePullRequestDescriptionResult |
updatePullRequestDescription(UpdatePullRequestDescriptionRequest request)
Replaces the contents of the description of a pull request.
|
UpdatePullRequestStatusResult |
updatePullRequestStatus(UpdatePullRequestStatusRequest request)
Updates the status of a pull request.
|
UpdatePullRequestTitleResult |
updatePullRequestTitle(UpdatePullRequestTitleRequest request)
Replaces the title of a pull request.
|
UpdateRepositoryDescriptionResult |
updateRepositoryDescription(UpdateRepositoryDescriptionRequest request)
Sets or changes the comment or description for a repository.
|
UpdateRepositoryNameResult |
updateRepositoryName(UpdateRepositoryNameRequest request)
Renames a repository.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
setEndpoint, setRegion, shutdown
@Deprecated public AWSCodeCommitClient()
AWSCodeCommitClientBuilder.defaultClient()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain
@Deprecated public AWSCodeCommitClient(ClientConfiguration clientConfiguration)
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration
- The client configuration options controlling how this client connects to CodeCommit (ex: proxy settings,
retry counts, etc.).DefaultAWSCredentialsProviderChain
@Deprecated public AWSCodeCommitClient(AWSCredentials awsCredentials)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
for example:
AWSCodeCommitClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.@Deprecated public AWSCodeCommitClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to CodeCommit (ex: proxy settings,
retry counts, etc.).@Deprecated public AWSCodeCommitClient(AWSCredentialsProvider awsCredentialsProvider)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.@Deprecated public AWSCodeCommitClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to CodeCommit (ex: proxy settings,
retry counts, etc.).@Deprecated public AWSCodeCommitClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
and
AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to CodeCommit (ex: proxy settings,
retry counts, etc.).requestMetricCollector
- optional request metric collectorpublic static AWSCodeCommitClientBuilder builder()
public BatchGetRepositoriesResult batchGetRepositories(BatchGetRepositoriesRequest request)
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.
batchGetRepositories
in interface AWSCodeCommit
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.public CreateBranchResult createBranch(CreateBranchRequest request)
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.
createBranch
in interface AWSCodeCommit
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.public CreatePullRequestResult createPullRequest(CreatePullRequestRequest request)
Creates a pull request in the specified repository.
createPullRequest
in interface AWSCodeCommit
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.public CreateRepositoryResult createRepository(CreateRepositoryRequest request)
Creates a new, empty repository.
createRepository
in interface AWSCodeCommit
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.public DeleteBranchResult deleteBranch(DeleteBranchRequest request)
Deletes a branch from a repository, unless that branch is the default branch for the repository.
deleteBranch
in interface AWSCodeCommit
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.public DeleteCommentContentResult deleteCommentContent(DeleteCommentContentRequest request)
Deletes the content of a comment made on a change, file, or commit in a repository.
deleteCommentContent
in interface AWSCodeCommit
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.public DeleteRepositoryResult deleteRepository(DeleteRepositoryRequest request)
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.
deleteRepository
in interface AWSCodeCommit
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.public DescribePullRequestEventsResult describePullRequestEvents(DescribePullRequestEventsRequest request)
Returns information about one or more pull request events.
describePullRequestEvents
in interface AWSCodeCommit
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.public GetBlobResult getBlob(GetBlobRequest request)
Returns the base-64 encoded content of an individual blob within a repository.
getBlob
in interface AWSCodeCommit
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.public GetBranchResult getBranch(GetBranchRequest request)
Returns information about a repository branch, including its name and the last commit ID.
getBranch
in interface AWSCodeCommit
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.public GetCommentResult getComment(GetCommentRequest request)
Returns the content of a comment made on a change, file, or commit in a repository.
getComment
in interface AWSCodeCommit
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.public GetCommentsForComparedCommitResult getCommentsForComparedCommit(GetCommentsForComparedCommitRequest request)
Returns information about comments made on the comparison between two commits.
getCommentsForComparedCommit
in interface AWSCodeCommit
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.public GetCommentsForPullRequestResult getCommentsForPullRequest(GetCommentsForPullRequestRequest request)
Returns comments made on a pull request.
getCommentsForPullRequest
in interface AWSCodeCommit
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.public GetCommitResult getCommit(GetCommitRequest request)
Returns information about a commit, including commit message and committer information.
getCommit
in interface AWSCodeCommit
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.public GetDifferencesResult getDifferences(GetDifferencesRequest request)
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.
getDifferences
in interface AWSCodeCommit
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.public GetMergeConflictsResult getMergeConflicts(GetMergeConflictsRequest request)
Returns information about merge conflicts between the before and after commit IDs for a pull request in a repository.
getMergeConflicts
in interface AWSCodeCommit
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.public GetPullRequestResult getPullRequest(GetPullRequestRequest request)
Gets information about a pull request in a specified repository.
getPullRequest
in interface AWSCodeCommit
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.public GetRepositoryResult getRepository(GetRepositoryRequest request)
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.
getRepository
in interface AWSCodeCommit
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.public GetRepositoryTriggersResult getRepositoryTriggers(GetRepositoryTriggersRequest request)
Gets information about triggers configured for a repository.
getRepositoryTriggers
in interface AWSCodeCommit
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.public ListBranchesResult listBranches(ListBranchesRequest request)
Gets information about one or more branches in a repository.
listBranches
in interface AWSCodeCommit
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.public ListPullRequestsResult listPullRequests(ListPullRequestsRequest request)
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.
listPullRequests
in interface AWSCodeCommit
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.public ListRepositoriesResult listRepositories(ListRepositoriesRequest request)
Gets information about one or more repositories.
listRepositories
in interface AWSCodeCommit
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.public MergePullRequestByFastForwardResult mergePullRequestByFastForward(MergePullRequestByFastForwardRequest request)
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.
mergePullRequestByFastForward
in interface AWSCodeCommit
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.public PostCommentForComparedCommitResult postCommentForComparedCommit(PostCommentForComparedCommitRequest request)
Posts a comment on the comparison between two commits.
postCommentForComparedCommit
in interface AWSCodeCommit
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 filePath for a location cannot be empty or 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.public PostCommentForPullRequestResult postCommentForPullRequest(PostCommentForPullRequestRequest request)
Posts a comment on a pull request.
postCommentForPullRequest
in interface AWSCodeCommit
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 filePath for a location cannot be empty or 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 filePath for a location cannot be empty or 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.public PostCommentReplyResult postCommentReply(PostCommentReplyRequest request)
Posts a comment in reply to an existing comment on a comparison between commits or a pull request.
postCommentReply
in interface AWSCodeCommit
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.public PutFileResult putFile(PutFileRequest request)
Adds or updates a file in an AWS CodeCommit repository.
putFile
in interface AWSCodeCommit
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. 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 filePath for a location cannot be empty or 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 file 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.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.public PutRepositoryTriggersResult putRepositoryTriggers(PutRepositoryTriggersRequest request)
Replaces all triggers for a repository. This can be used to create or delete triggers.
putRepositoryTriggers
in interface AWSCodeCommit
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.public TestRepositoryTriggersResult testRepositoryTriggers(TestRepositoryTriggersRequest request)
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.
testRepositoryTriggers
in interface AWSCodeCommit
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.public UpdateCommentResult updateComment(UpdateCommentRequest request)
Replaces the contents of a comment.
updateComment
in interface AWSCodeCommit
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.public UpdateDefaultBranchResult updateDefaultBranch(UpdateDefaultBranchRequest request)
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.
updateDefaultBranch
in interface AWSCodeCommit
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.public UpdatePullRequestDescriptionResult updatePullRequestDescription(UpdatePullRequestDescriptionRequest request)
Replaces the contents of the description of a pull request.
updatePullRequestDescription
in interface AWSCodeCommit
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.public UpdatePullRequestStatusResult updatePullRequestStatus(UpdatePullRequestStatusRequest request)
Updates the status of a pull request.
updatePullRequestStatus
in interface AWSCodeCommit
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.public UpdatePullRequestTitleResult updatePullRequestTitle(UpdatePullRequestTitleRequest request)
Replaces the title of a pull request.
updatePullRequestTitle
in interface AWSCodeCommit
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.public UpdateRepositoryDescriptionResult updateRepositoryDescription(UpdateRepositoryDescriptionRequest request)
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.
updateRepositoryDescription
in interface AWSCodeCommit
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.public UpdateRepositoryNameResult updateRepositoryName(UpdateRepositoryNameRequest request)
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.
updateRepositoryName
in interface AWSCodeCommit
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.
public 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 the request.
getCachedResponseMetadata
in interface AWSCodeCommit
request
- The originally executed requestCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.