Spec-Zone.ru › AWS CLI v2

[ aws . codeguru-reviewer ]

describe-code-review

Описание

Возвращает метаданные, связанные с обзором кода, вместе со своим статусом.

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

Синтаксис

  describe-code-review
--code-review-arn <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]

Параметры

--code-review-arn (строка)

Amazon Resource Name (ARN) объекта CodeReview.

--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-auto-prompt (логическое значение)

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

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

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

Примеры

Примечание

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

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

Список подробностей об обзоре кода.

Следующий describe-code-review список информации о рецензировании кода в ветке «mainline» репозитория AWS CodeCommit, который называется «my-repo-name».

aws codeguru-reviewer put-recommendation-feedback \
    --code-review-arn arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:code-review:RepositoryAnalysis-my-repository-name-branch-abcdefgh12345678 \
    --recommendation-id 3be1b2e5d7ef6e298a06499379ee290c9c596cf688fdcadb08285ddb0dd390eb \
    --reactions ThumbsUp

Вывод

{
        "CodeReview": {
            "Name": "My-ecs-beta-repo-master-xs6di4kfd4j269dz",
            "CodeReviewArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222:code-review:RepositoryAnalysis-my-repo-name",
            "RepositoryName": "My-ecs-beta-repo",
            "Owner": "123456789012",
            "ProviderType": "CodeCommit",
            "State": "Pending",
            "StateReason": "CodeGuru Reviewer is reviewing the source code.",
            "CreatedTimeStamp": 1618874226.226,
            "LastUpdatedTimeStamp": 1618874233.689,
            "Type": "RepositoryAnalysis",
            "SourceCodeType": {
                "RepositoryHead": {
                    "BranchName": "mainline"
                }
            },
            "AssociationArn": "arn:aws:codeguru-reviewer:us-west-2:123456789012:association:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
        }
    }

Для получения дополнительной информации см. Просмотр подробностей обзора кода в Руководстве пользователя Amazon CodeGuru Reviewer.

Вывод

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

Информация о рецензировании кода.

Имя -> (строка)

Имя рецензии кода.

CodeReviewArn -> (строка)

Amazon Resource Name (ARN) объекта CodeReview.

ИмяРепозитория -> (строка)

Имя репозитория.

Владелец -> (строка)

Владелец репозитория. Для репозитория Amazon Web Services CodeCommit это идентификатор учетной записи Amazon Web Services, владеющей репозиторием. Для репозиториев GitHub, GitHub Enterprise Server или Bitbucket это имя пользователя учетной записи, владеющей репозиторием. Для репозитория S3 это может быть имя пользователя или идентификатор учетной записи Amazon Web Services.

ТипПровайдера -> (строка)

Тип репозитория, содержащего просматриваемый код (например, GitHub или Bitbucket).

Состояние -> (строка)

Допустимые состояния рецензии кода:

  • Completed : Рецензия кода завершена.
  • Pending : Рецензия кода начата и не завершена или не завершилась успешно.
  • Failed : Рецензия кода завершилась неудачно.
  • Deleting : Рецензия кода удаляется.

ОписаниеСостояния -> (строка)

Причина состояния рецензии кода.

ВремяСоздание -> (отметка времени)

Время создания рецензии кода в миллисекундах с момента эпохи.

ПоследнееОбновление -> (отметка времени)

Время последнего обновления рецензии кода в миллисекундах с момента эпохи.

Тип -> (строка)

Тип рецензии кода.

PullRequestId -> (строка)

ID запроса на объединение (pull request) для рецензии кода.

ТипИсходногоКода -> (структура)

Тип исходного кода для рецензии кода.

РазницаПоCommit -> (структура)

Тип SourceCodeType, который определяет разницу по commit, созданную запросом на объединение (pull request) в связанном репозитории.

ИсходныйCommit -> (строка)

SHA исходного commit, используемого для создания разницы по commit. Это поле обязательно для рецензии кода с запросом на объединение (pull request).

ЦелевойCommit -> (строка)

SHA целевого commit, используемого для создания разницы по commit. Это поле обязательно для рецензии кода с запросом на объединение (pull request).

CommitБазовогоСостояния -> (строка)

SHA базового состояния commit.

ГоловкаРепозитория -> (структура)

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

ИмяВетки -> (строка)

Имя ветки в связанном репозитории. RepositoryHeadSourceCodeType указывает вершину этой ветки.

РазницаПоВетке -> (структура)

Тип SourceCodeType, который определяет имя исходной ветки и имя целевой ветки в связанном репозитории.

ИмяИсходнойВетки -> (строка)

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

ИмяЦелевойВетки -> (строка)

Целевая ветка для разницы в связанном репозитории.

S3Репозиторий -> (структура)

Информация о связанном репозитории в ведре S3, включая его имя и объект S3RepositoryDetails. Объект S3RepositoryDetails включает имя ведра S3, ключ S3 для файла исходного кода .zip и ключ S3 для файла сборки .zip. S3BucketRepository требуется в SourceCodeType для рецензий кода, основанных на S3BucketRepository.

Имя -> (строка)

Имя репозитория, когда ProviderType является S3Bucket.

Детали -> (структура)

Объект S3RepositoryDetails, который указывает имя ведра S3 и объект CodeArtifacts. Объект CodeArtifacts включает ключи объектов S3 для файла исходного кода .zip и для файла сборки .zip.

ИмяВедра -> (строка)

Имя ведра S3, используемого для связывания нового репозитория S3. Оно должно начинаться с codeguru-reviewer-.

АртефактыСборки -> (структура)

Объект CodeArtifacts. Объект CodeArtifacts включает ключ объекта S3 для файла исходного кода .zip и для файла сборки .zip, содержащего файлы .jar или .class.

КлючОбъектаИсходногоКода -> (строка)

Ключ объекта S3 для файла исходного кода .zip. Требуется для всех рецензий кода.

КлючОбъектаСборки -> (строка)

Ключ объекта S3 для файла сборки .zip, содержащего файлы .jar или .class. Требуется для рецензии кода с анализом безопасности. Для получения дополнительной информации см. Создание рецензий кода с помощью GitHub Actions в руководстве пользователя Amazon CodeGuru Reviewer.

МетаданныеЗапроса -> (структура)

Метаданные, связанные с рецензией кода. Это относится к любому типу рецензии кода, поддерживаемому CodeGuru Reviewer. Поле RequestMetadaa содержит метаданные события. Например, оно может содержать метаданные, связанные с триггером события, таким как push или pull request.

ИдентификаторЗапроса -> (строка)

Идентификатор запроса. Требуется для рецензии кода с запросом на объединение (pull request).

Запрашивающий -> (строка)

Идентификатор, такой как имя или идентификатор учетной записи, связанный с запрашивающим. Requester используется для захвата author/actor имени запроса события.

ИнформацияОбСобытии -> (структура)

Информация о событии, связанном с рецензией кода.

Имя -> (строка)

Имя события. Возможные имена: pull_request, workflow_dispatch, schedule и push.

Состояние -> (строка)

Состояние события. Состояние может быть открытым, закрытым или другим.

ИмяПродавца -> (строка)

Имя поставщика репозитория, используемого для загрузки кода в ведро S3 для рецензии кода CI/CD. Например, если код и артефакты загружаются в ведро S3 для рецензии кода CI/CD скриптами GitHub из репозитория GitHub, то ProviderType репозитория связывания равен S3Bucket, а имя поставщика репозитория CI/CD равно GitHub. Для получения дополнительной информации см. определение ProviderType в RepositoryAssociation.

AssociationArn -> (строка)

Amazon Resource Name (ARN) RepositoryAssociation, содержащий просматриваемый исходный код. Вы можете получить связанные ARN репозитория, вызвав ListRepositoryAssociations.

Метрики -> (структура)

Статистика из рецензии кода.

КоличествоИзмеренныхСтрокКода -> (целое)

MeteredLinesOfCodeCount - это количество строк кода в репозитории, где произошла рецензия кода. Это не включает строки, не являющиеся кодом, такие как комментарии и пустые строки.

КоличествоПодавленныхСтрокКода -> (целое)

SuppressedLinesOfCodeCount - это количество строк кода в репозитории, где произошла рецензия кода, которые CodeGuru Reviewer не проанализировал. Строки, подавленные в анализе, основаны на переменной excludeFiles в файле aws-codeguru-reviewer.yml. Это число не включает строки, не являющиеся кодом, такие как комментарии и пустые строки.

КоличествоНайденныхРекомендаций -> (целое)

Общее количество рекомендаций, найденных в рецензии кода.

ТипыАнализа -> (список)

Типы анализа, выполненные во время анализа репозитория или рецензии запроса на объединение (pull request). Вы можете указать Security, CodeQuality или оба.

(строка)

СостояниеФайлаКонфигурации -> (строка)

Состояние конфигурационного файла aws-codeguru-reviewer.yml, который позволяет настроить анализ CodeGuru Reviewer. Файл либо существует, не существует, либо существует с ошибками в корневом каталоге вашего репозитория.

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

Spec-Zone.ru

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