* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.codecommit.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 can access it until you send them the new HTTPS or SSH URL to use. *
** Branches, by calling the following: *
** CreateBranch, which creates a 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. *
** GetBlob, which returns the base-64 encoded content of an individual Git blob object in a repository. *
** 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 single file in a specified repository and branch. *
** Commits, by calling the following: *
** BatchGetCommits, which returns information about one or more commits in a repository. *
** CreateCommit, which creates a commit for changes to 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). *
** Merges, by calling the following: *
** BatchDescribeMergeConflicts, which returns information about conflicts in a merge between commits in a * repository. *
** CreateUnreferencedMergeCommit, which creates an unreferenced commit between two branches or commits for the * purpose of comparing them and identifying any potential conflicts. *
** DescribeMergeConflicts, which returns information about merge conflicts between the base, source, and * destination versions of a file in a potential merge. *
** GetMergeCommit, which returns information about the merge between a source and destination commit. *
** GetMergeConflicts, which returns information about merge conflicts between the source and destination branch * in a pull request. *
** GetMergeOptions, which returns information about the available merge options between two branches or commit * specifiers. *
** MergeBranchesByFastForward, which merges two branches using the fast-forward merge option. *
** MergeBranchesBySquash, which merges two branches using the squash merge option. *
** MergeBranchesByThreeWay, which merges two branches using the three-way merge option. *
** Pull requests, by calling the following: *
** CreatePullRequest, which creates a pull request in a specified repository. *
** CreatePullRequestApprovalRule, which creates an approval rule for a specified pull request. *
** DeletePullRequestApprovalRule, which deletes an approval rule for a specified pull request. *
** DescribePullRequestEvents, which returns information about one or more pull request events. *
** EvaluatePullRequestApprovalRules, which evaluates whether a pull request has met all the conditions specified * in its associated approval rules. *
** GetCommentsForPullRequest, which returns information about comments on a specified pull request. *
** GetPullRequest, which returns information about a specified pull request. *
** GetPullRequestApprovalStates, which returns information about the approval states for a specified pull * request. *
** GetPullRequestOverrideState, which returns information about whether approval rules have been set aside * (overriden) for a pull request, and if so, the Amazon Resource Name (ARN) of the user or identity that overrode the * rules and their requirements for the 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. *
** MergePullRequestBySquash, which merges the source destination branch of a pull request into the specified * destination branch for that pull request using the squash merge option. *
** MergePullRequestByThreeWay. which merges the source destination branch of a pull request into the specified * destination branch for that pull request using the three-way merge option. *
** OverridePullRequestApprovalRules, which sets aside all approval rule requirements for a pull request. *
** PostCommentForPullRequest, which posts a comment to a pull request at the specified line, file, or request. *
** UpdatePullRequestApprovalRuleContent, which updates the structure of an approval rule for a pull request. *
** UpdatePullRequestApprovalState, which updates the state of an approval on a pull 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. *
** Approval rule templates, by calling the following: *
** AssociateApprovalRuleTemplateWithRepository, which associates a template with a specified repository. After * the template is associated with a repository, AWS CodeCommit creates approval rules that match the template * conditions on every pull request created in the specified repository. *
** BatchAssociateApprovalRuleTemplateWithRepositories, which associates a template with one or more specified * repositories. After the template is associated with a repository, AWS CodeCommit creates approval rules that match * the template conditions on every pull request created in the specified repositories. *
** BatchDisassociateApprovalRuleTemplateFromRepositories, which removes the association between a template and * specified repositories so that approval rules based on the template are not automatically created when pull requests * are created in those repositories. *
** CreateApprovalRuleTemplate, which creates a template for approval rules that can then be associated with one * or more repositories in your AWS account. *
** DeleteApprovalRuleTemplate, which deletes the specified template. It does not remove approval rules on pull * requests already created with the template. *
** DisassociateApprovalRuleTemplateFromRepository, which removes the association between a template and a * repository so that approval rules based on the template are not automatically created when pull requests are created * in the specified repository. *
** GetApprovalRuleTemplate, which returns information about an approval rule template. *
** ListApprovalRuleTemplates, which lists all approval rule templates in the AWS Region in your AWS account. *
** ListAssociatedApprovalRuleTemplatesForRepository, which lists all approval rule templates that are associated * with a specified repository. *
** ListRepositoriesForApprovalRuleTemplate, which lists all repositories associated with the specified approval * rule template. *
** UpdateApprovalRuleTemplateDescription, which updates the description of an approval rule template. *
** UpdateApprovalRuleTemplateName, which updates the name of an approval rule template. *
** UpdateApprovalRuleTemplateContent, which updates the content of an approval rule template. *
** 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. *
** GetCommentReactions, which returns information about emoji reactions to comments. *
** 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. *
** PutCommentReaction, which creates or updates an emoji reaction to a comment. *
** UpdateComment, which updates the content of a comment on a commit in a repository. *
** Tags used to tag resources in AWS CodeCommit (not Git tags), by calling the following: *
** ListTagsForResource, which gets information about AWS tags for a specified Amazon Resource Name (ARN) in AWS * CodeCommit. *
** TagResource, which adds or updates tags for a resource in AWS CodeCommit. *
** UntagResource, which removes tags for a resource in AWS CodeCommit. *
** 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. *
*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AWSCodeCommit { /** * The region metadata service name for computing region endpoints. You can use this value to retrieve metadata * (such as supported regions) of the service. * * @see RegionUtils#getRegionsForService(String) */ String ENDPOINT_PREFIX = "codecommit"; /** * Overrides the default endpoint for this client ("https://codecommit.us-east-1.amazonaws.com"). Callers can use * this method to control which AWS region they want to work with. ** 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 {@link 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. * * @param 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 use {@link AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)} for * example: * {@code builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));} */ @Deprecated void setEndpoint(String endpoint); /** * An alternative to {@link AWSCodeCommit#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 * {@link 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. * * @param region * The region this client will communicate with. See {@link 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. * * @see Region#getRegion(com.amazonaws.regions.Regions) * @see Region#createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration) * @see Region#isServiceSupported(String) * @deprecated use {@link AwsClientBuilder#setRegion(String)} */ @Deprecated void setRegion(Region region); /** *
* Creates an association between an approval rule template and a specified repository. Then, the next time a pull * request is created in the repository where the destination reference (if specified) matches the destination * reference (branch) for the pull request, an approval rule that matches the template conditions is automatically * created for that pull request. If no destination references are specified in the template, an approval rule that * matches the template contents is created for all pull requests in that repository. *
* * @param associateApprovalRuleTemplateWithRepositoryRequest * @return Result of the AssociateApprovalRuleTemplateWithRepository operation returned by the service. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @throws MaximumRuleTemplatesAssociatedWithRepositoryException * The maximum number of approval rule templates for a repository has been exceeded. You cannot associate * more than 25 approval rule templates with a repository. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.AssociateApprovalRuleTemplateWithRepository * @see AWS API Documentation */ AssociateApprovalRuleTemplateWithRepositoryResult associateApprovalRuleTemplateWithRepository( AssociateApprovalRuleTemplateWithRepositoryRequest associateApprovalRuleTemplateWithRepositoryRequest); /** ** Creates an association between an approval rule template and one or more specified repositories. *
* * @param batchAssociateApprovalRuleTemplateWithRepositoriesRequest * @return Result of the BatchAssociateApprovalRuleTemplateWithRepositories operation returned by the service. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @throws RepositoryNamesRequiredException * At least one repository name object is required, but was not specified. * @throws MaximumRepositoryNamesExceededException * The maximum number of allowed repository names was exceeded. Currently, this number is 100. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.BatchAssociateApprovalRuleTemplateWithRepositories * @see AWS API Documentation */ BatchAssociateApprovalRuleTemplateWithRepositoriesResult batchAssociateApprovalRuleTemplateWithRepositories( BatchAssociateApprovalRuleTemplateWithRepositoriesRequest batchAssociateApprovalRuleTemplateWithRepositoriesRequest); /** ** Returns information about one or more merge conflicts in the attempted merge of two commit specifiers using the * squash or three-way merge strategy. *
* * @param batchDescribeMergeConflictsRequest * @return Result of the BatchDescribeMergeConflicts operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws MergeOptionRequiredException * A merge option or stategy is required, and none was provided. * @throws InvalidMergeOptionException * The specified merge option is not valid for this operation. Not all merge strategies are supported for * all operations. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws CommitRequiredException * A commit was not specified. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidCommitException * The specified commit is not valid. * @throws 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 usinggit diff or a diff tool.
* @throws InvalidMaxConflictFilesException
* The specified value for the number of conflict files to return is not valid.
* @throws InvalidMaxMergeHunksException
* The specified value for the number of merge hunks to return is not valid.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.BatchDescribeMergeConflicts
* @see AWS API Documentation
*/
BatchDescribeMergeConflictsResult batchDescribeMergeConflicts(BatchDescribeMergeConflictsRequest batchDescribeMergeConflictsRequest);
/**
* * Removes the association between an approval rule template and one or more specified repositories. *
* * @param batchDisassociateApprovalRuleTemplateFromRepositoriesRequest * @return Result of the BatchDisassociateApprovalRuleTemplateFromRepositories operation returned by the service. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @throws RepositoryNamesRequiredException * At least one repository name object is required, but was not specified. * @throws MaximumRepositoryNamesExceededException * The maximum number of allowed repository names was exceeded. Currently, this number is 100. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.BatchDisassociateApprovalRuleTemplateFromRepositories * @see AWS API Documentation */ BatchDisassociateApprovalRuleTemplateFromRepositoriesResult batchDisassociateApprovalRuleTemplateFromRepositories( BatchDisassociateApprovalRuleTemplateFromRepositoriesRequest batchDisassociateApprovalRuleTemplateFromRepositoriesRequest); /** ** Returns information about the contents of one or more commits in a repository. *
* * @param batchGetCommitsRequest * @return Result of the BatchGetCommits operation returned by the service. * @throws CommitIdsListRequiredException * A list of commit IDs is required, but was either not specified or the list was empty. * @throws CommitIdsLimitExceededException * The maximum number of allowed commit IDs in a batch request is 100. Verify that your batch requests * contains no more than 100 commit IDs, and then try again. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.BatchGetCommits * @see AWS API * Documentation */ BatchGetCommitsResult batchGetCommits(BatchGetCommitsRequest batchGetCommitsRequest); /** ** 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 webpage can 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 webpage. *
** This exception occurs only 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. *
* @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.BatchGetRepositories * @see AWS API Documentation */ BatchGetRepositoriesResult batchGetRepositories(BatchGetRepositoriesRequest batchGetRepositoriesRequest); /** ** Creates a template for approval rules that can then be associated with one or more repositories in your AWS * account. When you associate a template with a repository, AWS CodeCommit creates an approval rule that matches * the conditions of the template for all pull requests that meet the conditions of the template. For more * information, see AssociateApprovalRuleTemplateWithRepository. *
* * @param createApprovalRuleTemplateRequest * @return Result of the CreateApprovalRuleTemplate operation returned by the service. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateNameAlreadyExistsException * You cannot create an approval rule template with that name because a template with that name already * exists in this AWS Region for your AWS account. Approval rule template names must be unique. * @throws ApprovalRuleTemplateContentRequiredException * The content for the approval rule template is empty. You must provide some content for an approval rule * template. The content cannot be null. * @throws InvalidApprovalRuleTemplateContentException * The content of the approval rule template is not valid. * @throws InvalidApprovalRuleTemplateDescriptionException * The description for the approval rule template is not valid because it exceeds the maximum characters * allowed for a description. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws NumberOfRuleTemplatesExceededException * The maximum number of approval rule templates has been exceeded for this AWS Region. * @sample AWSCodeCommit.CreateApprovalRuleTemplate * @see AWS API Documentation */ CreateApprovalRuleTemplateResult createApprovalRuleTemplate(CreateApprovalRuleTemplateRequest createApprovalRuleTemplateRequest); /** ** Creates a 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. *
** This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws BranchNameRequiredException * A branch name is required, but was not specified. * @throws BranchNameExistsException * Cannot create the branch with the specified name because the commit conflicts with an existing branch * with the same name. Branch names must be unique. * @throws InvalidBranchNameException * The specified reference name is not valid. * @throws CommitIdRequiredException * A commit ID was not specified. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.CreateBranch * @see AWS API * Documentation */ CreateBranchResult createBranch(CreateBranchRequest createBranchRequest); /** ** Creates a commit for a repository on the tip of a specified branch. *
* * @param createCommitRequest * @return Result of the CreateCommit operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws 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). * @throws 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. * @throws 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. * @throws 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. * @throws BranchNameRequiredException * A branch name is required, but was not specified. * @throws InvalidBranchNameException * The specified reference name is not valid. * @throws BranchDoesNotExistException * The specified branch does not exist. * @throws BranchNameIsTagNameException * The specified branch name is not valid because it is a tag name. Enter the name of a branch in the * repository. For a list of valid branch names, use ListBranches. * @throws FileEntryRequiredException * The commit cannot be created because no files have been specified as added, updated, or changed (PutFile * or DeleteFile) for the commit. * @throws MaximumFileEntriesExceededException * The number of specified files to change as part of this commit exceeds the maximum number of files that * can be changed in a single commit. Consider using a Git client for these changes. * @throws PutFileEntryConflictException * The commit cannot be created because one or more files specified in the commit reference both a file and * a folder. * @throws SourceFileOrContentRequiredException * The commit cannot be created because no source files or file content have been specified for the commit. * @throws FileContentAndSourceFileSpecifiedException * The commit cannot be created because both a source file and file content have been specified for the same * file. You cannot provide both. Either specify a source file or provide the file content directly. * @throws PathRequiredException * The folderPath for a location cannot be null. * @throws InvalidPathException * The specified path is not valid. * @throws SamePathRequestException * The commit cannot be created because one or more changes in this commit duplicate actions in the same * file path. For example, you cannot make the same delete request to the same file in the same file path * twice, or make a delete request and a move request to the same file as part of the same commit. * @throws FileDoesNotExistException * The specified file does not exist. Verify that you have used the correct file name, full path, and * extension. * @throws FileContentSizeLimitExceededException * The file cannot be added because it is too large. The maximum file size is 6 MB, and the combined file * content change size is 7 MB. Consider making these changes using a Git client. * @throws FolderContentSizeLimitExceededException * The commit cannot be created because at least one of the overall changes in the commit results in a * folder whose contents exceed the limit of 6 MB. Either reduce the number and size of your changes, or * split the changes across multiple folders. * @throws InvalidDeletionParameterException * The specified deletion parameter is not valid. * @throws RestrictedSourceFileException * The commit cannot be created because one of the changes specifies copying or moving a .gitkeep file. * @throws FileModeRequiredException * The commit cannot be created because no file mode has been specified. A file mode is required to update * mode permissions for a file. * @throws InvalidFileModeException * The specified file mode permission is not valid. For a list of valid file mode permissions, see * PutFile. * @throws NameLengthExceededException * The user name is not valid because it has exceeded the character limit for author names. * @throws 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. * @throws CommitMessageLengthExceededException * The commit message is too long. Provide a shorter string. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws NoChangeException * The commit cannot be created because no changes will be made to the repository as a result of this * commit. A commit must contain at least one change. * @throws 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. * @throws 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. * @throws FilePathConflictsWithSubmodulePathException * The commit cannot be created because a specified file path points to a submodule. Verify that the * destination files have valid file paths that do not point to a submodule. * @sample AWSCodeCommit.CreateCommit * @see AWS API * Documentation */ CreateCommitResult createCommit(CreateCommitRequest createCommitRequest); /** ** Creates a pull request in the specified repository. *
* * @param createPullRequestRequest * @return Result of the CreatePullRequest operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws 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 returns * information about the initial request that used that token. * @throws InvalidClientRequestTokenException * The client request token is not valid. * @throws 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 reused. * @throws ReferenceNameRequiredException * A reference name is required, but none was provided. * @throws 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. * @throws ReferenceDoesNotExistException * The specified reference does not exist. You must provide a full commit ID. * @throws ReferenceTypeNotSupportedException * The specified reference is not a supported type. * @throws TitleRequiredException * A pull request title is required. It cannot be empty or null. * @throws InvalidTitleException * The title of the pull request is not valid. Pull request titles cannot exceed 100 characters in length. * @throws InvalidDescriptionException * The pull request description is not valid. Descriptions cannot be more than 1,000 characters. * @throws TargetsRequiredException * An array of target objects is required. It cannot be empty or null. * @throws 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. * @throws 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. * @throws 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. * @throws 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. * @throws 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. * @throws SourceAndDestinationAreSameException * The source branch and destination branch for the pull request are the same. You must specify different * branches for the source and destination. * @sample AWSCodeCommit.CreatePullRequest * @see AWS * API Documentation */ CreatePullRequestResult createPullRequest(CreatePullRequestRequest createPullRequestRequest); /** ** Creates an approval rule for a pull request. *
* * @param createPullRequestApprovalRuleRequest * @return Result of the CreatePullRequestApprovalRule operation returned by the service. * @throws ApprovalRuleNameRequiredException * An approval rule name is required, but was not specified. * @throws InvalidApprovalRuleNameException * The name for the approval rule is not valid. * @throws ApprovalRuleNameAlreadyExistsException * An approval rule with that name already exists. Approval rule names must be unique within the scope of a * pull request. * @throws ApprovalRuleContentRequiredException * The content for the approval rule is empty. You must provide some content for an approval rule. The * content cannot be null. * @throws InvalidApprovalRuleContentException * The content for the approval rule is not valid. * @throws NumberOfRulesExceededException * The approval rule cannot be added. The pull request has the maximum number of approval rules associated * with it. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.CreatePullRequestApprovalRule * @see AWS API Documentation */ CreatePullRequestApprovalRuleResult createPullRequestApprovalRule(CreatePullRequestApprovalRuleRequest createPullRequestApprovalRuleRequest); /** ** Creates a new, empty repository. *
* * @param createRepositoryRequest * Represents the input of a create repository operation. * @return Result of the CreateRepository operation returned by the service. * @throws RepositoryNameExistsException * The specified repository name already exists. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws InvalidRepositoryDescriptionException * The specified repository description is not valid. * @throws RepositoryLimitExceededException * A repository resource limit was exceeded. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws InvalidTagsMapException * The map of tags is not valid. * @throws TooManyTagsException * The maximum number of tags for an AWS CodeCommit resource has been exceeded. * @throws InvalidSystemTagUsageException * The specified tag is not valid. Key names cannot be prefixed with aws:. * @throws TagPolicyException * The tag policy is not valid. * @sample AWSCodeCommit.CreateRepository * @see AWS * API Documentation */ CreateRepositoryResult createRepository(CreateRepositoryRequest createRepositoryRequest); /** ** Creates an unreferenced commit that represents the result of merging two branches using a specified merge * strategy. This can help you determine the outcome of a potential merge. This API cannot be used with the * fast-forward merge strategy because that strategy does not create a merge commit. *
** This unreferenced merge commit can only be accessed using the GetCommit API or through git commands such as git * fetch. To retrieve this commit, you must specify its commit ID or otherwise reference it. *
** This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws 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 usinggit diff or a diff tool.
* @throws CommitRequiredException
* A commit was not specified.
* @throws InvalidCommitException
* The specified commit is not valid.
* @throws CommitDoesNotExistException
* The specified commit does not exist or no commit was specified, and the specified repository has no
* default branch.
* @throws MergeOptionRequiredException
* A merge option or stategy is required, and none was provided.
* @throws InvalidMergeOptionException
* The specified merge option is not valid for this operation. Not all merge strategies are supported for
* all operations.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws InvalidConflictResolutionException
* The specified conflict resolution list is not valid.
* @throws ManualMergeRequiredException
* The pull request cannot be merged automatically into the destination branch. You must manually merge the
* branches and resolve any conflicts.
* @throws MaximumConflictResolutionEntriesExceededException
* The number of allowed conflict resolution entries was exceeded.
* @throws MultipleConflictResolutionEntriesException
* More than one conflict resolution entries exists for the conflict. A conflict can have only one conflict
* resolution entry.
* @throws ReplacementTypeRequiredException
* A replacement type is required.
* @throws InvalidReplacementTypeException
* Automerge was specified for resolving the conflict, but the specified replacement type is not valid.
* @throws ReplacementContentRequiredException
* USE_NEW_CONTENT was specified, but no replacement content has been provided.
* @throws InvalidReplacementContentException
* Automerge was specified for resolving the conflict, but the replacement type is not valid or content is
* missing.
* @throws PathRequiredException
* The folderPath for a location cannot be null.
* @throws InvalidPathException
* The specified path is not valid.
* @throws FileContentSizeLimitExceededException
* The file cannot be added because it is too large. The maximum file size is 6 MB, and the combined file
* content change size is 7 MB. Consider making these changes using a Git client.
* @throws FolderContentSizeLimitExceededException
* The commit cannot be created because at least one of the overall changes in the commit results in a
* folder whose contents exceed the limit of 6 MB. Either reduce the number and size of your changes, or
* split the changes across multiple folders.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws ConcurrentReferenceUpdateException
* The merge cannot be completed because the target branch has been modified. Another user might have
* modified the target branch while the merge was in progress. Wait a few minutes, and then try again.
* @throws FileModeRequiredException
* The commit cannot be created because no file mode has been specified. A file mode is required to update
* mode permissions for a file.
* @throws InvalidFileModeException
* The specified file mode permission is not valid. For a list of valid file mode permissions, see
* PutFile.
* @throws NameLengthExceededException
* The user name is not valid because it has exceeded the character limit for author names.
* @throws 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.
* @throws CommitMessageLengthExceededException
* The commit message is too long. Provide a shorter string.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.CreateUnreferencedMergeCommit
* @see AWS API Documentation
*/
CreateUnreferencedMergeCommitResult createUnreferencedMergeCommit(CreateUnreferencedMergeCommitRequest createUnreferencedMergeCommitRequest);
/**
* * Deletes a specified approval rule template. Deleting a template does not remove approval rules on pull requests * already created with the template. *
* * @param deleteApprovalRuleTemplateRequest * @return Result of the DeleteApprovalRuleTemplate operation returned by the service. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateInUseException * The approval rule template is associated with one or more repositories. You cannot delete a template that * is associated with a repository. Remove all associations, and then try again. * @sample AWSCodeCommit.DeleteApprovalRuleTemplate * @see AWS API Documentation */ DeleteApprovalRuleTemplateResult deleteApprovalRuleTemplate(DeleteApprovalRuleTemplateRequest deleteApprovalRuleTemplateRequest); /** ** Deletes a branch from a repository, unless that branch is the default branch for the repository. *
* * @param deleteBranchRequest * Represents the input of a delete branch operation. * @return Result of the DeleteBranch operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws BranchNameRequiredException * A branch name is required, but was not specified. * @throws InvalidBranchNameException * The specified reference name is not valid. * @throws 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. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.DeleteBranch * @see AWS API * Documentation */ DeleteBranchResult deleteBranch(DeleteBranchRequest deleteBranchRequest); /** ** Deletes the content of a comment made on a change, file, or commit in a repository. *
* * @param deleteCommentContentRequest * @return Result of the DeleteCommentContent operation returned by the service. * @throws CommentDoesNotExistException * No comment exists with the provided ID. Verify that you have used the correct ID, and then try again. * @throws CommentIdRequiredException * The comment ID is missing or null. A comment ID is required. * @throws InvalidCommentIdException * The comment ID is not in a valid format. Make sure that you have provided the full comment ID. * @throws CommentDeletedException * This comment has already been deleted. You cannot edit or delete a deleted comment. * @sample AWSCodeCommit.DeleteCommentContent * @see AWS API Documentation */ DeleteCommentContentResult deleteCommentContent(DeleteCommentContentRequest deleteCommentContentRequest); /** ** Deletes a specified file from a specified branch. A commit is created on the branch that contains the revision. * The file still exists in the commits earlier to the commit that contains the deletion. *
* * @param deleteFileRequest * @return Result of the DeleteFile operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws 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). * @throws 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. * @throws 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. * @throws 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. * @throws PathRequiredException * The folderPath for a location cannot be null. * @throws InvalidPathException * The specified path is not valid. * @throws FileDoesNotExistException * The specified file does not exist. Verify that you have used the correct file name, full path, and * extension. * @throws BranchNameRequiredException * A branch name is required, but was not specified. * @throws InvalidBranchNameException * The specified reference name is not valid. * @throws BranchDoesNotExistException * The specified branch does not exist. * @throws BranchNameIsTagNameException * The specified branch name is not valid because it is a tag name. Enter the name of a branch in the * repository. For a list of valid branch names, use ListBranches. * @throws NameLengthExceededException * The user name is not valid because it has exceeded the character limit for author names. * @throws 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. * @throws CommitMessageLengthExceededException * The commit message is too long. Provide a shorter string. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.DeleteFile * @see AWS API * Documentation */ DeleteFileResult deleteFile(DeleteFileRequest deleteFileRequest); /** ** Deletes an approval rule from a specified pull request. Approval rules can be deleted from a pull request only if * the pull request is open, and if the approval rule was created specifically for a pull request and not generated * from an approval rule template associated with the repository where the pull request was created. You cannot * delete an approval rule from a merged or closed pull request. *
* * @param deletePullRequestApprovalRuleRequest * @return Result of the DeletePullRequestApprovalRule operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @throws ApprovalRuleNameRequiredException * An approval rule name is required, but was not specified. * @throws InvalidApprovalRuleNameException * The name for the approval rule is not valid. * @throws CannotDeleteApprovalRuleFromTemplateException * The approval rule cannot be deleted from the pull request because it was created by an approval rule * template and applied to the pull request automatically. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.DeletePullRequestApprovalRule * @see AWS API Documentation */ DeletePullRequestApprovalRuleResult deletePullRequestApprovalRule(DeletePullRequestApprovalRuleRequest deletePullRequestApprovalRuleRequest); /** ** Deletes a repository. If a specified repository was already deleted, a null repository ID is returned. *
** Deleting a repository also deletes all associated objects and metadata. After a repository is deleted, all future * push calls to the deleted repository fail. *
** This exception occurs only 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. *
* @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.DeleteRepository * @see AWS * API Documentation */ DeleteRepositoryResult deleteRepository(DeleteRepositoryRequest deleteRepositoryRequest); /** ** Returns information about one or more merge conflicts in the attempted merge of two commit specifiers using the * squash or three-way merge strategy. If the merge option for the attempted merge is specified as * FAST_FORWARD_MERGE, an exception is thrown. *
* * @param describeMergeConflictsRequest * @return Result of the DescribeMergeConflicts operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws MergeOptionRequiredException * A merge option or stategy is required, and none was provided. * @throws InvalidMergeOptionException * The specified merge option is not valid for this operation. Not all merge strategies are supported for * all operations. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws CommitRequiredException * A commit was not specified. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidCommitException * The specified commit is not valid. * @throws 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 usinggit diff or a diff tool.
* @throws PathRequiredException
* The folderPath for a location cannot be null.
* @throws InvalidPathException
* The specified path is not valid.
* @throws FileDoesNotExistException
* The specified file does not exist. Verify that you have used the correct file name, full path, and
* extension.
* @throws InvalidMaxMergeHunksException
* The specified value for the number of merge hunks to return is not valid.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.DescribeMergeConflicts
* @see AWS API Documentation
*/
DescribeMergeConflictsResult describeMergeConflicts(DescribeMergeConflictsRequest describeMergeConflictsRequest);
/**
* * Returns information about one or more pull request events. *
* * @param describePullRequestEventsRequest * @return Result of the DescribePullRequestEvents operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws InvalidPullRequestEventTypeException * The pull request event type is not valid. * @throws 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. * @throws ActorDoesNotExistException * The specified Amazon Resource Name (ARN) does not exist in the AWS account. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.DescribePullRequestEvents * @see AWS API Documentation */ DescribePullRequestEventsResult describePullRequestEvents(DescribePullRequestEventsRequest describePullRequestEventsRequest); /** ** Removes the association between a template and a repository so that approval rules based on the template are not * automatically created when pull requests are created in the specified repository. This does not delete any * approval rules previously created for pull requests through the template association. *
* * @param disassociateApprovalRuleTemplateFromRepositoryRequest * @return Result of the DisassociateApprovalRuleTemplateFromRepository operation returned by the service. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.DisassociateApprovalRuleTemplateFromRepository * @see AWS API Documentation */ DisassociateApprovalRuleTemplateFromRepositoryResult disassociateApprovalRuleTemplateFromRepository( DisassociateApprovalRuleTemplateFromRepositoryRequest disassociateApprovalRuleTemplateFromRepositoryRequest); /** ** Evaluates whether a pull request has met all the conditions specified in its associated approval rules. *
* * @param evaluatePullRequestApprovalRulesRequest * @return Result of the EvaluatePullRequestApprovalRules operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws InvalidRevisionIdException * The revision ID is not valid. Use GetPullRequest to determine the value. * @throws RevisionIdRequiredException * A revision ID is required, but was not provided. * @throws RevisionNotCurrentException * The revision ID provided in the request does not match the current revision ID. Use GetPullRequest to * retrieve the current revision ID. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.EvaluatePullRequestApprovalRules * @see AWS API Documentation */ EvaluatePullRequestApprovalRulesResult evaluatePullRequestApprovalRules(EvaluatePullRequestApprovalRulesRequest evaluatePullRequestApprovalRulesRequest); /** ** Returns information about a specified approval rule template. *
* * @param getApprovalRuleTemplateRequest * @return Result of the GetApprovalRuleTemplate operation returned by the service. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @sample AWSCodeCommit.GetApprovalRuleTemplate * @see AWS API Documentation */ GetApprovalRuleTemplateResult getApprovalRuleTemplate(GetApprovalRuleTemplateRequest getApprovalRuleTemplateRequest); /** ** Returns the base-64 encoded content of an individual blob in a repository. *
* * @param getBlobRequest * Represents the input of a get blob operation. * @return Result of the GetBlob operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws BlobIdRequiredException * A blob ID is required, but was not specified. * @throws InvalidBlobIdException * The specified blob is not valid. * @throws BlobIdDoesNotExistException * The specified blob does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws 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. * @sample AWSCodeCommit.GetBlob * @see AWS API * Documentation */ GetBlobResult getBlob(GetBlobRequest getBlobRequest); /** ** Returns information about a repository branch, including its name and the last commit ID. *
* * @param getBranchRequest * Represents the input of a get branch operation. * @return Result of the GetBranch operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws BranchNameRequiredException * A branch name is required, but was not specified. * @throws InvalidBranchNameException * The specified reference name is not valid. * @throws BranchDoesNotExistException * The specified branch does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetBranch * @see AWS API * Documentation */ GetBranchResult getBranch(GetBranchRequest getBranchRequest); /** ** Returns the content of a comment made on a change, file, or commit in a repository. *
** Reaction counts might include numbers from user identities who were deleted after the reaction was made. For a * count of reactions from active identities, use GetCommentReactions. *
** Returns information about reactions to a specified comment ID. Reactions from users who have been deleted will * not be included in the count. *
* * @param getCommentReactionsRequest * @return Result of the GetCommentReactions operation returned by the service. * @throws CommentDoesNotExistException * No comment exists with the provided ID. Verify that you have used the correct ID, and then try again. * @throws CommentIdRequiredException * The comment ID is missing or null. A comment ID is required. * @throws InvalidCommentIdException * The comment ID is not in a valid format. Make sure that you have provided the full comment ID. * @throws InvalidReactionUserArnException * The Amazon Resource Name (ARN) of the user or identity is not valid. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws CommentDeletedException * This comment has already been deleted. You cannot edit or delete a deleted comment. * @sample AWSCodeCommit.GetCommentReactions * @see AWS * API Documentation */ GetCommentReactionsResult getCommentReactions(GetCommentReactionsRequest getCommentReactionsRequest); /** ** Returns information about comments made on the comparison between two commits. *
** Reaction counts might include numbers from user identities who were deleted after the reaction was made. For a * count of reactions from active identities, use GetCommentReactions. *
** This exception occurs only 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. *
* @throws CommitIdRequiredException * A commit ID was not specified. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetCommentsForComparedCommit * @see AWS API Documentation */ GetCommentsForComparedCommitResult getCommentsForComparedCommit(GetCommentsForComparedCommitRequest getCommentsForComparedCommitRequest); /** ** Returns comments made on a pull request. *
** Reaction counts might include numbers from user identities who were deleted after the reaction was made. For a * count of reactions from active identities, use GetCommentReactions. *
** This exception occurs only 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. *
* @throws CommitIdRequiredException * A commit ID was not specified. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws RepositoryNotAssociatedWithPullRequestException * The repository does not contain any pull requests with that pull request ID. Use GetPullRequest to verify * the correct repository name for the pull request ID. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetCommentsForPullRequest * @see AWS API Documentation */ GetCommentsForPullRequestResult getCommentsForPullRequest(GetCommentsForPullRequestRequest getCommentsForPullRequestRequest); /** ** Returns information about a commit, including commit message and committer information. *
* * @param getCommitRequest * Represents the input of a get commit operation. * @return Result of the GetCommit operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws CommitIdRequiredException * A commit ID was not specified. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws CommitIdDoesNotExistException * The specified commit ID does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetCommit * @see AWS API * Documentation */ GetCommitResult getCommit(GetCommitRequest getCommitRequest); /** ** 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. *
* * @param getDifferencesRequest * @return Result of the GetDifferences operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws CommitRequiredException * A commit was not specified. * @throws InvalidCommitException * The specified commit is not valid. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidPathException * The specified path is not valid. * @throws PathDoesNotExistException * The specified path does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetDifferences * @see AWS API * Documentation */ GetDifferencesResult getDifferences(GetDifferencesRequest getDifferencesRequest); /** ** Returns the base-64 encoded contents of a specified file and its metadata. *
* * @param getFileRequest * @return Result of the GetFile operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidCommitException * The specified commit is not valid. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws PathRequiredException * The folderPath for a location cannot be null. * @throws InvalidPathException * The specified path is not valid. * @throws FileDoesNotExistException * The specified file does not exist. Verify that you have used the correct file name, full path, and * extension. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws 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. * @sample AWSCodeCommit.GetFile * @see AWS API * Documentation */ GetFileResult getFile(GetFileRequest getFileRequest); /** ** Returns the contents of a specified folder in a repository. *
* * @param getFolderRequest * @return Result of the GetFolder operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidCommitException * The specified commit is not valid. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws PathRequiredException * The folderPath for a location cannot be null. * @throws InvalidPathException * The specified path is not valid. * @throws FolderDoesNotExistException * The specified folder does not exist. Either the folder name is not correct, or you did not enter the full * path to the folder. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetFolder * @see AWS API * Documentation */ GetFolderResult getFolder(GetFolderRequest getFolderRequest); /** ** Returns information about a specified merge commit. *
* * @param getMergeCommitRequest * @return Result of the GetMergeCommit operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws CommitRequiredException * A commit was not specified. * @throws InvalidCommitException * The specified commit is not valid. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidConflictDetailLevelException * The specified conflict detail level is not valid. * @throws InvalidConflictResolutionStrategyException * The specified conflict resolution strategy is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetMergeCommit * @see AWS API * Documentation */ GetMergeCommitResult getMergeCommit(GetMergeCommitRequest getMergeCommitRequest); /** ** Returns information about merge conflicts between the before and after commit IDs for a pull request in a * repository. *
* * @param getMergeConflictsRequest * @return Result of the GetMergeConflicts operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws MergeOptionRequiredException * A merge option or stategy is required, and none was provided. * @throws InvalidMergeOptionException * The specified merge option is not valid for this operation. Not all merge strategies are supported for * all operations. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws CommitRequiredException * A commit was not specified. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidCommitException * The specified commit is not valid. * @throws 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 usinggit diff or a diff tool.
* @throws InvalidMaxConflictFilesException
* The specified value for the number of conflict files to return is not valid.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidDestinationCommitSpecifierException
* The destination commit specifier is not valid. You must provide a valid branch name, tag, or full commit
* ID.
* @throws InvalidSourceCommitSpecifierException
* The source commit specifier is not valid. You must provide a valid branch name, tag, or full commit ID.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.GetMergeConflicts
* @see AWS
* API Documentation
*/
GetMergeConflictsResult getMergeConflicts(GetMergeConflictsRequest getMergeConflictsRequest);
/**
* * Returns information about the merge options available for merging two specified branches. For details about why a * merge option is not available, use GetMergeConflicts or DescribeMergeConflicts. *
* * @param getMergeOptionsRequest * @return Result of the GetMergeOptions operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws CommitRequiredException * A commit was not specified. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidCommitException * The specified commit is not valid. * @throws 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 usinggit diff or a diff tool.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.GetMergeOptions
* @see AWS API
* Documentation
*/
GetMergeOptionsResult getMergeOptions(GetMergeOptionsRequest getMergeOptionsRequest);
/**
* * Gets information about a pull request in a specified repository. *
* * @param getPullRequestRequest * @return Result of the GetPullRequest operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetPullRequest * @see AWS API * Documentation */ GetPullRequestResult getPullRequest(GetPullRequestRequest getPullRequestRequest); /** ** Gets information about the approval states for a specified pull request. Approval states only apply to pull * requests that have one or more approval rules applied to them. *
* * @param getPullRequestApprovalStatesRequest * @return Result of the GetPullRequestApprovalStates operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws InvalidRevisionIdException * The revision ID is not valid. Use GetPullRequest to determine the value. * @throws RevisionIdRequiredException * A revision ID is required, but was not provided. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetPullRequestApprovalStates * @see AWS API Documentation */ GetPullRequestApprovalStatesResult getPullRequestApprovalStates(GetPullRequestApprovalStatesRequest getPullRequestApprovalStatesRequest); /** ** Returns information about whether approval rules have been set aside (overridden) for a pull request, and if so, * the Amazon Resource Name (ARN) of the user or identity that overrode the rules and their requirements for the * pull request. *
* * @param getPullRequestOverrideStateRequest * @return Result of the GetPullRequestOverrideState operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws InvalidRevisionIdException * The revision ID is not valid. Use GetPullRequest to determine the value. * @throws RevisionIdRequiredException * A revision ID is required, but was not provided. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetPullRequestOverrideState * @see AWS API Documentation */ GetPullRequestOverrideStateResult getPullRequestOverrideState(GetPullRequestOverrideStateRequest getPullRequestOverrideStateRequest); /** ** 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 webpage can 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 webpage. *
** This exception occurs only 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. *
* @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetRepository * @see AWS API * Documentation */ GetRepositoryResult getRepository(GetRepositoryRequest getRepositoryRequest); /** ** Gets information about triggers configured for a repository. *
* * @param getRepositoryTriggersRequest * Represents the input of a get repository triggers operation. * @return Result of the GetRepositoryTriggers operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.GetRepositoryTriggers * @see AWS API Documentation */ GetRepositoryTriggersResult getRepositoryTriggers(GetRepositoryTriggersRequest getRepositoryTriggersRequest); /** ** Lists all approval rule templates in the specified AWS Region in your AWS account. If an AWS Region is not * specified, the AWS Region where you are signed in is used. *
* * @param listApprovalRuleTemplatesRequest * @return Result of the ListApprovalRuleTemplates operation returned by the service. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @sample AWSCodeCommit.ListApprovalRuleTemplates * @see AWS API Documentation */ ListApprovalRuleTemplatesResult listApprovalRuleTemplates(ListApprovalRuleTemplatesRequest listApprovalRuleTemplatesRequest); /** ** Lists all approval rule templates that are associated with a specified repository. *
* * @param listAssociatedApprovalRuleTemplatesForRepositoryRequest * @return Result of the ListAssociatedApprovalRuleTemplatesForRepository operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.ListAssociatedApprovalRuleTemplatesForRepository * @see AWS API Documentation */ ListAssociatedApprovalRuleTemplatesForRepositoryResult listAssociatedApprovalRuleTemplatesForRepository( ListAssociatedApprovalRuleTemplatesForRepositoryRequest listAssociatedApprovalRuleTemplatesForRepositoryRequest); /** ** Gets information about one or more branches in a repository. *
* * @param listBranchesRequest * Represents the input of a list branches operation. * @return Result of the ListBranches operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @sample AWSCodeCommit.ListBranches * @see AWS API * Documentation */ ListBranchesResult listBranches(ListBranchesRequest listBranchesRequest); /** ** 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. *
* * @param listPullRequestsRequest * @return Result of the ListPullRequests operation returned by the service. * @throws InvalidPullRequestStatusException * The pull request status is not valid. The only valid values areOPEN and CLOSED
* .
* @throws 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.
* @throws AuthorDoesNotExistException
* The specified Amazon Resource Name (ARN) does not exist in the AWS account.
* @throws RepositoryNameRequiredException
* A repository name is required, but was not specified.
* @throws InvalidRepositoryNameException
* A specified repository name is not valid. * This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.ListPullRequests * @see AWS * API Documentation */ ListPullRequestsResult listPullRequests(ListPullRequestsRequest listPullRequestsRequest); /** ** Gets information about one or more repositories. *
* * @param listRepositoriesRequest * Represents the input of a list repositories operation. * @return Result of the ListRepositories operation returned by the service. * @throws InvalidSortByException * The specified sort by value is not valid. * @throws InvalidOrderException * The specified sort order is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @sample AWSCodeCommit.ListRepositories * @see AWS * API Documentation */ ListRepositoriesResult listRepositories(ListRepositoriesRequest listRepositoriesRequest); /** ** Lists all repositories associated with the specified approval rule template. *
* * @param listRepositoriesForApprovalRuleTemplateRequest * @return Result of the ListRepositoriesForApprovalRuleTemplate operation returned by the service. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @throws InvalidMaxResultsException * The specified number of maximum results is not valid. * @throws InvalidContinuationTokenException * The specified continuation token is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.ListRepositoriesForApprovalRuleTemplate * @see AWS API Documentation */ ListRepositoriesForApprovalRuleTemplateResult listRepositoriesForApprovalRuleTemplate( ListRepositoriesForApprovalRuleTemplateRequest listRepositoriesForApprovalRuleTemplateRequest); /** ** Gets information about AWS tags for a specified Amazon Resource Name (ARN) in AWS CodeCommit. For a list of valid * resources in AWS CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User Guide. *
* * @param listTagsForResourceRequest * @return Result of the ListTagsForResource operation returned by the service. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws ResourceArnRequiredException * A valid Amazon Resource Name (ARN) for an AWS CodeCommit resource is required. For a list of valid * resources in AWS CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User Guide. * @throws InvalidResourceArnException * The value for the resource ARN is not valid. For more information about resources in AWS CodeCommit, see * CodeCommit Resources and Operations in the AWS CodeCommit User Guide. * @sample AWSCodeCommit.ListTagsForResource * @see AWS * API Documentation */ ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest); /** ** Merges two branches using the fast-forward merge strategy. *
* * @param mergeBranchesByFastForwardRequest * @return Result of the MergeBranchesByFastForward operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws 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 usinggit diff or a diff tool.
* @throws CommitRequiredException
* A commit was not specified.
* @throws InvalidCommitException
* The specified commit is not valid.
* @throws CommitDoesNotExistException
* The specified commit does not exist or no commit was specified, and the specified repository has no
* default branch.
* @throws InvalidTargetBranchException
* The specified target branch is not valid.
* @throws InvalidBranchNameException
* The specified reference name is not valid.
* @throws BranchNameRequiredException
* A branch name is required, but was not specified.
* @throws BranchNameIsTagNameException
* The specified branch name is not valid because it is a tag name. Enter the name of a branch in the
* repository. For a list of valid branch names, use ListBranches.
* @throws BranchDoesNotExistException
* The specified branch does not exist.
* @throws ManualMergeRequiredException
* The pull request cannot be merged automatically into the destination branch. You must manually merge the
* branches and resolve any conflicts.
* @throws ConcurrentReferenceUpdateException
* The merge cannot be completed because the target branch has been modified. Another user might have
* modified the target branch while the merge was in progress. Wait a few minutes, and then try again.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.MergeBranchesByFastForward
* @see AWS API Documentation
*/
MergeBranchesByFastForwardResult mergeBranchesByFastForward(MergeBranchesByFastForwardRequest mergeBranchesByFastForwardRequest);
/**
* * Merges two branches using the squash merge strategy. *
* * @param mergeBranchesBySquashRequest * @return Result of the MergeBranchesBySquash operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws 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 usinggit diff or a diff tool.
* @throws CommitRequiredException
* A commit was not specified.
* @throws InvalidCommitException
* The specified commit is not valid.
* @throws CommitDoesNotExistException
* The specified commit does not exist or no commit was specified, and the specified repository has no
* default branch.
* @throws InvalidTargetBranchException
* The specified target branch is not valid.
* @throws InvalidBranchNameException
* The specified reference name is not valid.
* @throws BranchNameRequiredException
* A branch name is required, but was not specified.
* @throws BranchNameIsTagNameException
* The specified branch name is not valid because it is a tag name. Enter the name of a branch in the
* repository. For a list of valid branch names, use ListBranches.
* @throws BranchDoesNotExistException
* The specified branch does not exist.
* @throws ManualMergeRequiredException
* The pull request cannot be merged automatically into the destination branch. You must manually merge the
* branches and resolve any conflicts.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws InvalidConflictResolutionException
* The specified conflict resolution list is not valid.
* @throws MaximumConflictResolutionEntriesExceededException
* The number of allowed conflict resolution entries was exceeded.
* @throws MultipleConflictResolutionEntriesException
* More than one conflict resolution entries exists for the conflict. A conflict can have only one conflict
* resolution entry.
* @throws ReplacementTypeRequiredException
* A replacement type is required.
* @throws InvalidReplacementTypeException
* Automerge was specified for resolving the conflict, but the specified replacement type is not valid.
* @throws ReplacementContentRequiredException
* USE_NEW_CONTENT was specified, but no replacement content has been provided.
* @throws InvalidReplacementContentException
* Automerge was specified for resolving the conflict, but the replacement type is not valid or content is
* missing.
* @throws PathRequiredException
* The folderPath for a location cannot be null.
* @throws InvalidPathException
* The specified path is not valid.
* @throws FileContentSizeLimitExceededException
* The file cannot be added because it is too large. The maximum file size is 6 MB, and the combined file
* content change size is 7 MB. Consider making these changes using a Git client.
* @throws FolderContentSizeLimitExceededException
* The commit cannot be created because at least one of the overall changes in the commit results in a
* folder whose contents exceed the limit of 6 MB. Either reduce the number and size of your changes, or
* split the changes across multiple folders.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws FileModeRequiredException
* The commit cannot be created because no file mode has been specified. A file mode is required to update
* mode permissions for a file.
* @throws InvalidFileModeException
* The specified file mode permission is not valid. For a list of valid file mode permissions, see
* PutFile.
* @throws NameLengthExceededException
* The user name is not valid because it has exceeded the character limit for author names.
* @throws 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.
* @throws CommitMessageLengthExceededException
* The commit message is too long. Provide a shorter string.
* @throws ConcurrentReferenceUpdateException
* The merge cannot be completed because the target branch has been modified. Another user might have
* modified the target branch while the merge was in progress. Wait a few minutes, and then try again.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.MergeBranchesBySquash
* @see AWS API Documentation
*/
MergeBranchesBySquashResult mergeBranchesBySquash(MergeBranchesBySquashRequest mergeBranchesBySquashRequest);
/**
* * Merges two specified branches using the three-way merge strategy. *
* * @param mergeBranchesByThreeWayRequest * @return Result of the MergeBranchesByThreeWay operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws 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 usinggit diff or a diff tool.
* @throws CommitRequiredException
* A commit was not specified.
* @throws InvalidCommitException
* The specified commit is not valid.
* @throws CommitDoesNotExistException
* The specified commit does not exist or no commit was specified, and the specified repository has no
* default branch.
* @throws InvalidTargetBranchException
* The specified target branch is not valid.
* @throws InvalidBranchNameException
* The specified reference name is not valid.
* @throws BranchNameRequiredException
* A branch name is required, but was not specified.
* @throws BranchNameIsTagNameException
* The specified branch name is not valid because it is a tag name. Enter the name of a branch in the
* repository. For a list of valid branch names, use ListBranches.
* @throws BranchDoesNotExistException
* The specified branch does not exist.
* @throws ManualMergeRequiredException
* The pull request cannot be merged automatically into the destination branch. You must manually merge the
* branches and resolve any conflicts.
* @throws ConcurrentReferenceUpdateException
* The merge cannot be completed because the target branch has been modified. Another user might have
* modified the target branch while the merge was in progress. Wait a few minutes, and then try again.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws InvalidConflictResolutionException
* The specified conflict resolution list is not valid.
* @throws MaximumConflictResolutionEntriesExceededException
* The number of allowed conflict resolution entries was exceeded.
* @throws MultipleConflictResolutionEntriesException
* More than one conflict resolution entries exists for the conflict. A conflict can have only one conflict
* resolution entry.
* @throws ReplacementTypeRequiredException
* A replacement type is required.
* @throws InvalidReplacementTypeException
* Automerge was specified for resolving the conflict, but the specified replacement type is not valid.
* @throws ReplacementContentRequiredException
* USE_NEW_CONTENT was specified, but no replacement content has been provided.
* @throws InvalidReplacementContentException
* Automerge was specified for resolving the conflict, but the replacement type is not valid or content is
* missing.
* @throws PathRequiredException
* The folderPath for a location cannot be null.
* @throws InvalidPathException
* The specified path is not valid.
* @throws FileContentSizeLimitExceededException
* The file cannot be added because it is too large. The maximum file size is 6 MB, and the combined file
* content change size is 7 MB. Consider making these changes using a Git client.
* @throws FolderContentSizeLimitExceededException
* The commit cannot be created because at least one of the overall changes in the commit results in a
* folder whose contents exceed the limit of 6 MB. Either reduce the number and size of your changes, or
* split the changes across multiple folders.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws FileModeRequiredException
* The commit cannot be created because no file mode has been specified. A file mode is required to update
* mode permissions for a file.
* @throws InvalidFileModeException
* The specified file mode permission is not valid. For a list of valid file mode permissions, see
* PutFile.
* @throws NameLengthExceededException
* The user name is not valid because it has exceeded the character limit for author names.
* @throws 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.
* @throws CommitMessageLengthExceededException
* The commit message is too long. Provide a shorter string.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.MergeBranchesByThreeWay
* @see AWS API Documentation
*/
MergeBranchesByThreeWayResult mergeBranchesByThreeWay(MergeBranchesByThreeWayRequest mergeBranchesByThreeWayRequest);
/**
* * 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 strategy. If the merge is successful, it closes the pull * request. *
* * @param mergePullRequestByFastForwardRequest * @return Result of the MergePullRequestByFastForward operation returned by the service. * @throws ManualMergeRequiredException * The pull request cannot be merged automatically into the destination branch. You must manually merge the * branches and resolve any conflicts. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws 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. * @throws ReferenceDoesNotExistException * The specified reference does not exist. You must provide a full commit ID. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws RepositoryNotAssociatedWithPullRequestException * The repository does not contain any pull requests with that pull request ID. Use GetPullRequest to verify * the correct repository name for the pull request ID. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws ConcurrentReferenceUpdateException * The merge cannot be completed because the target branch has been modified. Another user might have * modified the target branch while the merge was in progress. Wait a few minutes, and then try again. * @throws PullRequestApprovalRulesNotSatisfiedException * The pull request cannot be merged because one or more approval rules applied to the pull request have * conditions that have not been met. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.MergePullRequestByFastForward * @see AWS API Documentation */ MergePullRequestByFastForwardResult mergePullRequestByFastForward(MergePullRequestByFastForwardRequest mergePullRequestByFastForwardRequest); /** ** 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 squash merge strategy. If the merge is successful, it closes the pull request. *
* * @param mergePullRequestBySquashRequest * @return Result of the MergePullRequestBySquash operation returned by the service. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws 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. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws ManualMergeRequiredException * The pull request cannot be merged automatically into the destination branch. You must manually merge the * branches and resolve any conflicts. * @throws 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. * @throws 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 usinggit diff or a diff tool.
* @throws NameLengthExceededException
* The user name is not valid because it has exceeded the character limit for author names.
* @throws 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.
* @throws CommitMessageLengthExceededException
* The commit message is too long. Provide a shorter string.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws InvalidConflictResolutionException
* The specified conflict resolution list is not valid.
* @throws ReplacementTypeRequiredException
* A replacement type is required.
* @throws InvalidReplacementTypeException
* Automerge was specified for resolving the conflict, but the specified replacement type is not valid.
* @throws MultipleConflictResolutionEntriesException
* More than one conflict resolution entries exists for the conflict. A conflict can have only one conflict
* resolution entry.
* @throws ReplacementContentRequiredException
* USE_NEW_CONTENT was specified, but no replacement content has been provided.
* @throws MaximumConflictResolutionEntriesExceededException
* The number of allowed conflict resolution entries was exceeded.
* @throws ConcurrentReferenceUpdateException
* The merge cannot be completed because the target branch has been modified. Another user might have
* modified the target branch while the merge was in progress. Wait a few minutes, and then try again.
* @throws PathRequiredException
* The folderPath for a location cannot be null.
* @throws InvalidPathException
* The specified path is not valid.
* @throws InvalidFileModeException
* The specified file mode permission is not valid. For a list of valid file mode permissions, see
* PutFile.
* @throws InvalidReplacementContentException
* Automerge was specified for resolving the conflict, but the replacement type is not valid or content is
* missing.
* @throws FileContentSizeLimitExceededException
* The file cannot be added because it is too large. The maximum file size is 6 MB, and the combined file
* content change size is 7 MB. Consider making these changes using a Git client.
* @throws FolderContentSizeLimitExceededException
* The commit cannot be created because at least one of the overall changes in the commit results in a
* folder whose contents exceed the limit of 6 MB. Either reduce the number and size of your changes, or
* split the changes across multiple folders.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws RepositoryNameRequiredException
* A repository name is required, but was not specified.
* @throws InvalidRepositoryNameException
* A specified repository name is not valid. * This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws RepositoryNotAssociatedWithPullRequestException * The repository does not contain any pull requests with that pull request ID. Use GetPullRequest to verify * the correct repository name for the pull request ID. * @throws PullRequestApprovalRulesNotSatisfiedException * The pull request cannot be merged because one or more approval rules applied to the pull request have * conditions that have not been met. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.MergePullRequestBySquash * @see AWS API Documentation */ MergePullRequestBySquashResult mergePullRequestBySquash(MergePullRequestBySquashRequest mergePullRequestBySquashRequest); /** ** 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 three-way merge strategy. If the merge is successful, it closes the pull * request. *
* * @param mergePullRequestByThreeWayRequest * @return Result of the MergePullRequestByThreeWay operation returned by the service. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws 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. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws ManualMergeRequiredException * The pull request cannot be merged automatically into the destination branch. You must manually merge the * branches and resolve any conflicts. * @throws 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. * @throws 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 usinggit diff or a diff tool.
* @throws NameLengthExceededException
* The user name is not valid because it has exceeded the character limit for author names.
* @throws 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.
* @throws CommitMessageLengthExceededException
* The commit message is too long. Provide a shorter string.
* @throws InvalidConflictDetailLevelException
* The specified conflict detail level is not valid.
* @throws InvalidConflictResolutionStrategyException
* The specified conflict resolution strategy is not valid.
* @throws InvalidConflictResolutionException
* The specified conflict resolution list is not valid.
* @throws ReplacementTypeRequiredException
* A replacement type is required.
* @throws InvalidReplacementTypeException
* Automerge was specified for resolving the conflict, but the specified replacement type is not valid.
* @throws MultipleConflictResolutionEntriesException
* More than one conflict resolution entries exists for the conflict. A conflict can have only one conflict
* resolution entry.
* @throws ReplacementContentRequiredException
* USE_NEW_CONTENT was specified, but no replacement content has been provided.
* @throws MaximumConflictResolutionEntriesExceededException
* The number of allowed conflict resolution entries was exceeded.
* @throws PathRequiredException
* The folderPath for a location cannot be null.
* @throws InvalidPathException
* The specified path is not valid.
* @throws InvalidFileModeException
* The specified file mode permission is not valid. For a list of valid file mode permissions, see
* PutFile.
* @throws InvalidReplacementContentException
* Automerge was specified for resolving the conflict, but the replacement type is not valid or content is
* missing.
* @throws FileContentSizeLimitExceededException
* The file cannot be added because it is too large. The maximum file size is 6 MB, and the combined file
* content change size is 7 MB. Consider making these changes using a Git client.
* @throws FolderContentSizeLimitExceededException
* The commit cannot be created because at least one of the overall changes in the commit results in a
* folder whose contents exceed the limit of 6 MB. Either reduce the number and size of your changes, or
* split the changes across multiple folders.
* @throws MaximumFileContentToLoadExceededException
* The number of files to load exceeds the allowed limit.
* @throws MaximumItemsToCompareExceededException
* The number of items to compare between the source or destination branches and the merge base has exceeded
* the maximum allowed.
* @throws RepositoryNameRequiredException
* A repository name is required, but was not specified.
* @throws InvalidRepositoryNameException
* A specified repository name is not valid. * This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws RepositoryNotAssociatedWithPullRequestException * The repository does not contain any pull requests with that pull request ID. Use GetPullRequest to verify * the correct repository name for the pull request ID. * @throws ConcurrentReferenceUpdateException * The merge cannot be completed because the target branch has been modified. Another user might have * modified the target branch while the merge was in progress. Wait a few minutes, and then try again. * @throws PullRequestApprovalRulesNotSatisfiedException * The pull request cannot be merged because one or more approval rules applied to the pull request have * conditions that have not been met. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.MergePullRequestByThreeWay * @see AWS API Documentation */ MergePullRequestByThreeWayResult mergePullRequestByThreeWay(MergePullRequestByThreeWayRequest mergePullRequestByThreeWayRequest); /** ** Sets aside (overrides) all approval rule requirements for a specified pull request. *
* * @param overridePullRequestApprovalRulesRequest * @return Result of the OverridePullRequestApprovalRules operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws InvalidRevisionIdException * The revision ID is not valid. Use GetPullRequest to determine the value. * @throws RevisionIdRequiredException * A revision ID is required, but was not provided. * @throws InvalidOverrideStatusException * The override status is not valid. Valid statuses are OVERRIDE and REVOKE. * @throws OverrideStatusRequiredException * An override status is required, but no value was provided. Valid values include OVERRIDE and REVOKE. * @throws OverrideAlreadySetException * The pull request has already had its approval rules set to override. * @throws RevisionNotCurrentException * The revision ID provided in the request does not match the current revision ID. Use GetPullRequest to * retrieve the current revision ID. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.OverridePullRequestApprovalRules * @see AWS API Documentation */ OverridePullRequestApprovalRulesResult overridePullRequestApprovalRules(OverridePullRequestApprovalRulesRequest overridePullRequestApprovalRulesRequest); /** ** Posts a comment on the comparison between two commits. *
* * @param postCommentForComparedCommitRequest * @return Result of the PostCommentForComparedCommit operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws 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 returns * information about the initial request that used that token. * @throws InvalidClientRequestTokenException * The client request token is not valid. * @throws 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 reused. * @throws CommentContentRequiredException * The comment is empty. You must provide some content for a comment. The content cannot be null. * @throws CommentContentSizeLimitExceededException * The comment is too large. Comments are limited to 1,000 characters. * @throws InvalidFileLocationException * The location of the file is not valid. Make sure that you include the file name and extension. * @throws 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. * @throws PathRequiredException * The folderPath for a location cannot be null. * @throws InvalidFilePositionException * The position is not valid. Make sure that the line number exists in the version of the file you want to * comment on. * @throws CommitIdRequiredException * A commit ID was not specified. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws 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. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidPathException * The specified path is not valid. * @throws PathDoesNotExistException * The specified path does not exist. * @throws PathRequiredException * The folderPath for a location cannot be null. * @sample AWSCodeCommit.PostCommentForComparedCommit * @see AWS API Documentation */ PostCommentForComparedCommitResult postCommentForComparedCommit(PostCommentForComparedCommitRequest postCommentForComparedCommitRequest); /** ** Posts a comment on a pull request. *
* * @param postCommentForPullRequestRequest * @return Result of the PostCommentForPullRequest operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws RepositoryNotAssociatedWithPullRequestException * The repository does not contain any pull requests with that pull request ID. Use GetPullRequest to verify * the correct repository name for the pull request ID. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws 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 returns * information about the initial request that used that token. * @throws InvalidClientRequestTokenException * The client request token is not valid. * @throws 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 reused. * @throws CommentContentRequiredException * The comment is empty. You must provide some content for a comment. The content cannot be null. * @throws CommentContentSizeLimitExceededException * The comment is too large. Comments are limited to 1,000 characters. * @throws InvalidFileLocationException * The location of the file is not valid. Make sure that you include the file name and extension. * @throws 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. * @throws PathRequiredException * The folderPath for a location cannot be null. * @throws InvalidFilePositionException * The position is not valid. Make sure that the line number exists in the version of the file you want to * comment on. * @throws CommitIdRequiredException * A commit ID was not specified. * @throws InvalidCommitIdException * The specified commit ID is not valid. * @throws 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. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws CommitDoesNotExistException * The specified commit does not exist or no commit was specified, and the specified repository has no * default branch. * @throws InvalidPathException * The specified path is not valid. * @throws PathDoesNotExistException * The specified path does not exist. * @throws PathRequiredException * The folderPath for a location cannot be null. * @sample AWSCodeCommit.PostCommentForPullRequest * @see AWS API Documentation */ PostCommentForPullRequestResult postCommentForPullRequest(PostCommentForPullRequestRequest postCommentForPullRequestRequest); /** ** Posts a comment in reply to an existing comment on a comparison between commits or a pull request. *
* * @param postCommentReplyRequest * @return Result of the PostCommentReply operation returned by the service. * @throws 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 returns * information about the initial request that used that token. * @throws InvalidClientRequestTokenException * The client request token is not valid. * @throws 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 reused. * @throws CommentContentRequiredException * The comment is empty. You must provide some content for a comment. The content cannot be null. * @throws CommentContentSizeLimitExceededException * The comment is too large. Comments are limited to 1,000 characters. * @throws CommentDoesNotExistException * No comment exists with the provided ID. Verify that you have used the correct ID, and then try again. * @throws CommentIdRequiredException * The comment ID is missing or null. A comment ID is required. * @throws InvalidCommentIdException * The comment ID is not in a valid format. Make sure that you have provided the full comment ID. * @sample AWSCodeCommit.PostCommentReply * @see AWS * API Documentation */ PostCommentReplyResult postCommentReply(PostCommentReplyRequest postCommentReplyRequest); /** ** Adds or updates a reaction to a specified comment for the user whose identity is used to make the request. You * can only add or update a reaction for yourself. You cannot add, modify, or delete a reaction for another user. *
* * @param putCommentReactionRequest * @return Result of the PutCommentReaction operation returned by the service. * @throws CommentDoesNotExistException * No comment exists with the provided ID. Verify that you have used the correct ID, and then try again. * @throws CommentIdRequiredException * The comment ID is missing or null. A comment ID is required. * @throws InvalidCommentIdException * The comment ID is not in a valid format. Make sure that you have provided the full comment ID. * @throws InvalidReactionValueException * The value of the reaction is not valid. For more information, see the AWS CodeCommit User * Guide. * @throws ReactionValueRequiredException * A reaction value is required. * @throws ReactionLimitExceededException * The number of reactions has been exceeded. Reactions are limited to one reaction per user for each * individual comment ID. * @throws CommentDeletedException * This comment has already been deleted. You cannot edit or delete a deleted comment. * @sample AWSCodeCommit.PutCommentReaction * @see AWS * API Documentation */ PutCommentReactionResult putCommentReaction(PutCommentReactionRequest putCommentReactionRequest); /** ** Adds or updates a file in a branch in an AWS CodeCommit repository, and generates a commit for the addition in * the specified branch. *
* * @param putFileRequest * @return Result of the PutFile operation returned by the service. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws 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). * @throws 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. * @throws 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. * @throws 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. * @throws FileContentRequiredException * The file cannot be added because it is empty. Empty files cannot be added to the repository with this * API. * @throws FileContentSizeLimitExceededException * The file cannot be added because it is too large. The maximum file size is 6 MB, and the combined file * content change size is 7 MB. Consider making these changes using a Git client. * @throws FolderContentSizeLimitExceededException * The commit cannot be created because at least one of the overall changes in the commit results in a * folder whose contents exceed the limit of 6 MB. Either reduce the number and size of your changes, or * split the changes across multiple folders. * @throws PathRequiredException * The folderPath for a location cannot be null. * @throws InvalidPathException * The specified path is not valid. * @throws BranchNameRequiredException * A branch name is required, but was not specified. * @throws InvalidBranchNameException * The specified reference name is not valid. * @throws BranchDoesNotExistException * The specified branch does not exist. * @throws BranchNameIsTagNameException * The specified branch name is not valid because it is a tag name. Enter the name of a branch in the * repository. For a list of valid branch names, use ListBranches. * @throws InvalidFileModeException * The specified file mode permission is not valid. For a list of valid file mode permissions, see * PutFile. * @throws NameLengthExceededException * The user name is not valid because it has exceeded the character limit for author names. * @throws 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. * @throws CommitMessageLengthExceededException * The commit message is too long. Provide a shorter string. * @throws InvalidDeletionParameterException * The specified deletion parameter is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @throws 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. * @throws 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. * @throws 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. * @throws FilePathConflictsWithSubmodulePathException * The commit cannot be created because a specified file path points to a submodule. Verify that the * destination files have valid file paths that do not point to a submodule. * @sample AWSCodeCommit.PutFile * @see AWS API * Documentation */ PutFileResult putFile(PutFileRequest putFileRequest); /** ** Replaces all triggers for a repository. Used to create or delete triggers. *
* * @param putRepositoryTriggersRequest * Represents the input of a put repository triggers operation. * @return Result of the PutRepositoryTriggers operation returned by the service. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryTriggersListRequiredException * The list of triggers for the repository is required, but was not specified. * @throws MaximumRepositoryTriggersExceededException * The number of triggers allowed for the repository was exceeded. * @throws InvalidRepositoryTriggerNameException * The name of the trigger is not valid. * @throws 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. * @throws InvalidRepositoryTriggerRegionException * The AWS Region for the trigger target does not match the AWS Region for the repository. Triggers must be * created in the same Region as the target for the trigger. * @throws InvalidRepositoryTriggerCustomDataException * The custom data provided for the trigger is not valid. * @throws MaximumBranchesExceededException * The number of branches for the trigger was exceeded. * @throws InvalidRepositoryTriggerBranchNameException * One or more branch names specified for the trigger is not valid. * @throws 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. * @throws RepositoryTriggerNameRequiredException * A name for the trigger is required, but was not specified. * @throws RepositoryTriggerDestinationArnRequiredException * A destination ARN for the target service for the trigger is required, but was not specified. * @throws RepositoryTriggerBranchNameListRequiredException * At least one branch name is required, but was not specified in the trigger configuration. * @throws RepositoryTriggerEventsListRequiredException * At least one event for the trigger is required, but was not specified. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.PutRepositoryTriggers * @see AWS API Documentation */ PutRepositoryTriggersResult putRepositoryTriggers(PutRepositoryTriggersRequest putRepositoryTriggersRequest); /** ** Adds or updates tags for a resource in AWS CodeCommit. For a list of valid resources in AWS CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User Guide. *
* * @param tagResourceRequest * @return Result of the TagResource operation returned by the service. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws ResourceArnRequiredException * A valid Amazon Resource Name (ARN) for an AWS CodeCommit resource is required. For a list of valid * resources in AWS CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User Guide. * @throws InvalidResourceArnException * The value for the resource ARN is not valid. For more information about resources in AWS CodeCommit, see * CodeCommit Resources and Operations in the AWS CodeCommit User Guide. * @throws TagsMapRequiredException * A map of tags is required. * @throws InvalidTagsMapException * The map of tags is not valid. * @throws TooManyTagsException * The maximum number of tags for an AWS CodeCommit resource has been exceeded. * @throws InvalidSystemTagUsageException * The specified tag is not valid. Key names cannot be prefixed with aws:. * @throws TagPolicyException * The tag policy is not valid. * @sample AWSCodeCommit.TagResource * @see AWS API * Documentation */ TagResourceResult tagResource(TagResourceRequest tagResourceRequest); /** ** Tests the functionality of repository triggers by sending information to the trigger target. If real data is * available in the repository, the test sends data from the last commit. If no data is available, sample data is * generated. *
* * @param testRepositoryTriggersRequest * Represents the input of a test repository triggers operation. * @return Result of the TestRepositoryTriggers operation returned by the service. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws RepositoryTriggersListRequiredException * The list of triggers for the repository is required, but was not specified. * @throws MaximumRepositoryTriggersExceededException * The number of triggers allowed for the repository was exceeded. * @throws InvalidRepositoryTriggerNameException * The name of the trigger is not valid. * @throws 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. * @throws InvalidRepositoryTriggerRegionException * The AWS Region for the trigger target does not match the AWS Region for the repository. Triggers must be * created in the same Region as the target for the trigger. * @throws InvalidRepositoryTriggerCustomDataException * The custom data provided for the trigger is not valid. * @throws MaximumBranchesExceededException * The number of branches for the trigger was exceeded. * @throws InvalidRepositoryTriggerBranchNameException * One or more branch names specified for the trigger is not valid. * @throws 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. * @throws RepositoryTriggerNameRequiredException * A name for the trigger is required, but was not specified. * @throws RepositoryTriggerDestinationArnRequiredException * A destination ARN for the target service for the trigger is required, but was not specified. * @throws RepositoryTriggerBranchNameListRequiredException * At least one branch name is required, but was not specified in the trigger configuration. * @throws RepositoryTriggerEventsListRequiredException * At least one event for the trigger is required, but was not specified. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.TestRepositoryTriggers * @see AWS API Documentation */ TestRepositoryTriggersResult testRepositoryTriggers(TestRepositoryTriggersRequest testRepositoryTriggersRequest); /** ** Removes tags for a resource in AWS CodeCommit. For a list of valid resources in AWS CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User Guide. *
* * @param untagResourceRequest * @return Result of the UntagResource operation returned by the service. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @throws ResourceArnRequiredException * A valid Amazon Resource Name (ARN) for an AWS CodeCommit resource is required. For a list of valid * resources in AWS CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User Guide. * @throws InvalidResourceArnException * The value for the resource ARN is not valid. For more information about resources in AWS CodeCommit, see * CodeCommit Resources and Operations in the AWS CodeCommit User Guide. * @throws TagKeysListRequiredException * A list of tag keys is required. The list cannot be empty or null. * @throws InvalidTagKeysListException * The list of tags is not valid. * @throws TooManyTagsException * The maximum number of tags for an AWS CodeCommit resource has been exceeded. * @throws InvalidSystemTagUsageException * The specified tag is not valid. Key names cannot be prefixed with aws:. * @throws TagPolicyException * The tag policy is not valid. * @sample AWSCodeCommit.UntagResource * @see AWS API * Documentation */ UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest); /** ** Updates the content of an approval rule template. You can change the number of required approvals, the membership * of the approval rule, and whether an approval pool is defined. *
* * @param updateApprovalRuleTemplateContentRequest * @return Result of the UpdateApprovalRuleTemplateContent operation returned by the service. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @throws InvalidApprovalRuleTemplateContentException * The content of the approval rule template is not valid. * @throws InvalidRuleContentSha256Exception * The SHA-256 hash signature for the rule content is not valid. * @throws ApprovalRuleTemplateContentRequiredException * The content for the approval rule template is empty. You must provide some content for an approval rule * template. The content cannot be null. * @sample AWSCodeCommit.UpdateApprovalRuleTemplateContent * @see AWS API Documentation */ UpdateApprovalRuleTemplateContentResult updateApprovalRuleTemplateContent(UpdateApprovalRuleTemplateContentRequest updateApprovalRuleTemplateContentRequest); /** ** Updates the description for a specified approval rule template. *
* * @param updateApprovalRuleTemplateDescriptionRequest * @return Result of the UpdateApprovalRuleTemplateDescription operation returned by the service. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @throws InvalidApprovalRuleTemplateDescriptionException * The description for the approval rule template is not valid because it exceeds the maximum characters * allowed for a description. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @sample AWSCodeCommit.UpdateApprovalRuleTemplateDescription * @see AWS API Documentation */ UpdateApprovalRuleTemplateDescriptionResult updateApprovalRuleTemplateDescription( UpdateApprovalRuleTemplateDescriptionRequest updateApprovalRuleTemplateDescriptionRequest); /** ** Updates the name of a specified approval rule template. *
* * @param updateApprovalRuleTemplateNameRequest * @return Result of the UpdateApprovalRuleTemplateName operation returned by the service. * @throws InvalidApprovalRuleTemplateNameException * The name of the approval rule template is not valid. Template names must be between 1 and 100 valid * characters in length. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide. * @throws ApprovalRuleTemplateNameRequiredException * An approval rule template name is required, but was not specified. * @throws ApprovalRuleTemplateDoesNotExistException * The specified approval rule template does not exist. Verify that the name is correct and that you are * signed in to the AWS Region where the template was created, and then try again. * @throws ApprovalRuleTemplateNameAlreadyExistsException * You cannot create an approval rule template with that name because a template with that name already * exists in this AWS Region for your AWS account. Approval rule template names must be unique. * @sample AWSCodeCommit.UpdateApprovalRuleTemplateName * @see AWS API Documentation */ UpdateApprovalRuleTemplateNameResult updateApprovalRuleTemplateName(UpdateApprovalRuleTemplateNameRequest updateApprovalRuleTemplateNameRequest); /** ** Replaces the contents of a comment. *
* * @param updateCommentRequest * @return Result of the UpdateComment operation returned by the service. * @throws CommentContentRequiredException * The comment is empty. You must provide some content for a comment. The content cannot be null. * @throws CommentContentSizeLimitExceededException * The comment is too large. Comments are limited to 1,000 characters. * @throws CommentDoesNotExistException * No comment exists with the provided ID. Verify that you have used the correct ID, and then try again. * @throws CommentIdRequiredException * The comment ID is missing or null. A comment ID is required. * @throws InvalidCommentIdException * The comment ID is not in a valid format. Make sure that you have provided the full comment ID. * @throws CommentNotCreatedByCallerException * You cannot modify or delete this comment. Only comment authors can modify or delete their comments. * @throws CommentDeletedException * This comment has already been deleted. You cannot edit or delete a deleted comment. * @sample AWSCodeCommit.UpdateComment * @see AWS API * Documentation */ UpdateCommentResult updateComment(UpdateCommentRequest updateCommentRequest); /** ** 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. *
** This exception occurs only 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. *
* @throws BranchNameRequiredException * A branch name is required, but was not specified. * @throws InvalidBranchNameException * The specified reference name is not valid. * @throws BranchDoesNotExistException * The specified branch does not exist. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.UpdateDefaultBranch * @see AWS * API Documentation */ UpdateDefaultBranchResult updateDefaultBranch(UpdateDefaultBranchRequest updateDefaultBranchRequest); /** ** Updates the structure of an approval rule created specifically for a pull request. For example, you can change * the number of required approvers and the approval pool for approvers. *
* * @param updatePullRequestApprovalRuleContentRequest * @return Result of the UpdatePullRequestApprovalRuleContent operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @throws ApprovalRuleNameRequiredException * An approval rule name is required, but was not specified. * @throws InvalidApprovalRuleNameException * The name for the approval rule is not valid. * @throws ApprovalRuleDoesNotExistException * The specified approval rule does not exist. * @throws InvalidRuleContentSha256Exception * The SHA-256 hash signature for the rule content is not valid. * @throws ApprovalRuleContentRequiredException * The content for the approval rule is empty. You must provide some content for an approval rule. The * content cannot be null. * @throws InvalidApprovalRuleContentException * The content for the approval rule is not valid. * @throws CannotModifyApprovalRuleFromTemplateException * The approval rule cannot be modified for the pull request because it was created by an approval rule * template and applied to the pull request automatically. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.UpdatePullRequestApprovalRuleContent * @see AWS API Documentation */ UpdatePullRequestApprovalRuleContentResult updatePullRequestApprovalRuleContent( UpdatePullRequestApprovalRuleContentRequest updatePullRequestApprovalRuleContentRequest); /** ** Updates the state of a user's approval on a pull request. The user is derived from the signed-in account when the * request is made. *
* * @param updatePullRequestApprovalStateRequest * @return Result of the UpdatePullRequestApprovalState operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws InvalidRevisionIdException * The revision ID is not valid. Use GetPullRequest to determine the value. * @throws RevisionIdRequiredException * A revision ID is required, but was not provided. * @throws InvalidApprovalStateException * The state for the approval is not valid. Valid values include APPROVE and REVOKE. * @throws ApprovalStateRequiredException * An approval state is required, but was not specified. * @throws PullRequestCannotBeApprovedByAuthorException * The approval cannot be applied because the user approving the pull request matches the user who created * the pull request. You cannot approve a pull request that you created. * @throws RevisionNotCurrentException * The revision ID provided in the request does not match the current revision ID. Use GetPullRequest to * retrieve the current revision ID. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @throws MaximumNumberOfApprovalsExceededException * The number of approvals required for the approval rule exceeds the maximum number allowed. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.UpdatePullRequestApprovalState * @see AWS API Documentation */ UpdatePullRequestApprovalStateResult updatePullRequestApprovalState(UpdatePullRequestApprovalStateRequest updatePullRequestApprovalStateRequest); /** ** Replaces the contents of the description of a pull request. *
* * @param updatePullRequestDescriptionRequest * @return Result of the UpdatePullRequestDescription operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws InvalidDescriptionException * The pull request description is not valid. Descriptions cannot be more than 1,000 characters. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @sample AWSCodeCommit.UpdatePullRequestDescription * @see AWS API Documentation */ UpdatePullRequestDescriptionResult updatePullRequestDescription(UpdatePullRequestDescriptionRequest updatePullRequestDescriptionRequest); /** ** Updates the status of a pull request. *
* * @param updatePullRequestStatusRequest * @return Result of the UpdatePullRequestStatus operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws InvalidPullRequestStatusUpdateException * The pull request status update is not valid. The only valid update is fromOPEN to
* CLOSED.
* @throws InvalidPullRequestStatusException
* The pull request status is not valid. The only valid values are OPEN and CLOSED
* .
* @throws PullRequestStatusRequiredException
* A pull request status is required, but none was provided.
* @throws EncryptionIntegrityChecksFailedException
* An encryption integrity check failed.
* @throws EncryptionKeyAccessDeniedException
* An encryption key could not be accessed.
* @throws EncryptionKeyDisabledException
* The encryption key is disabled.
* @throws EncryptionKeyNotFoundException
* No encryption key was found.
* @throws EncryptionKeyUnavailableException
* The encryption key is not available.
* @sample AWSCodeCommit.UpdatePullRequestStatus
* @see AWS API Documentation
*/
UpdatePullRequestStatusResult updatePullRequestStatus(UpdatePullRequestStatusRequest updatePullRequestStatusRequest);
/**
* * Replaces the title of a pull request. *
* * @param updatePullRequestTitleRequest * @return Result of the UpdatePullRequestTitle operation returned by the service. * @throws 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. * @throws 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. * @throws PullRequestIdRequiredException * A pull request ID is required, but none was provided. * @throws TitleRequiredException * A pull request title is required. It cannot be empty or null. * @throws InvalidTitleException * The title of the pull request is not valid. Pull request titles cannot exceed 100 characters in length. * @throws PullRequestAlreadyClosedException * The pull request status cannot be updated because it is already closed. * @sample AWSCodeCommit.UpdatePullRequestTitle * @see AWS API Documentation */ UpdatePullRequestTitleResult updatePullRequestTitle(UpdatePullRequestTitleRequest updatePullRequestTitleRequest); /** ** 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 webpage can 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 webpage. *
** This exception occurs only 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. *
* @throws InvalidRepositoryDescriptionException * The specified repository description is not valid. * @throws EncryptionIntegrityChecksFailedException * An encryption integrity check failed. * @throws EncryptionKeyAccessDeniedException * An encryption key could not be accessed. * @throws EncryptionKeyDisabledException * The encryption key is disabled. * @throws EncryptionKeyNotFoundException * No encryption key was found. * @throws EncryptionKeyUnavailableException * The encryption key is not available. * @sample AWSCodeCommit.UpdateRepositoryDescription * @see AWS API Documentation */ UpdateRepositoryDescriptionResult updateRepositoryDescription(UpdateRepositoryDescriptionRequest updateRepositoryDescriptionRequest); /** ** Renames a repository. The repository name must be unique across the calling AWS account. Repository names are * limited to 100 alphanumeric, dash, and underscore characters, and cannot include certain characters. The suffix * .git is prohibited. For more information about the limits on repository names, see Limits in the AWS CodeCommit User * Guide. *
* * @param updateRepositoryNameRequest * Represents the input of an update repository description operation. * @return Result of the UpdateRepositoryName operation returned by the service. * @throws RepositoryDoesNotExistException * The specified repository does not exist. * @throws RepositoryNameExistsException * The specified repository name already exists. * @throws RepositoryNameRequiredException * A repository name is required, but was not specified. * @throws InvalidRepositoryNameException * A specified repository name is not valid.* This exception occurs only 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. *
* @sample AWSCodeCommit.UpdateRepositoryName * @see AWS API Documentation */ UpdateRepositoryNameResult updateRepositoryName(UpdateRepositoryNameRequest updateRepositoryNameRequest); /** * Shuts down this client object, releasing any resources that might be held open. This is an optional method, and * callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client * has been shutdown, it should not be used to make any more requests. */ void shutdown(); /** * Returns additional metadata for a previously executed successful request, typically used for debugging issues * where a service isn't acting as expected. This data isn't considered part of the result data returned by an * operation, so it's available through this separate, diagnostic interface. ** 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. * * @param request * The originally executed request. * * @return The response metadata for the specified request, or null if none is available. */ ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request); }