Table Of Contents

Feedback

User Guide

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

[ aws . codecommit ]

delete-file

Description

Deletes a specified file from a specified branch. A commit is created on the branch that contains the revision. The file will still exist in the commits prior to the commit that contains the deletion.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  delete-file
--repository-name <value>
--branch-name <value>
--file-path <value>
--parent-commit-id <value>
[--keep-empty-folders | --no-keep-empty-folders]
[--commit-message <value>]
[--name <value>]
[--email <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--repository-name (string)

The name of the repository that contains the file to delete.

--branch-name (string)

The name of the branch where the commit will be made deleting the file.

--file-path (string)

The fully-qualified path to the file that will be deleted, including the full name and extension of that file. For example, /examples/file.md is a fully qualified path to a file named file.md in a folder named examples.

--parent-commit-id (string)

The ID of the commit that is the tip of the branch where you want to create the commit that will delete the file. This must be the HEAD commit for the branch. The commit that deletes the file will be created from this commit ID.

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

Specifies whether to delete the folder or directory that contains the file you want to delete if that file is the only object in the folder or directory. By default, empty folders will be deleted. This includes empty folders that are part of the directory structure. For example, if the path to a file is dir1/dir2/dir3/dir4, and dir2 and dir3 are empty, deleting the last file in dir4 will also delete the empty folders dir4, dir3, and dir2.

--commit-message (string)

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

--name (string)

The name of the author of the commit that deletes the file. If no name is specified, the user's ARN will be used as the author name and committer name.

--email (string)

The email address for the commit that deletes the file. If no email address is specified, the email address will be left blank.

--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 delete a file

The following delete-file example demonstrates how to delete a file named README.md from a branch named master with a most recent commit ID of c5709475EXAMPLE in a repository named MyDemoRepo.

aws codecommit delete-file --repository-name MyDemoRepo --branch-name master --file-path README.md --parent-commit-id c5709475EXAMPLE

Output:

{
    "blobId":"559b44fEXAMPLE",
    "commitId":"353cf655EXAMPLE",
    "filePath":"README.md",
    "treeId":"6bc824cEXAMPLE"
}

For more information, see Edit or Delete a File in AWS CodeCommit in the AWS CodeCommit API Reference guide.

Output

commitId -> (string)

The full commit ID of the commit that contains the change that deletes the file.

blobId -> (string)

The blob ID removed from the tree as part of deleting the file.

treeId -> (string)

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

filePath -> (string)

The fully-qualified path to the file that will be deleted, including the full name and extension of that file.