[ 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 . Дополнительные сведения см. в разделе «Допустимые типы и поставщики действий» в 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 . Дополнительную информацию см. в разделе Действительные типы и поставщики действий в CodePipeline.version -> (строка)
actionConfiguration -> (структура)
Представляет информацию о конфигурации действия.
configuration -> (отображение)
Данные конфигурации для действия.
key -> (строка)
value -> (строка)
pipelineContext -> (структура)
Представляет информацию о конвейерной линии рабочему заданию.
Примечание
ВключаетpipelineArn и pipelineExecutionId для пользовательских заданий.pipelineName -> (строка)
stage -> (структура)
Этап конвейерной линии.
name -> (строка)
action -> (структура)
Контекст действия для рабочего задания на этапе конвейерной линии.
name -> (строка)
actionExecutionId -> (строка)
pipelineArn -> (строка)
pipelineExecutionId -> (строка)
inputArtifacts -> (список)
Артефакт, предоставленный заданию.
(структура)
Артефакты — это файлы, над которыми работают действия в конвейерной линии. Подробную информацию о параметрах артефактов см. в конфигурации действия для каждого действия. Например, артефакт действия источника S3 — это имя файла (или путь к файлу), и файлы обычно предоставляются в формате ZIP. Пример имени артефакта: SampleApp_Windows.zip
name -> (строка)
revision -> (строка)
location -> (структура)
Расположение артефакта.
type -> (строка)
s3Location -> (структура)
Ведро S3, содержащее артефакт.
bucketName -> (строка)
objectKey -> (строка)
outputArtifacts -> (список)
Результат задания.
(структура)
Артефакты — это файлы, над которыми работают действия в конвейерной линии. Подробную информацию о параметрах артефактов см. в конфигурации действия для каждого действия. Например, артефакт действия источника S3 — это имя файла (или путь к файлу), и файлы обычно предоставляются в формате ZIP. Пример имени артефакта: SampleApp_Windows.zip
name -> (строка)
revision -> (строка)
location -> (структура)
Расположение артефакта.
type -> (строка)
s3Location -> (структура)
Ведро S3, содержащее артефакт.
bucketName -> (строка)
objectKey -> (строка)
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 -> (строка)
nonce -> (строка)
accountId -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.