Spec-Zone.ru › AWS CLI v2

[ aws . codecommit ]

create-commit

Описание

Создаёт коммит для репозитория на вершине указанной ветки.

См. также: Документацию API AWS

Синтаксис

  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 | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--repository-name (строка)

Имя репозитория, в котором создаётся коммит.

--branch-name (строка)

Имя ветки, в которой создаётся коммит.

--parent-commit-id (строка)

Идентификатор коммита, являющегося родителем создаваемого коммита. Не требуется, если это пустой репозиторий.

--author-name (строка)

Имя автора, создавшего коммит. Эта информация используется как для автора, так и для коммитера коммита.

--email (строка)

Электронный адрес человека, создавшего коммит.

--commit-message (строка)

Сообщение коммита, которое вы хотите включить в коммит. Сообщения коммитов ограничены 256 КБ. Если сообщение не указано, используется сообщение по умолчанию.

--keep-empty-folders | --no-keep-empty-folders (булево)

Если коммит содержит удаления, нужно ли сохранить папку или структуру папок, если изменения оставляют папки пустыми. Если true, создаётся файл ..gitkeep для пустых папок. По умолчанию false.

--put-files (список)

Файлы для добавления или обновления в этом коммите.

(структура)

Информация о файле, добавленном или обновлённом в рамках коммита.

filePath -> (строка)

Полный путь к файлу в репозитории, включая имя файла.

fileMode -> (строка)

Разрешения экстраполированной файловой моды для файла. Допустимые значения включают EXECUTABLE и NORMAL.

fileContent -> (двоичные данные)

Содержание файла, если исходный файл не указан.

sourceFile -> (структура)

Имя и полный путь к файлу, содержащему изменения, которые вы хотите внести в рамках коммита, если вы не предоставляете содержимое файла напрямую.

filePath -> (строка)

Полный путь к файлу, включая имя файла.

isMove -> (булево)

Удалять ли исходный файл из родительского коммита.

Сокращённый синтаксис:

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

Синтаксис JSON:

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

--delete-files (список)

Файлы для удаления в этом коммите. Эти файлы всё ещё существуют в более ранних коммитах.

(структура)

Файл, удалённый в рамках коммита.

filePath -> (строка)

Полный путь удаляемого файла, включая имя файла.

Сокращённый синтаксис:

filePath=string ...

Синтаксис JSON:

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

--set-file-modes (список)

Режим файлов для обновления файлов в этом коммите.

(структура)

Информация об изменениях режима файла.

filePath -> (строка)

Полный путь к файлу, включая имя файла.

fileMode -> (строка)

Режим файла.

Сокращённый синтаксис:

filePath=string,fileMode=string ...

Синтаксис JSON:

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

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные данные с помощью значения, предоставленного JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если указано без значения или со значением input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если указано output, он проверяет входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в генерируемом JSON-скелете.

Общие параметры

--debug (boolean)

Включить отладку логирования.

--endpoint-url (string)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с сервисами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла аутентификации.

--region (string)

Регион для использования. Переопределяет настройки из конфигурации/окружения.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Данные аутентификации не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки из конфигурации/окружения.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, а двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок fileb:// всегда будет обрабатываться как двоичный и будет использоваться непосредственно содержимое файла независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Отключить страницу cli для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров вам необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для создания коммита

Следующий create-commit пример демонстрирует, как создать начальный коммит для репозитория, добавляющего readme.md файл в репозиторий с именем MyDemoRepo в ветке main.

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

Вывод:

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

Дополнительную информацию см. в разделе Создание коммита в AWS CodeCommit в Руководстве пользователя AWS CodeCommit.

Вывод

commitId -> (строка)

Полный идентификатор коммита, содержащего измененные файлы.

treeId -> (строка)

Полный указатель SHA-1 информации о дереве для коммита, содержащего измененные файлы.

filesAdded -> (список)

Файлы, добавленные в рамках измененных файлов коммита.

(структура)

Файл для добавления, обновления или удаления в рамках коммита.

absolutePath -> (строка)

Полный путь к файлу для добавления или обновления, включая имя файла.

blobId -> (строка)

Идентификатор blob, содержащий информацию о файле.

fileMode -> (строка)

Доступные разрешения на режим файла. Допустимые значения включают EXECUTABLE и NORMAL.

filesUpdated -> (список)

Файлы, обновленные в рамках измененных файлов коммита.

(структура)

Файл для добавления, обновления или удаления в рамках коммита.

absolutePath -> (строка)

Полный путь к файлу для добавления или обновления, включая имя файла.

blobId -> (строка)

Идентификатор blob, содержащий информацию о файле.

fileMode -> (строка)

Доступные разрешения на режим файла. Допустимые значения включают EXECUTABLE и NORMAL.

filesDeleted -> (список)

Файлы, удаленные в рамках измененных файлов коммита.

(структура)

Файл для добавления, обновления или удаления в рамках коммита.

absolutePath -> (строка)

Полный путь к файлу для добавления или обновления, включая имя файла.

blobId -> (строка)

Идентификатор blob, содержащий информацию о файле.

fileMode -> (строка)

Доступные разрешения на режим файла. Допустимые значения включают EXECUTABLE и NORMAL.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API