Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
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.
# Image Builder Builder-Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Image Builder Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `create-component`
Das folgende Codebeispiel zeigt, wie Sie`create-component`.
**AWS CLI**
**So erstellen Sie eine Komponente**
Im folgenden Beispiel für `create-component` wird eine Komponente erstellt, die eine JSON-Dokumentdatei verwendet und auf ein Komponentendokument im YAML-Format verweist, das in einen Amazon-S3-Bucket hochgeladen wird.
```
aws imagebuilder create-component \
--cli-input-json file://create-component.json
```
Inhalt von `create-component.json`:
```
{
"name": "MyExampleComponent",
"semanticVersion": "2019.12.02",
"description": "An example component that builds, validates and tests an image",
"changeDescription": "Initial version.",
"platform": "Windows",
"uri": "s3://s3-bucket-name/s3-bucket-path/component.yaml"
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [CreateComponent AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-component.html)*Befehlsreferenz*.
### `create-distribution-configuration`
Das folgende Codebeispiel zeigt die Verwendung`create-distribution-configuration`.
**AWS CLI**
**So erstellen Sie eine Verteilungskonfiguration**
Im folgenden Beispiel für `create-distribution-configuration` wird eine Verteilungskonfiguration mithilfe einer JSON-Datei erstellt.
```
aws imagebuilder create-distribution-configuration \
--cli-input-json file:/create-distribution-configuration.json
```
Inhalt von `create-distribution-configuration.json`:
```
{
"name": "MyExampleDistribution",
"description": "Copies AMI to eu-west-1",
"distributions": [
{
"region": "us-west-2",
"amiDistributionConfiguration": {
"name": "Name {{imagebuilder:buildDate}}",
"description": "An example image name with parameter references",
"amiTags": {
"KeyName": "{{ssm:parameter_name}}"
},
"launchPermission": {
"userIds": [
"123456789012"
]
}
}
},
{
"region": "eu-west-1",
"amiDistributionConfiguration": {
"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
"amiTags": {
"KeyName": "Value"
},
"launchPermission": {
"userIds": [
"123456789012"
]
}
}
}
]
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [CreateDistributionConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)*Befehlsreferenz*.
### `create-image-pipeline`
Das folgende Codebeispiel zeigt die Verwendung`create-image-pipeline`.
**AWS CLI**
**So erstellen Sie eine Image-Pipeline**
Im folgenden Beispiel für `create-image-pipeline` wird eine Image-Pipeline mithilfe einer JSON-Datei erstellt.
```
aws imagebuilder create-image-pipeline \
--cli-input-json file://create-image-pipeline.json
```
Inhalt von `create-image-pipeline.json`:
```
{
"name": "MyWindows2016Pipeline",
"description": "Builds Windows 2016 Images",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure",
"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution",
"imageTestsConfiguration": {
"imageTestsEnabled": true,
"timeoutMinutes": 60
},
"schedule": {
"scheduleExpression": "cron(0 0 * * SUN)",
"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
},
"status": "ENABLED"
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [CreateImagePipeline AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-pipeline.html)*Befehlsreferenz*.
### `create-image-recipe`
Das folgende Codebeispiel zeigt die Verwendung`create-image-recipe`.
**AWS CLI**
**So erstellen Sie ein Rezept**
Im folgenden Beispiel für `create-image-recipe` wird ein Image-Rezept mithilfe einer JSON-Datei erstellt. Komponenten werden in der Reihenfolge installiert, in der sie angegeben sind.
```
aws imagebuilder create-image-recipe \
--cli-input-json file://create-image-recipe.json
```
Inhalt von `create-image-recipe.json`:
```
{
"name": "MyBasicRecipe",
"description": "This example image recipe creates a Windows 2016 image.",
"semanticVersion": "2019.12.03",
"components":
[
{
"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1"
},
{
"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1"
}
],
"parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/xxxx.x.x"
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [CreateImageRecipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-recipe.html)*Befehlsreferenz*.
### `create-image`
Das folgende Codebeispiel zeigt die Verwendung`create-image`.
**AWS CLI**
**Um ein Bild zu erstellen**
Im folgenden Beispiel für `create-image` wird ein Image erstellt.
```
aws imagebuilder create-image \
--image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03 \
--infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [CreateImage AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)*Befehlsreferenz*.
### `create-infrastructure-configuration`
Das folgende Codebeispiel zeigt die Verwendung`create-infrastructure-configuration`.
**AWS CLI**
**So erstellen Sie eine Infrastrukturkonfiguration**
Im folgenden Beispiel für `create-infrastructure-configuration` wird eine Infrastrukturkonfiguration mithilfe einer JSON-Datei erstellt.
```
aws imagebuilder create-infrastructure-configuration \
--cli-input-json file://create-infrastructure-configuration.json
```
Inhalt von `create-infrastructure-configuration.json`:
```
{
"name": "MyExampleInfrastructure",
"description": "An example that will retain instances of failed builds",
"instanceTypes": [
"m5.large", "m5.xlarge"
],
"instanceProfileName": "EC2InstanceProfileForImageBuilder",
"securityGroupIds": [
"sg-a1b2c3d4"
],
"subnetId": "subnet-a1b2c3d4",
"logging": {
"s3Logs": {
"s3BucketName": "bucket-name",
"s3KeyPrefix": "bucket-path"
}
},
"keyPair": "key-pair-name",
"terminateInstanceOnFailure": false,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-topic-name"
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [CreateInfrastructureConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-infrastructure-configuration.html)*Befehlsreferenz*.
### `delete-component`
Das folgende Codebeispiel zeigt die Verwendung`delete-component`.
**AWS CLI**
**So löschen Sie eine Komponente**
Im folgenden Beispiel für `delete-component` wird eine Build-Version einer Komponente durch Festlegen ihres ARN gelöscht.
```
aws imagebuilder delete-component \
--component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [DeleteComponent AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-component.html)*Befehlsreferenz*.
### `delete-image-pipeline`
Das folgende Codebeispiel zeigt die Verwendung`delete-image-pipeline`.
**AWS CLI**
**So löschen Sie eine Image-Pipeline**
Im folgenden Beispiel für `delete-image-pipeline` wird eine Image-Pipeline durch Festlegen ihres ARN gelöscht.
```
aws imagebuilder delete-image-pipeline \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [DeleteImagePipeline AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-pipeline.html)*Befehlsreferenz*.
### `delete-image-recipe`
Das folgende Codebeispiel zeigt die Verwendung`delete-image-recipe`.
**AWS CLI**
**So löschen Sie ein Image-Rezept**
Im folgenden Beispiel für `delete-image-recipe` wird ein Image-Rezept durch Festlegen seines ARN gelöscht.
```
aws imagebuilder delete-image-recipe \
--image-recipe-arn arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/mybasicrecipe/2019.12.03
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [DeleteImageRecipe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-recipe.html)*Befehlsreferenz*.
### `delete-image`
Das folgende Codebeispiel zeigt die Verwendung`delete-image`.
**AWS CLI**
**Um ein Bild zu löschen**
Im folgenden Beispiel für `delete-image` wird eine Build-Version eines Images durch Festlegen seines ARN gelöscht.
```
aws imagebuilder delete-image \
--image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.02/1
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [DeleteImage AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image.html)*Befehlsreferenz*.
### `delete-infrastructure-configuration`
Das folgende Codebeispiel zeigt die Verwendung`delete-infrastructure-configuration`.
**AWS CLI**
**So löschen Sie eine Infrastrukturkonfiguration**
Im folgenden Beispiel für `delete-infrastructure-configuration` wird eine Image-Pipeline durch Festlegen ihres ARN gelöscht.
```
aws imagebuilder delete-infrastructure-configuration \
--infrastructure-configuration-arn arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/myexampleinfrastructure
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [DeleteInfrastructureConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-infrastructure-configuration.html)*Befehlsreferenz*.
### `get-component-policy`
Das folgende Codebeispiel zeigt die Verwendung`get-component-policy`.
**AWS CLI**
**So rufen Sie Details zur Komponentenrichtlinie ab**
Im folgenden Beispiel für `get-component-policy` werden Details zu einer Komponentenrichtlinie durch Festlegen ihres ARN aufgelistet.
```
aws imagebuilder get-component-policy \
--component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1
```
Ausgabe:
```
{
"Policy": "{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetComponent", "imagebuilder:ListComponents" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1" ] } ] }"
}
```
Weitere Informationen finden Sie unter Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI < https://docs.aws.amazon.com/imagebuilder/ latest/userguide/managing - image-builder-cli .html>`\$1\$1 im *EC2* Image Builder Builder-Benutzerhandbuch.
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component-policy.html)AWS CLI *
### `get-component`
Das folgende Codebeispiel zeigt die Verwendung`get-component`.
**AWS CLI**
**So rufen Sie Details zu einer Komponente ab**
Im folgenden Beispiel für `get-component` werden Details zu einer Komponente durch Festlegen ihres ARN aufgelistet.
```
aws imagebuilder get-component \
--component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"component": {
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1",
"name": "component-name",
"version": "1.0.0",
"type": "TEST",
"platform": "Linux",
"owner": "123456789012",
"data": "name: HelloWorldTestingDocument\ndescription: This is hello world testing document.\nschemaVersion: 1.0\n\nphases:\n - name: test\n steps:\n - name: HelloWorldStep\n action: ExecuteBash\n inputs:\n commands:\n - echo \"Hello World! Test.\"\n",
"encrypted": true,
"dateCreated": "2020-01-27T20:43:30.306Z",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetComponent AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component.html)*Befehlsreferenz*.
### `get-distribution-configuration`
Das folgende Codebeispiel zeigt die Verwendung`get-distribution-configuration`.
**AWS CLI**
**So rufen Sie die Details zu einer Distributionskonfiguration ab**
Das folgende Beispiel für `get-distribution-configuration` zeigt Details zu einer Distributionskonfiguration durch Festlegen ihres ARN an.
```
aws imagebuilder get-distribution-configuration \
--distribution-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"distributionConfiguration": {
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution",
"name": "MyExampleDistribution",
"description": "Copies AMI to eu-west-1 and exports to S3",
"distributions": [
{
"region": "us-west-2",
"amiDistributionConfiguration": {
"name": "Name {{imagebuilder:buildDate}}",
"description": "An example image name with parameter references",
"amiTags": {
"KeyName": "{{ssm:parameter_name}}"
},
"launchPermission": {
"userIds": [
"123456789012"
]
}
}
},
{
"region": "eu-west-1",
"amiDistributionConfiguration": {
"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
"amiTags": {
"KeyName": "Value"
},
"launchPermission": {
"userIds": [
"123456789012"
]
}
}
}
],
"dateCreated": "2020-02-19T18:40:10.529Z",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetDistributionConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-distribution-configuration.html)*Befehlsreferenz*.
### `get-image-pipeline`
Das folgende Codebeispiel zeigt die Verwendung`get-image-pipeline`.
**AWS CLI**
**So rufen Sie Details zu einer Image-Pipeline ab**
Im folgenden Beispiel für `get-image-pipeline` werden Details zu einer Image-Pipeline durch die Angabe ihres ARN aufgelistet.
```
aws imagebuilder get-image-pipeline \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imagePipeline": {
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"name": "MyWindows2016Pipeline",
"description": "Builds Windows 2016 Images",
"platform": "Windows",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure",
"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution",
"imageTestsConfiguration": {
"imageTestsEnabled": true,
"timeoutMinutes": 60
},
"schedule": {
"scheduleExpression": "cron(0 0 * * SUN)",
"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
},
"status": "ENABLED",
"dateCreated": "2020-02-19T19:04:01.253Z",
"dateUpdated": "2020-02-19T19:04:01.253Z",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetImagePipeline AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-pipeline.html)*Befehlsreferenz*.
### `get-image-policy`
Das folgende Codebeispiel zeigt die Verwendung`get-image-policy`.
**AWS CLI**
**So rufen Sie Details zu einer Image-Richtlinie ab**
Im folgenden Beispiel für `get-image-policy` werden Details zu einer Image-Richtlinie durch die Angabe ihres ARN aufgelistet.
```
aws imagebuilder get-image-policy \
--image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1
```
Ausgabe:
```
{
"Policy": "{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImage", "imagebuilder:ListImages" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1" ] } ] }"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetImagePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-policy.html)*Befehlsreferenz*.
### `get-image-recipe-policy`
Das folgende Codebeispiel zeigt die Verwendung`get-image-recipe-policy`.
**AWS CLI**
**So rufen Sie Details zu einer Image-Rezept-Richtlinie ab**
Im folgenden Beispiel für `get-image-recipe-policy` werden Details zu einer Image-Rezept-Richtlinie durch die Angabe ihres ARN aufgelistet.
```
aws imagebuilder get-image-recipe-policy \
--image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-image-recipe/2019.12.03/1
```
Ausgabe:
```
{
"Policy": "{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImageRecipe", "imagebuilder:ListImageRecipes" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-image-recipe/2019.12.03/1" ] } ] }"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetImageRecipePolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-recipe-policy.html)*Befehlsreferenz*.
### `get-image`
Das folgende Codebeispiel zeigt die Verwendung`get-image`.
**AWS CLI**
**So rufen Sie Details zu einem Image ab**
Im folgenden Beispiel für `get-image` werden Details zu einem Image durch die Angabe seines ARN aufgelistet.
```
aws imagebuilder get-image \
--image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"image": {
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1",
"name": "MyBasicRecipe",
"version": "2019.12.03/1",
"platform": "Windows",
"state": {
"status": "BUILDING"
},
"imageRecipe": {
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03",
"name": "MyBasicRecipe",
"description": "This example image recipe creates a Windows 2016 image.",
"platform": "Windows",
"version": "2019.12.03",
"components": [
{
"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1"
},
{
"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1"
}
],
"parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/2019.12.17/1",
"dateCreated": "2020-02-14T19:46:16.904Z",
"tags": {}
},
"infrastructureConfiguration": {
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure",
"name": "MyExampleInfrastructure",
"description": "An example that will retain instances of failed builds",
"instanceTypes": [
"m5.large",
"m5.xlarge"
],
"instanceProfileName": "EC2InstanceProfileForImageFactory",
"securityGroupIds": [
"sg-a1b2c3d4"
],
"subnetId": "subnet-a1b2c3d4",
"logging": {
"s3Logs": {
"s3BucketName": "bucket-name",
"s3KeyPrefix": "bucket-path"
}
},
"keyPair": "Sam",
"terminateInstanceOnFailure": false,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name",
"dateCreated": "2020-02-14T21:21:05.098Z",
"tags": {}
},
"imageTestsConfiguration": {
"imageTestsEnabled": true,
"timeoutMinutes": 720
},
"dateCreated": "2020-02-14T23:14:13.597Z",
"outputResources": {
"amis": []
},
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetImage AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image.html)*Befehlsreferenz*.
### `get-infrastructure-configuration`
Das folgende Codebeispiel zeigt die Verwendung`get-infrastructure-configuration`.
**AWS CLI**
**So rufen Sie Details zu einer Infrastrukturkonfiguration ab**
Im folgenden Beispiel für `get-infrastructure-configuration` werden Details zu einer Infrastrukturkonfiguration durch die Angabe ihres ARN aufgelistet.
```
aws imagebuilder get-infrastructure-configuration \
--infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"infrastructureConfiguration": {
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure",
"name": "MyExampleInfrastructure",
"description": "An example that will retain instances of failed builds",
"instanceTypes": [
"m5.large",
"m5.xlarge"
],
"instanceProfileName": "EC2InstanceProfileForImageBuilder",
"securityGroupIds": [
"sg-a48c95ef"
],
"subnetId": "subnet-a48c95ef",
"logging": {
"s3Logs": {
"s3BucketName": "bucket-name",
"s3KeyPrefix": "bucket-path"
}
},
"keyPair": "Name",
"terminateInstanceOnFailure": false,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name",
"dateCreated": "2020-02-19T19:11:51.858Z",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [GetInfrastructureConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-infrastructure-configuration.html)*Befehlsreferenz*.
### `import-component`
Das folgende Codebeispiel zeigt die Verwendung`import-component`.
**AWS CLI**
**So importieren Sie eine Komponente**
Im folgenden Beispiel für `import-component` wird ein bereits vorhandenes Skript mithilfe einer JSON-Datei importiert.
```
aws imagebuilder import-component \
--cli-input-json file://import-component.json
```
Inhalt von `import-component.json`:
```
{
"name": "MyImportedComponent",
"semanticVersion": "1.0.0",
"description": "An example of how to import a component",
"changeDescription": "First commit message.",
"format": "SHELL",
"platform": "Windows",
"type": "BUILD",
"uri": "s3://s3-bucket-name/s3-bucket-path/component.yaml"
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myimportedcomponent/1.0.0/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ImportComponent AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-component.html)*Befehlsreferenz*.
### `list-component-build-versions`
Das folgende Codebeispiel zeigt die Verwendung`list-component-build-versions`.
**AWS CLI**
**So listen Sie die Build-Versionen einer Komponente auf**
Im folgenden Beispiel für `list-component-build-versions` werden die Build-Versionen einer Komponente mit einer bestimmten semantischen Version aufgelistet.
```
aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"componentSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1",
"name": "MyExampleComponent",
"version": "2019.12.02",
"platform": "Windows",
"type": "BUILD",
"owner": "123456789012",
"description": "An example component that builds, validates and tests an image",
"changeDescription": "Initial version.",
"dateCreated": "2020-02-19T18:53:45.940Z",
"tags": {
"KeyName": "KeyValue"
}
}
]
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListComponentBuildVersions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-component-build-versions.html)*Befehlsreferenz*.
### `list-components`
Das folgende Codebeispiel zeigt die Verwendung`list-components`.
**AWS CLI**
**So listen Sie alle semantischen Versionen einer Komponente auf**
Im folgenden Beispiel für `list-components` werden alle semantischen Versionen einer Komponente aufgelistet, auf die Sie Zugriff haben. Sie können optional danach filtern, ob Sie Komponenten auflisten möchten, die Ihnen gehören, die Amazon gehören oder die von anderen Konten mit Ihnen geteilt wurden.
```
aws imagebuilder list-components
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"componentVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0",
"name": "component-name",
"version": "1.0.0",
"platform": "Linux",
"type": "TEST",
"owner": "123456789012",
"dateCreated": "2020-01-27T20:43:30.306Z"
}
]
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListComponents AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-components.html)*Befehlsreferenz*.
### `list-distribution-configurations`
Das folgende Codebeispiel zeigt die Verwendung`list-distribution-configurations`.
**AWS CLI**
**So listen Sie Verteilungen auf**
Im folgenden Beispiel für `list-distribution-configurations` werden all Ihre Verteilungen aufgelistet.
```
aws imagebuilder list-distribution-configurations
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"distributionConfigurationSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution",
"name": "MyExampleDistribution",
"description": "Copies AMI to eu-west-1 and exports to S3",
"dateCreated": "2020-02-19T18:40:10.529Z",
"tags": {
"KeyName": "KeyValue"
}
}
]
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListDistributionConfigurations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-distribution-configurations.html)*Befehlsreferenz*.
### `list-image-build-versions`
Das folgende Codebeispiel zeigt die Verwendung`list-image-build-versions`.
**AWS CLI**
**So listen Sie die Build-Versionen eines Images auf**
Im folgenden Beispiel für `list-image-build-versions` werden alle Build-Versionen eines Images mit einer semantischen Version aufgelistet.
```
aws imagebuilder list-image-build-versions \
--image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/7",
"name": "MyBasicRecipe",
"version": "2019.12.03/7",
"platform": "Windows",
"state": {
"status": "FAILED",
"reason": "Can't start SSM Automation for arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/7 during building. Parameter \"iamInstanceProfileName\" has a null value."
},
"owner": "123456789012",
"dateCreated": "2020-02-19T18:56:11.511Z",
"outputResources": {
"amis": []
},
"tags": {}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/6",
"name": "MyBasicRecipe",
"version": "2019.12.03/6",
"platform": "Windows",
"state": {
"status": "FAILED",
"reason": "An internal error has occurred."
},
"owner": "123456789012",
"dateCreated": "2020-02-18T22:49:08.142Z",
"outputResources": {
"amis": [
{
"region": "us-west-2",
"image": "ami-a1b2c3d4567890ab",
"name": "MyBasicRecipe 2020-02-18T22-49-38.704Z",
"description": "This example image recipe creates a Windows 2016 image."
},
{
"region": "us-west-2",
"image": "ami-a1b2c3d4567890ab",
"name": "Name 2020-02-18T22-49-08.131Z",
"description": "Copies AMI to eu-west-2 and exports to S3"
},
{
"region": "eu-west-2",
"image": "ami-a1b2c3d4567890ab",
"name": "My 6 image 2020-02-18T22-49-08.131Z",
"description": "Copies AMI to eu-west-2 and exports to S3"
}
]
},
"tags": {}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/5",
"name": "MyBasicRecipe",
"version": "2019.12.03/5",
"platform": "Windows",
"state": {
"status": "AVAILABLE"
},
"owner": "123456789012",
"dateCreated": "2020-02-18T16:51:48.403Z",
"outputResources": {
"amis": [
{
"region": "us-west-2",
"image": "ami-a1b2c3d4567890ab",
"name": "MyBasicRecipe 2020-02-18T16-52-18.965Z",
"description": "This example image recipe creates a Windows 2016 image."
}
]
},
"tags": {}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/4",
"name": "MyBasicRecipe",
"version": "2019.12.03/4",
"platform": "Windows",
"state": {
"status": "AVAILABLE"
},
"owner": "123456789012",
"dateCreated": "2020-02-18T16:50:01.827Z",
"outputResources": {
"amis": [
{
"region": "us-west-2",
"image": "ami-a1b2c3d4567890ab",
"name": "MyBasicRecipe 2020-02-18T16-50-32.280Z",
"description": "This example image recipe creates a Windows 2016 image."
}
]
},
"tags": {}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/3",
"name": "MyBasicRecipe",
"version": "2019.12.03/3",
"platform": "Windows",
"state": {
"status": "AVAILABLE"
},
"owner": "123456789012",
"dateCreated": "2020-02-14T23:14:13.597Z",
"outputResources": {
"amis": [
{
"region": "us-west-2",
"image": "ami-a1b2c3d4567890ab",
"name": "MyBasicRecipe 2020-02-14T23-14-44.243Z",
"description": "This example image recipe creates a Windows 2016 image."
}
]
},
"tags": {}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/2",
"name": "MyBasicRecipe",
"version": "2019.12.03/2",
"platform": "Windows",
"state": {
"status": "FAILED",
"reason": "SSM execution 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' failed with status = 'Failed' and failure message = 'Step fails when it is verifying the command has completed. Command a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 returns unexpected invocation result: \n{Status=[Failed], ResponseCode=[1], Output=[\n----------ERROR-------\nfailed to run commands: exit status 1], OutputPayload=[{\"Status\":\"Failed\",\"ResponseCode\":1,\"Output\":\"\\n----------ERROR-------\\nfailed to run commands: exit status 1\",\"CommandId\":\"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\"}], CommandId=[a1b2c3d4-5678-90ab-cdef-EXAMPLE11111]}. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.'"
},
"owner": "123456789012",
"dateCreated": "2020-02-14T22:57:42.593Z",
"outputResources": {
"amis": []
},
"tags": {}
}
]
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListImageBuildVersions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)*Befehlsreferenz*.
### `list-image-pipeline-images`
Das folgende Codebeispiel zeigt die Verwendung`list-image-pipeline-images`.
**AWS CLI**
**So listen Sie Images von Image-Pipelines auf**
Im folgenden Beispiel für `list-image-pipeline-images` werden alle Images aufgelistet, die von einer bestimmten Image-Pipeline erstellt wurden.
```
aws imagebuilder list-image-pipeline-images \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imagePipelineList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"name": "MyWindows2016Pipeline",
"description": "Builds Windows 2016 Images",
"platform": "Windows",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure",
"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution",
"imageTestsConfiguration": {
"imageTestsEnabled": true,
"timeoutMinutes": 60
},
"schedule": {
"scheduleExpression": "cron(0 0 * * SUN)",
"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
},
"status": "ENABLED",
"dateCreated": "2020-02-19T19:04:01.253Z",
"dateUpdated": "2020-02-19T19:04:01.253Z",
"tags": {
"KeyName": "KeyValue"
}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/sam",
"name": "PipelineName",
"platform": "Linux",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/recipe-name-a1b2c3d45678/1.0.0",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/infrastructureconfiguration-name-a1b2c3d45678",
"imageTestsConfiguration": {
"imageTestsEnabled": true,
"timeoutMinutes": 720
},
"status": "ENABLED",
"dateCreated": "2019-12-16T18:19:02.068Z",
"dateUpdated": "2019-12-16T18:19:02.068Z",
"tags": {
"KeyName": "KeyValue"
}
}
]
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListImagePipelineImages AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-pipeline-images.html)*Befehlsreferenz*.
### `list-image-recipes`
Das folgende Codebeispiel zeigt die Verwendung`list-image-recipes`.
**AWS CLI**
**So listen Sie Image-Rezepte auf**
Im folgenden Beispiel für `list-image-recipes` werden alle Image-Rezepte aufgelistet.
```
aws imagebuilder list-image-recipes
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageRecipeSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03",
"name": "MyBasicRecipe",
"platform": "Windows",
"owner": "123456789012",
"parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/2019.x.x",
"dateCreated": "2020-02-19T18:54:25.975Z",
"tags": {
"KeyName": "KeyValue"
}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/recipe-name-a1b2c3d45678/1.0.0",
"name": "recipe-name-a1b2c3d45678",
"platform": "Linux",
"owner": "123456789012",
"parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/amazon-linux-2-x86/2019.11.21",
"dateCreated": "2019-12-16T18:19:00.120Z",
"tags": {
"KeyName": "KeyValue"
}
}
]
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListImageRecipes AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-recipes.html)*Befehlsreferenz*.
### `list-images`
Das folgende Codebeispiel zeigt die Verwendung`list-images`.
**AWS CLI**
**So listen Sie Images auf**
Im folgenden Beispiel für `list-images` werden alle semantischen Versionen aufgelistet, auf die Sie Zugriff haben.
```
aws imagebuilder list-images
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03",
"name": "MyBasicRecipe",
"version": "2019.12.03",
"platform": "Windows",
"owner": "123456789012",
"dateCreated": "2020-02-14T21:29:18.810Z"
}
]
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListImages AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)*Befehlsreferenz*.
### `list-infrastructure-configurations`
Das folgende Codebeispiel zeigt die Verwendung`list-infrastructure-configurations`.
**AWS CLI**
**So listen Sie Infrastrukturkonfigurationen auf**
Im folgenden Beispiel für `list-infrastructure-configurations` werden alle Infrastrukturkonfigurationen aufgelistet.
```
aws imagebuilder list-infrastructure-configurations
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"infrastructureConfigurationSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure",
"name": "MyExampleInfrastructure",
"description": "An example that will retain instances of failed builds",
"dateCreated": "2020-02-19T19:11:51.858Z",
"tags": {}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/infrastructureconfiguration-name-a1b2c3d45678",
"name": "infrastructureConfiguration-name-a1b2c3d45678",
"dateCreated": "2019-12-16T18:19:01.038Z",
"tags": {
"KeyName": "KeyValue"
}
}
]
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListInfrastructureConfigurations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-infrastructure-configurations.html)*Befehlsreferenz*.
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**So listen Sie Tags für eine bestimmte Ressource auf**
Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags für eine bestimmte Ressource aufgelistet.
```
aws imagebuilder list-tags-for-resource \
--resource-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Ausgabe:
```
{
"tags": {
"KeyName": "KeyValue"
}
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie unter [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-tags-for-resource.html)*Befehlsreferenz*.
### `put-component-policy`
Das folgende Codebeispiel zeigt die Verwendung`put-component-policy`.
**AWS CLI**
**So wenden Sie eine Ressourcenrichtlinie auf eine Komponente an**
Der folgende `put-component-policy`-Befehl wendet eine Ressourcenrichtlinie auf eine Build-Komponente an, um die kontoübergreifende gemeinsame Nutzung von Build-Komponenten zu ermöglichen. Wir empfehlen Ihnen, den RAM-CLI-Befehl `create-resource-share` zu verwenden. Wenn Sie den CLI-Befehl `put-component-policy` von EC2 Image Builder verwenden, müssen Sie auch den RAM-CLI-Befehl `promote-resource-share-create-from-policy` verwenden, damit die Ressource für alle Prinzipale sichtbar ist, mit denen die Ressource geteilt wird.
```
aws imagebuilder put-component-policy \
--component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1 \
--policy '{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetComponent", "imagebuilder:ListComponents" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1" ] } ] }'
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-component-policy.html)in der *AWS CLI Befehlsreferenz*.
### `put-image-policy`
Das folgende Codebeispiel zeigt die Verwendung`put-image-policy`.
**AWS CLI**
**So wenden Sie eine Ressourcenrichtlinie auf ein Image an**
Der folgende `put-image-policy`-Befehl wendet eine Ressourcenrichtlinie auf ein Image an, um die kontoübergreifende gemeinsame Nutzung von Images zu ermöglichen. Wir empfehlen Ihnen, den RAM-CLI-Befehl create-resource-share zu verwenden. Wenn Sie den EC2 Image Builder Builder-CLI-Befehl verwenden put-image-policy, müssen Sie auch den promote-resource-share-create RAM-CLI-Befehl -from-policy verwenden, damit die Ressource für alle Prinzipale sichtbar ist, mit denen die Ressource gemeinsam genutzt wird.
```
aws imagebuilder put-image-policy \
--image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1 \
--policy '{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImage", "imagebuilder:ListImages" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1" ] } ] }'
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutImagePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-policy.html)in der *AWS CLI Befehlsreferenz*.
### `put-image-recipe-policy`
Das folgende Codebeispiel zeigt die Verwendung`put-image-recipe-policy`.
**AWS CLI**
**So wenden Sie eine Ressourcenrichtlinie auf ein Image-Rezept an**
Der folgende `put-image-recipe-policy`-Befehl wendet eine Ressourcenrichtlinie auf ein Image-Rezept an, um die kontoübergreifende gemeinsame Nutzung von Image-Rezepten zu ermöglichen. Wir empfehlen Ihnen, den RAM-CLI-Befehl `create-resource-share` zu verwenden. Wenn Sie den CLI-Befehl `put-image-recipe-policy` von EC2 Image Builder verwenden, müssen Sie auch den RAM-CLI-Befehl `promote-resource-share-create-from-policy` verwenden, damit die Ressource für alle Prinzipale sichtbar ist, mit denen die Ressource geteilt wird.
```
aws imagebuilder put-image-recipe-policy \
--image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02 \
--policy '{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImageRecipe", "imagebuilder:ListImageRecipes" ], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02" ] } ] }'
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutImageRecipePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-recipe-policy.html)in der *AWS CLI Befehlsreferenz*.
### `start-image-pipeline-execution`
Das folgende Codebeispiel zeigt die Verwendung`start-image-pipeline-execution`.
**AWS CLI**
**So starten Sie eine Image-Pipeline manuell**
Im folgenden Beispiel für `start-image-pipeline-execution` wird eine Image-Pipeline manuell gestartet.
```
aws imagebuilder start-image-pipeline-execution \
--image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [StartImagePipelineExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/start-image-pipeline-execution.html)in der *AWS CLI Befehlsreferenz*.
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**So taggen Sie eine Ressource**
Im folgenden Beispiel für `tag-resource` wird zu EC2 Image Builder mithilfe einer JSON-Datei eine Ressource hinzugefügt, die getaggt wird.
```
aws imagebuilder tag-resource \
--cli-input-json file://tag-resource.json
```
Inhalt von `tag-resource.json`:
```
{
"resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"tags": {
"KeyName: "KeyValue"
}
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/tag-resource.html)in der *AWS CLI Befehlsreferenz*.
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So entfernen Sie ein Tag von einer Ressource**
Im folgenden Beispiel für `untag-resource` wird ein Tag mithilfe einer JSON-Datei aus einer Ressource entfernt.
```
aws imagebuilder untag-resource \
--cli-input-json file://tag-resource.json
```
Inhalt von `untag-resource.json`:
```
{
"resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"tagKeys": [
"KeyName"
]
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/untag-resource.html)in der *AWS CLI Befehlsreferenz*.
### `update-distribution-configuration`
Das folgende Codebeispiel zeigt die Verwendung`update-distribution-configuration`.
**AWS CLI**
**So aktualisieren Sie die Verteilungskonfiguration**
Im folgenden Beispiel für `update-distribution-configuration` wird eine Verteilungskonfiguration mithilfe einer JSON-Datei aktualisiert.
```
aws imagebuilder update-distribution-configuration \
--cli-input-json file://update-distribution-configuration.json
```
Inhalt von `update-distribution-configuration.json`:
```
{
"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution",
"description": "Copies AMI to eu-west-2 and exports to S3",
"distributions": [
{
"region": "us-west-2",
"amiDistributionConfiguration": {
"name": "Name {{imagebuilder:buildDate}}",
"description": "An example image name with parameter references"
}
},
{
"region": "eu-west-2",
"amiDistributionConfiguration": {
"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}"
}
}
]
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdateDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `update-image-pipeline`
Das folgende Codebeispiel zeigt die Verwendung`update-image-pipeline`.
**AWS CLI**
**So aktualisieren Sie eine Image-Pipeline**
Im folgenden Beispiel für `update-image-pipeline` wird eine Image-Pipeline mithilfe einer JSON-Datei aktualisiert.
```
aws imagebuilder update-image-pipeline \
--cli-input-json file://update-image-pipeline.json
```
Inhalt von `update-image-pipeline.json`:
```
{
"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03",
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure",
"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution",
"imageTestsConfiguration": {
"imageTestsEnabled": true,
"timeoutMinutes": 120
},
"schedule": {
"scheduleExpression": "cron(0 0 * * MON)",
"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
},
"status": "DISABLED"
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdateImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-image-pipeline.html)in der *AWS CLI Befehlsreferenz*.
### `update-infrastructure-configuration`
Das folgende Codebeispiel zeigt die Verwendung`update-infrastructure-configuration`.
**AWS CLI**
**So aktualisieren Sie eine Infrastrukturkonfiguration**
Im folgenden Beispiel für `update-infrastructure-configuration` wird eine Infrastrukturkonfiguration mithilfe einer JSON-Datei aktualisiert.
```
aws imagebuilder update-infrastructure-configuration \
--cli-input-json file:/update-infrastructure-configuration.json
```
Inhalt von `update-infrastructure-configuration.json`:
```
{
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure",
"description": "An example that will terminate instances of failed builds",
"instanceTypes": [
"m5.large", "m5.2xlarge"
],
"instanceProfileName": "EC2InstanceProfileForImageFactory",
"securityGroupIds": [
"sg-a48c95ef"
],
"subnetId": "subnet-a48c95ef",
"logging": {
"s3Logs": {
"s3BucketName": "bucket-name",
"s3KeyPrefix": "bucket-path"
}
},
"terminateInstanceOnFailure": true,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:sns-name"
}
```
Ausgabe:
```
{
"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Weitere Informationen finden Sie unter [Einrichten und Verwalten einer EC2 Image Builder Builder-Image-Pipeline mithilfe der AWS CLI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UpdateInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-infrastructure-configuration.html)in der *AWS CLI Befehlsreferenz*.