Spec-Zone.ru › AWS CLI v2

[ aws . codecommit ]

get-differences

Описание

Возвращает информацию о различиях в корректном указателе коммита (таком как ветвь, тег, HEAD, ID коммита или другой полный идентификатор). Результаты могут быть ограничены указанным путем.

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

get-differences является постраничной операцией. Для получения всего набора результатов могут быть вызваны несколько API-вызовов. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе постраничного запроса, аргумент --query должен извлекать данные из результатов следующих запросов: differences

Синтаксис

  get-differences
--repository-name <value>
[--before-commit-specifier <value>]
--after-commit-specifier <value>
[--before-path <value>]
[--after-path <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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 (строка)

Имя репозитория, где вы хотите получить различия.

--before-commit-specifier (строка)

Ветка, тег, HEAD или другой полный идентификатор, используемый для идентификации коммита (например, полный ID коммита). Необязательно. Если не указано, показываются все изменения до значения afterCommitSpecifier. Если вы не используете beforeCommitSpecifier в запросе, рассмотрите возможность ограничения результатов с помощью maxResults.

--after-commit-specifier (строка)

Ветка, тег, HEAD или другой полный идентификатор, используемый для идентификации коммита.

--before-path (строка)

Путь к файлу, в котором нужно проверить различия. Ограничивает результаты этим путем. Также может использоваться для указания предыдущего имени каталога или папки. Если beforePath и afterPath не указаны, различия показываются для всех путей.

--after-path (строка)

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

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

--starting-token (строка)

Токен для указания начала постраничной обработки. Это NextToken из ранее усечённого ответа.

Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.

--page-size (целое число)

Размер каждой страницы для получения данных от AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймаут вызовов AWS-сервиса.

Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе «Постраничная обработка» в руководстве пользователя AWS CLI.

--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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • автоматически

--no-sign-request (булево)

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

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

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 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.

Получение информации о различиях для указателя коммита в репозитории

В этом примере показано, как получить метаданные изменений между двумя указателями коммитов (веткой, тегом, HEAD или другими полными ссылками, такими как ID коммита) в переименованной папке в репозитории AWS CodeCommit с именем MyDemoRepo. Пример включает несколько необязательных параметров, включая –before-commit-specifier, –before-path и –after-path, чтобы более полно продемонстрировать, как можно использовать эти параметры для ограничения результатов. Ответ включает разрешения на доступ к файлам.

Команда:

aws codecommit get-differences --repository-name MyDemoRepo --before-commit-specifier 955bba12thisisanexamplethisisanexample --after-commit-specifier 14a95463thisisanexamplethisisanexample --before-path tmp/example-folder --after-path tmp/renamed-folder

Вывод:

{
  "differences": [
      {
          "afterBlob": {
              "path": "blob.txt",
              "blobId": "2eb4af3b1thisisanexamplethisisanexample1",
              "mode": "100644"
          },
          "changeType": "M",
          "beforeBlob": {
              "path": "blob.txt",
              "blobId": "bf7fcf281thisisanexamplethisisanexample1",
              "mode": "100644"
          }
      }
  ]
}

Вывод

differences -> (список)

Объект типа данных, содержащий информацию о различиях, включая добавление, изменение или удаление (A, D, M).

(структура)

Возвращает информацию о наборе различий для указателя коммита.

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

Информация об объекте типа данных beforeBlob, включая ID, код разрешений на доступ к файлам и путь.

blobId -> (строка)

Полный ID блока.

path -> (строка)

Путь к блоку и связанному имени файла, если таковое имеется.

mode -> (строка)

Разрешения на доступ к файлам блока. Коды разрешений на доступ к файлам включают:

  • 100644 указывает чтение/запись
  • 100755 указывает чтение/запись/выполнение
  • 160000 указывает подмодуль
  • 120000 указывает ссылку

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

Информация об объекте типа данных afterBlob, включая ID, код разрешений на доступ к файлам и путь.

blobId -> (строка)

Полный ID блока.

path -> (строка)

Путь к блоку и связанному имени файла, если таковое имеется.

mode -> (строка)

Разрешения на доступ к файлам блока. Коды разрешений на доступ к файлам включают:

  • 100644 указывает чтение/запись
  • 100755 указывает чтение/запись/выполнение
  • 160000 указывает подмодуль
  • 120000 указывает ссылку

changeType -> (строка)

Тип изменения различия: добавление (A), удаление (D) или изменение (M).

NextToken -> (строка)

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

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

Spec-Zone.ru

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