Esempi di Image Builder che utilizzano AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Image Builder.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-component.

AWS CLI

Come creare un componente

L’esempio create-component seguente crea un componente che utilizza un file di documento JSON e fa riferimento a un documento componente in formato YAML che viene caricato in un bucket Amazon S3.


aws imagebuilder create-component \
    --cli-input-json file://create-component.json

Contenuto di 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"
}

Output:


{
    "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"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. CreateComponentAWS CLI

Il seguente esempio di codice mostra come utilizzarecreate-distribution-configuration.

AWS CLI

Come creare una configurazione di distribuzione

L’esempio create-distribution-configuration seguente crea una configurazione di distribuzione utilizzando un file JSON.


aws imagebuilder create-distribution-configuration \
    --cli-input-json file:/create-distribution-configuration.json

Contenuto di 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"
                    ]
                }
            }
        }
    ]
}

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. CreateDistributionConfigurationAWS CLI

Il seguente esempio di codice mostra come utilizzarecreate-image-pipeline.

AWS CLI

Come creare una pipeline di immagini

L’esempio create-image-pipeline seguente crea una pipeline di immagini utilizzando un file JSON.


aws imagebuilder create-image-pipeline \
    --cli-input-json file://create-image-pipeline.json

Contenuto di 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"
}

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. CreateImagePipelineAWS CLI

Il seguente esempio di codice mostra come utilizzarecreate-image-recipe.

AWS CLI

Come creare una ricetta

L’esempio create-image-recipe seguente crea una ricetta di immagine utilizzando un file JSON. I componenti vengono installati nell’ordine in cui sono specificati.


aws imagebuilder create-image-recipe \
    --cli-input-json file://create-image-recipe.json

Contenuto di 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"
}

Output:


{
    "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"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. CreateImageRecipeAWS CLI

Il seguente esempio di codice mostra come utilizzarecreate-image.

AWS CLI

Come creare un’immagine

L’esempio create-image seguente crea un’immagine.


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

Output:


{
    "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"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. CreateImageAWS CLI

Il seguente esempio di codice mostra come utilizzarecreate-infrastructure-configuration.

AWS CLI

Come creare una configurazione dell’infrastruttura

L’esempio create-infrastructure-configuration seguente crea una configurazione dell’infrastruttura utilizzando un file JSON.


aws imagebuilder create-infrastructure-configuration \
    --cli-input-json file://create-infrastructure-configuration.json

Contenuto di 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"
}

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. CreateInfrastructureConfigurationAWS CLI

Il seguente esempio di codice mostra come utilizzaredelete-component.

AWS CLI

Come eliminare un componente

L’esempio delete-component seguente elimina una versione di build di un componente specificandone l’ARN.


aws imagebuilder delete-component \
    --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02/1"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. DeleteComponentAWS CLI

Il seguente esempio di codice mostra come utilizzaredelete-image-pipeline.

AWS CLI

Come eliminare una pipeline di immagini

L’esempio delete-image-pipeline seguente elimina una configurazione dell’infrastruttura specificandone l’ARN.


aws imagebuilder delete-image-pipeline \
    --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. DeleteImagePipelineAWS CLI

Il seguente esempio di codice mostra come utilizzaredelete-image-recipe.

AWS CLI

Come eliminare una ricetta di immagine

L’esempio delete-image-recipe seguente elimina una ricetta di immagine specificandone l’ARN.


aws imagebuilder delete-image-recipe \
    --image-recipe-arn arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/mybasicrecipe/2019.12.03

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/mybasicrecipe/2019.12.03"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. DeleteImageRecipeAWS CLI

Il seguente esempio di codice mostra come utilizzaredelete-image.

AWS CLI

Come eliminare un’immagine

L’esempio delete-image seguente elimina una versione di build di un’immagine specificandone l’ARN.


aws imagebuilder delete-image \
    --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.02/1

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. DeleteImageAWS CLI

Il seguente esempio di codice mostra come utilizzaredelete-infrastructure-configuration.

AWS CLI

Come eliminare una configurazione dell’infrastruttura

L’esempio delete-infrastructure-configuration seguente elimina una configurazione dell’infrastruttura specificandone l’ARN.


aws imagebuilder delete-infrastructure-configuration \
    --infrastructure-configuration-arn arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/myexampleinfrastructure

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. DeleteInfrastructureConfigurationAWS CLI

Il seguente esempio di codice mostra come utilizzareget-component-policy.

AWS CLI

Come ottenere dettagli su una policy sui componenti

L’esempio get-component-policy seguente elenca i dettagli di una policy sui componenti specificandone l’ARN.


aws imagebuilder get-component-policy \
    --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.03/1

Output:


{
    "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" ] } ] }"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la https://docs.aws.amazon.com/imagebuilder/ latest/userguide/managing image-builder-cli CLI < - .html>`__ nella Guida per l'utente di EC2 Image Builder.

Per GetComponentPolicyi AWS CLI dettagli sull'API, consulta Command Reference.

Il seguente esempio di codice mostra come utilizzareget-component.

AWS CLI

Come ottenere i dettagli dei componenti

L’esempio get-component seguente elenca i dettagli di un componente specificandone l’ARN.


aws imagebuilder get-component \
    --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/component-name/1.0.0/1

Output:


{
    "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": {}
    }
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. GetComponentAWS CLI

Il seguente esempio di codice mostra come utilizzareget-distribution-configuration.

AWS CLI

Come ottenere i dettagli di una configurazione di distribuzione

L’esempio get-distribution-configuration seguente mostra i dettagli di una configurazione di distribuzione specificandone l’ARN.


aws imagebuilder get-distribution-configuration \
    --distribution-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/myexampledistribution

Output:


{
    "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": {}
    }
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. GetDistributionConfigurationAWS CLI

Il seguente esempio di codice mostra come utilizzareget-image-pipeline.

AWS CLI

Come ottenere i dettagli di una pipeline di immagini

L’esempio get-image-pipeline seguente elenca i dettagli di una pipeline di immagini specificandone l’ARN.


aws imagebuilder get-image-pipeline \
    --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline

Output:


{
    "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": {}
    }
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. GetImagePipelineAWS CLI

Il seguente esempio di codice mostra come utilizzareget-image-policy.

AWS CLI

Come ottenere i dettagli di una policy sulle immagini

L’esempio get-image-policy seguente elenca i dettagli di una policy sulle immagini specificandone l’ARN.


aws imagebuilder get-image-policy \
    --image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1

Output:


{
    "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" ] } ] }"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. GetImagePolicyAWS CLI

Il seguente esempio di codice mostra come utilizzareget-image-recipe-policy.

AWS CLI

Come ottenere i dettagli di una policy sulle ricette

L’esempio get-image-recipe-policy seguente elenca i dettagli di una policy sulle ricette di immagini specificandone l’ARN.


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

Output:


{
    "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" ] } ] }"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. GetImageRecipePolicyAWS CLI

Il seguente esempio di codice mostra come utilizzareget-image.

AWS CLI

Come ottenere i dettagli di un’immagine

L’esempio get-image seguente elenca i dettagli di un’immagine specificandone l’ARN.


aws imagebuilder get-image \
    --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03/1

Output:


{
    "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": {}
    }
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. GetImageAWS CLI

Il seguente esempio di codice mostra come utilizzareget-infrastructure-configuration.

AWS CLI

Come ottenere i dettagli di una configurazione dell’infrastruttura

L’esempio get-infrastructure-configuration seguente elenca i dettagli di una configurazione dell’infrastruttura specificandone l’ARN.


aws imagebuilder get-infrastructure-configuration \
    --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/myexampleinfrastructure

Output:


{
    "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": {}
    }
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. GetInfrastructureConfigurationAWS CLI

Il seguente esempio di codice mostra come utilizzareimport-component.

AWS CLI

Come importare un componente

L’esempio import-component seguente importa uno script preesistente utilizzando un file JSON.


aws imagebuilder import-component \
    --cli-input-json file://import-component.json

Contenuto di 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"
}

Output:


{
    "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"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ImportComponentAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-component-build-versions.

AWS CLI

Come elencare le versioni di build dei componenti

L’esempio list-component-build-versions seguente elenca le versioni di build dei componenti con una determinata versione semantica.


aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/myexamplecomponent/2019.12.02

Output:


{
    "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"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListComponentBuildVersionsAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-components.

AWS CLI

Come elencare tutte le versioni semantiche dei componenti

L’esempio list-components seguente elenca tutte le versioni semantiche dei componenti a cui puoi accedere. Facoltativamente, puoi applicare un filtro per elencare i componenti di tua proprietà, di proprietà di Amazon o che sono stati condivisi con te da altri account.


aws imagebuilder list-components

Output:


{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListComponentsAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-distribution-configurations.

AWS CLI

Come elencare le distribuzioni

L’esempio list-distribution-configurations seguente elenca tutte le tue distribuzioni.


aws imagebuilder list-distribution-configurations

Output:


{
    "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"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListDistributionConfigurationsAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-image-build-versions.

AWS CLI

Come elencare le versioni di build di un’immagine

L’esempio list-image-build-versions seguente elenca tutte le versioni di build di un’immagine con una versione semantica.


aws imagebuilder list-image-build-versions \
    --image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/mybasicrecipe/2019.12.03

Output:


{
    "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": {}
        }
    ]
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListImageBuildVersionsAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-image-pipeline-images.

AWS CLI

Come elencare le immagini di una pipeline di immagini

L’esempio list-image-pipeline-images seguente elenca tutte le immagini create da una determinata pipeline di immagini.


aws imagebuilder list-image-pipeline-images \
    --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline

Output:


{
    "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"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListImagePipelineImagesAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-image-recipes.

AWS CLI

Come elencare le ricette di immagini

L’esempio list-image-recipes seguente elenca tutte le tue ricette di immagini.


aws imagebuilder list-image-recipes

Output:


{
    "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"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListImageRecipesAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-images.

AWS CLI

Come elencare le immagini

L’esempio list-images seguente elenca tutte le versioni semantiche a cui hai accesso.


aws imagebuilder list-images

Output:


{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListImagesAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-infrastructure-configurations.

AWS CLI

Come elencare le configurazioni dell’infrastruttura

L’esempio list-infrastructure-configurations seguente elenca tutte le configurazioni dell’infrastruttura.


aws imagebuilder list-infrastructure-configurations

Output:


{
    "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"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListInfrastructureConfigurationsAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag per una determinata risorsa

L’esempio list-tags-for-resource seguente elenca tutti i tag per una determinata risorsa.


aws imagebuilder list-tags-for-resource \
    --resource-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline

Output:


{
    "tags": {
        "KeyName": "KeyValue"
    }
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. ListTagsForResourceAWS CLI

Il seguente esempio di codice mostra come utilizzareput-component-policy.

AWS CLI

Come applicare una policy delle risorse a un componente

Il comando put-component-policy seguente applica una policy delle risorse a un componente di compilazione per consentire la condivisione dei componenti di compilazione tra più account. È consigliabile utilizzare il comando create-resource-share della CLI di RAM. Se utilizzi il comando put-component-policy della CLI di EC2 Image Builder, devi utilizzare anche il comando promote-resource-share-create-from-policy della CLI di RAM affinché la risorsa sia visibile a tutti i principali con cui è condivisa.


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" ] } ] }'

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/2019.12.02/1"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. PutComponentPolicyAWS CLI

Il seguente esempio di codice mostra come utilizzareput-image-policy.

AWS CLI

Come applicare una policy delle risorse a un’immagine

Il comando put-image-policy seguente applica una policy delle risorse a un’immagine per consentire la condivisione delle immagini tra più account. È consigliabile utilizzare il comando create-resource-share della CLI di RAM. Se si utilizza il comando CLI put-image-policy di EC2 Image Builder, è necessario utilizzare anche il comando RAM promote-resource-share-create CLI -from-policy affinché la risorsa sia visibile a tutti i principali con cui la risorsa è condivisa.


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" ] } ] }'

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imageArn": "arn:aws:imagebuilder:us-west-2:123456789012:image/example-image/2019.12.02/1"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. PutImagePolicyAWS CLI

Il seguente esempio di codice mostra come utilizzareput-image-recipe-policy.

AWS CLI

Come applicare una policy delle risorse a una ricetta di immagine

Il comando put-image-recipe-policy seguente applica una policy delle risorse a una ricetta di immagine per consentire la condivisione delle ricette di immagini tra più account. È consigliabile utilizzare il comando create-resource-share della CLI di RAM. Se utilizzi il comando put-image-recipe-policy della CLI di EC2 Image Builder, devi utilizzare anche il comando promote-resource-share-create-from-policy della CLI di RAM affinché la risorsa sia visibile a tutti i principali con cui è condivisa.


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" ] } ] }'

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/example-image-recipe/2019.12.02/1"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. PutImageRecipePolicyAWS CLI

Il seguente esempio di codice mostra come utilizzarestart-image-pipeline-execution.

AWS CLI

Come avviare manualmente una pipeline di immagini

L’esempio start-image-pipeline-execution seguente avvia manualmente una pipeline di immagini.


aws imagebuilder start-image-pipeline-execution \
    --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline

Output:


{
    "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"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. StartImagePipelineExecutionAWS CLI

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come taggare a una risorsa

L’esempio tag-resource seguente aggiunge e tagga una risorsa in EC2 Image Builder utilizzando un file JSON.


aws imagebuilder tag-resource \
    --cli-input-json file://tag-resource.json

Contenuto di tag-resource.json:


{
    "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
    "tags": {
        "KeyName: "KeyValue"
    }
}

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. TagResourceAWS CLI

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere un tag da una risorsa

L’esempio untag-resource seguente rimuove un tag da una risorsa utilizzando un file JSON.


aws imagebuilder untag-resource \
    --cli-input-json file://tag-resource.json

Contenuto di untag-resource.json:


{
    "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline",
    "tagKeys": [
        "KeyName"
    ]
}

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. UntagResourceAWS CLI

Il seguente esempio di codice mostra come utilizzareupdate-distribution-configuration.

AWS CLI

Come aggiornare una configurazione di distribuzione

L’esempio update-distribution-configuration seguente aggiorna una configurazione di distribuzione utilizzando un file JSON.


aws imagebuilder update-distribution-configuration \
    --cli-input-json file://update-distribution-configuration.json

Contenuto di 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}}"
            }
        }
    ]
}

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. UpdateDistributionConfigurationAWS CLI

Il seguente esempio di codice mostra come utilizzareupdate-image-pipeline.

AWS CLI

Come aggiornare una pipeline di immagini

L’esempio update-image-pipeline seguente aggiorna una pipeline di immagini utilizzando un file JSON.


aws imagebuilder update-image-pipeline \
    --cli-input-json file://update-image-pipeline.json

Contenuto di 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"
}

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. UpdateImagePipelineAWS CLI

Il seguente esempio di codice mostra come utilizzareupdate-infrastructure-configuration.

AWS CLI

Come aggiornare una configurazione dell’infrastruttura

L’esempio update-infrastructure-configuration seguente aggiorna una configurazione dell’infrastruttura utilizzando un file JSON.


aws imagebuilder update-infrastructure-configuration \
    --cli-input-json file:/update-infrastructure-configuration.json

Contenuto di 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"
}

Output:


{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Per ulteriori informazioni, consulta Configurazione e gestione di una pipeline di immagini di EC2 Image Builder AWS utilizzando la CLI nella Guida per l'utente di EC2 Image Builder.

Per i dettagli sull'API, consulta Command Reference. UpdateInfrastructureConfigurationAWS CLI

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Sistema di analisi degli accessi IAM

Strumento di gestione degli incidenti