Spec-Zone.ru › AWS CLI v2

[ aws . codecommit ]

merge-pull-request-by-three-way

Описание

Попытка объединить исходный коммит запроса на вытягивание в указанную целевую ветку для этого запроса на вытягивание в указанном коммите, используя стратегию слияния по трём версиям. Если слияние успешно выполнено, запрос на вытягивание закрывается.

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

Синтаксис

  merge-pull-request-by-three-way
--pull-request-id <value>
--repository-name <value>
[--source-commit-id <value>]
[--conflict-detail-level <value>]
[--conflict-resolution-strategy <value>]
[--commit-message <value>]
[--author-name <value>]
[--email <value>]
[--keep-empty-folders | --no-keep-empty-folders]
[--conflict-resolution <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]

Параметры

--pull-request-id (строка)

Сгенерированный системой идентификатор запроса на вытягивание. Чтобы получить этот идентификатор, используйте ListPullRequests .

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

Имя репозитория, в котором был создан запрос на вытягивание.

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

Полный идентификатор коммита исходного или обновленного коммита во ветке источника запроса на вытягивание. Передайте это значение, если вы хотите, чтобы было выброшено исключение, если текущий идентификатор коммита вершины ветки источника не соответствует этому идентификатору коммита.

--conflict-detail-level (строка)

Уровень детализации конфликтов. Если не указано, используется значение по умолчанию FILE_LEVEL, которое возвращает результат «невозможно слить», если у одного и того же файла есть различия в обеих ветках. Если указано LINE_LEVEL, конфликт считается несливаемым, если в одном и том же файле в обеих ветках есть различия на той же строке.

Возможные значения:

  • FILE_LEVEL
  • LINE_LEVEL

--conflict-resolution-strategy (строка)

Указывает, какую ветку использовать при разрешении конфликтов или пытаться автоматически слить две версии файла. По умолчанию значение NONE, что требует ручного разрешения всех конфликтов перед успешным выполнением операции слияния.

Возможные значения:

  • NONE
  • ACCEPT_SOURCE
  • ACCEPT_DESTINATION
  • AUTOMERGE

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

Сообщение коммита, которое нужно включить в информацию о коммите для слияния.

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

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

--email (строка)

Адрес электронной почты человека, сливающего ветки. Эта информация используется в информации о коммите для слияния.

--keep-empty-folders | --no-keep-empty-folders (логическое значение)

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

--conflict-resolution (структура)

Если стратегия разрешения конфликтов AUTOMERGE, список входных данных, которые нужно использовать при разрешении конфликтов во время слияния.

replaceContents -> (список)

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

(структура)

Информация о записи замены содержимого в конфликте операции слияния или запроса на вытягивание.

filePath -> (строка)

Путь к конфликтующему файлу.

replacementType -> (строка)

Тип замены, используемый при определении способа разрешения конфликта.

content -> (бинарный фрагмент)

Контент в кодировке base-64, который нужно использовать, когда тип замены USE_NEW_CONTENT.

fileMode -> (строка)

Режим файла, который нужно применить во время разрешения конфликта.

deleteFiles -> (список)

Файлы, которые должны быть удалены как часть разрешения конфликта слияния.

(структура)

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

filePath -> (строка)

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

setFileModes -> (список)

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

(структура)

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

filePath -> (строка)

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

fileMode -> (строка)

Режим файла.

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

replaceContents=[{filePath=string,replacementType=string,content=blob,fileMode=string},{filePath=string,replacementType=string,content=blob,fileMode=string}],deleteFiles=[{filePath=string},{filePath=string}],setFileModes=[{filePath=string,fileMode=string},{filePath=string,fileMode=string}]

Синтаксис JSON:

{
  "replaceContents": [
    {
      "filePath": "string",
      "replacementType": "KEEP_BASE"|"KEEP_SOURCE"|"KEEP_DESTINATION"|"USE_NEW_CONTENT",
      "content": blob,
      "fileMode": "EXECUTABLE"|"NORMAL"|"SYMLINK"
    }
    ...
  ],
  "deleteFiles": [
    {
      "filePath": "string"
    }
    ...
  ],
  "setFileModes": [
    {
      "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 (логическое значение)

Включить отладочную запись в журнал.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

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

--query (строка)

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

--profile (строка)

Использовать определенный профиль из вашего файла учетных данных.

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

Стиль форматирования, который будет использоваться для двоичных фрагментов. По умолчанию используется формат 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 (логическое значение)

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

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

Чтобы использовать следующие примеры, вы должны установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.

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

Для слияния запроса на вытягивание с использованием стратегии слияния по трём версиям

Следующий merge-pull-request-by-three-way пример объединяет и закрывает указанный запрос на вытягивание, используя значения по умолчанию для уровня детализации конфликта и стратегии разрешения конфликтов в репозитории с именем MyDemoRepo.

aws codecommit merge-pull-request-by-three-way \
    --pull-request-id 47 \
    --source-commit-id 99132ab0EXAMPLE \
    --repository-name MyDemoRepo \
    --name "Maria Garcia" \
    --email "maria_garcia@example.com" \
    --commit-message "Merging pull request 47 by three-way with default options"

Вывод:

{
    "pullRequest": {
        "approvalRules": [
            {
                "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
                "approvalRuleId": "dd8b17fe-EXAMPLE",
                "approvalRuleName": "2-approver-rule-for-main",
                "creationDate": 1571356106.936,
                "lastModifiedDate": 571356106.936,
                "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
                "originApprovalRuleTemplate": {
                    "approvalRuleTemplateId": "dd8b17fe-EXAMPLE",
                    "approvalRuleTemplateName": "2-approver-rule-for-main"
                },
                "ruleContentSha256": "4711b576EXAMPLE"
            }
        ],
        "authorArn": "arn:aws:iam::123456789012:user/Li_Juan",
        "clientRequestToken": "",
        "creationDate": 1508530823.142,
        "description": "Review the latest changes and updates to the global variables",
        "lastActivityDate": 1508887223.155,
        "pullRequestId": "47",
        "pullRequestStatus": "CLOSED",
        "pullRequestTargets": [
            {
                "destinationCommit": "9f31c968EXAMPLE",
                "destinationReference": "refs/heads/main",
                "mergeMetadata": {
                    "isMerged": true,
                    "mergedBy": "arn:aws:iam::123456789012:user/Mary_Major"
                },
                "repositoryName": "MyDemoRepo",
                "sourceCommit": "99132ab0EXAMPLE",
                "sourceReference": "refs/heads/variables-branch"
            }
        ],
        "title": "Consolidation of global variables"
    }
}

Дополнительную информацию см. в разделе Объединение запроса на вытягивание в руководстве пользователя AWS CodeCommit.

Вывод

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

Возвращает информацию о запросе на вытягивание.

pullRequestId -> (строка)

Сгенерированный системой идентификатор запроса на вытягивание.

title -> (строка)

Определяемое пользователем заголовок запроса на вытягивание. Этот заголовок отображается в списке запросов на вытягивание для других пользователей репозитория.

description -> (строка)

Определяемое пользователем описание запроса на вытягивание. Это описание может использоваться для уточнения того, что следует рассмотреть, и других деталей запроса.

lastActivityDate -> (метка времени)

День и время последней активности пользователя или системы по запросу на вытягивание в формате метки времени.

creationDate -> (метка времени)

Дата и время первоначального создания запроса на вытягивание в формате метки времени.

pullRequestStatus -> (строка)

Статус запроса на вытягивание. Статус запроса на вытягивание может изменяться только с OPEN на CLOSED.

authorArn -> (строка)

Идентификатор ресурса Amazon (ARN) пользователя, который создал запрос на вытягивание.

pullRequestTargets -> (список)

Цели запроса на вытягивание, включая исходную и целевую ветви запроса на вытягивание.

(структура)

Возвращает информацию о цели запроса на вытягивание.

repositoryName -> (строка)

Имя репозитория, содержащего исходные и целевые ветви запроса на вытягивание.

sourceReference -> (строка)

Ветка репозитория, содержащая изменения для запроса на вытягивание. Также известна как исходная ветвь.

destinationReference -> (строка)

Ветка репозитория, в которую будут объединены изменения запроса на вытягивание. Также известна как целевая ветвь.

destinationCommit -> (строка)

Полный идентификатор коммита, который является вершиной целевой ветви. Это коммит, где запрос на вытягивание был или будет объединён.

sourceCommit -> (строка)

Полный идентификатор коммита вершины исходной ветви, используемой для создания запроса на вытягивание. Если ветка запроса на вытягивание обновляется с помощью push во время открытого запроса на вытягивание, идентификатор коммита изменяется, чтобы отразить новую вершину ветви.

mergeBase -> (строка)

Идентификатор коммита самого последнего коммита, который общие для исходной и целевой ветвей.

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

Возвращает метаданные о состоянии слияния, включая выполнение слияния.

isMerged -> (булево)

Булево значение, указывающее, выполнено ли слияние.

mergedBy -> (строка)

Идентификатор ресурса Amazon (ARN) пользователя, который выполнил слияние ветвей.

mergeCommitId -> (строка)

Идентификатор коммита слияния, если таковой имеется.

mergeOption -> (строка)

Стратегия слияния, используемая при слиянии.

clientRequestToken -> (строка)

Уникальный, сгенерированный клиентом маркер идемпотенции, который, при предоставлении в запросе, гарантирует, что запрос не может быть повторён с изменённым параметром. Если запрос получен с теми же параметрами и маркер включён, запрос возвращает информацию об исходном запросе, который использовал этот маркер.

revisionId -> (строка)

Сгенерированный системой идентификатор ревизии для запроса на вытягивание.

approvalRules -> (список)

Правила утверждения, применимые к запросу на вытягивание.

(структура)

Возвращает информацию о правиле утверждения.

approvalRuleId -> (строка)

Сгенерированный системой идентификатор правила утверждения.

approvalRuleName -> (строка)

Имя правила утверждения.

approvalRuleContent -> (строка)

Содержание правила утверждения.

ruleContentSha256 -> (строка)

Подпись SHA-256 хэша для содержимого правила утверждения.

lastModifiedDate -> (метка времени)

Дата последнего изменения правила утверждения в формате метки времени.

creationDate -> (метка времени)

Дата создания правила утверждения в формате метки времени.

lastModifiedUser -> (строка)

Идентификатор ресурса Amazon (ARN) пользователя, который внес последние изменения в правило утверждения.

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

Шаблон правила утверждения, используемый для создания правила.

approvalRuleTemplateId -> (строка)

Идентификатор шаблона, который создал правило утверждения.

approvalRuleTemplateName -> (строка)

Имя шаблона, который создал правило утверждения.

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

Spec-Zone.ru

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