Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# AWS CodeBuild Builds mit Step Functions verwalten
Sie können Step Functions integrieren, AWS CodeBuild um Builds zu starten, zu stoppen und zu verwalten. Auf dieser Seite werden die unterstützten Funktionen aufgeführt, die CodeBuild APIs Sie mit Step verwenden können.
Informationen zur Integration mit AWS Diensten in Step Functions finden Sie unter [Integrieren von -Services](integrate-services.md) und[Übergeben von Parametern an eine Service-API in Step Functions](connect-parameters.md).
Mit der Step Functions-Integration können AWS CodeBuild Sie Step Functions verwenden, um Builds auszulösen, zu stoppen und zu verwalten und Build-Berichte gemeinsam zu nutzen. Mithilfe von Step Functions können Sie Pipelines für die kontinuierliche Integration entwerfen und ausführen, um Ihre Softwareänderungen für Anwendungen zu validieren.
**Hauptmerkmale der optimierten Integration CodeBuild**
Das [Ausführen einer Aufgabe (.sync)](connect-to-resource.md#connect-sync) Integrationsmuster wird unterstützt.
Nachdem Sie `StopBuild` oder aufgerufen haben`StopBuildBatch`, kann der Build oder der Build-Batch nicht sofort gelöscht werden, bis einige interne Arbeiten abgeschlossen sind, CodeBuild um den Status des Builds oder der Builds abzuschließen.
Wenn Sie versuchen, `BatchDeleteBuilds` oder `DeleteBuildBatch` während dieses Zeitraums zu verwenden, wird der Build oder der Build-Batch möglicherweise nicht gelöscht.
Die optimierten Serviceintegrationen `DeleteBuildBatch` bieten einen internen Wiederholungsversuch, um den Anwendungsfall des Löschens unmittelbar nach dem Beenden zu vereinfachen. `BatchDeleteBuilds`
Nicht alle APIs unterstützen alle Integrationsmuster, wie in der folgenden Tabelle dargestellt.
| API | Request Response (Antwort anfordern) | Ausführen einer Aufgabe (.sync) |
| --- | --- | --- |
| StartBuild | Unterstützt | Unterstützt |
| StopBuild | Unterstützt | Wird nicht unterstützt |
| BatchDeleteBuilds | Unterstützt | Wird nicht unterstützt |
| BatchGetReports | Unterstützt | Wird nicht unterstützt |
| StartBuildBatch | Unterstützt | Unterstützt |
| StopBuildBatch | Unterstützt | Wird nicht unterstützt |
| RetryBuildBatch | Unterstützt | Unterstützt |
| DeleteBuildBatch | Unterstützt | Wird nicht unterstützt |
**Die Parameter in Step Functions werden ausgedrückt in PascalCase**
Auch wenn sich die native Service-API in CamelCase befindet, z. B. die API-Aktion`startSyncExecution`, geben Sie Parameter in an PascalCase, z. B.:. `StateMachineArn`
## Optimiert 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)
**Anmerkung**
Bei der Verwendung JSONPath können Sie den rekursiven Abstiegsoperator (`..`) verwenden, um Parameter für `BatchDeleteBuilds` anzugeben. Mit dem zurückgegebenen Array können Sie das `Arn` Feld von `StartBuild` in einen `Ids` Pluralparameter umwandeln, wie im folgenden Beispiel gezeigt.
```
"BatchDeleteBuilds": {
"Type": "Task",
"Resource": "arn:aws:states:::codebuild:batchDeleteBuilds",
"Arguments": {
"Ids.$": "$.Build..Arn"
},
"Next": "MyNextState"
},
```
## IAM-Richtlinien für Anrufe AWS CodeBuild
Die folgenden Beispielvorlagen zeigen, wie IAM-Richtlinien auf der Grundlage der Ressourcen in Ihrer State-Machine-Definition AWS Step Functions generiert werden. Weitere Informationen erhalten Sie unter [So generiert Step Functions IAM-Richtlinien für integrierte Dienste](service-integration-iam-templates.md) und [Entdecken Sie Serviceintegrationsmuster in Step Functions](connect-to-resource.md).
*Ressourcen:*
****
```
{
"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`
*Statische Ressourcen*
------
#### [ 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"
]
}
]
}
```
------
*Dynamische Ressourcen*
------
#### [ 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`
*Statische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StopBuild"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
*Dynamische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StopBuild"
],
"Resource": [
"arn:aws:codebuild:us-east-1:*:project/*"
]
}
]
}
```
### `BatchDeleteBuilds`
*Statische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:BatchDeleteBuilds"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
*Dynamische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:BatchDeleteBuilds"
],
"Resource": [
"arn:aws:codebuild:us-east-1:*:project/*"
]
}
]
}
```
### `BatchGetReports`
*Statische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:BatchGetReports"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:report-group/myReportName"
]
}
]
}
```
*Dynamische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:BatchGetReports"
],
"Resource": [
"arn:aws:codebuild:us-east-1:*:report-group/*"
]
}
]
}
```
### `StartBuildBatch`
*Statische Ressourcen*
------
#### [ 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"
]
}
]
}
```
------
*Dynamische Ressourcen*
------
#### [ 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`
*Statische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StopBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
*Dynamische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:StopBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/*"
]
}
]
}
```
### `RetryBuildBatch`
*Statische Ressourcen*
------
#### [ 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"
]
}
]
}
```
------
*Dynamische Ressourcen*
------
#### [ 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`
*Statische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:DeleteBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/myProjectName"
]
}
]
}
```
*Dynamische Ressourcen*
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codebuild:DeleteBuildBatch"
],
"Resource": [
"arn:aws:codebuild:us-east-1:123456789012:project/*"
]
}
]
}
```