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 Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Aktionen

Das folgende Codebeispiel zeigt, wie Siecreate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie CreateComponentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie CreateDistributionConfigurationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie CreateImagePipelinein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie CreateImageRecipein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie CreateImagein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie CreateInfrastructureConfigurationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie DeleteComponentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie DeleteImagePipelinein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie DeleteImageRecipein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie DeleteImagein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie DeleteInfrastructureConfigurationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-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>`__ im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie in der Befehlsreferenz GetComponentPolicy.AWS CLI

Das folgende Codebeispiel zeigt die Verwendungget-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie GetComponentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie GetDistributionConfigurationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie GetImagePipelinein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie GetImagePolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie GetImageRecipePolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie GetImagein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie GetInfrastructureConfigurationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungimport-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ImportComponentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListComponentBuildVersionsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListComponentsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListDistributionConfigurationsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListImageBuildVersionsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListImagePipelineImagesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListImageRecipesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListImagesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListInfrastructureConfigurationsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie ListTagsForResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-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 EC2 Image Builder Builder-CLI-Befehl verwendenput-component-policy, 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 gemeinsam genutzt 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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie PutComponentPolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-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 RAM-CLI-Befehl promote-resource-share-create -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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie PutImagePolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-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 EC2 Image Builder Builder-CLI-Befehl verwendenput-image-recipe-policy, 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 gemeinsam genutzt 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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie PutImageRecipePolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie StartImagePipelineExecutionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

So markieren Sie eine Ressource

Im folgenden tag-resource Beispiel wird EC2 Image Builder mithilfe einer JSON-Datei eine Ressource hinzugefügt und mit Tags versehen.


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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

So entfernen Sie ein Tag aus 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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie UpdateDistributionConfigurationin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie UpdateImagePipelinein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-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 im EC2 Image Builder Builder-Benutzerhandbuch.

Einzelheiten zur API finden Sie UpdateInfrastructureConfigurationin der AWS CLI Befehlsreferenz.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

IAM Access Analyzer

Incident Manager