Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# 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.
**Topics**
+ [Azioni](#actions)
## Azioni
### `create-component`
Il seguente esempio di codice mostra come utilizzare`create-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [CreateComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-component.html)AWS CLI *
### `create-distribution-configuration`
Il seguente esempio di codice mostra come utilizzare`create-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [CreateDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)AWS CLI *
### `create-image-pipeline`
Il seguente esempio di codice mostra come utilizzare`create-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [CreateImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-pipeline.html)AWS CLI *
### `create-image-recipe`
Il seguente esempio di codice mostra come utilizzare`create-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [CreateImageRecipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image-recipe.html)AWS CLI *
### `create-image`
Il seguente esempio di codice mostra come utilizzare`create-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [CreateImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)AWS CLI *
### `create-infrastructure-configuration`
Il seguente esempio di codice mostra come utilizzare`create-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [CreateInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-infrastructure-configuration.html)AWS CLI *
### `delete-component`
Il seguente esempio di codice mostra come utilizzare`delete-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [DeleteComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-component.html)AWS CLI *
### `delete-image-pipeline`
Il seguente esempio di codice mostra come utilizzare`delete-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [DeleteImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-pipeline.html)AWS CLI *
### `delete-image-recipe`
Il seguente esempio di codice mostra come utilizzare`delete-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [DeleteImageRecipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image-recipe.html)AWS CLI *
### `delete-image`
Il seguente esempio di codice mostra come utilizzare`delete-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [DeleteImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-image.html)AWS CLI *
### `delete-infrastructure-configuration`
Il seguente esempio di codice mostra come utilizzare`delete-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [DeleteInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/delete-infrastructure-configuration.html)AWS CLI *
### `get-component-policy`
Il seguente esempio di codice mostra come utilizzare`get-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>`\$1\$1 nella Guida per l'utente di EC2 Image Builder.*
+ Per [GetComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component-policy.html)i *AWS CLI dettagli* sull'API, consulta Command Reference.
### `get-component`
Il seguente esempio di codice mostra come utilizzare`get-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [GetComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-component.html)AWS CLI *
### `get-distribution-configuration`
Il seguente esempio di codice mostra come utilizzare`get-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [GetDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-distribution-configuration.html)AWS CLI *
### `get-image-pipeline`
Il seguente esempio di codice mostra come utilizzare`get-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [GetImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-pipeline.html)AWS CLI *
### `get-image-policy`
Il seguente esempio di codice mostra come utilizzare`get-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [GetImagePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-policy.html)AWS CLI *
### `get-image-recipe-policy`
Il seguente esempio di codice mostra come utilizzare`get-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [GetImageRecipePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image-recipe-policy.html)AWS CLI *
### `get-image`
Il seguente esempio di codice mostra come utilizzare`get-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [GetImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-image.html)AWS CLI *
### `get-infrastructure-configuration`
Il seguente esempio di codice mostra come utilizzare`get-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [GetInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/get-infrastructure-configuration.html)AWS CLI *
### `import-component`
Il seguente esempio di codice mostra come utilizzare`import-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ImportComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-component.html)AWS CLI *
### `list-component-build-versions`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListComponentBuildVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-component-build-versions.html)AWS CLI *
### `list-components`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-components.html)AWS CLI *
### `list-distribution-configurations`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListDistributionConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-distribution-configurations.html)AWS CLI *
### `list-image-build-versions`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListImageBuildVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)AWS CLI *
### `list-image-pipeline-images`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListImagePipelineImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-pipeline-images.html)AWS CLI *
### `list-image-recipes`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListImageRecipes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-recipes.html)AWS CLI *
### `list-images`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListImages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)AWS CLI *
### `list-infrastructure-configurations`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListInfrastructureConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-infrastructure-configurations.html)AWS CLI *
### `list-tags-for-resource`
Il seguente esempio di codice mostra come utilizzare`list-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-tags-for-resource.html)AWS CLI *
### `put-component-policy`
Il seguente esempio di codice mostra come utilizzare`put-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [PutComponentPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-component-policy.html)AWS CLI *
### `put-image-policy`
Il seguente esempio di codice mostra come utilizzare`put-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [PutImagePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-policy.html)AWS CLI *
### `put-image-recipe-policy`
Il seguente esempio di codice mostra come utilizzare`put-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [PutImageRecipePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/put-image-recipe-policy.html)AWS CLI *
### `start-image-pipeline-execution`
Il seguente esempio di codice mostra come utilizzare`start-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [StartImagePipelineExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/start-image-pipeline-execution.html)AWS CLI *
### `tag-resource`
Il seguente esempio di codice mostra come utilizzare`tag-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/tag-resource.html)AWS CLI *
### `untag-resource`
Il seguente esempio di codice mostra come utilizzare`untag-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/untag-resource.html)AWS CLI *
### `update-distribution-configuration`
Il seguente esempio di codice mostra come utilizzare`update-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [UpdateDistributionConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)AWS CLI *
### `update-image-pipeline`
Il seguente esempio di codice mostra come utilizzare`update-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [UpdateImagePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-image-pipeline.html)AWS CLI *
### `update-infrastructure-configuration`
Il seguente esempio di codice mostra come utilizzare`update-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](https://docs.aws.amazon.com/imagebuilder/latest/userguide/managing-image-builder-cli.html) Builder.
+ *Per i dettagli sull'API, consulta Command Reference. [UpdateInfrastructureConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-infrastructure-configuration.html)AWS CLI *