AWS CodeCommit

Creates a commit for a repository on the tip of a specified branch.

See also: AWS API Documentation

Request Syntax

client.create_commit(
    repositoryName='string',
    branchName='string',
    parentCommitId='string',
    authorName='string',
    email='string',
    commitMessage='string',
    keepEmptyFolders=True|False,
    putFiles=[
        {
            'filePath': 'string',
            'fileMode': 'EXECUTABLE'|'NORMAL'|'SYMLINK',
            'fileContent': b'bytes',
            'sourceFile': {
                'filePath': 'string',
                'isMove': True|False
            }
        },
    ],
    deleteFiles=[
        {
            'filePath': 'string'
        },
    ],
    setFileModes=[
        {
            'filePath': 'string',
            'fileMode': 'EXECUTABLE'|'NORMAL'|'SYMLINK'
        },
    ]
)

type repositoryName

string

param repositoryName

[REQUIRED]

The name of the repository where you will create the commit.

type branchName

string

param branchName

[REQUIRED]

The name of the branch where you will create the commit.

type parentCommitId

string

param parentCommitId

The ID of the commit that is the parent of the commit you will create. If this is an empty repository, this is not required.

type authorName

string

param authorName

The name of the author who created the commit. This information will be used as both the author and committer for the commit.

type email

string

param email

The email address of the person who created the commit.

type commitMessage

string

param commitMessage

The commit message you want to include as part of creating the commit. Commit messages are limited to 256 KB. If no message is specified, a default message will be used.

type keepEmptyFolders

boolean

param keepEmptyFolders

If the commit contains deletions, whether to keep a folder or folder structure if the changes leave the folders empty. If this is specified as true, a .gitkeep file will be created for empty folders.

type putFiles

list

param putFiles

The files to add or update in this commit.

• (dict) --

  Information about a file that will be added or updated as part of a commit.

  • filePath (string) -- [REQUIRED]

    The full path to the file in the repository, including the name of the file.

  • fileMode (string) --

    The extrapolated file mode permissions for the file. Valid values include EXECUTABLE and NORMAL.

  • fileContent (bytes) --

    The content of the file, if a source file is not specified.

  • sourceFile (dict) --

    The name and full path of the file that contains the changes you want to make as part of the commit, if you are not providing the file content directly.

    • filePath (string) -- [REQUIRED]

      The full path to the file, including the name of the file.

    • isMove (boolean) --

      Whether to remove the source file from the parent commit.

type deleteFiles

list

param deleteFiles

The files to delete in this commit. These files will still exist in prior commits.

• (dict) --

  A file that will be deleted as part of a commit.

  • filePath (string) -- [REQUIRED]

    The full path of the file that will be deleted, including the name of the file.

type setFileModes

list

param setFileModes

The file modes to update for files in this commit.

• (dict) --

  Information about the file mode changes.

  • filePath (string) -- [REQUIRED]

    The full path to the file, including the name of the file.

  • fileMode (string) -- [REQUIRED]

    The file mode for the file.

rtype

dict

returns

Response Syntax

{
    'commitId': 'string',
    'treeId': 'string',
    'filesAdded': [
        {
            'absolutePath': 'string',
            'blobId': 'string',
            'fileMode': 'EXECUTABLE'|'NORMAL'|'SYMLINK'
        },
    ],
    'filesUpdated': [
        {
            'absolutePath': 'string',
            'blobId': 'string',
            'fileMode': 'EXECUTABLE'|'NORMAL'|'SYMLINK'
        },
    ],
    'filesDeleted': [
        {
            'absolutePath': 'string',
            'blobId': 'string',
            'fileMode': 'EXECUTABLE'|'NORMAL'|'SYMLINK'
        },
    ]
}

Response Structure

• (dict) --

  • commitId (string) --

    The full commit ID of the commit that contains your committed file changes.

  • treeId (string) --

    The full SHA-1 pointer of the tree information for the commit that contains the commited file changes.

  • filesAdded (list) --

    The files added as part of the committed file changes.

    • (dict) --

      A file that will be added, updated, or deleted as part of a commit.

      • absolutePath (string) --

        The full path to the file that will be added or updated, including the name of the file.

      • blobId (string) --

        The blob ID that contains the file information.

      • fileMode (string) --

        The extrapolated file mode permissions for the file. Valid values include EXECUTABLE and NORMAL.

  • filesUpdated (list) --

    The files updated as part of the commited file changes.

    • (dict) --

      A file that will be added, updated, or deleted as part of a commit.

      • absolutePath (string) --

        The full path to the file that will be added or updated, including the name of the file.

      • blobId (string) --

        The blob ID that contains the file information.

      • fileMode (string) --

        The extrapolated file mode permissions for the file. Valid values include EXECUTABLE and NORMAL.

  • filesDeleted (list) --

    The files deleted as part of the committed file changes.

    • (dict) --

      A file that will be added, updated, or deleted as part of a commit.

      • absolutePath (string) --

        The full path to the file that will be added or updated, including the name of the file.

      • blobId (string) --

        The blob ID that contains the file information.

      • fileMode (string) --

        The extrapolated file mode permissions for the file. Valid values include EXECUTABLE and NORMAL.