Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # AWS CodePipeline invoquer une référence d'action Vous utilisez une action d' CodePipeline appel pour simplifier le déclenchement des exécutions de pipeline en aval et le transfert de variables de pipeline et de révisions de source entre les pipelines. **Note** Cette action n'est prise en charge que pour les pipelines de type V2. **Topics** + [Type d'action](#action-reference-PipelineInvoke-type) + [Paramètres de configuration](#action-reference-PipelineInvoke-parameters) + [Artefacts d'entrée](#action-reference-PipelineInvoke-input) + [Artefacts de sortie](#action-reference-PipelineInvoke-output) + [Politique des rôles de service et autorisations pour l' CodePipeline action d'appel](#action-reference-PipelineInvoke-permissions-action) + [Déclaration d'action](#action-reference-PipelineInvoke-example) + [Consultez aussi](#action-reference-PipelineInvoke-links) ## Type d'action + Catégorie : `Invoke` + Propriétaire : `AWS` + Fournisseur : `CodePipeline` + Version : `1` ## Paramètres de configuration **PipelineName** Obligatoire : oui Nom du pipeline qui, lors de son exécution, démarrera le pipeline cible actuel. Vous devez déjà avoir créé le pipeline d'appel. L'action démarrera le pipeline `s3-pipeline-test` (cible) lorsque le pipeline (invoquant) nommé `my-s3-pipeline` lancera une exécution. **SourceRevisions** Obligatoire : non Les révisions de source que vous souhaitez que le pipeline cible utilise lorsqu'il est démarré par le pipeline d'appel. Par exemple, une action source S3 fournit des variables de sortie telles que l'ID de version S3 et la clé d'objet. Vous pouvez spécifier une valeur de révision à utiliser lorsque le pipeline est invoqué. Pour la CLI, vous spécifiez les révisions de source sous forme de chaîne JSON sérialisée. Pour plus d'informations sur l'utilisation des remplacements de version de source, consultez [SourceRevisionOverride](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SourceRevisionOverride.html)le *guide de l'CodePipeline API*. Le mappage utilise un format de chaîne comme illustré dans l'exemple suivant : ``` [{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision Value":"zq8mjNEXAMPLE"}] ``` **Variables** Obligatoire : non Les noms et valeurs des variables que vous souhaitez que l'action prenne en charge. Pour la CLI, vous spécifiez les variables sous forme de chaîne JSON sérialisée. Pour plus d'informations sur l'utilisation des variables de pipeline, consultez [PipelineVariable](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_PipelineVariable.html)le *guide de l'CodePipeline API*. Le mappage utilise un format de chaîne comme illustré dans l'exemple suivant : ``` [{"name":"VAR1","value":"VALUE1"}] ``` L'image suivante montre un exemple de l'action ajoutée à un pipeline dans la console. ![\[Un pipeline avec une source S3 et une phase de construction qui inclut l'action d'appel du pipeline\]](http://docs.aws.amazon.com/fr_fr/codepipeline/latest/userguide/images/example-pipeline-invoke-run.png) L'image suivante montre un exemple de page d'**édition** pour l'action. Dans l'exemple suivant, le pipeline nommé `s3-pipeline-test` possède une action d'appel de pipeline configurée comme indiqué pour la console. L'action démarrera le `s3-pipeline-test` pipeline lorsque le pipeline nommé `my-s3-pipeline` terminera une exécution. L'exemple montre que le remplacement de la version source pour le code source S3\$1OBJECT\$1VERSION\$1ID est remplacé par la valeur de révision spécifiée de. `zq8mjNYEexample` ![\[La page Modifier l'action pour un nouveau pipeline avec l'action d'appel du pipeline\]](http://docs.aws.amazon.com/fr_fr/codepipeline/latest/userguide/images/example-pipeline-invoke-edit.png) ## Artefacts d'entrée + **Nombre d'objets :** `0` + **Description :** Les artefacts d'entrée ne s'appliquent pas à ce type d'action. ## Artefacts de sortie + **Nombre d'objets :** `0` + **Description :** les artefacts de sortie ne s'appliquent pas à ce type d'action. ## Politique des rôles de service et autorisations pour l' CodePipeline action d'appel Lors de l' CodePipeline exécution de l'action, la politique de rôle de CodePipeline service nécessite l'`codepipeline:StartPipelineExecution`autorisation, limitée de manière appropriée à l'ARN de la ressource du pipeline afin de maintenir l'accès avec le moins de privilèges. ``` { "Sid": "StatementForPipelineInvokeAction", "Effect": "Allow", "Action": "codepipeline:StartPipelineExecution", "Resource": [ "arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}" ] } ``` ## Déclaration d'action ------ #### [ YAML ] ``` name: Invoke-pipeline actionTypeId: category: Invoke owner: AWS provider: CodePipeline version: '1' runOrder: 2 configuration: PipelineName: my-s3-pipeline SourceRevisions: '[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision Value":"zq8mjNEXAMPLE"}]' Variables: '[{"name":"VAR1","value":"VALUE1"}]' ``` ------ #### [ JSON ] ``` { "name": "Invoke-pipeline", "actionTypeId": { "category": "Invoke", "owner": "AWS", "provider": "CodePipeline", "version": "1" }, "runOrder": 2, "configuration": { "PipelineName": "my-s3-pipeline", "SourceRevisions": "[{\"actionName\":\"Source\",\"revisionType\":\"S3_OBJECT_VERSION_ID\",\"revisionValue\":\"zq8mjNEXAMPLE"}]", "Variables": "[{\"name\":\"VAR1\",\"value\":\"VALUE1\"}]" } }, ``` ------ ## Consultez aussi Les ressources connexes suivantes peuvent s'avérer utiles dans le cadre de l'utilisation de cette action. + [Démarrer un pipeline avec une modification de la version source](pipelines-trigger-source-overrides.md)— Cette section décrit le démarrage d'un pipeline avec des révisions de source manuellement ou via le transformateur d'entrée d' EventBridge événements.