[ aws ]

codecommit

Description

This is the CodeCommit API Reference . This reference provides descriptions of the operations and data types for CodeCommit API along with usage examples.

You can use the 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 Amazon Web Services account.
  • CreateRepository , which creates an CodeCommit repository.
  • DeleteRepository , which deletes an CodeCommit repository.
  • GetRepository , which returns information about a specified repository.
  • ListRepositories , which lists all CodeCommit repositories associated with your Amazon Web Services account.
  • UpdateRepositoryDescription , which sets or updates the description of the repository.
  • UpdateRepositoryEncryptionKey , which updates the Key Management Service encryption key used to encrypt and decrypt a 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.
  • ListFileCommitHistory , which retrieves a list of commits and changes to a specified file.
  • 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, 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, 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 Amazon Web Services 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 Amazon Web Services Region in your Amazon Web Services 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 CodeCommit (not Git tags), by calling the following:

  • ListTagsForResource , which gets information about Amazon Web Servicestags for a specified Amazon Resource Name (ARN) in CodeCommit.
  • TagResource , which adds or updates tags for a resource in CodeCommit.
  • UntagResource , which removes tags for a resource in 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 CodeCommit, see the CodeCommit User Guide .

Available Commands