Spec-Zone.ru › AWS CLI v2

[ aws . codepipeline ]

poll-for-jobs

Описание

Возвращает информацию о любых задачах, которые CodePipeline должен выполнить. PollForJobs действителен только для типов действий с «Custom» в поле owner. Если тип действия содержит AWS или ThirdParty в поле owner, действие PollForJobs возвращает ошибку.

Предупреждение

При вызове этого API CodePipeline возвращает временные учетные данные для ведра S3, используемого для хранения артефактов для конвейера, если действие требует доступа к этому ведру S3 для входных или выходных артефактов. Этот API также возвращает любые секретные значения, определённые для действия.

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

Синтаксис

  poll-for-jobs
--action-type-id <value>
[--max-batch-size <value>]
[--query-param <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]

Параметры

--action-type-id (структура)

Представляет информацию о типе действия.

category -> (строка)

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

  • Источник
  • Сборка
  • Тестирование
  • Развертывание
  • Вызов
  • Утверждение
  • Вычисление

owner -> (строка)

Создатель вызываемого действия. Существует три допустимых значения для поля Owner в разделе категории действий в структуре вашего конвейера: AWS , ThirdParty и Custom . Дополнительные сведения см. в разделе «Допустимые типы и поставщики действий» в CodePipeline.

provider -> (строка)

Поставщик вызываемой службой действия. Допустимые поставщики определяются категорией действия. Например, действие в категории «Развертывание» может иметь поставщика CodeDeploy, который будет указан как CodeDeploy . Дополнительные сведения см. в разделе «Допустимые типы и поставщики действий» в CodePipeline.

version -> (строка)

Строка, описывающая версию действия.

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

category=string,owner=string,provider=string,version=string

Синтаксис JSON:

{
  "category": "Source"|"Build"|"Deploy"|"Test"|"Invoke"|"Approval"|"Compute",
  "owner": "AWS"|"ThirdParty"|"Custom",
  "provider": "string",
  "version": "string"
}

--max-batch-size (целое число)

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

--query-param (отображение)

Отображение имен и значений свойств. Для типа действия без запросимых свойств это значение должно быть null или пустым отображением. Для типа действия с запросимым свойством вы должны указать это свойство в качестве ключа в отображении. Возвращаются только задачи, конфигурация действия которых соответствует сопоставленному значению.

key -> (строка)

value -> (строка)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--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 (строка)

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

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

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

Чтобы просмотреть доступные задачи

В этом примере возвращается информация о любых задачах, которые должна обработать рабочая задача. В этом примере используется предварительно определенный файл JSON (MyActionTypeInfo.json) для предоставления информации о типе действия, для которого рабочая задача обрабатывает задачи. Эта команда используется только для пользовательских действий. При вызове этой команды AWS CodePipeline возвращает временные учетные данные для ведра Amazon S3, используемого для хранения артефактов конвейера. Эта команда также вернет любые секретные значения, определенные для действия, если таковые имеются.

Команда:

aws codepipeline poll-for-jobs --cli-input-json file://MyActionTypeInfo.json

Пример содержимого файла JSON:

{
  "actionTypeId": {
    "category": "Test",
    "owner": "Custom",
    "provider": "MyJenkinsProviderName",
    "version": "1"
  },
  "maxBatchSize": 5,
  "queryParam": {
      "ProjectName": "MyJenkinsTestProject"
  }
}

Вывод:

{
 "jobs": [
  {
    "accountId": "111111111111",
    "data": {
      "actionConfiguration": {
        "__type": "ActionConfiguration",
        "configuration": {
          "ProjectName": "MyJenkinsExampleTestProject"
        }
      },
      "actionTypeId": {
        "__type": "ActionTypeId",
        "category": "Test",
        "owner": "Custom",
        "provider": "MyJenkinsProviderName",
        "version": "1"
      },
      "artifactCredentials": {
        "__type": "AWSSessionCredentials",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "secretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
        "sessionToken": "fICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9TrDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpEIbb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FkbFFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTbNYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE="
      },
      "inputArtifacts": [
        {
          "__type": "Artifact",
          "location": {
            "s3Location": {
              "bucketName": "codepipeline-us-east-1-11EXAMPLE11",
              "objectKey": "MySecondPipeline/MyAppBuild/EXAMPLE"
            },
            "type": "S3"
          },
          "name": "MyAppBuild"
        }
      ],
      "outputArtifacts": [],
      "pipelineContext": {
        "__type": "PipelineContext",
        "action": {
          "name": "MyJenkinsTest-Action"
        },
        "pipelineName": "MySecondPipeline",
        "stage": {
          "name": "Testing"
        }
      }
    },
    "id": "ef66c259-64f9-EXAMPLE",
    "nonce": "3"
  }
 ]
}

Вывод

jobs -> (список)

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

(структура)

Представляет информацию о задании.

id -> (строка)

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

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

Дополнительные данные о задании.

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

Представляет информацию об типе действия.

category -> (строка)

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

  • Источник
  • Сборка
  • Тестирование
  • Развертывание
  • Вызов
  • Утверждение
  • Вычисление

owner -> (строка)

Создатель вызываемого действия. Для поля Owner в разделе категории действий в структуре вашей конвейерной линии существуют три допустимых значения: AWS , ThirdParty и Custom . Дополнительную информацию см. в разделе Действительные типы и поставщики действий в CodePipeline.

provider -> (строка)

Поставщик вызываемой службой действия. Допустимые поставщики определяются категорией действия. Например, действие в категории типа Развертывания может иметь поставщика CodeDeploy, который будет указан как CodeDeploy . Дополнительную информацию см. в разделе Действительные типы и поставщики действий в CodePipeline.

version -> (строка)

Строка, описывающая версию действия.

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

Представляет информацию о конфигурации действия.

configuration -> (отображение)

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

key -> (строка)

value -> (строка)

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

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

Примечание

Включает pipelineArn и pipelineExecutionId для пользовательских заданий.

pipelineName -> (строка)

Имя конвейерной линии. Это значение, указанное пользователем. Имена конвейерных линий должны быть уникальными для всех имен конвейерных линий в учетной записи Amazon Web Services.

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

Этап конвейерной линии.

name -> (строка)

Имя этапа.

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

Контекст действия для рабочего задания на этапе конвейерной линии.

name -> (строка)

Имя действия в контексте задания.

actionExecutionId -> (строка)

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

pipelineArn -> (строка)

Идентификатор ресурса Amazon (ARN) конвейерной линии.

pipelineExecutionId -> (строка)

Идентификатор выполнения конвейерной линии.

inputArtifacts -> (список)

Артефакт, предоставленный заданию.

(структура)

Артефакты — это файлы, над которыми работают действия в конвейерной линии. Подробную информацию о параметрах артефактов см. в конфигурации действия для каждого действия. Например, артефакт действия источника S3 — это имя файла (или путь к файлу), и файлы обычно предоставляются в формате ZIP. Пример имени артефакта: SampleApp_Windows.zip

name -> (строка)

Имя артефакта.

revision -> (строка)

Идентификатор ревизии артефакта. В зависимости от типа объекта это может быть идентификатор коммита (GitHub) или идентификатор ревизии (Amazon S3).

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

Расположение артефакта.

type -> (строка)

Тип артефакта в расположении.

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

Ведро S3, содержащее артефакт.

bucketName -> (строка)

Имя ведра S3.

objectKey -> (строка)

Ключ объекта в ведре S3, который уникально идентифицирует объект в ведре.

outputArtifacts -> (список)

Результат задания.

(структура)

Артефакты — это файлы, над которыми работают действия в конвейерной линии. Подробную информацию о параметрах артефактов см. в конфигурации действия для каждого действия. Например, артефакт действия источника S3 — это имя файла (или путь к файлу), и файлы обычно предоставляются в формате ZIP. Пример имени артефакта: SampleApp_Windows.zip

name -> (строка)

Имя артефакта.

revision -> (строка)

Идентификатор ревизии артефакта. В зависимости от типа объекта это может быть идентификатор коммита (GitHub) или идентификатор ревизии (Amazon S3).

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

Расположение артефакта.

type -> (строка)

Тип артефакта в расположении.

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

Ведро S3, содержащее артефакт.

bucketName -> (строка)

Имя ведра S3.

objectKey -> (строка)

Ключ объекта в ведре S3, который уникально идентифицирует объект в ведре.

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

Представляет объект аутентификационных данных сеанса Amazon Web Services. Эти временные аутентификационные данные выдаются службой Amazon Web Services Secure Token Service (STS). Они могут использоваться для доступа к входным и выходным артефактам в ведре S3, используемом для хранения артефактов для конвейерной линии в CodePipeline.

accessKeyId -> (строка)

Ключ доступа для сеанса.

secretAccessKey -> (строка)

Секретный ключ доступа для сеанса.

sessionToken -> (строка)

Токен для сеанса.

continuationToken -> (строка)

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

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

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

id -> (строка)

Идентификатор, используемый для идентификации ключа. Для ключа Amazon Web Services KMS можно использовать идентификатор ключа, ARN ключа или ARN псевдонима.

Примечание

Псевдонимы распознаются только в той учетной записи, которая создала ключ KMS. Для действий между учетными записями можно использовать только идентификатор ключа или ARN ключа для идентификации ключа. Действия между учетными записями включают использование роли из другой учетной записи (AccountB), поэтому указание идентификатора ключа будет использовать ключ из другой учетной записи (AccountB).

type -> (строка)

Тип ключа шифрования, например, ключ Amazon Web Services KMS. При создании или обновлении конвейерной линии значение должно быть установлено в «KMS».

nonce -> (строка)

Сгенерированное системой случайное число, которое CodePipeline использует для обеспечения того, что заданием занимается только один рабочий. Используйте это число в запросе AcknowledgeJob.

accountId -> (строка)

Идентификатор учетной записи Amazon Web Services, которую нужно использовать при выполнении задания.

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

Spec-Zone.ru

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