Beispiele für Image Builder unter Verwendung der AWS CLI - AWS Command Line Interface
Aktionen

Beispiele für Image Builder unter Verwendung der AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Image Builder nutzen.

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

Das folgende Codebeispiel zeigt, wie create-component verwendet wird.

AWS CLI

So erstellen Sie eine Komponente

Im folgenden create-component-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter CreateComponent in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-distribution-configuration verwendet wird.

AWS CLI

So erstellen Sie eine Verteilungskonfiguration

Im folgenden create-distribution-configuration-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie create-image-pipeline verwendet wird.

AWS CLI

So erstellen Sie eine Image-Pipeline

Im folgenden create-image-pipeline-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie create-image-recipe verwendet wird.

AWS CLI

So erstellen Sie ein Rezept

Im folgenden create-image-recipe-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie create-image verwendet wird.

AWS CLI

So erstellen Sie ein Image

Im folgenden create-image-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter CreateImage in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-infrastructure-configuration verwendet wird.

AWS CLI

So erstellen Sie eine Infrastrukturkonfiguration

Im folgenden create-infrastructure-configuration-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie delete-component verwendet wird.

AWS CLI

So löschen Sie eine Komponente

Im folgenden delete-component-Beispiel wird eine Build-Version einer Komponente durch die Angabe 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter DeleteComponent in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-image-pipeline verwendet wird.

AWS CLI

So löschen Sie eine Image-Pipeline

Im folgenden delete-image-pipeline-Beispiel wird eine Image-Pipeline durch die Angabe 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie delete-image-recipe verwendet wird.

AWS CLI

So löschen Sie ein Image-Rezept

Im folgenden delete-image-recipe-Beispiel wird ein Image-Rezept durch die Angabe 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie delete-image verwendet wird.

AWS CLI

So löschen Sie ein Image

Im folgenden delete-image-Beispiel wird eine Build-Version eines Images durch die Angabe 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter DeleteImage in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-infrastructure-configuration verwendet wird.

AWS CLI

So löschen Sie eine Infrastrukturkonfiguration

Im folgenden delete-infrastructure-configuration-Beispiel wird eine Image-Pipeline durch die Angabe 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie get-component-policy verwendet wird.

AWS CLI

So rufen Sie Details zur Komponentenrichtlinie ab

Im folgenden get-component-policy-Beispiel werden Details zu einer Komponentenrichtlinie durch die Angabe 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI <https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html>`__ im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie get-component verwendet wird.

AWS CLI

So rufen Sie Details zu einer Komponente ab

Im folgenden get-component-Beispiel werden Details zu einer Komponente durch die Angabe 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter GetComponent in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-distribution-configuration verwendet wird.

AWS CLI

So rufen Sie die Details zu einer Distributionskonfiguration ab

Das folgende get-distribution-configuration-Beispiel zeigt Details zu einer Distributionskonfiguration durch die Angabe 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie get-image-pipeline verwendet wird.

AWS CLI

So rufen Sie Details zu einer Image-Pipeline ab

Im folgenden get-image-pipeline-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie get-image-policy verwendet wird.

AWS CLI

So rufen Sie Details zu einer Image-Richtlinie ab

Im folgenden get-image-policy-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter GetImagePolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-image-recipe-policy verwendet wird.

AWS CLI

So rufen Sie Details zu einer Image-Rezept-Richtlinie ab

Im folgenden get-image-recipe-policy-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie get-image verwendet wird.

AWS CLI

So rufen Sie Details zu einem Image ab

Im folgenden get-image-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter GetImage in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-infrastructure-configuration verwendet wird.

AWS CLI

So rufen Sie Details zu einer Infrastrukturkonfiguration ab

Im folgenden get-infrastructure-configuration-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie import-component verwendet wird.

AWS CLI

So importieren Sie eine Komponente

Im folgenden import-component-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter ImportComponent in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-component-build-versions verwendet wird.

AWS CLI

So listen Sie die Build-Versionen einer Komponente auf

Im folgenden list-component-build-versions-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie list-components verwendet wird.

AWS CLI

So listen Sie alle semantischen Versionen einer Komponente auf

Im folgenden list-components-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter ListComponents in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-distribution-configurations verwendet wird.

AWS CLI

So listen Sie Verteilungen auf

Im folgenden list-distribution-configurations-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie list-image-build-versions verwendet wird.

AWS CLI

So listen Sie die Build-Versionen eines Images auf

Im folgenden list-image-build-versions-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie list-image-pipeline-images verwendet wird.

AWS CLI

So listen Sie Images von Image-Pipelines auf

Im folgenden list-image-pipeline-images-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie list-image-recipes verwendet wird.

AWS CLI

So listen Sie Image-Rezepte auf

Im folgenden list-image-recipes-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie list-images verwendet wird.

AWS CLI

So listen Sie Images auf

Im folgenden list-images-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter ListImages in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-infrastructure-configurations verwendet wird.

AWS CLI

So listen Sie Infrastrukturkonfigurationen auf

Im folgenden list-infrastructure-configurations-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie Tags für eine bestimmte Ressource auf

Im folgenden list-tags-for-resource-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie put-component-policy verwendet wird.

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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie put-image-policy verwendet wird.

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 CLI-Befehl put-image-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-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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter PutImagePolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-image-recipe-policy verwendet wird.

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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie start-image-pipeline-execution verwendet wird.

AWS CLI

So starten Sie eine Image-Pipeline manuell

Im folgenden start-image-pipeline-execution-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So taggen Sie eine Ressource

Im folgenden tag-resource-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie ein Tag aus einer Ressource

Im folgenden untag-resource-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-distribution-configuration verwendet wird.

AWS CLI

So aktualisieren Sie die Verteilungskonfiguration

Im folgenden update-distribution-configuration-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie update-image-pipeline verwendet wird.

AWS CLI

So aktualisieren Sie eine Image-Pipeline

Im folgenden update-image-pipeline-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.

Das folgende Codebeispiel zeigt, wie update-infrastructure-configuration verwendet wird.

AWS CLI

So aktualisieren Sie eine Infrastrukturkonfiguration

Im folgenden update-infrastructure-configuration-Beispiel 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 Image-Pipeline von EC2 Image Builder mithilfe der AWS-CLI im Benutzerhandbuch zu EC2 Image Builder.