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.
# Gérez les AWS CodeBuild builds avec Step Functions
Vous pouvez intégrer Step Functions AWS CodeBuild pour démarrer, arrêter et gérer des builds. Cette page répertorie les fonctionnalités compatibles CodeBuild APIs que vous pouvez utiliser avec Step Functions.
Pour en savoir plus sur l'intégration aux AWS services dans Step Functions, consultez [Intégration des services ](integrate-services.md) et[Transmission de paramètres à une API de service dans Step Functions](connect-parameters.md).
Grâce à l'intégration de Step Functions, AWS CodeBuild vous pouvez utiliser Step Functions pour déclencher, arrêter et gérer des builds, ainsi que pour partager des rapports de build. À l'aide de Step Functions, vous pouvez concevoir et exécuter des pipelines d'intégration continue pour valider les modifications apportées aux logiciels pour les applications.
**Principales fonctionnalités de l' CodeBuild intégration optimisée**
Le modèle [Exécuter une tâche (.sync)](connect-to-resource.md#connect-sync) d'intégration est pris en charge.
Une fois que vous avez appelé `StopBuild` ou`StopBuildBatch`, le build ou le batch de build n'est pas immédiatement supprimé tant que certains travaux internes ne sont pas terminés CodeBuild pour finaliser l'état de la ou des versions.
Si vous essayez d'utiliser `BatchDeleteBuilds` ou `DeleteBuildBatch` pendant cette période, il est possible que le build ou le batch de build ne soit pas supprimé.
Les intégrations de services optimisées pour `BatchDeleteBuilds` et `DeleteBuildBatch` incluent une nouvelle tentative interne afin de simplifier le cas d'utilisation de la suppression immédiatement après l'arrêt.
Tous ne sont pas APIs compatibles avec tous les modèles d'intégration, comme le montre le tableau suivant.
| API | Réponse à la requête | Exécuter une tâche (.sync) |
| --- | --- | --- |
| StartBuild | Pris en charge | Pris en charge |
| StopBuild | Pris en charge | Non pris en charge |
| BatchDeleteBuilds | Pris en charge | Non pris en charge |
| BatchGetReports | Pris en charge | Non pris en charge |
| StartBuildBatch | Pris en charge | Pris en charge |
| StopBuildBatch | Pris en charge | Non pris en charge |
| RetryBuildBatch | Pris en charge | Pris en charge |
| DeleteBuildBatch | Pris en charge | Non pris en charge |
**Les paramètres in Step Functions sont exprimés en PascalCase**
Même si l'API de service native se trouve dans CamelCase, par exemple l'`startSyncExecution`action d'API, vous spécifiez des paramètres PascalCase dans, tels que :. `StateMachineArn`
## Optimisé CodeBuild APIs
+ [https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html#API_StartBuild_RequestSyntax](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html#API_StartBuild_RequestSyntax)
+ [https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StopBuild.html](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StopBuild.html)
+ [https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BatchDeleteBuilds.html](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BatchDeleteBuilds.html)
+ [https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BatchGetReports.html](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BatchGetReports.html)
+ [https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html)
+ [https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StopBuildBatch.html](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StopBuildBatch.html)
+ [https://docs.aws.amazon.com/codebuild/latest/APIReference/API_RetryBuildBatch.html](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_RetryBuildBatch.html)
+ [https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DeleteBuildBatch.html](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DeleteBuildBatch.html)
**Note**
Lors de l'utilisation JSONPath, vous pouvez utiliser l'opérateur de descente récursif (`..`) pour fournir des paramètres pour`BatchDeleteBuilds`. Avec le tableau renvoyé, vous pouvez transformer le `Arn` champ `StartBuild` en `Ids` paramètre pluriel, comme indiqué dans l'exemple suivant.
```
"BatchDeleteBuilds": {
"Type": "Task",
"Resource": "arn:aws:states:::codebuild:batchDeleteBuilds",
"Arguments": {
"Ids.$": "$.Build..Arn"
},
"Next": "MyNextState"
},
```
## Politiques IAM pour les appels AWS CodeBuild
Les exemples de modèles suivants montrent comment AWS Step Functions générer des politiques IAM en fonction des ressources contenues dans la définition de votre machine d'état. Pour plus d’informations, consultez [Comment Step Functions génère des politiques IAM pour les services intégrés](service-integration-iam-templates.md) et [Découvrez les modèles d'intégration des services dans Step Functions](connect-to-resource.md).
*Ressources:*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"sns:Publish"
],
"Resource": [
"arn:aws:sns:us-east-1:123456789012:StepFunctionsSample-CodeBuildExecution1111-2222-3333-wJalrXUtnFEMI-SNSTopic-bPxRfiCYEXAMPLEKEY"
],
"Effect": "Allow"
},
{
"Action": [
"codebuild:StartBuild",
"codebuild:StopBuild",
"codebuild:BatchGetBuilds",
"codebuild:BatchGetReports"
],
"Resource": "*",
"Effect": "Allow"
},
{
"Action": [
"events:PutTargets",
"events:PutRule",
"events:DescribeRule"
],
"Resource": [
"arn:aws:events:us-east-1:123456789012:rule/StepFunctionsGetEventForCodeBuildStartBuildRule"
],
"Effect": "Allow"
}
]
}
```
### `StartBuild`
*Ressources statiques*
------
#### [ Run a Job (.sync) ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StartBuild",
"codebuild:StopBuild",
"codebuild:BatchGetBuilds"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
},
{
"Effect": "Allow",
"Action": [
"events:PutTargets",
"events:PutRule",
"events:DescribeRule"
],
"Resource": [
"arn:aws:events:us-east-1:123456789012:rule/StepFunctionsGetEventForCodeBuildStartBuildRule"
]
}
]
}
```
------
#### [ Request Response ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StartBuild"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
------
*Ressources dynamiques*
------
#### [ Run a Job (.sync) ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StartBuild",
"codebuild:StopBuild",
"codebuild:BatchGetBuilds"
],
"Resource": [
"arn:aws:codebuild:us-east-1:*:project/*"
]
},
{
"Effect": "Allow",
"Action": [
"events:PutTargets",
"events:PutRule",
"events:DescribeRule"
],
"Resource": [
"arn:aws:events:us-east-1:123456789012:rule/StepFunctionsGetEventForCodeBuildStartBuildRule"
]
}
]
}
```
------
#### [ Request Response ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StartBuild"
],
"Resource": [
"arn:aws:codebuild:us-east-1:*:project/*"
]
}
]
}
```
------
### `StopBuild`
*Ressources statiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StopBuild"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
*Ressources dynamiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StopBuild"
],
"Resource": [
"arn:aws:codebuild:us-east-1:*:project/*"
]
}
]
}
```
### `BatchDeleteBuilds`
*Ressources statiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:BatchDeleteBuilds"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
*Ressources dynamiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:BatchDeleteBuilds"
],
"Resource": [
"arn:aws:codebuild:us-east-1:*:project/*"
]
}
]
}
```
### `BatchGetReports`
*Ressources statiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:BatchGetReports"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:report-group/myReportName"
]
}
]
}
```
*Ressources dynamiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:BatchGetReports"
],
"Resource": [
"arn:aws:codebuild:us-east-1:*:report-group/*"
]
}
]
}
```
### `StartBuildBatch`
*Ressources statiques*
------
#### [ Run a Job (.sync) ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StartBuildBatch",
"codebuild:StopBuildBatch",
"codebuild:BatchGetBuildBatches"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
},
{
"Effect": "Allow",
"Action": [
"events:PutTargets",
"events:PutRule",
"events:DescribeRule"
],
"Resource": [
"arn:aws:events:us-east-1:123456789012:rule/StepFunctionsGetEventForCodeBuildStartBuildBatchRule"
]
}
]
}
```
------
#### [ Request Response ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StartBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
------
*Ressources dynamiques*
------
#### [ Run a Job (.sync) ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StartBuildBatch",
"codebuild:StopBuildBatch",
"codebuild:BatchGetBuildBatches"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/*"
]
},
{
"Effect": "Allow",
"Action": [
"events:PutTargets",
"events:PutRule",
"events:DescribeRule"
],
"Resource": [
"arn:aws:events:us-east-1:123456789012:rule/StepFunctionsGetEventForCodeBuildStartBuildBatchRule"
]
}
]
}
```
------
#### [ Request Response ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StartBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/*"
]
}
]
}
```
------
### `StopBuildBatch`
*Ressources statiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StopBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
*Ressources dynamiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StopBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/*"
]
}
]
}
```
### `RetryBuildBatch`
*Ressources statiques*
------
#### [ Run a Job (.sync) ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:RetryBuildBatch",
"codebuild:StopBuildBatch",
"codebuild:BatchGetBuildBatches"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
------
#### [ Request Response ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:RetryBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
------
*Ressources dynamiques*
------
#### [ Run a Job (.sync) ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:RetryBuildBatch",
"codebuild:StopBuildBatch",
"codebuild:BatchGetBuildBatches"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/*"
]
}
]
}
```
------
#### [ Request Response ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:RetryBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/*"
]
}
]
}
```
------
### `DeleteBuildBatch`
*Ressources statiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:DeleteBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
*Ressources dynamiques*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:DeleteBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/*"
]
}
]
}
```