Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

Note: You are viewing the documentation for an older major version of the AWS CLI (version 1).

AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.

[ aws . codecommit ]

create-commit

Description

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

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  create-commit
--repository-name <value>
--branch-name <value>
[--parent-commit-id <value>]
[--author-name <value>]
[--email <value>]
[--commit-message <value>]
[--keep-empty-folders | --no-keep-empty-folders]
[--put-files <value>]
[--delete-files <value>]
[--set-file-modes <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--repository-name (string)

The name of the repository where you create the commit.

--branch-name (string)

The name of the branch where you create the commit.

--parent-commit-id (string)

The ID of the commit that is the parent of the commit you create. Not required if this is an empty repository.

--author-name (string)

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

--email (string)

The email address of the person who created the commit.

--commit-message (string)

The commit message you want to include in the commit. Commit messages are limited to 256 KB. If no message is specified, a default message is used.

--keep-empty-folders | --no-keep-empty-folders (boolean)

If the commit contains deletions, whether to keep a folder or folder structure if the changes leave the folders empty. If true, a ..gitkeep file is created for empty folders. The default is false.

--put-files (list)

The files to add or update in this commit.

Shorthand Syntax:

filePath=string,fileMode=string,fileContent=blob,sourceFile={filePath=string,isMove=boolean} ...

JSON Syntax:

[
  {
    "filePath": "string",
    "fileMode": "EXECUTABLE"|"NORMAL"|"SYMLINK",
    "fileContent": blob,
    "sourceFile": {
      "filePath": "string",
      "isMove": true|false
    }
  }
  ...
]

--delete-files (list)

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

Shorthand Syntax:

filePath=string ...

JSON Syntax:

[
  {
    "filePath": "string"
  }
  ...
]

--set-file-modes (list)

The file modes to update for files in this commit.

Shorthand Syntax:

filePath=string,fileMode=string ...

JSON Syntax:

[
  {
    "filePath": "string",
    "fileMode": "EXECUTABLE"|"NORMAL"|"SYMLINK"
  }
  ...
]

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Examples

To create a commit

The following create-commit example demonstrates how to create an initial commit for a repository that adds a readme.md file to a repository named MyDemoRepo in the master branch.

aws codecommit create-commit --repository-name MyDemoRepo --branch-name master --put-files "filePath=readme.md,fileContent='Welcome to our team repository.'"

Output:

{
    "filesAdded": [
        {
            "blobId": "5e1c309d-EXAMPLE",
            "absolutePath": "readme.md",
            "fileMode": "NORMAL"
        }
    ],
    "commitId": "4df8b524-EXAMPLE",
    "treeId": "55b57003-EXAMPLE",
    "filesDeleted": [],
    "filesUpdated": []
}

For more information, see Create a Commit in AWS CodeCommit in the AWS CodeCommit User Guide.

Output

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.

(structure)

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

absolutePath -> (string)

The full path to the file to 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.

(structure)

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

absolutePath -> (string)

The full path to the file to 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.

(structure)

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

absolutePath -> (string)

The full path to the file to 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.